Sun GlassFish Communications Server 2.0 Administration Reference

Attributes

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

Table 1–199 sip-listener Attributes

Attribute 

Default 

Description 

id

none 

The unique listener name. A sip-listener name cannot begin with a number.

address

none 

IP address of the listener. Can be in dotted-pair or IPv6 notation. Can be any (for INADDR_ANY) to listen on all IP addresses. Can be a hostname.

port

5060 (non-TLS)

5061 (TLS)

Port number on which the listener listens. Legal values are 1 - 65535. On UNIX, creating sockets that listen on ports 1 - 1024 requires superuser privileges.

transport

udp_tcp

(optional) Specifies the type of transport layer protocol. Allowed values are udp_tcp and tls.

enabled

true

(optional) Determines whether the listener is active. If set to false, any attempts to connect to the listener result in a socket exception (java.net.ConnectException).

type

default

Specifies the listener type for machines with multiple IP addresses that have separate internal and external communication. Allowed values are as follows: 

  • internal — Used strictly for proxying by the load balancer.

  • external — Used only by user agents and not by the load balancer.

  • default — Can be used by user agents or the load balancer.

external-sip-address

none 

Specifies the external address for a listener with a type of external.

external-sip-port

none 

Specifies the external port for a listener with a type of external.