The global servers object allows you to configure ENUM and E911 servers as well as global DNS, call recording criteria and SRS Group Profile configurations. The 'servers' object includes global configurations for DNS servers used for SIP NAPTR, SRV, and A-record lookups.
When the ERE receives multiple records with the same order value and preference for a NAPTR query, the ERE considers only the first record received to resolve the route. If it does not find a route for the chosen record, it returns a 'no route found' response, and will not consider other records to resolve the route.
However, in the case where the order value and preference are different for the received records, the record chosen to resolve the route is based on the RFC rule. In this scenario, if the ERE/PSX does not find the route for the chosen record, it returns a 'no route found' response, and will not consider other records to resolve the route.
The ENUM server returns a NAPTR response with an IP address to the SBC. To route a call to the IP Peer associated with this IP address, ensure the following is provisioned in ERE.
- Configure a SIP Domain with the IP address of the IP Peer.
- Create an IP Peer using the IP address above, and associate this IP peer to a routing label.
- Configure a Username Routing entry using SIP Domain from step 1, and attach the routing label created in step 2.
The SBC supports load balancing across ENUM servers for individual ENUM zones using enumDomainName, lwresdProfile and enumDomainNameLabel parameters described in this section. ENUM client routes the query to ENUM servers based on the load balancing scheme configured for that zone. ENUM client uses the following load balancing schemes to route the requests to ENUM servers. For details, refer to ENUM Support.
- Sequential
- Round Robin
- Proportional
Global DNS Servers
High Level Command Syntax
Code Block |
---|
|
% set global servers
adService
callRecordingCriteria
dmpmRuleService
priority
flags active <disable adService| enable>
translationOrder <callingNumber | callRecordingCriteria
calledNumber | calledAndCalling | callingAndCalled>
dns
domainController <server name>
description <description>
ldapQueryCriteria <criteria>
password <password>
userName <username>
primaryIP <x.x.x.x>
remote port (remote port>
searchScope <search scope>
secondary IP <x.x.x.x>
useTLS <enable | disable>
userName <username>
e911
e911VpcDevice <device_name>
enumDomainName <domain_name>
enumDomainNameLabel DEFAULT_ZONE_LABEL
enumDomainNameId <enumDomainName's name>
enumMessageDefinition
enumService <name>
lwresdProfile <profile name>
srsGroupCluster
srsGroupProfile |
Command Parameters
Caption |
---|
0 | Table |
---|
1 | Global Servers Parameters |
---|
3 | Global DNS Servers Parameters |
---|
|
Parameter | Length/Range | Description |
---|
adService | 1-23 | AD Service name used for AD service trigger. This is a mandatory parameter. | callRecordingCriteria | 0-23 | Unique Call Recording Criteria name. | dmpmRuleService | N/A | Use this object to enable/disable a new DMPM service, which will execute DM/PM rules to normalize the usernames in the ingress INVITE to E.164. - priority –
- flags active
- translationOrder
- callingNumber
- calledNumber
- calledAndCalling
- callingAndCalled
Available_since |
---|
Type | Available Since |
---|
Release | 9.2.3 |
---|
|
| dns
| N/A | Use this object to configure global DNS settings. (Refer to Servers - DNS Global - CLI for parameter details) | domainController | 1 - 23 | Name of the AD Domain Controller server. Complete the Domain Controller configuration to fetch the data from the remote server. The domainController entity holds data related to the remote Active Directory Server. description - Optional description of the AD Domain Controller
ldapQueryCriteria- LDAP ((Lightweight Directory Access Protocol) query to retrieve data from the AD Domain Controller
password - Password to access the AD Domain Controller
primaryIP - Primary IP address of the AD Domain Controller
remotePort - Port on the remote AD Domain Controller server (optional).
searchScope - Scope of the AD search when retrieving data
secondaryIP - Secondary IP address of the AD Domain Controller
useTLS - If enabled, the SBC uses TLS to communicate with the AD Domain Controller. Options are:
userName – Username to access the AD Domain Controller
| e911
| N/A | Use this parameter to configure enhanced 911 service. (Refer to Servers - E911 - CLI for parameter details) | e911VpcDevice
| N/A | Use this object to configure the IP address and port number of the E911 VoIP Positioning Center (VPC) device. This parameter is used for queries to one or more E911 VPCs for the Emergency Services Routing Number of the Public Services Answering Point nearest the current location of the caller. (Refer to Servers - E911 - CLI for parameter details) | enumARSProfile | 1-23 | Use this object to name an ENUM ARS profile. This profile applies to ENUM servers and specifies behavior for managing device failover to a secondary or backup ENUM server in the form of blacklisting and whitelisting critieria. | enumDomainName | 1-63 characters | The name of the ENUM domain containing forwarderIP entries for load balancing. (Refer to Servers - ENUM - CLI for parameter details) | enumDomainNameLabel | N/A | A collection of ENUM domains used by SLWRESD process for performing ENUM queries. The default enumDomainNameLabel value is "DEFAULT_ZONE_LABEL ". (Refer to Servers - ENUM - CLI for parameter details) | enumMessagedefinition | N/A | This table contains information about Enum Message Definitions. | enumService
| 1-23 characters | The ENUM Service name. (Refer to Servers - ENUM - CLI for parameter details) | lwresdProfile | N/A | LWRESD Profile configuration which uses ENUM zones configured for sending ENUM queries against an enumDomainLabel (and receives responses) using either the management or signaling interfaces, depending upon the LWRESD Profile type setting. (Refer to Servers - LWRESD Profile - CLI for parameter details) | srsGroupCluster | 0-23 | SRS Group Cluster name. The options are: -
SRS Group Cluster Id- Select the name of an SRS Group Profile to associate with the cluster. PER60690s_RECCluster - ClusterForRec
| srsGroupProfile | 0-23 | SRS Group Profile name. The options are: description - Descriptive text about this SRS Group Profile.
loadDistribution - The load distribution scheme for this SRS Group Profile.
- Round Robin
- Sequence (default)
numSimultaneousStream - range is 1-2.The number of simultaneous media streams for this SRS Group Profile. (default = 1)
srsGroupData - Data rows for SRS group. The options are:
ipAddress - Signaling IP address (IPv4 or IPv6) of this SRS (The values "0.0.0.0" or "0::0" are not allowed).ipPort - TCP/TLS/UDP port for this SRS.ipTGId - IP Trunk Group ID used to initiate the session towards the SRS.
|
|
Command Examples
To configure E911 server, execute the following CLI commands:
Code Block |
---|
|
% set global country 1 listOfNumberOfDigitsToMatch criteria 10,6,3,0
% commit
% set profiles digitParameterHandling numberTranslationCriteria DEFAULT_E911 none Sonus_NULL Sonus_NULL 4451211022 1 lookupType e911
% set global servers e911 DEFAULT_E911 flags active enable
% set global servers e911VpcDevice DEFAULT_E911 deviceData 0 ipAddress 10.6.30.137 portNumber 9000
% set global servers e911 DEFAULT_E911 vpcDevice DEFAULT_E911
% set global servers e911 DEFAULT_E911 criteria triggerCriteria DEFAULT_E911
% set global servers domainController adaserver userName rbbn password ribbon1 searchScope CN=Users,dc=sonusqa,dc=net ldapQueryCriteria cn=* primaryIP 10.50.10.20
% commit |
To configure global ENUM service, execute the following CLI commands:
Configure numberTranslationCriteria for calledUri as below
Code Block |
---|
|
% set profiles digitParameterHandling numberTranslationCriteria ENUM_CR calledUri ims.comcast.com Sonus_NULL 9876543210 1 lookupType enumCnam |
Provision enumService:
Code Block |
---|
|
% set global servers enumService ENUMSER1 criteria triggerCriteria ENUM_CR
% set global servers enumService ENUMSER1 serviceType cnam flags active enable |
Configure the private domain 'ims.comcast.com' for ENUM service.
Code Block |
---|
|
% set global servers enumService ENUMSER1 enumDefinitions privateDomainNameForEnumLookups ims.comcast.com |
Configure the ACL rule and management interface static route for the domain controller’s IP. This is to ensure that the management interface is used to send the LDAP query and packets from the AD server are allowed reach the application. The following is an example:
Code Block |
---|
set global servers domainController adaserver userName rbbn password ribbon1 searchScope CN=Users,dc=sonusqa,dc=net ldapQueryCriteria cn=* primaryIP 10.50.10.20 |
The following is an example of how to Create Ad Service and associate trigger criteria:
Code Block |
---|
set global servers adService ADSERV1 priority 10
set global servers adService ADSERV1 criteria triggerCriteria Test
set global servers adService ADSERV1 flags active enable |