Page History
| Add_docset_workflow | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Instructions for modifying/creating a SIP Server Table entry are below. To add a SIP Server table, see Managing SIP Server Tables.
Creating an Entry in a SIP Server Table
- In the left navigation pane, go to SIP > SIP Server Tables. Click on the desired SIP Server Table.
From the Create SIP Server drop down list, select IP/FQDN or DNS-SRV. The associated configuration screen is displayed.
Note title Note Federated IP addresses and FQDNs specified in a SIP Server Table are whitelisted.
- Configure the options. See Field Definitions.
| Info |
|---|
|
Create SIP Server: DNS SRV
| Caption | ||||
|---|---|---|---|---|
| ||||
|
Create SIP Server: IP/FQDN
| Caption | ||||
|---|---|---|---|---|
| ||||
|
Modifying an Entry in a SIP Server Table
- In the left navigation pane, go to SIP > SIP Server Tables.
- Select the desired SIP Server Table.
- Click the expand (
) icon next to the entry you wish to modify.
Edit the entry properties as required. See Field Definitions.
Caption 0 Figure 1 SIP Server Table - IP/FQDN Example Screen 
Resequencing an Entry in a SIP Server Table
| Include Page | ||||||
|---|---|---|---|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
Server Host - Field Definitions
| Table of Contents | ||||
|---|---|---|---|---|
|
Server Host - For IP/FQDN only
Server Lookup
| Panel | ||||
|---|---|---|---|---|
| ||||
This field is populated automatically when you add a SIP Server table entry and select IP/FQDN Lookup from the Create SIP Server drop down box. IP/FQDN enables the SBC to select the server containing the specified IP address or Fully Qualified Domain Name (FQDN) to which this Signaling Group sends SIP messages. |
Priority
| Panel | ||||
|---|---|---|---|---|
| ||||
Specifies the priority of this server. The priority is used to order the server when more than one is configured. If Load Balancing is configured as Round Robin or First in the SIP Signaling group, the Priority field is not used to determine the priority of the server. See Creating and Modifying SIP Signaling Groups. |
Host
| Panel | ||||
|---|---|---|---|---|
| ||||
Specifies an IP address or Fully Qualified Domain Name (FQDN) to which this Signaling Group sends SIP messages. If an FQDN is configured all the associated servers are included and used according to the server selection configuration element. |
Port
| Panel | ||||
|---|---|---|---|---|
| ||||
| Specifies the port number to which SIP messages are sent. |
Protocol
| Panel | ||||
|---|---|---|---|---|
| ||||
| Specifies the protocol to use for sending SIP messages. Valid entry: UDP, TCP, or TLS. Depending upon the entry you select, different configuration options are available. These are noted where necessary. |
TLS Profile
| Panel | ||||
|---|---|---|---|---|
| ||||
| If TLS is selected from the Protocol field, this specifies the TLS profile the server will use for secure SIP messages. |
Server Host - For DNS SRV only
Server Lookup
| Panel | ||||
|---|---|---|---|---|
| ||||
| This field is populated automatically when you add a SIP Server table entry and select DNS-SRV Lookup from the SIP Server drop down box. DNS SRV enables the SBC to populate SIP server entries in the SIP Server Table based on SRV records (specified by domain, service, and protocol supported). SIP entries are updated automatically as servers change and become available/unavailable. |
| Pagebreak |
|---|
Host IP Version
| Panel | ||||
|---|---|---|---|---|
| ||||
| Specifies the IP version to which this Signaling Group uses to send messages. Valid entries: IPv4 or IPv6. |
Domain Name/FQDN
| Panel | ||||
|---|---|---|---|---|
| ||||
| This field specifies the domain name supported in a SIP server from which the SBC requests information (through the DNS SRV Query). This field is used in combination with the Service and Protocol fields in the DNS SRV Query to request a list of eligible SIP servers. Valid entry: name of domain (i.e., example.com). |
Service Name
| Panel | ||||
|---|---|---|---|---|
| ||||
| This field specifies the service name (i.e., SIP) that will be used in the DNS SRV query. This field defaults to "sip" but can be overwritten with any text string (i.e., sipinernaltls). This field is used in combination with the Domain Name and Protocol fields in the DNS SRV Query to request a list of eligible SIP servers. Valid entry: name of service (i.e., SIP). |
Protocol
| Panel | ||||
|---|---|---|---|---|
| ||||
| This field specifies the protocol (i.e, UDP, TCP, or TLS) supported in a SIP Server from which the SBC requests information (through the DNS SRV query). This field is used in combination with the Domain Name and Service Name fields in the DNS SRV Query to request a list of eligible SIP servers. Valid entry: select from the drop down list. |
TLS Profile
| Panel | ||||
|---|---|---|---|---|
| ||||
| If TLS is selected in the Protocol field, this specifies the TLS profile the server will use for secure SIP messages. |
Remote Authorization and Contacts - Field Definitions
Remote Authorization Table
| Panel | ||||
|---|---|---|---|---|
| ||||
| Specifies a Remote Authorization table for this SIP Server from the list of authorization tables defined in the Remote Authorization Tables.The Remote Authorization table is used by a Signaling group when a challenge (401/407) is issued by the server. The table contains a realm, user name, and password. They are used to provide credentials to the server issuing the challenge. |
Contact Registrant Table
Specifies a Contact Registration Table for this SIP Server from the list of registration tables defined in the Contact Registrant Tables.
The Contact Registration is used by a Signaling Group to register one or more contacts to a registrar. The contact information contains the SIP address of record and the methods which can be used to establish sessions to this Signaling group. Valid entry: Select from the list of Contact Registrant Tables or select None. If you select a Contact Registrant from the list, the following fields are displayed: Clear Remote Registration on Startup, Contact URI Randomizer, and Stagger Registration.
| Note |
|---|
| If Fwd. Reg. After Local Processing is selected as the SIP Mode, the selected SIP Server Table for that same Signaling Group should not be configured with a Contact Registrant Table. The SBC does not support Fwd Reg. After Local Processing and a Contact Registrant Table in the same Signaling Group. |
Clear Remote Registration on Startup
| Panel | ||||
|---|---|---|---|---|
| ||||
| Specifies whether Remote Registration is cleared upon startup. When enabled, on power-up a Register with Expires: 0 ("Unregister") is first sent. When complete, a Register with Expires: non-0 ("Register") is sent. Valid entries: True (enables remote registration to be cleared at power-up) or False (disables remote registration from being cleared at power-up). This field is visible only when Contact Registrant Table is set to a value other than None. Default entry: False. |
Contact URI Randomizer
| Panel | ||||
|---|---|---|---|---|
| ||||
| Enables the username portion of the Contact URI in the registration for Request-URIs to contain a randomized value. When enabled, this random value is generated and put into the username portion of the Contact-URI of each outgoing Register message. The random user portion is saved and compared to the incoming Invite Request-URIs. If the Prefix of the Request-URI contains Hz1q6R, and there is a match, Hz1q6R is stripped and the remaining number is used to route. If there is not a match, but the first six digits are Hz1q6, the Invite Request-URI is ignored and no response is sent. If Hz1q6R is not contained in the Prefix, the number is sent as-is for routing. This field is visible only when the Contact Registrant Table is set to a value other than None. Valid entries: True (contact URI Randomizer is used) or False (contact URI Randomizer is not used). Default entry: False. |
Stagger Registration
| Panel | ||||
|---|---|---|---|---|
| ||||
| Enables Registration (and Unregistration) Requests to be staggered by one second if more than one Contact Registrant entry is in the Contact table. This field is visible only when Contact Registration Table is set to a configuration other than None. Valid entry: True (registration requests are staggered) or False (registration requests are not staggered). Default entry: False. When Stagger Registration is set to True, the maximum number of contact registrant entries configured should not exceed 500. If more than 500 are entered in configuration, they will be dropped and an ERROR trace is generated. |
Retry Non-Stale Nonce
| Panel | ||||
|---|---|---|---|---|
| ||||
| In 401 message, when stale = false, this field enables the SBC to either set the failed retry timer and re-attempt to send Register with same credentials at expiration (True) or not resend a Register with the same credentials (False). This field is available when a Remote Authorization is selected. |
Authorization on Refresh
| Panel | ||||
|---|---|---|---|---|
| ||||
| Enables SIP to remove the Remove an Authorization header from REGISTER requests for refresh/deletion. Valid entry: True (SIP removes Authorization header for refresh/deletion) or False (header stays the same) Default entry: False. |
Session URI Validation
| Panel | ||||
|---|---|---|---|---|
| ||||
| Enables the setting for matching the session URI when a user name is randomized as part of the Contact URI Randomizer field (in the Contact URI Randomizer, a random value is generated and put into the username portion of the Contact-URI of each outgoing Register message). The Session URI validation sets the matching requirement for this field. Valid entry: Strict or Liberal. |
Transport - Field Definitions
Monitor
| Panel | ||||
|---|---|---|---|---|
| ||||
Specifies the method to monitor server.
|
Keep Alive Frequency
| Panel | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
Specifies how often, in seconds, the
|
Recover Frequency
| Panel | ||||
|---|---|---|---|---|
| ||||
| Specifies frequency in seconds to check server to determine whether it has become available. Default entry: Anonymous. Visible only when SIP Options is selected from the Monitor field. |
Local Username
| Panel | ||||
|---|---|---|---|---|
| ||||
Local user name of the
|
Peer Username
| Panel | ||||
|---|---|---|---|---|
| ||||
| User name of the SIP Server. Visible only when SIP Options is selected from the Monitor field. |
Connection Reuse - Field Definitions
The configuration options in this section are available only when when Protocol is set as TCP or TLS.
Reuse
| Panel | ||||
|---|---|---|---|---|
| ||||
| Specifies whether or not sockets will be reused or shared. Select from the drop down list: True (sockets are reused) or False (sockets are shared). |
Sockets
| Panel | ||||
|---|---|---|---|---|
| ||||
| Specifies number of re-usable sockets. Valid entry: 1 - 4. |
Reuse Timeout
| Panel | ||||
|---|---|---|---|---|
| ||||
| Specifies whether or not a socket will timeout. If set to Limited, the Timeout Limit field is displayed. |
Timeout Limit
| Panel | ||||
|---|---|---|---|---|
| ||||
| Specifies the number of minutes that a socket remains connected to the server. This field is displayed only if Protocol is set as TCP or TLS, and Reuse Timeout is set as Limited. Valid entry: 5 - 1440 minutes. |
SRV Servers Table - Field Definitions
This table is in view-only mode and available only when the Server Lookup field is set as DNS SRV in the SIP Server Table. To view this table, go to SIP > SIP Server Tables and click on the desired SIP Server Table entry. The populated values in this table are determined by the administrator for the DNS server; ranges and possible values are detailed below.
Server ID
| Panel | ||||
|---|---|---|---|---|
| ||||
| A number generated internally that is used to identify the SIP Server. |
FQDN/Domain Name
| Panel | ||||
|---|---|---|---|---|
| ||||
| Based on the response from the DNS SRV Query, the SBC populates this table with the configured SIP server entries (IP or FQDN). The SBC will refresh the server entries by re-trying the same DNS SRV query until the Time to Live for the SRV record expires. This table is updated automatically as servers change and become available/unavailable. |
Protocol
| Panel | ||||
|---|---|---|---|---|
| ||||
| This field specifies the protocol (i.e, UDP, TCP, or TLS) supported in the SIP Server. |
Port
| Panel | ||||
|---|---|---|---|---|
| ||||
| Specifies the port number to which SIP messages are sent. |
Time to Live
| Panel | ||||
|---|---|---|---|---|
| ||||
| Amount of time the SRV record is able to be retried. This range is dependent on the value sent from the DNS server. |
Priority
| Panel | ||||
|---|---|---|---|---|
| ||||
| Priority determines how servers are selected. A server with a lower number priority is selected first. If that server is unavailable, the next server with the higher priority number is selected. Servers with the same priority value are selected based on weight parameter. For more information, see Weight. |
Weight
| Panel | ||||
|---|---|---|---|---|
| ||||
| The weight field specifies a relative weight for SIP server entries (range 0 - 65535), which is used to determine the selection of the server if the priority value is the same between two servers. A server with a larger weight is given a higher probability of being selected than a server with a lower weight. The weight selection algorithm is per RFC 2782. |
| Pagebreak |
|---|
Overview
Content Tools