Creating and Editing a SIP Listener

To create a SIP listener, in the Admin Console, expand the Configuration node, select the configuration you want to configure, then select SIP service, then the SIP Listeners node, and click New. Define the SIP listener settings and click Save.

Alternatively, you can use the asadmin create-sip-listener command. A sample command is as follows:

asadmin create-sip-listener --siplisteneraddress=127.0.0.1 --siplistenerport=5066 --transport=udp_tcp mysiplistener

The following is a list of SIP listener attributes:

• Name (id): Provide a unique identifier for your new listener.

• Network Address (address): Enter 0.0.0.0 if you want the listener to listen on all IP addresses for the server, using a unique port value. Otherwise, type a valid IP address for the server.

• Listener Port (port): Enter a unique port value if the Network Address field is 0.0.0.0, or the desired port value if you are using another IP address.

• Enabled (enabled): 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).

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

• External SIP Port (external-sip-port): Specifies the external SIP port. If specified, this value overrides the value of the external SIP port in the SIP container.

• External SIPS Port (external-sips-port): Specifies the external SIP port. If specified, this value overrides the value of the external SIPS port in the SIP container.

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

• Type (type): Valid values for this options are internal, external, and default. If set to internal, this listener will be used only for proxying by the converged load balancer. If set to external, this listener will be used only for SIP user agents. If set to default, the listener will be used by SIP user agents and converged load balancers. By default, the value this option is set to default.

To change an attribute of the SIP listener you can use the asadmin set command or you can use the Admin Console. To edit a SIP listener, in the Admin Console, expand the Configuration node, select the configuration you want to configure, then select SIP service, then the SIP Listeners node, and choose the SIP listener to edit. Edit the SIP listener settings and click Save.

A sample command to change the SIP port of a SIP listener is: asadmin set server.sip-service.sip-listener.sip-listener-1.port=5065