- Preface
- Barge and Privacy
- BLF Presence
- Call Back
- Call Control Discovery
- Call Display Restrictions
- Call Park and Directed Call Park
- Call Pickup
- Call Queuing
- Call Throttling and the Code Yellow State
- Calling Party Normalization
- Cisco Mobility
- Cisco Unified Communications Manager Assistant with Proxy Line Support
- Cisco Unified Communications Manager Assistant with Shared Line Support
- Cisco Unified Communications Manager Auto-Attendant
- Client Matter Codes and Forced Authorization Codes
- Custom Phone Rings
- Device Mobility
- Do Not Disturb
- Enhanced Location Call Admission Control
- Extend and Connect
- Extension Mobility
- Extension Mobility Cross Cluster
- External Call Control
- External Call Transfer Restrictions
- Geolocations and Location Conveyance
- Global Dial Plan Replication
- Hold Reversion
- Hotline
- IM and Presence Service
- Immediate Divert
- Intercluster Lookup Service
- Intercom
- Internet Protocol Version 6 (IPv6)
- Licensing
- Local Route Groups
- Logical Partitioning
- Malicious Call Identification
- Monitoring and Recording
- Multilevel Precedence and Preemption
- Music On Hold
- Originally Called Party Name in Placed Call History
- Paging
- Proxy TFTP Server
- Quality Report Tool
- Remote Worker Emergency Calling
- Single Sign-On
- SAML Single Sign-On
- URI Dialing
- Web Dialer
Features and Services Guide for Cisco Unified Communications Manager, Release 10.0(1)
- Updated:
- March 17, 2017
Chapter: Global Dial Plan Replication
Global Dial Plan Replication
This chapter provides information about how to configure the Global Dial Plan Replication feature. When Global Dial Plan Replication is enabled, the Intercluster Lookup Service (ILS) replicates local and learned directory URIs, enterprise alternate numbers, +E.164 alternate numbers, and number patterns throughout the ILS network. Global Dial Plan Replication allows you to create a global dial plan that spans the ILS network and which includes intercluster dialing of directory URIs and alternate numbers.
- Set Up Global Dial Plan Replication
- Global Dial Plan Data
- Alternate Numbers
- Advertised Patterns
- PSTN Failover
- Route Strings
- Learned Global Dial Plan Data
- About Imported Global Dial Plan Data
Set Up Global Dial Plan Replication
This procedure describes how to set up Global Dial Plan Replication in the ILS network. See the Related Topics for more detailed information on how to perform some of the high-level steps in this procedure.
Global Dial Plan Replication runs on an ILS network. Follow the procedure to set up an ILS network in the "Intercluster Lookup Service" chapter before you configure Global Dial Plan Replication.
Global Dial Plan Data
When Global Dial Plan Replication is enabled, each cluster in an ILS network advertises its global dial plan data, including global dial plan data that was configured locally and any data that was learned from other clusters, to the ILS network. Global dial plan data includes the following:
- Directory URIs
-
ILS advertises the full catalog of locally configured directory URIs where the Advertise Globally via ILS option is selected. The URI dialing chapter in the Cisco Unified Communications Manager Features and Services Guide contains details on how to set up URI dialing. See URI Dialing for more information.
- Alternate Numbers
-
ILS advertises locally configured enterprise alternate numbers and +E.164 alternate numbers to the ILS network where the Advertise globally via ILS option has been selected.
- Advertised Patterns
-
ILS advertises locally configured alternate number patterns to the ILS network.
- PSTN Failover
-
ILS advertises locally configured PSTN failover information for alternate numbers, directory URIs, and advertised patterns.
- Route String
-
ILS advertises the local route string to the ILS network. Each global dial plan data element associates to a route string that identifies the home cluster for that element. Remote clusters use the route string in combination with a SIP route pattern in order to route to the various clusters in an ILS network.
- Learned Global Dial Plan Data
-
In addition to locally configured global dial plan data, ILS advertises all global dial plan data that the local cluster has learned from other clusters in the ILS network. This ensures that all advertised data reaches each cluster in the ILS network. Learned global dial plan data includes learned directory URIs, learned alternate numbers, learned patterns, learned PSTN failover rules, and learned route strings.
- Imported Global Dial Plan Data
-
ILS advertises imported global dial plan data throughout the ILS network. Imported global dial plan data includes directory URIs, +E.164 patterns, and PSTN failover rules that were imported manually from a CSV file for a Cisco TelePresence Video Communication Server or a third-party call control system.
Alternate Numbers
Alternate numbers can be configured as aliases of directory numbers. Alternate numbers allow you to configure globally routable numbers that can be dialed from anywhere within an ILS network. Cisco Unified Communications Manager allows you to create two types of alternate numbers:
In Cisco Unified Communications Manager Administration, you can create an enterprise alternate number or +E.164 alternate number and associate the alternate number to a directory number. When you associate an alternate number to a directory number, the alternate number can act as an alias of that directory number so that when you dial the alternate number, the phone that is registered to the associated directory number rings.
Each alternate number that you set up must associate to a single directory number. However, that directory number can associate to both an enterprise alternate number and a +E.164 alternate number at the same time. You can also choose one of the alternate numbers as the PSTN failover number for all alternate numbers and directory URIs that are associated to that directory number. See PSTN Failover for more information.
Local Routing with Alternate Numbers
To configure local routing for alternate numbers, you must assign the alternate number to a local route partition that is configured in a calling search space. In Directory Number Configuration, under the alternate number, check the Assign to a local route partition check box and choose a route partition that is in a local calling search space.
Intercluster Routing with Alternate Numbers
For intercluster routing of alternate numbers, Cisco Unified Communications Manager uses ILS to advertise alternate numbers and patterns to the ILS network. For each alternate number that you assign to a directory number, you have the option to include that alternate number in the advertised global dial plan data. If this option is chosen, ILS includes the alternate number along with the local route string and advertises that data to the ILS network. Remote clusters use the route string, in combination with a SIP route pattern, to route calls to that alternate number.
As an alternative, you can configure a pattern that summarizes a range of alternate numbers, and advertise that pattern to the ILS network. The advertised pattern saves you from having to configure replication for each alternate number on an individual basis. For details on advertised patterns, see Advertised Patterns.
Set Up Alternate Number
This procedure describes how to assign an enterprise alternate number or +E.164 alternate number to an existing directory number and configure that alternate number for local or intercluster calls.
What to Do Next
If you want to enable intercluster routing for the alternate number you must also set up Global Dial Plan Replication within your ILS network. ILS will not advertise the alternate number unless Global Dial Plan Replication is enabled.
Advertised Patterns
Advertised patterns allow you to create summarized routing instructions for a range of enterprise alternate numbers or +E.164 alternate numbers and replicate that pattern throughout an ILS network such that all clusters within the ILS network know the pattern. Advertised patterns prevent you from having to configure routing information for each alternate number on an individual basis. Advertised patterns are never used by the local cluster on which they are configured—they are only used by remote clusters that learn the pattern through ILS.
For example, if Cluster A has a range of enterprise alternate numbers between 80001 and 89999 and you want to replicate those alternate numbers throughout the ILS network, you can create a pattern of 8XXXX and advertise that pattern to the ILS network. When a remote cluster receives an outgoing call for which the dial string matches the learned pattern (for example, 82211), the remote cluster uses the route string that is associated with the pattern to route the call.
You can also configure PSTN failover information for patterns that are advertised by ILS. See PSTN Failover for more information.
Advertised Patterns Settings
In Cisco Unified CM Administration, use the menu path to create alternate number patterns that ILS advertises to remote clusters in the ILS network.
In the Advertised Patterns Configuration window, you can create a number pattern that summarizes a range of alternate enterprise or +E.164 numbers. If Global Dial Plan Replication is enabled, ILS advertises the number pattern to remote clusters in the ILS network.
The following table describes the field settings for the Advertised Patterns Configuration window.
|
Field |
Field Description |
|---|---|
|
Description |
|
|
Description |
In the text box, enter a description of the number pattern. |
|
Advertised Pattern |
|
|
Pattern |
In the text box, enter the number pattern that you want Cisco Unified Communications Manager to match against incoming calls. The number pattern must consist of an optional + followed by one or more dialable digits (0-9, A-D, *, #), digit ranges in regular expression format (example: [6-9] or [^6-9]), or single-digit wildcards (X). The pattern may end with an optional % or !. If Global Dial Plan Replication is configured, ILS advertises this pattern to remote clusters in the ILS network. When a remote cluster receives an incoming call that matches this pattern, the remote cluster applies this pattern to the incoming call and tries to route the call to this cluster. |
|
Pattern Type |
Choose the type of pattern that applies to this number pattern. When an outgoing call arrives for which the destination dial string matches this number pattern, Cisco Unified Communications Manager assigns the route partition that applies for this pattern type. Click one of the following radio buttons: |
|
Don't use PSTN Failover |
Click this radio button if you do not want to configure a PSTN failover for calls that match this pattern. If Cisco Unified Communications Manager is unable to route a call to this pattern over a SIP trunk, the call will not be rerouted to the PSTN. |
|
Use Pattern as PSTN Failover |
Click this radio button if you want to use the dial string as the PSTN failover for calls that match this pattern. If Cisco Unified Communications Manager is unable to route the call over a SIP trunk, Cisco Unified Communications Manager uses the calling party AAR CSS to reroute the call to a PSTN gateway. |
|
Apply Strip Digits and Prepend Digits to Pattern and Use for PSTN Failover |
Click this radio button to use the PSTN Failover Strip Digits and PSTN Failover Prepend Digits fields as the PSTN failover for calls that match this pattern. If Cisco Unified Communications Manager is unable to route the call over a SIP trunk, Cisco Unified Communications Manager applies the PSTN Failover Strip Digits and PSTN Failover Prepend Digits fields to the dial string and uses the calling party AAR CSS to reroute the call to a PSTN gateway. |
|
PSTN Failover Strip Digits |
In the text box, enter the number of digits that you want Cisco Unified Communications Manager to strip from the beginning of the dial string for incoming dial strings that match this pattern. You can enter up to 16 digits. |
|
PSTN Failover Prepend Digits |
In the text box, enter the digits that you want Cisco Unified Communications Manager to attach to the beginning of the dial string for incoming calls that match this pattern. The allowed characters are 0-9 with an optional leading +. |
Set Up an Advertised Pattern for Alternate Numbers
Follow this procedure to create a pattern that summarizes a range of alternate numbers and advertise the pattern to the ILS network.
What to Do Next
For remote clusters to be able to route calls to the PSTN failover number, in the remote cluster you must set up AAR and create route patterns that route the PSTN failover digits to a PSTN gateway.
PSTN Failover
When Global Dial Plan Replication is enabled, ILS can be configured to replicate a PSTN failover rule for learned directory URIs, learned numbers, and learned patterns. If the dial string for an outgoing call matches a learned pattern, learned alternate number, or learned directory URI, and Cisco Unified Communications Manager is unable to route the call over a SIP trunk, Cisco Unified Communications Manager uses the calling party's AAR CSS to reroute the call to the associated PSTN failover number.
Cisco Unified Communications Manager uses the PSTN failover to reroute calls only for calls placed to patterns, alternate numbers, or directory URIs that were learned through ILS. Cisco Unified Communications Manager does not reroute calls to the PSTN failover number for calls that are placed to locally configured patterns, alternate numbers, and directory URIs.
You can use two different methods to assign a PSTN failover rule:
-
In the Advertised Pattern Configuration window, you can assign PSTN failover Strip Digits and Prepend Digits instructions for an ILA-advertised pattern that summarizes a range of alternate numbers. ILS advertises the pattern and PSTN failover instructions to remote clusters in the ILS network.
-
In the Directory Number Configuration window, you can configure an alternate number as the PSTN failover for all ILS-advertised alternate numbers and directory URIs that associate to that directory number.
PSTN Failover for Advertised Pattern Example
Company ABC has clusters in New York and Los Angeles in an ILS network and advertises an enterprise alternate number pattern of 8XXXX to represent the range of New York extensions. The pattern includes PSTN failover instructions to strip the first digit and prepend +1718555 to the dial string.
If a Los Angeles employee dials 86301 to reach a New York employee and Cisco Unified Communications Manager is unable to route the call over a SIP trunk, the call is rerouted to a PSTN gateway with +17185556301 as the dial string.
PSTN Failover for Directory URI Example
At Company ABC, Alice’s Los Angeles extension is 2100. Alice also has an enterprise alternate number of 72100, a +E.164 alternate number of +13105552100, and a directory URI of alice@abc.com, all of which are associated to her extension. Alice’s +E.164 alternate number is configured as the PSTN failover.
If a New York employee dials alice@abc.com and Cisco Unified Communications Manager is unable to route the call over a SIP trunk, Cisco Unified Communications Manager reroutes the call to the PSTN failover of +131055521000 and sends the call to a PSTN gateway.
 Note | For the PSTN failover to be used by remote clusters, you must set up Automated Alternate Routing in your remote clusters and create route patterns that route the PSTN failover number to a PSTN gateway. |
Set Up PSTN Failover for Directory URIs and Alternate Numbers
This procedure describes how to assign a PSTN failover number for directory URIs or alternate numbers and advertise that PSTN failover number to the ILS network. Remote clusters can use the PSTN failover number for calls to learned directory URIs or learned alternate numbers.
Note | For alternate numbers, you can also assign a PSTN failover rule to an advertised pattern that summarizes a range of alternate numbers. To assign a PSTN failover rule to an advertised pattern, see Set Up an Advertised Pattern for Alternate Numbers. |
What to Do Next
In order for a remote cluster to route calls to the PSTN failover number, you must set up the AAR CSS and configure route patterns in the remote cluster that route the PSTN failover number to a PSTN gateway.
Route Strings
To configure Global Dial Plan Replication, you must assign a distinct route string for each cluster in the ILS network. Route String must contain only alphanumeric characters (A-Z,a-z,0-9), dots (.) or dashes (-), not more than 64 characters in length. Although route strings are used with domain-based routing, route strings do not have to match a specific domain—you can assign whatever route strings you want.
When you assign a route string to a cluster, ILS associates that route string to all the global dial plan data that is local to that cluster (including locally configured directory URIs, alternate numbers, advertised patterns, and PSTN failover information). If Global Dial Plan Replication is enabled, ILS advertises the local route string and the rest of the global dial plan data to the ILS network.
To configure remote Cisco Unified Communications Manager clusters to route to the route string, for each cluster in the ILS network, you must configure SIP route patterns that match the route strings in the ILS network and route calls that are destined for those route strings to SIP trunks that lead to the next-hop clusters in your ILS network.
When a user in a remote cluster dials a directory URI or alternate number that was learned through ILS, Cisco Unified Communications Manager matches the associated route string to a SIP route pattern, and routes the call to the trunk that is specified by the SIP route pattern.
You can assign a route string to the local cluster in the ILS Configuration window.
Route String Example
Company ABC has an ILS network with clusters in San Jose and Paris. ABC assigns ABC.SanJose.USA and ABC.Paris.France as route strings. In the San Jose cluster, ABC configures a domain-based SIP route pattern that routes calls that are destined for ABC.Paris.France to an outbound trunk that leads to the Paris cluster. When a user in San Jose dials an alternate number or directory that was configured in Paris, Cisco Unified Communications Manager matches the alternate number to the Paris route string and sends the call to the outbound trunk that is specified by the SIP route pattern.
Learned Global Dial Plan Data
Global dial plan data that Cisco Unified Communications Manager learns through ILS is stored in the local database. In addition to replicating locally configured data, ILS also replicates learned global dial plan data to the rest of the ILS network so that all data that is learned by one cluster is learned by all clusters in the ILS network.
Note | Cisco Unified Communications Manager pauses the recording of learned ILS patterns until replication of the cluster is successfully established. |
In Cisco Unified CM Administration, you can view the following types of learned global dial plan data:
- Learned Alternate Numbers
-
To display a list of all the alternate enterprise and +E.164 numbers that Cisco Unified Communications Manager learned through ILS, in Cisco Unified CM Administration, choose and click Find.
- Learned Enterprise and +E.164 Patterns
-
To display a list of all the enterprise and +E.164 number patterns that Cisco Unified Communications Manager learned through ILS, in Cisco Unified CM Administration, choose and click Find.
- Learned Directory URIs
-
To display a list of all the directory URIs that Cisco Unified Communications Manager learned through ILS, in Cisco Unified CM Administration, choose and click Find.
For any learned alternate number, learned pattern, or learned directory URI, you can click the number, pattern, or directory URI to open that item in the Learned Object window, where you can view additional details, such as the PSTN failover number.
Partitions for Learned Patterns Settings
In Cisco Unified CM Administration, use the menu path to assign route partitions to the alternate numbers and patterns that Cisco Unified Communications Manager learns through the Global Dial Plan Replication feature with ILS.
You must assign learned numbers and learned patterns to a partition. You cannot assign a learned number or learned pattern to a NULL partition. You can define your own partitions or use the predefined default partitions. Cisco Unified Communications Manager comes installed with the following predefined partitions for learned alternate numbers and number patterns:
-
Global Learned Enterprise Numbers
-
Global Learned E.164 Numbers
-
Global Learned Enterprise Patterns
-
Global Learned E.164 Patterns
The following table describes the field settings for the Partitions for Learned Alternate Numbers and Patterns Configuration window.
Block a Learned Pattern
If you want to prevent a local Cisco Unified Communications Manager cluster from routing calls to a learned alternate number or learned alternate number pattern, you can configure a local blocking rule on that cluster. Before routing a call to a learned number or learned pattern, ILS checks to see if a local blocking rule matches the dial string. If the blocking rule matches, Cisco Unified Communications Manager does not route the call.
Some additional characteristics of blocking rules:
-
Blocking rules are applied only on the local cluster on which you configure them—ILS does not advertise blocking rules.
-
Blocking rules are applied only to learned alternate numbers and learned patterns—Cisco Unified Communications Manager does not apply blocking rules to locally configured numbers or route patterns.
To set up a blocking rule for a learned alternate number or learned alternate number pattern, perform the following steps:
Blocked Learned Patterns Settings
In Cisco Unified CM Administration, use the menu path to create blocking rules that prevent the local cluster from routing calls to specific enterprise and +E.164 alternate numbers or number patterns that were learned through the Intercluster Lookup Service (ILS).
The following table describes the field settings for the Blocked Learned Pattern window. In the Blocked Pattern section, complete only the fields that you want to use that are relevant as blocking conditions.
About Imported Global Dial Plan Data
Cisco Unified Communications Manager allows you to import global dial plan data from a CSV file into any hub cluster in an ILS network and ILS replicates the imported global dial plan data throughout the ILS network allowing you to interoperate Cisco Unified Communications Manager with a Cisco TelePresence Video Communications Server or a third-party call control system.
You can import directory URIs, +E.164 patterns, and associated PSTN failover rules into Cisco Unified Communications Manager. You can view the global dial plan data that has been imported into the local cluster by doing the following:
Imported Directory URIs—To view a list of directory URIs and associated PSTN failover numbers that have been imported into the local cluster, choose and click the Find button.
Imported Patterns—To view a list of +E.164 patterns and PSTN failover rules that have been imported into the local cluster, choose and click the Find button.
Note | Imported data includes only global dial plan data that is imported manually into Cisco Unified Communications Manager. Imported global dial plan data does not include data that was learned through ILS. |
Imported Global Dial Plan Catalog Settings
In Cisco Unified CM Administration, use the path to import manually directory URIs, +E.164 patterns and PSTN failover rules from a CSV file for a call control system that is not running ILS, such as a Cisco TelePresence Video Communication Server or a third-party call control system.
Configure the settings on the Imported Global Dial Plan Catalog window to create an empty catalog with a route string for the remote call control system. After you configure the settings, you must use Bulk Administration to insert directory URIs and patterns from the CSV file into the newly created catalog.
Note | The local cluster must be part of an existing ILS network. For more information about ILS networks, see the "Intercluster Lookup Service" chapter of the Cisco Unified Communications Manager Features and Services Guide. |
The following table contains field descriptions for the Imported Global Dial Plan Catalog window.
| Field | Description | ||
|---|---|---|---|
| Name | Enter a unique name to identify the catalog that you want to import. | ||
| Description | Enter a description for the catalog that you want to import. | ||
| Route String |
Enter a route string for the remote call control system. Route strings can be up to 250 alphanumeric characters long and can include dots and dashes. Cisco Unified Communications Manager uses route strings in conjunction with SIP route patterns to route calls to directory URIs that are configured in remote clusters. When a call from the local cluster is placed to a directory URI in this remote catalog, Cisco Unified Communications Manager matches the directory URI with the route string and then uses a SIP route pattern to match that route string to an outbound trunk that routes to that directory URI.
|
Import Directory URIs and Patterns From a Non-ILS System
Follow this procedure if you are running the Intercluster Lookup Service (ILS) on your local cluster and you want to import a global dial plan catalog, including directory URIs, +E.164 number patterns, or PSTN failover rules from a CSV file for a call control system that is not running ILS, such as a Cisco TelePresence Video Communication Server (VCS) or a third-party call control system.
To perform this procedure, the Cisco Bulk Provisioning Service must be running on the local cluster, which must be configured as a hub cluster in an ILS network. After you import the catalog into Cisco Unified Communications Manager, ILS replicates the imported catalog to the other clusters in the ILS network.
Note | Make sure that the CSV file that you use for the import is compatible with your version of Cisco Unified Communications Manager. For example, a CSV file that is compatible to import into Version 9.0(1) is not compatible with Version 10.0(1). To view a sample CSV file for your release, in Cisco Unified CM Administration, choose and click View Sample File. |
Note | Within Cisco Unified CM Administration, you can enter directory URIs with embedded double quotation marks or commas. However, when you use Bulk Administration to import a CSV file that contains directory URIs with embedded double quotation marks and commas, you must enclose the entire directory URI in double quotation marks and escape the embedded double quotation marks with a double quotation mark. For example, a directory URI of Jared, "Jerry",Smith@test.com must be input as "Jared", ""Jerry"", "Smith@test.com" in the CSV file. |
Feedback