Cucm B System Configuration Guide For Cisco
Cucm B System Configuration Guide For Cisco
Cucm B System Configuration Guide For Cisco
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS,
INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH
THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY,
CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version of
the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS.
CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT
LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS
HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network
topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional
and coincidental.
All printed copies and duplicate soft copies of this document are considered uncontrolled. See the current online version for the latest version.
Cisco has more than 200 offices worldwide. Addresses and phone numbers are listed on the Cisco website at www.cisco.com/go/offices.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL:
https://www.cisco.com/c/en/us/about/legal/trademarks.html. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a
partnership relationship between Cisco and any other company. (1721R)
© 2021 Cisco Systems, Inc. All rights reserved.
CONTENTS
CHAPTER 1 Introduction 1
System Configuration Overview 1
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
iii
Contents
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
iv
Contents
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
v
Contents
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
vi
Contents
Gateway Overview 89
Gateway Setup Prerequisites 90
Gateway Configuration Task Flow 90
Configure MGCP Gateway 91
Configure MGCP (IOS) Gateway 92
Configure Gateway Port Interface 92
Configure Digital Access PRI Ports 93
Configure Digital Access T1 Ports for MGCP Gateway 93
Configure FXS Ports 94
Configure FXO Ports 95
Configure BRI Ports 96
Add Digital Access T1 Ports for MGCP Gateway 96
Reset Gateway 97
Configure SCCP Gateway 98
Configure SCCP as Gateway Protocol 98
Enable Auto Registration for Analog Phones 99
Enable Autoregistration of Nonconfigured Analog FXS Ports 100
Troubleshooting Tips 101
Configure SIP Gateway 101
Configure SIP Profile 102
Configure SIP Trunk Security Profile. 102
Configure SIP Trunk for SIP Gateway 102
Configure H.323 Gateway 103
Configure Clusterwide Call Classification for Gateway 104
Block OffNet Gateway Transfers 104
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
vii
Contents
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
viii
Contents
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
ix
Contents
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
x
Contents
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
xi
Contents
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
xii
Contents
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
xiii
Contents
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
xiv
Contents
CHAPTER 29 Provisioning Users and Devices Using Bulk Administration Tool 299
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
xv
Contents
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
xvi
Contents
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
xvii
Contents
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
xviii
Contents
CHAPTER 36 Cisco Unified Communications Manager TCP and UDP Port Usage 383
Cisco Unified Communications Manager TCP and UDP Port Usage Overview 383
Port Descriptions 385
Intracluster Ports Between Cisco Unified Communications Manager Servers 385
Common Service Ports 388
Ports Between Cisco Unified Communications Manager and LDAP Directory 391
Web Requests From CCMAdmin or CCMUser to Cisco Unified Communications Manager 391
Web Requests From Cisco Unified Communications Manager to Phone 391
Signaling, Media, and Other Communication Between Phones and Cisco Unified Communications
Manager 392
Signaling, Media, and Other Communication Between Gateways and Cisco Unified Communications
Manager 394
Communication Between Applications and Cisco Unified Communications Manager 396
Communication Between CTL Client and Firewalls 398
Communication Between Cisco Smart Licensing Service and Cisco Smart Software Manager 398
Special Ports on HP Servers 399
Port References 399
Firewall Application Inspection Guides 399
IETF TCP/UDP Port Assignment List 399
IP Telephony Configuration and Port Utilization Guides 399
VMware Port Assignment List 400
CHAPTER 37 Port Usage Information for the IM and Presence Service 401
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
xix
Contents
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
xx
CHAPTER 1
Introduction
• System Configuration Overview, on page 1
After completing the tasks in this guide, your system will be setup with users, devices, basic security and
SSO. You can then proceed to configure Cisco solutions.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
1
Introduction
System Configuration Overview
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
2
PA R T I
System Components
• Smart Software Licensing, on page 5
• Configure Enterprise Parameters and Services, on page 31
• Configure IPv6 Stack, on page 43
• Configure Two Stacks (IPv4 and IPv6), on page 49
• Configure Basic Security, on page 53
• Configure Single Sign-On, on page 59
• Configure Core Settings for Device Pools, on page 65
• Configure Trunks, on page 83
• Configure Gateways, on page 89
• Configure SRST, on page 107
• Configure Media Resources, on page 113
• Configure Conference Bridges, on page 133
• Configure Enhanced Locations Call Admission Control, on page 141
• Configure Resource Reservation Protocol, on page 151
• Configure Push Notifications, on page 159
CHAPTER 2
Smart Software Licensing
• Smart Software Licensing Overview, on page 5
• System Licensing Prerequisites, on page 8
• Smart Software Licensing Task Flow, on page 8
• Additional Tasks with Smart Software Licensing, on page 11
• Specific License Reservation, on page 16
• Smart Licensing Export Compliance, on page 28
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
5
System Components
Smart Software Licensing Overview
Note The License authorization is valid for 90 days with a renewal atleast once in 30 days. The authorization will
expire after 90 days if it is not connected to Cisco Smart Software Manager or Cisco Smart Software Manager
satellite.
If the Cisco Smart Software Manager satellite option is selected, the satellite must have an internet connection
to Cisco Smart Software Manager for the authorization to occur. The Cisco Smart Software Manager satellite
can operate in 2 modes: Connected Mode in which the connection time is configurable, and Disconnected
mode which requires a manual sync.
Optionally, if Unified Communications Manager cannot connect directly to Cisco Smart Software Manager,
you can deploy a proxy server to manage the connection.
For additional information about Cisco Smart Software Manager, go to https://software.cisco.com.
Note The Unified CM running in Dual Stack mode supports satellite configured with IPv4 and IPv6 address.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
6
System Components
License Types
For Cisco Smart Software Manager satellite information and documentation, go to https://www.cisco.com/c/
en/us/buy/smart-accounts/software-manager-satellite.html.
License Types
The following licensing types are available to cover your needs:
Cisco Unified Workspace Licensing
Cisco Unified Workspace Licensing (UWL) provides the most popular bundles of Cisco Collaboration
applications and services in a cost-effective, simple package. It includes soft clients, applications server
software, and licensing on a per-user basis.
Cisco User Connect Licensing
User Connect Licensing (UCL) is a per-user based license for individual Cisco Unified Communications
applications, which includes the applications server software, user licensing, and a soft client. Depending
on the type of device and number of devices that you require, UCL is available in Essential, Basic,
Enhanced, and Enhanced Plus versions.
For more information about these license types and the versions in which they are available, see
http://www.cisco.com/c/en/us/products/unified-communications/unified-communications-licensing/
index.html.
Session Management Edition
Session Management Edition can be registered to either Cisco Smart Software Manager or Cisco Smart
Software Manager satellite. You can register Session Management Edition using the same processes as
for Unified Communications Manager, register to a virtual account that Cisco Unified Communications
Manager is registered or a separate virtual account, and fulfill a minimal set of licenses requirement.
Note The SME registered in Specific License Reservation (SLR) requires a minimum set of licenses reserved
in CSSM while generating an SLR authorization code.
Note You cannot deploy a secure SIP trunk while running with a 90-day evaluation period. To deploy a secure SIP
trunk, your system must have registered to a Smart Software Manager account with the Allow export-controlled
functionality product registration token selected.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
7
System Components
System Licensing Prerequisites
Procedure
Step 2 Configure Connection to Smart Software Select transport settings through which Unified
Licensing, on page 9 Communications Manager connects to the
Smart Software Licensing service. The Direct
option is selected by default where the product
communicates directly with Cisco licensing
servers.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
8
System Components
Obtain the Product Instance Registration Token
Procedure
Step 1 Log in to your smart account in either Cisco Smart Software Manager or your Cisco Smart Software Manager
satellite.
Step 2 Navigate to the virtual account with which you want to associate the Unified Communications Manager
cluster.
Step 3 Generate a “Product Instance Registration Token”.
Note Select the Allow export-controlled functionality on the products registered with this token
check box to turn on the Export-Controlled functionality for tokens of a product instance you wish
in this smart account. By checking this check box and accepting the terms, you enable higher levels
of the product encryption for products registered with this Registration Token. By default, this check
box is selected. You can uncheck this check box if you wish not to allow the Export-Controlled
functionality to be made available for use with this token.
Caution Use this option only if you are compliant with the Export-Controlled functionality.
Note The Allow export-controlled functionality on the products registered with this token check
box is not displayed for the Smart Accounts that are not permitted to use the Export-Controlled
functionality.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
9
System Components
Register with Cisco Smart Software Manager
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Licensing > License Management.
The License Management window appears.
Step 2 From the Smart Software Licensing section, click the View/Edit the Licensing Smart Call Home settings
link.
The Transport Settings dialog box appears.
Step 3 Select the method of connecting Unified Communications Manager to the Smart Licensing service:
• Direct—Unified Communications Manager connects directly to the Smart Software Manager on cisco.com.
This is the default option. With this option, you must deploy DNS on Unified Communications Manager
that can resolve tools.cisco.com.
• Transport Gateway—Unified Communications Manager connects to an on-premise Cisco Smart
Software Manager satellite or Transport Gateway for system licensing. In the URL text box, enter the
address and port of the Smart Software Manager satellite or Transport Gateway. For example,
fqdn_of_smart_software_manager:port_number. For HTTPS, use port 443.
• HTTP/HTTPS Proxy— Unified Communications Manager connects to a proxy server, which connects
to the Cisco Smart Software Manager service along with Transport Gateway also along with satellite on
cisco.com. Enter the IP address or hostname of the proxy server along with the port:
• Authentication needed on HTTP or HTTPS proxy—Enable the checkbox if want to register to Cisco
Smart Software Manager using authentication based proxy server.
• IP Address/Host Name
• Port—For HTTPS, use port 443.
• User Name
• Password
Step 4 Check the Do not share my hostname or IP address with Cisco check box to restrict Unified Communications
Manager from sharing its IP address and hostname during the Smart Licensing registration.
Step 5 Click Save.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Licensing > License Management.
The License Management window appears.
Step 2 From the Smart Software Licensing section, click the Register button.
The Registration window appears.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
10
System Components
Additional Tasks with Smart Software Licensing
Step 3 In the Product Instance Registration Token section, paste the copied or saved “Registration Token Key”
that you generated using the Smart Software Manager or Smart Software Manager satellite.
Step 4 Click Register to complete the registration process.
Step 5 Click Close. For more information, see the online help.
Step 6 In the License Usage Report section, click Update Usage Details to manually update the system license
usage information.
Note Usage information is updated once every 6 hours automatically. For more information, see the
online help.
Procedure
Step 2 Renew Registration, on page 13 Complete this task to renew the registration
information manually.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
11
System Components
Renew Authorization
Step 4 Reregister License with Cisco Smart Software Complete this task to reregister Unified
Manager, on page 15 Communications Manager with Cisco Smart
Software Manager or Cisco Smart Software
Manager satellite.
Note Product may migrate to a different
virtual account by reregistering with
token from a new virtual account.
Renew Authorization
Use this procedure to manually renew the License Authorization Status for all the licenses listed under the
License Type.
Note The license authorization is renewed automatically every 30 days. The authorization status will expire after
90 days if it is not connected to Cisco Smart Software Manager or Cisco Smart Software Manager satellite.
If the Cisco Smart Software Manager satellite option is selected, the satellite must have an internet connection
to Cisco Smart Software Manager for the authorization to occur. The Cisco Smart Software Manager satellite
can operate in 2 modes: Connected Mode in which the connection time is configurable, and Disconnected
mode which requires a manual sync.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
12
System Components
Renew Registration
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Licensing > License Management.
The License Management window appears.
Step 2 From the Smart Software Licensing section, click the Actions drop-down list.
Step 3 Choose Renew Authorization Now.
The Renew Authorization window appears.
Step 4 Click Ok.
Unified Communications Manager sends a request to Cisco Smart Software Manager or Cisco Smart Software
Manager satellite to check the “License Authorization Status” and Cisco Smart Software Manager or Cisco
Smart Software Manager satellite reports back the status to Unified Communications Manager. For more
information, see the online help.
Step 5 In the License Usage Report section, click Update Usage Details to manually update the system license
usage information.
Note Usage information is updated once every 6 hours automatically. For more information on the fields
and their configuration options, see the system Online Help
Renew Registration
During product registration to Cisco Smart Software Manager or Cisco Smart Software Manager satellite,
there is a security association used to identify the product and is anchored by the registration certificate, which
has a lifetime of one year (that is, registration period). This is different from the registration token ID expiration,
which has the time limit for the token to be active. This registration period is automatically renewed every 6
months. However, if there is an issue, you can manually renew this registration period.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Licensing > License Management.
The License Management window appears.
Step 2 From the Smart Software Licensing section, click the Actions drop-down list.
Step 3 Choose Renew Registration Now.
The Renew Registration window appears.
Step 4 Click Ok.
Unified Communications Manager sends a request to Cisco Smart Software Manager or Cisco Smart Software
Manager satellite to check the “Registration Status” and Cisco Smart Software Manager or Cisco Smart
Software Manager satellite reports back the status to Unified Communications Manager.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
13
System Components
Deregister
Step 5 In the License Usage Report section, click Update Usage Details to manually update the system license
usage information.
Note Usage information is updated once every 6 hours automatically. For more information on the fields
and their configuration options, see the system Online Help.
Deregister
Use this procedure to unregister from Cisco Smart Software Manager or Cisco Smart Software Manager
satellite and release all the licenses from the current virtual account. This procedure also disconnects Unified
Communications Manager cluster from Cisco Smart Software Manager or Cisco Smart Software Manager
satellite. All license entitlements used for the product are released back to the virtual account and is available
for other product instances to use.
Note If Unified Communications Manager is unable to connect with the Cisco Smart Software Manager or Cisco
Smart Software Manager satellite, and the product is still deregistered, then a warning message is displayed.
This message notifies you to remove the product manually from Cisco Smart Software Manager or Cisco
Smart Software Manager satellite to free up licenses.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Licensing > License Management.
The License Management window appears.
Step 2 From the Smart Software Licensing section, click the Actions drop-down list.
Step 3 Choose Deregister.
The Deregister window appears.
Step 4 Click Ok.
Step 5 In the License Usage Report section, click Update Usage Details to manually update the system license
usage information.
Note Usage information is updated once every 6 hours automatically. For more information on the fields
and their configuration options, see the system Online Help.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
14
System Components
Reregister License with Cisco Smart Software Manager
Note • If the data plane encryption (Unified Communications Manager cluster in mixed-mode) has
been enabled after registered with Cisco Smart Software Manager or Cisco Smart Software
Manager satellite and the product is later deregistered, then mixed-mode will continue to be
enabled.
An alert named SmartLicenseExportControlNotAllowed is sent to the administrator to set
cluster to non-secure mode when the product is deregistered from Cisco Smart Software
Manager or Cisco Smart Software Manager satellite. The mixed-mode will continue to be
enabled even after the reboot.
• This behavior after deregistration, may change in future versions of the product. For more
details on setting up CTL Client, see the “Set Up Cisco CTL Client” chapter of the Security
Guide for Cisco Unified Communications Manager at http://www.cisco.com/c/en/us/support/
unified-communications/unified-presence/products-maintenance-guides-list.html.
For more details on Mixed Mode with Tokenless CTL, see the “CUCM Mixed Mode with
Tokenless CTL” at http://www.cisco.com/c/en/us/support/unified-communications/
unified-communications-manager-callmanager/products-tech-notes-list.html.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Licensing > License Management.
The License Management window appears.
Step 2 From the Smart Software Licensing section, click the Register button.
The Registration window appears.
Step 3 From the Smart Software Licensing section, click the Actions drop—down list.
Step 4 Choose Reregister.
The Reregister window appears.
Step 5 Click Ok.
Step 6 In the Product Instance Registration Token section, paste the copied or saved “Registration Token Key”
that you generated using the Cisco Smart Software Manager or Cisco Smart Software Manager satellite.
Step 7 Click Register to complete the registration process.
Step 8 Click Close. For more information, see the online help.
Step 9 In the License Usage Report section, click Update Usage Details to manually update the system license
usage information.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
15
System Components
Specific License Reservation
Note Usage information is updated once every 6 hours automatically. For more information on the fields
and their configuration options, see the system Online Help.
An update or change in reserved licenses (increase or decrease) can be done on previously reserved licenses
in Cisco Smart Software Manager. The new authorization code can be installed on the Product and a
confirmation code can be obtained. The new changes remain in transit status unless confirmation code from
the product is installed on the Cisco Smart Software Manager.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
16
System Components
Specific License Reservation
When licenses are reserved on a Product Instance (Unified Communications Manager), there are two ways
to remove the product from the smart account and release all the licenses that are reserved for that Product
Instance (Unified Communications Manager):
Product Instance is operational (graceful removal): User can return the Specific License Reservation
authorization by creating a Reservation Return code on the Product Instance (which removes the Authorization
Code) and then enter the Reservation Return code into Cisco Smart Software Manager.
Product Instance is not operational (failure/RMA or due to destroying the VM/container): User must
contact TAC, who can remove the Product Instance from thier smart account.
Figure 3: Remove a Product Instance - Unified Communications Manager
Note User can use only the CLI configuration to enable Specific License Reservation.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
17
System Components
Specific License Reservation Task Flow
Note When Specific License Reservation is enabled on Unified Communications Manager, voucher generation for
cloud on-boarding will is not supported.
Customer who is entitled to License reservation feature on their Smart Account can reserve licenses from
their virtual account, tie them to a devices UDI and use their device with these reserved licenses in a
disconnected mode. The customer reserves specific licenses and counts for a UDI from their virtual account.
The following options describe the new functionality and design elements for Specific License Reservation:
• license smart reservation enable
• license smart reservation disable
• license smart reservation request
• license smart reservation cancel
• update license reservation
• license smart reservation install "<authorization-code>"
• license smart reservation install-file <url>
• license smart reservation return
• license smart reservation return-authorization "<authorization-code>"
Procedure
From Cisco Unified CM Admin Console execute the below CLI command.
• license smart reservation enable
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
18
System Components
license smart reservation request
Procedure
Step 1 From Cisco Unified CM Admin Console executelicense smart reservation request command.
Step 2 Log into CSSM [Cisco Smart Software manager] and enter the reservation request code.
Step 3 Select the licenses that have to be reserved for this device and generate Authorization code.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
19
System Components
license smart reservation install "<authorization-code>"
Step 4 Copy the authorization code to the product instance and execute the license smart reservation install
"<authorization-code> "command to install.
Procedure
From Cisco Unified CM Admin Console execute the below CLI command.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
20
System Components
license smart reservation install-file <url>
Note url is mandatory Path to the authorization-code file on SFTP server in below format:
Procedure
From Cisco Unified CM Admin Console execute the below CLI command.
• license smart reservation install-file <url>
Procedure
From Cisco Unified CM Admin Console execute the below CLI command.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
21
System Components
update license reservation
Note License borrowing from a higher tier does not happen automatically when a Specific License Reservation is
enabled on Unified Communications Manager. License Reservation has to be updated manually to the Unified
Communications Manager license consumption/usage.
Procedure
Step 1 Select Update Reserved Licenses from Actions drop-down list next to the Product Instance that you wish to
update reservation on CSSM.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
22
System Components
update license reservation
Step 2 Update the reservation (Add/Remove/Update licenses for this product instance) and generate authorization
code.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
23
System Components
update license reservation
Step 3 Copy the authorization code to the product instance and execute the license smart reservation install
“<authorization-code>” command to install.
Step 4 Confirmation code is generated on the product after the authorization code is successfully installed.
Step 5 Copy the confirmation code to the CSSM and enter to complete the reservation update.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
24
System Components
license smart reservation cancel
Procedure
From Cisco Unified CM Admin Console execute the below CLI command.
• license smart reservation cancel
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
25
System Components
license smart reservation return
Procedure
Step 1 From Cisco Unified CM Admin Console execute the license smart reservation return command.
Step 2 Copy the reservation return code to CSSM and remove the product instance.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
26
System Components
license smart reservation return-authorization "<authorization-code>"
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
27
System Components
Smart Licensing Export Compliance
Procedure
Step 1 From Cisco Unified CM Admin Console execute the license smart reservation return-authorization
"<authorization-code>" command.
Step 2 Copy the reservation return code to CSSM and remove the product instance.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
28
System Components
Export Control Task Flow
Software Manager or the satellite and enable the export restricted feature on Cisco Unified Communications
Manager.
The following options describe the new functionality and design elements for the export control feature:
• license smart export request local <exportfeaturename>
• license smart export return local <exportfeaturename>
• license smart export cancel
Procedure
From Cisco Unified CM Admin Console, execute the following CLI command:
• license smart export request local <exportfeaturename>
Procedure
From Cisco Unified CM Admin Console, execute the following CLI command:
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
29
System Components
license smart export cancel
Procedure
From Cisco Unified CM Admin Console, execute the following CLI command:
• license smart export cancel
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
30
CHAPTER 3
Configure Enterprise Parameters and Services
• Enterprise Parameters Overview, on page 31
• Service Parameters Overview, on page 32
• System Parameters Task Flow, on page 32
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
31
System Components
Service Parameters Overview
You can view service parameter field descriptions for service parameters by by clicking the ? icon within the
Service Parameter Configuration window, or by clicking on one of the parameter names.
Note If you deactivate a service, Unified Communications Manager retains any updated service parameter values.
If you start the service again, Unified Communications Manager sets the service parameters to the changed
values.
Procedure
Step 3 Configure Service Parameters, on page 40. Configure service parameters for the publisher
and subscriber nodes in the cluster.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
32
System Components
Configure Enterprise Parameters
Note If you edit a parameter in Cisco Unified CM Administration, the new setting also reflects in Cisco Unified
CM, IM and Presence Administration.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Enterprise Parameters.
The Enterprise Parameters window displays the list of enterprise parameters.
Table 1: Common Enterprise Parameters for an Initial Unified Communications Manager Setup
Enterprise Parameters
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
33
System Components
Common Enterprise Parameters
Connection Monitor If an IP phone in the cluster registers on a secondary node, use this parameter to
Duration set the amount of time that the IP phone waits before it falls back and re-registers
with the primary node after the primary node becomes available. This parameter
affects all secure devices for a specific Secure Survivable Remote Site Telephony
(SRST) router.
For more information, see Security Guide for Cisco Unified Communications
Manager.
Default: 120 seconds
Restart all services for the changes to take effect.
CCMAdmin Parameters
Enable Dependency This parameter is used to display dependency records that are required for
Records troubleshooting. Displaying the dependency records may be beneficial during an
initial system setup.
Displaying the dependency records could lead to high CPU usage spikes and
could impact call processing. To avoid possible performance issues, disable this
parameter after the system setup is complete. We recommend displaying
dependency records only during off-peak hours or during a maintenance window.
When enabled, you can select Dependency Records from the Related Links
drop-down list, which is accessible from most configuration windows using
Unified Communications Manager.
Default: False
Enable All User Search This parameter allows you to search the corporate directory for all users when
no last name, first name, or directory number is specified. This parameter also
applies to directory searches on the Cisco CallManager Self Care (CCMUser)
window.
Default: True
Organization Top Level This parameter defines the top-level domain for the organization. For example,
Domain cisco.com.
Maximum length: 255 characters
Allowed values: A valid domain using upper and lowercase letters, numbers
(0-9), hyphens, and dots (as a domain label separator). Domain labels must not
start with a hyphen. The last label must not start with a number. For example,
this domain is invalid -cisco.1om.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
34
System Components
Common Enterprise Parameters
Cluster Fully Qualified This parameter defines one or more Fully Qualified Domain Names (FQDN) for
Domain Name the cluster. Multiple FQDNs must be separated by a space. Specify wildcards
within an FQDN using an asterisk (*). Example: cluster-1.cisco.com
*.cisco.com.
Requests containing URLs, such as SIP calls, that have a host portion that matches
any of the FQDNs in this parameter are routed to that cluster and the attached
devices.
Maximum length: 255 characters
Allowed values: An FQDN or a partial FQDN using the * wildcard. Upper and
lowercase letters, numbers (0-9), hyphens, and dots (as a domain label separator).
Domain labels must not start with a hyphen. The last label must not start with a
number. For example, this domain is invalid -cisco.1om.
IPv6
Enable IPv6 This parameter determines whether Unified Communications Manager can
negotiate Internet Protocol Version 6 (IPv6) and whether phones are allowed to
advertise IPv6 capability.
IPv6 must be enabled on all other network components including on the platform
of all nodes before you enable this parameter. Otherwise, the system continues
to run in IPv4-only mode.
This is a required field.
Default: False (IPv6 is disabled)
You must restart the following services for the IPv6 parameter change to take
effect, and the affected services in the IM and Presence Service cluster.
• Cisco CallManager
• Cisco IP Voice Media Streaming App
• Cisco CTIManager
• Cisco Certificate Authority Proxy Function
Remote Syslog Server Enter the name or IP address of the remote Syslog server. Cisco Unified
Name 1 Serviceability do not send the Syslog messages if a server name is not specified.
This parameter is required only if you are using the Syslog server for logs.
Maximum length: 255 characters
Allowed values: A valid remote Sylog server name using upper and lowercase
letters, numbers (0-9), hyphens, and dots.
Do not specify another Unified Communications Manager node as the destination.
Cisco Jabber
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
35
System Components
Common Enterprise Parameters
Never Start Call with This parameter determines if video is sent when a video call starts. Select True
Video to start video calls without immediately sending video. Anytime during the video
call, you can choose to start sending your video.
This parameter overrides any IM and Presence Service preferences. When set to
False, video calls start according to the preferences set in IM and Presence Service.
Default: False.
SSO Login Behavior for This parameter is required to allow Cisco Jabber to perform the certificate-based
iOS authentication with the IdP in a controlled mobile device management (MDM)
deployment.
The SSO Login Behavior for iOS parameter includes the following options:
• Use Embedded Browser—If you enable this option, Cisco Jabber uses the
embedded browser for the SSO authentication. Use this option to allow iOS
devices prior to version 9 to use SSO without cross-launching into the native
Apple Safari browser.
• Use Native Browser—If you enable this option, Cisco Jabber uses the Apple
Safari framework on an iOS device to perform the certificate-based
authentication with an Identity Provider (IdP) in the MDM deployment.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
36
System Components
Activate Essential Services
OAuth with Refresh This parameter controls the login flow used by clients such as Cisco Jabber when
Login Flow connecting to Unified Communication Managers.
• Enabled—If you enable this option, clients can use an oAuth-based Fast
Login flow to provide a quicker and streamlined login experience, without
requiring the user input to re-log in. For example, due to a network change.
The option requires support from the other components of the Unified
Communications solution, such as Expressway and Unity Connection
(compatible versions with the refresh login flow enabled).
• Disabled—If you enable this option, the existing behavior is preserved and
is compatible with older versions of other system components.
Note For Mobile and Remote Access deployment with Cisco Jabber,
we recommend enabling this parameter only with a compatible
version of Expressway that supports oAuth with Refresh login
flow. Incompatible version may impact the Cisco Jabber
functionality. Please refer the specific product documents for
supported version and configuration requirements.
Use SSO for RTMT This parameter is configured to enable SAML SSO for Real-Time Monitoring
Tool (RTMT).
The Use SSO for RTMT parameter includes the following options:
• True—If you choose this option, RTMT displays the SAML SSO-based
IdP sign-in window.
Note When you perform a fresh install, the default value of the Use
SSO for RTMT parameter appears as True.
• False—If you choose this option, RTMT displays the basic authentication
sign-in window.
Note When you perform an upgrade from a Cisco Unified
Communications Manager version where Use SSO for RTMT
parameter does not exist, the default value of this parameter in
the newer version appears as False.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
37
System Components
Recommended Services for Publisher Nodes
Procedure
Step 1 From Cisco Unified Serviceability, choose Tools > Service Activation.
Step 2 Select a Server from the drop-down menu and click Go.
The services and their current status display.
Table 2: Recommended Publisher Node Services for Non-Dedicated TFTP Server Deployments
Cisco CTIManager
Cisco TFTP
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
38
System Components
Recommended Services for Subscriber Nodes
Tip You can safely disable the following services if you do not plan to use them:
• Cisco Messaging Interface
• Cisco DHCP Monitor Service
• Cisco TAPS Service
• Cisco Directory Number Alias Sync
• Cisco Directory Number Alias SyncCisco Dialed Number Analyzer Server
• Cisco Dialed Number Analyzer
• Self Provisioning IVR
Tip You can safely disable the other services if you don't plan to use them.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
39
System Components
Configure Service Parameters
Table 3: Recommended Subscriber Node Services for Non-Dedicated TFTP Server Deployments
Cisco CTIManager
Cisco TFTP
You must activate the following services on each IM and Presence Service node in your cluster.
• Cisco SIP Proxy
• Cisco Presence Engine
• Cisco XCP Connection Manager
• Cisco XCP Authentication Service
Caution Some changes to service parameters can cause system failure. We recommend that you do not make any
changes to service parameters unless you fully understand the feature that you are changing or unless the
Cisco Technical Assistance Center (TAC) specifies the changes.
Procedure
Step 1 From Cisco Unified CM Administration, choose choose System > Service Parameters.
Step 2 Select a node in the Server drop-down list.
Step 3 Select a service in the Service drop-down list.
Tip Click the ? icon in the Service Parameter Configuration window to view a list of service parameters
along with their descriptions.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
40
System Components
View Clusterwide Service Parameter Settings
Procedure
Step 1 To display services and view service parameter settings for a node using Cisco Unified Communications
Manager Assistant, perform the following steps.
a) Select System > Service Parameters.
b) In the Service Parameters Configuration window, select a node in the Server drop-down box.
c) Select a service in the Service drop-down box.
All parameters that apply to the selected node appear. Parameters that appear in the Clusterwide
Parameters (General) section apply to all nodes in the cluster.
d) Click the (?) icon in the Service Parameter Configuration window to view a list of service parameters
along with their descriptions.
Step 2 To display the service parameters for a particular service on all nodes in a cluster, select Parameters for All
Servers in the Related Links drop-down box in the Service Parameters Configuration window, then click
Go.
The Parameters for All Servers window appears. You can click on a server name that is listed or on a
parameter value to open the related Service Parameter Configuration window.
Step 3 To display out-of-sync service parameters for a particular service on all nodes in a cluster, select Out of Sync
Parameters for All Servers in the Related Links drop-down box in the Parameters for All Servers window,
then click Go.
The Out of Sync Parameters for All Servers window appears. You can click on a server name that is listed
or on a parameter value to open the related Service Parameter Configuration window.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
41
System Components
View Clusterwide Service Parameter Settings
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
42
CHAPTER 4
Configure IPv6 Stack
• IPv6 Stack Overview, on page 43
• IPv6 Prerequisites, on page 44
• IPv6 Configuration Task Flow, on page 44
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
43
System Components
IPv6 Prerequisites
Note If you need your SIP devices to operate in both IPv4 and IPv6 networks, you will need to configure two stacks.
After you complete the tasks in this chapter to enable the IPv6 stack in Cisco Unified Communications
Manager, you will then have to also enable your SIP network for two stacks. See Two Stacks (IPv4 and IPv6)
Overview, on page 49.
IPv6 Prerequisites
Before you configure Cisco Unified Communications Manager with IPv6 support, you must configure the
following network servers and devices to support IPv6. For details, refer to your device user documentation:
• Provision a DHCP and DNS server with IPv6 support. The Cisco Network Registrar server supports
IPv6 for DHCP and DNS.
• Configure the IOS for network devices such as gateways, routers, and MTPs with IPv6 support.
• Configure your TFTP server to run IPv6.
Procedure
Step 2 Configure Server for IPv6, on page 45 Configure the servers in your cluster with IPv6
addresses.
Step 3 Enable IPv6, on page 46 Configure enterprise parameters that enable the
system for IPv6.
Step 4 Perform any of the following: You can configure an enterprise parameter to
assign a clusterwide IP Addressing preference.
• Configure IP Addressing Preference for
Cluster, on page 46 If you want to assign different preferences for
• Configure IP Addressing Preferences for different groups of endpoints, configure the
Devices, on page 47 addressing preference within a Common Device
Configuration.
Configure cluster settings for which IP
addressing method is preferred.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
44
System Components
Configure IPv6 in Operating System
What to do next
To configure dual stack trunks, refer to the chapters for configuring SIP trunks.
To configure dual stack for SIP devices, refer to the sections for the SIP devices that you want to configure.
Note Use Cisco IOS IPv6 DHCP server because the IPv6 DHCP server configuration is not supported on Windows.
Procedure
Step 1 From Cisco Unified OS Administration, choose Settings > IPv6 > Ethernet.
Step 2 Check the Enable IPv6 check box.
Step 3 From the Address Source drop-down list box, configure how the system acquires the IPv6 address:
• Router Advertisement—The system uses stateless autoconfiguration to acquire an IPv6 address.
• DHCP—The system acquires an IPv6 address from a DHCP server.
• Manual Entry—Choose this option if you want to enter the IPv6 address manually.
Step 4 If you have configured Manual Entry as the means of acquiring an IPv6 address, complete the following
fields:
• Enter an IPv6 Address. For example, fd62:6:96:2le:bff:fecc:2e3a.
• Enter an IPv6 Mask. for example, 64.
Step 5 Check the Update with Reboot check box to ensure that the system reboots after you save.
Step 6 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
45
System Components
Enable IPv6
Procedure
Enable IPv6
If you want to set up IPv6 support in your system, you must enable the system to support IPv6 devices.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Enterprise Parameters.
Step 2 Set the value of the Enable IPv6 enterprise parameter to True.
Step 3 Click Save.
What to do next
Configure IP addressing preferences for the devices in your cluster. You can apply settings via a clusterwide
enterprise parameter or you can use a Common Device Configuration to apply settings to a group of devices
that uses that configuration:
• Configure IP Addressing Preference for Cluster, on page 46
• Configure IP Addressing Preferences for Devices, on page 47
Note The IP address preferences in a Common Device Configuration override the clusterwide enterprise parameter
settings for the devices that use that Common Device Configuration.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
46
System Components
Configure IP Addressing Preferences for Devices
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Enterprise Parameters.
Step 2 Set the value of the IP Addressing Mode Preference for Media enterprise parameter to IPv4 or IPv6
Step 3 Set the value of the IP Addressing Mode Preference for Signaling enterprise parameter to IPv4 or IPv6.
Step 4 Click Save.
Note The IP address preferences in a Common Device Configuration override the clusterwide enterprise parameter
settings for the devices that use that Common Device Configuration.
Procedure
Step 1 From Cisco Unified CM Administration, choose Device > Device Settings > Common Device Configuration.
Step 2 Click Add New.
Step 3 For SIP trunks, SIP Phones or SCCP phones, choose a value for the IP Addressing Mode drop-down list:
• IPv4 Only—The device uses only an IPv4 address for media and signaling.
• IPv6 Only—The device uses only an IPv6 address for media and signaling.
• IPv4 and IPv6 (Default)—The device is a dual-stack device and uses whichever IP address type is
available. If both IP address types are configured on the device, for signaling the device uses the IP
Addressing Mode Preference for Signaling setting and for media the device uses the IP Addressing
Mode Preference for Media enterprise parameter setting.
Step 4 If you configure IPv6 in your previous step, then configure an IP addressing preference for the IP Addressing
Mode for Signaling drop-down list:
• IPv4—The dual stack device prefers IPv4 address for signaling.
• IPv6—The dual stack device prefers IPv6 address for signaling.
• Use System Default—The device uses the setting for the IP Addressing Mode Preference for Signaling
enterprise parameter.
Step 5 Configure the remaining fields in the Common Device Configuration window. For more information on the
fields and their configuration options, see the system Online Help.
Step 6 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
47
System Components
Restart Services
What to do next
If your IPv6 configuration is complete, Restart Services, on page 48.
If you want your SIP devices to support both IPv4 and IPv6 networks simultaneously, you must configure
the system to support both stacks at the device level. For details, see Two Stacks (IPv4 and IPv6) Overview,
on page 49.
Restart Services
After configuring your system for IPv6, restart essential services.
Procedure
Step 1 Log into Cisco Unified Serviceability and choose Tools > Control Center - Feature Services.
Step 2 Check the check box corresponding to each of the following services:
• Cisco CallManager
• Cisco CTIManager
• Cisco Certificate Authority Proxy Function
• Cisco IP Voice Media Streaming App
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
48
CHAPTER 5
Configure Two Stacks (IPv4 and IPv6)
• Two Stacks (IPv4 and IPv6) Overview, on page 49
• Two Stacks (IPv4 and IPv6) Prerequisites, on page 49
• Two Stacks (IPv4 and IPv6) Configuration Task Flow, on page 50
For SIP devices and trunks, you can enable two-stack support by configuring Alternate Network Address
Types (ANAT). When ANAT is applied to a SIP device or trunk, the SIP signaling that the device or trunk
sends includes both an IPv4 and IPv6 address, if both are available. ANAT allows the endpoint to interoperate
seamlessly in both IPv4-only and IPv6-only networks.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
49
System Components
Two Stacks (IPv4 and IPv6) Configuration Task Flow
Procedure
Step 2 Apply ANAT to SIP Phone, on page 51 Apply the ANAT-enabled SIP Profile to a SIP
phone. This allows the SIP phone to support
both IPv4 and IPv6 stacks simultaneously.
Step 3 Apply ANAT to a SIP Trunk, on page 51 Apply the ANAT-enabled SIP Profile to a SIP
trunk. This allows the trunk to support both
IPv4 and IPv6 stacks simultaneously.
Step 4 Restart Services, on page 51 After configuring your system to support both
IPv4 and IPv6 stacks simultaneously, restart
essential services.
Procedure
Step 1 From Cisco Unified CM Administration, choose Device > Device Settings > SIP Profile.
Step 2 Do one of the following:
a) Click Add New to create a new SIP Profile.
b) Click Find and select an existing SIP Profile.
Step 3 Check the Enable ANAT check box.
Step 4 Complete the remaining fields in the SIP Profile Configuration window. For more information on the fields
and their configuration options, see the system Online Help.
Step 5 Click Save.
You must apply the SIP Profile to a SIP phone or SIP trunk to enable those devices to support both IPv4 and
IPv6 stacks simultaneously.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
50
System Components
Apply ANAT to SIP Phone
Procedure
Note For more information on SIP trunk configuration options, see Configure SIP Trunks, on page 85.
Procedure
Restart Services
After configuring your system to support both IPv4 and IPv6 stacks simultaneously, restart essential services.
Procedure
Step 1 Log into Cisco Unified Serviceability and choose Tools > Control Center - Feature Services.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
51
System Components
Restart Services
Step 2 Check the check box corresponding to each of the following services:
• Cisco CallManager
• Cisco CTIManager
• Cisco Certificate Authority Proxy Function
• Cisco IP Voice Media Streaming App
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
52
CHAPTER 6
Configure Basic Security
• About Security Configuration, on page 53
• Security Configuration Tasks, on page 53
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
53
System Components
Download Certificates
Note Make sure that Communications Manager is registered with the Cisco Smart Software Manager or
Cisco Smart Software Manager satellite and the Registration Token received from the Smart account
or Virtual account has Allow export-controlled functionality enabled while registering with this
cluster.
Download Certificates
Use the download certificates task to have a copy of your certificate or upload the certificate when you submit
a CSR request.
Procedure
Step 1 From Cisco Unified OS Administration, choose Security > Certificate Management.
Step 2 Specify search criteria and then click Find.
Step 3 Choose the required file name and Click Download.
Note If you generate a new CSR, you overwrite any existing CSRs.
Procedure
Step 1 From Cisco Unified OS Administration, choose Security > Certificate Management.
Step 2 Click Generate CSR.
Step 3 Configure fields on the Generate Certificate Signing Request window. See the online help for more
information about the fields and their configuration options.
Step 4 Click Generate.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
54
System Components
Upload Root Certificate for Third-Party CAs
Procedure
Step 1 From Cisco Unified OS Administration, choose Security > Certificate Management.
Step 2 Click Download CSR.
Step 3 Choose the certificate name from the Certificate Purpose drop-down list.
Step 4 Click Download CSR.
Step 5 (Optional) If prompted, click Save.
Note Skip this task if you don't want to use a third-party CA to sign LSCs.
Procedure
Step 1 From Cisco Unified OS Administration choose Security > Certificate Management.
Step 2 Click Upload Certificate/Certificate chain.
Step 3 From the Certificate Purpose drop-down list, choose CAPF-trust.
Step 4 Enter a Description for the certificate. For example, Certificate for External LSC-Signing CA.
Step 5 Click Browse, navigate to the file, and then click Open.
Step 6 Click Upload.
Step 7 Repeat this task, uploading certificates to callmanager-trust for the Certificate Purpose.
TLS Prerequisites
Before you configure the minimum TLS version, make sure that your network devices and applications both
support the TLS version. Also, make sure that they are enabled for TLS that you want to configure with
Unified Communications Manager and IM and Presence Services. If you have any of the following products
deployed, confirm that they meet the minimum TLS requirement. If they do not meet this requirement, upgrade
those products:
• Skinny Client Control Protocol (SCCP) Conference Bridge
• Transcoder
• Hardware Media Termination Point (MTP)
• SIP Gateway
• Cisco Prime Collaboration Assurance
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
55
System Components
Set Minimum TLS Version
You will not be able to upgrade conference bridges, Media Termination Point (MTP), Xcoder, Prime
Collaboration Assurance, and Prime Collaboration Provisioning.
Note If you are upgrading from an earlier release of Unified Communications Manager, make sure that all your
devices and applications support the higher version of TLS before you configure it. For example, Unified
Communications Manager and IM and Presence Services, Release 9.x supports TLS 1.0 only.
Procedure
Step 4 Perform Step 3 on all Unified Communications Managerand IM and Presence Service Service cluster nodes.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Enterprise Parameters.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
56
System Components
Set TLS Ciphers
Step 2 In Security Parameters, configure a value for the TLS Ciphers enterprise parameter. For help on the available
options, refer to the enterprise parameter online help.
Step 3 Click Save.
Note All TLS Ciphers will be negotiated based on client cipher preference
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
57
System Components
Set TLS Ciphers
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
58
CHAPTER 7
Configure Single Sign-On
• About SAML SSO Solution, on page 59
• SAML SSO Configuration Task Flow, on page 60
Important When deploying Cisco Jabber with Cisco Webex meeting server, Unified Communications Manager and the
Webex meeting server must be in the same domain.
SAML is an XML-based open standard data format that enables administrators to access a defined set of Cisco
collaboration applications seamlessly after signing into one of those applications. SAML describes the exchange
of security related information between trusted business partners. It is an authentication protocol used by
service providers (for example, Unified Communications Manager) to authenticate a user. SAML enables
exchange of security authentication information between an Identity Provider (IdP) and a service provider.
SAML SSO uses the SAML 2.0 protocol to offer cross-domain and cross-product single sign-on for Cisco
collaboration solutions. SAML 2.0 enables SSO across Cisco applications and enables federation between
Cisco applications and an IdP. SAML 2.0 allows Cisco administrative users to access secure web domains to
exchange user authentication and authorization data, between an IdP and a Service Provider while maintaining
high security levels. The feature provides secure mechanisms to use common credentials and relevant
information across various applications.
The authorization for SAML SSO Admin access is based on Role-Based Access Control (RBAC) configured
locally on Cisco collaboration applications.
SAML SSO establishes a Circle of Trust (CoT) by exchanging metadata and certificates as part of the
provisioning process between the IdP and the Service Provider. The Service Provider trusts the IdP's user
information to provide access to the various services or applications.
Important Service providers are no longer involved in authentication. SAML 2.0 delegates authentication away from
the service providers and to the IdPs.
The client authenticates against the IdP, and the IdP grants an Assertion to the client. The client presents the
Assertion to the Service Provider. Since there is a CoT established, the Service Provider trusts the Assertion
and grants access to the client.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
59
System Components
SAML SSO Configuration Task Flow
Note The above links are examples only. Refer to your IdP documentation for official documentation.
Procedure
Step 2 Configure SAML SSO on the Identity Provider Complete the following tasks:
(IdP)
• Upload the UC metadata file that was
exported from Unified Communications
Manager in order to complete the Circle
of Trust relationship.
• Configure SAML SSO on the IdP
• Export an IdP metadata file. This file will
be imported into the Unified
Communications Manager
Step 3 Enable SAML SSO in Cisco Unified Import your IdP metadata and enable SAML
Communications Manager SSO in Unified Communications Manager.
Step 4 Restart Cisco Tomcat Service, on page 63 Before and After you enable SSO, you must
restart the Cisco Tomcat service on all cluster
nodes where SSO is enabled.
Step 5 Verify the SAML SSO Configuration, on page Verify that SAML SSO has been configured
63 successfully.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
60
System Components
Export UC Metadata from Cisco Unified Communications Manager
Procedure
Step 1 From Cisco Unified CM Administration, choose System > SAML Single Sign-On
Step 2 From the SAML Single Sign-On window, choose one of the options for the SSO Mode field:
• Cluster wide—A single SAML agreement for the cluster.
Note If you choose this option, ensure that Tomcat servers for all the nodes in the cluster have the
same certificate, which is the multi-server SAN certificate.
Step 3 From the SAML Single Sign-On window, choose one of the options for the Certificate field.
• Use system generated self-signed certificate
• Use Tomcat certificate
What to do next
Complete the following tasks on the IdP:
• Upload the UC metadata file that was exported from Unified Communications Manager
• Configure SAML SSO on the IdP
• Export an IdP metadata file. This file will be imported into the Unified Communications Manager in
order to complete the Circle of Trust relationship.
Important Cisco recommends that you restart Cisco Tomcat service after enabling or disabling SAML SSO.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
61
System Components
Enable SAML SSO in Cisco Unified Communications Manager
Note The Cisco CallManager Admin, Unified CM IM and Presence Administration, Cisco CallManager
Serviceability, and Unified IM and Presence Serviceability services are restarted after you enable or disable
SAML SSO.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > SAML Single Sign-On.
Step 2 Click Enable SAML SSO and then click Continue.
A warning message notifies you that all server connections will be restarted.
Step 3 If you have configured the Cluster wide SSO mode, click the Test for Multi-server tomcat certificate
button. Otherwise, you can skip this step.
Step 4 Click Next.
A dialog box that allows you to import IdP metadata appears. To configure the trust relationship between the
IdP and your servers, you must obtain the trust metadata file from your IdP and import it to all your servers.
Step 5 Import the metadata file that you exported from your IdP:
a) Browse to locate and select your exported IdP metadata file.
b) Click Import IdP Metadata.
c) Click Next.
d) At the Download Server Metadata and Install on IdP screen, click Next.
Note The Next button is enabled only if the IdP metadata file is successfully imported on at least one
node in the cluster.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
62
System Components
Restart Cisco Tomcat Service
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
63
System Components
Verify the SAML SSO Configuration
Procedure
Step 1 From the Cisco Unified CM Administration, choose System > SAML Single Sign-On and the SAML Single
Sign-On Configuration window opens, click Next.
Step 2 Choose an administrative user form the Valid Administrator Usernames area and click the Run SSO Test…
button.
Note The user for the test must have administrator rights and has been added as a user on the IdP server.
The Valid Administrator Usernames area displays a list of users, which can be drawn on to run the
test.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
64
CHAPTER 8
Configure Core Settings for Device Pools
• Device Pools Overview, on page 65
• Device Pool Prerequisites, on page 71
• Core Settings for Device Pools Configuration Task Flow, on page 71
• Call Preservation, on page 80
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
65
System Components
Regions Overview
During installation, you must set up an NTP server for the Unified Communications Manager publisher node.
The subscriber nodes then sync their time from the publisher node.
You can assign up to five NTP servers.
Authenticated NTP
To provide more network security to the NTP portion of your network, you can configure Authenticated NTP.
Authenticated NTP is configured on the Cisco Unified Communications Manager publisher node. The subscriber
nodes and IM and Presence nodes sync the time from the Unified CM publisher node.
You can choose from the following authentication methods:
• Authentication through Symmetric Key: If you choose this option, the devices in your network use a
symmetric key to encrypt and authenticate NTP messages. This option is recommended by some vendors,
such as RedHat.
• Authentication through Autokey (PKI-based infrastructure): If you choose this option, the devices
in your network use the autokey protocol to encrypt and authenticate NTP messages. This method is
mandatory for Common Criteria compliance.
• No Authentication: If you choose not to configure Authentication through Symmetric Key or
Authentication through Autokey methods, NTP messages will not be authenticated.
Regions Overview
Regions provide capacity controls for Unified Communications Manager multi-site deployments where you
may need to limit the bandwidth for certain calls. For example, you can use regions to limit the bandwidth
for calls that are sent across a WAN link, while maintaining a higher bandwidth for internal calls. You can
use regions to limit the bandwidth for audio and video calls by setting the maximum bitrate for intraregional
or interregional calls to whatever the region(s) can provide.
Additionally, the system uses regions to set the audio codec priority where you have applications that support
specific codecs only. You can configure a prioritized list of supported audio codecs and apply it to calls to
and from specific regions.
When you configure the maximum audio bit rate setting in the Region Configuration window (or use the
service parameter in the Service Parameter Configuration window), this setting serves as a filter. When an
audio codec is selected for a call, Unified Communications Manager takes the matching codecs from both
sides of a call leg, filters out the codecs that exceed the configured maximum audio bit rate, and then picks
the preferred codec among the codecs that are remaining in the list.
Unified Communications Manager supports up to 2000 regions.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
66
System Components
Regions Overview
G.711 The most commonly supported codec, used over the public switched telephone
network.
G.722 Wideband codec often used in video conferences. This is always preferred by
Unified Communications Manager over G.711, unless G.722 is disabled.
G.722.1 Low complexity wideband codec operating at 24 and 32 kb/s. The audio quality
approaches that of G.722 while using, at most, half the bit rate.
G.729 Low bit rate codec with 8 kb/s compression that is supported by Cisco IP Phone
7900, and typically used for calls across a WAN link.
GSM The global system for mobile communications (GSM) codec. GSM enables
the MNET system for GSM wireless handsets to operate with Unified
Communications Manager.
AAC-LD (mpeg4-generic) Supported for SIP devices, in particular, Cisco TelePresence systems.
Internet Speech Audio An adaptive wideband audio codec, specially designed to deliver wideband
Codec (iSAC) sound quality with low delay in both low and medium bit rate applications.
Internet Low Bit Rate Provides audio quality between G.711 and G.729 at bit rates of 15.2 and 13.3
Codec (iLBC) kb/s while allowing for graceful speech quality degradation in a lossy network
due to independently encoded speech frames. iLBC is supported for SIP, SCCP,
H323, and MGCP devices.
Note H.323 Outbound FastStart does not support the iLBC codec.
Adaptive Multi-Rate (AMR) The required standard codec for 2.5G/3G wireless networks based on GSM
(WDMA, EDGE, GPRS). This codec encodes narrowband (200-3400 Hz)
signals at variable bit rates ranging from 4.75 to 12.2 kb/s with toll quality
speech starting at 7.4 kb/s. AMR is supported only for SIP devices.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
67
System Components
Cisco Unified CM Groups Overview
Adaptive Multi-Rate Codified as G.722.2, an ITU-T standard speech codec formally known as
Wideband (AMR-WB) Wideband, codes speech at about 16 kb/s. This codec is preferred over other
narrowband speech codecs such as AMR and G.711 because it provides better
speech quality due to a wider speech bandwidth of 50 Hz to 7000 Hz. AMR-WB
is supported only for SIP devices.
Opus Opus codec is an interactive speech and audio codec, specially designed to
handle a wide range of interactive audio applications such as voice over IP,
video conferencing, in-game chat, and live distributed music performance.
This codec scales from narrowband low bit rate to a very high quality bit rate
ranging from 6 to 510 kb/s.
Opus codec support is enabled by default for all SIP devices. You can
reconfigure Opus support via the Opus Codec Enabled service parameter (the
default setting is Enabled for All Devices ). You can reconfigure this parameter
to disable Opus codec support, or to enable support in non-recording devices
only.
Note Opus has a dependency on the G.722 codec. The Advertise G.722
Codec enterprise parameter should also be set to Enabled for SIP
devices to use Opus.
For most systems, you will assign a single Unified Communications Manager to multiple groups to achieve
better load distribution and redundancy.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
68
System Components
Call Processing Redundancy
• Fallback—Occurs when a failed primary Unified Communications Manager comes back into service,
and the devices in that group reregister with the primary Unified Communications Manager.
Under normal operation, the primary Unified Communications Manager in a group controls call processing
for all the registered devices (such as phones and gateways) that are associated with that group.
If the primary Unified Communications Manager fails for any reason, the first backup Unified Communications
Manager in the group takes control of the devices that were registered with the primary Unified Communications
Manager. If you specify a second backup Unified Communications Manager for the group, it takes control
of the devices if both the primary and the first backup Unified Communications Managers fail.
When a failed primary Unified Communications Manager comes back into service, it takes control of the
group again, and the devices in that group automatically reregister with the primary Unified Communications
Manager.
Example
For example, the following figure shows a simple system with three Unified Communications Managers in
a single group that is controlling 800 devices.
Figure 4: Unified Communications Manager Group
The figure depicts Unified Communications Manager group G1 that is assigned with two device pools, DP1
and DP2. Unified Communications Manager 1, as the primary Unified Communications Manager in group
G1, controls all 800 devices in DP1 and DP2 under normal operation. If Unified Communications Manager
1 fails, control of all 800 devices transfers to Unified Communications Manager 2. If Unified Communications
Manager 2 also fails, control of all 800 devices transfers to Unified Communications Manager 3.
The configuration provides call-processing redundancy, but it does not distribute the call-processing load very
well among the three Unified Communications Managers in the example. Refer to the following topic for
information on how to use Unified Communications Manager groups and device pools to provide distributed
call processing within the cluster.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
69
System Components
Distributed Call Processing
The previous figure depicts the Unified Communications Manager groups as they are configured and assigned
to device pools, so Unified Communications Manager 1 serves as the primary controller in two groups, G1
and G2. If Unified Communications Manager 1 fails, the 100 devices in device pool DP1 reregister with
Unified Communications Manager 2, and the 300 devices in DP2 reregister with Unified Communications
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
70
System Components
Device Pool Prerequisites
Manager 3. Similarly, Unified Communications Manager 2 serves as the primary controller of groups G3 and
G4. If Unified Communications Manager 2 fails, the 100 devices in DP3 reregister with Unified
Communications Manager 1, and the 300 devices in DP4 reregister with Unified Communications Manager
3. If Unified Communications Manager 1 and Unified Communications Manager 2 both fail, all devices
reregister with Unified Communications Manager 3.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
71
System Components
Configure the Network Time Protocol
Procedure
Step 2 Configure Region Relationships, on page 78 Complete these tasks to set up Regions for your
system. You can create up to 2000 regions and
configure customized settings, such as
customized audio codec preferences and bitrate
restrictions based on what the region can
provide.
Step 3 Configure Cisco Unified CM Groups, on page Configure Unified Communications Manager
78 groups for call processing redundancy and load
balancing.
Step 4 Configure Device Pools, on page 79 Set up device pools for your system devices.
Apply the other core settings that you
configured to the device pools in order to apply
those settings to the devices that use this device
pool.
Procedure
Step 2 Choose one of these methods to authenticate Optional. For additional security, configure
NTP messages: authenticated NTP. You can configure
authentication via either a symmetric key or via
• Configure NTP Authentication via
autokey. The autokey method is required for
Symmetric Key, on page 73
Common Criteria compliance.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
72
System Components
Add an NTP Server
Step 3 Configure Phone NTP References, on page 74 For SIP phones, it's mandatory that you
configure phone NTP references and then apply
them via a Date/Time Group and Device Pool.
Step 4 Add a Date/Time Group, on page 75 Define time zones for the various devices that
are connected to your system and assign the
Phone NTP references that you've set up to the
appropriate Date/Time Group.
Note For additional information on CLI commands that you can use to troubleshoot and configure NTP such as
the utils ntp* set of commands, refer to the Command Line Interface Reference Guide at
https://www.cisco.com/c/en/us/support/unified-communications/unified-communications-manager-callmanager/
products-maintenance-guides-list.html.
Note You can also add an NTP Server in the NTP Server Configuration window of the Cisco Unified OS
Administration winodw at Settings > NTP Servers.
Procedure
Procedure
Step 1 Log in to the Command Line Interface on the Cisco Unified Communications Manager publisher node.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
73
System Components
Configure NTP Authentication via Autokey
Step 2 Run the utils ntp auth-symmetric key status command to verify the status of the current NTP
authentication setting.
Step 3 Do either of the following:
• To enable NTP authentication with a symmetric key, run the utils ntp auth symmetric-key enable
CLI command.
• To disable NTP authentication with a symmetric key, run the utils ntp auth symmetric-key disable
CLI command.
Step 4 Follow the prompts to enter the key ID and symmetric key of the NTP server.
Note If NTP authentication with a symmetric key is enabled, you must disable it before enabling authentication
with autokey. To disable NTP authentication with a symmetric key, see Configure NTP Authentication via
Symmetric Key, on page 73.
Procedure
Step 4 Enter the number for the NTP server for which you want to enable or disable NTP authentication.
Step 5 If you are enabling authentication, enter the IFF client key. Paste the client key for the NTP server.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
74
System Components
Add a Date/Time Group
Note Unified Communications Manager does not support the multicast and anycast modes. If you choose either of
these modes, your system defaults to the directed broadcast mode.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Phone NTP Reference.
Step 2 Click Add New.
Step 3 Enter the NTP server's IPv4 Address or IPv6 Address, depending on which addressing system your phones
use.
Note It is mandatory to enter either IPv4 address or IPv6 address to save the Phone NTP References. If
you are deploying both IPv4 phones and IPv6 phones, then provide both the IPv4 address and the
IPv6 address for the NTP server.
Step 4 In the Description field, enter a description for the phone NTP reference.
Step 5 From the Mode drop-down list, choose the mode for the phone NTP reference from the following list of
options:
• Unicast—If you choose this mode, the phone sends an NTP query packet to that particular NTP server.
• Directed Broadcast—If you choose this default NTP mode, the phone accesses date/time information
from any NTP server but gives the listed NTP servers (1st = primary, 2nd = secondary) priority.
Note Cisco TelePresence and Cisco Spark device types support Unicast mode only.
What to do next
Assign the Phone NTP Reference(s) to a Date/Time Group. For details, see Add a Date/Time Group, on page
75
Tip For a worldwide distribution of Cisco IP Phones, create a date/time group for each time zones.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
75
System Components
Configure Regions
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Date/Time Group.
Step 2 Click Add New.
Step 3 Assign NTP References to this group:
a) Click Add Phone NTP References.
b) In the Find and List Phone NTP References popup, click Find and select the phone NTP reference(s)
that you configured in the previous task.
c) Click Add Selected.
d) If you added multiple references, use the up and down arrows to changed the prioritized order. The
references at the top have the higher priority.
Step 4 Configure the remaining fields in the Date/Time Group Configuration window. See the online help for
more information about the fields and their configuration options.
Step 5 Click Save.
Configure Regions
Complete the following tasks to configure regions for your device pools. Configure relationships between
regions to better manage bandwidth. You can use Regions to control the maximum bit rates for certain types
of calls (for example, video calls) and to prioritize specific audio codecs.
Procedure
Step 2 Configure Clusterwide Defaults for Regions, Configure the clusterwide defaults for Regions.
on page 77 All Regions will use these default settings
unless you configure otherwise within the
Region Configuration.
Step 3 Configure Region Relationships, on page 78 Set up new regions or edit settings for existing
regions. Configure relationships for both
interregional and intraregional calls.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
76
System Components
Configure Clusterwide Defaults for Regions
Note If you don't need to customize audio codec priorities, you can skip this task. When you configure your device
pools, you can assign one of the default audio codec preference lists.
Procedure
Step 1 From Cisco Unified CM Administration choose System > Region Information > Audio Codec Preference
List.
Step 2 Click Add New.
Step 3 From the Audio Codec Preference Lists drop-down list box, select one of the existing audio codec preference
lists.
The prioritized list of audio codecs displays for the list that you selected.
Step 4 Click Copy. The prioritized list of codecs from the copied list is applied to a newly created list.
Step 5 Edit the Name for your new audio codec list. For example, customizedCodecList.
Step 6 Edit the Description.
Step 7 Use the up and down arrows to move codecs in the prioritized order that appears in the Codecs in List list
box.
Step 8 Click Save.
You must apply the new list to a region and then apply that region to a device pool. All devices in the device
pool will use this audio codec preference list.
Procedure
Step 1 From Cisco Unified CM Administration choose System > Service Parameters.
Step 2 From the Server drop-down list, select a Unified Communications Manager node.
Step 3 From the Service drop-down list, select the Cisco CallManager service.
The Service Parameter Configuration window displays.
Step 4 Under Clusterwide Parameters (System - Location and Region), configure any new service parameter
settings that you want. For service parameter descriptions, click any of the parameter names to view the help
description.
Step 5 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
77
System Components
Configure Region Relationships
Note For enhanced scalability, and to ensure that the system uses fewer resources, we recommend that you use the
default values from the Service Parameters Configuration window wherever possible.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Region Information > Regions.
Step 2 Do either of the following:
• Click Find and select a region.
• Click Add New ro create a new region.
• Enter a Name for the Region. For example, NewYork.
• Click Save.
The read-only Region Relationships area displays any customized settings that you've set up between the
selected region and another region.
Step 3 To modify the settings between this region and another region (or the same region for intraregional calls),
edit the settings in the Modify Relationships to other Regions area:
a) In the Regions area, highlight the other region (for intraregional calls, highlight the same region that you
are configuring).
b) Edit the settings in the adjacent fields. For help with the fields and their settings, see the online help.
c) Click Save.
The new settings now display as a custom rule in the Region Relationships area.
Note If you edit a region relationship within one region there is no need to duplicate that configuration
in the other region as the settings will update in the other region automatically. For example, let's
say that you open Region 1 in the Region Configuration window and configure a custom relationship
to Region 2. If you were to then open Region 2, you would see the custom relationship displayed
in the Region Relationships area
Tip Set up multiple groups and device pools where the primary server is different in each group so as to provide
distributed call processing where device registrations are balanced evenly across the cluster nodes.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
78
System Components
Configure Device Pools
Note Do not use the default server group because it is not descriptive and can cause confusion.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Cisco Unified CM Group.
Step 2 Enter a Name for the group.
Note Consider identifying the order of the nodes in the name so that you can easily distinguish the group
from others. For example, CUCM_PUB-SUB.
Step 3 Check the Auto-registration Cisco Unified Communications Manager Group check box if you want this
Unified Communications Manager group to be the default Unified Communications Manager group when
auto-registration is enabled.
Step 4 From the Available Cisco Unified Communications Managers list, choose the nodes that you want to add
to this group, and click the down arrow to select them. You can add up to three servers to a group.
The servers in this group appear in the Selected Cisco Unified Communications Managers list box. The
top server in the list is the primary server
Step 5 Use the arrows beside the Selected Cisco Unified Communications Managers list box to change which
servers are the primary, and backup servers.
Step 6 Click Save.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Device Pool.
Step 2 Do either of the following:
• Click Add New to create a new device pool.
• Click Find and select an existing device pool.
Step 3 In the Device Pool Name field, enter a name for the device pool.
Step 4 From the Cisco Unified Communications Manager Group drop-down, select the group that you set up to
handle call processing redundancy and load balancing.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
79
System Components
Basic Device Pool Configuration Fields
Step 5 From the Date/Time Group drop-down, select the group that you set up to handle date, time, and phone NTP
references for the devices that use this device pool.
Step 6 From the Region drop-down list box, select the region that you want to apply to this device pool.
Step 7 From the Media Resource Group List drop-down, select a list that contains the media resources that you
want to apply to this device pool.
Step 8 Apply SRST settings for this device pool:
a) From the SRST Reference drop-down, assign an SRST reference.
b) Assign a value for the Connection Monitor Duration field. This This setting defines the time that the
phone monitors its connection to Unified Communications Manager before it unregisterring from SRST
and reregisterring to Unified Communications Manager.
Step 9 Complete the remaining fields in the Device Pool Configuration window. For help with the fields and their
settings, see the online help.
Step 10 Click Save.
What to do next
Configure multiple device pools according to your deployment requirements.
Field Description
Device Pool Name Enter the name of the new device pool. You can enter up to 50 characters, which
include alphanumeric characters, periods (.), hyphens (-), underscores (_), and
blank spaces.
Cisco Unified Choose the Cisco Unified Communications Manager group to assign to devices
Communications Manager in this device pool. A Cisco Unified Communications Manager group specifies
Group a prioritized list of up to three Unified Communications Manager nodes. The first
node in the list serves as the primary node for that group, and the other members
of the group serve as backup nodes for redundancy.
Date/Time Group Choose the date/time group to assign to devices in this device pool. The date/time
group specifies the time zone and the display formats for date and time.
Region Choose the region to assign to devices in this device pool. The region settings
specify voice and video codecs that can be used for communications within a
region and between other regions.
Call Preservation
The call preservation feature of Unified Communications Manager ensures that an active call does not get
interrupted when a Unified Communications Manager fails or when communication fails between the device
and the Unified Communications Manager that set up the call.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
80
System Components
Call Preservation Scenarios
Unified Communications Manager supports full call preservation for an extended set of Cisco Unified
Communications devices. This support includes call preservation between Cisco Unified IP Phones, Media
Gateway Control Protocol (MGCP) gateways that support Foreign Exchange Office (FXO) (non-loop-start
trunks) and Foreign Exchange Station (FXS) interfaces, and, to a lesser extent, conference bridge, MTP, and
transcoding resource devices.
Enable H.323 call preservation by setting the advanced service parameter, Allow Peer to Preserve H.323
Calls, to True.
The following devices and applications support call preservation. If both parties connect through one of the
following devices, Unified Communications Manager maintains call preservation:
• Cisco Unified IP Phones
• SIP trunks
• Software conference bridge
• Software MTP
• Hardware conference bridge (Cisco Catalyst 6000 8 Port Voice E1/T1 and Services Module, Cisco
Catalyst 4000 Access Gateway Module)
• Transcoder (Cisco Catalyst 6000 8 Port Voice E1/T1 and Services Module, Cisco Catalyst 4000 Access
Gateway Module)
• Non-IOS MGCP gateways (Catalyst 6000 24 Port FXS Analog Interface Module, Cisco DT24+, Cisco
DE30+, Cisco VG200)
• Cisco IOS H.323 gateways (such as Cisco 2800 series, Cisco 3800 series)
• Cisco IOS MGCP Gateways (Cisco VG200, Catalyst 4000 Access Gateway Module, Cisco 2620, Cisco
3620, Cisco 3640, Cisco 3660, Cisco 3810)
• Cisco VG248 Analog Phone Gateway
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
81
System Components
Call Preservation Scenarios
Communication failure occurs between Unified When communication fails between a device and the
Communications Manager and device. Unified Communications Manager that controls it,
the device recognizes the failure and maintains active
connections. The Unified Communications Manager
recognizes the communication failure and clears
call-processing entities that are associated with calls
in the device where communication was lost.
The Unified Communications Managers still maintain
control of the surviving devices that are associated
with the affected calls. Unified Communications
Manager maintains affected active calls until the end
user hangs up or until the devices can determine that
the media connection has been released. Users cannot
invoke any call-processing features for calls that are
maintained as a result of this failure.
Note In case of a failover, when you bring up
the Unified CM node within the KeepAlive
timer, the phone remains registered to the
current node even though the call is in
preservation mode. This is possible as
KeepAliver time is active.
Device failure When a device fails, the connections that exist through
the device stop streaming media. The active Unified
(Phone, gateway, conference bridge, transcoder, MTP)
Communications Manager recognizes the device
failure and clears call-processing entities that are
associated with calls in the failed device.
The Unified Communications Manager maintain
control of the surviving devices that are associated
with the affected calls. Unified Communications
Manager maintains the active connections (calls) that
are associated with the surviving devices until the
surviving end users hang up or until the surviving
devices can determine that the media connection has
been released.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
82
CHAPTER 9
Configure Trunks
• SIP Trunk Overview, on page 83
• SIP Trunk Prerequisites, on page 83
• SIP Trunk Configuration Task Flow, on page 84
• SIP Trunk Interactions and Restrictions, on page 86
• H.323 Trunk Overview, on page 87
• H.323 Trunk Prerequisites, on page 88
• Configure H.323 Trunks, on page 88
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
83
System Components
SIP Trunk Configuration Task Flow
you can create your own script. For details on creating customized SIP Normalization and Transparency
scripts, see the Feature Configuration Guide for Cisco Unified Communications Manager.
Procedure
Step 2 Configure SIP Trunk Security Profile, on page Configure a security profile with security
85 settings such as TLS signaling or digest
authentication.
Step 3 Configure SIP Trunks, on page 85 Set up a SIP trunk and apply the SIP Profile and
security profile to the trunk.
Procedure
Step 1 From Cisco Unified CM Administration, choose Device > Device Settings > SIP Profile.
Step 2 Perform one of the following steps:
• Click Find and select the SIP profile to edit an existing profile, .
• Click Add New to create a new profile.
Step 3 If you want your SIP phones and trunks to support IPv4 and IPv6 stacks, check the Enable ANAT check box.
Step 4 If you want to assign an SDP transparency profile to resolve SDP interoperability, from the SDP Transparency
Profile drop-down list.
Step 5 If you want to assign a normalization or transparency script to resolve SIP interoperability issues, from the
Normalization Script drop-down list, select the script.
Step 6 (Optional) Check the Send ILS Learned Destination Route String check box for Global Dial Plan Replication
deployments where you may need to route calls across a Cisco Unified Border Element.
Step 7 Complete the remaining fields in the SIP Profile Configuration window. For more information on the fields
and their configuration options, see Online Help.
Step 8 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
84
System Components
Configure SIP Trunk Security Profile
Note If you don't assign a SIP trunk security profile to your SIP trunks, Cisco Unified Communications Manager
assigns a nonsecure profile by default.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Security > SIP Trunk Security Profile.
Step 2 Click Add New.
Step 3 To enable SIP signaling encryption with TLS, perform the following:
a) From the Device Security Mode drop-down list, select Encrypted.
b) From the Incoming Transport Type and Outgoing Transport Type drop-down lists, choose TLS.
c) For device authentication, in the X.509 Subject Name field, enter the subject name of the X.509 certificate.
d) In the Incoming Port field, enter the port on which you want to receive TLS requests. The default for
TLS is 5061.
Step 4 To enable digest authentication, do the following
a) Check the Enable Digest Authentication check box
b) Enter a Nonce Validity Timer value to indicate the number of seconds that must pass before the system
generates a new nonce. The default is 600 (10 minutes).
c) To enable digest authentication for applications, check the Enable Application Level Authorization
check box.
Step 5 Complete the additional fields in the SIP Trunk Security Profile Configuration window.For more information
on the fields and their configuration options, see Online Help.
Step 6 Click Save.
Note You must assign the profile to a trunk in the Trunk Configuration window so that the trunk can
uses the settings.
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
85
System Components
SIP Trunk Interactions and Restrictions
Step 4 From the Protocol Type drop-down list, choose the type of SIP trunk that matches your deployment and click
Next:
• None (Default)
• Call Control Discovery
• Extension Mobility Cross Cluster
• Cisco Intercompany Media Engine
• IP Multimedia System Service Control
Step 5 (Optional) If you want to apply a Common Device Configuration to this trunk, select the configuration from
the drop-down list.
Step 6 Check the SRTP Allowed check box if you want to allow encypted media over the trunk.
Step 7 Check the Run on All Active Unified CM Nodes check box if you want to enable the trunk for all cluster
nodes.
Step 8 Configure the destination address for the SIP trunk:
a) In the Destination Address text box, enter an IPv4 address, fully qualified domain name, or DNS SRV
record for the server or endpoint that you want to connect to the trunk.
b) If the trunk is a dual stack trunk, in the Destination Address IPv6 text box, enter an IPv6 address, fully
qualified domain name, or DNS SRV record for the server or endpoint that you want to connect to the
trunk.
c) If the destination is a DNS SRV record, check the Destination Address is an SRV check box.
d) To add additional destinations, click the (+).
Step 9 From the SIP Trunk Security Profile drop-down, assign a security profile. If you don't select this option, a
nonsecure profile will be assigned.
Step 10 From the SIP Profile drop-down list, assign a SIP profile.
Step 11 (Optional) If you want to assign a normalization script to this SIP trunk, from the Normalization Script
drop-down list, select the script that you want to assign.
Step 12 Configure any additional fields in the Trunk Configuration window. For more information on the fields and
their configuration options, see Online Help.
Step 13 Click Save.
Multiple Secure SIP As of Release 12.5(1), Cisco Unified Communications Manager supports the
Trunks to Same configuration of multiple secure SIP trunks to the same Destination IP Address
Destination and Destination Port Number. This capability provides the following benefits:
• Bandwidth optimization—Provides a route for emergency calls with
unrestricted bandwidth
• Selective routing based on a particular region or calling search space
configuration
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
86
System Components
H.323 Trunk Overview
Feature Description
Presentation Sharing If you are deploying Presentation Sharing for Cisco endpoints, make sure that
using BFCP the Allow Presentation Sharing with BFCP check box is checked in the SIP
Profile of all intermediate SIP trunks.
Note For third-party SIP endpoints, you must also make sure the same check
box is checked within the Phone Configuration window.
iX Channel If you are deploying iX Media Channel, make sure that the Allow iX Application
Media check box is checked in the SIP Profiles that are used by all intermediate
SIP trunks.
Note For information on encrypted iX Channel, refer to the Security Guide
for Cisco Unified Communications Manager.
90-day Evaluation You cannot deploy a secure SIP trunk while running with a 90-day evaluation
License period. To deploy a secure SIP trunk, your system must have registered to a Smart
Software Manager account with the Allow export-controlled functionality
product registration token selected.
Intercluster Trunks
When configuring intercluster trunk connections between two remote clusters, you must configure an intercluster
trunk on each cluster and match the trunk configurations so that the destination addresses used by one trunk
match the call processing nodes that are used by the trunk from the remote cluster. For example:
• Remote cluster trunk uses Run on all Active Nodes—The remote cluster trunk uses all nodes for call
processing and load balancing. In the local intercluster trunk that originates in the local cluster, add in
the IP addresses or hostnames for each server in the remote cluster.
• Remote cluster does not use Run on all Active Nodes—The remote cluster trunk uses the servers from
the Unified Communications Manager Group that is assigned to the trunk's device pool for call processing
and load balancing. In the local intercluster trunk configuration, you must add the IP address or hostname
of each node from the Unified Communications Manager group used by the remote cluster trunk's device
pool.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
87
System Components
H.323 Trunk Prerequisites
Secure Trunks
To configure secure signaling for H.323 trunks, you must configure IPSec on the trunk. For details, see the
Security Guide for Cisco Unified Communications Manager. To configure the trunk to allow media encryption,
check the SRTP allowed check box in the Trunk Configuration window.
Note Gatekeepers are no longer widely used, but you can also configure your H.323 deployment to use
gatekeeper-controlled trunks. For details on how to set up gatekeeper-controlled trunks, refer to Cisco Unified
Communications Manager Administration Guide, Release 10.0(1).
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
88
CHAPTER 10
Configure Gateways
• Gateway Overview, on page 89
• Gateway Setup Prerequisites, on page 90
• Gateway Configuration Task Flow, on page 90
Gateway Overview
Cisco offers a wide variety of voice and video gateways. A gateway provides interfaces that allow the Unified
Communications network to communicate with an external network. Traditionally, gateways have been used
to connect the IP-based Unified Communications network to legacy telephone interfaces such as the PSTN,
a private branch exchange (PBX), or legacy devices such as an analog phone or fax machine. In its simplest
form, a voice gateway has an IP interface and a legacy telephony interface, and the gateway translates messages
between the two networks so that the two networks can communicate.
Gateway Protocols
Most Cisco gateways offer multiple deployment options and can be deployed using any one of a number of
protocols. Depending on the gateway that you want to deploy, your gateway may be configurable using any
of the following communication protocols:
• Media Gateway Control Protocol (MGCP)
• Skinny Call Control Policy (SCCP)
• Session Initiation Protocol (SIP)
• H.323
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
89
System Components
Gateway Setup Prerequisites
For details, refer to the hardware and software documentation that comes with your gateway.
Note To get to the default web pages for many gateway devices, you can use the IP address of that gateway. Make
your hyperlink url = http://x.x.x.x/, where x.x.x.x is the dot-form IP address of the device. The web page for
each gateway contains device information and the real-time status of the gateway.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
90
System Components
Configure MGCP Gateway
Procedure
Step 2 Configure Clusterwide Call Classification for Optional. Configure a clusterwide service
Gateway, on page 104 parameter to classify all calls coming from the
gateway ports in your network to be internal
(OnNet) or external (OffNet).
Step 3 Block OffNet Gateway Transfers, on page 104 Optional. Block Unified Communications
Manager from transferring calls from one
external (OffNet) gateway to another external
gateway, configure the Block OffNet to Offnet
Transfer service parameter.
Procedure
Step 2 Configure Gateway Port Interface, on page 92 Configure the gateway port interface for the
devices that connect to the VICs that are
installed on the gateway. Most VICs include
multiple port connections and options so you
may have to configure a few different port
interface types.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
91
System Components
Configure MGCP (IOS) Gateway
Step 3 Add Digital Access T1 Ports for MGCP Optional. If you have configured a digital
Gateway, on page 96 access T1 CAS port interface, add T1 CAS ports
to the gateway. You can add ports on an
individual basis or add a range of ports
simultaneously.
Step 4 Reset Gateway, on page 97 The configuration changes take effect after you
reset the gateway.
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
92
System Components
Configure Digital Access PRI Ports
Select any of the following tasks, depending on the type of interface that you want to configure:
• Configure Digital Access PRI Ports, on page 93
• Configure Digital Access T1 Ports for MGCP Gateway, on page 93
• Configure FXS Ports, on page 94
• Configure FXO Ports, on page 95
• Configure BRI Ports, on page 96
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
93
System Components
Configure FXS Ports
Procedure
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
94
System Components
Configure FXO Ports
For more information on the fields and their configuration options, see the system Online Help.
Note Unified Communications Manager assumes all loop-start trunks lack the positive disconnect supervision.
Configure trunks with the positive disconnect supervision as ground start, so that the active calls can be
maintained during a server failover.
Procedure
Step 5 From the Device Pool drop-down list, select a device pool.
Step 6 In the Attendant DN text box, enter the directory number to which you want to route all incoming calls from
this port connection. For example, a zero or the directory number for an attendant.
Step 7 Complete any remaining fields in the Port Configuration window. Refer to the online help for field
descriptions.
Step 8 Click Save.
Step 9 (Optional) To configure more port interfaces on the MGCP IOS gateway, from the Related Links drop-down
list, select Back to Gateway and click Go.
The Gateway Configuration window displays the available ports for the gateway.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
95
System Components
Configure BRI Ports
When you have completed configuring more ports interfaces, see Reset Gateway, on page 97.
Procedure
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
96
System Components
Reset Gateway
Step 4 From the Port Type drop-down list, select the type of port that you want to add and click Next.
Step 5 Enter port numbers in the Beginning Port Number and Ending Port Number fields to specify the range of
ports that you want to add and configure.
For example, enter 1 and 10 to add ports 1 through 10 to the port interface simultaneously.
Step 6 From the Port Direction drop-down list, configure the direction of calls passing through this port:
• Bothways—Select this option if the port allows both inbound and outbound calls.
• Inbound—Select this option if the port allows inbound calls only.
• Outbound—Select this option if the port allows outbound calls only.
Step 7 For EANDM ports, from the Calling Party Selection drop-down list, choose how you want the calling number
to display for outbound calls from the device that is attached to this port:
• Originator—Send the directory number of the calling device.
• First Redirect Number—Send the directory number of the redirecting device.
• Last Redirect Number—Send the directory number of the last device to redirect the call.
• First Redirect Number (External)—Send the directory number of the first redirecting device with an
external phone mask applied.
• Last Redirect Number (External)—Send the directory number of the last redirecting device with the
external phone mask applied.
Reset Gateway
Most gateways need to be reset for configuration changes to take effect. We recommend that you complete
all necessary gateway configuration before performing a reset.
Note Resetting an H.323 gateway only reinitializes the configuration that Unified Communications Manager loaded
and does not physically restart or reset the gateway.
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
97
System Components
Configure SCCP Gateway
Step 3 Click the check box beside the gateway that you want to reset and click Reset Selected. The Device Reset
dialog box appears. Do one of the following actions:
Step 4 Click Reset.
Procedure
Step 3 Enable Auto Registration for Analog Phones, Enables auto registration for the specified ports
on page 99 to fetch the DN from the pool of
auto-registration DNs.
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
98
System Components
Enable Auto Registration for Analog Phones
Note Supported gateway types are VG310, VG350, VG400, VG450, and ISR4K series.
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
99
System Components
Enable Autoregistration of Nonconfigured Analog FXS Ports
Note The MAC address of the gateway can either be the Ethernet MAC address or the Virtual MAC
address assigned in the SCCP gateway's interface, communicating to the Unified Communications
Manager.
When you provide the MAC address, each FXS port obtains the port name from the configured
MAC address and its port number. The corresponding analog phones automatically register
with this gateway.
For example, if NM-4VWIC-MBRD is selected in Module in Slot 0 drop-down list and
VIC3-4FXS/DID-SCCP is selected in the Subunit 0 drop-down list, 4 FXS port values are
displayed namely 0/0/0, 0/0/1, 0/0/2, 0/0/3. Click each port to view the corresponding port name
in the Description field of Phone Configuration window. The displayed port name is the
combination of MAC address and the port value.
The gateway uses the Virtual MAC address or Ethernet MAC address to communicate with the
Unified Communication Manager based on the configuration. The Virtual MAC address can
be used even when you replace the damaged gateway so that you do not need to perform any
configuration changes in the Unified Communication Manager application.
b) Select the required Cisco Unified Communications Manager Group from the drop-down list to enable
autoregistration.
Step 6 In the Configured Slots, VICs and Endpoints section, perform the following steps:
a) Select a slot corresponding to the Network Interface Module hardware that is installed on the gateway for
each Module drop-down list and click Save to enable respective Subunits.
b) Select corresponding VICs installed on the gateway for one or more Subunits and click Save.
Note Slot and module indicate which slot and module have FXS ports. It also indicates a number of
FXS ports.
Configure gateways only up to a Subunit level and not up to the port level as it auto-registers
and obtain an auto DNs. For example, when the Subunit is selected to FXS, the corresponding
FXS port selects one of the DN available in the auto-register DN pool and assigns the DN to
the selected ports.
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
100
System Components
Troubleshooting Tips
Step 4 In the Clusterwide Parameters (Device-PRI and MGCP Gateway) section, ensure that the value of Enable
Auto Registration for FXS Ports drop-down list is set to True.
Note Set the value of Enable Auto Registration for FXS Ports to False to disable the auto registration
of nonconfigured Analog FXS ports.
Troubleshooting Tips
Perform the following in Unified Communications Manager to ensure the ports are registered and obtain an
auto DNs.
1. Configure SCCP as Gateway Type.
2. Enable Auto-registration
3. Select an Analog Phone as the Device Type
4. Ensure sufficient DNs are available in the pool to accommodate the number of voice ports.
Procedure
Step 2 Configure SIP Trunk Security Profile., on page Configure a SIP Trunk Security Profile so that
102 trunk uses this to connect to the SIP gateway.
You can configure security settings, such as
device security mode, digest authentication, and
incoming/outgoing transport type settings.
Step 3 Configure SIP Trunk for SIP Gateway, on page Configure a SIP trunk that points to the SIP
102 gateway. Apply the SIP Profile and the SIP
Trunk Security Profile to the SIP trunk.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
101
System Components
Configure SIP Profile
Procedure
Step 1 From Cisco Unified CM Administration, choose Device > Device Settings > SIP Profile.
Step 2 Perform either of the following steps:
• Click Add New to create a new profile.
• Click Find to select an existing SIP profile.
Procedure
Step 1 In Cisco Unified CM Administration, choose System > Security > SIP Trunk Security Profile.
Step 2 Perform either of the following steps:
a) Click Find to select an existing profile.
b) Click Add New to create a new profile.
Step 3 Complete the fields in the SIP Trunk Security Profile Configuration window.
For more information on the fields and their configuration options, see the system Online Help.
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
102
System Components
Configure H.323 Gateway
Note If your deployment includes H.323 gatekeepers, you can also add an H.323 gateway by setting up a
gatekeeper-controlled H.225 trunk. This scenario is not documented in this guide because gatekeeper usage
has been in steady decline recent years. If you want to configure gatekeepers and H.225 gatekeeper-controlled
trunks, refer to the Cisco Unified Communications Manager Administration Guide, Release 10.0(1).
Note When a gateway is registered with Unified Communications Manager, the registeration status may display in
Unified Communications Manager Administration as unknown.
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
103
System Components
Configure Clusterwide Call Classification for Gateway
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Service Parameters.
Step 2 From the Server drop-down list, choose the server on which the Cisco CallManager service is running.
Step 3 From the Service drop-down list, choose Cisco CallManager.
Step 4 Under Clusterwide Parameters (Device - General), configure one of the following values for the Call
Classification service parameter.
• OnNet—Calls from this gateway are classified as originating from inside the company network.
• OffNet—Calls from this gateway are classified as originating from outside the company network.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Service Parameters.
Step 2 From the Server drop-down list, choose the server on which the Cisco CallManager service is running.
Step 3 From the Service drop-down list, choose Cisco CallManager.
Step 4 Configure a setting for the Block OffNet to Offnet Transfer service parameter:
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
104
System Components
Block OffNet Gateway Transfers
• True—Select this option to cancel transfers between two external (OffNet) gateways.
• False—Select this option to allow transfers between two external (OffNet) gateways. This is the default
option.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
105
System Components
Block OffNet Gateway Transfers
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
106
CHAPTER 11
Configure SRST
• Survivable Remote Site Telephony Overview, on page 107
• Survivable Remote Site Telephony Configuration Task Flow, on page 108
• SRST Restrictions, on page 111
When phones at the remote site lose connectivity to all associatedUnified Communications Manager nodes,
the phones connect to the SRST reference IP gateway. The status line indication on the IP phone shows the
phone has failed over to the backup SRST gateway. When the connection toUnified Communications Manager
is restored, the IP phones reregister withUnified Communications Manager and full telephony services are
restored.
SRST supports remote sites that may have a mix of SCCP and SIP endpoints in addition to PSTN gateway
access.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
107
System Components
Survivable Remote Site Telephony Configuration Task Flow
Communications Manager. The IP phone receives the connection monitor duration value in the XML
configuration file.
Procedure
Step 4 Enable SRST on the SRST Gateway, on page Configure SRST parameters on the gateway.
110
Procedure
Step 1 Log into Cisco Unified CM Administration and choose System > SRST.
Step 2 Click Add New.
Step 3 Configure the fields in the SRST Reference Configuration window. For more information on the fields and
their configuration options, see the system Online Help.
Step 4 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
108
System Components
Assign the SRST Reference to a Device Pool
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Device Pool.
Step 2 Click Find and choose the device pool to which the remote IP phones are registered.
Step 3 In the Roaming Sensitive Settings area, choose the SRST reference from the SRST Reference drop-down
list.
The SRST Reference drop-down list contains the following options:
• Disable—If a phone cannot reach any Cisco Unified Communications Manager node, it does not try to
connect to an SRST gateway.
• Use Default Gateway—If a phone cannot reach any Cisco Unified Communications Manager node, it
tries to connect to its IP gateway as an SRST gateway.
• User-Defined—If a phone cannot reach any Cisco Unified Communications Manager node, it tries to
connect to this SRST gateway.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Enterprise Parameters.
Step 2 Enter a value in the Connection Monitor Duration field. The default value is 120 seconds. The maximum
number of seconds that you can enter in the field is 2592000.
Step 3 Click Save.
Note You must restart all services for the change to take effect.
The enterprise parameter forms the cluster default for the Connection Monitor Duration. However,
if an overriding configuration exists within a device pool, that setting overrides the enterprise
parameter setting for the devices that use the device pool.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
109
System Components
Configure Connection Monitor Duration for a Device Pool
Tip When you change the value of the connection monitor duration for a device pool, it applies only to the device
pool that is being updated. All other device pools use the value in their own Connection Monitor Duration
fields or use the cluster-wide value that is configured in the Connection Monitor Duration enterprise parameter.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Device Pool.
Step 2 Click Find and choose the device pool to which the remote IP phones are registered.
Step 3 In the Roaming Sensitive Settings area, enter a value in the Connection Monitor Duration field. The maximum
number of seconds that you can enter in the field is 2592000.
Note This setting overrides the enterprise parameter setting for connection monitor duration.
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
110
System Components
SRST Restrictions
Step 5 Enter the command ip source-address ip-address where ip-address is a preexisting router IP address, typically
one of the addresses of the Ethernet port of the router.
This command enables the SRST router to receive messages from Cisco IP Phones through the specified IP
address.
SRST Restrictions
Restriction Description
Deleting SRST You cannot delete SRST references that device pools or other items are using.
References To find out which device pools are using the SRST reference, click the
Dependency Records link from the SRST Reference Configuration window.
If the dependency records are not enabled for the system, the dependency records
summary window displays a message. If you try to delete an SRST reference that
is in use, Unified Communications Manager displays an error message. Before
you delete an SRST reference that is currently in use, perform either or both of
the following tasks:
• Assign a different SRST reference to any device pools that are using the
SRST reference that you want to delete.
• Delete the device pools that are using the SRST reference that you want to
delete.
Note Before you delete an SRST reference, check carefully to ensure that
you are deleting the correct SRST reference. You cannot retrieve
deleted SRST references. If an SRST reference is accidentally deleted,
you must rebuild it.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
111
System Components
SRST Restrictions
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
112
CHAPTER 12
Configure Media Resources
• About Media Resources, on page 113
• Media Resources Configuration Task Flow, on page 125
You can make media resources available to calls by assigning them to a media resource group list, and then
assigning that list to a device pool, or to an individual device. The default setting for individual devices is to
use the media resources that are assigned to the device pool that the device is using.
Note For information on configuring Music On Hold, refer to the Feature Configuration Guide for Cisco Unified
Communications Manager.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
113
System Components
Media Termination Points
MTP Types
Cisco Unified Communications Manager supports the following MTP types:
• Software MTPs in IOS gateways
• Hardware MTPs in IOS gateways
• Software MTP provided by the Cisco IP Voice Media Streaming service
The Cisco Media Termination Point Software MTP type provides a default of 48 MTP (user configurable)
resources, depending on the speed of the network and the network interface card (NIC). For example, a
100-MB Network/NIC card can support 48 MTP resources, while a 10-MB NIC card cannot.
For a 10-MB Network/NIC card, approximately 24 MTP resources can be provided. However, the exact
number of MTP resources that are available depends on the resources that other applications on that PC are
consuming, the speed of the processor, network loading, and various other factors.
MTP Registration
An MTP device always registers with its primary Unified Communications Manager if that Unified
Communications Manager is available and informs the Unified Communications Manager about the number
of MTP resources it supports. You can register multiple MTPs with the same Unified Communications
Manager. When more than one MTP is registered with a Unified Communications Manager, that Cisco Unified
Communications Manager controls the set of resources for each MTP.
For example, consider MTP server 1 as configured for 48 MTP resources, and the MTP server 2 as configured
for 24 resources. If both MTPs register with the same Unified Communications Manager, that Unified
Communications Manager maintains both sets of resources for a total of 72 registered MTP resources.
When Unified Communications Manager determines that a call endpoint requires an MTP, it allocates an
MTP resource from the MTP that has the least active streams. That MTP resource gets inserted into the call
on behalf of the endpoint. MTP resource use remains invisible to both the users of the system and to the
endpoint on whose behalf it was inserted. If an MTP resource is not available when it is needed, the call
connects without using an MTP resource, and that call does not have supplementary services.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
114
System Components
Media Termination Points Interactions and Restrictions
Restriction Description
Cisco IP Voice Streaming You can activate only one Cisco IP Voice Streaming Application per server. To
Application provide more MTP resources, you can activate the Cisco IP Voice Streaming
application on additional networked servers.
Cisco strongly recommends that you do not activate the Cisco IP Voice Streaming
Media Application on a Cisco Unified Communications Manager with a high
call-processing load because it can adversely affect the performance of the Cisco
Unified Communications Manager.
Registering with Cisco Each MTP can register with only one Cisco Unified Communications Manager
Unified Communoications at a time. The system may have multiple MTPs, each of which may be registered
Manager to one Cisco Unified Communications Manager, depending on how your system
is configured.
Failover and Fallback This section describes how MTP devices failover and fallback when the Cisco
Unified Communications Manager to which they are registered becomes
unreachable:
• If the primary Cisco Unified Communications Manager fails, the MTP
attempts to register with the next available Cisco Unified Communications
Manager in the Cisco Unified Communications Manager Group that is
specified for the device pool to which the MTP belongs.
• The MTP device reregisters with the primary Cisco Unified Communications
Manager as soon as it becomes available after a failure and is currently not
in use.
• The system maintains the calls or conferences that were active in call
preservation mode until all parties disconnect. The system does not make
supplementary services available.
• If an MTP attempts to register with a new Cisco Unified Communications
Manager and the register acknowledgment is never received, the MTP
registers with the next Cisco Unified Communications Manager.
The MTP devices unregister and then disconnect after a hard or soft reset. After
the reset completes, the devices reregister with the Cisco Unified Communications
Manager.
Transcoders
A transcoder is a device that performs codec conversion, converting an input stream from one codec into an
output stream that uses a different codec. For example, a transcoder can take a G.711 stream and convert it
to a G.729 stream in real time. When the two endpoints in a call use different voice codecs, Cisco Unified
Communications Manager invokes a transcoder into the media path. The transcoder converts the data streams
between the two incompatible codecs so that communication can occur. The transcoder is invisible to either
the user or the endpoints that are involved in a call.
Transcoder resources is managed by the Media Resource Manager (MRM).
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
115
System Components
Transcoder Types
Note The transcoder supports transcoding between G.711 and all codecs, including G.711, when functioning as a
transcoder and when providing MTP/TRP functionality.
Transcoder Types
Transcoder types in Cisco Unified Communications Manager Administration are listed in the following table.
Note The transcoder supports transcoding between G.711 and all codecs, including G.711, when functioning as a
transcoder and when providing MTP/TRP functionality.
Cisco Media Termination This type, which supports the Cisco Catalyst 4000 WS-X4604-GWY and the
Point Hardware Cisco Catalyst 6000 WS-6608-T1 or WS-6608-E1, provides the following number
of transcoding sessions:
For the Cisco Catalyst 4000 WS-X4604-GWY
• For transcoding to G.711-16 MTP transcoding sessions
Cisco IOS Media This type, which supports the Cisco 2600XM, Cisco 2691, Cisco 3725, Cisco
Termination Point 3745, Cisco 3660, Cisco 3640, Cisco 3620, Cisco 2600, and Cisco VG200
(hardware) gateways, provides the following number of transcoding sessions:
Per NM-HDV
• Transcoding from G.711 to G.729-60
• Transcoding from G.711 to GSM FR/GSM EFR- 45
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
116
System Components
Transcoder Interactions and Restrictions
Per NM-HDV2
This type, which supports Cisco 2600XM, Cisco 2691, Cisco 3725, Cisco 3745,
and Cisco 3660 Access Routers, provides the following number of transcoding
sessions:
• Transcoding for G.711 to G.729a/G.729ab/GSMFR-128
• Transcoding for G.711 to G.729/G.729b/GSM EFR-96
Cisco Media Termination This type provides 64 transcoding sessions per daughter card that is populated:
Point (WS-SVC-CMM) 64 transcoding sessions with one daughter card, 128 transcoding sessions with
two daughter cards, 192 transcoding sessions with three daughter cards, and 256
transcoding sessions with four daughter cards (maximum).
This type provides transcoding between any combination of the following codecs:
• G.711 a-law and G.711 mu-law
• G.729 annex A and annex B
• G.723.1
• GSM (FR)
• GSM (EFR)
Transcoder Deletion You cannot delete a transcoder that is assigned to a media resource group. To
find out which media resource groups are using the transcoder, click Dependency
Records from the Related Links drop-down list box on the Transcoder
Configuration window and click Go. The Dependency Records Summary window
displays information about media resource groups that are using the transcoder.
To find out more information about the media resource group, click the media
resource group, and the Dependency Records Details window displays. If the
dependency records are not enabled for the system, the dependency records
summary window displays a message. If you try to delete a transcoder that is in
use, Cisco Unified Communications Manager displays a message. Before deleting
a transcoder that is currently in use, you must remove the transcoder from the
media resource group(s) to which it is assigned.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
117
System Components
Trusted Relay Point Overview
Transcoder devices will unregister and then disconnect after a hard or soft reset.
After the reset completes, the devices reregister with the primary Cisco Unified
Communications Manager node.
Configuration
Both MTPs and transcoders can be configured to provide TRP functionality by checking the Trusted Relay
Point check box in the Media Termination Point Configuration or Transcoder Configuration window.
You can configure the TRP requirement for individual calls by setting the Use Trusted Relay Point field to
On for the following configuration windows:
• Phone Configuration
• Gateway Configuration
• Voicemail Port Configuration
• Trunk Configuration
• CTI Route Point Configuration
• Common Device Configuration
• Universal Device Template Configuration
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
118
System Components
Trusted Relay Points Interactions and Restrictions
• Various media resource configurations (Annunciator, IVR, MTPs, Transcoders, Conference Bridges,
Music On Hold)
Resource Reservation If RSVP is enabled for the call, Cisco Unified Communications Manager first
Protocol (RSVP) tries to allocate an RSVPAgent that is also labeled as TRP. Otherwise, another
TRP device is inserted between the RSVPAgent and the endpoint.
Transcoder for call If you need a transcoder for the call and need to allocate it on the same side as
the endpoint that needs TRP, Cisco Unified Communications Manager first tries
to allocate a transcoder that is also labeled as TRP. Otherwise, another TRP device
is inserted between the transcoder and the endpoint.
MTP allocation for If you check both the Media Termination Point Required check box and the
endpoint Use Trusted Relay Point check box for an endpoint, Cisco Unified
Communications Manager should allocate an MTP that is also a TRP. If the
administrator fails to allocate such an MTP or TRP, the call status appears.
TRP allocation In most instances, TRP is allocated after users answer the call, so if a call fails
due to failure to allocate the TRP, users may receive fast-busy tone after answering
the call. (The SIP outbound leg with MTP required, or H.323 outbound faststart,
represents an exception.)
TRP Insertion for Cisco Unified Communications Manager must insert a TRP for the endpoint if
endpoint you have checked the Use Trusted Relay Point check box for either the endpoint
or the device pool that is associated with the device. The call may fail if Cisco
Unified Communications Manager fails to allocate a TRP while the Fail Call If
Trusted Relay Point Allocation Fails service parameter is set to True.
Fail Call If TRP Allocation Fails Fail Call If MTP Allocation Fails Unified CM Fails Call?
Service Parameter Service Parameter
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
119
System Components
Annunciator Overview
Fail Call If TRP Allocation Fails Fail Call If MTP Allocation Fails Unified CM Fails Call?
Service Parameter Service Parameter
False False No
MTP Required = Yes Use TRP = Yes Resource Allocation Call Behavior
Status
Annunciator Overview
An annunciator is an SCCP software devices that runs on Cisco Unified Communications Manager and which
allows you to send prerecorded messages and tones to Cisco IP Phones and gateways. The annunciator is
activated on a cluster node by turning on the Cisco IP Voice Media Streaming service on that node. Features
such as MLPP, SIP trunks, IOS gateways, and software conference bridges rely on the annunciator to send
the predefined message to the phone or gateway via a one-way media stream. In addition:
• Both IPv4 and IPV6 are supported. The annunciator is configured automatically in dual mode when the
system's platform is configured for IPv6 and the IPv6 enterprise parameter is enabled.
• SRTP is supported
Annunciator Scalability
By default, an annunciator supports 48 simultaneous media streams. You can add capacity by activating the
annunciator on additional nodes or by changing the default number of annunciator media streams via the Call
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
120
System Components
Default Annunciator Announcements and Tones
Count service parameter. However, it's not recommended to increase this value on a node unless the Cisco
CallManager service is deactivated on that node.
If the annunciator runs on a dedicated subscriber node where the Cisco CallManager service does not run,
the annunciator can support up to 255 simultaneous announcement streams. If the dedicated subscriber node
meets the OVA virtual machine configuration for 10,000 users, the annunciator can support up to 400
simultaneous announcement streams.
Caution We recommend that you do not activate the annunciator on Unified Communications Manager nodes that
have a high call-processing load.
The annunciator is not available to a conference bridge if the media resource group list is assigned directly
to the device that controls the conference.
Each conference supports only one announcement. If the system requests another announcement while the
current announcement is playing, the new announcement preempts the one that is playing.
You cannot change the default prerecorded annunciator announcements or add additional announcements.
Localization of the announcement is supported if the Cisco Unified Communications Manager Locale Installer
is installed and the locale settings are configured for the Cisco Unified IP Phone or device pool. For information
about the Locale Installer and the files to install for user and (combined) network locales, see Installing Cisco
Unified Communications Manager. To download the locale installer, see the support pages at www.cisco.com.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
121
System Components
Interactive Voice Response Overview
Condition Announcement
An equal or higher precedence call is in Precedence access limitation has prevented the completion of your
progress. call. Please hang up and try again. This is a recording.
A precedence access limitation exists. Precedence access limitation has prevented the completion of your
call. Please hang up and try again. This is a recording.
Someone attempted an unauthorized The precedence used is not authorized for your line. Please use an
precedence level. authorized precedence or ask your operator for assistance. This is
a recording.
The call appears busy, or the The number you have dialed is busy and not equipped for call
administrator did not configure the waiting or preemption. Please hang up and try again. This is a
directory number for call waiting or recording.
preemption.
The system cannot complete the call. Your call cannot be completed as dialed. Please consult your
directory and call again or ask your operator for assistance. This is
a recording.
A service interruption occurred. A service disruption has prevented the completion of your call. In
case of emergency call your operator. This is a recording.
The following table lists the tones that the annunciator supports.
Type Description
Busy tone A busy tone is heard when the dialed number is busy.
Barge tone A conference barge-in tone is heard before the participant joins an ad hoc conference.
Ring back tone An alert tone is heard for the following scenarios:
• When you transfer a call over the PSTN through an IOS gateway.
• When you transfer a call over an H.323 intercluster trunk.
• When you transfer a call to the SIP client from an SCCP phone.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
122
System Components
Default IVR Announcements and Tones
An IVR supports 48 simultaneous callers by default. You can change the number of IVR callers using the
Cisco IP Voice Media Streaming Application service parameter. However, we recommend that you do not
exceed 48 IVR callers on a node. You can configure the number of callers for IVR based on expected
simultaneous calls to IVR for joining Conference Now.
Caution Do not activate the IVR device on Cisco Unified Communications Manager nodes that have a high
call-processing load.
Announcement Condition
ConferenceNowAccessCodeFailed Plays when an attendee enters the wrong access code to join Conference
Announcement Now after exceeding the maximum number of attempts.
ConferenceNowCFBFailed Plays when the conference bridge capacity limit is exceeded while
Announcement initiating Conference Now.
ConferenceNowEnterAccessCode Plays when an attendee joins Conference Now and the host sets an
Announcement attendee access code.
ConferenceNowFailedPIN Plays after the host exceeds the maximum number of attempts to enter
Announcement a correct PIN.
ConferenceNowNumberFailed Plays when a host or attendee enters the wrong meeting number after
Announcement exceeding the maximum number of attempts.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
123
System Components
Interactive Voice Response Restrictions
Load Balancing The Interactive Voice Response (IVR) uses Real-Time Protocol (RTP)
streams through a common media device driver. This device driver is
also used by other software media devices provided by the Cisco IP
Voice Media Streaming Application services such as Music On Hold
(MOH), Software Media Termination Point (MTP), Software Conference
Bridge (CFB), and Annunciator.
Configuring a larger call volume affects the system performance. This
also impacts call processing if the Call Manager service is active on the
same server node.
DTMF Digits The IVR supports only Out-Of-Band (OOB) DTMF digit collection
method. If there is a DTMF capability mismatch between the calling
device and the IVR, an MTP will be allocated.
Codecs The IVR only supports codec G.711 (a-law and mu-law), G.729, and
Wide Band 256k. If there is a codec mismatch between the calling device
and the IVR, a transcoder will be allocated.
Announcements Overview
In Cisco Unified Communications Manager Administration, use the Menu Resources > Announcements
menu path to configure announcements. There are two classifications of announcements:
• System Announcements—Pre-defined announcements that are used in normal call processing or provided
as sample feature announcements.
• Feature Announcements—Used by features such as Music on Hold (MOH), Hunt Pilots with Call Queuing
or External Call Control. You can customize your own feature announcements by uploading
Cisco-provided audio files or uploading custom .wav files. Upload all custom announcement .wav
files to all servers in the cluster.
Note You can hear custom announcements such as warning or reorder tones if you are connected through a trunk
or gateway. However, you cannot hear custom announcements on calls between two IP phones or IP phones
and Jabber clients.
Formats
The recommended format for announcements includes the following specifications:
• 16-bit PCM wav file
• Stereo or mono
• Sample rates of 48 kHz, 44.1 kHz, 32 kHz, 16 kHz, or 8 kHz
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
124
System Components
Default Announcements
Default Announcements
You can upload custom announcement .wav files or change the Cisco-provided file for a system announcement.
However, you cannot change the announcement identifier. For example, the System announcement
(VCA_00121) is played when a caller dials an invalid number. This is commonly known as the vacant call
announcement.
Procedure
Step 2 Configure Media Termination Points, on page Configure Media Termination Points (MTPs)
127 for your system.
Step 3 Configure Transcoders, on page 127 Add Transcoder resources to the system.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
125
System Components
Activate Software Media Resources
Step 6 Configure Media Resource Groups, on page Add your media resources into a Media
129 Resource Group. Set up multiple groups with
different combinations of resources.
Step 7 Configure Media Resource Group Lists, on Create a list of Media Resource Groups that
page 129 you can assign to an endpoint, or class of
endpoints.
Step 8 Assign Media Resources to Device or Device Make media resources available to endpoints
Pool, on page 130 by assigning them to a device or device pool.
Step 9 Configure Announcement, on page 130 Optional. Configure settings for specific
announcements. Announcements are used in
normal processing, or for features like Music
On Hold or IVR.
Procedure
Step 1 From Cisco Unified Serviceability, choose Tools > Service Activation.
Step 2 From the Server, select a Unified Communications Manager node.
Step 3 Check the Cisco IP Voice Media Streaming Service and click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
126
System Components
Configure Media Termination Points
Procedure
Step 1 From Cisco Unified CM Administration, choose Media Resources > Media Termination Point.
Step 2 Do either of the following:
• Click Find and select an existing MTP.
• Click Add New to create a new MTP.
Configure Transcoders
A transcoder is a device that converts an input stream from one codec into an output stream that uses a different
codec.
Procedure
Step 1 Log into Cisco Unified CM Administration and choose Media Resources > Transcoder.
Step 2 Do either of the following:
• Click Find and select an existing transcoder.
• Click Add New.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
127
System Components
Configure the Interactive Voice Response (IVR)
Procedure
Step 1 From Cisco Unified CM Administration, choose Media Resources > Interactive Voice Response.
Step 2 Click Find and select the IVR.
Step 3 Enter a Name and Description.
Step 4 If you want IVR calls to use a trusted relay point, set the Use Trusted Relay Point drop-down to On.
Step 5 Complete the remaining fields in the Interactive Voice Response Configuration window. For help with the
fields and their settings, see the online help.
Step 6 Click Save.
Procedure
Step 1 From Cisco Unified CM Administration, choose Media Resources > Annunciator.
Step 2 Click Find and select the annunciator.
Step 3 Enter a Name and Description.
Step 4 Select a Device Pool.
Step 5 If you want the annunciator to use a trusted relay point, set the Use Trusted Relay Point drop-down to On.
Step 6 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
128
System Components
Configure Media Resource Groups
Procedure
Step 1 From Cisco Unified CM Administration, choose Media Resources > Media Resource Group.
Step 2 Do either of the following:
• Click Find and select an existing media resource group.
• Click Add New to create a new media resource group.
Step 3 Configure the fields in the Media Resource Group Configuration window. See the online help about the
fields and their configuration options.
Step 4 Enter a Name and Description for the group.
Step 5 From Available Media Resources, select the resources you want to add to this group, and use the arrows to
move the resources to Selected Media Resources.
Step 6 (Optional) To use multicast for Music On Hold audio, check the Use Multi-cast for MOH Audio check box.
Step 7 Click Save.
Procedure
Step 1 From Cisco Unified CM Administration, choose Media Resources > Media Resource Group List.
Step 2 Do either of the following:
• Click Find and select an existing list.
• Click Add New and create a new list.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
129
System Components
Assign Media Resources to Device or Device Pool
Procedure
Step 1 From the Cisco Unified CM Administration, choose Devices > Phone.
• To add media resources to a device pool, choose System > Device Pools.
• To add media resource directly to an endpoint, choose Device > Phone.
Step 2 Click Find and select the device pool or device to which you want to assign these media resources.
Step 3 From the Media Resource Group List drop-down, select a list.
Step 4 Click Save.
Step 5 Click Apply Config to Selected.
The Apply Configuration window appears showing the device name and the applicable configuration changes.
Configure Announcement
You can configure an announcement that you can use as a system announcement or as a feature announcement.
A system announcement is used for call processing or for the use of sample feature announcements whereas
a feature announcement is used for specific features, such as music on hold (MOH) in association with hunt
pilot call queuing or external call control.
You can modify an existing announcement or configure a new announcement in Cisco Unified Communications
Manager.
Procedure
Step 1 From Cisco Unified CM Administration, choose Media Resources > Announcement.
Step 2 Do one of the following:
• Click Find and select an existing announcement to edit.
• Click Add New to add a new announcment.
Step 3 Configure the fields in the Announcement Configuration window. For more information on the fields and
their configuration options, see the system Online Help.
Step 4 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
130
System Components
Upload a Customized Announcement
Note Announcements are specific to the locale (language). If your installation is using more than one language
locale, you have to record each custom announcement each language as a separate .wav file and upload with
the correct locale assignment. This task also requires that the correct locale package is installed on each server
before uploading custom announcement .wav files for languages other than United States English.
Similar to MOH audio source files, the recommended format for announcements includes the following
specifications:
• 16-bit PCM .wav file
• Stereo or mono
• Sample rates of 48 kHz, 44.1 kHz, 32 kHz, 16 kHz, or 8 kHz
You cannot update announcements that are not hyperlinked in the Find and List Announcements window
in Unified Communications Manager. You can add customized announcements for Cisco-provided
announcements that are underlined with a hyperlink in this window. For example, MLPP-ICA_00120 and
MonitoringWarning_00055.
Procedure
Step 1 From Cisco Unified CM Administration, choose Media Resources > Announcement.
Step 2 From the Find and List Announcements window, enter search criteria, click Find, and click the hyperlink
for the announcement from the resulting list.
Step 3 From the Announcement Configuration window, click Upload File.
Step 4 From the Upload File pop-up window, choose the locale, enter the filename and browse to select the .wav
file, and click Upload File.
The upload process begins and the status is updated after the processing is complete. Select Close to close
the Upload File window.
Step 5 (Optional) If you want Unified Communications Manager to play the customized announcement instead of
playing the Cisco-provided announcement, check the Enable check box appears in the Announcement by
Locale pane in the Announcements Configuration window.
If the Enable check box is unchecked, Unified Communications Manager plays the Cisco-provided
announcement.
What to do next
Upload the announcement on each node in the cluster as the announcement files are not propagated between
servers in a cluster. Browse for Cisco Unified Communications Manager Administration on each server in
the cluster and repeat the upload process.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
131
System Components
Upload a Customized Announcement
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
132
CHAPTER 13
Configure Conference Bridges
• Conference Bridges Overview, on page 133
• Conference Bridge Types, on page 133
• Conference Bridge Configuration Task Flow, on page 138
Note When Cisco Unified Communications Manager server is created, the Conference Bridge Software is also
created automatically and it cannot be deleted. You cannot add Conference Bridge Software to Cisco Unified
Communications Manager Administration.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
133
System Components
Conference Bridge Types
Cisco Conference Bridge This type supports the Cisco Catalyst 4000 and 6000 Voice Gateway Modules
Hardware and the following number of conference sessions:
Cisco Catalyst 6000
• G.711 or G.729a conference - 32 participants per port; six participants
maximum per conference; 256 total participants per module; 10 bridges
with three participants.
• GSM - 24 participants per port; six participants maximum per
conference; 192 total participants per module.
Cisco Conference Bridge Software conference devices support G.711 codecs by default.
Software
The maximum number of callers for this type equals 256. With a setting of 256,
the software conference bridge can support 64 conference sessions of 4 parties
each. The maximum number of caller parties in a conference session is specified
via the Maximum Ad Hoc Conference and Maximum MeetMe Conference
Unicast service parameters.
Caution This type of conference bridge (SW Conference Bridge) is a simplified
implementation. It does not identify parties that are silent and uses a
simple summing algorithm which may cause audio quality and low
volume levels for the conference when there is a large number of
participants.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
134
System Components
Conference Bridge Types
Cisco IOS Enhanced • Uses the onboard Cisco Packet Voice/Fax Digital Signal Processor Modules
Bridges (PVDM2) on the Cisco 2800 and 3800 series voice gateway routers or uses
the NM-HD or NM-HDV2 network modules.
• G.711 a-law/mu-law, G.729, G.729a, G.729b, G.729ab, GSM FR, and GSM
EFR participants can join in a single conference
• Up to eight parties can join in a single call.
Cisco Conference Bridge This conference bridge type supports the Cisco Catalyst 6500 series and Cisco
(WS-SVC-CMM) 7600 series Communication Media Module (CMM).
It supports up to eight parties per conference and up to 64 conferences per port
adapter. This conference bridge type supports the following codecs: This
conference bridge type supports ad hoc conferencing.
• G.711 a-law/mu-law
• G.729 annex A and annex B
• G.723.1
Cisco Video Conference The Cisco Video Conference Bridge provides audio and video conferencing
Bridge (IPVC-35xx) functions for Cisco IP video phones, H.323 endpoints, and audio-only Cisco
Unified IP Phones. The Cisco Video Conference Bridge supports the H.261,
H.263, and H.264 codecs for video.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
135
System Components
Conference Bridge Types
Cisco IOS Heterogeneous Cisco Integrated Services Routers Generation 2 (ISR G2) can act as IOS-based
Video Conference Bridge conference bridges that support ad hoc and meet-me video conferencing. DSP
modules must be installed on the router to enable the router as a conference
bridge.
In a heterogeneous video conference, all the conference participants connect to
the conference bridge with phones that use different video format attributes. In
heterogeneous conferences, transcoding and transsizing features are required
from the DSP to convert the signal between the various formats.
For heterogeneous video conferences, callers connect to the conference as audio
participants under either of the following conditions:
• Insufficient DSP resources.
• The conference bridge is not configured to support the video capabilities of
the phone.
For more detailed information about video conferencing with ISR G2 routers,
refer to the document Configuring Video Conferences and Video Transcoding.
Cisco Guaranteed Audio Cisco Integrated Services Routers Generation 2 (ISR G2) can act as IOS-based
Video Conference Bridge conference bridges that support ad hoc and meet-me voice and video conferencing.
DSP modules must be installed on the router to enable the router as a conference
bridge.
DSP resources are reserved for the audio portion of the conference, and video
service is not guaranteed. Callers on video phones may have video service if DSP
resources are available at the start of the conference. Otherwise, the callers connect
to the conference as audio participants.
For more detailed information about video conferencing with ISR G2 routers,
refer to the document Configuring Video Conferences and Video Transcoding.
Cisco IOS Homogeneous Cisco Integrated Services Routers Generation 2 (ISR G2) can act as IOS-based
Video Conference Bridge conference bridges that support ad hoc and meet-me video conferencing. DSP
modules must be installed on the router to enable the router as a conference
bridge.
Cisco IOS Homogeneous Video Conference Bridge specifies the IOS-based
conference bridge type that supports homogeneous video conferencing. A
homogeneous video conference is a video conference in which all participants
connect using the same video format attributes. All the video phones support the
same video format and the conference bridge sends the same data stream format
to all the video participants.
If the conference bridge is not configured to support the video format of a phone,
the caller on that phone connects to the conference as an audio only participant.
For more detailed information about video conferencing with ISR G2 routers,
refer to the document Configuring Video Conferences and Video Transcoding.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
136
System Components
Conference Bridge Types
Cisco TelePresence MCU Cisco TelePresence MCU is a set of hardware conference bridges for Cisco
Unified Communications Manager.
The Cisco TelePresence MCU is a high-definition (HD) multipoint video
conferencing bridge. It delivers up to 1080p at 30 frames per second, full
continuous presence for all conferences, full transcoding, and is ideal for mixed
HD endpoint environments.
The Cisco TelePresence MCU supports SIP as the signaling call control protocol.
It has a built in Web Server that allows for complete configuration, control, and
monitoring of the system and conferences. The Cisco TelePresence MCU provides
XML management API over HTTP.
Cisco TelePresence MCU allows both ad hoc and meet-me voice and video
conferencing. Each conference bridge can host several simultaneous, multiparty
conferences.
Cisco Unified Communications Manager supports presentation sharing with the
Binary Floor Control Protocol (BFCP) between Unified Communications Manager
and a Cisco TelePresence MCU.
Cisco TelePresence MCU must be configured in Port Reservation mode. For
more information, consult the Cisco TelePresence MCU Configuration Guide.
Note Cisco TelePresence MCU does not support a common out-of-band
DTMF method. Under the default setting, Cisco Unified
Communications Manager will not require a Media Termination Point
(MTP). However, if the Media Termination Point Required check box
is checked, Cisco Unified Communications Manager will allocate an
MTP and the SIP trunk will negotiate DTMF according to RFC 2833.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
137
System Components
Conference Bridge Configuration Task Flow
Cisco Meeting Server The Cisco Meeting Server conference bridge solution allows Ad Hoc, Meet-Me,
Conference Now, and Rendezvous conferences. This conference bridge offers
premises-based audio, video, and web conferencing, and works with third-party
on-premises infrastructure. It scales for small or large deployments. You can add
capacity incrementally as needed, to ensure that you can support the current and
future needs of your organization. This conference bridge provides advanced
interoperability. Any number of participants can create and join meetings from:
• Cisco or third-party room or desktop video systems
• Cisco Jabber Client
• Cisco Meeting App (can be native or with a WebRTC compatible browser)
• Skype for Business
A minimum release of Cisco Meeting Server 2.0 is required to use the Cisco
Meeting Server conference bridge.
The Cisco Meeting Server supports SIP as the signaling call control protocol. It
has a built in Web Server that allows for complete configuration, control, and
monitoring of the system and conferences. The Cisco Meeting Server provides
XML management API over HTTP.
Note Cisco Meeting Server does not support H.265 video codec and Far
End camera Control.
Step 2 Configure Service Parameters for Conference Perform this procedure when your network
Bridges, on page 139 includes both Cisco IOS Conference Bridge and
Cisco IOS Enhanced Conference Bridge.
Step 3 Configure SIP Trunk Connection to Conference Perform this procedure to configure a SIP trunk
Bridge, on page 139 connection to your conference bridge.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
138
System Components
Configure Service Parameters for Conference Bridges
Procedure
Step 1 From Cisco Unified CM Administration, choose Media Resources > Conference Bridge.
Step 2 Click Add New.
Step 3 Configure the fields in the Conference Bridge Configuration window. For detailed field descriptions, refer
to the online help.
Step 4 Click Save.
What to do next
If your network includes both Cisco IOS Conference Bridge and Cisco IOS Enhanced Conference Bridge,
Configure Service Parameters for Conference Bridges, on page 139.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Service Parameters.
Step 2 In the Service Parameter Configuration window, choose a server and choose the Cisco CallManager service.
Step 3 In the Clusterwide Parameters (Features - Conference) section, set the following parameters to 6:
• Maximum Ad Hoc Conference
• Maximum MeetMe Conference Unicast
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
139
System Components
Configure SIP Trunk Connection to Conference Bridge
Step 5 Create an entry for the conference bridge in the Destination area by adding the IP address or hostname for
the conference bridge. If you need a new line, you can click (+) to add it.
Step 6 From the Normalization Script drop-down list box, select a normalization script. For example, the following
scripts are mandatory
• cisco-telepresence-conductor-interop – select this script if you are connecting this trunk to a Cisco
TelePresence Conductor.
• cisco-telepresence-mcu-ts-direct-interop – select this script if you are connecting this trunk to a Cisco
TelePresence MCU.
• cisco-meeting-server-interop – select this script if you are connecting this trunk to a Cisco Meeting
Server.
Step 7 Complete any remaining fields in the Trunk Configuration window. For help with the fields and their settings,
refer to the online help.
Step 8 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
140
CHAPTER 14
Configure Enhanced Locations Call Admission
Control
• Enhanced Locations Call Admission Control Overview, on page 141
• Enhanced Locations CAC Prerequisites, on page 143
• Enhanced Locations CAC Task Flow, on page 143
• Enhanced Locations CAC Interactions Restrictions, on page 147
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
141
System Components
Intercluster LBM Replication
• Bandwidth Allocations—The total bandwidth allocated for a particular type of traffic (audio, desktop
video, immersive video) over a specific link. Bandwidth can also be allocated for intralocation calls (the
default setting is Unlimited).
• Location Bandwidth Manager (LBM)—A feature service that must be activated in Cisco Unified
Serviceability for Enhanced Locations CAC to work. This service assembles the network model and
computes the effective path between locations by adding the weight of all links and locations between
the source and destination, and choosing the path with the least cumulative weight.
Note Do not change the Location Bandwidth Manager bandwidth or link configurations during production hours
as that could unecessarily spike CPU utilization on the server.
Cisco Unified Communications Manger supports up to 2,000 locations and 2,000 regions per cluster.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
142
System Components
Enhanced Locations CAC Prerequisites
Location and Link Use a single cluster to configure and manage bandwidth allocations for all links
Management across the intercluster network. This approach simplifies the configuration
overhead, particularly in deployments with many common locations. The
intercluster configuration approach is as follows:
In the management cluster, configure all locations and links (including bandwidth
allocations and weights) for the entire topology. This information will be replicated
to the intercluster network.
For the other clusters in the topology:
• Configure locations for the local cluster only. This is solely to associate
devices to a location.
• Do not configure link information.
• Leave all bandwidth allocations in the local cluster as Unlimited. If the
management cluster replicates bandwidth allocations that are less than the
local cluster, the more restrictive configuration will be applied.
Note It;s critical for replication to name clusters consistenly across all
clusters.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
143
System Components
Activate Location Bandwidth Manager
Procedure
Step 2 Configure LBM Group, on page 145 By default, the Cisco CallManager service
communicates with the local LBM service.
However, LBM groups can be used to manage
this communication, providing an active and
standby LBM for redundancy.
Step 3 Configure Locations and Links, on page 145 Create the locations (LANs) for your network
and assign bandwidth allocations for the WAN
links that connect those locations.
Step 4 Configure LBM Intercluster Replication Group, Create an intercluster replication group that
on page 146 replicates configured CAC information to other
clusters.
Step 5 Configure SIP Intercluster Trunks, on page 146 Assign the Shadow location to the SIP
intercluster trunks in your network.
Step 6 Configure Call Admission Control Service Optional. Configure service parameter settings
Parameters, on page 147 for Call Admission Control. The default settings
may be sufficient for many deployments.
Procedure
Step 1 From Cisco Unified Serviceability, choose Tools > Service Activation.
Step 2 From the Server drop-down, select the cluster node on which you want the service to run and click Go.
Step 3 Under CM Services, check the Cisco Location Bandwidth Manager service
Step 4 Click Save.
Step 5 Repeat this task if you want to start the service on addiitonal nodes.
Note Cisco recommends running the Cisco Location Bandwidth Manager service on each subscriber
node in the cluster that is also running the Cisco CallManager service.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
144
System Components
Configure LBM Group
Note The order in which the Cisco CallManager service uses the LBM is as follows:
• LBM Group designation
• Local LBM (co-resident)
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Locations > Location Bandwidth Manager
Group.
Step 2 Click Add New.
Step 3 Assign a Name to the group.
Step 4 From the Active Member drop-down, select the active member of this group.
Step 5 From the Standby Member drop-down, select a desired standby to be used when the active member is
unavailable.
Step 6 Click Save.
Procedure
Step 1 From Cisco Unfiied CM Administration, choose System > Location Info > Location.
Step 2 Click Add New to create a new location.
Step 3 Assign a Name for the location.
Step 4 In the Links - Bandwidth Between This Location and Adjacent Locations area, configure settings for
WAN links to a another location:
a) Select a second location from the Location list box.
b) Configure the Weight that reflects the relative priority of this link in forming the effective path.
c) Configure total bandwidth for audio, video, and immersive video (TelePresence) calls.
d) Repeat these substeps to configure links to any additional locations.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
145
System Components
Configure LBM Intercluster Replication Group
Step 5 Optional. Expand the Intra-location - Bandwidth for Devices Within This Location area and configure
total bandwidth allocations for intralocation calls for the newly created location. The default setting for all
media types for these calls is Unlimited.
Step 6 In the Modify Settings to Other Locations area, configure RSVP settings to other locations:
a) In the Location column select the other location.
b) Select the RSVP Setting for calls between these locations.
c) Repeat these substeps to add RSVP settings for calls with additional locations.
Step 7 Click Save.
Step 8 Repeat this procedure to create additional locations and to configure links to and from those new locations.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Location Info > Location Bandwidth Manager
(LBM) Intercluster Replication Group.
Step 2 Click Add New.
Step 3 Enter a Name for the group.
Step 4 In the Bootstrap Servers area, assign one or more LBM servers to be responsible for replicating connectivity
information to other hubs.
Step 5 In the Role Assignments area, use the up and down arrows to select the local LBM servers that will act as
hubs, and the LBM servers that will remain as spokes.
Step 6 Click Save.
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
146
System Components
Configure Call Admission Control Service Parameters
Step 6 Repeat this task for any other intercluster trunks that will replicate information for Enhanced Locations Call
Admission Control.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Service Parameters.
Step 2 From the Server drop-down, select a cluster node.
Step 3 Configure service parameters for the Cisco CallManager service:
a) From the Service drop-down, select Cisco CallManager.
b) In the Clusterwide Parameters (Call Admission Control) area, configure any service parameters. For
parameter help descriptions, click the name of the parameter in the GUI.
c) Click Save.
Step 4 Configure settings for the Cisco Location Bandwidth Manager service:
a) From the Service drop-down, select Cisco Location Bandwidth Manager.
b) Configure any service parameters that you want. For parameter help descriptions, click the name of the
parameter in the GUI.
c) Click Save.
LBM Security Mode By default, the LBM Security Mode is Insecure. You can reconfigure this setting
with the LBM Security Mode enterprise parameter. This parameter can be set
to Secure, Insecure or Mixed.
The Mixed setting can be used temporarily to maintain communication while
you are securing all of your clusters, following which you can change the setting
to Secure.
After changing this parameter, you must reset all Cisco LBM Service Hubs in
the cluster for this to take effect.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
147
System Components
Enhanced Locations CAC Interactions Restrictions
Audio Bandwidth By default, bandwidth for the audio portion of a video call is deducted from the
Deduction in Video Calls video pool. You can reconfigure the system so that the audio portion of a video
call is deducted from the audio pool by setting the Deduct Audio Portion from
Audio Pool for Video Calls service parameter to True (the default setting is
False).
Video Call Classification Cisco TelePresence endpoints have a nonconfigurable video call classification
of Immersive.
Other endpoints have a nonconfigurable video call classification of Desktop.
For SIP trunks, you can set the video classification (Desktop, Immersive or Mixed)
by configuring the Video Call Traffic Class within the associated SIP Profile.
Media Resources Bandwidth for media resources is not allocated via Call Admissions Control.
Locations Serviceability The Cisco Unified Serviceability interface contains additional tools for managing
and monitoring the Locations topology. For details, see the "Locations" topics
in the Cisco Unified Serviceability Administration Guide.
Session Bandwidth You can assign which Session Bandwidth Modifiers are used by SIP endpoints
Modifiers within the SIP Profile Configuration window.
Bandwidth Allocation If there is a conflict in bandwidth capacity or weight assignment on the common
Conflicts links or locations, the local cluster uses the minimum of the assigned values.
Device Support Your system and LBM manage bandwidth for all types of devices, including IP
phones, gateways, and H.323 and SIP trunk destinations. However, intercluster
enhanced locations CAC requires SIP ICTs assigned to the system shadow
location. All other types of devices are supported only when assigned to ordinary
(fixed) locations.
Network Failures During network failure conditions, the bandwidth reservation path calculated by
Unified Communications Manager might not accurately reflect network conditions.
There is no satisfactory way to allow for this scenario in the model.
Synchronization Issues The model created by the system is not perfectly synchronized at all times. Use
conservative bandwidth allocations to accommodate this restriction.
Clustering over the WAN For deployments with clustering over the WAN and local failover, intracluster
LBM traffic is already calculated into the WAN bandwidth calculations.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
148
System Components
Enhanced Locations CAC Interactions Restrictions
Flexible DSCP Marking For additional QoS, you can use DSCP marking to assign markings that prioritize
certain types of call flows over others. For example, you can prioritize audio over
video so that even if the network is congested, blocking video media, basic
communication can continue via audio.
You can configure DSCP marking in two ways:
• Service Parameters—Configure clusterwide DSCP defaults within the
Service Parameter Configuration window's Clusterwide Parameters
(System - QoS) section.
• SIP Profile—Configure customized DSCP settings in a SIP Profile and apply
them to certain groups of SIP devices. This setting overrides the clusterwide
default.
APIC-EM Controller You can use an APIC_EM Controller to manage SIP media flows for external
QoS management. For details, refer to the Feature Configuration Guide for Cisco
Unified Communications Manager.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
149
System Components
Enhanced Locations CAC Interactions Restrictions
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
150
CHAPTER 15
Configure Resource Reservation Protocol
• RSVP Call Admission Control Overview, on page 151
• RSVP Call Admission Control Prerequisites, on page 151
• RSVP Configuration Task Flow, on page 151
Step 2 Configure Location-pair RSVP Policy, on page Optional. You can configure the RSVP policy
153 for a specific location pair if you want the
location pair to use a different policy than the
rest of the cluster.
Step 3 Configure RSVP Retry, on page 154 Configure the frequency and number of RSVP
retries.
Step 4 Configure Midcall RSVP Error Handling, on Configure how the system responds when RSVP
page 154 fails during a call.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
151
System Components
Configure Clusterwide Default RSVP Policy
Step 6 Configure RSVP agents. Perform this IOS procedure on your gateway
device. See the documentation for device for
information about how to configure an RSVP
agent.
Step 7 Configure the Application ID, on page 156 When you configure the RSVP application ID,
the system adds an identifier to both the voice
and video traffic so that the Cisco RSVP Agent
can set a separate bandwidth limit on either type
of traffic, based on the identifier it receives.
Step 8 Configure DSCP Marking, on page 156 Configure DSCP marking so that if the RSVP
reservation fails, the system can instruct the
RSVP agent or endpoint devices to change
media Differentiated Services Control Point
(DSCP) marking to best effort. Otherwise, an
excess of EF-marked media packets can degrade
quality of service (QoS) even for flows that
have a reservation.
Procedure
Step 1 In Cisco Unified Communications Manager Administration, choose System > Service Parameters.
Step 2 In the Service Parameter Configuration window, choose a server and choose the Cisco CallManager service.
Step 3 In the Clusterwide Parameters (System - RSVP) section, configure the Default Interlocation RSVP Policy
service parameter.
You can set this service parameter to the following values:
• No Reservation-No RSVP reservations get made between any two locations.
• Optional (Video Desired)-A call can proceed as a best-effort, audio-only call if failure to obtain
reservations for both audio and video streams occurs. RSVP agent continues to attempt RSVP reservation
for audio and informs Cisco Unified Communications Manager if reservation succeeds.
• Mandatory-Cisco Unified Communications Manager does not ring the terminating device until RSVP
reservation succeeds for the audio stream and, if the call is a video call, for the video stream as well.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
152
System Components
Configure Location-pair RSVP Policy
• Mandatory (Video Desired)-A video call can proceed as an audio-only call if a reservation for the audio
stream succeeds but a reservation for the video stream does not succeed.
What to do next
Choose one of the following options:
• If you want a location pair to use a different policy than the rest of the cluster, Configure Location-pair
RSVP Policy, on page 153.
• If you are using the same RSVP policy for all nodes in the cluster, Configure RSVP Retry, on page 154.
Procedure
Step 1 In Cisco Unified Communications Manager Administration, choose the System > Location.
Step 2 Find one location of the location pair and select this location.
Step 3 To modify the RSVP policy between the selected location and another location, select the other location in
the location pair.
Step 4 In the RSVP Setting drop-down list, choose an RSVP policy for this location pair.
You can set this field to the following values:
• Use System Default–The RSVP policy for the location pair matches the cluster-wide RSVP policy.
• No Reservation–No RSVP reservations get made between any two locations.
• Video Desired (Optional) –A call can proceed as a best-effort, audio-only call if failure to obtain
reservations for both audio and video streams occurs. The RSVP agent continues to attempt RSVP
reservation for audio and informs Cisco Unified Communications Manager if reservation succeeds. The
system does not ring the terminating device until RSVP reservation succeeds for the audio stream and,
if the call is a video call, for the video stream as well.
• Video Desired–A video call can proceed as an audio-only call if a reservation for the audio stream
succeeds but the reservation for the video stream does not succeed.
What to do next
Configure RSVP Retry, on page 154
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
153
System Components
Configure RSVP Retry
Procedure
Step 1 In Cisco Unified Communications Manager Administration, choose System > Service Parameters .
Step 2 In the Service Parameter Configuration window, choose a server and choose the Cisco CallManager service.
Step 3 In the Clusterwide Parameters (System - RSVP) section, configure the specified service parameters.
You can set these service parameters to the following values:
• RSVP Retry Timer-Specify the RSVP retry timer value in seconds. If you set this parameter to 0, you
disable RSVP retry on the system.
• Mandatory RSVP Midcall Retry Counter-Specify the midcall RSVP retry counter when the RSVP policy
specifies Mandatory and midcall error handling option is set to “call fails following retry counter exceeds.”
The default value specifies 1 time. If you set the service parameter to -1, retry continues indefinitely until
either the reservation succeeds or the call gets torn down.
What to do next
Configure Midcall RSVP Error Handling, on page 154
Procedure
Step 1 In Cisco Unified Communications Manager Administration, choose System > Service Parameters.
Step 2 In the Service Parameter Configuration window, choose a server and choose the Cisco CallManager service.
Step 3 In the Clusterwide Parameters (System - RSVP) section, configure the specified service parameter.
You can set the Mandatory RSVP mid call error handle option service parameter to the following values:
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
154
System Components
Configure MLPP-to-RSVP Priority Mapping
• Call becomes best effort-If RSVP fails during a call, the call becomes a best-effort call. If retry is enabled,
RSVP retry attempts begin simultaneously.
• Call fails following retry counter exceeded-If RSVP fails during a call, the call fails after N retries of
RSVP, where the Mandatory RSVP Mid-call Retry Counter service parameter specifies N.
What to do next
Configure RSVP agents on your gateway device. See the documentation for device for information about
how to configure an RSVP agent. After you have configure RSVP agents on your gateway, return to Cisco
Unified Communications Manager Administration and choose one of the following options:
• Optional. Configure MLPP-to-RSVP Priority Mapping, on page 155 if you are using multilevel precedence
and preemption in your network.
• Configure the Application ID, on page 156
Procedure
Step 1 In Cisco Unified Communications Manager Administration, choose System > Service Parameters.
Step 2 In the Service Parameter Configuration window, choose a server and choose the Cisco CallManager service.
Step 3 In the Clusterwide Parameters (System - RSVP) section, configure the specified service parameters.
These service parameters function as follows:
• Cisco Unified Communications Manager maps the caller precedence level to RSVP priority when initiating
an RSVP reservation based on the following configuration: the higher the service parameter value, the
higher the priority.
• The IOS router preempts the call based on RSVP priority.
• The RSVP agent must notify Cisco Unified Communications Manager about the reason for an RSVP
reservation failure, including the cause for preemption.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
155
System Components
Configure the Application ID
• Cisco Unified Communications Manager uses the existing MLPP mechanism to notify the preempted
calling and called parties about the preemption.
What to do next
Configure RSVP agents on your gateway device. See the documentation for device for information about
how to configure an RSVP agent. After you have configure RSVP agents on your gateway, return to Cisco
Unified Communications Manager Administration and Configure the Application ID, on page 156.
Procedure
Step 1 In Cisco Unified Communications Manager Administration, choose System > Service Parameters.
Step 2 In the Service Parameter Configuration window, choose a server and choose the Cisco CallManager service.
Step 3 In the Clusterwide Parameters (System - RSVP) section, configure the RSVP Audio Application ID service
parameter.
(Default = AudioStream)
Step 4 In the Clusterwide Parameters (System - RSVP) section, configure the RSVP Video Application ID
(Default = VideoStream)
What to do next
Configure DSCP Marking, on page 156
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
156
System Components
Configure DSCP Marking
Procedure
Step 1 In Cisco Unified Communications Manager Administration, choose System > Service Parameters.
Step 2 In the Service Parameter Configuration window, choose a server and choose the Cisco CallManager service.
Step 3 In the Clusterwide Parameters (System - QoS) section, configure the DSCP for Audio Calls When RSVP
Fails service parameter.
Step 4 In the Clusterwide Parameters (System - QoS) section, configure the DSCP for Video Calls When RSVP
Fails service parameter.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
157
System Components
Configure DSCP Marking
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
158
CHAPTER 16
Configure Push Notifications
• Push Notifications Overview, on page 159
• Push Notifications Configuration, on page 163
Note Cisco Jabber and Cisco Webex is considered to be running in suspended mode if any of the following conditions
are true:
• the Cisco Jabber or Cisco Webex application is running off-screen (in the background)
• the Android or iOS device is locked
• the Android or iOS device screen is turned off
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
159
System Components
Push Notifications Overview
The above diagram displays what happens when Cisco Jabber or Cisco Webex for Android and iOS clients
run in the background or are stopped. The figure illustrates: (1) an Mobile and Remote Access deployment
where the clients that connects with an on-premises Cisco Unified Communications Manager and IM and
Presence Service deployment through Expressway, and (2) a Cisco Jabber or Cisco Webex for Android and
iOS clients that connects directly to the on-premises deployment from within the enterprise network.
Note As of iOS13 for Apple clients and supported Android clients, voice calls and messages use separate Push
Notifications channels ('VoIP' and 'Message') to reach a client that is running in background mode. However,
the general flow is the same for both channels. With iOS 12, voice calls and messages are delivered using the
same channel.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
160
System Components
Push Notifications Overview
Cisco Jabber or Cisco Cisco Jabber is running on an iOS12 Device Cisco Jabber is running on an iOS13 Device
Webex client is running or Android Device
in...
Foreground Mode Voice and Video Calls The behaviour is the same as with iOS12.
Unified Communications Manager sends
voice and video calls to Cisco Jabber or Cisco
Webex clients directly using the standard SIP
communications channel.
For calls, Unified Communications Manager
also sends Push Notifications to Cisco Jabber
or Cisco Webex clients that are in foreground
mode. However, the standard SIP channel
gets used to establish the call, rather than the
Push Notifications channel.
Messages
The IM and Presence Service sends messages
to the client directly using the standard SIP
communication channel. For messages, Push
Notifications are not sent to clients that are
in foreground mode.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
161
System Components
Push Notifications Overview
Cisco Jabber or Cisco Cisco Jabber is running on an iOS12 Device Cisco Jabber is running on an iOS13 Device
Webex client is running or Android Device
in...
Suspended Mode Voice or Video Calls With iOS13, call traffic and message traffic
(Background mode) is split into separate Push Notifications
Standard communication channel is
channels: a 'VoIP' channel for calls, and a
unavailable. Unified CM uses the Push
"Message" channel for messaging.
Notifications channel.
Voice or Video Calls
Upon receiving the notification, the Cisco
Jabber or Cisco Webex client re-enters Standard communication channel is
foreground mode automatically, and the client unavailable. Unified CM uses Push
rings. Notifications 'VoIP' channel.
Messaging Upon receiving the VoIP notification, Jabber
launches CallKit with Caller ID.
Standard communication channel is
unavailable. IM and Presence Service uses This behavior holds for Cisco Jabber or Cisco
the Push Notifications channel to send IM Webex iOS clients.
notifications as follows:
Messaging
1. IM and Presence Service sends the IM
Standard communication channel is
notification to the Push REST service in
unavailable. IM and Presence Service uses
the Cisco cloud, which forwards the
Push Notifications 'Message' channel.
notification to the Apple cloud.
1. IM and Presence Service sends the IM
2. The Apple cloud pushes the IM notification to the Push REST service in
notification to the Cisco Jabber or Cisco the Cisco cloud, which forwards the
Webex client and a notification appears notification to the Apple cloud.
on the Cisco Jabber or Cisco Webex
client. 2. The Apple cloud pushes the IM
notification to the Cisco Jabber or Cisco
3. When the user clicks the notification, the Webex client.
Cisco Jabber or Cisco Webex client
moves back the foreground. The Cisco 3. When the user clicks the notification,
Jabber or Cisco Webex client resumes Cisco Jabber or Cisco Webex client
the session with the IM and Presence moves to foreground mode. Cisco Jabber
Service and downloads the instant or Cisco Webex client resumes the
message. session with the IM and Presence Service
and downloads the message.
Note While the Cisco Jabber or Cisco
Webex client is in suspended Note While Cisco Jabber or Cisco
mode, the user's Presence status Webex client is in suspended
displays as Away. mode, the user Presence displays
as Away.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
162
System Components
Push Notifications Configuration
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
163
System Components
Push Notifications Configuration
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
164
PA R T II
Dial Plan
• Configure Partitions, on page 167
• Install a National Numbering Plan, on page 173
• Configure Call Routing, on page 177
• Configure Hunt Pilots, on page 205
• Configure Intercluster Lookup Service, on page 213
• Configure Global Dial Plan Replication, on page 221
• Calling Party Normalization, on page 237
• Configure Dial Rules, on page 247
CHAPTER 17
Configure Partitions
• Partitions Overview, on page 167
• Calling Search Space Overview, on page 167
• Class of Service, on page 168
• Partition Configuration Task Flow, on page 169
• Partition Interactions and Restrictions , on page 171
Partitions Overview
Partitions are logical groups of any of the following:
• Route patterns
• Directory numbers (DNs)
• Translation patterns
• Transformation patterns
• Universal resource indicators (URIs)
• Hunt pilots
Partitions facilitate call routing by dividing the route plan into logical subsets that are based on similar
accessibility requirements, organization, location, and call type.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
167
Dial Plan
Class of Service
Class of Service
You can use partitions and calling search spaces (CSS) to configure classes of service. The table below provides
an example of partitions and calling search spaces that you can create for classes of service that provide PSTN
access to:
• Emergency calls
• Local calls
• National calls
• International dialing
Calling Search Space Route Partition 1 Route Partition 2 Route Partition 3 Capabilities
Base_CSS Base_PT — — • Emergency
• On-net
Devices automatically register with a calling search space such as Base_CSS. This allows all devices to dial
both on-net and emergency off-net numbers. You must assign the remaining calling search spaces to the
directory number on the user device profile to provide local 7-digit or local 10-digit, national, and international
dialing capabilities.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
168
Dial Plan
Partition Configuration Task Flow
Step 2 Configure Calling Search Spaces, on page 170 Configure the partitions that calling devices
search when they are attempting to complete a
call.
Configure Partitions
Configure partitions to create a logical group of system resources with similar reachability characteristics.
You can create partitions for any of the following:
• Route patterns
• Directory numbers (DNs)
• Translation patterns
• Transformation patterns
• Universal resource indicators (URIs)
• Hunt pilots
Partitions facilitate call routing by dividing the route plan into logical subsets that are based on organization,
location, and call type. You can configure multiple partitions.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Class of Control > Partition.
Step 2 Click Add New to create a new partition.
Step 3 In the Partition Name, Description field, enter a name for the partition that is unique to the route plan.
Partition names can contain alphanumeric characters, as well as spaces, hyphens (-), and underscore characters
(_). See the online help for guidelines about partition names.
Step 4 Enter a comma (,) after the partition name and enter a description of the partition on the same line.
The description can contain up to 50 characters in any language, but it cannot include double quotes ("),
percentage sign (%), ampersand (&), backslash (\), angle brackets (<>), or square brackets ([ ]).
If you do not enter a description, Cisco Unified Communications Manager automatically enters the partition
name in this field.
Step 5 To create multiple partitions, use one line for each partition entry.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
169
Dial Plan
Partition Name Guidelines
Step 6 From the Time Schedule drop-down list, choose a time schedule to associate with this partition.
The time schedule specifies when the partition is available to receive incoming calls. If you choose None, the
partition remains active at all times.
Step 7 Select one of the following radio buttons to configure the Time Zone:
• Originating Device—When you select this radio button, the system compares the time zone of the calling
device to the Time Schedule to determine whether the partition is available is available to receive an
incoming call.
• Specific Time Zone—After you select this radio button, choose a time zone from the drop-down list.
The system compares the chosen time zone to the Time Schedule to determine whether the partition is
available is available to receive an incoming call.
2 characters 340
3 characters 256
4 characters 204
5 characters 172
... ...
10 characters 92
15 characters 64
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Class of Control > Calling Search Space.
Step 2 Click Add New.
Step 3 In the Name field, enter a name.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
170
Dial Plan
Partition Interactions and Restrictions
Ensure that each calling search space name is unique to the system. The name can include up to 50 alphanumeric
characters and can contain any combination of spaces, periods (.), hyphens (-), and underscore characters (_).
Step 5 From the Available Partitions drop-down list, perform one of the following steps:
• For a single partition, select that partition.
• For multiple partitions, hold down the Control (CTRL) key, then select the appropriate partitions.
Step 6 Select the down arrow between the boxes to move the partitions to the Selected Partitions field.
Step 7 (Optional) Change the priority of selected partitions by using the arrow keys to the right of the Selected
Partitions box.
Step 8 Click Save.
Check carefully to ensure that you are deleting the correct partition, because you cannot
retrieve deleted partitions. If you accidentally delete a partition, you must rebuild it.
Translation Patterns A translation pattern contains digit manipulations and is assigned to a partition. When
a call matches the translation pattern, Unified CM performs the translation and then
reroutes the call using the calling search space that the translation pattern specifies.
For details on translation patterns, see the Configure Call Routing chapter.
Time of Day Configure a schedule for when a partition is available to accept incoming calls. For
Routing details on configuring time of day routing, see the Configure Call Routing chapter.
Logical Partitioning Optional: Allows you split your internal VoIP network from your external network
with gateway and trunk access. Logical partitioning is optional for most deployments,
but is mandatory in countries such as India where regulations mandate that all calls
that leave the internal network go to a local PSTN gateway. For details on Configuring
Logical Partitioning, refer to the "Configure Logical Partitioning" section in the Feature
Configuration Guide for Cisco Unified Communication Manager.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
171
Dial Plan
Partition Interactions and Restrictions
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
172
CHAPTER 18
Install a National Numbering Plan
• National Numbering Plan Overview, on page 173
• National Numbering Plan Prerequisites, on page 173
• National Numbering Plan Installation Task Flow, on page 174
Place the file on an external FTP or SFTP server that Unified Communications Manager can access.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
173
Dial Plan
National Numbering Plan Installation Task Flow
Step 2 Install a National Numbering Plan, on page 175 Install the national numbering plan on each
Unified Communications Manager node in the
cluster. Perform this procedure only if you are
installing a National Numbering Plan for
countries outside of North America.
Step 3 Restart the CallManager Service, on page 175 The changes take effect after you restart the
service.
Procedure
Step 1 Begin this procedure on the Unified Communications Manager publisher node. From Cisco Unified
Communications OS Administration, choose Software Upgrades > Install.
The Software Installation/Upgrade window appears.
Step 2 In the Source field, choose Remote File System.
Step 3 Configure the fields on the Software Installation/Upgrade window. See the Related Topics for more
information about the fields and their configuration options.
Step 4 Click Next.
The window refreshes with a list of available software options and upgrades.
Step 5 From the Options/Upgrades drop-down list, choose the DP COP file and click Next.
The Installation File window opens and downloads the file from the FTP server. The window displays the
progress of the download.
Step 6 When the Checksum window appears, verify the checksum value against the checksum for the file that you
downloaded.
Step 7 Click Next to proceed with the software upgrade.
A warning message displays the DP COP file that you selected to install.
Step 8 Click Install.
The Install Status window appears.
Step 9 Click Finish.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
174
Dial Plan
COP File Installation Fields
Step 10 Repeat this procedure on the Unified Communications Manager subscriber nodes. You must install the COP
file on all the nodes in the cluster.
Related Topics
COP File Installation Fields, on page 175
Remote Server Enter the host name or IP address of the server where COP file is located.
Remote User Enter the user name for the remote server.
Transfer Protocol Select a protocol to use when connecting with the remote server.
Procedure
Step 1 From Cisco Unified Communications Manager Administration, choose Call Routing > Dial Plan Installer.
Step 2 Enter search criteria and click Find.
Step 3 Choose the dial plan version that you want to install from the Available Version drop-down list.
Step 4 Click Install.
The Status displays that the dial plan has been installed.
Step 5 Repeat this procedure for every subscriber node in the cluster.
Step 1 From the Cisco Unified Serviceability interface, choose Tools > Control Center - Feature Services.
Step 2 Choose the Unified Communications Manager server from the Servers drop-down list.
In the CM Services area, Cisco CallManager displays in the Service Name column.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
175
Dial Plan
Restart the CallManager Service
Step 3 Click the radio button that corresponds to the Cisco CallManager service.
Step 4 Click Restart.
The service restarts and displays the message, Service Successfully Restarted.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
176
CHAPTER 19
Configure Call Routing
• Call Routing Overview, on page 177
• Call Routing Prerequisites, on page 178
• Call Routing Configuration Task Flow, on page 179
• Call Routing Restrictions, on page 194
• Troubleshooting with Dialed Number Analyzer, on page 195
• Line Group Setup , on page 196
Translation Patterns
You can configure translation patterns to manipulate digits for any type of call. Translation patterns follow
the same general rules and use the same wildcards as route patterns. As with route patterns, you assign a
translation pattern to a partition. However, when the dialed digits match the translation pattern, Unified CM
does not route the call to an outside entity such as a gateway; instead, it performs the translation first and then
routes the call again, this time using the calling search space that is configured within the translation pattern.
Note For each translation pattern that you create, ensure that the combination of partition, route filter, and numbering
plan is unique. If you receive an error that indicates duplicate entries, check the route pattern or hunt pilot,
translation pattern, directory number, call park number, call pickup number, or meet-me number configuration
windows.
Transformation Patterns
Transformation patterns can be used to discard digits, add prefix digits, add a calling party transformation
mask, and control the presentation of the calling party number before the system sends the call to the phone
or to the PSTN.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
177
Dial Plan
Call Routing Prerequisites
Configure transformation patterns and associate them to a route partition, thereby assigning the pattern to the
calling search space that contains the partition. You can assign the pattern to the call settings for a specific
device, device pool, gateway, or trunk via the Calling Party Transformation CSS or Called Party Transformation
CSS fields in the configuration windows.
You can configure the following transformation patterns:
• Calling Party Transformation Patterns — Allow the system to adapt the global form of the calling
party's number into the local form required by off-cluster networks connected to the route group devices,
such as gateways or trunks.
Called Party Transformation Patterns — Allow the system to adapt the global form of the called
party's number into the local form required by off-cluster networks connected to the route group devices.
Route Patterns
The system has a three-tiered approach to route planning that uses the following components:
• Route Patterns — The system searches for a configured route pattern that matches the external dial
string and uses it to direct the call to a gateway or route list. You can assign route patterns to gateways,
trunks, or to a route list that includes one or more route groups.
• Route Lists — A prioritized list of the available paths for the call.
• Route Groups — The available paths; the route group distributes the call to gateways and trunks.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
178
Dial Plan
Call Routing Configuration Task Flow
For detailed information on planning your call routing, refer to the Call Control and Routing topics in the
Cisco Collaboration System Solution Reference Network Design.
Step 2 Configure Calling Party Transformation Use this procedure to transform the calling
Patterns, on page 180 number. For example, you can configure a
transformation pattern that replaces a caller's
extension with the office's main number when
calling the PSTN.
Step 3 Configure Called Party Transformation Use this procedure to transform the called
Patterns, on page 181 number. For example, you can configure a
transformation pattern that retains only the last
five digits of a ten-digit calling number.
Step 4 Configure Local Route Groups, on page 181 Optional. Local route groups let you use a
single set of route patterns for multiple
locations. Unified CM assigns the gateway
based on the calling device location rather than
the route pattern.
Step 5 Configure Route Groups, on page 183 Optional. Configure route groups to set the
selection order of the gateway devices. Route
groups contain one or more devices.
Step 6 Configure Route Lists, on page 184 Optional. Route lists contain one or more
route groups. Configure route lists to control
the selection order of the route groups.
Step 7 Configure Route Filters, on page 184 Optional. Use route filters to restrict certain
numbers that are otherwise allowed by a route
pattern.
Step 8 Configure Route Patterns, on page 188 Configure route patterns to direct calls to
specific devices and to include or exclude
specific digit patterns.
Step 9 Enable Clusterwide Automated Alternate Optional. Enable Automated Alternate
Routing, on page 192 Routing (AAR) to let the system reroute calls
to the PSTN or other networks when calls are
blocked due to insufficient bandwidth.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
179
Dial Plan
Configure Translation Patterns
Step 11 Configure Time of Day Routing, on page 193 Optional. Create a time schedule that specifies
when a given partition is available to receive
incoming calls.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Translation Pattern.
Step 2 Choose one of the following options:
• Click Add New to add a new translation pattern.
• Click Find, and select an exisiting translation pattern.
Step 3 In the Translation Pattern field, enter the pattern that you want the system to match to dial strings that use
this pattern.
Step 4 From the Partition drop-down list, select the partition where you want to assign this pattern.
Step 5 Complete the remaining fields in the Translation Pattern Configuration window. For more information on
the fields and their configuration options, see the system Online Help.
Step 6 Click Save.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Transformation > Transformation Pattern >
Calling Party Transformation Pattern.
Step 2 Choose one of the following options:
• Click Add New to add a new calling party transformation pattern.
• Click Find and select an existing pattern.
Step 3 From the Pattern field, enter the pattern that you want to match to the calling party number.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
180
Dial Plan
Configure Called Party Transformation Patterns
Step 4 Complete the remaining fields in the Calling Party Transformation Pattern Configuration window. For
more information on the fields and their configuration options, see Online Help.
Step 5 Click Save.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Transformation > Transformation Pattern >
Called Party Transformation Pattern.
Step 2 Choose one of the following options:
• Click Add New, to add a new called party transformation pattern.
• Click Find and select an existing pattern.
Step 3 From the Pattern field, enter the pattern that you want to match to the called number.
Step 4 Complete the remaining fields in the Called Party Transformation Pattern Configuration window. For
more information on the fields and their configuration options, see the system Online Help.
Step 5 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
181
Dial Plan
Configure Local Route Group Names
Note Extend and Connect works only with Standard Local Route Groups when Local route group for redirected
calls are set to Local route group of last redirecting party.
Mobile Voice Access works only with Standard Local Route Groups when Local route group for redirected
calls are set to Local route group of calling party.
Procedure
Step 2 Associate a Local Route Group with a Device To ensure that each device in the system is
Pool, on page 182 provisioned to know its local route group,
associate the local route group with a device
pool.
Step 3 Add Local Route Group to a Route List, on Optional. Configure a local route group that
page 183 you can add to your route list. When you create
a local route group, the system routes outgoing
calls to the gateways that are defined for the
user at the device pool level.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Route/Hunt > Local Route Group Names.
Step 2 Click Add Row.
Step 3 Enter a name and description for the new local route group.
Step 4 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
182
Dial Plan
Add Local Route Group to a Route List
To ensure that each device in the system is provisioned to know its local route group, associate the local route
group with a device pool.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Device Pool.
Step 2 Enter search criteria, click Find, and select a device pool from the resulting list.
Step 3 In the Local Route Group Settings area, select a route group from the Standard Local Route Group
drop-down list.
Step 4 Click Save.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Route/Hunt > Route List.
Step 2 Choose one of the following options:
• Click Add New button to add a new route list.
• Click Find and select a route list from the resulting list, to modify the settings for an existing route list.
The Route List Configuration window appears.
Step 3 To add a local route group to the route list, click the Add Route Group button.
Step 4 From the Route Group drop-down list, select a local route group to add to the route list. You can add the
standard local route group, or you can add a custom local route group that you have created.
Step 5 Click Save.
Step 6 Click Apply Config.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Route/Hunt > Route Group.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
183
Dial Plan
Configure Route Lists
Note When an outbound call is sent through a route list, the route list process locks the outbound device to prevent
sending an alert message before the call is completed. After the outbound device is locked, the Hunt List stops
hunting down the incoming calls.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Route/Hunt > Route List.
Step 2 Choose one of the following options:
• Click Add New, to add a new route list.
• Click Find and select a route list from the resulting list, to modify the settings for an existing route list.
Step 3 Configure the fields in the Route List Configuration window. For more information on the fields and their
configuration options, see the system Online Help.
Step 4 To add a route group to the route list, click the Add Route Group button.
Step 5 From the Route Group drop-down list, choose a route group to add to the route list.
Step 6 Click Save.
Step 7 Click Apply Config.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
184
Dial Plan
Route Filter Settings
Unified Communications Manager routes calls according to the numbering plan that you specify in this
procedure.
Route filters are mandatory if you are using a dial plan installer; that is, if you install a dial plan file and then
configure a route pattern based on that numbering plan. Route plans are optional when configuring dial plans
manually.
If you are configuring a dial plan manually, you need to configure route filters whenever you have a route
pattern that contains the @ wildcard. When the route pattern contains the @ wildcard, the system routes calls
according to the numbering plan that you specify with a route filter.
Note When configuring your call routing, ensure that you do not assign a single route filter to many route patterns.
A system core could result if you were to edit a route filter that has hundreds of associated route patterns.
This is due to the extra system processing that is required to update call routing for all of the route patterns
that use the route filter. Create duplicate route filters and associate any single route filter with no more than
250 Route Patterns.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Route Filter.
Step 2 From the Numbering Plan drop-down list, choose a dial plan and click Next.
Step 3 Enter a name in the Route Filter Name field.
Ensure each route filter name is unique to the route plan.
Step 4 Choose the route filter tags and operators and enter the data to create a clause for this route filter.
For more information about available route filter tags, see Route Filter Tags, on page 186.
Note Do not enter route filter tag values for tags that are using the operators EXISTS, DOES-NOT-EXIST,
or NOT-SELECTED.
Step 5 Choose the route filter operators and enter data, where appropriate, to create a clause for this route filter.
For more inforation about available route filter operators, see Route Filter Operators, on page 187.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
185
Dial Plan
Route Filter Tags
Tag Description
AREA-CODE This three-digit area code in the form [2-9]XX identifies the area code for long-distance
calls.
COUNTRY CODE These one-, two-, or three-digit codes specify the destination country for international
calls.
END-OF-DIALING This single character identifies the end of the dialed-digit string. The # character serves
as the end-of-dialing signal for international numbers that are dialed within the NANP.
INTERNATIONAL-ACCESS This two-digit access code specifies international dialing. Calls that originate in the
U.S. use 01 for this code.
INTERNATIONAL-DIRECT-DIAL This one-digit code identifies a direct-dialed international call. Calls that originate in
the U.S. use 1 for this code.
INTERNATIONAL-OPERATOR This one-digit code identifies an operator-assisted international call. This code specifies
0 for calls that originate in the U.S.
LOCAL-AREA-CODE This three-digit local area code in the form [2-9]XX identifies the local area code for
10-digit local calls.
LOCAL-DIRECT-DIAL This one-digit code identifies a direct-dialed local call. NANP calls use 1 for this code.
LOCAL-OPERATOR This one-digit code identifies an operator-assisted local call. NANP calls use 0 for this
code.
LONG-DISTANCE-DIRECT-DIAL This one-digit code identifies a direct-dialed, long-distance call. NANP calls use 1 for
this code.
LONG-DISTANCE-OPERATOR These one- or two-digit codes identify an operator-assisted, long-distance call within
the NANP. Operator-assisted calls use 0 for this code, and operator access uses 00.
NATIONAL-NUMBER This tag specifies the nation-specific part of the digit string for an international call.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
186
Dial Plan
Route Filter Operators
Tag Description
OFFICE-CODE This tag designates the first three digits of a seven-digit directory number in the form
[2-9]XX.
SATELLITE-SERVICE This one-digit code provides access to satellite connections for international calls.
SERVICE This three-digit code designates services such as 911 for emergency, 611 for repair,
and 411 for information.
SUBSCRIBER This tag specifies the last four digits of a seven-digit directory number in the form
XXXX.
TRANSIT-NETWORK-ESCAPE This three-digit value precedes the long-distance carrier identifier. The value for this
field specifies 101. Do not include the four-digit carrier identification code in the
TRANSIT-NETWORK-ESCAPE value. See TRANSIT-NETWORK for more
information.
Operator Description
NOT-SELECTED Specifies do not filter calls based on the dialed-digit string that is associated with this
tag.
Note The presence or absence of the tag with which the operator is associated
does not prevent Cisco Unified Communications Manager from routing the
call.
EXISTS Specifies filter calls when the dialed-digit string that is associated with this tag is found.
Note Cisco Unified Communications Manager routes or blocks the call only if
the dialed-digit string contains a sequence of digits that are associated with
the tag.
DOES-NOT-EXIST Specifies filter calls when the dialed-digit string that is associated with this tag is not
found.
Note Cisco Unified Communications Manager routes or blocks the call only if
the dialed-digit string does not contain a sequence of digits that are associated
with the tag.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
187
Dial Plan
Route Filter Examples
Operator Description
== Specifies filter calls when the dialed-digit string that is associated with this tag matches
the specified value.
Note Cisco Unified Communications Manager routes or blocks the call only if
the dialed-digit string contains a sequence of digits that are associated with
the tag and within the numbering range that is specified in the attached field.
Note Although the route pattern can point directly to a gateway, we recommend that you configure route lists and
route groups. This approach provides the greatest flexibility in call routing and scalability.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Route/Hunt > Route Pattern.
Step 2 Perform one of the following:
• Click Add New to create a new route pattern.
• Click Find and select an existing route pattern.
The Route Pattern Configuration Window appears.
Step 3 In the Route Pattern field, enter the number pattern that the dial string must match.
Step 4 From the Gateway/Route drop-down list, select the destination where you want to send calls that match this
route pattern.
Step 5 Complete the remaining fields in the Route Pattern Configuration window. For more information on the
fields and their configuration options, see the system Online Help.
Step 6 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
188
Dial Plan
Route Patterns Settings
@ The at symbol (@) wildcard The route pattern 9.@ routes or blocks all numbers
matches all National Numbering that the National Numbering Plan recognizes.
Plan numbers.
The following route patterns examples show National
Each route pattern can have only Numbering Plan numbers that the @ wildcard
one @ wildcard. encompasses:
•0
• 1411
• 19725551234
• 101028819725551234
• 01133123456789
X The X wildcard matches any single The route pattern 9XXX routes or blocks all numbers
digit in the range 0 through 9. in the range 9000 through 9999.
! The exclamation point (!) wildcard The route pattern 91! routes or blocks all numbers in
matches one or more digits in the the range 910 through 91999999999999999999999.
range 0 through 9.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
189
Dial Plan
Wildcards and Special Characters in Route Patterns
? The question mark (?) wildcard The route pattern 91X? routes or blocks all numbers
matches zero or more occurrences in the range 91 through 91999999999999999999999.
of the preceding digit or wildcard
value.
Note If the question mark (??)
wildcard is used, the
second question mark
does not match the
empty input. Example
router pattern:
*33X?*X?*X?#
+ The plus sign (+) wildcard matches The route pattern 91X+ routes or blocks all numbers
one or more occurrences of the in the range 910 through 91999999999999999999999.
preceding digit or wildcard value.
[] The square bracket ([ ]) characters The route pattern 813510[012345] routes or blocks
enclose a range of values. all numbers in the range 8135100 through 8135105.
- The hyphen (-) character, used with The route pattern 813510[0-5] routes or blocks all
the square brackets, denotes a range numbers in the range 8135100 through 8135105.
of values.
^ The circumflex (^) character, used The route pattern 813510[^0-5] routes or blocks all
with the square brackets, negates a numbers in the range 8135106 through 8135109.
range of values. Ensure that it is the
first character following the
opening bracket ([).
Each route pattern can have only
one ^ character.
. The dot (.) character, used as a The route pattern 9.@ identifies the initial 9 as the
delimiter, separates the Cisco Cisco Unified Communications Manager access code
Unified Communications Manager in a National Numbering Plan call.
access code from the directory
number.
Use this special character, with the
discard digits instructions, to strip
off the Cisco Unified
Communications Manager access
code before sending the number to
an adjacent system.
Each route pattern can have only
one dot (.) character.
* The asterisk (*) character can You can configure the route pattern *411 to provide
provide an extra digit for special access to the internal operator for directory assistance.
dialed numbers.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
190
Dial Plan
Example of Pre-dot Digit Removal
# The octothorpe (#) character The route pattern 901181910555# routes or blocks an
generally identifies the end of the international number that is dialed from within the
dialing sequence. National Numbering Plan. The # character after the
last 5 identifies this digit as the last digit in the
Ensure the # character is the last
sequence.
character in the pattern.
\+ A plus sign preceded by a Using \+ means that the international escape character
backslash, that is, \+, indicates that + is used as a dialable digit, not as a wildcard.
you want to configure the
international escape character +.
In these patterns, 9 is the access code for an external line, and the dot (.) is a separator that helps format the
route pattern by indicating which digits are internal to the network, and which ones are outside digits. When
the system sends the dialed digits to the PSTN, you can use the Discard Digits option to strip the pre-dot digit
from the dialed string so that the PSTN can route the call.
Ensure that you deselect the Allow Device Override check box when you use this option.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
191
Dial Plan
Example of Block and Route Patterns
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Service Parameters.
Step 2 Select a node in the Server drop-down box.
Step 3 From the Service drop-down list, select Cisco Call Manager.
Step 4 In the Clusterwide Parameters (System - CCM Automated Alternate Routing) area, set the Automated
Alternate Routing Enable parameter to True.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > AAR Group.
Step 2 Choose one of the following options:
• Click Add New, to add a new AAR group.
• Click Find and choose an AAR group from the resulting list, to modify the settings for an existing AAR
group.
The AAR Group Configuration window appears.
Step 3 In the Name field, enter the name that you want to assign to the new AAR group.
The name can contain up to 20 alphanumeric characters and can contain any combination of spaces, periods
(.), hyphens (-), and underscore characters (_).
The window refreshes and displays additional fields.
Step 4 Configure the fields on the AAR Group Configuration window. For more information on the fields and their
configuration options, see the system Online Help.
Step 5 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
192
Dial Plan
Configure Time of Day Routing
Note Optional. To enable AAR to work with hunt pilots, see Hunt Pilot Configuration Task Flow, on
page 205.
Note Time of Day routing is not implemented for Message Waiting Indication (MWI) intercept.
Procedure
Step 2 Configure a Time Schedule, on page 194 Use this procedure to create a schedule. The
time periods that you configured in the previous
procedure are building blocks for this schedule.
You can assign time periods to multiple
schedules.
Step 3 Associate a Time Schedule with a Partition, on Associate time schedules with partitions to
page 194 determine where calling devices search when
they are attempting to complete a call during a
particular time of day.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Class of Control > Time Period.
Step 2 Configure the fields in the Time Period Configuration window. For more information on the fields and their
configuration options, see the system Online Help.
Step 3 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
193
Dial Plan
Configure a Time Schedule
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Class of Control > Time Schedule.
Step 2 Configure the fields in the Time Schedule Configuration window. For more information on the fields and
their configuration options, see the system Online Help.
Step 3 Click Save.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Class of Control > Partition.
Step 2 From the Time Schedule drop-down list, choose a time schedule to associate with this partition.
The time schedule specifies when the partition is available to receive incoming calls. If you choose None, the
partition remains active at all times.
Step 3 Click Save.
Route Filter When configuring your call routing, be careful not to assign a single route filter to too
Associations many route patterns. A system core crash could result if you were to edit a route filter
that has hundreds of associated route patterns. This is due to the extra system processing
that is required to update call routing for all of the route patterns that use the route
filter. Create duplicate route filters to ensure that this does not happen.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
194
Dial Plan
Troubleshooting with Dialed Number Analyzer
Feature Restriction
External Call External call control lets an adjunct route server make call routing decisions for Unified
Control Communications Manager by using the Cisco Unified Routing Rules Interface. When
you configure external call control, Unified Communications Manager issues a route
request that contains the calling party and called party information to the adjunct route
server. That server receives the request, applies appropriate business logic, and returns
a route response that instructs your system on how to route the call along with any
additional call treatment to apply.
For details, see the Configure External Call Control chapter of the Feature
Configuration Guide for Cisco Unified Communications Manager.
Call Control With Call Control Discovery, Unified Communications Manager clusters can
Discovery automatically exchange the DN ranges they host by subscribing to a Cisco IOS service
routing protocol called the Service Advertisement Framework (SAF). This feature
enables clusters to advertise their own hosted DN ranges into the network as well as
to subscribe to advertisements that are generated by other call agents in the network.
The main benefits of using SAF CCD are:
• Automated distribution of call routing information between call agents participating
in the same SAF CCD network, thus avoiding incremental configuration work
when new call agents are added or when new DN ranges are added to a call agent.
• No reliance on a centralized dial plan resolution control point.
• Automated recovery of inter-call agent call routing information when routing
changes occur, including when multiple Unified CM clusters are combined.
To configure Call Control Discovery, refer to the Configure Call Control Discovery
chapter of the Feature Configuration Guide for Cisco Unified Communications
Manager.
Route Plan Report You can view a detailed route plan within the Route Plan Report window of Cisco
Unified CM Administration (Call Routing > Route Plan Report). The route plan report
allows you to view either a partial or full list of your route plan and to go directly to
the associated configuration windows by clicking the entry in the Pattern/Directory
Number, Partition, or Route Detail columns of the report.
In addition, the route plan report allows you to save report data into a .csv file that you
can import into other applications. The .csv file contains more detailed information
than the web pages, including directory numbers for phones, route patterns, pattern
usage, device name, and device description.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
195
Dial Plan
Line Group Setup
contain errors. You can use Dialed Number Analyzer to test a dial plan by providing dialed digits as input.
The tool analyzes the dialed digits and shows details of the calls. You can use these results to diagnose the
dial plan, identify problems if any, and tune the dial plan before you deploy it.
For details on how to set up and use the Dialed Number Analyzer, refer to the document Dialed Number
Analyzer for Cisco Unified Communications Manager at https://www.cisco.com/c/en/us/support/
unified-communications/unified-communications-manager-callmanager/products-maintenance-guides-list.html.
Note Users cannot pick up calls to a DN that belongs to a line group by using the Directed Call Pickup feature.
Tip Although you can configure an empty line group with no members (directory numbers), Cisco Unified
Communications Manager does not support this configuration for routing calls. If the line group contains no
members, the hunt list stops hunting when the call gets routed to the empty line group. To avoid this situation,
make sure that you configure at least one member in the line group.
Tip Dependency Records is not supported for line groups. As a best practice, always check the configuration
before you delete a line group.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
196
Dial Plan
Line Group Settings
Line Group Name Enter a name for this line group. The name can
comprise up to 50 alphanumeric characters and can
contain any combination of spaces, periods (.),
hyphens (-), and underscore characters (_). Ensure
that each line group name is unique to the route plan.
Timesaver Use concise and descriptive names for your
line groups. The
CompanynameLocationGroup format
usually provides a sufficient level of detail
and is short enough to enable you to
quickly and easily identify a line group.
For example, CiscoDallasAA1 identifies
a Cisco Access Analog line group for the
Cisco office in Dallas.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
197
Dial Plan
Line Group Settings
Field Description
Hunt Options
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
198
Dial Plan
Line Group Settings
Field Description
Automatically Logout Hunt Member on No Answer If this check box is checked, line members will be
logged off the hunt list automatically. Line members
can log back in using the "HLOG" softkey or PLK.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
199
Dial Plan
Line Group Settings
Field Description
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
200
Dial Plan
Line Group Settings
Field Description
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
201
Dial Plan
Line Group Settings
Field Description
Partition Choose a route partition for this line group from the
drop-down list box. The default value specifies
<None>.
If you click Find, the Available DN/Route Partition
list box displays all DNs that belong to the chosen
partition.
Directory Number Contains Enter the character(s) that are found in the directory
number that you are seeking and click the Find button.
Directory numbers that match the character(s) that
you entered display in the Available DN/Route
Partition box.
Broadcast algorithm with shared line DNs To change the priority of a directory number, choose
a directory number in the Selected DN/Route Partition
list box. Move the directory number up or down in
the list by clicking the arrows on the right side of the
list box.
To reverse the priority order of the directory numbers
in the Selected DN/Route Partition list box, click
Reverse Order of Selected DNs/Route Partitions.
Note When adding DNs and Route Partitions to
your line group, do not put DNs that are
shared lines in a line group that uses the
Broadcast distribution algorithm. Unified
Communications Manager cannot display
all DNs that are shared lines on devices
where the DNs are configured as shared
lines if the DNs are members of a line
group that uses the Broadcast distribution
algorithm.
Directory Numbers
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
202
Dial Plan
Add Members to Line Group
Field Description
(list of DNs that currently belong to this line group) Click a directory number in this list to go to the
Directory Number Configuration window for the
specified directory number.
Note When you are adding a new line group,
this list does not display until you save the
line group.
Procedure
Step 4 In the Available DN/Route Partition list box, choose a directory number to add and click Add to Line Group
to move it to the Selected DN/Route Partition list box. Repeat this step for each member that you want to add
to this line group.
Step 5 In the Selected DN/Route Partition list box, choose the order in which the new directory number(s) is to be
accessed in this line group. To change the order, click a directory number and use the Up and Down arrows
to the right of the list box to change the order of directory numbers.
Step 6 Click Save to add the new directory numbers and to update the directory number order for this line group.
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
203
Dial Plan
Remove Members From Line Group
Step 2 Locate the line group from which you want to remove a directory number.
Step 3 In the Selected DN/Route Partition list box, choose a directory number to be deleted and click the down arrow
below the list box to move the directory number to the Removed DN/Route Partition list box. Repeat this step
for each member that you want to remove from this line group.
Step 4 To remove the members, click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
204
CHAPTER 20
Configure Hunt Pilots
• Hunt Pilot Overview, on page 205
• Hunt Pilot Configuration Task Flow, on page 205
• Hunt Pilot Interactions and Restrictions, on page 210
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
205
Dial Plan
Configure Line Groups
Step 3 Configure Hunt Pilots, on page 207 Configure a hunt pilot number or pattern that
the system uses to direct calls to a hunt list.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Route/Hunt > Line Group.
Step 2 Choose one of the following options:
• Click Add New to create a new line group.
• Click Find and select an existing line group.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Route/Hunt > Hunt List.
Step 2 Choose one of the following options:
• Click Add New to create a new list.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
206
Dial Plan
Configure Hunt Pilots
Note For information about wildcards and special characters that you can use for the hunt pilot, see Wildcards and
Special Characters in Hunt Pilots, on page 208.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Route/Hunt > Hunt Pilot.
Step 2 Choose one of the following options:
• Click Add New to create a new hunt pilot.
• Click Find and select an existing hunt pilot.
Step 3 In the Hunt Pilot field, enter the number or pattern that you want to use to route calls.
Step 4 From the Hunt List drop-down, select the hunt list to which you want to direct calls that match the hunt pilot
number.
Step 5 Complete the remaining fields in the Hunt Pilot Configuration window. For help with the fields and their
settings, see the online help.
Step 6 If you want to enable Call Queuing, check the Queue Calls check box and configure the fields in the Queuing
section.
Step 7 Assign any digit transformation patterns that you want to apply to calling, connected or called parties.
Step 8 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
207
Dial Plan
Wildcards and Special Characters in Hunt Pilots
@ The at symbol (@) wildcard The route pattern 9.@ routes or blocks all numbers
matches all National Numbering that the National Numbering Plan recognizes.
Plan numbers.
The following route patterns examples show National
Each route pattern can have only Numbering Plan numbers that the @ wildcard
one @ wildcard. encompasses:
•0
• 1411
• 19725551234
• 101028819725551234
• 01133123456789
X The X wildcard matches any single The route pattern 9XXX routes or blocks all numbers
digit in the range 0 through 9. in the range 9000 through 9999.
! The exclamation point (!) wildcard The route pattern 91! routes or blocks all numbers in
matches one or more digits in the the range 910 through 91999999999999999999999.
range 0 through 9.
? The question mark (?) wildcard The route pattern 91X? routes or blocks all numbers
matches zero or more occurrences in the range 91 through 91999999999999999999999.
of the preceding digit or wildcard
value.
Note If the question mark (??)
wildcard is used, the
second question mark
does not match the
empty input. Example
router pattern:
*33X?*X?*X?#
+ The plus sign (+) wildcard matches The route pattern 91X+ routes or blocks all numbers
one or more occurrences of the in the range 910 through 91999999999999999999999.
preceding digit or wildcard value.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
208
Dial Plan
Performance and Scalability for Hunt Pilots
[] The square bracket ([ ]) characters The route pattern 813510[012345] routes or blocks
enclose a range of values. all numbers in the range 8135100 through 8135105.
- The hyphen (-) character, used with The route pattern 813510[0-5] routes or blocks all
the square brackets, denotes a range numbers in the range 8135100 through 8135105.
of values.
^ The circumflex (^) character, used The route pattern 813510[^0-5] routes or blocks all
with the square brackets, negates a numbers in the range 8135106 through 8135109.
range of values. Ensure that it is the
first character following the
opening bracket ([).
Each route pattern can have only
one ^ character.
. The dot (.) character, used as a The route pattern 9.@ identifies the initial 9 as the
delimiter, separates the Cisco Cisco Unified Communications Manager access code
Unified Communications Manager in a National Numbering Plan call.
access code from the directory
number.
Use this special character, with the
discard digits instructions, to strip
off the Cisco Unified
Communications Manager access
code before sending the number to
an adjacent system.
Each route pattern can have only
one dot (.) character.
* The asterisk (*) character can You can configure the route pattern *411 to provide
provide an extra digit for special access to the internal operator for directory assistance.
dialed numbers.
# The octothorpe (#) character The route pattern 901181910555# routes or blocks an
generally identifies the end of the international number that is dialed from within the
dialing sequence. National Numbering Plan. The # character after the
last 5 identifies this digit as the last digit in the
Ensure the # character is the last
sequence.
character in the pattern.
\+ A plus sign preceded by a Using \+ means that the international escape character
backslash, that is, \+, indicates that + is used as a dialable digit, not as a wildcard.
you want to configure the
international escape character +.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
209
Dial Plan
Hunt Pilot Interactions and Restrictions
• A single Unified CM Subscriber supports a maximum of 100 hunt pilots with call queuing enabled per
node
• Hunt list devices may be a combination of 1500 hunt lists with ten IP phones in each hunt list, 750 hunt
lists with twenty IP phones in each hunt list, or similar combinations
Note When using the broadcast algorithm for call coverage, the number of hunt list
devices is limited by the number of busy hour call attempts (BHCA). Note that
a BHCA of 10 on a hunt pilot pointing to a hunt list or hunt group containing 10
phones and using the broadcast algorithm is equivalent to 10 phones with a BHCA
of 10.
• The maximum number of hunt pilots is 100 per Unified CM subscriber node with call queue enabled
when configured with 32 callers which is allowed in the queue. The total number of queue slots per node
(the value of "Maximum Number of Callers Allowed in Queue" for all Call Queuing Enabled Hunt Pilots
on the node combined) is limited to 3200. The maximum number of simultaneous callers in a queue for
each hunt pilot is 100, meaning 100 callers per hunt pilot is allowed in a queue and the maximum number
of hunt pilots is reduced to 32. The maximum number of members across all hunt lists does not change
when call queuing is enabled.
• The maximum wait time in queue for each hunt pilot that you can configure ranges from 0 to 3600
seconds (default 900). An increase in the number of hunt lists can require you to increase the dial plan
initialization timer that is specified in the Unified Communications Manager service parameters. We
recommend that you set the dial plan initialization timer to 600 seconds if you have 1500 hunt lists
configured.
• We recommend having no more than 35 directory numbers for a single line group when using broadcast
algorithms with call queuing. Additionally, the number of broadcast line groups depends on the busy
hour call completion rate (BHCC). If there are multiple broadcast line groups in a Unified CM system,
the number of maximum directory numbers in a line group must be less than 35. The number of busy
hour call attempts (BHCA) for all the broadcast line groups should not exceed 35 calls set up per second.
Single Number Reach If you have a hunt group configured and one or more of the directory numbers
with Hunt Groups that the hunt group points toward also has Single Number Reach (SNR) enabled,
the call does not extend to the SNR remote destinations unless all devices in the
hunt group are logged in.
For each device within the hunt group, the Logged Into Hunt Group check box
must be checked within the Phone Configuration window for that device.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
210
Dial Plan
Calls Not Being Distributed
Call Queuing Call Queuing is a subfeature of hunt pilots. When call queuing is enabled and
the incoming call requirement to a particular hunt pilot exceeds the number of
hunt members whom are available to answer a call, the system queues incoming
calls until a hunt member is available to answer them. You can configure
announcements and music on hold to play to callers while they are waiting.
For additional configuration details, see the 'Configure Call Queuing' chapter of
the Feature Configuration Guide for Cisco Unified Communications Manager.
Unified Mobility We don’t recommend configuring Unified Mobility devices in Hunt pilot.
Restriction Description
Calls are not being When a call is extended to an agent who is in a logged off state and the call is
distributed correctly in rejected with a different reject type other than the "Huntlogout" type. Then the
Circular algorithm for a index will not get incremented and the call will go to the same agent who had
line group with BOT and answered the previous call.
TCT devices.
Calls are not distributed While distributing the calls in a circular algorithm, when an agent is busy, the
correctly in Circular call is extended to the next available agent (i.e. the next agent will answer the
algorithm for a line group. call on behalf of the busy agent).
Note In the case of multiple calls at the same time, the next available agent
answers the call.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
211
Dial Plan
Calls Not Being Distributed
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
212
CHAPTER 21
Configure Intercluster Lookup Service
• ILS Overview, on page 213
• ILS Configuration Task Flow, on page 214
• ILS Interactions and Restrictions, on page 217
ILS Overview
The Cisco Intercluster Lookup Service (ILS) makes it easy to create a multi-cluster network of remote Cisco
Unified Communications Manager clusters that share data.
ILS eliminates the need for an administrator having to configure connections between clusters manually. Once
you have ILS configured on a hub cluster, you can connect new clusters by enabling ILS on the new cluster
and pointing the new cluster to an existing hub. ILS connects the clusters automatically and lets both clusters
know the topology of the larger ILS network.
Cluster View
The remote cluster view functionality of ILS can be used to map the network. Each cluster exchanges update
messages, called peer info vectors, that inform remote clusters of the status of each cluster in the network.
The update messages contain information about the known clusters in the network, including:
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
213
Dial Plan
ILS Networking Capacities
• Cluster IDs
• Peer IDs for the publisher
• Cluster descriptions and versions
• Fully Qualified Domain Name (FQDN) of the host
• IP addresses and host names for the cluster nodes that have ILS activated
Feature Support
Features such as Global Dial Plan Replication and Extension Mobility Roaming are dependent on ILS to
create intercluster networks where the clusters share dial plan information. This lets you set up intercluster
call networks with video calling, URI dialing, and intercluster mobility.
ILS is also used by Centralized Deployments of the IM and Presence Service if you are connecting the IM
and Presence central cluster to multiple telephony clusters. ILS is used to create the connections between the
IM and Presence central cluster and the telephony clusters.
Note These recommendations are based on system testing and taking resource utilization into account. Although
the system does not prevent you from exceeding these recommendations, by doing so you would risk the
overutilization of resources. Cisco recommends the above capacities for optimal performance.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
214
Dial Plan
Configure Cluster IDs
Procedure
Step 2 Configure ILS, on page 215 Configure and activate ILS in the various
clusters of your network.
Step 3 Verify that ILS is Running, on page 216 Confiirm that the ILS network is up and
running.
Step 4 Configure Remote Cluster View, on page 217 Configure the remote cluster view for your ILS
network.
Procedure
Configure ILS
Use this procedure to activate and configure the Intercluster Lookup Service (ILS) in your network.
Note The first cluster that you configure must be a hub cluster.
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
215
Dial Plan
Verify that ILS is Running
Note When advertising URI patterns (user@domain), in the SIP Profile Configuration window, make
sure that the Dial String Interpretation field is set to Always treat all dial strings as URI addresses
to prevent the devices to dial URI learned patterns with only numbers in the user section as Directory
Number patterns. Alternatively, you can advertise only URI patterns with text strings in the user
section through ILS.
Step 5 Configure ILS Authentication Details between the various clusters in the network:
• For TLS authentication, check the Use TLS Certificates check box. Note that if you choose this option,
you must also exchange CA-signed certificates between the nodes in your cluster.
• For password authentication (regardless of whether TLS is used), check the Use Password check box
and enter the password details.
If you chose to use Transport Layer Security (TLS) authentication between clusters, you must exchange
Tomcat certificates between the publisher node of each cluster in the ILS network. From Cisco Unified
Operating System Administration, use the Bulk Certificate Management feature to:
• Export certificates from the publisher node of each cluster to a central location
• Consolidate exported certificates in the ILS network
• Import certificates onto the publisher node of each cluster in your network
For details, see the "Manage Certificates" chapter of the Administration Guide for Cisco Unified
Communications Manager.
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
216
Dial Plan
Configure Remote Cluster View
Step 3 Check the ILS Clusters and Global Dial Plan Imported Catalogs section. Your ILS network topology
should appear.
Procedure
Step 1 In Cisco Unified CM Administration, choose Advanced Features > Cluster View.
Step 2 In the Find and List Remote Clusters window, choose any previously created remote cluster.
Step 3 From the Remote Cluster Service Configuration window, check the appropriate check box to configure services
such as Extension Mobility Cross Cluster, TFTP, and RSVP Agent for remote clusters.
Step 4 Click Save.
Feature Interaction
Cluster discovery ILS cluster discovery allows Cisco Unified Communications Manager clusters to learn
dynamically about remote clusters without the need for an administrator to manually
configure connections between those clusters.
Each cluster in an ILS network exchange update messages, called peer info vectors, that
are designed to inform remote clusters of the status of each cluster in the network. The
update messages contain information about the known clusters in the network, including:
• Cluster IDs
• Cluster descriptions and versions
• Fully qualified domain name of the host
• IP addresses and hostnames for the cluster nodes that have ILS activated
The ILS cluster discovery feature automatically populates the list of remote clusters that
can be viewed in Cisco Unified CM Administration by choosing Advanced Features >
Cluster View. From this window, you can configure services such as Extension Mobility
Cross Cluster, TFTP, and RSVP Agent for remote clusters.
Note A fully qualified domain name of the remote cluster, as seen in the Cluster
View, must be DNS resolvable for ILS discovery to work.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
217
Dial Plan
ILS Restrictions
Feature Interaction
Global Dial Plan When Global Dial Plan Replication is enabled across an ILS network, remote clusters in
Replication an ILS network share global dial plan data, including the following:
• Directory URIs
• Alternate numbers
• Alternate number patterns
• Route strings
• PSTN failover numbers
Block Inbound To block Inbound calls based on calling party number in an ILS-based network, you must
Calls include the SIP route pattern's partition in the calling party's CSS. For example, if the
call originates from SIP Trunk then SIP trunk inbound CSS must have SIP route pattern's
partition.
ILS Restrictions
Table 22: ILS Restrictions
Restriction Description
ILS Service The ILS Service runs only on the Unified Communications manager publisher node.
Clusters A hub cluster can have many spokes but, a spoke cluster can have only one hub cluster.
ILS Network You cannot connect a third-party call control system into an ILS network.
Cluster Import You can import a third-party catalog into a hub cluster only.
Duplicated URI If a learned ILS cluster contains duplicated URIs from a different remote cluster and
when a call is placed to that URI, it will be routed to the cluster whose URI has been
learned and inserted into the database first.
Database Although the Global dial plan data is exchanged successfully on the ILS Network, an
Replication Status ILS receiving cluster will not write learned information into the database until it
completes its database replication status.
Import For imported third-party directory URIs and patterns, the CSV file format must match
the exact syntax as shown in the administration window sample file otherwise, the
import fails.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
218
Dial Plan
ILS Restrictions
Restriction Description
ILS Hub When adding an additional hub cluster into the ILS network ensure to verify the
following conditions are met for the primary ILS hub node:
• Cluster ID is unique across all the hub nodes in the ILS cluster.
• Fully Qualified Domain Name (FQDN) is configured.
• UDS and EM services are running on the all of the hub nodes in the ILS cluster
• DNS primary and reverse resolution are working fine.
• Import consolidated Tomcat certificates from all the hub nodes.
Else, the "version" information will not get displayed in the Find and List Remote
Clusters window even after rebooting the clusters or correcting the errors. The
workaround is to remove the hub cluster from the ILS network, comply with the above
requirements and add the hub cluster back into the ILS network.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
219
Dial Plan
ILS Restrictions
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
220
CHAPTER 22
Configure Global Dial Plan Replication
• Global Dial Plan Replication Overview, on page 221
• Global Dial Plan Replication Prerequisites, on page 225
• Global Dial Plan Replication Configuration Task Flow, on page 225
• Global Dial Plan Replication Interactions and Restrictions, on page 234
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
221
Dial Plan
URI Dialing
the failover number provides an alternate routing method. In the remote cluster, you must configure route
patterns that route the PSTN failover to an appropriate gateway.
• Route string—Each cluster has a route string that gets replicated with along with the global dial plan
catalog. The route string identifies the home cluster for a directory URI or alternate number. For intercluster
calling, you must configure SIP route patterns in each remote cluster that route the route string back to
its home cluster.
• Learned Global Dial Plan Data—To ensure that replicated data reaches all clusters in the ILS network,
each cluster replicates its locally provisioned global dial plan data, along with catalogs that were learned
from other clusters.
• Imported Global Dial Plan Data— If you are interoperating Cisco Unified Communications Manager
with a Cisco TelePresence Video Communications Server, or a third-party call control system, export
global dial plan data from the other system to a csv file, and then import that csv file into a hub cluster
in the ILS network. Global Dial Plan Replication replicates the imported catalog to other clusters in the
ILS network, allowing you to place calls to directory URIs and alternate numbers that are registered to
the other system.
Note Directory URIs can be assigned to a directory number or to an end user. Directory
URIs that are associated to an end user will also associate to the user's primary
extension (a directory number) and will ring the primary extension, provided it
is assigned.
URI Dialing
URI dialing is a subfeature of Global Dial Plan Replication that allows callers to place calls using directory
URIs as the dial string. A directory URI is an alphanumeric text string that looks like an email addresses (for
example, [email protected]).
Although the URI resembles an email address, a directory URI is not a routable entity by itself. For local
calling, calls to directory URIs can be routed so long as the directory URI is in a partition that is within the
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
222
Dial Plan
Directory URI Format
caller's calling search space. For intercluster calls, the system pulls the cluster route string that was replicated
with Global Dial Plan Replication and tries to match a SIP route pattern to the route string.
The system supports the following formats in the user portion of a directory URI (the portion before the @
symbol):
• Accepted characters are a-z, A-Z, 0-9, !, $, %, &, *, _, +, ~, -, =, \, ?, \, ‘, ,, ., /.
• The user portion has a maximum length of 47 characters.
• Cisco Unified Communications Manager automatically applies percent encoding to the following
characters when the directory URI is saved in the database:
# % ^ ` { } | \ : ” < > [ ] \ ‘ and spaces.
Note The user portion of a directory URI is case sensitive by default. You can edit the user portion to be case
insensitive by editing the URI Lookup Policy enterprise parameter.
Note When you apply percent encoding, the digit length of the directory URI increases. For example, if you input
joe smith#@cisco.com (20 characters) as a directory URI, Cisco Unified Communications Managerstores the
directory URI in the database as joe%20smith%[email protected] (24 characters). Due to database restrictions,
the Directory URI field has a maximum length of 254 characters.
Cisco Unified Communications Manager supports the following formats in the host portion of a directory
URI (the portion after the @ symbol):
• Supports IPv4 addresses or fully qualified domain names.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
223
Dial Plan
Call Routing for Global Dial Plan Replication
• Accepted characters are alphanumeric characters, hyphens (-), and dots (.).
• The host portion cannot start or end with a hyphen (-).
• The host portion cannot have two dots in a row.
• The host portion has a minimum length of two characters.
• The host portion is not case sensitive.
Note Within Cisco Unified Communications Manager Administration, when you use Bulk Administration to
import a CSV file that contains directory URIs with embedded double quotes and commas, you must enclose
the entire directory URI in double quotes (").
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
224
Dial Plan
Global Dial Plan Replication Prerequisites
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
225
Dial Plan
Global Dial Plan Replication Configuration Task Flow
Procedure
Step 2 Configure SIP Profiles, on page 227 Configure SIP settings that support Global Dial
Plan Replication and URI Dialing.
Step 3 Configure SIP Trunks for URI Dialing, on For URI dialing, configure whether the system
page 227 inserts a directory URI, directory number, or
blended address in Contact headers.
Step 4 Configure SIP Route Patterns, on page 228 For intercluster routing, configure SIP route
patterns in each cluster that route the learned
route strings back to their home clusters.
Step 5 Set Database Limits for Learned Data, on page Set the upper limit for the amount of data that
229 ILS can write to the local database.
Step 6 Assign Partitions for Learned Numbers and Assign route partitions for enterprise alternate
Patterns, on page 230 numbers, +E.164 alternate numbers, and
learned number patterns.
Step 7 Set Up Advertised Pattern for Alternate Optional. Advertise a number pattern that
Numbers, on page 230 summarizes a range of enterprise or +E.164
alternate numbers.
Step 8 Block a Learned Pattern, on page 231 Optional. Configure a pattern that blocks calls
to a specific number or number pattern. This
configuration is applied locally, and is not
replicated to the ILS network.
Step 9 Import Global Dial Plan Data, on page 233 Optional. If you are interoperating with a Cisco
TelePresence Video Communications Server
or third-party call control system, import a
catalog of directory URIs, +E.164 Numbers
and PSTN failover numbers from the other
system into a hub cluster in the ILS network.
Step 10 Provision Global Dial Plan Data, on page 231 Assign directory URIs, enterprise alternate
numbers, and +E.164 alternate numbers to a
directory number.
Note For multiple users, use an LDAP
directory sync or Bulk
Administration to assign global dial
plan data for a large number of
users in a single operation. Refer to
the Provisioning Users section of
this guide.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
226
Dial Plan
Enable ILS Support for Global Dial Plan Replication
Procedure
Procedure
Step 1 In Cisco Unified CM Administration, choose Device > Device Settings > SIP Profile.
Step 2 Click Find and select an existing SIP Profile.
Step 3 From the Dial String Interpretation drop-down, configure the policy the system uses to determine whether
to route calls as directory URIs or as directory numbers:
• Always treat all dial strings as URI addresses
• Phone number consists of characters 0–9, A–D, *, and + (others treated as URI addresses).
• Phone number consists of characters 0-9, *, and + (others treated as URI addresses)—This is the default
option.
Step 4 Check the Use Fully Qualified Domain Name in SIP Requests check box.
Step 5 Optional. Under Trunk-Specific Configuration, check the Send ILS Learned Destination Route String
check box if you want to be able to route intercluster calls across a Cisco Unified Border Element.
Step 6 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
227
Dial Plan
Configure SIP Route Patterns
Procedure
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > SIP Route Pattern.
Step 2 Click Add New.
Step 3 From the Pattern Usage drop-down, select Domain Routing.
Step 4 Depending on whether you are deploying IPv4 or IPv6, enter the route string in the IPv4 Address or IPv6
Address text box.
Step 5 Under SIP Trunk/Route List, select a SIP trunk or route list that leads to the next- hop cluster for the route
back to the route string's home cluster.
Step 6 Complete the remaining fields in the SIP Route Pattern Configuration window. For more information on
the fields and their configuration options, see the system Online Help.
Step 7 Click Save.
Step 8 Create SIP route patterns for each learned route string.
Step 9 Repeat these tasks for each cluster in the ILS network.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
228
Dial Plan
Set Database Limits for Learned Data
Note If the SIP Route Pattern name contains dashes, you must ensure that there are no numerical digits between
dashes. However, you can use a combination of letters and numbers or letters only, if there is more than one
dash. Examples of right and wrong SIP Route Patterns are listed in the following:
Correct Patterns:
• abc-1d-efg.xyz.com
• 123-abc-456.xyz.com
Incorrect Patterns :
• abc-123-def.xyz.com
• 1bc-2-3ef.xyz.com
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Service Parameters.
Step 2 Choose the Server where you want to configure the parameter.
Step 3 From the Service drop-down list, choose Cisco Intercluster Lookup Service (Active). If the service does
not appear as active, ensure that the service is activated in Cisco Unified Serviceability.
Step 4 Under Clusterwide Parameters (ILS) section, set an upper limit for the ILS Max Number of Learned
Objects in Database service parameter.
Step 5 Click Save.
Note This service parameter determines the maximum number of entries that Unified Communications Manager
can write to the database for data that is learned through ILS. The default value of the service parameter is
100,000 while the maximum value of the service parameter is 1,000,00
If you reduce the service parameter to a value that is lower than the current number of ILS-learned entries
that are saved in the database, Unified Communications Manager does not write additional ILS learned objects
to the database. However, the existing database entries remain.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
229
Dial Plan
Assign Partitions for Learned Numbers and Patterns
Note You cannot assign a learned number or learned pattern to a NULL partition.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Global Dial Plan Replication > Partitions
for Learned Numbers and Patterns.
Step 2 Configure the fields in the Partitions for Learned Numbers and Patterns window. For more information
on the fields and their configuration options, see the system Online Help.
Step 3 Click Save.
Note The route partition must also exist in the calling search space that is used by the calling party in
order for calls to be placed to numbers in the partition.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Global Dial Plan Replication > Advertised
Patterns.
Step 2 From the Find and List Advertised Patterns window, do either of the following:
• Click Find and select an existing pattern.
• Click Add New to create a new pattern.
Step 3 In the Pattern field, enter the number pattern. For example, 54XXX summarizes a range of numbers between
54000 - 54999.
Step 4 In the Pattern Type field, select the pattern type: Enterprise Number Pattern or E.164 Number Pattern.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
230
Dial Plan
Block a Learned Pattern
Step 5 From the radio buttons, select whether you want to apply a PSTN Failover.
• Don't use PSTN Failover
• Use Pattern as PSTN Failover
• Apply Strip Digits and Prepend Digits to Pattern and Use for PSTN Failover—If you choose this
option, enter the digits in the PSTN Failover Strip Digits and PSTN Failover Prepend Digits fields.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Global Dial Plan Replication > Block
Learned Numbers and Patterns.
Step 2 Perform one of the following tasks:
• Click Find and select an existing blocking rule to edit.
• Click Add New to create a new blocking rule.
Step 3 In the Pattern field, enter the pattern or number that you want to block. For example, 206XXXXXXX can
be used to block calls to 2065551212.
Step 4 If you want to block calls based on the dial string prefix, enter the Prefix.
Step 5 If you want to block calls from being sent to a specific cluster, enter the Cluster ID of the cluster.
Step 6 From the Pattern Type drop-down list, select how you want to apply the blocking rule:
• Any—Choose this option if the blocking rule applies to both enterprise number patterns and +E.164
patterns.
• Enterprise Pattern—Choose this option if the blocking rule applies to enterprise number patterns only.
• +E.164 Pattern—Choose this option if the blocking rule applies to +E.164 number patterns only.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
231
Dial Plan
Provision Global Dial Plan Data
Note If you have a large number of users, configure universal line templates and apply them with provisioning
tools such as LDAP sync or Bulk Administration to provision global dial plan data for a large number of users
in a single operation. See the Provisioning Users section of this book.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Directory Number.
Step 2 Do either of the following:
• Click Find and select an existing directory number for which you want to add global dial plan data.
• Click Add New to create a new directory number.
Step 3 If you are creating a new number, enter the Directory Number and click Save.
Step 4 To add an enterprise alternate number click the the Add an Enterprise Alternate Number button and do
the following:
a) Enter a Number Mask. For example, 5XXXX as an alternate number for 4001. The resulting enterprise
alternate number (54001) displays in the Alternate Number field.
b) Check the Add to Local Route Partition check box to add to a local route partition.
c) From the Route Partition drop-down, select the partition.
d) Check Advertise Globally via ILS if you want this alternate number to be advertised to the ILS network.
Note If you configure an advertised pattern where the enterprise alternate number or +E.164 alternate
number falls within the range of the pattern, then you don't need to advertise the alternate
numbers individually.
Step 5 To add an +E.164 Alternate Number, click the Add an +E.164 Alternate Number and do the following:
a) Enter a Number Mask. For example, 1972555XXXX as an alternate number for extension 4001. The
resulting +E.164 alternate number (19725554001) displays in the Alternate Number field.
b) Check the Add to Local Route Partition check box to add to a local route partition.
c) From the Route Partition drop-down, select the partition.
d) Check Advertise Globally via ILS if you want this alternate number to be advertised to the ILS network.
Step 6 In the Directory URIs section, add directory URIs to this directory number:
a) In the URI field, enter the directory URI. For example, [email protected].
b) From the Partition drop-down, assign the directory URI to a local partition.
c) Check the Advertise Globally via ILS check box to include this directory URI in advertised catalogs.
d) Click Add Row to add additional directory URIs. You can add up to five directory URIs.
Step 7 In the Advertised Failover Number field, select either the Enterprise Alternate Number or +E.164 Alternate
Number as a PSTN failover.
Step 8 Configure the remaining fields in the Directory Number Configuration window. For more information on
the fields and their configuration options, see the system Online Help.
Step 9 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
232
Dial Plan
Import Global Dial Plan Data
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Global Dial Plan RepIication > Imported
Global Dial Plan Catalog.
Step 2 From the Find and List Imported Global Dial Plan Catalogs window, perform one of the following tasks:
• Click Find and select an existing catalog from the resulting list.
• Click Add New to add a new catalog.
Step 3 From the Imported Global Dial Plan Catalog Settings window, in the Name field, enter a unique name to
identify the catalog that you want to import.
Step 4 (Optional) In the Description field, enter a description of the catalog.
Step 5 In the Route String field, create a route string for the system from which you are importing the catalog.
Note Route strings can be up to 250 alphanumeric characters long and can include dots and dashes.
Step 8 In the Select the Target drop-down list, select Imported Directory URIs and Patterns.
Step 9 In the Select Transaction Type drop-down list, select Insert Imported Directory URIs and Patterns.
Step 10 Click Save.
Step 11 From Cisco Unified CM Administration, choose Bulk Administration > Directory URIs and Patterns >
Insert Imported Directory URIs and Patterns.
Step 12 In the File Name drop-down list, choose the CSV file that contains the catalog that you want to import.
Step 13 In the Imported Directory URI Catalog drop-down list, choose the catalog that you named in the Imported
Global Dial Plan Catalog window.
Step 14 In the Job Description text box, enter a name for the job that you are about to run.
Step 15 Perform one of the following steps:
• If you want to run the job now, select the Run Immediately option, and click Submit.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
233
Dial Plan
Global Dial Plan Replication Interactions and Restrictions
• If you want to schedule the job to run at a specified time, select the Run Later radio button and click
Submit.
Note If you choose the Run Later option, you must use the Bulk Administration Job Scheduler to schedule
when the job runs.
Cisco Unified Communications Manager saves all imported +E.164 patterns to the Global Learned +E.164
Patterns partition.
Note You can also export all locally configured directory URIs, +E.164 number patterns, and their associated PSTN
failover rules to a CSV file that you can import into the other call control system. Refer to the menus at Bulk
Administration > Directory URIs and Patterns > Export Local Directory URIs and Patterns for details.
Export Directory URIs You can also export all directory URIs and +E.164 number patterns that were
and +E.164 Patterns configured in the local cluster, and export them to a csv file that you can import
into another system.
1. In Cisco Unified CM Administration, choose Bulk Adminstration >
Directory URIs and Patterns > Export Local Directory URIs and
Patterns.
2. Click one of the following radio buttons to define the domain name that you
want to attach to the export file:
• Organizational Top Level Domain—Click this radio button to use the
value of the Organizational Top Level Domain enterprise parameter for
the export file domain name.
• Route String Domain—Click this radio button to use the value of the
Route String field, as configured in ILS Configuration, for the export
file domain name.
• User Defined Domain—Click this radio button to create a customized
domain name to attach to the export file. If you choose this option, enter
the domain name in the Domain Name text box.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
234
Dial Plan
Global Dial Plan Replication Interactions and Restrictions
Partitioning with URI Partitioning with directory URIs depends on how you provision the directory
Dialing URI.
• For user-based directory URIs that are assigned to an end user in End User
Configuration, the local nondeletable Directory URI partition is assigned
to the URI automatically. You cannot assign another partition, but you can
use an administrator-managed partition as an alias for the local Directory
URI partition by configuring the Directory URI Alias Partition enterprise
parameter.
• For line-based directory URIs where the URI is assigned directly to a
directory number in Directory Number Configuration, you can assign
each URI to a local partition separately.
If you are using tools like LDAP sync and Bulk Administration to provision
directory URIs:
• Directory URIs that are provisioned via an LDAP sync are user-based and
get assigned to the user in End User Configuration. These URIs are
assigned to the local Directory URI partition. If the user has a primary
extension, the URI also appears in Directory Number Configuration as
the Primary URI. However, the assigned partition is the Directory URI
partition.
• For directory URIs that are provisioned via Bulk Administration, it depends
on how your updates are applied. For example, if you use the bat.xlt
spreadsheet to create a csv import file, the user will be a user-based URI if
you use the Users or Update Users tabs on the spreadsheet to add the
directory URI. However, if you add the directory URI via the Line Fields
options that appear when you click Create File Format, you can assign the
URI to a directory number and assign a local partition to the URI directly.
Directory URI Case By default, the user portion of a directory URI (the portion before the @) is case
Sensitivity sensitive. You can make the user portion case insensitive by editing the URI
Lookup Policy enterprise parameter.
Calling Search Space To be dialable, directory URIs, enterprise alternate numbers, and +E.164 alternate
numbers must be in a partition that is available in the calling party's calling search
space.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
235
Dial Plan
Global Dial Plan Replication Interactions and Restrictions
Digit Transformations If you use digit transformations, and you are deploying intercluster URI dialing,
with URI dialing apply digit transformations against either the phone configuration or against the
device pool that the phone uses.
• For individual phones, apply the transformation to the Calling Party
Transformation CSS field in the Remote Number section.
• For device pools, you can apply the transformation against the Calling Party
Transformation CSS field under Device Mobility Related Information.
Note For roaming devices, the device pool setting overrides the phone
configuration even if the Use Device Pool Calling Party
Transformation CSS check box is unchecked in the Phone
Configuration window.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
236
CHAPTER 23
Calling Party Normalization
• Calling Party Normalization Overview, on page 237
• Calling Party Normalization Prerequisites, on page 238
• Calling Party Normalization Configuration Task Flow, on page 238
• Calling Party Normalization Interactions and Restrictions, on page 242
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
237
Dial Plan
Calling Party Normalization Prerequisites
and prefix instructions specific to the calling party number type for that call. This allows Cisco Unified
Communications Manager to reformat the calling party number such that the calling party number that displays
on the called phone is a localized number that does not include unnecessary country codes and international
access codes.
For example, assume an incoming number arrives from the PSTN with a globalized number of +49 40
69XXXXXXX where +49 represents the country code, 40 represents the city code, and the calling party
number type is Subscriber. Cisco Unified Communications Manager can be configured with a calling party
transformation pattern, along with instructions to strip the country code, city code, and add a prefix of 0. After
the instructions are applied, the calling party number displays in the dialed phone as 069XXXXXXX.
Note Calling Party Transformation works only with the original calling party. Any modifications done for redirecting
numbers affect only the diversion header. Review your configuration from the SIP trunk chapter, and add a
diversion header on the SIP trunk itself.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
238
Dial Plan
Globalize Calling Party Numbers
Procedure
Step 2 Globalize Calling Party Numbers, on page 239 For incoming calls that arrive through the
PSTN, configure settings that will globalize
calling party numbers.
Step 3 Set up Calling Search Spaces, on page 240 Set up your partitions and calling search spaces.
Step 4 Create Calling Party Transformation Patterns, Create calling party transformation patterns that
on page 240 transform the calling party number to a
globalized or localized version and assign each
pattern to a partition.
Step 5 Apply Calling Party Transformation Patterns Apply the incoming Calling Party
to a Calling Search Space, on page 241 Transformation CSS to your devices such as
device pools, gateways, and trunks
Procedure
Step 1 If you want to apply calling party normalization settings to particular devices, perform the following steps:
a) Open the configuration window for the device on which you want to apply settings. For example, device
pools, gateways, phones, and trunks.
b) In the Incoming Calling Party Settings section for the configuration window, apply prefix and strip digit
instructions for each calling party number type.
Note Cisco Unified Communications Manager includes the prefix in the calling party number field
for all additional actions, such as supplementary services including call forwarding, call park,
voice messaging, and CDR data that pertain to the call.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
239
Dial Plan
Set up Calling Search Spaces
Step 2 If you want to use service parameters to globalize calling party numbers on all devices clusterwide, perform
the following steps:
a) From Cisco Unified CM Administration, choose System > Service Parameters.
b) From the Server drop-down list, select the server on which you want the service to run.
c) From the Service drop-down list, select Cisco CallManager.
d) Click Advanced.
e) Configure values for the following parameters, which can be applied on a clusterwide basis to phones,
MGCP gateways, or H.323 gateways:
• Incoming Calling Party National Number Prefix
• Incoming Calling Party International Number Prefix
• Incoming Calling Party Unknown Number Prefix
• Incoming Calling Party Subscriber Number Prefix
Note In order for Cisco Unified Communications Manager to apply the clusterwide service parameter
settings on a particular phone, the prefix setting for that phone must be set to the default option at
both the device and device pool levels.
Procedure
Step 1 In Cisco Unified CM Administration, choose Call Routing > Class of Control > Partitions.
Step 2 Create partitions for your network.
Step 3 In Cisco Unified CM Administration, choose Call Routing > Class of Control > Calling Search Space.
Step 4 Create calling search spaces for your calling party transformation patterns.
Step 5 For each calling search space, assign partitions to the calling search spaces
Procedure
Step 1 In Cisco Unified CM Administration, choose Call Routing > Transformation Pattern > Calling Party
Transformation Pattern.
Step 2 Create transformation patterns.
Step 3 For each calling party transformation pattern that you create, assign prefixes or strip digits commands that
will globalize or localize the calling party number.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
240
Dial Plan
Apply Calling Party Transformation Patterns to a Calling Search Space
Step 4 For each calling party transformation pattern, assign a partition that is associated to one of your calling search
spaces.
Procedure
Step 1 In Cisco Unified CM Administration, choose the configuration window that applies to the device on which
you want to apply calling party transformations.
• Gateways
• Trunks
• Device Pools
Step 2 To localize calling party numbers, in the Calling Search Space drop-down list box, choose the CSS that
contains the calling party transformation pattern that you want to apply.
Note If you configure the CSS against the Device Pool, you must also apply that device pool to your
phones.
Step 3 To globalize calling party numbers, in the Incoming Calling Party Settings section, choose the calling search
space that contains the calling party transformation pattern that you want to apply.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
241
Dial Plan
Calling Party Normalization Interactions and Restrictions
Feature Interaction
Transferred Calls Calling Party Normalization may not be supported for some transferred call
scenarios because the transfer feature relies on midcall updates and calling
party normalization occurs during initial call setup for each call hop. Following
is one example of how calling party normalization can work for transfer.
Phone A with extension 12345 and phone number of 972 500 2345 calls Phone
B with extension 54321 and phone number 972 500 4321. On Phone B, the
calling party number 12345 displays, but Phone B transfers the call through
a San Jose gateway to Phone C. During the initial transfer, Phone C displays
a calling party number of 972 500 4321, but after the transfer completes, Phone
C displays the calling party number for Phone A as 12345.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
242
Dial Plan
Calling Party Normalization Interactions
Feature Interaction
Forwarded Calls Forwarded calls support globalization and localization of calling party numbers.
For example, a caller with Phone F calls Phone G in Dallas through the PSTN,
but Phone G has forwarded calls to Phone H in San Jose. On the incoming
Dallas gateway the calling party number displays as 555-5555/Subscriber, but
the call is forwarded to a San Jose gateway. The outgoing call from Dallas
displays as 972 555 5555. On the incoming San Jose gateway the +1 is prefixed
and Phone F displays a calling number of +1 972 555 5555.
Call Detail Records For details of how calling party normalization works with CDR records, see
the Cisco Unified Communications Manager Call Detail Records
Administration Guide.
Cisco Unity Connection Cisco Unity Connection does not support the international escape character
(+). Therefore, you must ensure that calls to Cisco Unity Connection do not
contain the +, so that voice-messaging features work as expected.
For Cisco Unity Connection to work as expected, treat this application as a
device and configure calling party transformations that ensure that the + does
not get sent to this voice-messaging application. If the Cisco Unity Connection
server uses a North American-based dial plan, localize the calling party number
to NANP format before Cisco Unity Connection receives the calling party
number. Because no calling party transformation options exist in Cisco Unified
Communications Manager Administration for voice-messaging ports, make
sure that you configure the calling party number transformations in the device
pool that is associated with the voice-messaging ports. To localize the calling
party number, also consider adding prefixes for access codes so that the
voice-messaging application easily can redial the number for certain features,
such as Live Reply. For example, you can convert +12225551234 to
912225551234, and you can convert international number, +4423453456, to
include the international escape code, 90114423453456.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
243
Dial Plan
Calling Party Normalization Restrictions
Feature Interaction
Device Mobility The Calling Party Transformation CSS of the roaming device pool overrides
the device-level configuration of the phone roaming within same Device
Mobility Group, even when the Use Device Pool Calling Party Transformation
CSS check box in the phone configuration window remains unchecked.
The following examples demonstrate how calling party normalization works
with device mobility for a phone with a home location of Dallas which is
currently roaming in San Jose.
When the phone is roaming in San Jose, a call comes through the PSTN from
972 500 1212 <National> in Dallas. On the incoming San Jose gateway, the
calling party number gets converted to the global format of + 1 408 500 1212.
On the phone that currently is in San Jose, the calling party number displays
as 1 972 500 1212.
When the phone is roaming in San Jose, a call comes through the PSTN from
500 1212 <Subscriber> from a seven-digit dialing area in San Jose. On the
incoming San Jose gateway, the calling party number gets converted to the
global format of + 1 408 500 1212. On the phone that currently is in San Jose,
the calling party number displays as 9 500 1212.
Feature Restriction
Share lines The calling party number that displays for a shared line depends on the
sequence of call control events in Cisco Unified Communications
Manager. To avoid displaying an incorrect localized calling party number
on a shared line, especially when the shared line occurs in different
geographical locations, make sure that you configure the same Calling
Party Transformation CSS for different devices that share the same line.
SIP trunks and MGCP gateways SIP trunks and MGCP gateways can support sending the international
escape character, (+) for calls. H.323 gateways do not support the +.
QSIG trunks do not attempt to send the +. For outgoing calls through a
gateway that supports +, Cisco Unified Communications Manager can
send the + with the dialed digits to the gateway. For outgoing calls
through a gateway that does not support +, the international escape
character + gets stripped when Cisco Unified Communications Manager
sends the call information to the gateway.
SIP SIP does not support the number type, so calls through SIP trunks support
only the Incoming Number settings for calling party number types of
Unknown.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
244
Dial Plan
Calling Party Normalization Restrictions
Feature Restriction
Calling Party Transformation CSS For localizing the calling party number, the device must apply the
transformation by using digit analysis. If you configure the Calling Party
Transformation CSS as None, the transformation does not match and
does not get applied. Ensure that you configure the Calling Party
Transformation Pattern in a non-null partition that is not used for routing.
T1-CAS and FXO ports The Calling Party Transformation CSS settings do not apply to T1-CAS
and FXO ports on the gateway.
Cisco Unity Connection CiscoUnity Connection does not support the international escape
character (+). Therefore, you must ensure that calls to CiscoUnity
Connection do not contain the +, so that voice-messaging features work
as expected.
For detailed information on Cisco Unity Connection, go to
http://www.cisco.com/c/en/us/products/unified-communications/
unity-connection/index.html.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
245
Dial Plan
Calling Party Normalization Restrictions
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
246
CHAPTER 24
Configure Dial Rules
• Dial Rules Overview, on page 247
• Dial Rules Prerequisites, on page 247
• Dial Rules Configuration Task Flow, on page 248
• Dial Rules Interactions and Restrictions, on page 253
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
247
Dial Plan
Dial Rules Configuration Task Flow
Note Cisco Unified Communications Manager automatically applies application dial rules to all remote destination
numbers for CTI remote devices.
Perform the following procedure to add a new application dial rule or update an existing application dial rule.
Procedure
Step 1 From Cisco Unified Communications Manager Administration, choose Call Routing > Dial Rules >
Application Dial Rules.
Step 2 In the Find and List Application Dial Rules window, perform one of the following steps:
• Click Add New.
• Click Find and choose an existing application dial rule.
Step 3 Configure the fields in the Application Dial Rule Configuration window. For detailed field descriptions,
refer to the online help.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
248
Dial Plan
Configure Directory Lookup Dial Rules
What to do next
Perform the following tasks:
• Configure Directory Lookup Dial Rules, on page 249
• Configure SIP Dial Rules, on page 249
Procedure
Step 1 From Cisco Unified Communications Manager Administration, choose Call Routing > Dial Rules > Directory
Lookup Dial Rules.
Step 2 In the Directory Lookup Dial Rule Find and List window Directory Lookup Dial Rule Find and List
window, perform one of the following steps:
• Click Add New.
• Click Find and choose an existing directory lookup dial rule.
Step 3 Configure the fields in the Directory Lookup Dial Rule Configuration window. For detailed field descriptions,
refer to the online help.
Step 4 Click Save.
What to do next
Configure SIP Dial Rules, on page 249
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
249
Dial Plan
Pattern Formats
Procedure
Step 2 Reset SIP Dial Rule, on page 251 Reset or restart the phone that is running SIP
when the SIP dial rule gets updated, so that the
phone is updated with the new SIP dial rule.
Step 3 Synchronize SIP Dial Rules Settings With SIP (Optional) Synchronize a SIP phone with a SIP
Phones, on page 252 dial rule that has undergone configuration
changes, which applies any outstanding
configuration settings in the least intrusive
manner possible. For example, a reset or restart
may not be required on some affected SIP
phones.
Related Topics
Pattern Formats, on page 250
Pattern Formats
Table 25: Pattern Formats for SIP Dial Rules
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
250
Dial Plan
Set Up SIP Dial Rule
Procedure
Step 1 From Cisco Unified Communications Manager Administration, choose Call Routing > Dial Rules > SIP
Dial Rules.
Step 2 In the Find and List SIP Dial Rules window. Perform one of the following steps:
• Click Add New
• Click Find and choose an existing SIP Dial Rule
Step 3 Configure the fields in the SIP Dial Rule Configuration window. For detailed field descriptions, refer to the
online help.
Step 4 Click Save.
Note When you add or update a SIP dial rule in Cisco Unified Communications Manager Administration,
be aware that the Cisco TFTP service rebuilds all phone configuration files, which may cause CPU
to spike on the server where the Cisco TFTP service runs, especially if you have a large system
with many phones. To ensure that CPU does not spike, add or update the SIP dial rule during a
maintenance window or temporarily stop the Cisco TFTP service in Cisco Unified Serviceability
before you make the configuration change. If you stop the Cisco TFTP service, remember to restart
the service in Cisco Unified Serviceability after you add or update the SIP dial rule.
What to do next
Reset SIP Dial Rule, on page 251
Related Topics
Pattern Formats, on page 250
Procedure
Step 1 From Cisco Unified Communications Manager Administration, choose Call Routing > Dial Rules >
Application Dial Rules.
Step 2 In the Find and List SIP Dial Rules window, click Find and choose an existing SIP dial rule that you want
to reset.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
251
Dial Plan
Synchronize SIP Dial Rules Settings With SIP Phones
What to do next
Synchronize SIP Dial Rules Settings With SIP Phones, on page 252
Procedure
Step 1 From Cisco Unified Communications Manager Administration, choose Call Routing > Dial Rules > SIP
Dial Rules.
Step 2 In the Find and List SIP Dial Rules window, click Find and choose an existing SIP dial rule to which you
want to synchronize applicable SIP phones.
Step 3 Make any additional configuration changes and click Save in the SIP Dial Rule Configuration.
Step 4 Click Apply Config.
Step 5 Click OK.
Procedure
Step 1 From Cisco Unified Communications Manager Administration, choose Call Routing > Dial Rules.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
252
Dial Plan
Dial Rules Interactions and Restrictions
Step 3 In the Find and List window, choose a dial rule and click the dial rule name.
The Dial Rule Configuration window appears.
Step 4 Use the up and down arrows to move the dial rule up or down the list.
Step 5 After you complete prioritizing the order, click Save.
7911, 7941, 7961, 7970, and 7971 that are running These phones use the 7940_7960_OTHER dial rules
SIP patterns. Key Press Markup Language (KPML) allows
for the digits to be sent to Cisco Unified
Communications Manager digit by digit; SIP dial rules
allow for a pattern of digits to be collected locally on
the phone prior to sending to Cisco Unified
Communications Manager. If SIP dial rules are not
configured, KPML is used. To increase the
performance of Cisco Unified Communications
Manager (increasing the number of calls that get
processed), Cisco recommends that administrators
configure SIP dial rules.
7940 and 7960 that are running SIP These phones use the 7940_7960_OTHER dial rules
pattern and do not support KPML. If the administrator
does not configure a SIP dial plan for these phones,
the user must wait a specified time before the digits
are sent to Cisco Unified Communications Manager
for processing. This delays the processing of the actual
call.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
253
Dial Plan
Directory Lookup Dial Rules Restrictions
Field Restriction
Number Begins With This field supports only digits and the characters +,*,
and #. The length cannot exceed 100 characters.
Number of Digits This field supports only digits, and the value in this
field cannot be less than the length of the pattern that
is specified in the pattern field.
Total Digits to be Removed This field supports only digits, and the value in this
field cannot be more than the value in the Number
of Digits field.
Prefix with Pattern The prefix it with field supports only digits and the
characters +,*, and #. The length cannot exceed 100
characters.
Note You cannot allow both the Total Digits to
be Removed field and the Prefix with
Pattern field to be blank for a dial rule.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
254
PA R T III
Integrate Applications
• Integrate Cisco Applications, on page 257
• Configure CTI Applications, on page 265
CHAPTER 25
Integrate Cisco Applications
• Cisco Unity Connection, on page 257
• Cisco Expressway, on page 259
• Cisco Emergency Responder, on page 260
• Cisco Paging Server, on page 261
• Cisco Unified Contact Center Enterprise, on page 261
• Cisco Unified Contact Center Express, on page 261
• Advanced QoS APIC-EM Controller, on page 262
• Configure Cisco WebDialer Servers, on page 262
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
257
Integrate Applications
Enable PIN Synchronization
• Identified user messaging (Cisco Unity Connection automatically identifies a user who leaves a message
during a forwarded internal call, based on the extension from which the call originated)
• Message waiting indication (MWI)
• The configuration of a secure SIP trunk integration between a Cisco Unified Communications Manager
and Cisco Unity Connection server requires that the Cisco Unified Communications Manager cluster is
configured in mixed mode.
Cisco Unified Communications Manager interacts with Cisco Unity Connection through one of the following
interfaces:
• SIP Trunk—You can integrate Cisco Unity Connection and Unified Communications Manager by using
SIP. Instead of multiple SCCP ports involved with traditional integrations, SIP uses a single trunk per
Unity Connection server. The SIP integration eliminates the requirement to configure directory numbers
for Voicemail Ports and message-waiting indicators (MWI).
• SCCP Protocol—You configure the interface to directly connected voice-messaging systems by creating
voicemail ports. These establish a link between Unified Communications Manager and Cisco Unity
Connection.
To handle multiple, simultaneous calls to a voice-messaging system, you create multiple voicemail ports
and place the ports in a line group and the line group in a route/hunt list.
Cisco Unified Communications Manager generates SCCP messages, which are translated by Cisco Unity
Connection. The voicemail system sends message-waiting indications (MWIs) by calling a
message-waiting on and off number.
When you configure security for voicemail ports and Cisco Unity SCCP devices, a TLS connection
(handshake) opens for authenticated devices after each device accepts the certificate of the other device;
likewise, the system sends SRTP streams between devices; that is, if you configure the devices for
encryption.
When the device security mode is set to authenticated or encrypted, the Cisco Unity TSP connects to
Cisco Unified Communications Manager through the Unified Communications Manager TLS port. When
the security mode is nonsecure, the Cisco Unity TSP connects to Cisco Communications Manager through
the Unified Communications Manager SCCP port.
For more information about configuring Cisco Unity Connection to integrate with your system, see the Cisco
Unified Communications Manager SCCP Integration Guide for Cisco Unity Connection or the Cisco Unified
Communications Manager SIP Trunk Integration Guide for Cisco Unity Connection at http://www.cisco.com/
c/en/us/support/unified-communications/unity-connection/
products-installation-and-configuration-guides-list.html.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
258
Integrate Applications
Cisco Expressway
Note The pin synchronization between Cisco Unity Connection and Cisco Unified Communications Manager is
successful, only when Cisco Unified Communications Manager publisher database server is running and
completes its database replication. Following error message is displayed when the pin synchronization fails
on Cisco Unity Connection: Failed to update PIN on CUCM. Reason: Error getting
the pin.
If the PIN Synchronization is enabled and the end user changes the pin, then pin is updated in Cisco Unified
Communications Manager. This happens only when the pin update is successful in at least one of the configured
Unity Connection Application servers.
Note For PIN Synchronization to take effect, administrators must force the users to change their PIN after successfully
enabling the feature.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Application Servers.
Step 2 Select the application server that you set up for Cisco Unity Connection.
Step 3 Check the Enable End User PIN Synchronization check box.
Step 4 Click Save.
Related Topics
Configure Application Servers
Cisco Expressway
Cisco Unified Communications Manager integrates with Cisco Expressway to provide Cisco Unified
Communications Mobile and Remote Access. Cisco Unified Communications Mobile and Remote Access is
a core part of the Cisco Collaboration Edge Architecture. It allows endpoints such as Cisco Jabber to have
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
259
Integrate Applications
Cisco Emergency Responder
their registration, call control, provisioning, messaging and presence services provided by Cisco Unified
Communications Manager (Unified CM) when the endpoint is not within the enterprise network. The
Expressway provides secure firewall traversal and line-side support for Unified CM registrations.
The overall solution provides the following functions:
• Off-premises access—A consistent experience outside the network for Cisco Jabber and EX/MX/SX
Series clients
• Security—Secure business-to-business communications
• Cloud services—Enterprise grade flexibility and scalable solutions providing rich Webex integration
and Service Provider offerings
• Gateway and interoperability services—Media and signaling normalization, and support for non-standard
endpoints.
For deployment details, refer to the Mobile and Remote Access Through Cisco Expressway Deployment Guide
at https://www.cisco.com/c/en/us/support/unified-communications/expressway-series/
products-installation-and-configuration-guides-list.html.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
260
Integrate Applications
Cisco Paging Server
For more information and documentation on Cisco Paging Server, see https://www.cisco.com/c/en/us/products/
unified-communications/paging-server/index.html.
Configuration
For details on how to configure Cisco Unified Communications Manager for Basic Paging or Advanced
Notifications, see the "Paging" chapter of the Feature Configuration Guide for Cisco Unified Communications
Manager.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
261
Integrate Applications
Advanced QoS APIC-EM Controller
When the agent picks up, relative call context is provided in the agent’s desktop application. This step ensures
that agents have the proper information in front of them to support the customer.
For detailed tasks about how to configure Unified CCX to integrate with your system, see the Cisco Unified
CCX Administration Guide at http://www.cisco.com/c/en/us/support/customer-collaboration/
unified-contact-center-express/products-installation-and-configuration-guides-list.html.
Configuration Details
For additional details, including information on how to configure Cisco Unified Communications Manager
to integrate with an APIC_EM Controller, refer to the "Configure QoS with APIC-EM Controller" chapter
of the Feature Configuration Guide for Cisco Unified Communications Manager.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Application Server.
Step 2 Click Add New.
Step 3 From the Application Server Type drop-down list, choose Cisco Web Dialer, and then click Next.
Step 4 In the Hostname or IP Address field, enter the hostname or IP address of the WebDialer server.
Step 5 From the Redirector Node drop-down list, choose < None > or a specific Unified Communications Manager
node.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
262
Integrate Applications
Configure Cisco WebDialer Servers
< None > indicates the WebDialer Server would apply to all nodes.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
263
Integrate Applications
Configure Cisco WebDialer Servers
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
264
CHAPTER 26
Configure CTI Applications
• CTI Applications Overview, on page 265
• CTI Applications Prerequisites, on page 267
• Configure CTI Applications Task Flow, on page 267
Note To determine which Unified Communications Manager CTI applications support SIP IP phones, see the
application-specific documentation.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
265
Integrate Applications
CTI Route Points Overview
Note The applications do not rehome to the primary CTIManager when it comes back in service. Applications fail
back to the primary CTIManager if you restart the application or if the backup CTIManager fails.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
266
Integrate Applications
CTI Applications Prerequisites
configured call forward on failure (CFOF) number. The CTIManager also routes subsequent calls into those
CTI ports and route points to the configured Call Forward No Answer (CFNA) number until the application
recovers and reregisters those devices.
Procedure
Step 2 Configure CTIManager and Cisco Unified Configure CTIManager advanced clusterwide
Communications Manager Service Parameters, service parameters that are used in conjunction
on page 268 with the CTI Super Provider capability.
Step 3 To configure CTI Route Points perform the Configure one or more CTI route point virtual
following procedure: devices which can receive multiple,
simultaneous calls for application-controlled
• Configure CTI Route Points, on page 269
redirection.
• Configure New Call Accept Timer, on
page 269
• Configure Simultaneous Active Calls, on
page 270
• Synchronize CTI Route Point, on page 270
Step 4 Configure CTI Device Directory Number, on Configure the directory number for the CTI
page 271 device.
Step 5 Associate Devices with Groups, on page 271 Associate all devices that the application will
use for application users and end users with the
appropriate Cisco Unified Communications
Manager group (via the device pool).
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
267
Integrate Applications
Activate the CTIManager Service
Step 7 (Optional) Configure CTI Redundancy for To define the interval at which CTIManager
Application Failure, on page 272 expects to receive a message from an
application within two consecutive intervals.
Note If the configured limits are exceeded, CTI generates alarms, but the applications continue to operate with the
extra devices.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Service Parameters.
Step 2 Choose the node from the Server drop-down list.
Step 3 Choose Cisco CTIManager (Active) from the Service drop-down list.
Step 4 On the Service Parameter Configuration window, click Advanced.
Step 5 In the Maximum Devices Per Provider field, enter the maximum number of devices that a single CTI
application can open. The default is 2000 devices.
Step 6 In the Maximum Devices Per Node field, enter the maximum number of devices that all CTI applications can
open on any CTIManager node in the Unified Communications Manager system. The default is 800 devices.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
268
Integrate Applications
Configure CTI Route Points Task Flow
Step 2 Configure New Call Accept Timer, on page 269 Configure the New Call Accept Timer so that
when a call arrives at a route point, the
application will handle (accept, answer, redirect)
it within the time specified.
Step 3 Configure Simultaneous Active Calls, on page Configure the number of simultaneous active
270 calls on the route point.
Step 4 Optional: Synchronize CTI Route Point, on Synchronize a CTI route point with the most
page 270 recent configuration changes, which applies any
outstanding configuration settings in the least
intrusive manner possible. (For example, a
reset/restart may not be required on some
affected devices.)
Procedure
Step 1 From Cisco Unified CM Administration, click Device > CTI Route Point.
Step 2 Perform one of the following tasks:
• Click Add New, to add a new gateway.
• Click Find and select a CTI route point from the resulting list to modify the settings for an existing CTI
route point, enter search criteria.
Step 3 Configure the fields in the CTI Route Point Configuration window. For more information on the fields and
their configuration options, see the system Online Help..
Step 4 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
269
Integrate Applications
Configure Simultaneous Active Calls
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Service Parameters.
Step 2 Choose the node from the Server drop-down list.
Step 3 Choose Cisco CallManager (Active) from the Service drop-down list.
Step 4 In the CTI New Call Accept Timer field, specify the time that you want to allow for a call to be answered.
The default value is 4.
Step 5 Click Save.
Note If you are planning to use a TAPI application to control CTI port devices by using the Cisco CallManager
Telephony Service Provider (TSP), you may only configure one line per CTI port device.
Procedure
Step 1 From Cisco Unified CM Administration, click Call Routing > Directory Number.
Step 2 On the Directory Number Configuration window, click Add New.
Step 3 Fill in the required fields.
Step 4 Click Save.
Procedure
Step 1 From Cisco Unified CM Administration, click Device > CTI Route Point.
Step 2 On the Find and List CTI Route Points window, click Find to display the list of CTI route points.
Step 3 Check the check boxes next to the CTI route points that you want to synchronize. To choose all CTI route
points in the window, check the check box in the matching records title bar.
Step 4 Click Apply Config to Selected.
Step 5 Click OK.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
270
Integrate Applications
Configure CTI Device Directory Number
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Directory Number.
Step 2 On the Find and List Directory Numbers window, click Add New.
Step 3 On the Directory Number Configuration window, and enter the required fields.
Step 4 Click Save.
Procedure
Step 1 From Cisco Unified CM Administration, click User Management > Application User.
Step 2 On the Find and List Application Users window, click Add New. This brings you to the Application User
Configuration window.
Step 3 In the Device Information pane, associate your devices by moving them from the Available Devices list to
the Controlled Devices list.
Step 4 Click Save.
Step 5 To Associate Devices for end users, click User Management > End User.
Step 6 Repeat steps 2 - 4.
Procedure
Step 1 From Cisco Unified CM Administration, click User Management > User Settings > Access Control Group.
Step 2 On the Find and List Access Control Groups window, click Find to display the current list of access control
groups.
Step 3 Click Standard CTI Enabled, this brings you to the Access Control Group Configuration window for this
group. Ensure all CTI users are in the Standard CTI Enabled user group. See Access Control Group
Configuration Options, for a full list of available groups and their capabilities.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
271
Integrate Applications
Access Control Group Configuration Options
Step 4 If you want to add end users, click Add End Users to Group or, if you want to add application users, click
Add App Users to Group.
Step 5 Click Find, to display the list of current users.
Step 6 Check the users you want to assign to the Standard CTI Enabled user group.
Step 7 Click Add Selected.
Note The CTI application must support the specified user group to which it is assigned.
Note Cisco recommends that users who are associated with the Standard CTI Allow Control of All Devices user
group also be associated with the Standard CTI Secure Connection user group.
Field Description
Standard CTI Allow Call Monitoring This user group allows an application to monitor calls.
Standard CTI Allow Call Park This user group allows an application to receive a notification when
Monitoring calls are parked/unparked to all Call Park directory numbers.
Standard CTI Allow Call Recording This user group allows an application to record calls.
Standard CTI Allow Calling Number This user group allows an application to modify the calling party
Modification number in supported CTI applications.
Standard CTI Allow Control of All This user group allows an application to control or monitor any
Devices CTI-controllable device in the system.
Standard CTI Allow Reception of This user group allows an application to receive information that is
SRTP Key Material necessary to decrypt encrypted media streams. This group typically
gets used for recording and monitoring purposes.
Standard CTI Enabled This user group, which is required for all CTI applications, allows an
application to connect to Cisco Unified Communications Manager
and to access CTI functionality.
Standard CTI Secure Connection Inclusion into this group requires that the application has a secure
(TLS) CTI connection to Cisco Unified Communications Manager
and that the Cisco Unified Communications Manager cluster has
security enabled.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
272
Integrate Applications
Configure CTI Redundancy for Application Failure
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Service Parameters.
Step 2 Choose the node from the Server drop-down list.
Step 3 Choose Cisco CTIManager (Active) from the Service drop-down list.
Step 4 On the Service Parameter Configuration window, click Advanced.
Step 5 In the Application Heartbeat Minimum Interval field, enter the time for the minimum interval. The default
is 5.
Step 6 In the Application Heartbeat Maximum Interval field, enter the time for the maximum interval. The default
is 3600.
Step 7 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
273
Integrate Applications
Configure CTI Redundancy for Application Failure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
274
PA R T IV
Provisioning End Users
• Configure Provisioning Profiles, on page 277
• Configure LDAP Synchronization, on page 291
• Provisioning Users and Devices Using Bulk Administration Tool, on page 299
CHAPTER 27
Configure Provisioning Profiles
• Provisioning Profiles Overview, on page 277
• Provisioning Profiles Task Flow, on page 278
• Configure SIP Profile, on page 280
• Configure Phone Security Profile, on page 281
• Create a Feature Control Policy, on page 281
• Create a Common Phone Profile, on page 282
• Configure Common Device Configuration, on page 283
• Configure a Universal Device Template, on page 283
• Configure a Universal Line Template, on page 284
• Configure a User Profile, on page 285
• Configure a Headset Template, on page 286
• Configure UC Services, on page 287
• Configure a Service Profile, on page 288
• Configure a Feature Group Template, on page 288
• Configure Default Credential Policy, on page 289
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
277
Provisioning End Users
Provisioning Profiles Task Flow
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
278
Provisioning End Users
Provisioning Profiles Task Flow
Procedure
Step 2 Configure Phone Security Profile, on page 281 Configure security profiles that you will assign
to provisioned endpoints. Assign settings such
as TLS and TFTP encryption.
Step 3 Create a Feature Control Policy, on page 281 Optional. Use this policy to enable particular
features and control the appearance of phone
softkeys.
Step 4 Create a Common Phone Profile, on page 282 Optional. Use this profile to assign TFTP data
and product-specific configuration defaults to
a profile that you can assign to groups of
endpoints.
Step 5 Configure Common Device Configuration, on Optional. Use this configuration to assign
page 283 user-specific settings and IPv6 preferences to
endpoints.
Step 6 Configure a Universal Device Template, on This template contains common settings that
page 283 will be used to configure newly provisioned
phones. You can also assign the profiles that
you’ve configured to this template.
Step 7 Configure a Universal Line Template, on page This template contains common settings that
284 will used to configure newly provisioned
extensions. You can also configure enterprise
and E.164 numbers for your extensions.
Step 8 Configure a User Profile, on page 285 Set up a User Profile with the device templates,
line templates, and common settings for newly
provisioned users.
Step 9 Configure a Headset Template, on page 286 Optional. If you plan to use Cisco Headsets
configure headset templates and assign them
to the User Profiles that you’ve set up.
Step 10 Configure UC Services, on page 287 Configure UC Services such as the IM and
Presence Service and a directory service.
Step 11 Configure a Service Profile, on page 288 Create a Service Profile that includes the UC
services you want to assign to provisioned
users.
Step 12 Configure a Feature Group Template, on page For LDAP syncs, add your user profile and
288 service profiles to a feature group template that
you can assign to LDAP-synced users.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
279
Provisioning End Users
Configure SIP Profile
What to do next
• Set up your LDAP sync in order to provision new users
• If you are not deploying LDAP, you can use Bulk Administration to provision users by bulk.
Procedure
Step 1 From Cisco Unified CM Administration, choose Device > Device Settings > SIP Profile.
Step 2 Perform one of the following steps:
• To edit an existing profile, click Find and select the SIP profile.
• To create a new profile, click Add New.
Step 7 If you want this profile to support both IPv4 and IPv6 stacks simultaneously, check the Enable ANAT check
box.
Step 8 Check the Allow Presentation Sharing using BFCP check box if you want your users to be able to share
presentations.
Step 9 Complete the remaining fields in the SIP Profile Configuration window. For help with the fields and their
settings, see the online help.
Step 10 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
280
Provisioning End Users
Configure Phone Security Profile
Note By default, if you don't apply a SIP phone security profile to a provisioned device, the device uses a nonsecure
profile.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Security > Phone Security Profile.
Step 2 Click Add New.
Step 3 From the Phone Security Profile Type drop-down list, choose the Universal Device Template to create a
profile that you can use when provisioning through the device templates.
Note Optionally, you can also create security profiles for specific device models.
Procedure
Step 1 From Cisco Unified CM Administration, choose Device > Device Settings > Feature Control Policy.
Step 2 Perform one of the following tasks:
• To modify the settings for an existing policy, enter search criteria, click Find and choose the policy from
the resulting list.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
281
Provisioning End Users
Create a Common Phone Profile
Procedure
Step 1 From Cisco Unified CM Administration, choose Device > Device Settings > Common Phone Profile menu
path to configure common phone profiles.
Step 2 Click Add New.
Step 3 Enter a Name for the profile.
Step 4 Enter a Description for the profile.
Step 5 If you set up a Feature Control Policy to phones that use this profile, select the policy from the drop-down
list.
Step 6 Complete the remaining fields in the Common Phone Profile Configuration window. For help with the
fields and their settings, see the online help.
Step 7 Configure fields under Product-Specific Configuration Layout. For field descriptions, click the (?) to see
field-specific help.
Step 8 (Optional) If you want to enable Interactive Connectivity Establishment (ICE) for Mobile and Remote Access
phones:
a) Set the ICE drop-down to Enabled.
b) Set the Default Candidate Type to one of the following:
• Host—A candidate obtained by selecting the IP address on the host device. This is the default.
• Server Reflexive—An IP address and port candidate obtained by sending a STUN request. Often,
this may represent the public IP address of the NAT.
• Relayed—An IP address and port candidate obtained from a TURN server. The IP address and port
are resident on the TURN server such that media is relayed through the TURN server.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
282
Provisioning End Users
Configure Common Device Configuration
Procedure
Step 1 From Cisco Unified CM Administration, choose Device > Device Settings > Common Device Configuration.
Step 2 Click Add New.
Step 3 For SIP trunks, SIP Phones or SCCP phones, choose a value for the IP Addressing Mode drop-down list:
• IPv4 Only—The device uses only an IPv4 address for media and signaling.
• IPv6 Only—The device uses only an IPv6 address for media and signaling.
• IPv4 and IPv6 (Default)—The device is a dual-stack device and uses whichever IP address type is
available. If both IP address types are configured on the device, for signaling the device uses the IP
Addressing Mode Preference for Signaling setting and for media the device uses the IP Addressing
Mode Preference for Media enterprise parameter setting.
Step 4 If you configure IPv6 in your previous step, then configure an IP addressing preference for the IP Addressing
Mode for Signaling drop-down list:
• IPv4—The dual stack device prefers IPv4 address for signaling.
• IPv6—The dual stack device prefers IPv6 address for signaling.
• Use System Default—The device uses the setting for the IP Addressing Mode Preference for Signaling
enterprise parameter.
Step 5 Configure the remaining fields in the Common Device Configuration window. For more information on the
fields and their configuration options, see the system Online Help.
Step 6 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
283
Provisioning End Users
Configure a Universal Line Template
Procedure
Step 1 In Cisco Unified CM Administration, choose User Management > User/Phone Add > Universal Device
Template.
Step 2 Click Add New.
Step 3 Enter the following mandatory fields:
a) Enter a Device Description for the template.
b) Select a Device Pool type from the drop-down list.
c) Select a Device Security Profile from the drop-down list.
d) Select a SIP Profile from the drop-down list.
e) Select a Phone Button Template from the drop-down list.
Step 4 Complete the remaining fields in the Universal Device Template Configuration window. For field
descriptions, see the online help.
Step 5 Under Phone Settings, complete the following optional fields:
a) If you configured a Common Phone Profile, assign the profile.
b) If you configured a Common Device Configuration, assign the configuration.
c) If you configured a Feature Control Policy, assign the policy.
Step 6 Click Save.
Procedure
Step 1 In Cisco Unified CM Administration, choose User Management > User/Phone Add > Universal Line
Template.
Step 2 Click Add New.
Step 3 Configure the fields in the Universal Line Template Configuration window. See the online help for more
information about the fields and their configuration options.
Step 4 If you are deploying Global Dial Plan Replication with alternate numbers expand the Enterprise Alternate
Number and +E.164 Alternate Number sections and do the following:
a) Click the Add Enterprise Alternate Number button and/or Add +E.164 Alternate Number button.
b) Add the Number Mask that you want to use to assign to your alternate numbers. For example, a 4-digit
extension might use 5XXXX as an enterprise number mask and 1972555XXXX as an +E.164 alternate
number mask.
c) Assign the partition where you want to assign alternate numbers.
d) If you want to advertise this number via ILS, check the Advertise Globally via ILS check box. Note that
if you are using advertised patterns to summarize a range of alternate numbers, you may not need to
advertise individual alternate numbers.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
284
Provisioning End Users
Configure a User Profile
e) Expand the PSTN Failover section and choose the Enterprise Number or +E.164 Alternate Number
as the PSTN failover to use if normal call routing fails.
Step 5 Click Save.
Procedure
Step 1 From Cisco Unified CM Administration, choose User Management > User Settings > User Profile.
Step 2 Click Add New.
Step 3 Enter a Name and Description for the user profile.
Step 4 Assign a Universal Device Template to apply to users' Desk Phones, Mobile and Desktop Devices, and
Remote Destination/Device Profiles.
Step 5 Assign a Universal Line Template to apply to the phone lines for users in this user profile.
Step 6 If you want the users in this user profile to be able to use the self-provisioning feature to provision their own
phones, do the following:
a) Check the Allow End User to Provision their own phones check box.
b) In the Limit Provisioning once End User has this many phones field, enter a maximum number of
phones the user is allowed to provision. The maximum is 20.
c) Check the Allow Provisioning of a phone already assigned to a different End User check box to
determine whether the user associated with this profile has the permission to migrate or re-assign a device
that is already owned by another user. By default, this check box is unchecked.
Step 7 If you want Cisco Jabber users associated with this user profile, to be able to use the Mobile and Remote
Access feature, check the Enable Mobile and Remote Access check box.
Note • By default, this check box is selected. When you uncheck this check box, the Jabber Policies
section is disabled and No Service client policy option is selected by default.
• This setting is mandatory only for Cisco Jabber users whom are using OAuth Refresh Logins.
Non-Jabber users do not need this setting to be able to use Mobile and Remote Access. Mobile
and Remote Access feature is applicable only for the Jabber Mobile and Remote Access users
and not to any other endpoints or clients.
Step 8 Assign the Jabber policies for this user profile. From the Jabber Desktop Client Policy, and Jabber Mobile
Client Policy drop-down list, choose one of the following options:
• No Service—This policy disables access to all Cisco Jabber services.
• IM & Presence only—This policy enables only instant messaging and presence capabilities.
• IM & Presence, Voice and Video calls—This policy enables instant messaging, presence, voicemail, and
conferencing capabilities for all users with audio or video devices. This is the default option.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
285
Provisioning End Users
Configure a Headset Template
Note Jabber desktop client includes Cisco Jabber for Windows users and Cisco Jabber for Mac users.
Jabber mobile client includes Cisco Jabber for iPad and iPhone users and Cisco Jabber for Android
users.
Step 9 If you want the users in this user profile to set the maximum login time for Extension Mobility or Extension
Mobility Cross Cluster through Cisco Unified Communications Self Care Portal, check the Allow End User
to set their Extension Mobility maximum login time check box.
Note By default Allow End User to set their Extension Mobility maximum login time check box is
unchecked.
Note The Standard Default Headset Configuration Template is a system-defined template. You can assign new
User Profiles to the Standard Default Headset Template but you can't edit the template. By default, all user
profiles are assigned to this template. To disassociate a user profile from this template, you must assign the
profile to a new template.
Procedure
Step 1 From Cisco Unified CM Administration, choose Device > Headset > Headset Template.
Step 2 Do either of the following:
• To edit an existing template, select the template.
• To create a new template, select any existing template and click Copy. The existing settings are applied
to your new template.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
286
Provisioning End Users
Configure UC Services
• Anonymous devices
For a Customized Headset Configuration Template, the Apply Config button takes effect only for devices
owned by users you added to the Assigned User Profiles list.
Configure UC Services
Use this procedure to configure the UC service connections that your users will use. You can configure
connections for the following UC services:
• Voicemail
• Mailstore
• Conferencing
• Directory
• IM and Presence Service
• CTI
• Video Conferencing Scheduling Portal
• Jabber Client Configuration (jabber-config.xml)
Note The fields may vary depending on which UC service you configure.
Procedure
Step 1 From Cisco Unified CM Administration, choose User Management > User Settings > UC Services.
Step 2 Click Add New.
Step 3 From the UC Service Type drop-down, select the UC service that you want to configure and click Next.
Step 4 Select the Product Type.
Step 5 Enter a Name for the service.
Step 6 Enter the Hostname or IP address for the server where the service is homed.
Step 7 Complete the Port and Protocol information.
Step 8 Configure the remaining fields. For help with the fields and their settings, refer to the online help. The field
options vary depending on which UC service you are deploying.
Step 9 Click Save.
Step 10 Repeat this procedure until you have provisioned all the UC services that you need.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
287
Provisioning End Users
Configure a Service Profile
Note If you want the service to be located on multiple servers, configure different UC service connections
that point to different servers. For example, with the IM and Presence Service Centralized
Deployment, it is recommended to configure multiple IM and Presence UC services that point to
different IM and Presence nodes. After you have configured all your UC connections, you can add
them to a Service Profile.
Procedure
Step 1 From Cisco Unified CM Administration, choose User Management > User Settings > Service Profile.
Step 2 Click Add New.
Step 3 Enter a Name for the chosen Service Profile Configuration.
Step 4 Enter a Description for the chosen Service Profile Configuration.
Step 5 For each UC service that you want to be a part of this profile, assign the Primary, Secondary, and Tertiary
connections for that service.
Step 6 Complete the remaining fields in the Service Profile Configuration window. For detailed field descriptions,
see the online help.
Step 7 Click Save.
Procedure
Step 1 In Cisco Unified CM Administration, choose User Management > User/Phone Add > Feature Group
Template.
Step 2 Click Add New.
Step 3 Enter a Name and Description for the Feature Group Template.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
288
Provisioning End Users
Configure Default Credential Policy
Step 4 Check the Home Cluster check box if you want to use the local cluster as the home cluster for all users whom
use this template.
Step 5 Check the Enable User for Unified CM IM and Presence check box to allow users whom use this template
to exchange instant messaging and presence information.
Step 6 From the drop-down list, select a Services Profile and User Profile.
Step 7 Complete the remaining fields in the Feature Group Template Configuration window. Refer to the online
help for field descriptions.
Step 8 Click Save.
What to do next
Associate the feature group template with an LDAP directory sync to apply the settings from the template to
synchronized end users.
Procedure
c) If you want the system to check for easily hacked passwords such as ABCD or 123456, check the Check
for Trivial Passwords check box.
d) Complete the fields in the Credential Policy Configuration window. For help with the fields and their
settings, see the online help.
e) Click Save.
f) If you want to create a different credential policy for one of the other credential types, repeat these steps.
Step 2 Apply the credential policy to one of the credential types:
a) From Cisco Unified CM Administration, choose User Management > User Settings > Credential Policy
Default.
b) Select the credential type to which you want to apply your credential policy.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
289
Provisioning End Users
Configure Default Credential Policy
c) From the Credential Policy drop-down, select the credential policy that you want to apply for this
credential type. For example, you might select the credential policy that you created.
d) Enter the default passwords in both the Change Credential and Confirm Credential fields. Users have
to enter these passwords at next login.
e) Configure the remaining fields in the Credential Policy Default Configuration window. For help with
the fields and their settings, see the online help.
f) Click Save.
g) If you want to assign a credential policy for one of the other credential types, repeat these steps.
Note For individual users, you can also assign a policy to a specific user credential from the End User Configuration
window or Application User Configuration window for that user. Click the Edit Credential button that is
adjacent to the credential type (password or PIN) to open the Credential Configuration settings for that user
credential.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
290
CHAPTER 28
Configure LDAP Synchronization
• LDAP Synchronization Overview, on page 291
• LDAP Synchronization Prerequisites, on page 292
• LDAP Synchronization Configuration Task Flow, on page 292
Note Unified Communications Manager supports LDAPS (LDAP with SSL) but does not support LDAP with
StartTLS. Ensure that you upload the LDAP server certificate to Unified Communications Manager as a
Tomcat-Trust.
See the Compatibility Matrix for Cisco Unified Communications Manager and the IM and Presence Service
for information on the supported LDAP directories.
LDAP synchronization advertises the following functionalities:
• Importing End Users—You can use LDAP synchronization during the initial system setup to import
your user list from a company LDAP directory into the Unified Communications Manager database. If
you've preconfigured items such as feature group templates, user profiles, service profiles, universal
device and line templates, you can apply configurations to your users, and assign configured directory
numbers and directory URIs during the sync process. The LDAP synchronization process imports the
list of users and user-specific data and applies the configuration templates that you've set up.
Note You cannot make edits to an LDAP synchronization once the initial
synchronization has occurred already.
• Scheduled Updates—You can configure Unified Communications Manager to synchronize with multiple
LDAP directories at scheduled intervals to ensure that the database is updated regularly and user data is
up-to-date.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
291
Provisioning End Users
LDAP Synchronization Prerequisites
• Authenticate End Users—You can configure your system to authenticate end user passwords against
the LDAP directory rather than the Cisco Unified Communications Manager database. LDAP
authentication provides companies with the ability to assign a single password to end users for all company
applications. This functionality does not apply to PINs or application user passwords.
• Directory Server User Search for Cisco Mobile and Remote Access Clients and Endpoints—You
can search a corporate directory server even when operating outside the enterprise firewall. When this
feature is enabled, the User Data Service (UDS) acts as a proxy and sends the user search request to the
corporate directory instead of sending it to the Unified Communications Manager database.
Note For users whose data you want to synchronize to your system, ensure that their email ID fields on the Active
Directory server are unique entries or left blank.
Note If you have already synced the LDAP directory once, you can still sync new items from your external LDAP
directory, but you cannot add new configurations in Unified Communications Manager to the LDAP directory
sync. In this case, you can use the Bulk Administration Tool and menus such as Update Users or Insert Users.
Refer to the Bulk Administration Guide for Cisco Unified Communications Manager.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
292
Provisioning End Users
Activate the Cisco DirSync Service
Procedure
Step 3 Create an LDAP Filter, on page 294 Optional. Create an LDAP filter if you want
Unified Communications Manager to
synchronize only a subset of users from your
corporate LDAP directory.
Step 4 Configure LDAP Directory Sync, on page 295 Configure settings for the LDAP directory sync
such as field settings, LDAP server locations,
synchronization schedules, and assignments for
access control groups, feature group templates,
and primary extensions.
Step 5 Configure Enterprise Directory User Search, Optional. Configure the system for enterprise
on page 297 directory server user searches. Follow this
procedure to configure phones and clients in
your system to perform user searches against
an enterprise directory server instead of the
database.
Step 6 Configure LDAP Authentication, on page 297 Optional. If you want to use the LDAP
directory for end user password authentication,
configure LDAP authentication settings.
Step 7 Customize LDAP Agreement Service Optional. Configure the optional LDAP
Parameters, on page 298 Synchronization service parameters. For most
deployments, the default values are sufficient.
Procedure
Step 1 From Cisco Unified Serviceability, choose Tools > Service Activation.
Step 2 From the Server drop-down list, choose the publisher node.
Step 3 Under Directory Services, click the Cisco DirSync radio button.
Step 4 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
293
Provisioning End Users
Enable LDAP Directory Synchronization
Note If you have already synced the LDAP directory once, you can still sync new users from your external LDAP
directory, but you cannot add new configurations in Unified Communications Manager to the LDAP directory
sync. You also cannot add edits to underlying configuration items such as the feature group template or user
profile. If you have already completed one LDAP sync, and want to add users with different settings, you can
use Bulk Administration menus such as Update Users or Insert Users.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > LDAP > LDAP System.
Step 2 If you want Unified Communications Manager to import users from your LDAP directory, check the Enable
Synchronizing from LDAP Server check box.
Step 3 From the LDAP Server Type drop-down list, choose the type of LDAP directory server that your company
uses.
Step 4 From the LDAP Attribute for User ID drop-down list, choose the attribute from your corporate LDAP
directory that you want Unified Communications Manager to synchronize with for the User ID field in the
End User Configuration window.
Step 5 Click Save.
Note Any LDAP filter that you configure must comply with the LDAP search filter standards that are specified in
RFC4515.
Procedure
Step 1 In Cisco Unified CM Administration, choose System > LDAP > LDAP Filter.
Step 2 Click Add New to create a new LDAP filter.
Step 3 In the Filter Name text box, enter a name for your LDAP filter.
Step 4 In the Filter text box, enter a filter. The filter can contain a maximum of 1024 UTF-8 characters and must be
enclosed in parentheses ().
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
294
Provisioning End Users
Configure LDAP Directory Sync
Tip If you are assigning access control groups or feature group templates, you can use an LDAP filter to limit the
import to the group of users with the same configuration requirements.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > LDAP > LDAP Directory.
Step 2 Perform one of the following steps:
• Click Find and select an existing LDAP directory.
• Click Add New to create a new LDAP directory.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
295
Provisioning End Users
Configure LDAP Directory Sync
b) In the pop-up window, click the corresponding check box for each access control group that you want to
assign to the imported end users.
c) Click Add Selected.
Step 9 If you want to assign a feature group template, select the template from the Feature Group Template
drop-down list.
Note The end users are synced with the assigned Feature Group Template only for the first time when
the users are not present. If an existing Feature Group Template is modified and a full sync is
performed for the associated LDAP, the modifications will not get updated.
Step 10 If you want to assign primary extension by applying a mask to imported telephone numbers, do the following:
a) Check the Apply mask to synced telephone numbers to create a new line for inserted users check
box.
b) Enter a Mask. For example, a mask of 11XX creates a primary extension of 1145 if the imported telephone
number is 8889945.
Step 11 If you want to assign primary extensions from a pool of directory numbers, do the following:
a) Check the Assign new line from the pool list if one was not created based on a synced LDAP telephone
number check box.
b) In the DN Pool Start and DN Pool End text boxes, enter the range of directory numbers from which to
select primary extensions.
Step 12 In the LDAP Server Information section, enter the hostname or IP address of the LDAP server.
Step 13 If you want to use TLS to create a secure connection to the LDAP server, check the Use TLS check box.
Step 14 Click Save.
Step 15 To complete an LDAP sync, click Perform Full Sync Now. Otherwise, you can wait for the scheduled sync.
Note When users are deleted in LDAP, they will automatically be removed from Unified Communications Manager
after 24 hours. Also, if the deleted user is configured as a mobility user for any of the following devices, these
inactive devices will also be automatically deleted:
• Remote Destination Profile
• Remote Destination Profile Template
• Mobile Smart Client
• CTI Remote Device
• Spark Remote Device
• Nokia S60
• Cisco Dual Mode for iPhone
• IMS-integrated Mobile (Basic)
• Carrier-integrated Mobile
• Cisco Dual Mode for Android
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
296
Provisioning End Users
Configure Enterprise Directory User Search
Procedure
Step 1 In Cisco Unified CM Administration, choose System > LDAP > LDAP Search.
Step 2 To enable user searches to be performed using an enterprise LDAP directory server, check the Enable user
search to Enterprise Directory Server check box.
Step 3 Configure the fields in the LDAP Search Configuration window. See the online help for more information
about the fields and their configuration options.
Step 4 Click Save.
Note To search conference rooms represented as Room objects in OpenLDAP Server, configure the
custom filter as (| (objectClass=intOrgPerson)(objectClass=rooms)). This allows Cisco Jabber client
to search conference rooms by their name and dial the number associated with the room.
Conference rooms are searchable provided givenName or sn or mail or displayName or
telephonenumber attribute is configured in the OpenLDAP server for a room object.
Procedure
Step 1 In Cisco Unified CM Administration, choose System > LDAP > LDAP Authentication.
Step 2 Check the Use LDAP Authentication for End Users check box to use your LDAP directory for user
authentication.
Step 3 In the LDAP Manager Distinguished Name field, enter the user ID of the LDAP Manager who has access
rights to the LDAP directory.
Step 4 In the Confirm Password field, enter the password for the LDAP manager.
Step 5 In the LDAP User Search Base field, enter the search criteria.
Step 6 In the LDAP Server Information section, enter the hostname or IP address of the LDAP server.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
297
Provisioning End Users
Customize LDAP Agreement Service Parameters
Step 7 If you want to use TLS to create a secure connection to the LDAP server, check the Use TLS check box.
Step 8 Click Save.
What to do next
Customize LDAP Agreement Service Parameters, on page 298
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Service Parameters.
Step 2 From the Server drop-down list box, choose the publisher node.
Step 3 From the Service drop-down list box, choose Cisco DirSync.
Step 4 Configure values for the Cisco DirSync service parameters.
Step 5 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
298
CHAPTER 29
Provisioning Users and Devices Using Bulk
Administration Tool
• Bulk Administration Tool Overview, on page 299
• Bulk Administration Tool Prerequisites, on page 300
• Bulk Administration Tool Task Flow, on page 300
Note The Bulk Administration menu is visible only on the first node of Unified Communications Manager server.
The Cisco Bulk Provisioning Service (BPS) administers and maintains all jobs that are submitted through the
Bulk Administration menu of Cisco Unified CM Administration. You can start this service from Cisco Unified
Serviceability. You need to activate the Cisco Bulk Provisioning Service only on the first node of Unified
Communications Manager.
You can use BAT to perform the following:
• Add, update, or delete large numbers of phones in batches
• Define the common phone attributes to add a group of new phones
• Creates new BAT phone templates
• Adds a group of new users and to associate users to phones and other IP Telephony devices
• Creates User CSV Data File From BAT Spreadsheet
• Creates CSV data file for adding phones and users in batches
• Adds a group of phones and users to the Unified Communications Manager database and directory
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
299
Provisioning End Users
Bulk Administration Tool Prerequisites
Step 2 Create New BAT Phone Template, on page You can create new BAT phone templates.
301
Step 3 Create Phone CSV Data File Using BAT You can add new phones or IP telephony
Spreadsheet, on page 306 devices to the system using the .xls spreadsheet
that was designed for use with BAT.
Step 4 Create Custom Phone File Format Using Text You can use a text editor to create a custom
Editor, on page 308 phone file format for the text-based CSV data
file.
Step 5 Insert Phones Into Unified Communications You can add phones, Cisco VGC Phones, CTI
Manager, on page 309 ports, or H.323 clients into the Unified
Communications Manager database.
Step 6 Add Users, on page 311 You can use BAT to add a group of new users
and to associate users to phones and other IP
Telephony devices.
Step 7 Create User CSV Data File From BAT You can provide details for adding new users
Spreadsheet, on page 311 to the Unified Communications Manager
database in the BAT spreadsheet and then
convert it in to a CSV data file.
Step 8 Insert Users in Unified Communications You can add a group of users to the Unified
Manager Database, on page 312 Communications Manager database using a
CSV data file.
Step 9 Add Phone and User File Format, on page 314 You can add the phone and user file format
with a text-based CSV data file. After the CSV
data file is created, you need to associate the
file format with the text-based CSV data file.
Step 10 Insert Phones with Users Into Unified You can add a group of phones and users to
Communications Manager, on page 314 the Unified Communications Manager
database and directory.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
300
Provisioning End Users
Add Phones to Database
Procedure
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
301
Provisioning End Users
Add or Update Phone Lines in BAT Template
Step 5 In the Template Name field, enter a name for the template.
The name can contain up to 50 alphanumeric characters.
Step 6 In the Device Information area, enter the phone settings that this batch has in common.
Some phone models and device types do not have all the attributes that the table lists. See, the phone model
documentation for information on all the attributes.
Step 7 After you have entered all the settings for this BAT phone template, click Save.
When the status indicates that the transaction has completed, you can add line attributes.
Procedure
Step 1 Find the Phone Template to which you want to add the line.
Step 2 In the Phone Template Configuration window, click Line [1] Add a new DN, in the Associated Information
area.
The Line Template Configuration window displays.
Step 3 Enter or choose the appropriate values for the line settings.
Step 4 Click Save.
Step 5 To add settings for any additional lines, repeat Step 2, on page 302 through Step 4, on page 302.
If you choose Back to Find/List from the Related Links drop-down list box in the upper, right, corner of the
Line Template Configuration window, the Find and List Line Template window displays.
a) To find existing line template, enter the appropriate search criteria and click Find.
b) To add a new line template, click Add New.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
302
Provisioning End Users
Add or Update Speed Dials in BAT Template
Procedure
Step 1 Find the Phone Template to which you want add an IP service.
Step 2 From the Phone Template Configuration window, click Add a new SURL in the Associated Information
area.
A popup window displays. In this window, you can subscribe to CiscoUnifiedIPPhone services that are
available.
Step 3 In the Select a Service drop-down list box, choose a service to which you want all phones to be subscribed.
The Service Description box displays details about the service that you choose.
Step 4 Click Next.
Step 5 In the Service Name field, modify the name of the service, if required.
Step 6 Associate the selected services or add more services to the template.
a) To associate these phone services to the phone template, click Save.
b) To add more services, repeat Step 3, on page 303 through Step 6, on page 303.
c) To add all the services to the template, click Update.
After you are done adding or updating services for the selected template, proceed to the next step.
Step 7 Close the popup window.
Procedure
Step 1 Find the Phone Template to which you want to add speed dials.
Step 2 From the Phone Template Configuration window, do one of the following:
a) Click Add a new SD in the Associated Information area.
b) Choose Add/Update Speed Dials from the Related Links drop-down list box in the upper, right-hand
corner of the window.
A popup window displays. In this window, you can designate speed-dial buttons for CiscoUnifiedIPPhones
and expansion modules.
Step 3 In the Speed Dial Settings area, enter the phone number, including any access or long-distance codes, in the
Number field.
Note When you enter the phone number, it can be followed by Forced Authorized Code (FAC)/Client
Matter Code (CMC) if applicable. You can enter the Phone number, FAC, CMC either in sequence
or separated by a comma (,). The Speed dial may include any PIN, Password or any other digits to
be sent as DTMF digits after the call is connected. If you require a pause while connecting through
speed dial, you can enter one or more comma (,) where each comma represents a pause of 2 seconds.
DTMF digits will be sent after the call is connected and the appropriate pause duration corresponding
to the number of commas is entered.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
303
Provisioning End Users
Add or Update Busy Lamp Field in BAT Template
Step 4 In the Label field, enter a label that corresponds to the speed-dial number.
Step 5 In the Abbreviated Dial Settings area, you can set abbreviated speed dials for applicable IP phone models.
Repeat Step 3, on page 303.
Step 6 Click Save.
BAT inserts the speed-dial settings in the template and the popup window closes.
Procedure
Step 1 Find the Phone Template to which you want to add speed dials.
Step 2 In the Phone Template Configuration window, do one of the following:
a) Click Add a new BLF SD in the Associated Information area.
b) Choose Add/Update Busy Lamp Field Speed Dials from the Related Links drop-down list in the upper,
right-hand corner of the window.
A popup window displays. In this window, you can designate busy lamp field speed-dial (BLF SD) buttons
for CiscoUnifiedIPPhones and expansion modules.
Step 3 In the Speed Dial Settings area, enter the destination, including any access or long-distance codes, in the
Destination field.
Step 4 Choose the directory number from the drop-down list. You can click Find to search for directory numbers.
Step 5 In the Label field, enter a label that corresponds to the BLF SD number.
Step 6 Click Save.
BAT inserts the BLF SD settings in the template, and the popup window closes.
Add or Update Busy Lamp Field Directed Call Park in BAT Template
You can add and update busy lamp field (BLF) directed call park in the BAT template for phones and Cisco
VGC phones if the Phone Button Template provides speed-dial buttons. The Phone Button Template in use
for this BAT template determines the number of available BLF Directed Call Park buttons.
Procedure
Step 1 Find the Phone Template to which you want to add BLF speed directed call park.
Step 2 In the Phone Template Configuration window, do one of the following:
a) Click Add a new BLF Directed Call Park in the Associated Information area.
b) Choose Add/Update BLF Directed Call Park from the Related Links drop-down list box in the upper,
right-hand corner of the window.
A popup window displays. In this window, you can designate BLF Directed Call Park buttons for
CiscoUnifiedIPPhones and expansion modules.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
304
Provisioning End Users
Add or Update Intercom Template in BAT Template
Step 3 In the Unassigned Busy Lamp Field/Directed Call Park Settings area, choose the directory number from
the drop-down list. You can click Find to search for directory numbers.
Step 4 In the Label field, enter a label that corresponds to the BLF Directed Call Park number.
Step 5 Click Save.
BAT inserts the BLF Directed Call Park settings in the template, and the popup window closes.
Procedure
Step 1 Find the Phone Template to which you want to add the intercom template.
Step 2 In the Phone Template Configuration window, click Intercom [1] - Add a new Intercom in the Associated
Information area.
The Intercom Template Configuration window displays.
Step 3 Enter or choose the appropriate values for the intercom template settings.
Step 4 Click Save.
BAT adds the intercom template to the phone template configuration.
Step 5 To add settings for any additional intercom templates, repeat Step 2, on page 305 through Step 4, on page 305.
If you choose Back to Find/List from the Related Links drop-down list box in the upper, right, corner of the
Intercom Template Configuration window, the Find and List Intercom Directory Number window
displays.
Note If you choose Back to Find/List from the Related Links drop-down list box in the upper, right,
corner of the Intercom Template Configuration window, the Find and List Intercom Directory
Number window displays.
a) Click Find and enter the appropriate search criteria and to find existing Intercom directory numbers.
b) In the Find and List Intercom Directory Number window, click Add New to add a new intercom
directory number.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
305
Provisioning End Users
Create Phone CSV Data File Using BAT Spreadsheet
Note If you enter a comma in one of the fields, BAT.xlt encloses that field entry in double quotes when you export
to BAT format.
If you enter a blank row in the BAT spreadsheet, the system treats the empty row as the end of the file and
does not convert data that is entered after a blank line to the BAT format.
You can use the dummy MAC address option when adding CTI ports. This option gives a unique device name
to each CTI port in the form of dummy MAC addresses that you can manually update later using the Cisco
Unified Communications Manager Administration or the UnifiedCM Auto-Register phone Tool. Do not use
the dummy MAC address option for H.323 clients, VGC phones, or VGC virtual phones.
The dummy MAC address option automatically generates dummy MAC addresses in the following format:
XXXXXXXXXXXX
where X represents any 12-character, hexadecimal (0-9 and A-F) number.
Attention The number of lines and speed dials that you define for phones in the BAT spreadsheet must not exceed the
numbers that are defined in the BAT phone template, otherwise, an error occurs when you attempt to insert
the CSV data file and BAT template.
After you have finished editing all the fields in the BAT spreadsheet, you can export the content to a CSV
formatted data file. A default filename is assigned to the exported CSV formatted data file:
<tabname>-<timestamp>.txt
where <tabname> represents the type of input file that you created, such as phones, and <timestamp> represents
the precise date and time that the file was created.
You can rename the CSV formatted data file after you save the exported file to your local workstation.
Note You cannot upload a CSV filename that contains a comma (for example, abcd,e.txt) to the Unified
Communications Manager server.
Procedure
Step 1 To open the BAT spreadsheet, locate and double-click the BAT.xlt file
Step 2 When prompted, click Enable Macros to use the spreadsheet capabilities.
Step 3 To display the phones options, click the Phones tab at the bottom of the spreadsheet.
Step 4 Choose the radio button for one of the following device types:
The device type that you select determines the validation criteria for data in the BAT spreadsheet.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
306
Provisioning End Users
Create Phone CSV Data File Using BAT Spreadsheet
• Phones
• CTI Port
• H.323 Client
• VGC Phones
• VGC Virtual Phones
• Cisco IP Communicator Phone
The spreadsheet displays options that are available for the chosen device. For example, when you choose
phones, fields for the number of phone lines and the number of speed dials display.
Step 5 Choose the device and line fields to appear in the BAT spreadsheet for each phone. Do the following:
a) Click Create File Format.
b) To choose the device fields, click a device field name in the Device Field box and then click the arrow
to move the field to the Selected Device Fields box.
A CSV data file must include MAC Address/Device Name and Description; therefore, these fields
always remain selected.
Tip To select a range of items in the list, hold down the Shift key. To select random field names,
hold down the Ctrl key and click field names.
c) Click a line field name in the Line Field box and click the arrow to move the field to the Selected Line
Fields box.
Tip To change the order of the items in the Selected Line and Device boxes, choose an item and
use the up and down arrows to move the field up or down in the list.
d) A message asks whether you want to overwrite the existing CSV format. Click Create to modify the CSV
data file format.
e) Click OK.
New columns for the selected fields display in the BAT spreadsheet in the order that you specified.
Step 6 Scroll to the right to locate the Number of Phone Lines box and enter the number of lines for the phone.
Note The number of lines you enter must not exceed the number of lines that are configured in the BAT
template.
Step 7 For phones, you must enter the number of speed-dial buttons in the Maximum Number of Speed Dials box.
Note The number of speed dials you enter must not exceed the number of speed dials that are configured
in the BAT template.
After you enter the number, columns display for each speed-dial number.
Step 8 Enter the number of Busy Lamp Field (BLF) speed-dial buttons in the Maximum Number of BLF Speed
Dials box.
After you enter the number, columns display for each BLF speed-dial number.
Step 9 Enter data for an individual phone on each line in the spreadsheet.
Complete all mandatory fields and any relevant, optional fields. Each column heading specifies the length of
the field and whether it is required or optional. See online help for phone field descriptions.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
307
Provisioning End Users
Create Custom Phone File Format Using Text Editor
Step 10 If you did not enter the MAC address for each phone, check the Create Dummy MAC Address check box.
Attention Do not use the dummy MAC address option for H.323 clients, VGC phones, or VGC virtual phones.
Step 11 To transfer the data from the BAT Excel spreadsheet into a CSV formatted data file, click Export to BAT
Format.
Tip For information on how to read the exported CSV data file, click the link to View Sample File in
the Insert phones window in BAT.
The system saves the file with the default filename: <tabname>-<timestamp>.txt to your choice of a folder
on your local workstation.
Procedure
Step 1 Choose Bulk Administration > Phones > Phone File Format > Create File Format.
Step 2 Click Add New.
Step 3 In the Format Name field, enter a name for this custom format.
Step 4 Choose the fields to appear in the custom file format. Do the following:
a) To choose the device fields, click a device field name in the Device Field box and then click the arrow
to move the field to the Selected Device Fields box.
A CSV data file must include MAC Address/Device Name and Description; therefore, these fields
always remain selected.
Tip To select a range of items in the list, hold down the Shift key. To select random field names,
hold down the Ctrl key and click field names.
b) Click a line field name in the Line Field box and click the arrow to move the field to the Selected Line
Fields box.
c) Click the intercom DN field names in the Intercom DN Fields box and click the arrow to move the fields
to the Selected Intercom DN Fields Order box.
Tip You can change the order of the items in the Selected Line Fields, Selected Device Fields, and
Selected Intercom DN Fields Order boxes. Choose an item and use the up and down arrows
to move the field up or down in the list.
Step 5 In the IP Phone Services Maximums area, enter the maximum values for the following fields:
• Maximum Number of Speed Dials
• Maximum Number of BLF Speed Dials
• Maximum Number of BLF Directed Call Parks
• Maximum Number of IP Phone Services
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
308
Provisioning End Users
Insert Phones Into Unified Communications Manager
Note BAT expects Directory Number URI fields for directory numbers in the following format:
URI 1 on Directory Number 1, URI 1 Route Partition on Directory Number 1, URI 1 is Primary on Directory
Number 1.
You can use the dummy MAC address option. When adding CTI ports, this option gives a unique device
name to each CTI port in the form of dummy MAC addresses that you can manually update later using the
Unified Communications Manager Administration or the UnifiedCM Auto-Register Phone Tool. Do not use
the dummy MAC address option for H.323 clients, VGC phones, or VGC virtual phones.
The dummy MAC address option automatically generates dummy MAC addresses in the following format:
XXXXXXXXXXXX
where X represents any 12-character, hexadecimal (0-9 and A-F) number.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
309
Provisioning End Users
Insert Phones Into Unified Communications Manager
Procedure
Step 5 For the Specific Details option, in the Phone Template Name drop-down list, choose the BAT phone template
that you created for this type of bulk transaction.
Attention If you did not enter individual MAC addresses in the CSV data file, you must check the Create
Dummy MAC Address check box. You can update this information manually later. Skip to Step 8,
on page 310. If you supplied MAC addresses or device names in the data input file, do not choose
this option.
If you do not know the MAC address of the phone that is assigned to the user, then choose this
option. When the phone is plugged in, a MAC address registers for that device.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
310
Provisioning End Users
Add Users
What to do next
If the phones inserted are of the type Cisco Unified Mobile Communicator, then you must reset the devices
after the insert job is completed. You can reset the phones using the Bulk Administration > Phones >
Reset/Restart Phones option.
Add Users
You must create a CSV data file to add new users in bulk to the Unified Communications Manager database
using the BAT spreadsheet. For users who have applications that require a CTI port, such as CiscoIPSoftPhone,
BAT can associate CTI ports to existing users.
Procedure
Step 1 Create a comma separated values (CSV) data file to define individual values for each user that you want to
add.
Step 2 Use BAT to insert the users in the Unified Communications Manager database.
Note If you enter a blank row in the BAT spreadsheet, the system treats the empty row as the end of the file and
does not convert data that is entered after a blank line to the BAT format.
After you have finished editing the fields to add users in the BAT spreadsheet, you can export the content to
a CSV formatted data file. A default filename is assigned to the exported CSV formatted data file:
<tabname>-<timestamp>.txt
where <tabname> represents the type of input file that you created, such as phones, and <timestamp> represents
the precise date and time that the file was created.
You can rename the CSV formatted data file after you save the exported file to your local workstation. If you
enter a comma in one of the fields, BAT.xlt encloses that field entry in double quotes when you export to
BAT format.
Note You cannot upload a CSV filename that contains a comma (for example, abcd,e.txt) to the Unified
Communications Manager server.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
311
Provisioning End Users
Insert Users in Unified Communications Manager Database
Procedure
Step 1 To open the BAT spreadsheet, locate and double-click BAT.xlt file.
Step 2 When prompted, click Enable Macros to use the spreadsheet capabilities.
Step 3 To add users, click the Users tab at the bottom of the spreadsheet.
Step 4 Complete all mandatory fields and any relevant optional fields. Each column heading specifies the length of
the field and whether it is required or optional.
In each row, provide the information as described in the online help files.
• If a user has multiple devices, the device name field should be repeated, once for each device.
• To enter additional device names that will be associated to a new user, enter a value in the Number of
Controlled Devices text box.
Note You can associate all devices, including CTI ports, ATA ports, and H.323 clients, with a user.
Step 5 To enter additional device names that will be associated to a new user, enter a value in the Number of
Controlled Devices text box.
Step 6 Click Export to BAT Format to transfer the data from the BAT Excel spreadsheet into a CSV formatted
data file.
The system saves the file to C:\XLSDataFiles with the default file name <tabname>-<timestamp>.txt , or uses
Browse to save the file to another existing folder.
Tip For information on how to read the exported CSV data file, click the link to View Sample File in
the Insert Users window in BAT.
What to do next
You must upload the CSV data file to the first node of Unified Communications Manager database server so
that BAT can access the data file.
Attention If the credential policy has “check for trivial password” enabled, and the password in the user template is the
user ID, inserting users through BAT may fail if the user ID does not satisfy the necessary criteria for the
trivial password.
Users can be inserted using BAT with primary extension configured without any devices selected for controlled
devices. To do so, you must pre-populate the DN in Unified Communications Manager before inserting the
users using BAT. The following steps outline the process of pre-populating the DN:
1. Create range of DNs to be associated for primary extension for users in the DN page.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
312
Provisioning End Users
Add Phones with Users Using the BAT Spreadsheet
2. Create a BAT template with primary extension configured (which should be the same DN's pre-populated).
3. Insert the users using BAT (as shown in the following procedure)
Note When you are inserting users by using an exported BAT file, you might get errors stating “User ID already
exists” for some users that were exported in more than one file. For example, a list of first line managers and
a list of users might both include the same manager user ID.
Procedure
Procedure
Step 1 To open the BAT spreadsheet, locate and double-click BAT.xlt file.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
313
Provisioning End Users
Add Phone and User File Format
Procedure
Step 1 Choose Bulk Administration > Phones and Users > Phones & Users File Format > Assign File Format.
The Add File Format Configuration window displays.
Step 2 In the File Name field, choose the text-based CSV file that you created for this transaction.
Step 3 In the Format File Name field, choose the file format that you created for this type of bulk transaction.
Step 4 To create a job for associating the matching file format with the CSV data file, click Submit.
Step 5 To schedule and/or activate this job, use the Job Scheduler option in the Bulk Administration main menu.
Note The user fields get added automatically when you add the file format.
You can use the dummy MAC address option. When adding CTI ports, this option gives a unique device
name to each CTI port in the form of dummy MAC addresses that you can manually update later using the
Unified Communications Manager Administration or the UnifiedCM Auto-Register phone Tool. Do not use
the dummy MAC address option for H.323 clients, VGC phones, or VGC virtual phones.
The dummy MAC address option automatically generates dummy MAC addresses in the following format:
XXXXXXXXXXXX
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
314
Provisioning End Users
Insert Phones with Users Into Unified Communications Manager
Procedure
Step 1 Choose Bulk Administration > Phones & Users > Insert Phones with Users.
Step 2 In the File Name field, choose the CSV data file that you created for this bulk transaction.
Step 3 In the Phone Template Name field, choose the BAT phone template that you used for this transaction.
Attention If you did not enter individual MAC addresses in the CSV data file, you must check the Create
Dummy MAC Address check box. You can update this information manually later. If you supplied
MAC addresses or device names in the data input file, do not choose this option.
If you do not know the MAC address of the phone that is assigned to the user, choose this option.
When the phone is plugged in, a MAC address registers for that device.
Step 4 In the User Template Name field, choose the BAT user template that you used for this transaction
Step 5 In the Job Information area, enter the Job description.
Step 6 Choose an insert method. Do one of the following:
a) Click Run Immediately to insert the phones with users immediately.
b) Click Run Later to insert the phones with users at a later time.
Step 7 To create a job for inserting the phones and user records, click Submit.
To schedule and activate this job, use the Job Scheduler option in the Bulk Administration main menu.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
315
Provisioning End Users
Insert Phones with Users Into Unified Communications Manager
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
316
PA R T V
Provisioning Endpoints
• Configure Endpoints, on page 319
• Configure CAPF, on page 327
• Configure TFTP Servers, on page 343
• Device Onboarding via Activation Codes, on page 351
• Configure Autoregistration, on page 365
• Configure Self-Provisioning, on page 373
CHAPTER 30
Configure Endpoints
• Endpoint Provisioning Defaults, on page 319
• Endpoint Provisioning Default Prerequisites, on page 319
• Endpoint Provisioning Defaults Task Flow, on page 319
• Configure Device Defaults, on page 320
• Configure Enterprise Phone, on page 323
• Self Care Portal, on page 324
Note In most cases, there is no need to change the ports from their default settings.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
319
Provisioning Endpoints
Configure Device Defaults
Procedure
Step 2 Configure Device Profile, on page 323 Optional. You can configure a device profile
comprises the set of attributes that associate
with a particular device for a user.
Step 3 Configure Default Device Profiles, on page 321 You can configure a default device profile that
a phone takes whenever a user logs into a phone
for which that user does not have a user device
profile.
Step 4 Configure a Softkey Template on the Default Optional. You can add the default device
Device Profile, on page 321 profile to a softkey template.
Step 5 Configure Enterprise Phone, on page 323 You can configure the basic enterprise phone
settings that apply to all phones in the same
cluster.
Procedure
Step 1 In Cisco Unified CM Administration, select Device > Device Settings > Device Defaults.
Step 2 In the Device Defaults Configuration window, modify the applicable settings for the type of device that you
want to update, then click Save. For field descriptions, see the online help.
• Load Information
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
320
Provisioning Endpoints
Configure Default Device Profiles
• Device Pool
• Phone Template
Step 3 Click the Reset icon that appears to the left of the device name to reset all the devices of that type and load
the new defaults to all devices of that type on all nodes in the cluster.
If you do not reset all devices, then only new devices that auto-register on the node are configured with the
updated default values.
Procedure
Step 1 From the Cisco Unified CM Administration window, choose Device > Device Settings > Default Device
Profile.
Step 2 In the Default Device Profile Configuration window, from the Device Profile Type drop-down list, choose
the appropriate Cisco Unified IP Phone.
Step 3 Click Next.
Step 4 From the Device Protocol drop-down list, choose the appropriate protocol.
Step 5 Click Next.
Step 6 Configure the fields in the Default Device Profile Configuration window. See the online help for more
information about the fields and their configuration options.
Step 7 Click Save.
Procedure
Step 1 From Cisco Unified CM Administration, choose Device > Device Settings > Softkey Template.
Step 2 Perform the following steps to create a new softkey template; otherwise, proceed to the next step.
a) Click Add New.
b) Select a default template and click Copy.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
321
Provisioning Endpoints
Configure a Softkey Template on the Default Device Profile
c) Enter a new name for the template in the Softkey Template Name field.
d) Click Save.
Step 3 Perform the following steps to add softkeys to an existing template.
a) Click Find and enter the search criteria.
b) Select the required existing template.
Step 4 Check the Default Softkey Template check box to designate this softkey template as the default softkey
template.
Note If you designate a softkey template as the default softkey template, you cannot delete it unless you
first remove the default designation.
Step 5 Choose Configure Softkey Layout from the Related Links drop-down list in the upper right corner and
click Go.
Step 6 From the Select a Call State to Configure drop-down list, choose the call state for which you want the softkey
to display.
Step 7 From the Unselected Softkeys list, choose the softkey to add and click the right arrow to move the softkey
to the Selected Softkeys list. Use the up and down arrows to change the position of the new softkey.
Step 8 Repeat the previous step to display the softkey in additional call states.
Step 9 Click Save.
Step 10 Perform one of the following tasks:
• Click Apply Config if you modified a template that is already associated with devices to restart the
devices.
• If you created a new softkey template, associate the template with the devices and then restart them. For
more information, see Add a Softkey Template to a Common Device Configuration and Associate a
Softkey Template with a Phone sections.
What to do next
You can apply a customized softkey template to a device by selecting the template from the Softkey Template
drop-down in one of the following configuration windows:
• Phone Configuration
• Universal Device Template
• BAT Template
• Common Device Configuration
• Device Profile
• Default Device Profile
• UDP Profile
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
322
Provisioning Endpoints
Configure Device Profile
Procedure
Step 1 From the Cisco Unified CM Administration window, choose Device > Device Settings > Device Profile.
Step 2 In the Device Profile Configuration window, from the Device Profile Type drop-down list, choose the
appropriate Cisco Unified IP Phone.
Step 3 Click Next.
Step 4 From the Device Protocol drop-down list, choose the appropriate protocol.
Step 5 Click Next.
Step 6 From the Phone Button Template drop-down list, choose a template.
Step 7 (Optional) From the Softkey Template drop-down list, select a softkey template.
Step 8 Configure the fields in the Device Profile Configuration window. See the online help for more information
about the fields and their configuration options.
Step 9 Click Save.
Note For details on using Device Profiles to setup Cisco Extension Mobility, see the Feature Configuration
Guide for Cisco Unified Communications Manager, Release 12.5(1)SU1.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Enterprise Phone Configuration.
Step 2 Enter the required fields in the Product Specific Configuration Layout section.
To view the descriptions of all enterprise phone parameters, click the ? button in the Enterprise Phone
Parameters Configuration window.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
323
Provisioning Endpoints
Configure a Phone
Step 3 Complete the remaining fields in the Enterprise Phone Configuration window. For help with the fields and
their settings, see the online help.
Configure a Phone
Perform these steps to manually add the phone to the Unified Communications Manager database. You do
not have to perform these steps if you are using autoregistration. If you opt for autoregistration, Unified
Communications Manager automatically adds the phone and assigns the directory number.
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
324
Provisioning Endpoints
Self Care Portal
• Users can also use the portal to self-provision their own Single Number Reach remote destinations.
End users need to be set up with access before they can use the portal. For details on how to set up the portal,
go to the “Self Care Portal’ chapter of the Feature Configuration Guide for Cisco Unified Communications
Manager.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
325
Provisioning Endpoints
Self Care Portal
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
326
CHAPTER 31
Configure CAPF
• Certificate Authority Proxy Function (CAPF) Overview, on page 327
• CAPF Prerequisites, on page 329
• Certificate Authority Proxy Function Configuration Task Flow, on page 330
• CAPF Administration Tasks, on page 337
• CAPF System Interactions and Restrictions, on page 338
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
327
Provisioning Endpoints
Phone Certificate Types
Note Cisco recommends that if you want to use a third-party CA to sign LSC, use the
Online CA option instead of Offline CA as the process is automated, much
quicker, and less likely to encounter problems.
Note For Online CA, the LSC validity is based on the CA and can be used as long as
the CA allows it.
Note Cisco recommends that you use Manufacturer Installed Certificates (MICs) for LSC installation only. Cisco
supports LSCs to authenticate the TLS connection with Unified Communications Manager. Since MIC root
certificates can be compromised, customers who configure phones to use MICs for TLS authentication or for
any other purpose do so at their own risk. Cisco assumes no liability if MICs are compromised.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
328
Provisioning Endpoints
CAPF Prerequisites
Note Be aware that the phone user can abort the certificate operation or view the operation status on the phone.
Note Key generation set at low priority allows the phone to function while the action occurs. Although the phone
functions during certification generation, additional TLS traffic may cause minimal call-processing interruptions
with the phone. For example, audio glitches may occur when the certificate is written to flash at the end of
the installation
CAPF Prerequisites
Before configuring the Certificate Authority Proxy Function for LSC generation, perform the following:
• If you want to use a third-party CA to sign your LSCs, configure your CA externally.
• Plan how you are going to authenticate your phones.
• Before you generate LSCs, ensure that you have the following:
• Unified Communications Manager Release 12.5 or later.
• Endpoints that use CAPF for certificates (includes Cisco IP Phones and Jabber).
• Microsoft Windows Server 2012 and 2016.
• Domain Name Service (DNS) is configured.
• You must upload the CA root and HTTPS certificates before generating LSCs. During a secure SIP
connection, HTTPS certificate goes through the CAPF-trust and the CA root certificate goes through the
CAPF-trust and the CallManager-trust. The Internet Information Services (IIS) hosts the HTTPS certificate.
The CA root certificate is used to sign the Certificate Signing Requests (CSR).
Following are the scenarios when you have to upload the certificates:
Scenarios Results
CA root and HTTPS certificates are same. Upload the CA root certificate.
CA root and HTTPS certificates are different Upload the CA root certificate.
and if HTTPS certificates are issued by the same
CA root certificate.
CA root and HTTPS certificates are different Upload CA root and HTTPS certificate.
and are issued by the same CA root certificate.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
329
Provisioning Endpoints
Certificate Authority Proxy Function Configuration Task Flow
Note Cisco strongly recommends that you use CAPF during a scheduled maintenance window because generating
multiple certificates simultaneously may cause call-processing interruptions.
Note You don't have to restart the CAPF service after regenerating or uploading the new CAPF certificate.
Procedure
Step 2 Upload Certificate Authority (CA) Root Upload the CA root certificate to the Unified
Certificate , on page 331 Communications Manager Trust store.
Step 3 Configure Online Certificate Authority Settings, Use this procedure to generate phone LSC
on page 332 certificates.
Step 4 Configure Offline Certificate Authority Settings Use this procedure to generate phone LSC
certificates using an Offline CA.
Step 5 Activate or Restart CAPF Services After you configure the CAPF system settings,
activate essential CAPF services.
Step 6 Configure CAPF settings in Unified Add the CAPF settings to Phone Configuration
Communications Manager using one of the using one of the following options:
following procedures:
• If you haven't synced your LDAP
• Configure CAPF Settings in a Universal directory, add CAPF settings to a
Device Template, on page 334 Universal Device Template and apply
• Update CAPF Settings via Bulk Admin, settings through the initial LDAP sync.
on page 335
• Use Bulk Administration Tool to apply
• Configure CAPF Settings for a Phone, on CAPF settings to many phones in a single
page 336 operation.
• You can apply CAPF settings on a
phone-by-phone basis.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
330
Provisioning Endpoints
Upload Root Certificate for Third-Party CAs
Note Skip this task if you don't want to use a third-party CA to sign LSCs.
Procedure
Step 1 From Cisco Unified OS Administration choose Security > Certificate Management.
Step 2 Click Upload Certificate/Certificate chain.
Step 3 From the Certificate Purpose drop-down list, choose CAPF-trust.
Step 4 Enter a Description for the certificate. For example, Certificate for External LSC-Signing CA.
Step 5 Click Browse, navigate to the file, and then click Open.
Step 6 Click Upload.
Step 7 Repeat this task, uploading certificates to callmanager-trust for the Certificate Purpose.
Procedure
Step 1 From Cisco Unified OS Administration choose Security > Certificate Management.
Step 2 Click Upload Certificate/Certificate chain.
Step 3 From the Certificate Purpose drop-down list, choose callmanager-trust.
Step 4 Enter a Description for the certificate. For example, Certificate for External LSC-Signing CA.
Step 5 Click Browse, navigate to the file, and then click Open.
Step 6 Click Upload.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
331
Provisioning Endpoints
Configure Online Certificate Authority Settings
Note FIPS enabled mode doesn't support Online CAPF and CAPFv3.
Procedure
Step 1 From Cisco Unified CM Administration, choose System > Service Parameters.
Step 2 From the Server drop-down list, choose a node where you activated the Cisco Certificate Authority Proxy
Function (Active) service.
Step 3 From the Service drop-down list, choose Cisco Certificate Authority Proxy Function (Active). Verify that
the word “Active” is displayed next to the service name.
Step 4 From the Certificate Issuer to Endpoint drop-down list, choose Online CA. For CA-signed certificates, we
recommend using an Online CA.
Step 5 In the Duration Of Certificate Validity (in days) field, enter a number between 1 and 1825 to represent the
number of days that a certificate issued by CAPF is valid.
Step 6 In the Online CA Parameters section, set the following parameters in order to create the connection to the
Online CA section.
• Online CA Hostname—The subject name or the Common Name (CN) should be the same as the Fully
Qualified Domain Name (FQDN) of HTTPS certificate.
Note The hostname configured is the same as the Common Names (CN) of the HTTPs certificate
hosted by Internet Information Services (IIS) running on Microsoft CA.
• Online CA Port—Enter the port number for Online CA. For example, 443
• Online CA Template—Enter the name of the template. Microsoft CA creates the template.
• Online CA Type—Choose the default type, Microsoft CA.
• Online CA Username—Enter the username of the CA server.
• Online CA Password—Enter the password for the username of the CA server.
Step 7 Complete the remaining CAPF service parameters. Click the parameter name to view the service parameter
help system.
Step 8 Click Save.
Step 9 Restart Cisco Certificate Authority Proxy Function for the changes to take effect. It automatically restarts
the Cisco Certificate Enrollment service.
Current Online CA limitations
• For Online CA operation, EST servers use TVS certificates from CUCM and if the TVS certificate is
CA signed, then the Online CA will not work.
• The Online CA feature does not work if the CA server uses any other language apart from English. The
CA server should respond only in English.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
332
Provisioning Endpoints
Configure Offline Certificate Authority Settings
Note The offline CA option is more time-consuming than online CAs, involving numerous manual steps. Restart
the process if there are any issues (for example, a network outage or phone reset) during the certificate
generation and transmission process.
Procedure
Step 1 Download the root certificate chain from the third-party certificate authority.
Step 2 Upload the root certificate chain to the required trusts (CallManager trust CAPF trust) in Unified
Communications Manager.
Step 3 Configure Unified Communications Manager to use Offline CAs by setting the Certificate Issue to Endpoint
service parameter to Offline CA.
Step 4 Generate CSRs for your phone LSCs.
Step 5 Send the CSRs to the certificate authority.
Step 6 Obtain the signed certificates from the CSR.
For more detailed example on how to generate phone LSCs using an Offline CA, see CUCM Third-Party
CA-Signed LSCs Generation and Import Configuration.
Procedure
Step 1 From Cisco Unified Serviceability, choose Tools > Service Activation.
Step 2 From the Server drop-down list, select the publisher node and click Go.
Step 3 From the Security Services pane, check the services that apply:
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
333
Provisioning Endpoints
Configure CAPF Settings in a Universal Device Template
• Cisco Certificate Enrollment Service—Check this service if you're using an Online CA else leave it
unchecked.
• Cisco Certificate Authority Proxy Function—Check this service if unchecked (Deactivated). Restart
if the service is already activated.
Note You can only add the Universal Device Template to an LDAP directory that hasn't been synced. If your initial
LDAP sync has occurred, use Bulk Administration to update phones. For details, see Update CAPF Settings
via Bulk Admin, on page 335.
Procedure
Step 1 From Cisco Unified CM Administration, choose User Management > User/Phone Add > Universal Device
Template.
Step 2 Do either of the following:
• Click Find and Select an existing template.
• Click Add New.
Step 3 Expand the Certificate Authority Proxy Function (CAPF) Settings area.
Step 4 From the Certificate Operation drop-down list, select Install/Upgrade.
Step 5 From the Authentication Mode drop-down list menu, select an option for the device to authenticate itself.
Step 6 If you chose to use an authentication string, enter the Authentication String in the text box, or click Generate
String to have the system generate a string for you.
Note Authentication fails if this string isn't configured on the device itself.
Step 7 From the remaining fields, configure the key information. For help with the fields, see the online help.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
334
Provisioning Endpoints
Update CAPF Settings via Bulk Admin
Step 9 Apply the template settings to devices that use this profile.
a) Add the Universal Device Template to a Feature Group Template Configuration.
b) Add the Feature Group Template to an LDAP Directory Configuration that isn't synced.
c) Complete an LDAP sync. The CAPF settings get applied to all synced devices.
For details on configuring feature group templates and LDAP directories, see the "Configure End Users"
section of System Configuration Guide for Cisco Unified Communications Manager.
Note If you haven't provisioned the phones, use Insert Phones menu of the Bulk Administration to provision new
phones with CAPF settings from a CSV file. See the "Phones Insertions" section of Bulk Administration
Guide for Cisco Unified Communications Manager for details on how to insert phones from CSV files.
Make sure you have configured your phones with the same string and authentication method that you plan to
add in this procedure. Else, your phones don't authenticate to CAPF. See your Phone Documentation for
details on how to configure authentication on the phone.
Procedure
Step 1 From Cisco Unified CM Administration, choose Bulk Administration > Phones > Update Phones > Query.
Step 2 Use filter options to limit the search to the phones that you want to update and click Find.
For example, use Find phones where drop-down list to select all phones, where LSC expires before a specific
date or in a specific Device Pool.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
335
Provisioning Endpoints
Configure CAPF Settings for a Phone
Step 8 Complete one of the following steps if you selected By Authentication String as the Authentication Mode:
• Check Generate unique authentication string for each device if you want to use a unique authentication
string for each device.
• Enter the string in Authentication String text box, or click Generate String if you want to use the same
authentication string for all devices.
Step 9 Complete the remaining fields in the Certification Authority Proxy Function (CAPF) Information section
of the Update Phones window. For help with the fields and their settings, see the online help.
Step 10 From the Job Information section, select Run Immediately.
Note Select Run Later if you want run the job at a scheduled time. For details on scheduling jobs, see
the "Manage Scheduled Jobs" section in Bulk Administration Guide for Cisco Unified
Communications Manager.
Note Use Bulk Administration or sync LDAP directory to apply CAPF settings to a large number of phones.
Configure your phone with the same string and authentication method that you plan to add in this procedure.
Else, the phone doesn't authenticate itself to CAPF. See your Phone Documentation for details on how to
configure authentication on the phone.
Procedure
Step 6 Enter a text string or click Generate String to generate a string for you if you selected By Authentication
String.
Step 7 Enter the details in the remaining fields in the Certification Authority Proxy Function (CAPF) Information
pane of the Phone Configuration page. For help with the fields and their settings, see the online help.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
336
Provisioning Endpoints
Set KeepAlive Timer
Procedure
Step 1 Use the Command Line Interface to login to the publisher node.
Step 2 Run the utils capt set keep_alive CLI command.
Step 3 Enter a number between 5 and 60 (minutes) and click Enter.
Note You can also obtain a list of stale LSC certificates by running the utils capf stale-lsc list CLI command
on the publisher node.
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
337
Provisioning Endpoints
View Pending CSR List
Procedure
Step 1 Use the Command Line Interface to login to the publisher node.
Step 2 Run the utils capf csr list CLI command.
A timestamped list of pending CSR files displays.
Procedure
Step 1 Use the Command Line Interface to login to the publisher node.
Step 2 Run the utils capf stale-lsc delete all CLI command
The system deletes all stale LSC certificates from the system.
Authentication String CAPF authentication method for the phone, you must enter the same
authentication string on the phone after the operation, or the operation
will fail. If TFTP Encrypted Configuration enterprise parameter is
enabled and you fail to enter the authentication string, the phone may
fail and may not recover until the matching authentication string is
entered on the phone
Cluster Server Credentials All servers in the Unified Communications Manager cluster must use
the same administrator username and password, so CAPF can
authenticate to all servers in the cluster
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
338
Provisioning Endpoints
CAPF System Interactions and Restrictions
Feature Interaction
Migrating secure phone If a secure phone gets moved to another cluster, the Unified
Communications Manager will not trust the LSC certificate that the
phone sends because it was issued by another CAPF, whose certificate
is not in the CTL file.
To enable the secure phone to register, delete the existing CTL file. You
can then use the Install/Upgrade option to install a new LSC certificate
with the new CAPF and reset the phone for the new CTL file (or use
the MIC). Use the Delete option in the CAPF section on the Phone
Configuration window to delete the existing LSC before you move the
phones.
Cisco Unified IP Phones 6900 Cisco recommends upgrading Cisco Unified IP Phones 6900 series,
series, 7900 series, 8900 series, and 7900 series, 8900 series, and 9900 series to use LSCs for TLS connection
9900 to Unified Communications Manager and removing MIC root certificates
from the CallManager trust store to avoid possible future compatibility
issues. Be aware that some phone models that use MICs for TLS
connection to Unified Communications Manager may not be able to
register.
Administrators should remove the following MIC root certificates from
the CallManager trust store:
• CAP-RTP-001
• CAP-RTP-002
• Cisco_Manufacturing_CA
• Cisco_Root_CA_2048
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
339
Provisioning Endpoints
CAPF Examples with 7942 and 7962 Phones
Feature Interaction
Note In the following examples, if the LSC does not already exist in the phone and if By Existing Certificate is
chosen for the CAPF Authentication Mode, the CAPF certificate operation fails.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
340
Provisioning Endpoints
CAPF Interaction with IPv6 Addressing
When the phone connects to CAPF to get a certificate, CAPF uses the configuration from the Enable IPv6
enterprise parameter to determine whether to issue or upgrade the certificate to the phone. If the enterprise
parameter is set to False, CAPF ignores/rejects connections from phones that use IPv6 addresses, and the
phone does not receive the certificate.
The following table describes how a phone that has an IPv4, IPv6, or both types of addresses connects to
CAPF.
Two stack IPv4 and IPv6 available IPv4, IPv6 Phone uses an IPv6
address to connect to
CAPF; if the phone
cannot connect via an
IPv6 address, it attempts
to connect by using an
IPv4 address.
Two stack IPv4 and IPv6 available IPv6 Phone uses and IPv6
address to connect to
CAPF.
Two stack IPv4 and IPv6 available IPv4 Phone uses an IPv4
address to connect to
CAPF.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
341
Provisioning Endpoints
CAPF Interaction with IPv6 Addressing
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
342
CHAPTER 32
Configure TFTP Servers
• Proxy TFTP Deployment Overview, on page 343
• TFTP Server Configuration Task Flow, on page 346
Tip When you configure peer relationships between the remote proxy TFTP servers in your network, keep the
relationships hierarchical. Ensure that the peer proxy TFTP servers on the remote clusters do not point to each
other to avoid possible looping. For example, if the primary node A has a peer relationship with nodes B and
C. You should not create a peer relationship between nodes B and C. If you do, then you have created a loop.
Proxy TFTP
In multi-cluster systems, the proxy TFTP service is able provide TFTP files from multiple clusters via a single
primary TFTP server. The proxy TFTP can serve as a single TFTP reference for scenarios where a single
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
343
Provisioning Endpoints
Proxy TFTP
subnet or VLAN contains phones from multiple clusters or in any scenario where multiple clusters share the
same DHCP TFTP option (150).
The Proxy TFTP service functions as a single-level hierarchy is as illustrated. More complicated multi-level
hierarchies are not supported.
Figure 7: Proxy TFTP Single-Level Hierarchy
In the above illustration, a group of devices contacts the Primary TFTP server for their configuration files.
When it receives a request for TFTP from a device, the primary TFTP looks into its own local cache for the
configuration file as well as any other remotely configured clusters such as Remote Cluster A, B, C, or N (any
other remote clusters configured).
It is possible to configure any number of remote clusters on the primary TFTP server; however, each remote
cluster may contain only up to 3 TFTP IP addresses. The recommended design for redundancy is 2 TFTP
servers per cluster, and thus 2 IP addresses per remote cluster on the Primary TFTP server for redundancy.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
344
Provisioning Endpoints
TFTP Support for IPv4 and IPv6 Devices
2. The cluster is a remote cluster that is also acting as a Proxy TFTP server for remote clusters. The remote
cluster is manually defined, and Autoregistration should not be enabled.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
345
Provisioning Endpoints
TFTP Server Configuration Task Flow
To disable Security by Default, see "Update ITL File for Cisco Unified IP Phones" section the Security Guide
for Cisco Unified Communications Manager.
Note The phone's configuration in the Proxy TFTP takes 30 minutes to expire. To avoid any file not found response,
you can restart Proxy Cluster's TFTP services.
3. Reset Phones to download configuration files from Remote Cluster B and register to Remote Cluster B.
Procedure
Step 2 (Optional) Update the CTL File for TFTP Install the CTL client plug-in and add the
Servers, on page 348 primary proxy TFTP server to the Cisco
Certificate Trust List (CTL) file of all proxy
TFTP servers in all remote clusters that are
operating in mixed-mode.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
346
Provisioning Endpoints
Configure TFTP Server Dynamically
Step 4 (Optional) Modify Non-Configuration Files for You can modify non-configuration files that the
the TFTP Server, on page 349 end points request from the proxy TFTP server.
Step 5 (Optional) Stop and Start the TFTP service, on Stop and restart the TFTP service on the proxy
page 349 TFTP node if you have uploaded modified
non-configuration files for your endpoints.
Step 6 (Optional) See the documentation that supports For multiple cluster deployments, modify the
your DHCP server. DHCP scope for individual remote nodes to
include the IP address of the primary proxy
TFTP server.
Procedure
In Cisco Unified Communications Manager Administration, choose Advanced Features > Cluster View >
Update Remote Cluster Now. The TFTP server is automatically configured for the cluster.
What to do next
You must add any remote proxy TFTP servers to the Trust Verification Lists (TVL) of the endpoints; otherwise,
they will not accept the configuration files from the proxy TFTP server that is on a remote cluster. See the
documentation that supports your endpoint device for instructions.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
347
Provisioning Endpoints
Update the CTL File for TFTP Servers
Each remote TFTP server in the proxy TFTP deployment must include a peer relationship to the primary
proxy TFTP server. To avoid creating a loop, ensure that the peer TFTP servers on the remote clusters do not
point to each other.
Procedure
Step 2 Check the TFTP check box to enable TFTP for the remote cluster.
Step 3 Click TFTP.
Step 4 In the Remote Cluster Service Manually Override Configuration window, select Manually configure
remote service addresses.
Step 5 Enter the IP addresses of the TFTP server to create a peer relationships to those TFTP servers.
You can enter up to three TFTP server IP addresses.
Step 6 (Optional) Check the Cluster is Secure check box if the proxy TFTP server is deployed in a secured cluster.
Step 7 Click Save.
What to do next
You must add any remote TFTP servers to the Trust Verification Lists (TVL) of the endpoints; otherwise,
they will not accept the configuration files from the proxy TFTP server that is on a remote cluster. See the
documentation that supports your endpoint device for instructions.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
348
Provisioning Endpoints
Modify Non-Configuration Files for the TFTP Server
For more information about security and using the Cisco CTL CLI, see the "About Cisco CTL Setup" section
in the Security Guide for Cisco Unified Communications Manager.
Procedure
Procedure
Step 1 In Cisco Unified Communications Operating System Administration, select Software Upgrades > TFTP
File Management.
The TFTP File Management window appears.
Step 2 Click Upload File.
The Upload File pop-up appears.
Step 3 Perform one of the following actions:
• Click Browse to browse to the directory location of the file to upload.
• Paste the full directory path of the updated file in to the Directory field.
Step 4 Click Upload File or click Close to exit without uploading the file.
What to do next
Stop and restart the Cisco TFTP service on the proxy TFTP node using Cisco Unified Serviceability
Administration.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
349
Provisioning Endpoints
Stop and Start the TFTP service
Procedure
Step 1 In Cisco Unified Serviceability, select Tools > Control Center - Feature Services.
Step 2 In the Control Center–Feature Services window, select the proxy TFTP node in the Server drop-down list.
Step 3 Select the TFTP service in the CM Services area and click Stop.
The status changes to reflect the updated status.
Tip To see the latest status of services, click Refresh.
Step 4 Select the TFTP service in the CM Services area, then click Start.
The status changes to reflect the updated status.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
350
CHAPTER 33
Device Onboarding via Activation Codes
• Activation Codes Overview, on page 351
• Activation Code Prerequisites, on page 353
• Device Onboarding with Activation Codes Task Flow in On-Premise Mode, on page 353
• Device Onboarding Task Flow (Mobile and Remote Access Mode), on page 359
• Additional Tasks for Activation Code, on page 361
• Activation Code Use Cases, on page 362
• No need to manually enter actual MAC addresses. Administrators can use dummy MAC addresses and
the phone updates the configuration automatically with the real MAC address during registration.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
351
Provisioning Endpoints
Onboarding Process Flow in On-Premise Mode
• No need to deploy an IVR, such as TAPS, to convert phone names from BAT to SEP.
Phone users can obtain their activation codes via the Self-Care Portal, provided the Show Phones Ready to
Activate enterprise parameter is set to True. Otherwise, administrators must provide the codes to phone
users.
Note When you provision with BAT MAC addresses, activation codes are tied to the phone model. BAT MAC is
a reference to the device name that starts with 'BAT' and is followed by a random 12 hexidecimal digits that
look like a MAC address. When saving a device configuration page with a blank MAC Address field, a random
name with this format is created for you.You must enter an activation code that matches the phone model in
order to activate the phone.
For added security, you can provision the phone with the actual MAC address of the phone. This option
involves more configuration because the administrator must gather and input each phone's MAC address
during provisioning, but provides greater security because users must enter the activation code that matches
the actual MAC address on their phone.
Note It's recommended to add an additional subscriber to the default communication manager group for on-premise
activation code onboarding. Else, when the node in the default communication manager group goes down,
you may face onboarding issues.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
352
Provisioning Endpoints
Activation Code Prerequisites
Procedure
Step 2 Set Registration Method to use Activation Under Device Defaults, set the default
Codes, on page 354 registration method to use Activation Codes for
supported phone models.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
353
Provisioning Endpoints
Activate the Device Activation Service
Step 4 Activate Phones, on page 358 Distribute activation codes to users. Users must
enter the code on the phone in order to use the
phone.
Procedure
Step 1 From Cisco Unified Serviceability, choose Tools > Service Activation.
Step 2 From the Server drop-down, choose the Unified Communications Manager publisher node and click Go.
Step 3 Under CM Services, confirm that the Status of the Cisco Device Activation Service says Activated.
Step 4 If the service is not running, check the adjacent check box and click Save.
What to do next
Set Registration Method to use Activation Codes, on page 354
Note This procedure applies for the onboarding of on-premise endpoints only. The Onboarding Method setting
under Device Defaults does not apply for onboarding of Mobile and Remote Access endpoints using activation
codes.
Procedure
Step 1 From Cisco Unified CM Administration, choose Device > Device Settings > Device Defaults.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
354
Provisioning Endpoints
Add Phone with Activation Code Requirement
Step 2 In the Device Defaults Configuration window, select the device type that will use activation codes for
registration in the Dual Bank Information section, and change On-Premise Onboarding Method from
Auto Registration to Activation Code.
Step 3 Click Save.
Note When device default is set to Activation Code, and if Auto Registration is earlier used for phone
types, subsequent addition of new phones should follow Activation Code Onboarding or Manual
Configuration of Phone (Using MAC address) and Registration.
For more information, see Add Phone with Activation Code Requirement and Add Phones with
Activation Codes via Bulk Administration section to provision new phones.
Note If you choose not to use templates, you can add a new phone and configure settings manually, or add settings
via a BAT Template. In each case, the Requires Activation Code for Onboarding check box must be checked
in the Phone Configuration window.
Procedure
• SEP{mac}->BAT{mac}: You can blank out the MAC address for prefix to change from ?SEP? to
?BAT? and a new device name with a prefix of ?BAT?.
Step 5 From the Device Template drop-down, select a template such as an existing Universal Device Template with
the settings ou want to apply.
Step 6 From the Directory Number field, select an existing directory number, or click New and do the following:
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
355
Provisioning Endpoints
Add Phones with Activation Codes via Bulk Administration
a) In the Add New Extension popup, enter a new directory number and a Line Template that contains the
settings you want to apply.
b) Click Save and then click Close.
The new extension appears in the Directory Number field.
Step 7 Optional. From the User field, select the User ID that you want to apply to this phone.
Step 8 Click Add.
Step 9 Check the Requires Activation Code for Onboarding check box. In case of Mobile and Remote Access
mode, check the Allow Activation Code via Mobile and Remote Access check box.
Step 10 Configure any other settings that you want to apply. Refer to the online help for help with the fields and their
settings.
Step 11 Click Save, and then click OK.
The Phone Configuration generates the new activation code. Click View Activation Code if you want to
view the code.
What to do next
Activate Phones, on page 358
Procedure
Step 2 Create CSV File with New Phones, on page 357 Create a CSV file that contains the new phones
that you want to add.
Step 3 Insert Phones, on page 358 Use Bulk Administrations's Insert Phones
function to add the new phones to the database.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
356
Provisioning Endpoints
Create CSV File with New Phones
Procedure
Step 1 From Cisco Unified CM Administration, choose Bulk Administration > Phones > Phone Template.
Step 2 Click Add New.
Step 3 From the Phone Type drop-down, select the phone model for which you want to create a template.
Step 4 Enter a Template Name.
Step 5 Check the Require Activation Code for Onboarding check box. In case of Mobile and Remote Access
mode, check the Allow Activation Code via Mobile and Remote Access check box.
Step 6 Configure values for the following mandatory fields:
• Device Pool
• Phone Button Template
• Owner User ID
• Device Security Profile
• SIP Profile
Step 7 Complete any remaining fields in the Phone Template Configuration window. For help with the fields and
their settings, refer to the online help.
Step 8 Click Save.
What to do next
Create CSV File with New Phones, on page 357
Procedure
Step 1 From Cisco Unified CM Administration, choose Bulk Administration > Upload/Download Files.
Step 2 Click Find.
Step 3 Select and download the bat.xlt spreadsheet.
Step 4 Open the spreadsheet and go to the Phones tab.
Step 5 Add your new phone details to the spreadsheet. If you are using dummy MAC addresses, leave the MAC
Address field empty. Check the Require Activation Code for Onboarding check box. In case of Mobile
and Remote Access mode, check the Allow Activation Code via Mobile and Remote Access check box.
Step 6 When you are done, click Export to BAT Format.
Step 7 From Cisco Unified CM Administration, choose Bulk Administration > Upload/Download Files.
Step 8 Upload the csv file.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
357
Provisioning Endpoints
Insert Phones
What to do next
Insert Phones, on page 358
Insert Phones
Use this procedure to insert new phones from a csv file.
Procedure
Step 5 Check the Run Immediately check box to run the job right away. If you choose to run the job later, you must
schedule the job in the Bulk Administration Tool’s Job Scheduler.
Step 6 Click Submit.
What to do next
Activate Phones, on page 358
Activate Phones
After provisioning, distribute activation codes to your phone users so that they can activate their phones.
Following are two options for gathering and distributing activation codes:
• Self-Care Portal—Phone users can log in to the Self-Care Portal in order obtain the activation code that
applies to their phone. They can either input the code on the phone manually, or use their phone's video
camera to scan the barcode that displays in Self-Care. Either method will work. To use Self-Care to
activate the phone, the Show Phones Ready to Activate enterprise parameter must be set to True in
Cisco Unified Communications Manager (this is the default setting).
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
358
Provisioning Endpoints
Export Activation Codes
Note For additional requirements on how to configure user access for the Self-Care
portal, see the "Self-Care Portal" chapter of the Feature Configuration Guide for
Cisco Unified Communications Manager.
• CSV File—You can also export the list of outstanding users and activation codes to a csv file, which
you can then distribute to your users. For a procedure, see Export Activation Codes, on page 359.
Registration Process
Phone users must enter the activation code on their phone in order to use their phones. After a phone user
enters the correct activation code on the phone, the following occurs:
• Their phone authenticates with Cisco Unified Communications Manager.
• The phone configuration in Cisco Unified Communications Manager updates with the actual MAC
address of the phone.
• The phone downloads the configuration file and any other relevant files from the TFTP server and registers
with Cisco Unified Communications Manager.
What to do Next
The phone is now ready to use.
Procedure
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
359
Provisioning Endpoints
Enable Cisco Cloud Onboarding via Mobile and Remote Access
Procedure
Step 2 Mobile and Remote Access Service Domain Onboard the cluster to the cloud to allow remote
Configuration (Optional), on page 361 Mobile and Remote Access device onboarding
to a specific Mobile and Remote Access
Activation Domain.
Step 3 Upload Custom Certificate (Optional), on page Optional. If you want to use your own custom
361 certificates, remote Mobile and Remote Access
endpoints will be able to download them from
the cloud and use them to connect to
Expressway.
Step 4 Provision phones with activation code You must provision the phone in the Unified
requirement. Following are two provisioning CM database. Unified CM has a variety of
sample options: provisioning methods that you can use,
including these sample options.
• Add Phone with Activation Code
Requirement, on page 355
• Add Phones with Activation Codes via
Bulk Administration, on page 356
Step 5 Activate Phones, on page 358 Distribute activation codes to users. Users must
enter the code on the phone in order to use the
phone.
Step 1 To authorize the cluster (CCMAct service) to connect to the cloud-based device activation service, generate
the voucher by clicking the Generate Voucher button.
Step 2 Specify an Mobile and Remote Access Activation Domain. (This is copied to the Mobile and Remote Access
Service Domain list automatically.)
Step 3 Enable activation code onboarding by checking the 'Enable the Activation Code Onboarding' and 'Allow
Mobile and Remote Access Onboarding' checkboxes. If you configured device defaults onboarding using
'Auto Registration', then the 'Allow Mobile and Remote Access Onboarding' checkbox is disabled and
automatically checked as it can only work for phones in Mobile and Remote Access mode. If you configured
device defaults onboarding using 'Activate Code', then both the check boxes are available.
Step 4 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
360
Provisioning Endpoints
Mobile and Remote Access Service Domain Configuration (Optional)
Procedure
Step 1 Choose Advanced Features > Mobile and Remote Access Service Domain to access the Mobile and
Remote Access Service Domain window.
Step 2 Enter the Mobile and Remote Access Service Domain name.
Step 3 Enter the SRV record for the Expressway-E that is used for activation.
Step 4 Choose the default Mobile and Remote Access Service Domain by checking the Default check box next to
the selected domain. This is the domain that is used when you choose '< None >' at the device pool level.
Step 5 Access the Dependency Records using the link on the row of that record that also lists the number of
dependencies.
Procedure
Step 1 Upload the certificates to the Expressway. Do not remove any other certificates.
Step 2 Upload the new certificates to Unified Communications Manager using the path CUCM OS Administration>
Certificate Management . Use the “Phone-Edge-trust” type. (Cisco Unified Communication manager sends
these to the cloud and then to the phone to access the Expressway.)
Step 3 Remove any other “Phone-Edge-trust” type certificates, as desired, so that the custom certificates are the only
ones in use.
Task Procedure
Generate activation codes If you want to generate an activation code for an already-registered phone:
for registered phones
1. From Cisco Unified CM Administration, choose Device > Phone.
2. Search for and open the Phone Configuation for the phone for which you
want to generate an activation code.
3. Check the Requires Activation Code for Onboarding check box and click
Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
361
Provisioning Endpoints
Activation Code Use Cases
Task Procedure
Regenerate activation To generate a new activation code for an unregistered phone, such as may be
codes for unregistered required if the activation process for a new phone fails, do the following:
phones
1. From Cisco Unified CM Administration, choose Device > Phone.
2. Search for and open the Phone Configuation for the phone for which you
want to generate an activation code.
3. Click Release Activation Code
4. Click Generate New Activation Code and click Save.
Set Optional Activation If you want to configure optional service parameters for activation codes.
Code Parameters
1. From Cisco Unified CM Administration, choose System > Service
Parameters.
2. From the Server drop-down, select the publisher node.
3. From the Service drop-down, select Cisco Device Activation Service.
4. Configure a value for the following optional service parameters. For help
with the settings, refer to the context-sensitive help
• Activation Time to Live (Hours)—The number of hours that an
activation code remains active. The default is 168
• Enable Mobile and Remote Access Activation—Set this to True (the
default setting) to enable Mobile and Remote Access activation.
• Mobile and Remote Access Activation Domain—The domain where
Mobile and Remote Access device activation takes place.
5. Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
362
Provisioning Endpoints
Activation Code Use Cases
Replace an existing phone Activation codes make it easy to replace existing phones. For example, let’s say
that a remote worker needs a new phone as their phone is damaged.
• The administrator opens the Phone Configuration settings for the damaged
phone in Unified Communications Manager.
• The administrator blanks out the MAC Address, checks the Requires
Activation Code for Onboarding check box, and clicks Save.
• The user acquires a new phone of the same phone model, and plugs their
phone into the network.
• The user logs in to Self-Care to get their activation code, and inputs the code
on the phone. The phone onboards successfully.
Note In this scenario, the user can onboard any new phone so long as it is
the same phone model as the damaged phone. In a more secure
environment, the administrator may need to provision a replacement
phone to replace the old phone (see below).
Secure shipping of new In a more secure environment where you can ensure that phone shipping process
phone with activation is secure by ting the activation code to a specific MAC address as follows:
codes
• The administrator provisions a new phone in Unified Communications
Manager.
• In the Phone Configuration settings for the new phone, the administrator
enters the phone’s actual MAC Address and checks the Requires Activation
Code for Onboarding check box.
• The administrator packages the phone and ships the phone to the user.
• The user plugs the new phone into the network.
• The user logs in to Self-Care to get the activation code, enters the code on
the phone. The phone onboards successfully.
Note In this scenario, the user can onboard only that specific phone.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
363
Provisioning Endpoints
Activation Code Use Cases
Secure shipping of new As an alternative to activation codes, you can also use autoregistration and TAPS
phone (autoregistration) to securely ship phones to a remote worker:
• In the Device Defaults Configuration, the administrator makes sure that
the Onboarding Method for the phone model is Autoregistration.
• The administrator provisions a new phone in Unified Communications
Manager. In the Phone Configuration for the new phone, the administrator
blanks out the phone’s actual MAC Address.
• The administrator packages the phone and ships the phone to the user.
• The user plugs the new phone into the network, and lets it autoregister.
• The user uses TAPS to map the autoregistered record back to the old record.
Re-onboarding phones via You can switch onboarding methods for specific phone models between Activation
autoregistration Codes and Autoregistration via the On-Premise Onboarding Method field in
the Device Defaults Configuration window.
Note If you want to re-onboard an existing phone via autoregistration, you
must delete the existing record from the database for autoregistration
to work.
Onboarding On-Premise You can onboard the phones on-premise, and then mark the phone for onboarding
phones for Use in Mobile again in Mobile and Remote Access mode to leverage the security provided by
and Remote Access mode OAuth connection to Expressway and trusted connection from Expressway to
Cisco Unified Communications Manager.
In this scenario, with 'Allow Activation Code via Mobile and Remote Access'
enabled, the phone onboards on-premise, validates the OAuth access token that
it received, and switches to Mobile and Remote Access mode and initiates
communication with the Expressway. If your internal network does not allow
communication with the Expressway from on-premise, the phone does not register,
but is ready to contact the Expressway when it is powered up off-premise.
Note The off-premise phones that are unregistered cannot update their
firmware load.This scenario is useful with out-of-the-box phones that
need to be on premise to download the latest firmware and use the
Activation Code feature.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
364
CHAPTER 34
Configure Autoregistration
• Autoregistration Overview, on page 365
• Configure Autoregistration Task Flow, on page 365
Autoregistration Overview
Autoregistration allows Unified Communications Manager to automatically assign directory numbers to new
phones when you plug those phones in to your network.
Autoregistration is enabled on secure mode now. This enhancement provides greater security for your system
because you can secure your cluster while provisioning new phones. It also simplifies the registration process
because you don't have to disable cluster security to register new phones.
If you create a device pool that allows only 911 (emergency) and 0 (operator) calls, you can use that to prevent
unauthorized endpoints from connecting to your network when autoregistration is enabled. New endpoints
can register to this pool, but their access is limited. Unauthorized access by rogue devices that continuously
boot in and attempt to register to your network is prevented. You can move a phone that has auto-registered
to a new location and assign it to a different device pool without affecting its directory number.
The system doesn't know whether the new phones that are auto-registering are running SIP or SCCP, so you
must specify this when you enable autoregistration. Devices that support both SIP and SCCP (such as Cisco
IP Phones 7911, 7940, 7941, 7960, 7961, 7970, and 7971) auto-register with the protocol that is specified in
the enterprise parameter called Auto Registration Phone Protocol.
Devices that support only a single protocol will auto-register with that protocol. The Auto Registration Phone
Protocol setting is ignored. For example, any Cisco IP Phones that support SCCP only will autoregister with
SCCP even if the Auto Registration Phone Protocol parameter is set to SIP.
We recommend that you use autoregistration to add fewer than 100 phones to your network. To add more
than 100 phones, use the Bulk Administration Tool (BAT). For more information, see Cisco Unified
Communications Manager Bulk Administration Guide at http://www.cisco.com/c/en/us/support/
unified-communications/unified-communications-manager-callmanager/products-maintenance-guides-list.html.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
365
Provisioning Endpoints
Configure a Partition for Autoregistration
Procedure
Step 2 Configure a Calling Search Space for Configure a calling search space to use
Autoregistration, on page 367 specifically for autoregistration to limit
auto-registered phones to internal calls only.
Step 3 Configure a Device Pool for Autoregistration, Create a device pool that uses the calling search
on page 368 space that is configured for autoregistration.
Step 4 Set the Device Protocol Type for Use this procedure to set the protocol to SCCP
Autoregistration, on page 369 or SIP to match the type of phones you are
auto-registering.
Step 5 Enable Autoregistration, on page 369 Enable autoregistration on the node to use for
autoregistration and set the Auto-registration
Cisco Unified Communications Manager
Group parameter to enable autoregistration for
the Cisco Unified Communications Manager
group that is to be used for autoregistration.
Step 6 Disable Autoregistration, on page 371 Disable autoregistration for the node as soon as
you are finished registering new devices.
Step 7 Reuse Autoregistration Numbers, on page 372 Optional. Autoregistration numbers for devices
that have been disabled can be reused. When
you reset the range of autoregistration directory
numbers, you force the system to search again
from the starting number. Available directory
numbers are reused.
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Class of Control > Partition.
Step 2 Click Add New to create a new partition.
Step 3 In the Partition Name, Description field, enter a name for the partition that is unique to the route plan.
Partition names can contain alphanumeric characters, as well as spaces, hyphens (-), and underscore characters
(_). See the online help for guidelines about partition names.
Step 4 Enter a comma (,) after the partition name and enter a description of the partition on the same line.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
366
Provisioning Endpoints
Configure a Calling Search Space for Autoregistration
The description can contain up to 50 characters in any language, but it cannot include double quotes ("),
percentage sign (%), ampersand (&), backslash (\), angle brackets (<>), or square brackets ([ ]).
If you do not enter a description, Cisco Unified Communications Manager automatically enters the partition
name in this field.
Step 5 To create multiple partitions, use one line for each partition entry.
Step 6 From the Time Schedule drop-down list, choose a time schedule to associate with this partition.
The time schedule specifies when the partition is available to receive incoming calls. If you choose None, the
partition remains active at all times.
Step 7 Select one of the following radio buttons to configure the Time Zone:
• Originating Device—When you select this radio button, the system compares the time zone of the calling
device to the Time Schedule to determine whether the partition is available is available to receive an
incoming call.
• Specific Time Zone—After you select this radio button, choose a time zone from the drop-down list.
The system compares the chosen time zone to the Time Schedule to determine whether the partition is
available is available to receive an incoming call.
What to do next
Configure a Calling Search Space for Autoregistration, on page 367
Procedure
Step 1 From Cisco Unified CM Administration, choose Call Routing > Class of Control > Calling Search Space.
Step 2 Click Add New.
Step 3 In the Name field, enter a name.
Ensure that each calling search space name is unique to the system. The name can include up to 50 alphanumeric
characters and can contain any combination of spaces, periods (.), hyphens (-), and underscore characters (_).
Step 5 From the Available Partitions drop-down list, perform one of the following steps:
• For a single partition, select that partition.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
367
Provisioning Endpoints
Configure a Device Pool for Autoregistration
• For multiple partitions, hold down the Control (CTRL) key, then select the appropriate partitions.
Step 6 Select the down arrow between the boxes to move the partitions to the Selected Partitions field.
Step 7 (Optional) Change the priority of selected partitions by using the arrow keys to the right of the Selected
Partitions box.
Step 8 Click Save.
What to do next
Configure a Device Pool for Autoregistration, on page 368
Related Topics
Class of Service, on page 168
Procedure
Step 1 From Cisco Unified Communications Manager Administration, choose System > Device Pool.
Step 2 To modify the Default device pool for autoregistration, perform the following actions:
a) Click Find, then select Default from the list of device pools.
b) In the Device Pool Configuration window, select the CSS to be used for autoregistration in the Calling
Search Space for Auto-registration field, then click Save.
Step 3 To create a new device pool for autoregistration, perform the following actions:
a) Click Add New.
b) In the Device Pool Configuration window, enter a unique name for the device pool.
You can enter up to 50 characters, which include alphanumeric characters, periods (.), hyphens (-),
underscores (_), and blank spaces.
c) Set the following fields to match the Default device pool. See the online help for field descriptions.
• In Cisco Unified Communications Manager Group, select Default.
• In Date/Time Group, select CMLocal
• In Region, select Default.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
368
Provisioning Endpoints
Set the Device Protocol Type for Autoregistration
d) Select the CSS to be used for autoregistration in the Calling Search Space for Auto-registration field,
then click Save.
What to do next
Set the Device Protocol Type for Autoregistration, on page 369
Procedure
Step 1 In Cisco Unified Communications Manager Administration, select System > Enterprise Parameters.
Step 2 In the Enterprise Parameters Configuration window, select either SCCP or SIP in the Auto Registration
Phone Protocol drop-down list, then click Save.
What to do next
Enable Autoregistration, on page 369
Enable Autoregistration
When you enable autoregistration, you must specify a range of directory numbers that get assigned to the new
endpoints as they connect to the network. As each new endpoint connects, the next available directory number
is assigned. After all the available autoregistration directory numbers are used up, no more endpoints can
auto-register.
New endpoints auto-register with the first Unified Communications Manager node in the group that has the
Auto-Registration Cisco Unified Communications Manager Group setting enabled. That node then
automatically assigns each auto-registered endpoint to a default device pool according to the device type.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
369
Provisioning Endpoints
Enable Autoregistration
• Check that the correct phone image names for SIP and SCCP appear on the Device Defaults
Configuration window. Although most of the common device configuration files should be available
on the TFTP server, make sure that the configuration files for your devices are there.
• Ensure that the Cisco TFTP server is up and running and that the DHCP option for TFTP specifies the
correct server.
Procedure
Step 1 From Cisco Unified Communications Manager Administration, select System > Cisco Unified CM, then
click Find in the Find and List Cisco Unified Communications Managers window.
Step 2 Select the Cisco Unified Communications Manager in the cluster to use for autoregistration.
appears.
Step 3 In the Cisco Unified CM Configuration widow, configure the autoregistration parameters for the node in
the Auto-registration Information section, then click Save. For more information on the fields and their
configuration options, see the system Online Help.
a) Select the universal device template to use for autoregistration from the drop-down list.
If no universal device template is created for autoregistration, you can select Default Universal Device
Template. Make sure that the selected template specifies the device pool that is to be used for
autoregistration from User Management > User/Phone Add > Universal Device Template.
b) Select the universal line template to use for autoregistration from the drop-down list.
If no universal line template is created for autoregistration, you can select Default Universal Line
Template. Make sure that the selected template specifies the calling search space and the route partition
that are to be used for autoregistration from User Management > User/Phone Add > Universal Line
Template.
c) Enter the starting and ending directory numbers in to the Starting Directory Number and Ending
Directory Number fields.
Setting the starting and ending directory numbers to the same value disables autoregistration.
d) Uncheck Auto-registration Disabled on this Cisco Unified Communications Manager to enable
autoregistration for this node.
Always enable or disable autoregistration on only the selected Unified Communications Manager node. If
you switch the autoregistration function to another node in the cluster, you must reconfigure the Unified
Communications Manager nodes, the Default Unified Communications Manager group, and the default device
pools that you used.
Step 4 Select System > Cisco Unified CM Group, then click Find in the Find and List Cisco Unified
Communications Manager Groups window.
Step 5 Select the Unified Communications Manager group to enable for autoregistration.
In most cases, the name of this group is Default. You can choose a different Cisco Unified Communications
Manager group. The group must have at least one node selected.
Step 6 In the Cisco Unified CM Group Configuration window for that group, select Auto-registration Cisco
Unified Communications Manager Group to enable autoregistration for the group, then click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
370
Provisioning Endpoints
Disable Autoregistration
Tip Ensure that the Selected Cisco Unified Communications Managers list contains the node that
you configured for autoregistration. Use the arrows to move the node to appear in the list. The
Unified Communications Manager nodes get selected in the order in which they are listed. Save
your changes.
Note You can proceed to reconfigure the auto-registered phones and assign them to their permanent device pools.
The directory number that is assigned to the phone does not change when you change the phone location.
Note To register phones of a different type, change the device protocol type and install those devices before disabling
autoregistration.
Disable Autoregistration
Disable autoregistration for the node as soon as you are finished registering new devices.
Procedure
Step 1 In Cisco Unified Communications Manager Administration, select System > Cisco Unified CM, then click
Find in the Find and List Cisco Unified CM window.
Step 2 Select the Cisco Unified Communications Manager from the list of nodes.
Step 3 In the Cisco Unified CM Configuration widow for the selected node, check the Auto-registration Disabled
on this Cisco Unified Communications Manager check box to disable autoregistration for this node, then
click Save.
Tip Setting the same value in the Starting Directory Number and Ending Directory Number fields
also disables autoregistration.
What to do next
Optional. If you manually changed the directory number of an auto-registered device, or if you delete that
device from the database, you can reuse the directory number. For details, see Reuse Autoregistration Numbers,
on page 372.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
371
Provisioning Endpoints
Reuse Autoregistration Numbers
Procedure
Step 1 In Cisco Unified Communications Manager Administration, select System > Cisco Unified Communications
Manager
Step 2 Select the Cisco Unified Communications Manager to reset for autoregistration.
Step 3 Write down the current settings in the Starting Directory Number and Ending Directory Number fields.
Step 4 Click Auto-registration Disabled on this Cisco Unified Communications Manager, then click Save.
New phones cannot auto-register while autoregistration is disabled.
Step 5 Set the Starting Directory Number and Ending Directory Number fields to their previous values, then
click Save.
Tip You could set the fields to new values.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
372
CHAPTER 35
Configure Self-Provisioning
• Self-Provisioning Overview, on page 373
• Self-Provisioning Prerequisites, on page 374
• Self-Provisioning Configuration Task Flow, on page 375
Self-Provisioning Overview
The Self-Provisioning feature helps you provision phones for your network by giving end users the ability to
provision their own phones without contacting an administrator. If the system is configured for self-provisioning,
and an individual end user is enabled for self-provisioning, then end user can provision a new phone by
plugging the phone into the network and follow the specified few prompts. Cisco Unified Communications
Manager configures the phone and the phone line by applying pre-configured templates.
Self-provisioning can be used either by administrators to provision phones on behalf of their end users, or
end users can use self-provisioning to provision their own phones.
Self-provisioning is supported whether the cluster security setting is nonsecure or mixed mode.
Security Modes
You can configure self-provisioning in one of two modes:
• Secure mode—In secure mode, users or administrators must be authenticated in order to access
self-provisioning. End users can be authenticated against their password or PIN. Administrators can enter
a pre-configured authentication code.
• Non-secure mode—In non-secure mode, users or administrators can enter their user ID, or a
self-provisioning ID, in order to associate the phone to a user account. Non-secure mode is not
recommended for day-to-day use.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
373
Provisioning Endpoints
Self-Provisioning Prerequisites
Self-Provisioning Phones
When the feature is configured, you can provision a phone by doing the following:
• Plug the phone into the network.
• Dial the self-provisioning IVR extension.
• Follow the prompts to configure the phone, and associate the phone to an end user. Depending on how
you have configured self-provisioning, the end user may to enter the user password, PIN, or an
administrative authentication code.
Tip If you are provisioning a large number of phones on behalf of your end users, configure a speed dial on the
universal device template that forwards to the self-provisioning IVR extension.
Note Upon confirmation, the analog device is provisioned using the End User Primary Extension. The auto-registered
DN is released to the pool.
Self-Provisioning Prerequisites
Before your end users can use self-provisioning, your end users be configured with the following items:
• Your end users must have a primary extension.
• Your end users must be associated to a user profile or feature group template that includes a universal
line template, universal device template. The user profile must be enabled for self-provisioning.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
374
Provisioning Endpoints
Self-Provisioning Configuration Task Flow
Step 3 Configure CTI Route Point, on page 376 Configure a CTI route point to handle the
self-provisioning IVR service.
Step 4 Assign a Directory Number to the CTI Route Configure the extension that users will dial in
Point, on page 377 order to access the self-provisioning IVR and
associate that extension to the CTI route point.
Step 5 Configure Application User for Configure an application user for the
Self-Provisioning, on page 377 self-provisioning IVR. Associate the CTI route
point to the application user.
Step 6 Configure the System for Self-Provisioning, on Configure self-provisioning settings for your
page 378 system, including associating the application
user and CTI route point to the self-provisioning
IVR.
Step 7 Enable Self-Provisioning in a User Profile, on Enables the users to Self-Provision phones in
page 378 the user profile to which they are assigned.
Procedure
Step 1 From Cisco Unified Serviceability, choose Tools > Service Activation.
Step 2 From the Server drop-down list, select the publisher node and click Go.
Step 3 Under CM Services, check Cisco CTI Manager.
Step 4 Under CTI Services, check Self Provisioning IVR.
Step 5 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
375
Provisioning Endpoints
Enable Autoregistration for Self-Provisioning
Procedure
Step 1 In Cisco Unified CM Administration, choose System > Cisco Unified CM.
Step 2 Click on the publisher node.
Step 3 Select the Universal Device Template that you want to be applied to provisioned phones.
Step 4 Select the Universal Line Template that you want to be applied to the phone lines for provisioned phones.
Step 5 Use the Starting Directory Number and Ending Directory Number fields to enter a range of directory
numbers to apply to provisioned phones.
Step 6 Uncheck the Auto-registration Disabled on the Cisco Unified Communications Manager check box.
Step 7 Confirm the ports that will be used for SIP registrations. In most cases, there is no need to change the ports
from their default settings.
Step 8 Click Save.
Procedure
Step 1 From Cisco Unified CM Administration, choose, Device > CTI Route Points.
Step 2 Complete either of the following steps:
a) Click Find and select an existing CTI route point.
b) Click Add New to create a new CTI route point.
Step 3 In the Device Name field, enter a unique name to identify the route point.
Step 4 From the Device Pool drop-down list, select the device pool that specifies the properties for this device.
Step 5 From the Location drop-down list, select the appropriate location for this CTI route point.
Step 6 From the Use Trusted Relay Point drop-down list, enable or disable whether Unified Communications
Manager inserts a trusted relay point (TRP) device with this media endpoint. The default setting is to use the
Common Device Configuration setting that is associated to this device.
Step 7 Complete the remaining fields in the CTI Route Point Configuration window. For more information on the
fields and their settings, see the online help.
Step 8 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
376
Provisioning Endpoints
Assign a Directory Number to the CTI Route Point
Procedure
Step 1 From Cisco Unified CM Administration, choose Device > CTI Route Point.
Step 2 Click Find and select the CTI route point that you set up for self-provisioning.
Step 3 Under Association click Line [1] - Add a new DN.
The Directory Number Configuration window displays.
Step 4 In the Directory Number field, enter the extension that you want users to dial to access the Self-Provisioning
IVR service.
Step 5 Click Save.
Step 6 Complete the remaining fields in the Directory Number Configuration window. For more information with
the fields and their settings, see the online help.
Step 7 Click Save.
Procedure
Step 1 From Cisco Unified CM Administration, choose User > Application User.
Step 2 Perform either of the following steps:
a) To select an existing application user, click Find and select the application user.
b) To create a new application user, click Add New.
Step 3 In the User ID text box, enter a unique ID for the application user.
Step 4 Select a BLF Presence Group for the application user.
Step 5 Associate the CTI route point that you created to the application user by performing the following steps:
a) If the CTI route point that you created does not appear in the Available Devices list box, click Find More
Route Points.
The CTI route point that you created displays as an available device.
b) In the Available Devices list, select the CTI route point that you created for self-provisioning and click
the down arrow.
The CTI route point displays in the Controlled Devices list.
Step 6 Complete the remaining fields in the Application User Configuration window. For help with the fields and
their settings, see the online help.
Step 7 Click Save.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
377
Provisioning Endpoints
Configure the System for Self-Provisioning
Note In order to use the self-provisioning feature, your end users must also have the feature enabled in their user
profiles.
Procedure
Step 1 From Cisco Unified CM Administration, choose User Management > Self-Provisioning.
Step 2 Configure whether you want the self-provisioning IVR to authenticate end users by clicking one of the
following radio buttons:
• Require Authentication—In order to use the self-provisioning IVR, end users must enter their password,
PIN, or a system authentication code.
• No Authentication Required—End users can access the self-provisioning IVR without authenticating.
Step 3 If the self-provisioning IVR is configured to require authentication, click one of the following radio buttons
to configure the method whereby the IVR authenticates end users:
• Allow authentication for end users only—End users must enter their password or PIN.
• Allow authentication for users (via Password/PIN) and Administrators (via Authentication
Code)—End Users must enter an authentication code. If you choose this option, configure the
authentication code by entering an integer between 0 and 20 digits in the Authentication Code text box.
Step 4 In the IVR Settings list boxes, use the arrows to select the Language that you prefer to use for IVR prompts.
The list of available languages depends on the language packs that you have installed on your system. Refer
to the Downloads section of cisco.com if you want to download additional language packs.
Step 5 From the CTI Route Points drop-down list, choose the CTI route point that you have configured for your
self-provisioning IVR.
Step 6 From the Application User drop-down list, choose the application user that you have configured for
self-provisioning.
Step 7 Click Save.
Note If you don’t know which user profile your users are using, you can open a user’s settings in the End User
Configuration window and view the User Profile field to get the correct profile.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
378
Provisioning Endpoints
Enable Self-Provisioning in a User Profile
Procedure
Step 1 From Cisco Unified CM Administration, choose User Management > User Settings > User Profile.
Step 2 Click Find and select the user profile to which the user is assigned.
Step 3 Assign Universal Line Templates and Universal Device Templates to the user profile.
Step 4 Configure user settings for Self-Provisioning:
• Check the Allow End User to Provision their own phones check box.
• Enter a limit for the number of phones a user can provision. The default is 10.
• If you want users to be able to use self-provisioning to reassign a previously assigned phone, check the
Allow Provisioning of a phone that is already assigned to a different End User setting in the user
profile page associated with the end user of old device. Users can reassign a previously assigned phone
only if this check box is enabled in the User Profile that is associated to the old device.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
379
Provisioning Endpoints
Enable Self-Provisioning in a User Profile
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
380
PA R T VI
Reference Information
• Cisco Unified Communications Manager TCP and UDP Port Usage, on page 383
• Port Usage Information for the IM and Presence Service, on page 401
CHAPTER 36
Cisco Unified Communications Manager TCP and
UDP Port Usage
• Cisco Unified Communications Manager TCP and UDP Port Usage Overview, on page 383
• Port Descriptions, on page 385
• Port References, on page 399
See “Port Descriptions” for port details in each of the above categories.
Note Cisco has not verified all possible configuration scenarios for these ports. If you are having configuration
problems using this list, contact Cisco technical support for assistance.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
383
Reference Information
Cisco Unified Communications Manager TCP and UDP Port Usage Overview
Port references apply specifically to Cisco Unified Communications Manager. Some ports change from one
release to another, and future releases may introduce new ports. Therefore, make sure that you are using the
correct version of this document for the version of Cisco Unified Communications Manager that is installed.
While virtually all protocols are bidirectional, directionality from the session originator perspective is presumed.
In some cases, the administrator can manually change the default port numbers, though Cisco does not
recommend this as a best practice. Be aware that Cisco Unified Communications Manager opens several ports
strictly for internal use.
Installing Cisco Unified Communications Manager software automatically installs the following network
services for serviceability and activates them by default. Refer to “Intracluster Ports Between Cisco Unified
Communications Manager Servers” for details:
• Cisco Log Partition Monitoring (To monitor and purge the common partition. This uses no custom
common port.)
• Cisco Trace Collection Service (TCTS port usage)
• Cisco RIS Data Collector (RIS server port usage)
• Cisco AMC Service (AMC port usage)
Configuration of firewalls, ACLs, or QoS will vary depending on topology, placement of telephony devices
and services relative to the placement of network security devices, and which applications and telephony
extensions are in use. Also, bear in mind that ACLs vary in format with different devices and versions.
Note You can also configure Multicast Music on Hold (MOH) ports in Cisco Unified Communications Manager.
Port values for multicast MOH are not provided because the administrator specifies the actual port values.
Note The ephemeral port range for the system is 32768 to 61000, and the ports needs to be open to keep the phones
registered. For more information, see http://www.cisco.com/c/en/us/support/security/
asa-5500-series-next-generation-firewalls/tsd-products-support-series-home.html.
Note Make sure that you configure your firewall so that connections to port 22 are open, and are not throttled.
During the installation of IM and Presence subscriber nodes, multiple connections to the Cisco Unified
Communications Manager publisher node are opened in quick succession. Throttling these connections could
lead to a failed installation.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
384
Reference Information
Port Descriptions
Port Descriptions
Intracluster Ports Between Cisco Unified Communications Manager Servers
Table 28: Intracluster Ports Between Cisco Unified Communications Manager Servers
Unified Communications RTMT 1090, 1099 / TCP Cisco AMC Service for
Manager RTMT performance
monitors, data collection,
logging, and alerting
Unified Communications Unified Communications 1510 / TCP CAR IDS DB. CAR IDS
Manager (DB) Manager (DB) engine listens on waiting
for connection requests
from the clients.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
385
Reference Information
Intracluster Ports Between Cisco Unified Communications Manager Servers
Standard CCM Admin Unified Communications 5005 / TCP This port is used by SOAP
Users / Admin Manager CDROnDemand2 services
Unified Communications Unified Communications 7000, 7001, 7002 / TCP This port is used for
Manager (Tomcat) Manager (TCTS) communication between
Cisco Trace Collection
Tool Service and Cisco
Trace Collection servlet.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
386
Reference Information
Intracluster Ports Between Cisco Unified Communications Manager Servers
Unified Communications Unified Communications 8500 / TCP and UDP Intracluster replication of
Manager (IPSec) Manager (IPSec) system data by IPSec
Cluster Manager
Unified Communications Unified Communications 8888 - 8889 / TCP RIS Service Manager
Manager (RIS) Manager (RIS) status request and reply
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
387
Reference Information
Common Service Ports
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
388
Reference Information
Common Service Ports
Endpoint or Gateway Unified Communications 69, 6969, then Ephemeral Trivial File Transfer
Manager / UDP Protocol (TFTP) service
to phones and gateways
CUCM Server SNMP SNMP trap destination 162 / UDP SNMP traps
Primary Agent application
Unified Communications DHCP Server 546 / UDP DHCPv6. DHCP port for
Manager IPv6.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
389
Reference Information
Common Service Ports
Endpoint Unified Communications 443, 8443 / TCP Used for Cisco User Data
Manager Services (UDS) requests
Unified Communications Unified Communications 5060, 5061 / TCP Provide trunk-based SIP
Manager Manager services
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
390
Reference Information
Ports Between Cisco Unified Communications Manager and LDAP Directory
Unified Communications External Directory 389, 636, 3268, 3269 / Lightweight Directory
Manager TCP Access Protocol (LDAP)
query to external directory
External Directory Unified Communications Ephemeral (Active Directory,
Manager Netscape Directory)
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
391
Reference Information
Signaling, Media, and Other Communication Between Phones and Cisco Unified Communications Manager
Phone Unified Communications 69, then Ephemeral / UDP Trivial File Transfer
Manager (TFTP) Protocol (TFTP) used to
download firmware and
configuration files
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
392
Reference Information
Signaling, Media, and Other Communication Between Phones and Cisco Unified Communications Manager
Phone Unified Communications 5060 / TCP and UDP Session Initiation Protocol
Manager (SIP) phone
Phone Unified Communications 9443 / TCP Phone use this port for
Manager authenticated contact
search.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
393
Reference Information
Signaling, Media, and Other Communication Between Gateways and Cisco Unified Communications Manager
Gateway Unified Communications 69, then Ephemeral / UDP Trivial File Transfer
Manager (TFTP) Protocol (TFTP)
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
394
Reference Information
Signaling, Media, and Other Communication Between Gateways and Cisco Unified Communications Manager
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
395
Reference Information
Communication Between Applications and Cisco Unified Communications Manager
Gateway Unified Communications 5060 / TCP and UDP Session Initiation Protocol
Manager (SIP) gateway and
Intercluster Trunk (ICT)
Unified Communications Gateway
Manager
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
396
Reference Information
Communication Between Applications and Cisco Unified Communications Manager
Unified Communications Unified Communications 1101 / TCP RMI server sends RMI
Manager Attendant Manager callback messages to
Console clients on these ports.
Unified Communications IOS Router running SAF 5050 / TCP Multi-Service IOS Router
Manager with SAF/CCD image running EIGRP/SAF
Protocol.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
397
Reference Information
Communication Between CTL Client and Firewalls
Cisco Unified Unified Communications 8443 / TCP AXL / SOAP API for
Communications App Manager programmatic reads from
or writes to the Cisco
Unified Communications
Manager database that
third parties such as
billing or telephony
management applications
use.
CTL Client TLS Proxy Server 2444 / TCP Certificate Trust List
(CTL) provider listening
service in an ASA firewall
Table 37: Communication Between Cisco Smart Licensing Service and Cisco Smart Software Manager
Unified Communications Cisco Smart Software 443 / HTTPS Smart Licensing Service
Manager (Cisco Smart Manager (CSSM) sends the license usage to
Licensing Service) CSSM to check whether
Unified CM is a
complaint or not.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
398
Reference Information
Special Ports on HP Servers
Port References
Firewall Application Inspection Guides
ASA Series reference information
http://www.cisco.com/c/en/us/support/security/asa-5500-series-next-generation-firewalls/
tsd-products-support-series-home.html
PIX Application Inspection Configuration Guides
http://www.cisco.com/c/en/us/support/security/pix-firewall-software/
products-installation-and-configuration-guides-list.html
FWSM 3.1 Application Inspection Configuration Guide
http://www-author.cisco.com/c/en/us/td/docs/security/fwsm/fwsm31/configuration/guide/fwsm_cfg/inspct_
f.html
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
399
Reference Information
VMware Port Assignment List
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
400
CHAPTER 37
Port Usage Information for the IM and Presence
Service
• IM and Presence Service Port Usage Overview, on page 401
• Information Collated in Table, on page 401
• IM and Presence Service Port List, on page 402
Note Cisco has not verified all possible configuration scenarios for these ports. If you are having configuration
problems using this list, contact Cisco technical support for assistance.
While virtually all protocols are bidirectional, this document gives directionality from the session originator
perspective. In some cases, the administrator can manually change the default port numbers, though Cisco
does not recommend this as a best practice. Be aware that the IM and Presence Service opens several ports
strictly for internal use.
Ports in this document apply specifically to the IM and Presence Service. Some ports change from one release
to another, and future releases may introduce new ports. Therefore, make sure that you are using the correct
version of this document for the version of IM and Presence Service that is installed.
Configuration of firewalls, ACLs, or QoS will vary depending on topology, placement of devices and services
relative to the placement of network security devices, and which applications and telephony extensions are
in use. Also, bear in mind that ACLs vary in format with different devices and versions.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
401
Reference Information
IM and Presence Service Port List
Protocol Either a Session-layer protocol used for establishing and ending communications,
or an Application-layer protocol used for request and response transactions
SIP Gateway IM and SIP TCP/UDP 5060 Ephemeral Default SIP Proxy UDP
Presence and TCP Listener
--------------
--------------
IM and
Presence SIP Gateway
IM and IM and HTTP TCP 8081 Ephemeral Used for HTTP requests
Presence Presence from the Config Agent to
indicate a change in
configuration.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
402
Reference Information
IM and Presence Service Port List
Third-party IM and HTTPS TLS / TCP 8083 Ephemeral Default IM and Presence
Client Presence HTTPS Listener. Used
for Third-Party Clients to
connect
Browser IM and HTTPS TCP 8080 Ephemeral Used for web access
Presence
Browser IM and AXL / TLS / TCP 8443 Ephemeral Provides database and
Presence HTTPS serviceability access via
SOAP
Browser IM and HTTPS TLS / TCP 8443 Ephemeral Provides access to Web
Presence administration
Browser IM and HTTPS TLS / TCP 8443 Ephemeral Provides access to User
Presence option pages
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
403
Reference Information
IM and Presence Service Port List
Browser IM and SOAP TLS / TCP 8443 Ephemeral Provides access to Cisco
Presence Unified Personal
Communicator, Cisco
Unified Mobility
Advantage, and
third-party API clients
via SOAP
Table 43: IM and Presence Service Ports - External Corporate Directory Requests
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
404
Reference Information
IM and Presence Service Port List
IM and IM and TCP TCP 1500 Ephemeral Internal IDS port for
Presence Presence Database clients.
(Database) (Database) Localhost traffic only.
IM and IM and Proprietary UDP/TCP 8500 8500 Internal port - cluster manager port
Presence Presence used by the ipsec_mgr daemon for
(IPSec) (IPSec) cluster replication of platform data
(hosts) certs
Table 48: IM and Presence Service Ports - DRF Master Agent Server Requests
IM and IM and TCP TCP 4040 Ephemeral DRF Master Agent server
Presence Presence port, which accepts
(DRF) (DRF) connections from Local
Agent, GUI, and CLI
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
405
Reference Information
IM and Presence Service Port List
SNMP Server IM and SNMP UDP 161, 8161 Ephemeral Provides services for
Presence SNMP-based
management applications
IM and IM and SNMP UDP 6162 Ephemeral Native SNMP agent that
Presence Presence listens for requests
forwarded by SNMP
master agents
IM and IM and SNMP UDP 6161 Ephemeral SNMP Master agent that
Presence Presence listens for traps from the
native SNMP agent, and
forwards to management
applications
SNMP Server IM and TCP TCP 7999 Ephemeral Used as a socket for the
Presence cdp agent to
communicate with the
cdp binary
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
406
Reference Information
IM and Presence Service Port List
IM and SNMP Trap SNMP UDP 162 Ephemeral Sends SNMP traps to
Presence Monitor management applications
IM and IM and XML TCP 8888 and Ephemeral Internal port. Localhost
Presence Presence 8889 traffic only. Used to
(RIS) (RIS) listen to clients
communicating with the
RIS Service Manager
(servM).
IM and DNS Server DNS UDP 53 Ephemeral The port that DNS server
Presence listen on for IM and
Presence DNS queries.
To: DNS Server | From:
IM and Presence
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
407
Reference Information
IM and Presence Service Port List
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
408
Reference Information
IM and Presence Service Port List
Table 57: IM and Presence Service Ports - Microsoft Exchange Notify Requests
IM and RTMT TCP TCP 1090 Ephemeral AMC RMI Object port.
Presence Cisco AMC Service for
RTMT performance
monitors, data collection,
logging, and alerting.
IM and RTMT TCP TCP 1099 Ephemeral AMC RMI Registry port.
Presence Cisco AMC Service for
RTMT performance
monitors, data collection,
logging, and alerting.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
409
Reference Information
IM and Presence Service Port List
XMPP Client IM and TCP TCP 5222 Ephemeral Client access port
Presence
Third-party IM and TCP TCP 7335 Ephemeral HTTP listening port used
BOSH client Presence by the XCP Web
Connection Manager for
BOSH third-party API
connections
IM and IM and UDP UDP 5353 Ephemeral MDNS port. XCP routers
Presence Presence in a cluster use this port
(XCP Router (XCP Router to discover each other.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
410
Reference Information
IM and Presence Service Port List
IM and IM and TCP TCP 20075 Ephemeral The port that Cisco
Presence Presence Server Recovery
(Server (Server Manager uses to provide
Recovery Recovery admin rpc requests.
Manager) Manager)
IM and IM and UDP UDP 21999 Ephemeral The port that Cisco
Presence Presence Server Recovery
(Server (Server Manager uses to
Recovery Recovery communicate with its
Manager) Manager) peer.
Table 63: IM and Presence Service Ports - In Memory Database Replication Messages
* If you want to run the Administration CLI Diagnostic Utility, using the utils imdb_replication status
command, these ports must be open on all firewalls that are configured between IM and Presence Service
nodes in the cluster. This setup is not required for normal operation.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
411
Reference Information
IM and Presence Service Port List
Table 64: IM and Presence Service Ports - In Memory Database SQL Messages
Table 65: IM and Presence Service Ports - In Memory Database Notification Messages
Table 66: IM and Presence Service Ports - Force Manual Sync/X.509 Certificate Update Requests
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
412
Reference Information
IM and Presence Service Port List
Table 68: Ports used for IM and Presence - Cisco Unified CM communication and IM and Presence Publisher - Subscriber communication
Cisco Unified IM and TCP 1500 Bi-directional Internal ID port for Database
Communications Presence clients. Localhost traffic
Manager Publisher only.
Cisco Unified IM and TCP 1090 Bi-directional AMC RMI Object port.
Communications Presence Cisco AMC Service for
Manager Publisher RTMT performance
monitors, data collection,
logging, and alerting.
Cisco Unified IM and TCP 8600 Bi-directional Config Agent heartbeat port
Communications Presence
Manager Publisher
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
413
Reference Information
IM and Presence Service Port List
IM and IM and UDP 21999 Bi-directional The port that Cisco Server
Presence Presence Recovery Manager uses to
Publisher Subscriber communicate with its peer.
IM and Cisco Unified TCP 4040 Bi-directional DRF Master Agent server
Presence Communications port that accepts connections
Publisher Manager from Local Agent, GUI, and
CLI.
IM and IM and TCP 20075 Bi-directional The port that Cisco Server
Presence Presence Recovery Manager uses to
Publisher Subscriber provide admin RPC requests.
IM and IM and TCP 20075 Bi-directional The port that Cisco Server
Presence Presence Recovery Manager uses to
Subscriber Publisher provide admin RPC requests.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
414
Reference Information
IM and Presence Service Port List
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
415
Reference Information
IM and Presence Service Port List
See the Cisco Unified Serviceability Administration Guide for information about SNMP.
System Configuration Guide for Cisco Unified Communications Manager, Release 12.5(1)SU4
416