sip-container (Sun GlassFish Communications Server 1.5 Administration Reference)

Sun GlassFish Communications Server 1.5 Administration Reference

sip-container

Configures the Session Initiation Protocol (SIP) container.

Superelements

config

Subelements

The following table describes subelements for the sip-container element.

Table 1–186 sip-container Subelements


Element	Required	Description
session-config	zero or one	Specifies session configuration information for the SIP container.
stack-config	zero or one	Specifies the configuration of a stack of layers, typically related to protocols such as SIP.
property	zero or more	Specifies a property or a variable.

Attributes

The following table describes attributes for the sip-container element.

Table 1–187 sip-container Attributes


Attribute	Default	Description
`external-address`	determined by SIP container based on network interfaces	Specifies the address that is externally visible to clients. The clients see the entire cluster. In some cases, when providing addresses to clients, the servers must use this address to make sure the client can call back the load-balanced cluster instead of the individual server instance that provided the callback.
`external-sip-port`	SIP port of default sip-listener (developer profile)	Specifies the SIP port that is externally visible to clients for call backs.
`external-sips-port`	SIPS port of default sip-listener (developer profile)	Specifies the secure SIP (SIPS) port that is externally visible to clients for call backs.

Properties

The following table describes properties for the sip-container element.

Table 1–188 sip-container Properties


Property	Default	Description
`olpInserted`	`false`	If `true`, the overload protection manager is enabled in the SIP container and operates according to `CpuOverloadRegulation`, `MemOverloadRegulation`, and other `sip-container` properties. Overload regulation protects the SIP container from too high CPU usage.
`CpuOverloadRegulation`	`false`	If `true`, CPU overload protection is enabled. Applicable only if `olpInserted` is set to `true`.
`MemOverloadRegulation`	`false`	If `true`, memory overload protection is enabled. Applicable only if `olpInserted` is set to `true`.
`SampleRate`	`2`	Specifies the sample rate in seconds for updating threshold levels. Allowed values are `1` to `120` seconds.
`NumberOfSamples`	`5`	Specifies the number of consecutive samples needed before a threshold is raised. Allowed values are `2` to `20`.
`SrThreshold`	`90`	Specifies the CPU usage threshold level for SIP subsequent requests. Allowed values are `0` to `100`. Must be set higher than the `IrThreshold` value. Any `503` error responses are sent above the threshold level. Applicable only if `CpuOverloadRegulation` is set to `true`.
`IrThreshold`	`70`	Specifies the CPU usage threshold level for SIP initial requests. Allowed values are `0` to `100`. Any `503` error responses are sent above the threshold level. Applicable only if `CpuOverloadRegulation` is set to `true`.
`MemIrThreshold`	`85`	Specifies the memory usage threshold level for SIP initial requests. Allowed values are `0` to `100`. Any `503` error responses are sent above the threshold level. Applicable only if `MemOverloadRegulation` is set to `true`.
`HttpThreshold`	`70`	Specifies the CPU usage threshold level for HTTP requests. Allowed values are `0` to `100`. Any `503` error responses are sent above the threshold level. Applicable only if `CpuOverloadRegulation` is set to `true`.
`MemHttpThreshold`	`85`	Specifies the memory usage threshold level for HTTP requests. Allowed values are `0` to `100`. Any `503` error responses are sent above the threshold level. Applicable only if `MemOverloadRegulation` is set to `true`.
`MmThreshold`	`90`	Specifies the CPU usage threshold level when all messages are dropped. Allowed values are `0` to `100`. Any `503` error responses are sent above the threshold level. Applicable only if `CpuOverloadRegulation` is set to `true`.
`MemMmThreshold`	`99`	Specifies the memory usage threshold level when all messages are dropped. Allowed values are `0` to `100`. Any `503` error responses are sent above the threshold level. Applicable only if `MemOverloadRegulation` is set to `true`.