Skip to end of metadata
Go to start of metadata

In this section:

Modified: for 4.2.1

 

Use this command to configure SIP signaling ports for a specified zone. For additional routing details, see Routing Mechanisms page.

If a zone's sipSigPort is configured for transportProtocolsAllowedsip-tls-tcp, SBC increments the configured portNumber by 1 and uses it as the new port number for SIP over TLS signaling. SBC then opens a TCP socket for SIP over TLS for the new TCP port number.

Example: When sipSigPort is configured with a portNumber of 5060 and transportProtocolsAllowed = sip-tls-tcp, SBC listens on TCP port 5061 for SIP over TLS.

Each signaling port within an Address Context must use a unique IP address.

The SBC 52x0 and SBC 7000 systems are enhanced in 4.2.0 release to ease some restrictions on which IP Interfaces may coexist in an IP Interface Group. The user may now create IP Interface Groups containing sets of IP interfaces that are not "processor friendly" (i.e. carried on physical Ethernet ports served by separate processors). However, restrictions exist regarding the usage of such Interface Groups.

For complete details, see Configuring IP Interface Groups and Interfaces.

The above enhancement does not apply to the SBC 51x0 systems which have only two physical media ports. IP interfaces from the two physical ports may be configured within the same IP Interface Groups without restriction.

Command Syntax

% set addressContext <name> zone <name> sipSigPort <index #>
	dscpValue <0-63>
	ipAddressV4 <IPv4 address>
	ipAddressV6 <IPv6 address>
	ipInterfaceGroupName <name>
	maskIpAddressforRcb <disabled | enabled>
	maskPortforRcb <disabled | enabled>
	mode <inService | outOfService>
	portNumber <1-65535>
	recorder <disabled | enabled>
	sctpProfileName <name>
	siprec <disabled | enabled>
	state <disabled | enabled>
	tcpConnectTimeout <0-180>
	tcpKeepaliveInterval <60-120 seconds>
	tcpKeepaliveProbes <1-10>
	tcpKeepaliveTime <60-7200 seconds>
	tlsProfileName <name>
	transportProtocolsAllowed <sip-sctp | sip-tcp | sip-tls-tcp | sip-udp>

// Mandatory parameters:

<index #>
dscpValue
ipInterfaceGroupName
portNumber
recorder
sctpProfileName
siprec
state
tcpConnectTimeout
tcpKeepaliveInterval
tcpKeepaliveProbes
tcpKeepaliveTime
tlsProfileName
transportProtocolsAllowed

// Non-mandatory parameters:

ipAddressV4
ipAddressV6
maskIpAddressforRcb
maskPortforRcb
mode

Command Parameters

Table : Zone SIP Signaling Port Parameters

Parameter Length/Range Description
<index #> 1-4096

The Sip Signaling Port for this zone.

dscpValue   0-63 DSCP value for packets from this SIP Signaling Port. (default = 0).
ipAddressV4 N/A IPv4 address for this SIP signaling port in dotted decimal format (for example 128.127.50.224).
ipAddressV6 N/A

IPv6 address for this SIP signaling port in hexadecimal/colon format.   (for example, 1280:1276:3350:2224:2222:3333:8888:1245 or fd00:21:445:128::7880).

maskIpAddressforRcb

N/A

Use this flag to fetch the RCB value for a user using only the source port and not the source IP address for generating the hashKey.

  • disabled (default)
  • enabled

The flag maskPortforRcb must be disabled to use this flag. Both flags cannot be enabled at the same time.


maskPortforRcb

N/A

Use this flag to fetch the RCB value for a user using only the source IP address and not the source port for generating hashKey

  • disabled (default)
  • enabled

The flag maskIpAddressforRcb must be disabled to use this flag. Both flags cannot be enabled at the same time.


mode   N/A

Operational mode for this SIP Signaling Port.

  • inService (default)
  • outOfService
 portNumber  1-65535

UDP/TCP port number of SIP Signaling Port (default = 5060).

If transportProtocolsAllowed is “sip-udp”, ensure that portNumber value is outside the configured system-wide mediaPortRange unless portNumber = default value “5060”. If portNumber is set to a number other than “5060”, the user is prompted to continue with the configuration.

For example, if media port range is 5000-6000, portNumber should be configured starting with 6002 (6001 cannot be used as its used for RTCP by default).

To view mediaPortRange values, use the command:

> show configuration details system media mediaPortRange

recorder  N/A

Enable flag to indicate the port is being used for recording.

  • disabled (default)
  • enabled

sctpProfileName

1-23 SCTP profile name.
siprec   N/A

Administrative state of the SIP Signaling Recorder Port. Enable flag to use the port for recording using SIPRec Protocol.

  • disabled (default)
  • enabled

The SIPRec feature is controlled by a system-wide SBC license (SBC-SIPREC). If the license is not available, any SIPRec recording returned by a PSX is ignored.

Not applicable to SBC Software Edition.


state   N/A Administrative state of the SIP Signaling Port.
  • disabled (default)
  • enabled
tcpConnectTimeout   0-180

The maximum time (in seconds) the SBC waits for a TCP connection to complete. (default = 5).

This application level configuration has NO impact on any IP layer re-transmission of SYN.

tcpKeepaliveInterval 60-120

The number of seconds between TCP Keep-alive probes (default = 60).

tcpKeepaliveProbes 1-10

The maximum number of TCP Keep-alive probes to send until SBC decides that the connection is broken (default = 2).

tcpKeepaliveTime 60-7200 The number of seconds a TCP connection remains idle before TCP Keep-alive probes are sent out. A value of "0" disables this parameter (default = 0).
tlsProfileName N/A TLS Profile name used by this Signaling Port.
transportProtocolsAllowed N/A

Transport protocols allowed on this signaling port.

  • sip-udp – (default) BIT 0
  • sip-tcp – BIT 1
  • sip-tls-tcp – BIT 2
  • sip-sctp – BIT   3

The SBC supports only UDP towards the recording server.


Command Example

The following example sets tcpKeepaliveTime to 90 seconds, tcpKeepaliveInterval to 60 seconds and tcpKeepaliveProbes count to 2.

% set addressContext default zone ZONE_SIPART_AS sipSigPort 2 tcpKeepaliveTime 90 tcpKeepaliveInterval 60 tcpKeepaliveProbes 2
% commit
 
% show details addressContext default zone ZONE_SIPART_AS sipSigPort 2
ipInterfaceGroupName      LIG2;
ipAddressV4               10.7.14.179;
portNumber                5060;
mode                      inService;
state                     enabled;
recorder                  disabled;
siprec                    disabled;
tcpConnectTimeout         5;
dscpValue                 0;
tlsProfileName            defaultTlsProfile;
transportProtocolsAllowed sip-tcp;
sctpProfileName           defaultSctpProfile;
tcpKeepaliveTime          90;
tcpKeepaliveInterval      60;
tcpKeepaliveProbes        2;