SIP Proxy Application Configuration Options

applications

Default Value: NULL
Valid Values: String value
Change Take Effect: After SIP Proxy restart

Specifies a comma-separated list of all SIP Server applications names in the environment. Only primary servers need to be specified.

oos-check

Default Value: 5
Valid Values: 0–300
Changes Take Effect: Immediately

Specifies how often, in seconds, SIP Proxy checks SIP Servers for out-of-service status.

oos-force

Default Value: 5
Valid Values: 1–32
Changes Take Effect: Immediately

Specifies how often, in seconds, SIP Proxy checks whether the out-of-service SIP Server starts to respond.

overload-ctrl-dialog-rate

Default Value: 0
Valid Values: Any positive integer
Changes Take Effect: Immediately

Specifies a dialog rate (incoming INVITE requests per second) threshold. All over-threshold INVITE requests will be rejected. When set to a value of 0 (the default), this functionality is disabled.

resolve-host

Default Value: false
Valid Values: true, false
Changes Take Effect: After SIP Proxy restart

If this option is set to false, the name of the host where SIP Proxy runs is specified in the Via header. If this option is set to true, the resolved IP address is specified in the Via header.

serving-sipserver

Default Value: NULL
Valid Values: Any string
Change Take Effect: After SIP Proxy restart

Specifies the SIP Server application name to which all requests from endpoints and media gateways will be forwarded.

sip-address

Default Value: NULL
Valid Values: String value
Changes Take Effect: After SIP Proxy restart

Specifies the IP address of the SIP Proxy interface. This option must be set when deploying SIP Proxy on a host with multiple network interfaces. If this option is specified, SIP Proxy inserts the option value into the Via header of outgoing SIP messages.

sip-enable-tcp-keep-alive

Default Value: false
Valid Values: true, false
Changes Take Effect: After SIP Proxy restart
Related Feature: Keep Alive for TCP Connections

When set to true, enables the TCP keep-alive mechanism for all SIP-related connections. Keep-alive timeouts are configured on the operating system level.

sip-ip-tos

Default Value: 256
Valid Values: 0–255
Changes Take Effect: After SIP Proxy restart

Specifies the value of the Type of Service (TOS) byte in the IP header of SIP messages that are sent by SIP Proxy. If this option is not specified, the operating system TOS byte is used. The default value (256) disables this functionality. Only decimal values are accepted.

Depending on the network configuration, the TOS byte is treated as one of the following:

• 3-bit IP precedence field, followed by a 4-bit type-of-service. The least significant bit (LSB) is unused and set to 0. (RFC 1349)
• 6-bit DiffServ, with the two least significant bits unused. (RFC 2474)

Note: On most operating systems, applications that are running on behalf of non-privileged user accounts are not permitted to set a non-zero TOS value, so you might have to perform additional actions to enable this functionality. In particular:

• On Linux, the application must have CAP_NET_ADMIN capability (that is, be capable of running from the root account).
• On Windows, the following registry setting must be set (see also http://support.microsoft.com\kb/248611): HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters\DisableUserTOSSetting = (DWORD) 0

Refer to operating system documentation for additional information.

sipproxy-role

Default Value: 0
Valid Values: 0,10
Changes Take Effect: After SIP Proxy restart

Specifies the mode of the SIP Proxy:

• 0—Reserved for engineering purposes
• 10—Standalone mode (the only mode currently supported)

sip-tls-sec-protocol

Default Value: SSLv23
Valid Values: SSLv23, SSLv3, TLSv1, TLSv11
Changes Take Effect: After SIP Proxy restart
Related Feature: Transport Layer Security

Specifies which handshake protocol SIP Proxy will use on the SIP TLS listening port and when connecting to a SIP TLS-enabled device as a client. This option can be used only on UNIX operating systems with Genesys Security Pack on UNIX 8.1.300.03 or later. The option must be configured in the security section of the SIP Proxy Application. The option is not used on Windows. Protocols are specified by the option values as follows:

• SSLv23—SSL v2.0
• SSLv3—SSL v3.0
• TLSv1—TLS v1.0
• TLSv11—TLS v1.1