Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel

In this section:

Table of Contents

 

The global servers object allows you to configure ENUM and E911 servers as well as DNS global settingsglobal 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.

  1. Configure a SIP Domain with the IP address of the IP Peer.
  2. Create an IP Peer using the IP address above, and associate this IP peer to a routing label.
  3. 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
languagenone
% set global servers 
	dns global
		ednsFailureCounte911 <1-5>
		ednsPayloadSize <512-4096 bytes>
		ednsRetryAfter <60-180 seconds>
		iterationCount <0-32>   
		monitoringInterval <0-300> 
		probeInterval <0-300> 
		retransmissionCount <0-20> 
		retransmissionTimer <100-10000>
		timeouts <0-32>
	e911 
		<e911_service_name>
		criteria triggerCriteria <criteria>
		defaultTreatment <applyFinalTreatment | routeAsDialed>
		flags active <disable | enable>
		requestTimeOut <0-2147483647>
		routePrecedence <local | lro>
	e911VpcDevice <device_name>
		deviceData <0-32767>
			ipAddress <ip_address>
			portNumber <0-65535>
	enumDomainName <domain_name>
		forwardersData <0-99999>
			forwarderDescription <description>
			forwarderIP <IPv4 or IPv6 address>
		loadDistribution <proportion | roundRobin | sequence> 
		queryRetryTimer <0-10000 ms>
		zoneType individual
	enumDomainNameLabel DEFAULT_ZONE_LABEL enumDomainNameId <enumDomainName's name>
	enumService <name>
		criteria triggerCriteria <criteria>
		defaultTreatment <applyFinalTreatment | routeAsDialed>
		enumDefinitions privateDomainNameForEnumLookups <private_domain_name>
		flags 
			active <disable | enable>
			processCallingNumber <disable | enable>
			processNewANI <disable | enable>
		priority <129-140>
		requestTimeOut <0-2147483647>
		serviceType <cnam | lnp | sipAor>
	lwresdProfile <profile name>
		description 
		enableLwresdLog 
		enumDomainNameLabel

Command Parameters

Global DNS Servers Parameters

e911VpcDevice <device_name>
	enumDomainName <domain_name>
	enumDomainNameLabel DEFAULT_ZONE_LABEL enumDomainNameId <enumDomainName's name>
	enumService <name>
	lwresdProfile <profile name>
    domainController <server name> description <description> userName <username> password <password> primaryIP <x.x.x.x> ldapQueryCriteria <criteria> searchScope <search     scope>
    adService <Service Name>
       priority <Num>
       criteria triggerCriteria <criteria>
       flags active <enable/disable>

Command Parameters

 
Caption
0Table
1Global DNS Servers Parameters
3Global DNS Servers Parameters

Parameter

Length/Range

Description

dns global

N/A

Use this object to configure global DNS settings

. Parameters:
  • ednsFailureCount – The maximum number of EDNS failure responses allowed, after which the DNS server is identified as unsupported for EDNS. (range: 1-5 / default = 3)
  • ednsPayloadSize – Specifies the global EDNS payload size, in bytes, for DNS Servers. (range: 512-4096 / default = 1280
  • ednsRetryAfter – Specifies the number of seconds to wait before retrying to establish EDNS support after a failure. (range: 60-180 / default = 180>
  • iterationCount – Global Iteration count limit for DNS iterations of server requests. (range: 0-32 / default = 8).
  • monitoringInterval – Global monitoring interval (in seconds) for DNS Servers. (range: 0-300 / default = 5).
  • probeInterval – Global probe interval (in seconds) for blacklisted DNS Servers. (range: 0-300 / default = 5).
  • retransmissionCount –  Global retransmission count limit for DNS iterations of server requests.  (range: 0-20 / default = 2).
  • retransmissionTimer –  Global retransmission timer value (in milliseconds) for DNS iterations of server requests. (range: 100-10000 / default = 500)
  • timeouts – Global number of time outs for blacklisting a DNS Server. (range: 0-32 / default = 0).
Info

Use the following command to enable EDNS support:

% set addressContext <addressContext Name> dnsGroup <dnsGroup Name> ednsSupport enabled

. (Refer to Servers - DNS Global - CLI for parameter details)

e911

N/A

Use this parameter to configure enhanced 911 service.

  • <e911_service_name>
  • criteria triggerCriteria <criteria>
  • defaultTreatment– Default treatment to apply for requests that time out.
    • applyFinalTreatment
    • routeAsDialed (default)
  • flags active
    • disable (default)
    • enable
  • requestTimeOut – (range: 0-2147483647 / default = 4000)
  • routePrecedence– Routing treatment to apply in the event that a location for the caller cannot be determined, either “Local” or “Last Routing Option” (LRO).
  • local
  • lro (default
  • ipAddress <IPv4 or IPv6 address>
  • portNumber <0-65535>

    (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.

    deviceData <call priority: 0-32767>

    (Refer to Servers - E911 - CLI for parameter details)

    enumDomainName 1-63 characters
    <domain_name> – Name

    The name of the ENUM domain containing forwarderIP entries for load balancing.

    forwardersData <priority #> – Priority or sequence number of each forwarderIP defined below. A lower value represents a higher priority. This value is unique for each forwarderIP.
  • loadDistribution  – Load distribution strategy. Refer to ENUM Support for details.
    • proportion
      • percentageDistribution – The percentage of load distribution to calculate for each IP in enumDomainName (range: 0-99999).
    • roundRobin
    • sequence (default)
  • queryRetryTimer – The time, in milliseconds, that SLWRESD process waits before trying the next IP in the forwardersData list (range: 0-10000 | default = 4000).
  • zoneType individual – The zone type for this ENUM domain (At present, "individual" is the only zone type available, and it indicates SBC supports load balancing across individual zones).
  • Note

    All forwarderIP entries for this enumDomainName must be configured with the same loadDistribution type and queryRetryTimer value because attributes apply to ENUM domain, not individual forwarderIP entries.

    Info

    Refer to ENUM Support for additional feature details and descriptions.

    (

    range: 0-99999).
    • forwarderDescription <description> – Textual description of each fowarderIP entry.
    • forwarderIP <IPv4 or IPv6 address> – ENUM server IPv4 or IPv6 address of this forwarderIP entry.

    Refer to Servers - ENUM - CLI for parameter details)

    enumDomainNameLabelN/A
    <ENUM domain name label>

    A collection of ENUM domains used by SLWRESD process for performing ENUM queries. The default enumDomainNameLabel value is "DEFAULT_ZONE_LABEL".

    • enumDomainNameId <enumDomainName's name> – The enumDomainName of each ENUM domain to attach to this enumDomainNameLabel.

    (Refer to Servers - ENUM - CLI  for parameter details)

    enumService

    1-23 characters

    The ENUM Service name.

    (Refer to Servers - ENUM - CLI  for parameter details)

    enumService

    N/A

    Use this object to configure ENUM service. See Global ENUM Service Parameters table below for parameter details.

    lwresdProfileN/A
    <profile name> – Profile name used by the SLWRESD process. The default profile name is "DEFAULT". The SLWRESD process uses the

    LWRESD Profile configuration which uses ENUM zones configured for

    performing an

    sending ENUM

    query

    queries against

    enumDomainLabel.
    • description – Textual description of lwresdProfile (length: 1-255 characters)
    • enableLwresdLog – Use this flag to enable/disable LWRESD log.
      • disable (default)
      • enable
    • enumDomainNameLabel –  The ENUM domain name label created for enumDomainNameLabel entity. Use this parameter to associate the lwresdProfile with a particular enumDomainNameLabel.
    Note

    Only one lwresdProfile is allowed.

    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)

    domainController1 - 23Domain Controller name
    description1 - 23

    Active Directory Domain Controller Description

    ldapQueryCriteria1 - 127Data will be fetched based on this query criteria
    password1 - 127Active Directory Domain Controller Password
    primaryIPNAPrimary IP Address Of The Domain Controller
    remotePort

    1 - 65535

    (default - 389)

    Remote Server Port.
    searchScope1 - 127Scope of the Active Directory from where data shall be fetched
    secondaryIPNA

    Secondary IP Address Of The Domain Controller

    useTLS

    disable/enable

    (Default: disable)

    If enabled, TLS shall be used for communication with this domain controller
    userName1 - 127Active Directory Domain Controller Username
    adService1-23AD Service name used for AD service trigger. This is a Mandatory parameter.

    Global ENUM Service Parameters

    To support ENUM services for SBC in ERE mode, manually create an ACL rule towards ENUM server to allow the packets (ENUM responses) from ENUM server into SBC. See the CLI example below.

    Note

    Set fillRate to a higher value (for example, fillRate = 2000) to support high ENUM call loads (more than 20 cps). Refer to IP Access Control List - CLI for configuration details.

    Code Block
    languagenone
    titleExample ACL Rule
    % set addressContext default ipAccessControlList rule ENUMSEV precedence 1 protocol any sourceIpAddress <ENUM_SERVER_ADDRESS> sourceAddressPrefixLength 32 action accept fillRate 50 bucketSize 50 state enabled 
    Caption
    0Table
    1Global ENUM Service Parameters
    3Global ENUM Service Parameters
     

    Parameter

    Length/Range

    Description

    <service_name>1-23ENUM Service name.
    criteria1-23triggerCriteria <criteria> – Trigger criteria to use for this ENUM Service. The characters #%^&(){}<>,/\;`[]=!$"*?|~ and SPACE are not allowed.
    defaultTreatmentN/A

    Default treatment to apply to this ENUM Service.

    • applyFinalTreatment
    • routeAsDialed (default)
    enumDefinitions 

    Use this parameter to specify how to treat ENUM definitions.

    • privateDomainNameForEnumLookups <private_domain_name> – Specify the private domain name to use for ENUM look-ups.
     flags  
    • active
      • disable (default)
      • enable
    • processCallingNumberEnable this flag to analyze the calling number using prefix profile. When this flag is disabled, the calling number is not analyzed and hence if it has +CC, the same is sent as-is to SBC in the calling number field in policy response.
      • disable (default)
      • enable
    • processNewANI When this flag is enabled for ENUM AoR service, and ENUM AoR response contains "newani=<some_number>" parameter in NAPTR record, the ERE overwrites the existing calling number of the call with the newANI number. When this flag is disabled, any newANIparameters received in NAPTR response are ignored in PES.
      • disable (default)
      • enable
    priority129-140

    Specifies the priority (order) of ENUM service execution. If this parameter is not set or set to the default of '129', default priorities are assigned for LNP (130), CNAM (131) and SIP AoR (132). If a different order of service execution is desired, set the priorities accordingly.

    For example, setting CNAM priority to 133 executes SIP AoR before CNAM.

    requestTimeOut0-2147483647Request timeout value, in milliseconds. (default = 2000)
    serviceTypeN/A

    Use this parameter to specify the ENUM service type. Options are:

    • cnam
    • lnp
    • sipAor
     

    Command Examples

    To configure E911 server, execute the following CLI commands:

    Code Block
    languagenone
    % 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:

    1. Configure numberTranslationCriteria for calledUri as below

      Code Block
      languagenone
      % set profiles digitParameterHandling numberTranslationCriteria ENUM_CR calledUri ims.comcast.com Sonus_NULL 9876543210 1 lookupType enumCnam 
    2. Provision enumService:

      Code Block
      languagenone
      % set global servers enumService ENUMSER1 criteria triggerCriteria ENUM_CR 
      % set global servers enumService ENUMSER1 serviceType cnam flags active enable 
    3. Configure the private domain 'ims.comcast.com' for ENUM service.

      Code Block
      languagenone
      % 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

    Pagebreak