About this Resource

Modified: for 1.3.0

Defines a SIP Server Entry resource to describe a given SIP Server Table.

REST API Methods for this Resource

Resource Schema

Configuration

Parameter Name Required Service Affecting Data Type Default Value Possible Values Description
ServerLookupYesNoEnum0Possible values:
  • 0 - eLkUpIpFQDN
  • 1 - eLkUpSRV
 Specifies the method to use to lookup SIP servers
  • IP/FQDN
    - Do a typical DNS lookup of FQDN.
  • DNS SRV
    - Send an SRV record to DNS server then upon reply lookup FQDN's via DNS.
A maximum of 99 entries can be added to this table entry. When added via REST any Row ID greater than 99 will be rejected.
ServerTypeYesNoEnum0Possible values:
  • 0 - eConventionalSrvr
  • 1 - eSrvRecordTemplateSrvr
  • 2 - eSrvRecordSrvr
 Specifies the method to use to lookup SIP servers
  • eConventionalSrvr
    - A configured server entry defined by IP or FQDN.
  • eSrvRecordTemplateSrvr
    - This is not an actual server but a template which will populate the server(s) once the SRV Query gets a response from DNS.
  • eSrvRecordSrvr
    - The actual server created after SRV Query.
WeightYesNoint0Possible values:
  • 0 - Minimum
  • 65535 - Maximum
 Specifies the weight of the server in case it's defined in the SRV record.
HostYesNostringnone256 - Max Length Specifies the IP address or FQDN where 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.
HostIpVersionYesNoEnum0Possible values:
  • 0 - eVersionPreferIPv4
  • 1 - eVersionPreferIPv6
 Specifies whether the FQDN should be resolved into IPv4 addresses or IPv6 addresses. If this is a SRV record, this field specifies whether the resulting FQDNs are resolved into IPv4 or IPv6 addresses. By default, the SBC resolves the FQDN into IPv4 addresses.
DomainNameYesNostringnone256 - Max Length Specifies the Domain where this Signaling Group sends SRV queries.
ServiceNameNoNostringsip64 - Max Length The name of the service to be placed in the SRV request.
PortYesYesint5060Possible values:
  • 1 - Minimum
  • 65535 - Maximum
Specifies the port number to send SIP messages.
TransportSocketNoNoint0Possible values:
  • 0 - Minimum
  • 10 - Maximum
 Specifies number of re-usable sockets

This option is available when ReuseTransport is set to True. When ReuseTransport is false, this needs to be set to 0

ReuseTransportNoNoEnum1Possible values:
  • 0 - btFalse
  • 1 - btTrue
Specifies whether sockets will be reused or shared. Only valid for TCP or TLS
ReuseTimeoutNoNoint1000Possible values:
  • 0 - Minimum
  • 1440 - Maximum
 Specifies the number of minutes that a socket remains connected to the server.

This option is available when ReuseTransport is Enabled. A value of 0 means ReuseTimeout is set Forever*. Otherwise, the valid range is 5-1440

ProtocolYesNoEnum1Possible values:
  • 0 - eTrNone
  • 1 - eTrUDP
  • 2 - eTrTCP
  • 3 - eTrTCP_UDP
  • 4 - eTrTLS
  • 5 - eTrTLS_UDP
  • 6 - eTrTLS_TCP
  • 7 - eTrTLS_TCP_UDP
  • 8 - eTrCount
  • 9 - eTrSCTP
 Specifies the protocol to use for sending SIP messages
  • UDP
    - Send messages using UDP.
  • TCP
    - Send message using TCP.
  • TLS
    - Send message using TLS.
MonitorNoNoEnum0Possible values:
  • 0 - eMonitorNone
  • 1 - eMonitorOptions
  • 2 - eMonitorPing
 Specifies the method to monitor server
  • None
    - no monitoring of this server occurs
  • SIP options
    - an Options message is sent to the server
KeepAliveFrequencyNoNoint30Possible values:
  • 0 - Minimum
  • 300 - Maximum
Specify frequency in seconds to determine server availability.

This configuration is available when Monitor is set to SIP Options . If Monitor is not set to SIP Options, this value needs to be 0. Otherwise, this value needs to be in the range 30-300*

RecoverFrequencyNoNoint5Possible values:
  • 0 - Minimum
  • 300 - Maximum
Specify frequency in seconds to check server to determine whether it has become available.

This configuration is available when Monitor is set to SIP Options . If Monitor is not set to SIP Options, this value needs to be 0. Otherwise, this value needs to be in the range 5-300*

LocalUserNameNoNostringAnonymous64 - Max Length The local username of the SBC.

This configuration is available when Monitor is set to SIP Options

PeerUserNameNoNostringAnonymous64 - Max Length The username of SIP server.

This configuration is available when Monitor is set to SIP Options

PriorityYesNoint0Possible values:
  • 0 - Minimum
  • 16 - Maximum
Specifies the priority of this server. The priority is used to order the server when more than 1 is configured.
RemoteAuthorizationTableIDNoNoint0Possible values:
  • 0 - Minimum
  • 65534 - Maximum
 Specifies a Remote Authorization table for this SIP Server, from a 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. There are used to provide credentials to he server issuing the challenge.
ContactRegistrantTableIDNoNoint0Possible values:
  • 0 - Minimum
  • 65534 - Maximum
 Specifies a Contact Registration Table for this SIP Server,from a 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.
StaggerRegistrationNoNoEnum0Possible values:
  • 0 - btFalse
  • 1 - btTrue
 If more than one Contact Registrant Entry is in Contact table, stagger Register Requests by 1 second. Applies to UnRegister also. This will only be displayed and applicble if Contact Registract Table is something other than None.
ClearRemoteRegistrationOnStartupNoNoEnum0Possible values:
  • 0 - btFalse
  • 1 - btTrue
 When enabled, a Register with Expires: 0 will be sent to the SIP Server on power up. After the Unregister (Expires: 0) is complete, a Register (Expires: non-zero) will then be sent.
SessionURIValidationNoNoEnum0Possible values:
  • 0 - edsLiberal
  • 1 - edsStrict
Selects whether the Request URI of the incoming request needs to be validated. edsStrict ensures that the request URI is validated, edsLiberal ensures no validation is done.
ContactURIRandomizerNoNoEnum0Possible values:
  • 0 - btFalse
  • 1 - btTrue
 If enabled, the following will occur: -Random user values will be generated and put into the Contact-URI of each outgoing Register message. -The random user portion will be saved and compared to incoming Invite Request-Uri's. If the prefix of the R-URI contains SBCxxxx, then if there is a match, SBCxxxx will be stripped and the remaining number used to route (if no match, Invite is not accepted). If there is no SBCxxxx in R-URI, then the number is sent as-is for routing.
RetryNonStaleNonceNoNoEnum1Possible values:
  • 0 - btFalse
  • 1 - btTrue
 This value will only be visible if Remote Authorization Table are defined in SIP Server. When true, if stale=false is received in 401/407, the SBC will set failed retry timer and re-attempt to send Register with same credentials at expiration. When false, if stale=false is received in 401/407, the SBC will never resend a challenged request with the same credentials.(this is RFC behavior)
TLSProfileIDNoNoint0Possible values:
  • 0 - Minimum
  • 65534 - Maximum
 If TLS is selected this specifies the TLS profile this server will use for secure SIP messages.

This option is available if Protocol is set to TLS.

AuthorizationOnRefreshNoNoEnum1Possible values:
  • 0 - btFalse
  • 1 - btTrue
 This value will only be visible if both Contact Registrant Table and Remote Authorization Table are defined in SIP Server. When true, the SBC will include authorization headers obtained from previous 401/407 exchange in registration refresh messages. When false, the SBC will not include authorization headers obtained from previous 401/407 exchange in registration refresh messages.

Statistics

Parameter Name Description Data Type Possible Values
rt_Transactions Displays the number of SBC client transactions with the server. int
rt_TransactionFalures Displays the number of failed SBC client transactions with the server. int
rt_PersistentConnections Displays the number of sockets which are being reused in the moment with this server. int
rt_UpTime Displays the time for which the server was functioning and responding to SIP Options. int
rt_DownTime Displays the the time for which server was down due to not responding to options request or dns failures. int
rt_RemoteSrvrIDs Comma separated list of SRV Server ID's. string
rt_RemoteServers Comma separated list of SRV Server FQDN's. string
rt_RemoteProtocols Comma separated list of SRV Record Protocol values. string
rt_RemotePorts Comma separated list of SRV Record Port values. string
rt_RemoteTTLs Comma separated list of SRV Record Time to Live values. string
rt_RemotePriorities Comma separated list of SRV Record Priority values. string
rt_RemoteWeights Comma separated list of SRV Record Weight values. string
rt_ServerTableID string
rt_ServerID string
rt_PodIndex int