DN Options
TServer section
agent-state-auto-restore
Default Value: false
Valid Values: true, false
Changes Take Effect: On the next call
Introduced: 8.1.103.45
Set in the VOIP Service DN with service-type=sip-cluster-nodes, this option enables restoration of agent states when the DN ownership changes between SIP Cluster nodes. When set to false, agents are logged out on the DN ownership change and must log in manually. When set to true, agent states are restored on the new primary SIP Cluster node and agents are logged in automatically.
Limitation: When an agent manually sets to NotReady state with ACW mode, SIP Server generates the ManualSetACWPeriod reason code automatically and does not restore the agent state on the new agent state owner (the SIP Cluster node).
make-call-cpd-extensions
Default Value: BusinessCallType,SIP_HEADERS,CPNDigits,DisplayName,User-Agent
Valid Values: BusinessCallType,SIP_HEADERS,CPNDigits,DisplayName,User-Agent
Changes Take Effect: On the next call
Introduced: 8.1.103.78
Set in the VOIP Service DN with service-type=sip-cluster-nodes, this option specifies a list of AttributeExtensions key-value pairs that SIP Server passes from a TMakeCall request in AttributeExtensions key-value pairs of an internal TMakePredictiveCall request. If no value is configured, the default value applies. If this option is configured, SIP Server passes only specified AttributeExtensions key-value pairs. When set to SIP_HEADERS, SIP Server passes all key-value pairs that are present in the SIP_HEADERS key.
record-metadata-prefix
Default Value: An empty string
Valid Values: Any valid string
Changes Take Effect: On the next call
Introduced: 8.1.103.66
Set in the VOIP Service DN with service-type=sip-cluster-nodes, this option specifies the prefix that must match the initial characters of GVP parameters to be added from AttributeExtensions of TRouteCall in the INFO message sent to MCP. The matching KVPs are sent under recording metadata as additional GVP parameters with the prefix value stripped out. The setting at the Application level takes priority over the VOIP DN level setting. If this option is configured with an empty value at a VOIP DN, the existing recording metadata is sent without additional GVP parameters.
replace-agent-phone
Default Value: false
Valid Values: true, false
Changes Take Effect: On the next call
Introduced: 8.1.103.52
Set in the VOIP Service DN with service-type=sip-cluster-nodes, this option enables modification of dial digits that are required to reach an agent DN. This option setting affects all cluster internal DNs. This feature adds support for remote agents to use external numbers that are not provisioned in the Configuration Database.
sip-enable-strict-auth
Default Value: false
Valid Values: true, false
Changes Take Effect: On the next call
Introduced: 8.1.103.56
Set in the VOIP Service DN with service-type=sip-cluster-nodes, this option enables SIP Server in SIP Cluster mode to mandate authorization of internal devices on REGISTER and INVITE requests. To register or establish communication, devices must not use empty passwords or passwords equal to the DN name. When this option is set to false, an internal device can register or establish communication with SIP Cluster without any authorization.
sipp-oos-recheck
Default Value: false
Valid Values: true, false
Changes Take Effect: On the next call
Introduced: 8.1.103.53
Set in the VOIP Service DN with service-type=sip-cluster-nodes, this option, when set to true, enables the Active Out-of-Service (OOS) check procedure for a VOIP service or Trunk DN. This procedure ensures that this DN is placed out of service only when SIP Proxy processes the SIP traffic.
If set to true, SIP Server places a DN out of service only after rechecking that SIP Proxy is available, and does not place any other DN out of service if the SIP Proxy DN is already out of service. If set to false (the default), SIP Server behavior is not changed.
See also the switchover-on-sipp-oos option.
smart-proxy-verbose-level
Default Value: brief
Valid Values: brief, detailed
Changes Take Effect: Immediately
Introduced: 8.1.103.94
Set in the VOIP Service DN with service-type=sip-cluster-nodes, this option enables Smart Proxy logs optimization to print T-Library events that are sent to or received from Smart Proxy clients in a summarized format.
suppress-event-network-private-info
Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately
Introduced: 8.1.104.01
Set in the VOIP Service DN with service-type=sip-cluster-nodes, this option specifies whether EventNetworkPrivateInfo messages are distributed by Smart Proxy of the SIP Cluster Node to its T-Library clients. If set to true, no EventNetworkPrivateInfo messages are distributed.
switchover-on-msml-oos
Default Value: false
Valid Values: true, false
Changes Take Effect: On the next call
Introduced: 8.1.103.61
Set in the VOIP Service DN with service-type=sip-cluster-nodes, this option specifies the SIP Server action in case of losing connectivity to MSML VOIP Service DNs. When set to true, in the case of strict matching only, VOIP Service DNs with the same or alternative geo-location are considered. After detecting that those DNs are out of service, SIP Server checks one more time that MSML VOIP Service DNs are unresponsive, before reporting the SERVICE_UNAVAILABLE status to LCA/SCS in order to trigger a switchover.
switchover-on-sipp-oos
Default Value: false
Valid Values: true, false
Changes Take Effect: On the next call
Introduced: 8.1.103.53
Set in the VOIP Service DN with service-type=sip-cluster-nodes, this option, when set to true, enables establishing a connection to SIP Proxy from another HA-peer application. SIP Server attempts to initiate a switchover immediately after the SIP Proxy VOIP DN is placed out of service. The switchover is initiated by the SERVICE_UNAVAILABLE message sent to LCA/SCS. When SIP Server is switched to backup mode by SCS, SIP Server issues the SERVICE_AVAILABLE message to SCS.
See also the sipp-oos-recheck option.
switchover-on-trunks-oos
Default Value: false
Valid Values: true, false
Changes Take Effect: On the next call
Introduced: 8.1.103.61
Set in the VOIP Service DN with service-type=sip-cluster-nodes, this option specifies the SIP Server action in case of losing connectivity to Trunk DNs. When set to true, in the case of strict matching only, Trunk DNs with the same or alternative geo-location are considered. After detecting that those DNs are out of service, SIP Server checks one more time that Trunk DNs are unresponsive, before reporting the SERVICE_UNAVAILABLE status to LCA/SCS in order to trigger a switchover.
switchover-on-xs-oos
Default Value: false
Valid Values: true, false
Changes Take Effect: On the next call
Introduced: 8.1.103.80
Set in the VOIP Service DN with service-type=sip-cluster-nodes, this option specifies the SIP Server action in case of losing connectivity with all Feature Server URLs. SIP Server marks a URL as out of service when the threshold of failed heartbeat requests set by the xs-missed-heartbeat-threshold option is reached. When set to true and all configured Feature Server URLs become out of service, SIP Server reports the SERVICE_UNAVAILABLE status to LCA/SCS to switch over to backup mode. When set to false, SIP Server responds with a 503 Service Unavailable message to all calls, until one of the Feature Server URLs becomes available. See the Enhanced handling of XS requests topic for details.
tc-latency-poll-interval
Default Value: 10
Valid Values: Any positive integer
Changes Take Effect: On the next call
Introduced: 8.1.103.58
Set in the VOIP Service DN with service-type=sip-cluster-nodes, this option specifies the time interval, in seconds, that each T-Controller polls its peers and updates *_QUEUE_LEN statistics. If set to 0 (zero), no polls are performed, all statistics are set to "disconnected value" and neither statistic from this feature is updated. See Troubleshooting T-Controllers communication issues for details.
tc-reconnect-timeout
Default Value: 0
Valid Values: 0-60
Changes Take Effect: Immediately
Introduced: 8.1.103.45
Set in the VOIP Service DN with service-type=sip-cluster-nodes, this option specifies the timeout, in seconds, during which T-Controller tries to reconnect to another SIP Cluster node when the connection between SIP Cluster nodes is lost. When the timeout expires and the connection is not restored, DNs owned by the disconnected T-Controller are declared out of service. The default value of 0 (zero) disables this functionality.
time-before-switchover-on-xs-oos
Default Value: 1
Valid Values: 0-60
Changes Take Effect: Immediately
Set in the VOIP Service DN with service-type=sip-cluster-nodes, this option specifies the timeout, in seconds, that SIP Server waits before reporting the SERVICE_UNAVAILABLE status in a scenario described in the switchover-on-xs-oos option. When set to 0 (zero), SIP Server reports the SERVICE_UNAVAILABLE status immediately after the Feature Server VOIP Service DN is detected as out of service. See the Enhanced handling of XS requests topic for details.