[AIX HP-UX Linux Solaris Windows]This topic applies only on the i5/OS operating system.

SIP container custom properties

Use the following custom properties to configure a Session Initiation Protocol (SIP) container.

Navigate to the custom properties page to specify a value for the custom property.

  1. In the administrative console, expand Servers, and click Application servers > server_name to open the configuration tab for the server.
  2. From Container settings, expand SIP Container settings, and click SIP container.
  3. From Additional properties, select Custom properties > New .
  4. On the settings page, type the custom property to configure in the Name field, and then type the value of the custom property in the Value field.
  5. Click Apply or OK.
  6. Click Save on the console task bar to save your configuration changes.
  7. Restart the server.

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.

bootstrap.batch.size

Specifies the number of replication tasks to send in a batch for configuring bootstrap replication throttle. This prevents a server from running into overload when replicating data to newly started servers. The default behavior is disabled throttling (batch size = -1).

Data type Integer
Default -1

bootstrap.blocking.delay

Specifies the delay between batches of replication tasks during bootstrap. When bootstrap.batch.size is enabled (with a positive number), the default for the delay time is 0.5 seconds, unless set differently.

Data type Integer
Default Disabled

enable.system.headers.modify

Specifies whether the application has access to headers that are otherwise restricted.

Data type Boolean
Default False

end.of.service.replication

Specifies whether changes are buffered until the thread for a siplet is about to end. If the value is set to true, then each change is buffered until the thread for the siplet is about to end.

Data type Boolean
Default false

immediate.replication

Specifies whether each change is immediately sent to the Data Replication Service. When this property is set to true, when replication is issued from a non-SIP container thread, the replication is immediately performed on the calling thread. When this property is set to false, the changes are buffered, and replication does not occur until all changes are made.

Setting this property to true might have a negative impact on performance.

Data type Boolean
Default true

on.outgoing.message.replication

Specifies whether changes are buffered until a siplet issues a request.send() or response.send() call. If the value is set to true, then each change is buffered until a siplet issues a request.send() or response.send() call.

Data type Boolean
Default false

replicate.with.confirmed.dialog.only

Specifies whether to replicate the application session, even when no dialogs are confirmed. If the value is set to false, then the application session is replicated immediately after the session is created. Otherwise, the application session is only replicated when an associated dialog is confirmed.

Data type String
Default False

com.ibm.sip.sm.lnm.size

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 container. The proxy server routes messages to the correct container using the logical name found in the message. The value must be higher than 1.

Data type Integer
Default 10

auth.int.enable

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

com.ibm.websphere.sip.security.tai.usercachecleanperiod

Specifies the clean security subject cache period in minutes.

Data type Integer
Default 15

com.ibm.ws.sip.tai.DisableSIPBasicAuth

Specifies whether to allow basic authentication for SIP.

Data type String
Default False

com.ibm.webspehere.sip.security.digest.ldap.cachecleanperiod

Specifies the clean Lightweight Directory Access Protocol (LDAP) cache period in minutes.

Data type Integer
Default 120

pws_atr_name

Specifies the LDAP attribute name that stores the user password.

Data type String
Default userpassword

javax.sip.transaction.invite.auto100

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

javax.sip.force.connection.reuse

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.

Data type String
Default True

javax.sip.hide.message.body

Specifies whether to hide message content in log files. Set the value of this property to true to remove the message body text from SIP messages printed in the log files. This property only affects the representation of the messages in log files.

Data type String
Default False

javax.sip.hide.message.headers [Fix Pack 31 or later]

Specifies to hide the specified message header field names in log files. The value of this property is a comma-separated list of header field names that you want removed from SIP messages printed in the log files. This property only affects the representation of the messages in log files.

Data type String
Default None

javax.sip.hide.request.uri [Fix Pack 31 or later]

Specifies to hide request URIs in log files. Set the value of this property to true to remove request URIs from SIP messages printed in the log files. This property only affects the representation of the messages in log files.

Data type Boolean
Default False

javax.sip.PATH_MTU

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 higher 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 discarded. See the RFC 3261-18.1.1 specification for details.

Data type Integer
Default 1500

javax.sip.OUTBOUND_PROXY

Specifies the fixed address for routing all outbound SIP messages. The format is address:port/transport, such as 1.2.3.4:5065/tcp.

Best Practice: Do not use this property if the container is fronted by an application server SIP proxy.
Data type String
Default null

javax.sip.trace.msg.in

Specifies whether to print incoming messages to a SystemOut.log file.

Data type String
Default False

javax.sip.trace.msg.out

Specifies whether to print outbound messages to a SystemOut.log file.

Data type String
Default False

javax.sip.stat.report.interval

Specifies the amount of time, in milliseconds, for reporting dispatch and timer statistics to a SystemOut.log file. A value of 0 indicates no report.

Data type Integer
Default 0

javax.sip.detect.pre.escaped.params

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

DigestPasswordServerClass

Specifies types of user registries that are supported, except LDAP. To configure DigestTAI without the LDAP user registry, complete the following steps. [Updated in November 2010]
  1. Create a class that implements this interface: com.ibm.ws.sip.security.digest.DigestPasswordServer
  2. Add the following property to the SIP container custom property:
    • Default LdapPasswordServer
  3. Ensure that all users declared by the impl class are declared in the user registry configured for the product security.
[Updated in November 2010]
nov2010
Data type String
Default impl

javax.sip.bind.retries

Specifies the amount of time, in milliseconds, between attempts to start the SIP channel if the SIP port is busy with another process during server startup.

Data type Integer
Default 60

javax.sip.bind.retry.delay

Specifies the delay, in milliseconds, between attempts to start the SIP channel if the SIP port is busy with another process during server startup.

Data type Integer
Default 5000

javax.sip.transaction.timer.t1

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 Integer
Default 500

javax.sip.transaction.timer.t2

Specifies the maximum time in milliseconds before retransmitting non-invite requests and invite responses for timer T2 for the RFC 3261 specification.

Data type Integer
Default 4000

javax.sip.transaction.timer.t4

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 Integer
Default 5000

javax.sip.transaction.timer.a

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

javax.sip.transaction.timer.b

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

javax.sip.transaction.timer.d

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 Integer
Default 32000

javax.sip.transaction.timer.e

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

javax.sip.transaction.timer.f

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

javax.sip.transaction.timer.g

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

javax.sip.transaction.timer.h

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

javax.sip.transaction.timer.i

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

javax.sip.transaction.timer.j

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

javax.sip.transaction.timer.k

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

javax.sip.transaction.timer.non.invite.server

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 Integer
Default 34000

javax.sip.transaction.timer.invite.server

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 Integer
Default 32000

javax.sip.transaction.timer.cancel

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

SIP_RFC3263_nameserver [Fix Pack 11 or later]

Specifies whether to allow a SIP URI to be resolved through Domain Name System (DNS) into the IP address, port, and transport protocol of the next hop.

The value of the property is a string containing one or two address and port tuples, where two tuples are separated by a space. The following examples specify a one address and port tuple or a two address and port tuple:
  • dottedDecimalAddress@.port
  • hostname.domain@port
  • IPV6address@port
The following example values represent a single tuple:
  • 1.2.3.4@53
  • example.com@53
  • a:b:c::d@53
The following example values represent two tuples separated by a space:
  • 1.2.3.4@53 example.com@53
  • a:b:c::d@53 9.32.211.14@53
Data type String
Default null

thread.message.queue.max.size

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.

This value represents the total number of messages for all queues and reflects the state of the CPU. When the CPU approaches 100 percent, the maximum value for this custom property is reached quickly. Configure your system to limit the queue size and prevent the queue from reaching this threshold.

Data type Integer
Default 1000

weight.overload.watermark

Specifies the threshold value for the internal weight calculated by the container. When the container calculates the internal weight to be higher than the value specified, an overloaded container becomes available for service again.

This custom property represents a percentage of the maximum internal weight, such as 30 percent when the default value is set. When the high-water mark, or maximum threshold, is exceeded, the container waits until the weight drops below the maximum weight. This value cannot exceed 10.

Data type Integer
Default 3

sip.container.heartbeat.enabled [Fix Pack 11 or later]

Specifies whether or not SIP network outage detection is enabled for the SIP container. SIP network outage detection supports the SIP proxy to send keepalive messages to the SIP container if the value of this property is set to true.

If the value is set to false for the SIP container, then this property has no effect on the SIP proxy. However, if the value is set to true for the SIP container, then set the value to true for the SIP proxy server to ensure that keepalive messages are answered at the SIP container and not presented to the application.

Data type String
Default true



Related tasks
Browse all SIP topics
Configuring the SIP container
Creating a proxy server
Reference topic    

Terms of Use | Feedback

Last updated: Feb 19, 2011 5:25:36 AM CST
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v610web&product=was-nd-mp&topic=rjpx_sipcontaincustprops
File name: rjpx_sipcontaincustprops.html