In this section:


ENUM ARS Profile

Use this section to configure an ENUM ARS Profile for ENUM servers, and to specify behavior for managing device failover to a secondary or backup ENUM server in the form of blacklisting and whitelisting parameters.

Command Synax

% set global servers enumArsProfile <enumArsProfile name>
	blackListing
		duration <0-99999>
		numberOfFailures <1-32>
	whiteListing
		highWaterMarkTimer <0-172800>
		numberOfResponses <1-32>
		pingInterval <0-99999>


Command Parameters

Note

When the pingInterval and highWaterMarkTimer parameters are both set to 0, the ENUM server remains black listed until the parameters are reconfigured.

ParameterLength/RangeDefaultDescription

enumArsProfile

 1-23 N/A<enumArsProfile name> – Configure this parameter with the name of the Address Reachability Service (ARS) profile that will be associated with the lwresdProfile.

blackListing

 N/AN/A

The blacklisting configuration.

  • duration (default = 180) – Set the duration, in seconds, within which the numberOfFailures configuration occurs. When this parameter is set to 0, the duration is insignificant and the endpoint is black listed after the configured numberOfFailures occurs. (range: 0-99999)
  • numberOfFailures (default = 3) – Configure this parameter with the number of failures to occur within a specific duration to blacklist an endpoint. (range: 1-32)
whiteListingN/AN/A

Configure this parameter with the name of the Address Reachability Service (ARS) profile that will be associated with the lwresdProfile.

  • highWaterMarkTimer (default = 86400) – Set the maximum duration, in seconds, during which the recovery mechanism occurs. After this duration, the recovery process stops. When this parameter is set to 0, the recovery process occurs indefinitely. (range: 0-172800)
  • numberOfResponses (default = 2) – Set the consecutive number of probe responses that must be received in order to recover a server from the black listed state. (range: 1-32)
  • pingInterval (default = 1) – Set the interval, in seconds, between a probe response and the next probe request. When set to 0, the SBC does not send a dummy NPTR query towards the ENUM server to check its status. The ENUM server is white listed once the highWaterMarkTimer expires and the highWaterMarkTimer parameter is not set to 0.


Command Examples

set global servers enumArsProfile Test blackListing numberOfFailures 5 duration 60
set global servers enumArsProfile Test whiteListing numberOfResponses 1 pingInterval 5 highWaterMarkTimer 86000
commit
 
show global servers enumArsProfile
enumArsProfile Test {
    blackListing {
        numberOfFailures 5;
        duration         60;
    }
    whiteListing {
        numberOfResponses  1;
        pingInterval       5;
        highWaterMarkTimer 86000;
    }
}

ENUM Domain Name

Command Syntax

% set global servers enumDomainName <domain_name>
	forwardersData <0-99999>
		forwarderDescription <description>
		forwarderIP <IPv4 or IPv6 address>
        eDNSBufferSize <0 | 512-4096>
        eDNSType <no | yes>
	loadDistribution <proportion | roundRobin | sequence> 
	queryRetryTimer <0-10000 ms>
	zoneType individual

Command Parameters

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.

Note
Refer to ENUM Support for additional feature details and descriptions.

Parameter

Length/Range

Description

<domain_name>1-63 characters

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

forwardersData0-99999

<priority #> – Priority or sequence number of each forwarderIP defined below. A lower value represents a higher priority. This value is unique for each forwarderIP.

  • forwarderDescription <description> – Textual description of each fowarderIP entry.
  • forwarderIP <IPv4 or IPv6 address> – ENUM server IPv4 or IPv6 address of this forwarderIP entry.
eDNSTypeN/A

Set this flag to yes to send the eDNS OPT record. If this flag is set to no, the ERE sends the query without the OPT record.

  • no
  • yes (default)
eDNSBufferSize 0 | 512-4,096

If this parameter is configured as any value other than zero, the OPT record uses this value when the eDNSType flag is set to yes.

If this parameter is configured as 0, the OPT record uses the eDnsGlobalBufferSize value when the eDNSType flag is set to yes.

loadDistributionN/A

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)
queryRetryTimer0-10000

The time, in milliseconds, that SLWRESD process waits before trying the next IP in the forwardersData list (default = 4000).

zoneTypeN/A

The zone type for this ENUM domain.

  • individual – At present, this is the only zone type available, and it indicates the SBC supports load balancing across individual zones).

ENUM Domain Name Label

Command Syntax

% set global servers enumDomainNameLabel DEFAULT_ZONE_LABEL enumDomainNameId <enumDomainName's name>

Command Parameters

Parameter

Description

enumDomainNameLabel

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

ENUM Message Definition

When a DNS-ENUM service is triggered in the ERE, you can configure the ERE to prioritize a Dialed Number (DN) over a Routing Number (RN) in the ingress INVITE when formulating the ENUM query by configuring the ENUM Message Definition entity's "Use Dialed Number Only" flag, and then associating it with an ENUM Service for prioritization.

If the ENUM Message Definition is not associated with an ENUM Service, the ENUM query is formed using the RN. Alternatively, if the ENUM Message Definition is attached to an ENUM service and the "Use Dialed Number Only" flag is enabled, the ENUM query is formed using the DN. The ENUM Message Definition configuration uses a seeded default entry named "ENUM_REQUEST". 

Note

The DN option of the "ENUM Message Definition" feature is limited to an ENUM Service using a Service Type of "Sip AoR". 

Note

This functionality is also available in the PSX. Refer to ENUM Message Definition Entity Screen and MADDR and REGEX Expression Support in ENUM Responses for details.

Command Syntax

% set global servers enumMessageDefinition <PROFILE NAME>
	useDialedNumberOnly (disable | enable)


Command Parameters

ParameterLength/RangeDescriptionM/O
enumMessageDefinitionUp to 23 characters

<profile> – Enter the profile name.

  • ENUM_REQUEST (This option is the default seeded value)
M
useDialedNumberOnly

N/A

Enable this flag to only send dialed numbers in the ingress INVITE in support of “maddr” and REGEX expressions in an ENUM response. Use the default setting to send routing numbers.

  • disable (default)
  • enable
Note

This option is limited to an ENUM service with a service-type of SIP-AOR.

This flag also exists in the PSX in the "ENUM Message Definition Entity" screen. 

O

Command Example

set global servers enumMessageDefinition ENUM_REQUEST useDialedNumberOnly enable
set global servers enumService ENUM1 enumMessageDefinitions enumRequest ENUM_REQUEST 1
commit

ENUM Service


Note

The Bucket Size value is insignificant if the Fill Rate value is unlimited.

  • The Fill Rate is the maximum rate you expect for the traffic to pass the policer.
  • The Bucket Size is the number of additional packets allowed to pass in a given period if available packets are in the bucket. The credit balance is consumed before the packets are discarded.

If the ACL rules with action = discard, the Fill Rate and the Bucket Size values are irrelevant, and the packets are dropped based on the Type, IP address, or Port.

The Fill Rate and the Bucket Size parameters do not play any role since the policer portion of an ACL is only applicable for the "accept" action and is ignored with the "discard" action since all the packets are already discarded by the criteria.


To support ENUM services for the SBC in ERE mode, manually create an ACL rule for the ENUM server to allow packets (ENUM responses) from the ENUM server into the SBC. Set the Fill Rate for the rule to a higher value (for example, Fill Rate = 2000) to support high ENUM call loads (more than 20 cps).

As an example, set the fillRate to a higher value (e.g., fillRate = 2000) to support high ENUM call loads (more than 20 cps). 

Example 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 

Refer to IP Access Control List - Cloud - CLI for configuration details.

Command Syntax

% set global servers enumService <name>
	criteria triggerCriteria <criteria>
	defaultTreatment <applyFinalTreatment | routeAsDialed>
	enumDefinitions privateDomainNameForEnumLookups <private_domain_name>
	enumMessageDefinitions enumRequest <ENUM Message Definition profile>
	flags 
		active <disable | enable>
		processCallingNumber <disable | enable>
		processNewANI <disable | enable>
        sendOrigDialedNumOverEgress  <disable | enable>
        skipFurtherNumberTranslationServices  <disable | enable>
	priority <0-255>
	requestTimeOut <0-2147483647>
	serviceType <cnam | lnp | sipAor>


Command 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)
enumDefinitionsN/A

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.
enumMessageDefinitionsN/AenumRequest <ENUM Message Definition profile> – Enter an ENUM Message Definition profile to associate with this ENUM Service.
 flags N/A 
  • active - Specifies the status of the ENUM service object.
    • disable (default)
    • enable
  • processCallingNumber –Enable this flag to analyze the calling number using the 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 newANI parameters received in a NAPTR response are ignored in PES.
    • disable (default)
    • enable
  • sendOrigDialedNumOverEgress - When this flag is enabled, the SBC sends the original dialed number in the egress INVITE request after an ENUM dip.
    • disable (default)
    • enable
  • skipFurtherNumberTranslationServices – When this flag is enabled, the SBC skips all further services and goes directly to routing.
    • disable (default)
    • enable
priority0-255

Specifies the priority (order) of execution of ENUM services. Specifying a priority value is mandatory.

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

Use this parameter to specify the ENUM service type for this ENUM service.

  • cnam
  • lnp
  • sipAor