You can add any of the following custom properties to the configuration settings for a Session Initiation Protocol (SIP) container.
To specify custom properties for a specific SIP container, navigate to the custom properties page, and then specify a value for the custom property.
The following list of SIP container custom properties is provided with the product. These properties are not shown on the settings page for the container.
Specifies whether the application has access to headers that are otherwise restricted.
Data type | String |
Default | False |
Specifies whether to replicate the application session when the dialog is not confirmed or does not exist. If the value is false, then the application session is replicated when the dialog is not confirmed or does not exist. Otherwise, the application session is only replicated when the dialog is confirmed.
Data type | String |
Default | False |
Specifies the number of logical names in the application server. Each SIP object that can be replicated, such as a SIP session, is associated with a logical name. All objects with the same logical name are replicated to the same back-up container. The proxy can route messages to the correct container using the logical name found in the message. The value must be greater than 1.
Data type | String |
Default | 10 |
Specifies the auth-int quality of protection (QOP) for digest authentication. Digest authentication defines two types of QOP: auth and auth-int. By default, auth is used. When this custom property is set to True, the highest level of protection is used, which is the auth-int QOP.
Data type | String |
Default | False |
Specifies the Java class name that implements the PasswordServer interface.
Data type | String |
Default | LdapPasswordServer |
Specifies the clean security subject cache period in minutes.
Data type | String |
Default | 15 |
Specifies whether to allow basic authentication for SIP.
Data type | String |
Default | False |
Specifies the clean Lightweight Directory Access Protocol (LDAP) cache period in minutes.
Data type | String |
Default | 120 |
Specifies the LDAP attribute name that stores the user password.
Data type | String |
Default | userpassword |
Specifies whether to automatically reply to invite requests with a 100 Trying response. Disabling this property might increase the number of invite retransmissions.
Data type | String |
Default | True |
Specifies whether to force reuse of inbound connections for outbound requests. This custom property is only relevant for stream transports, such as Transmission Control Protocol (TCP) and Transport Layer Security (TLS). Disabling this property causes the container to create a separate connection for outbound requests, even if an existing connection is already established to the same peer address. The connection is automatically reused if the top Via header in the inbound request contains an alias parameter. (http://www.ietf.org/internet-drafts/draft-ietf-sip-connect-reuse-07.txt)
Data type | String |
Default | True |
Specifies whether to hide message content in logs. If the value is set to false, then this property removes the message body text from the SIP messages printed in the log files.
Data type | String |
Default | False |
Specifies the maximum transmission unit, in bytes, for outbound User Datagram Protocol (UDP) requests. The SIP stack measures the size of a request before sending it out on the UDP channel. If the request is larger than the value specified for PATH_MTU-200 (1300 bytes by default), then the transport is switched from UDP to TCP before transmission.
Increase this value to send larger requests over the UDP channel; however, messages might be truncated or dropped. See the RFC 3261-18.1.1 specification for details.
Data type | String |
Default | 1500 |
Specifies the fixed address for routing all outbound SIP messages. The format is address:port/transport, such as 1.2.3.4:5065/tcp.
Note: Do not use this property if the container is fronted by an application server SIP proxy.
Data type | String |
Default | null |
Specifies whether to print incoming messages to a system.out file.
Data type | String |
Default | False |
Specifies whether to print outbound messages to a system.out file.
Data type | String |
Default | False |
Specifies the amount of time, in milliseconds, for reporting dispatch and timer statistics to a system.out file. A value of zero indicates no report.
Data type | String |
Default | 0 |
Specifies whether to prevent the container from re-escaping Uniform Resource Identifier (URI) parameters that were pre-escaped by the application. Enabling this property provides the application with more control over escaping URI parameters, when calling the javax.servlet.sip.SipFactory.createURI() and the javax.servlet.sip.SipURI.setParameter() parameters.
By default, the container only escapes characters that it must encode according to the RFC 3261 25.1 specification. In some cases, however, escaping additional characters might be required. Due to a limitation in the JSR 116 (5.2.1) specification, the application cannot perform its own escaping. Because of this limitation, attempts by the application to encode URI parameters causes the container to re-encode the percent sign. If the value of this property is set to true, the container cannot re-encode the percent sign.
Setting the value to true is not in compliance with the JSR 116 (5.2.1) specification, but provides the application with greater control over URI parameter escaping. APAR PK37192 describes the problem and the workaround.
Data type | String |
Default | False |
Data type | String |
Default | impl |
Specifies the amount of time, in mililiseconds, between attempts to start the SIP channel if the SIP port is busy with another process during server startup.
Data type | String |
Default | 60 |
Specifies the delay, in mililiseconds, between attempts to start the SIP channel if the SIP port is busy with another process during server startup.
Data type | String |
Default | 5000 |
Specifies the amount of time, in milliseconds, for a network round trip delay for timer T1 for the RFC 3261 specification. The value is used as a base for calculating some timers and is relevant for all types of transactions, such as client, server, invite, and non-invite transactions.
Data type | String |
Default | 500 |
Specifies the maximum time in milliseconds before retransmitting non-invite requests and invite responses for timer T2 for the RFC 3261 specification.
Data type | String |
Default | 4000 |
Specifies the maximum amount of time, in milliseconds, for a message to remain in the network. This value is used as a base for calculating other timers for timer T4 for the RFC 3261 specification.
Data type | String |
Default | 5000 |
Specifies, for UDP only, the amount of time, in milliseconds, before retransmitting invite requests for timer A for the RFC 3261 specification. This property is relevant for the invite client transaction.
Data type | String |
Default | javax.sip.transaction.timer.t1 |
Specifies the amount of time, in milliseconds, for the invite client transaction timeout timer (timer B) for the RFC 3261 specification.
Data type | String |
Default | 64*javax.sip.transaction.timer.t1 |
Specifies the wait time, in milliseconds, before retransmission of the invite response for timer D for the RFC 3261 specification. This property is relevant for the invite client transaction.
Data type | String |
Default | 32000 |
Specifies, for UDP only, the amount of time, in milliseconds, before the retransmission of the initial non-invite request for timer E for the RFC 3261 specification. This property is relevant for the non-invite client transaction.
Data type | String |
Default | javax.sip.transaction.timer.t1 |
Specifies the amount of time, in milliseconds, for the non-invite transaction timeout timer (timer F) for the RFC 3261 specification. This property is relevant for the non-invite client transaction.
Data type | String |
Default | 64*javax.sip.transaction.timer.t1 |
Specifies the amount of time, in milliseconds, before retransmission of an initial invite response for timer G for the RFC 3261 specification. This property is relevant for the invite server transaction.
Data type | String |
Default | javax.sip.transaction.timer.t1 |
Specifies the amount of time, in milliseconds, to wait for an acknowledgement (ACK) receipt for timer H for the RFC 3261 specification. This property is relevant for the invite server transaction.
Data type | String |
Default | 64*javax.sip.transaction.timer.t1 |
Specifies the amount of time in milliseconds to wait for an ACK retransmission for timer I for the RFC 3261 specification. This property is relevant for the invite server transaction.
Data type | String |
Default | javax.sip.transaction.timer.t4 |
Specifies the amount of time in milliseconds to wait for non-invite request retransmission for timer J for the RFC 3261 specification. This property is relevant for the non-invite server transaction.
Data type | String |
Default | 64*javax.sip.transaction.timer.t1 |
Specifies the amount of time, in milliseconds, to wait for non-INVITE response retransmissions for timer K for the RFC 3261 specification. This property is relevant for the non-invite client transaction.
Data type | String |
Default | javax.sip.transaction.timer.t4 |
Specifies the amount of time, in milliseconds, for an Application Programming Interface (API) timer for the application to respond to a non-invite request. This property is relevant for non-invite server transactions.
This timer is not defined in the RFC specification. This property is needed to stop the transaction if the application does not generate a final response to the request. The timer starts when the request arrives in the stack and stops when a response is generated by the application. If no response is generated before the timer stops, then the transaction completes.
Data type | String |
Default | 34000 |
Specifies the amount of time, in milliseconds, for the timer to keep the invite server transaction in the complete state. This timer is not defined in the RFC specification.
To avoid creating a new server transaction when a client retransmits an invite request, keep the completed server transaction for a period of time before removing invite retransmissions. This timer is started when the transaction changes to the terminated state. When the timer completes, the transaction is removed.
Data type | String |
Default | 32000 |
Specifies the amount of timer, in milliseconds, for the timer to keep the cancelled client transaction in the proceeding state before completing the cancelled transaction for the RFC 3261 9.1 specification. This property is relevant for the invite client transaction.
Data type | String |
Default | 64*javax.sip.transaction.timer.t1 |
Specifies the maximum number of events allowed in the container threads queue. When this number is exceeded, the proxy server is notified that the container is overloaded and requests for new sessions are not accepted. Instead, the container returns an error message that indicates that the container is temporarily unavailable.
Data type | String |
Default | 1000 |
Specifies the value for the low water mark threshold. When the high water mark is exceeded, the container waits until the weight drops below a weight that is lower than the maximum number allowed for the low water mark threshold.
Data type | String |
Default | 3 |