sip Section
- copyunknownheaders
- localuser
- maxtcpconnections
- maxtlsconnections
- min_se
- mtusize
- OPTIONS.header.Accept
- OPTIONS.header.Accept-Encoding
- OPTIONS.header.Accept-Language
- OPTIONS.header.Allow
- OPTIONS.header.Supported
- prack.support
- preferred_ipversion
- registerexpiryadjustment
- route.default.tcp
- route.default.tcp.ipv6
- route.default.tls
- route.default.tls.ipv6
- route.default.udp
- route.default.udp.ipv6
- route.dest.0
- route.dest.1
- route.dest.2
- route.dest.3
- route.dest.4
- route.dest.5
- routeset
- securerouteset
- sessionexpires
- tcp.portrange
- threadpoolsize
- threads
- timer.ci_proceeding
- tls.portrange
- transport.0
- transport.0.tos
- transport.1
- transport.1.tos
- transport.2
- transport.2.tos
- transport.3
- transport.3.tos
- transport.4
- transport.4.tos
- transport.5
- transport.5.tos
- transport.dnsharouting
- transport.localaddress
- transport.localaddress_ipv6
- transport.localaddress.srv
- transport.staticroutelist
copyunknownheaders
Default Value: 1
Valid Values:
Changes Take Effect: At start/restart
Copy unknown headers from request to all responses. If this parameter is turned on, all unknown SIP headers found in SIP request will be automatically copied to its responses. 0 is disable and 1 is enable.
localuser
Default Value: Genesys
Valid Values:
Changes Take Effect: At start/restart
Configures the user name portion of the Contact header generated from the platform.
maxtcpconnections
Default Value: 100
Valid Values: The maximum number of connections must be between 1 and 10000
Changes Take Effect: At start/restart
Defines the maximum number of TCP connections concurrently established. If the maximum number of TCP connections has been reached, new SIP requests to establish TCP connections will be rejected
maxtlsconnections
Default Value: 100
Valid Values: The maximum number of TLS connections must be between 1 and 10000
Changes Take Effect: At start/restart
Defines the maximum number of TLS connections concurrently established. If the maximum number of TLS connections has been reached, new SIP requests to establish TLS connections will be rejected
min_se
Default Value: 90
Valid Values: The parameter size must be between 90 and 3600
Changes Take Effect: At start/restart
Defines the Min-SE parameter in seconds. This is the minimum duration of session expiry this SIP stack will accept from a user agent client.
mtusize
Default Value: 1500
Valid Values: The MTU size must be between 1 and 65535
Changes Take Effect: At start/restart
Defines the Maximum Transmission Unit (MTU) of the network interfaces. If a SIP request size is within 200 bytes of this value, the request will be sent on a congestion controlled transport protocol, such as TCP.
OPTIONS.header.Accept
Default Value: application/sdp
Valid Values:
Changes Take Effect: immediately
This defines the Accept header value in the SIP OPTIONS response.
OPTIONS.header.Accept-Encoding
Default Value:
Valid Values:
Changes Take Effect: immediately
This defines the Accept-Encoding header value in the SIP OPTIONS response.
OPTIONS.header.Accept-Language
Default Value: en
Valid Values:
Changes Take Effect: immediately
This defines the Accept-Language header value in the SIP OPTIONS response
OPTIONS.header.Allow
Default Value: INVITE,ACK,CANCEL,BYE,OPTIONS,INFO
Valid Values:
Changes Take Effect: immediately
This defines the Allow header value in the SIP OPTIONS response.
OPTIONS.header.Supported
Default Value:
Valid Values:
Changes Take Effect: immediately
This defines the Supported header value in the SIP OPTIONS response.
prack.support
Default Value: 0
Valid Values:
Changes Take Effect: At start/restart
This parameter will allow the SIP Stack to send reliable the 101-199 provisional responses. The parameter value of 1 or 2 will enable the PRACK support. If the parameter value is set to 2 the CCP will include the "100rel" extension in the Require header of the outbound INVITE request, forcing a remote user that supports PRACK method to sent the provisional responses reliable. If the parameter value is set to 1, the "100rel" extension will be included in the Supported header of the outbound INVITE request giving the remote user the option to send or not the provisional responses reliable. The default parameter value is 0.
preferred_ipversion
Default Value: ipv4
Valid Values: ipv4, ipv6
Changes Take Effect: At start/restart
Preferred IP version to be used in SIP. When multiple IP addresses with different IP versions are resolved from a destination address, the first address from the list with the preferred IP version will be used. However, if there is no sip.transport defined for the preferred version, other version will be used. Valid values are "ipv4" and "ipv6".
registerexpiryadjustment
Default Value: 10
Valid Values: sip.registerexpiryadjustment should be non-negative integer
Changes Take Effect: At start/restart
Specifies the amount of time (in seconds) that the platform should re-register with the configured registrars before their respective expiration times are reached
route.default.tcp
Default Value:
Valid Values:
Changes Take Effect: At start/restart
Default IPv4 route for TCP. The number denotes the transport defined in sip.transport.x where x is the value of this parameter and will be used when no IPv4 TCP routes are found.
route.default.tcp.ipv6
Default Value:
Valid Values:
Changes Take Effect: At start/restart
Default IPv6 route for TCP. The number denotes the transport defined in sip.transport.x where x is the value of this parameter and will be used when no IPv6 TCP routes are found. If this parameter is not set, the first IPv6 TCP transport found in sip.transport.x becomes the default.
route.default.tls
Default Value:
Valid Values:
Changes Take Effect: At start/restart
Default IPv4 route for TLS. The number denotes the transport defined in sip.transport.x where x is the value of this parameter and will be used when no IPv4 TLS routes are found.
route.default.tls.ipv6
Default Value:
Valid Values:
Changes Take Effect: At start/restart
Default IPv6 route for TLS. The number denotes the transport defined in sip.transport.x where x is the value of this parameter and will be used when no IPv6 TLS routes are found. If this parameter is not set, the first IPv6 TLS transport found in sip.transport.x becomes the default.
route.default.udp
Default Value:
Valid Values:
Changes Take Effect: At start/restart
Default IPv4 route for UDP. The number denotes the transport defined in sip.transport.x where x is the value of this parameter and will be used when no IPv4 UDP routes are found.
route.default.udp.ipv6
Default Value:
Valid Values:
Changes Take Effect: At start/restart
Default IPv6 route for UDP. The number denotes the transport defined in sip.transport.x where x is the value of this parameter and will be used when no IPv6 UDP routes are found. If this parameter is not set, the first IPv6 UDP transport found in sip.transport.x becomes the default.
route.dest.0
Default Value:
Valid Values:
Changes Take Effect: At start/restart
This is an entry in routing table.
Format: sip.route.dest.x=[Destination] [Netmask] [Transport] [Metric]
To select an entry in routing table, we mask the outgoing IP Address with [Netmask]; if the result matches with the [Destination], we will accept that route. The [Transport] part determines the transport to use and maps to the index 'x' in one of the transports defined as sip.transport.x. In most of the cases, first accepted route will be used. Unless the protocol is specified or required (for example, when the message size is larger than mtusize, tcp is required to be used), the accepted route in routing table is also required to have matched protocol. If there.s no such route, default transport of that protocol will be used.
If all cases failed, sip.transport.0.s protocol will be obtained. The default transport of the obtained protocol will be used.
Note that [Metric] entry is needed but not used at this point.
For example: sip.route.dest.0=138.120.72.0 255.255.255.0 1 0
For example (ipv6): sip.route.dest.0=2620:0:60:: FFFF:FFFF:FFFF:: 0 0 When we make a call to the machine 138.120.72.20, outgoing IP is masked with [netmask] using .bitwise AND. operator. In this case: 138.120.72.20 & 255.255.255.0 gives 138.120.72.0. This matches the defined [Destination] in the route. Therefore, transport in sip.transport.1 will be used.
route.dest.1
Default Value:
Valid Values:
Changes Take Effect: At start/restart
This is an entry in routing table.
Format: sip.route.dest.x=[Destination] [Netmask] [Transport] [Metric]
To select an entry in routing table, we mask the outgoing IP Address with [Netmask]; if the result matches with the [Destination], we will accept that route. The [Transport] part determines the transport to use and maps to the index 'x' in one of the transports defined as sip.transport.x. In most of the cases, first accepted route will be used. Unless the protocol is specified or required (for example, when the message size is larger than mtusize, tcp is required to be used), the accepted route in routing table is also required to have matched protocol. If there.s no such route, default transport of that protocol will be used.
If all cases failed, sip.transport.0.s protocol will be obtained. The default transport of the obtained protocol will be used.
Note that [Metric] entry is needed but not used at this point.
For example: sip.route.dest.0=138.120.72.0 255.255.255.0 1 0
For example (ipv6): sip.route.dest.0=2620:0:60:: FFFF:FFFF:FFFF:: 0 0 When we make a call to the machine 138.120.72.20, outgoing IP is masked with [netmask] using .bitwise AND. operator. In this case: 138.120.72.20 & 255.255.255.0 gives 138.120.72.0. This matches the defined [Destination] in the route. Therefore, transport in sip.transport.1 will be used.
route.dest.2
Default Value:
Valid Values:
Changes Take Effect: At start/restart
This is an entry in routing table.
Format: sip.route.dest.x=[Destination] [Netmask] [Transport] [Metric]
To select an entry in routing table, we mask the outgoing IP Address with [Netmask]; if the result matches with the [Destination], we will accept that route. The [Transport] part determines the transport to use and maps to the index 'x' in one of the transports defined as sip.transport.x. In most of the cases, first accepted route will be used. Unless the protocol is specified or required (for example, when the message size is larger than mtusize, tcp is required to be used), the accepted route in routing table is also required to have matched protocol. If there.s no such route, default transport of that protocol will be used.
If all cases failed, sip.transport.0.s protocol will be obtained. The default transport of the obtained protocol will be used.
Note that [Metric] entry is needed but not used at this point.
For example: sip.route.dest.0=138.120.72.0 255.255.255.0 1 0
For example (ipv6): sip.route.dest.0=2620:0:60:: FFFF:FFFF:FFFF:: 0 0 When we make a call to the machine 138.120.72.20, outgoing IP is masked with [netmask] using .bitwise AND. operator. In this case: 138.120.72.20 & 255.255.255.0 gives 138.120.72.0. This matches the defined [Destination] in the route. Therefore, transport in sip.transport.1 will be used.
route.dest.3
Default Value:
Valid Values:
Changes Take Effect: At start/restart
This is an entry in routing table.
Format: sip.route.dest.x=[Destination] [Netmask] [Transport] [Metric]
To select an entry in routing table, we mask the outgoing IP Address with [Netmask]; if the result matches with the [Destination], we will accept that route. The [Transport] part determines the transport to use and maps to the index 'x' in one of the transports defined as sip.transport.x. In most of the cases, first accepted route will be used. Unless the protocol is specified or required (for example, when the message size is larger than mtusize, tcp is required to be used), the accepted route in routing table is also required to have matched protocol. If there.s no such route, default transport of that protocol will be used.
If all cases failed, sip.transport.0.s protocol will be obtained. The default transport of the obtained protocol will be used.
Note that [Metric] entry is needed but not used at this point.
For example: sip.route.dest.0=138.120.72.0 255.255.255.0 1 0
For example (ipv6): sip.route.dest.0=2620:0:60:: FFFF:FFFF:FFFF:: 0 0 When we make a call to the machine 138.120.72.20, outgoing IP is masked with [netmask] using .bitwise AND. operator. In this case: 138.120.72.20 & 255.255.255.0 gives 138.120.72.0. This matches the defined [Destination] in the route. Therefore, transport in sip.transport.1 will be used.
route.dest.4
Default Value:
Valid Values:
Changes Take Effect: At start/restart
This is an entry in routing table.
Format: sip.route.dest.x=[Destination] [Netmask] [Transport] [Metric]
To select an entry in routing table, we mask the outgoing IP Address with [Netmask]; if the result matches with the [Destination], we will accept that route. The [Transport] part determines the transport to use and maps to the index 'x' in one of the transports defined as sip.transport.x. In most of the cases, first accepted route will be used. Unless the protocol is specified or required (for example, when the message size is larger than mtusize, tcp is required to be used), the accepted route in routing table is also required to have matched protocol. If there.s no such route, default transport of that protocol will be used.
If all cases failed, sip.transport.0.s protocol will be obtained. The default transport of the obtained protocol will be used.
Note that [Metric] entry is needed but not used at this point.
For example: sip.route.dest.0=138.120.72.0 255.255.255.0 1 0
For example (ipv6): sip.route.dest.0=2620:0:60:: FFFF:FFFF:FFFF:: 0 0 When we make a call to the machine 138.120.72.20, outgoing IP is masked with [netmask] using .bitwise AND. operator. In this case: 138.120.72.20 & 255.255.255.0 gives 138.120.72.0. This matches the defined [Destination] in the route. Therefore, transport in sip.transport.1 will be used.
route.dest.5
Default Value:
Valid Values:
Changes Take Effect: At start/restart
This is an entry in routing table.
Format: sip.route.dest.x=[Destination] [Netmask] [Transport] [Metric]
To select an entry in routing table, we mask the outgoing IP Address with [Netmask]; if the result matches with the [Destination], we will accept that route. The [Transport] part determines the transport to use and maps to the index 'x' in one of the transports defined as sip.transport.x. In most of the cases, first accepted route will be used. Unless the protocol is specified or required (for example, when the message size is larger than mtusize, tcp is required to be used), the accepted route in routing table is also required to have matched protocol. If there.s no such route, default transport of that protocol will be used.
If all cases failed, sip.transport.0.s protocol will be obtained. The default transport of the obtained protocol will be used.
Note that [Metric] entry is needed but not used at this point.
For example: sip.route.dest.0=138.120.72.0 255.255.255.0 1 0
For example (ipv6): sip.route.dest.0=2620:0:60:: FFFF:FFFF:FFFF:: 0 0 When we make a call to the machine 138.120.72.20, outgoing IP is masked with [netmask] using .bitwise AND. operator. In this case: 138.120.72.20 & 255.255.255.0 gives 138.120.72.0. This matches the defined [Destination] in the route. Therefore, transport in sip.transport.1 will be used.
routeset
Default Value:
Valid Values: A valid routeset must have the format as specify in its description
Changes Take Effect: At start/restart
Defines a SIP route set for outbound calls. If defined, this route set will be inserted as the ROUTE header for all outgoing calls. This will force the platform to send the SIP messages via this defined route set.
Each element in the routeset should be seperated by a comma. This parameter can be used to define outbound proxies. Note that this routeset does not apply to SIP REGISTER messages.
sip.routeset = <sip:ip/host;priority>, ... e.g. sip.routeset=<sip:p1.example.com;lr>,<sip:p2.domain.com;lr>
In this example, the Genesys Voice platform will route the request to p1.example.com, which will in turn route the message to p2.domain.com, and finally be redirected to its intended destination.
securerouteset
Default Value:
Valid Values: A valid secure routeset must have the format as specify in its description
Changes Take Effect: At start/restart
Defines a SIPS route set for SIPS outbound calls. If defined, this route set will be inserted as the ROUTE header for all outgoing calls. This will force the platform to send the SIP messages via this defined route set.
Each element in the routeset should be seperated by a comma. This parameter can be used to define outbound proxies. Note that this routeset does not apply to SIP REGISTER messages.
sip.securerouteset = <sips:ip/host;priority>, ... e.g. sip.securerouteset=<sips:p1.example.com;lr>,<sips:p2.domain.com;lr>
In this example, the Genesys Voice platform will route the request to p1.example.com, which will in turn route the message to p2.domain.com, and finally be redirected to its intended destination.
sessionexpires
Default Value: 1800
Valid Values: The parameter size must be between 90 and 3600
Changes Take Effect: At start/restart
Defines the default session expiry value in seconds. The session timer defines the duration of which a SIP session will expire if no re-INVITEs are sent/received within this period.
tcp.portrange
Default Value:
Valid Values: Possible values are the empty string or low-high, where low and high are integers from 1030 to 65535 inclusive
Changes Take Effect: At start/restart
The local TCP port range to be used for SIP transport. If this parameter is not specified, CCP will let the OS choose the local port.
threadpoolsize
Default Value: 4
Valid Values: The size of the thread pool for handling DNS queries
Changes Take Effect: At start/restart
The size of the thread pool for handling DNS queries.
threads
Default Value: 0
Valid Values:
Changes Take Effect: After restart
Specifies the number of worker threads that handles the SIP requests arriving from the SIP transport layer. If the value is 0, all requests are handled within the arriving transport layer thread. Otherwise, all arriving requests are handled by hashing onto the N number of worker threads.
timer.ci_proceeding
Default Value: 120000
Valid Values: sip.timer.ci_proceeding must be greater than 0
Changes Take Effect: At start/restart
Defines the client INVITE proceeding timer in milliseconds, default value is 120000. The timer starts after a 1xx response is received for a client INVITE. If a final response is not received before the timer expires, the SIP session and dialog will be destroyed without further notice to the UAS. Note that the CI proceeding timer should be configured to be greater than the connect timeout. This ensures that a CANCEL will be sent to terminate the SIP session properly when connect timeout occurs.
tls.portrange
Default Value:
Valid Values: Possible values are the empty string or low-high, where low and high are integers from 1030 to 65535 inclusive
Changes Take Effect: At start/restart
The local TLS port range to be used for SIP transport. If this parameter is not specified, CCP will let the OS choose the local port.
transport.0
Default Value: transport0 udp:any:5068
Valid Values:
Changes Take Effect: At start/restart
defines transport layer for SIP stack and the network interfaces that are used to process SIP requests Format: sip.transport.x = transport_name
type:ip:port [parameters]
where transport_name is any string; type is udp/tcp/tls; ip is the IP address of the network interface that accepts incoming SIP messages; If ip is an IPv6 address, [] must be used. To define a transport to listen to all IPv4 interfaces, use "any" or "any4" for ip. To define a transport to listen to all IPv6 interfaces, use "any6" for ip. port is the port number where SIP stack accepts incoming SIP messages;
[parameters] defines any extra SIP transport parameters. Note that this is for LMSIP2.
Example:
cert=[cert path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS certificate to be used key=[key path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS key to be used. type=[Type of secure transport] Applicable to SIPS only and is optional. The type of secure transport to be used and value can be TLSv1, SSLv2, SSLv3, SSLv23. Default to SSLv23. password=[password] Applicable to SIPS only and is optional. The password associated with the certificate and key pair. Required only if key file is password protected. cafile=[CA cert path and filename] Mandatory for TLS mutual authentication. The path and the filename of the certificate to be used for verifying the peer. The same certificate specified in cert=[cert path and filename] parameter can be used as the value here if using only 1 certificate is preferred. verifypeer=true Mandatory for TLS mutual authentication. This parameter turns on the TLS mutual authentication. verifydepth=[max depth for the certificate chain verification] Applicable only to TLS mutual authentication. This parameter sets the maximum depth for the certificate chain verification. For the default Genesys certificate provided, the recommended value is 1.
transport.0.tos
Default Value: 0
Valid Values: Possible values are integers from 0 to 255 inclusive.
Changes Take Effect: At start/restart
Specifies the IP Differentiaed Services Field (also known as ToS) to set in all outgoing SIP packets over transport instance 0. Note that this configuration does not work for Windows 2008. For Windows 2008, the setting needs to be configured at the OS level through the policy settings. Please refer to the GVP User's Guide.
transport.1
Default Value: transport1 tcp:any:5068
Valid Values:
Changes Take Effect: At start/restart
defines transport layer for SIP stack and the network interfaces that are used to process SIP requests Format: sip.transport.x = transport_name
type:ip:port [parameters]
where transport_name is any string; type is udp/tcp/tls; ip is the IP address of the network interface that accepts incoming SIP messages; If ip is an IPv6 address, [] must be used. To define a transport to listen to all IPv4 interfaces, use "any" or "any4" for ip. To define a transport to listen to all IPv6 interfaces, use "any6" for ip. port is the port number where SIP stack accepts incoming SIP messages;
[parameters] defines any extra SIP transport parameters. Note that this is for LMSIP2.
Example:
cert=[cert path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS certificate to be used key=[key path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS key to be used. type=[Type of secure transport] Applicable to SIPS only and is optional. The type of secure transport to be used and value can be TLSv1, SSLv2, SSLv3, SSLv23. Default to SSLv23. password=[password] Applicable to SIPS only and is optional. The password associated with the certificate and key pair. Required only if key file is password protected. cafile=[CA cert path and filename] Mandatory for TLS mutual authentication. The path and the filename of the certificate to be used for verifying the peer. The same certificate specified in cert=[cert path and filename] parameter can be used as the value here if using only 1 certificate is preferred. verifypeer=true Mandatory for TLS mutual authentication. This parameter turns on the TLS mutual authentication. verifydepth=[max depth for the certificate chain verification] Applicable only to TLS mutual authentication. This parameter sets the maximum depth for the certificate chain verification. For the default Genesys certificate provided, the recommended value is 1.
transport.1.tos
Default Value: 0
Valid Values: Possible values are integers from 0 to 255 inclusive.
Changes Take Effect: At start/restart
Specifies the IP Differentiaed Services Field (also known as ToS) to set in all outgoing SIP packets over transport instance 1. Note that this configuration does not work for Windows 2008. For Windows 2008, the setting needs to be configured at the OS level through the policy settings. Please refer to the GVP User's Guide.
transport.2
Default Value: transport2 tls:any:5069 cert=$InstallationRoot$/config/x509_certificate.pem key=$InstallationRoot$/config/x509_private_key.pem
Valid Values:
Changes Take Effect: At start/restart
defines transport layer for SIP stack and the network interfaces that are used to process SIP requests Format: sip.transport.x = transport_name
type:ip:port [parameters]
where transport_name is any string; type is udp/tcp/tls; ip is the IP address of the network interface that accepts incoming SIP messages; If ip is an IPv6 address, [] must be used. To define a transport to listen to all IPv4 interfaces, use "any" or "any4" for ip. To define a transport to listen to all IPv6 interfaces, use "any6" for ip. port is the port number where SIP stack accepts incoming SIP messages;
[parameters] defines any extra SIP transport parameters. Note that this is for LMSIP2.
Example:
cert=[cert path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS certificate to be used key=[key path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS key to be used. type=[Type of secure transport] Applicable to SIPS only and is optional. The type of secure transport to be used and value can be TLSv1, SSLv2, SSLv3, SSLv23. Default to SSLv23. password=[password] Applicable to SIPS only and is optional. The password associated with the certificate and key pair. Required only if key file is password protected. cafile=[CA cert path and filename] Mandatory for TLS mutual authentication. The path and the filename of the certificate to be used for verifying the peer. The same certificate specified in cert=[cert path and filename] parameter can be used as the value here if using only 1 certificate is preferred. verifypeer=true Mandatory for TLS mutual authentication. This parameter turns on the TLS mutual authentication. verifydepth=[max depth for the certificate chain verification] Applicable only to TLS mutual authentication. This parameter sets the maximum depth for the certificate chain verification. For the default Genesys certificate provided, the recommended value is 1.
transport.2.tos
Default Value: 0
Valid Values: Possible values are integers from 0 to 255 inclusive.
Changes Take Effect: At start/restart
Specifies the IP Differentiaed Services Field (also known as ToS) to set in all outgoing SIP packets over transport instance 2. Note that this configuration does not work for Windows 2008. For Windows 2008, the setting needs to be configured at the OS level through the policy settings. Please refer to the GVP User's Guide.
transport.3
Default Value:
Valid Values:
Changes Take Effect: At start/restart
defines transport layer for SIP stack and the network interfaces that are used to process SIP requests Format: sip.transport.x = transport_name
type:ip:port [parameters]
where transport_name is any string; type is udp/tcp/tls; ip is the IP address of the network interface that accepts incoming SIP messages; If ip is an IPv6 address, [] must be used. To define a transport to listen to all IPv4 interfaces, use "any" or "any4" for ip. To define a transport to listen to all IPv6 interfaces, use "any6" for ip. port is the port number where SIP stack accepts incoming SIP messages;
[parameters] defines any extra SIP transport parameters. Note that this is for LMSIP2.
Example:
cert=[cert path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS certificate to be used key=[key path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS key to be used. type=[Type of secure transport] Applicable to SIPS only and is optional. The type of secure transport to be used and value can be TLSv1, SSLv2, SSLv3, SSLv23. Default to SSLv23. password=[password] Applicable to SIPS only and is optional. The password associated with the certificate and key pair. Required only if key file is password protected. cafile=[CA cert path and filename] Mandatory for TLS mutual authentication. The path and the filename of the certificate to be used for verifying the peer. The same certificate specified in cert=[cert path and filename] parameter can be used as the value here if using only 1 certificate is preferred. verifypeer=true Mandatory for TLS mutual authentication. This parameter turns on the TLS mutual authentication. verifydepth=[max depth for the certificate chain verification] Applicable only to TLS mutual authentication. This parameter sets the maximum depth for the certificate chain verification. For the default Genesys certificate provided, the recommended value is 1.
transport.3.tos
Default Value: 0
Valid Values: Possible values are integers from 0 to 255 inclusive.
Changes Take Effect: At start/restart
Specifies the IP Differentiaed Services Field (also known as ToS) to set in all outgoing SIP packets over transport instance 3. Note that this configuration does not work for Windows 2008. For Windows 2008, the setting needs to be configured at the OS level through the policy settings. Please refer to the GVP User's Guide.
transport.4
Default Value:
Valid Values:
Changes Take Effect: At start/restart
defines transport layer for SIP stack and the network interfaces that are used to process SIP requests Format: sip.transport.x = transport_name
type:ip:port [parameters]
where transport_name is any string; type is udp/tcp/tls; ip is the IP address of the network interface that accepts incoming SIP messages; If ip is an IPv6 address, [] must be used. To define a transport to listen to all IPv4 interfaces, use "any" or "any4" for ip. To define a transport to listen to all IPv6 interfaces, use "any6" for ip. port is the port number where SIP stack accepts incoming SIP messages;
[parameters] defines any extra SIP transport parameters. Note that this is for LMSIP2.
Example:
cert=[cert path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS certificate to be used key=[key path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS key to be used. type=[Type of secure transport] Applicable to SIPS only and is optional. The type of secure transport to be used and value can be TLSv1, SSLv2, SSLv3, SSLv23. Default to SSLv23. password=[password] Applicable to SIPS only and is optional. The password associated with the certificate and key pair. Required only if key file is password protected. cafile=[CA cert path and filename] Mandatory for TLS mutual authentication. The path and the filename of the certificate to be used for verifying the peer. The same certificate specified in cert=[cert path and filename] parameter can be used as the value here if using only 1 certificate is preferred. verifypeer=true Mandatory for TLS mutual authentication. This parameter turns on the TLS mutual authentication. verifydepth=[max depth for the certificate chain verification] Applicable only to TLS mutual authentication. This parameter sets the maximum depth for the certificate chain verification. For the default Genesys certificate provided, the recommended value is 1.
transport.4.tos
Default Value: 0
Valid Values: Possible values are integers from 0 to 255 inclusive.
Changes Take Effect: At start/restart
Specifies the IP Differentiaed Services Field (also known as ToS) to set in all outgoing SIP packets over transport instance 4. Note that this configuration does not work for Windows 2008. For Windows 2008, the setting needs to be configured at the OS level through the policy settings. Please refer to the GVP User's Guide.
transport.5
Default Value:
Valid Values:
Changes Take Effect: At start/restart
defines transport layer for SIP stack and the network interfaces that are used to process SIP requests Format: sip.transport.x = transport_name
type:ip:port [parameters]
where transport_name is any string; type is udp/tcp/tls; ip is the IP address of the network interface that accepts incoming SIP messages; If ip is an IPv6 address, [] must be used. To define a transport to listen to all IPv4 interfaces, use "any" or "any4" for ip. To define a transport to listen to all IPv6 interfaces, use "any6" for ip. port is the port number where SIP stack accepts incoming SIP messages;
[parameters] defines any extra SIP transport parameters. Note that this is for LMSIP2.
Example:
cert=[cert path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS certificate to be used key=[key path and filename] Applicable to SIPS only and mandatory if using SIPS. The path and the filename of the TLS key to be used. type=[Type of secure transport] Applicable to SIPS only and is optional. The type of secure transport to be used and value can be TLSv1, SSLv2, SSLv3, SSLv23. Default to SSLv23. password=[password] Applicable to SIPS only and is optional. The password associated with the certificate and key pair. Required only if key file is password protected. cafile=[CA cert path and filename] Mandatory for TLS mutual authentication. The path and the filename of the certificate to be used for verifying the peer. The same certificate specified in cert=[cert path and filename] parameter can be used as the value here if using only 1 certificate is preferred. verifypeer=true Mandatory for TLS mutual authentication. This parameter turns on the TLS mutual authentication. verifydepth=[max depth for the certificate chain verification] Applicable only to TLS mutual authentication. This parameter sets the maximum depth for the certificate chain verification. For the default Genesys certificate provided, the recommended value is 1.
transport.5.tos
Default Value: 0
Valid Values: Possible values are integers from 0 to 255 inclusive.
Changes Take Effect: At start/restart
Specifies the IP Differentiaed Services Field (also known as ToS) to set in all outgoing SIP packets over transport instance 5. Note that this configuration does not work for Windows 2008. For Windows 2008, the setting needs to be configured at the OS level through the policy settings. Please refer to the GVP User's Guide.
transport.dnsharouting
Default Value: false
Valid Values:
Changes Take Effect: At start/restart
Specifies whether the DNS HA routing based on RFC3263 should be turned on. If turned off, alternate records returned from the DNS query will not be tried. Otherwise, alternate records returned from the DNS query will be tried based on RFC3263.
transport.localaddress
Default Value:
Valid Values:
Changes Take Effect: At start/restart
If specified, the sent-by field of the Via header and the hostport part of the Contact header in the outgoing SIP message will be set to this value if a IPv4 transport is used. The value must be a hostname or domain name. If left empty the outgoing transport's actual IP and port will be used for the Via header and the Contact header. Note that if the domain name used in the SRV record query is specified, sip.transport.localaddress.srv must be set to true to prevent the port part being automatically generated by the SIP stack.
transport.localaddress_ipv6
Default Value:
Valid Values:
Changes Take Effect: At start/restart
If specified, the sent-by field of the Via header and the hostport part of the Contact header in the outgoing SIP message will be set to this value if a IPv6 transport is used. The value must be a hostname or domain name. If left empty the outgoing transport's actual IP and port will be used for the Via header and the Contact header. Note that if the domain name used in the SRV record query is specified, sip.transport.localaddress.srv must be set to true to prevent the port part being automatically generated by the SIP stack.
transport.localaddress.srv
Default Value: false
Valid Values:
Changes Take Effect: At start/restart
Specifies whether the sip.transport.localaddress contains an SRV domain name. If set to true, port part will not be automatically generated by the SIP stack. Otherwise, the outgoing transport's port will used together with the hostname specified by the sip.transport.localaddress.
transport.staticroutelist
Default Value:
Valid Values:
Changes Take Effect: At start/restart
Specifies a list of static routes. Each route group is separated by