Download - Sme Deploy 861
-
8/6/2019 Sme Deploy 861
1/96
Americas Headquarters
Cisco Systems, Inc.170 West Tasman DriveSan Jose, CA 95134-1706USAhttp://www.cisco.comTel: 408 526-4000
800 553-NETS (6387)Fax: 408 527-0883
Cisco Unified Communications ManagerSession Management Edition, Release
8.6(1)Version 8.6(1)
Text Part Number: OL-25265-01
http://www.cisco.com/http://www.cisco.com/ -
8/6/2019 Sme Deploy 861
2/96
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 LICENSEOR 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 UCBs 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 D ATA 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.
Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other countries. A listing of Cisco's trademarks can be f ound at
www.cisco.com/go/trademarks. 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. (1005R)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not i ntended 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.
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1) 2011 Cisco Systems, Inc. All rights reserved.
http://www.cisco.com/go/trademarkshttp://www.cisco.com/go/trademarks -
8/6/2019 Sme Deploy 861
3/96
i
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
C O N T E N T S
Preface v
Overview 1-1
Unified CM Session Management Edition Basics 1-1
When to Deploy Unified CM Session Management Edition 1-2
Differences Between Unified CM Session Management Edition and Standard Cisco Unified CMClusters 1-3
Architecture Overview 1-4
SIP Trunks 1-4
SIP Trunks for IP PSTN Connectivity 1-5H.323 Intercluster Trunks 1-5
H.323 Gateways 1-6
MGCP Gateways 1-6
Features New to Cisco Unified CM Release 8.5(1) 1-6
Trunk Type and Feature Recommendations for Multi-Cluster Deployments 1-7
Multiple Clusters That Run Cisco Unified CM 8.5 1-7
Multiple Clusters That Run Cisco Unified CM 8.5 and Pre-8.5 Versions 1-8
Unified CM Session Management Edition Components 1-10
Unified CM Session Management Edition Clusters 1-10
Unified CM Leaf Clusters 1-11
Third Party Leaf Cisco Unified CM Systems 1-11
IP PSTN Connectivity 1-11
Centralized Applications 1-11
Before you Begin 1-12
Licensing 1-12
Interoperability Testing 1-12
Installation Considerations 1-13
Unified CM Session Management Edition Design Considerations 1-13
Cisco Unified Communications Manager Trunks 2-1
A Comparison of SIP and H.323 Trunks 2-1
SIP Trunks Overview 2-4
General Deployment Considerations 2-5
SIP Trunk Features and Operation 2-5
SIP Trunks Can Run on All Active Unified CM Nodes 2-5
-
8/6/2019 Sme Deploy 861
4/96
Contents
ii
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Up to 16 SIP Trunk Destination IP Addresses 2-5
SIP OPTIONS Ping 2-6
SIP Early Offer Support over Cisco Unified CM SIP Trunks 2-6
QSIG over SIP Trunks 2-9
SIP Trunk Message Normalization and Transparency 2-9
Route Lists Run on All Active Unified CM Nodes 2-13
SIP Trunks Using DNS 2-14
High Availability for SIP Trunks 2-16
Multiple Source Cisco Unified CM Servers for Originating SIP Trunk Calls 2-16
Multiple Destination IP Addresses per SIP Trunk 2-17
Design Considerations When Using Run on All Active Unified CM Nodes 2-17
Multiple SIP Trunks Using Route Lists and Route Groups 2-17
SIP OPTIONS Ping 2-17
Load Balancing for SIP Trunks 2-17Outbound Calls over a Single SIP Trunk 2-18
Outbound Calls over Multiple SIP Trunks 2-18
SIP OPTIONS Ping 2-18
SIP Delayed Offer and Early Offer 2-18
Media Termination Points 2-19
DTMF Transport 2-21
SIP Trunk Transport Protocols 2-22
Secure SIP Trunks 2-22
Media Encryption 2-22
Signaling Encryption 2-22
Calling Party Number Transformation and SIP Trunks 2-23
SIP Trunk Service Types 2-24
Design Considerations for SIP Trunks 2-25
Considerations for SIP Intercluster Trunks 2-25
Using Standard Cisco Unified CM Groups with SIP Intercluster Trunks 2-25
Using Run on All Active Unified CM Nodes with SIP Intercluster Trunks 2-26
Using Standard Cisco Unified CM Groups and Run on All Active Unified CM Nodes with SIPIntercluster Trunks 2-27
Trunk Type and Feature Recommendations for Multi-Cluster Deployments 2-28
Multiple Clusters All Running Cisco Unified CM 8.5 or Later Releases 2-29
Multiple Clusters Running Cisco Unified CM 8.5 and Prior Releases 2-30
Trunk Design Considerations for Clustering over the WAN 2-31
Design Guidance for Clustering over the WAN with Leaf Cluster Trunks 2-32
Design Guidance for Clustering over the WAN with Unified CM Session Management EditionCluster Trunks 2-33
Other SIP Trunk Deployment Considerations 2-33
-
8/6/2019 Sme Deploy 861
5/96
Contents
iii
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
H.323 Trunks Overview 2-34
General H.323 Intercluster Trunk Deployment Considerations 2-34
Basic Operation of H.323 Trunks 2-35
H.323 Trunk Types 2-35
Intercluster Trunk (Non-Gatekeeper Controlled) 2-35
Intercluster Trunk (Gatekeeper Controlled) 2-42
H.225 Trunk (Gatekeeper Controlled) 2-43
High Availability for Gatekeeper Controlled Trunks 2-43
Load Balancing Outbound Calls over H.323 Gatekeeper Controlled Trunks 2-46
H.323 Outbound FastStart Call Connections 2-47
H.323 Trunks with Media Termination Points 2-48
DTMF Transport 2-48
H.323 Trunk Transport Protocols 2-48
Secure H.323 Trunks 2-48H.323 Operation in Cisco Unified CM 2-49
Other Design Considerations for H.323 Trunks 2-53
General SIP and H.323 Trunk Design Considerations 2-53
Deterministic Outbound Call Load Balancing over Cisco Unified CM Trunks 2-53
Codec Selection Over IP Trunks 2-54
Other MTP Uses 2-55
Other Design Considerations for Unified CM Session Management Edition Deployments 2-55
Unified CM Session Management Edition and SAF CCD Deployments 2-56
Advertising SAF CCD Routes to Leaf Clusters from/through Unified CM Session Management
Edition 2-56
Advertising SAF CCD Routes from Leaf Clusters to Unified CM Session Management Edition 2-56
Operational Considerations for Unified CM Session Management Edition and SAF CCDDeployments 2-58
Cisco Unified CM Trunks and Emergency Services 2-59
Capacity Planning for Cisco Unified CM IP Trunks 2-59
IP PSTN and IP Trunks to Service Provider Networks 2-60
Cisco Unified Border Element 2-60
Protocol and Media Interworking 2-60
Service Provider SIP Trunk Best Practice Recommendations 2-61
Design Considerations for Scalability and Redundancy 2-61
Security Best Practices 2-62
Management and Monitoring of Service Provider SIP Trunks 2-63
Trunk IP-PSTN Connection Models 2-63
Deployment Examples A-1
-
8/6/2019 Sme Deploy 861
6/96
Contents
iv
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
-
8/6/2019 Sme Deploy 861
7/96
v
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Preface
This preface describes the purpose, audience, organization, and conventions of this guide and provides
information on how to obtain related documentation.
Note This document may not represent the latest Cisco product information available. You can obtain the most
current documentation by accessing Cisco's product documentation page at this URL:
http://www.cisco.com/en/US/products/sw/voicesw/ps556/tsd_products_support_series_home.html
The preface covers these topics:
Purpose, page v
Audience, page v
Organization, page vi
Related Documentation, page vi
Conventions, page vi
Obtaining Documentation and Submitting a Service Request, page vii
Cisco Product Security Overview, page viii
PurposeThis document provides conceptual information about Cisco Unified Communicat ions Manager Session
Management Edition and its components as well as design considerations and guidelines for deploying
Cisco Unified Communications Manager Session Management Edition.
AudienceThe Cisco Unified Communications Manager Session Management Edition Deployment Guide provides
information for network administrators and designers who are responsible for deploying the Cisco
Unified Communications Manager Session Management Edition system. This guide requires knowledge
of telephony and IP networking technology.
http://www.cisco.com/en/US/products/sw/voicesw/ps556/tsd_products_support_series_home.htmlhttp://www.cisco.com/en/US/products/sw/voicesw/ps556/tsd_products_support_series_home.html -
8/6/2019 Sme Deploy 861
8/96
vi
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Preface
OrganizationThe following table shows the organization of this guide:
Related DocumentationFor information about Cisco Unified Communications Manager documentation, refer to the
documentation guide for your release at the following URL:
http://cisco.com/en/US/products/sw/voicesw/ps556/products_documentation_roadmaps_list.html .
ConventionsThis document uses the following conventions:
Chapter DescriptionChapter 1 Overview
This chapter provides an overview of Cisco Unified Communications Manager
Session Management Edition and a description of the system components.
Chapter 2 Cisco Unified Communications Manager Trunks
This chapter provides information about the trunks used in a Cisco Unified
Communications Manager Session Management Edition deployment as well as
design considerations for the system.
Appendix A Deployment Examples
This appendix provides a link to Cisco Unified Communications Manager Session
Management Edition deployment models.
Convention Description
boldface font Commands and keywords are in boldface.
italic font Arguments for which you supply values are in italics.
[ ] Elements in square brackets are optional.
{ x | y | z } Alternative keywords are grouped in braces and separated by vertical bars.
[ x | y | z ] Optional alternative keywords are grouped in brackets and separated by
vertical bars.
string A nonquoted set of characters. Do not use quotation marks around the stringor the string will include the quotation marks.
screen font Terminal sessions and information the system displays are in screen font.
boldface screen font Information you must enter is inboldface screen font.
italic screen font Arguments for which you supply values are in italic screen font.
This pointer highlights an important line of text in an example.
http://cisco.com/en/US/products/sw/voicesw/ps556/products_documentation_roadmaps_list.htmlhttp://cisco.com/en/US/products/sw/voicesw/ps556/products_documentation_roadmaps_list.html -
8/6/2019 Sme Deploy 861
9/96
vii
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Preface
Notes use the following conventions:
Note Means reader take note. Notes contain helpful suggestions or references to material not covered in the
publication.
Timesavers use the following conventions:
Timesaver Means the described action saves time. You can save time by performing the action described in the
paragraph.
Tips use the following conventions:
Tip Meansthe information contains useful tips.
Cautions use the following conventions:
Caution Means reader be careful. In this situation, you might do something that could result in equipment
damage or loss of data.
Warnings use the following conventions:
Warning This warning symbol means danger. You are in a situation that could cause bodily injury. Before you
work on any equipment, you must be aware of the hazards involved with electrical circuitry and
familiar with standard practices for preventing accidents.
Obtaining Documentation and Submitting a Service RequestFor information on obtaining documentation, submitting a service request, and gathering additional
information, see the monthly Whats New in Cisco Product Documentation, which also lists all new and
revised Cisco technical documentation, at:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
Subscribe to the Whats New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed
and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free
service and Cisco currently supports RSS Version 2.0.
^ The symbol represents the key labeled Controlfor example, the key
combination ^D in a screen display means hold down the Control key while
you press the D key.
< > Nonprinting characters, such as passwords, are in angle brackets.
Convention Description
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.htmlhttp://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html -
8/6/2019 Sme Deploy 861
10/96
viii
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Preface
Cisco Product Security OverviewThis product contains cryptographic features and is subject to United States and local country laws
governing import, export, transfer and use. Delivery of Cisco cryptographic products does not imply
third-party authority to import, export, distribute or use encryption. Importers, exporters, distributors
and users are responsible for compliance with U.S. and local country laws. By using this product youagree to comply with applicable laws and regulations. If you are unable to comply with U.S. and local
laws, return this product immediately.
Further information regarding U.S. export regulations may be found at
http://www.access.gpo.gov/bis/ear/ear_data.html .
http://www.access.gpo.gov/bis/ear/ear_data.htmlhttp://www.access.gpo.gov/bis/ear/ear_data.html -
8/6/2019 Sme Deploy 861
11/96
C H A P T E R
1-1
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
1Overview
Unified Communications deployments using Cisco Unified Communications Manager Session
Management Edition (Unified CM Session Management Edition) are a variation of the multisite
distributed call processing deployment model and are typically employed to interconnect large numbers
of unified communications systems through a single front-end system, in this case the Unified CM
Session Management Edition. This document discusses the relevant design considerations for deploying
Unified CM Session Management Edition.
Unified CM Session Management Edition is essentially a Cisco Unified Communications Manager
(Cisco Unified CM) cluster with trunk interfaces only and no IP endpoints. It enables aggregation of
multiple unified communications systems, referred to as leaf systems.
Unified CM Session Management Edition deployments can be used to migrate a deployment of multiple
PBXs and associated phones to a Cisco Unified CM cluster with IP phones and relatively few trunks.
The Unified CM Session Management Edition cluster may start with a large number of trunks
interconnecting third-party PBXs; and migrate over time to a Cisco Unified CM cluster deployment with
thousands of IP phones.
This section contains the following information:
Unified CM Session Management Edition Basics, page 1-1
Architecture Overview, page 1-4
Trunk Type and Feature Recommendations for Multi-Cluster Deployments, page 1-7
Unified CM Session Management Edition Components, page 1-10
Centralized Applications, page 1-11
Before you Begin, page 1-12
Unified CM Session Management Edition BasicsWith Cisco Unified CM 8.0 and later releases, Unified CM Session Management Edition supports the
following features:
H.323 Annex M1 intercluster trunks
SIP intercluster trunks
SIP trunks
H.323 trunks
MGCP trunks
-
8/6/2019 Sme Deploy 861
12/96
-
8/6/2019 Sme Deploy 861
13/96
1-3
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 1 Overview
Unified CM Session Management Edition Basics
systems with a simplified dial plan and trunk(s) that point to the session management cluster.
Unified CM Session Management Edition maintains the centralized dial plan and corresponding
reachability information about all of the other unified communications systems.
Provide centralized PSTN accessUnified CM Session Management Edition can be used to
aggregate PSTN access to one (or more) centralized IP PSTN trunks. Centralized PSTN access is
commonly combined with the reduction, or elimination, of branch-based PSTN circuits. Centralize applicationsThe deployment of a Unified CM Session Management Edition enables
commonly used applications, such as conferencing or videoconferencing to connect directly to the
session management cluster, which reduces the overhead of managing multiple trunks to leaf
systems.
Aggregate PBXs for migration to a unified communications systemUnified CM Session
Management Edition provides an aggregation point for multiple PBXs as part of the migration from
legacy PBXs to a Cisco Unified CM system.
Differences Between Unified CM Session Management Edition and Standard
Cisco Unified CM ClustersThe Unified CM Session Management Edition software is exactly the same as Cisco Unified CM;
however, the software has been enhanced significantly to satisfy the requirements and the constraints of
this new deployment model. Unified CM Session Management Edition is designed to support a large
number of trunk-to-trunk connections, and as such, it is subject to the following design considerations:
CapacityIt is important to correctly size the Unified CM Session Management Edition cluster
based on the expected BHCA traffic load between leaf unified communications systems (for
example, Cisco Unified CM clusters and PBXs), to and from any centralized IP PSTN connections,
and to any centralized applications. Work with your Cisco account Systems Engineer (SE) or Cisco
partner to size your Unified CM Session Management Edition cluster correctly.
TrunksWhere possible, avoid the use of static MTPs on Cisco Unified CM trunks (that is, "MTP
required" must not be checked on the leaf or session management Cisco Unified CM SIP or H.323trunks). MTP-less trunks offer more codec choices, support voice, video, and encryption, and do not
anchor trunk calls to MTP resources. If SIP Early Offer is required by a third-party unified
communications system, use the Delayed Offer to Early Offer feature with Cisco Unified Border
Element (CUBE). Dynamically inserted MTPs can be used on trunks (for example, for DTMF
translation from in-band to out-of-band).
Unified CM versions Both the Unified CM Session Management Edition and Cisco Unified CM
leaf clusters should be deployed with Cisco Unified CM 7.1(2) or later release. Earlier versions of
Cisco Unified CM can be deployed but might experience problems that can be resolved only by
upgrading your cluster to a Cisco Unified CM 7.1(2) or later release.
InteroperabilityThough most vendors do conform to standards, differences can and do exist
between protocol implementations from various vendors. As with any standard Cisco Unified CM
cluster, Cisco strongly recommends that you conduct end-to-end system interoperability testingwith any unverified third-party unified communications system before deploying the system in a
production environment. The interoperability testing should verify call flows and features from
Cisco and third-party leaf systems through the Unified CM Session Management Edition cluster. To
-
8/6/2019 Sme Deploy 861
14/96
1-4
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 1 Overview
Architecture Overview
learn which third-party unified communications systems have been tested by the Cisco
Interoperability team, go to www.cisco.com/go/interoperability and select the link for Cisco Unified
Communications Manager - Session Management Edition.
Load balancing for inbound and outbound callsConfigure trunks on the Unified CM Session
Management Edition and leaf unified communications systems so that inbound and outbound calls
are evenly distributed across the Cisco Unified CM servers within the session management cluster.For more information on load balancing for trunk calls, refer to the chapter on Cisco Unified
Communications Manager Trunks section on page 2-1.
Design assistanceUnified CM Session Management Edition designs should be reviewed by your
Cisco SE in conjunction with the Cisco Unified CM Session Management Team. For more
information of the Unified CM Session Management Edition design review process, Cisco partners
and employees can refer to the documentation at the following URL:
http://docwiki.cisco.com/wiki/Unified_Communications_Manager_-_Session_Manager_Edition
Architecture OverviewEvery Unified CM Session Management Edition design consists of a Unified CM Session Management
Edition cluster and a number of leaf Cisco Unified CM clusters or leaf third-party unified
communications systems. How these leaf systems connect to the Unified CM Session Management
Edition cluster largely depends on the protocols and features that are required to be supported by each
system. A Unified CM Session Management Edition cluster can support SIP, H.323 or MGCP Trunks.
Each of these trunk protocols have their own merits, but as a general rule, with a Unified CM Session
Management Edition cluster that runs Cisco Unified CM 8.5, Cisco recommends SIP trunks as they offer
a greater set of features when compared to H.323 and MGCP trunks. The choice of trunk used on Unified
CM Session Management Edition is often determined by the end system to which Unified CM Session
Management Edition is connecting.
The following topics give a brief overview of Unified CM Session Management Edition trunk
capabilities (the features and capabilities of Unified CM Session Management Edition trunk types are
discussed in detail later in this document) and decribes a number of Unified CM Session ManagementEdition trunking use cases:
SIP Trunks, page 1-4
H.323 Intercluster Trunks, page 1-5
H.323 Gateways, page 1-6
MGCP Gateways, page 1-6
SIP Trunks
SIP trunks can be used as intercluster trunks between Unified CM Session Management Edition and leaf
Cisco Unified CM clusters, as trunks to third party unified communications systems, and SIP-based IP
PSTNs. Today, SIP is arguably the most commonly chosen protocol when connecting to service
providers and unified communications applications. Cisco Unified CM 8.5 provides the following SIP
trunk and call routing related features and functionality, which provides highly available trunk
connections with dynamic reachability detection and good load balancing capabilties :
Up to 16 destination IP addresses per trunk, which can be run on all Cisco Unified CM nodes
SIP OPTIONS Ping keepalives
http://www.cisco.com/go/interoperabilityhttp://docwiki.cisco.com/wiki/Unified_Communications_Manager_-_Session_Manager_Editionhttp://docwiki.cisco.com/wiki/Unified_Communications_Manager_-_Session_Manager_Editionhttp://www.cisco.com/go/interoperability -
8/6/2019 Sme Deploy 861
15/96
1-5
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 1 Overview
Architecture Overview
SIP Early Offer support for voice and video calls (insert MTP if needed)
QSIG over SIP
SIP Trunk Normalization and Transparency
Route Lists that can be run on all Unified CM nodes
Because of the SIP trunk features that are available in this release, Cisco recommends SIP for new andexisting trunk connections.
SIP Trunks for IP PSTN Connectivity
Service providers are increasingly offering IP PSTN connections to enterprise customers. Cisco strongly
recommends that you connect to the IP PSTN via a CUBE as an enterprise edge session border controller.
(SBC). CUBE provides a controlled demarcation and security point for the following functions:
Address and port translations (privacy and Layer 7 topology hiding)
Media interworking (DTMF, fax, codec transcoding and transrating, volume/gain control,
RTP-SRTP conversion)
Call Admission Control (based on total calls, CPU, Memory, call arrival spike detection, ormaximum calls per destination)
Security (DoS attack protection, toll fraud protection, SIP malformed packet detection, and number
of signaling and media encryption options)
Complaince with the SP SIP trunk UNI specification
H.323 Intercluster Trunks
For intercluster trunk (ICT) connections between Unified CM Session Management Edition and Cisco
Unified CM leaf clusters, where the leaf cluster is using a version of Cisco Unified CM prior to release
8.5, Cisco generally recommends H.323 non-gatekeeper-controlled ICTs as they offer addditional
features in comparison with SIP and MGCP trunks, such as up to three configurable destination
addresses, support for H.323 Annex M1 (QSIG over H.323).
For ICT connections between Unified CM Session Management Edition and Cisco Unified CM leaf
clusters using Cisco Unified CM release 8.5, H.323 non-gatekeeper-controlled ICTs offer the following
additional functionality:
Run on all Cisco Unified CM nodes
Allow up to 16 destination IP addresses per trunk
Run route lists on all Cisco Unified CM nodes
Note H.323 gatekeeper-controlled ICTs do not support the capability to run on all Cisco Unified CM nodes
or allow up to 16 destination IP addresses to be defined per trunk; however, they can support more than16 destination IP addresses by using the gatekeeper to return destination addresses to the calling cluster
-
8/6/2019 Sme Deploy 861
16/96
1-6
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 1 Overview
Architecture Overview
H.323 Gateways
Use H.323 gateway trunks for non-gatekeeper-controlled connections to H.323-based third party Cisco
Unified CM systems. H.323 gateway trunks support standard Cisco Unified CM groups and a single
configurable destination IP address.
MGCP Gateways
MGCP gateways support standard Cisco Unified CM groups and a single configurable destination IP
address. Prior to Cisco Unified CM 8.5, MGCP gateways were the only option for connecting a
QSIG-based TDM PBX to Cisco Unified CM via an IOS gateway. Cisco Unified CM 8.5 now supports
QSIG over SIP connections to IOS gateways. These standard Cisco Unified CM SIP trunks support all
of the features described previously for SIP trunks. MCGP trunks are often preferred by customers
because minimal configuration is required in the IOS gateway. For example, no dial peers need to be
configured in the IOS gateway as the Q.931/QSIG signaling is backhauled to Cisco Unified CM.
Although MGCP trunks reduce configuration overhead, they do not support the dynamic reachability
detection and load balancing capabilties of SIP trunks.
Features New to Cisco Unified CM Release 8.5(1)
Cisco Unified CM 8.5 and later releases provide the following SIP trunk and call routing enhancements.
These enhancements can be utilized in a Unified CM Session Management Edition deployment when the
system components run this version of Cisco Unified CM.
SIP OPTIONSThe SIP OPTIONS method allows a SIP trunk to track the status of remote
destinations. By sending outgoing OPTIONS and checking the incoming response message, the SIP
trunk knows whether remote peers are ready to receive a new request. The SIP trunk does not attempt
to set up new calls to unreachable remote peers; this approach allows for quick failovers.
Up to 16 destination IP addresses per trunkFor SIP trunks, Cisco Unified CommunicationsManager supports up to 16 IP addresses for each DNS SRV and up to 10 IP addresses for each DNS
host name. The order of the IP addresses depends on the DNS response and may be identical in each
DNS query. The OPTIONS request may go to a different set of remote destinations each time if a
DNS SRV record (configured on the SIP trunk) resolves to more than 16 IP addresses, or if a host
name (configured on the SIP trunk) resolves to more than 10 IP addresses. Thus, the status of a SIP
trunk may change because of a change in the way a DNS query gets resolved, not because of any
change in the status of any of the remote destinations.
SIP Early Offer support for voice and video calls (insert MTP if needed)To enhance
interoperability with third party SIP devices, Cisco Unified CM now allows you to configure SIP
trunks to enable early offer for outgoing voice and video calls without requiring MTP, when media
capabilities and media port information of the calling endpoint is available. For outgoing call setup
for an early offer trunk, Cisco Unified CM includes an SDP with the calling device media port,
codecs, and IP address of the calling device (when available); inserts an MTP for early offer only
when the media information for the caller is unavailable; and advertises multiple codecs when an
MTP that supports multiple codecs gets inserted. The early offer feature enhancement in this release
ensures that a higher percentage of outbound early offer SIP trunk calls get made without requiring
an MTP, thus reducing the number of MTP resources needed and improving interoperability with
third party PBXs.
-
8/6/2019 Sme Deploy 861
17/96
1-7
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 1 Overview
Trunk Type and Feature Recommendations for Multi-Cluster Deployments
QSIG over SIPCisco Unified CM supports QSIG tunneling over a SIP trunk. QSIG tunneling
supports the following features: Call Back, Call Completion, Call Diversion, Call Transfer,
Identification Services, Message Waiting Indication, and Path Replacement.
SIP trunk normalization and transparencySIP transparency and normalization allow Cisco
Unified CM to seamlessly interoperate with a variety of PBXs and service providers. Normalization
allows you to modify incoming and outgoing SIP messages at a protocol level on their way throughCisco Unified CM. Transparency allows Cisco Unified CM to pass headers, parameters, and content
bodies from one call leg to the other.
Run route lists on all Cisco Unified CM nodes The SIP trunk features available in the 8.5 release
make SIP the preferred choice for new and existing trunk connections. The QSIG over SIP feature
provides parity with H.323 intercluster trunks and can also be used to provide QSIG over SIP trunk
connections to Cisco IOS gateways (and on to QSIG-based TDM PBXs). The ability to run on all
Cisco Unified CM nodes and to handle up to 16 destination IP addresses improves outbound call
distribution from Cisco Unified CM clusters and reduces the number of SIP trunks required between
clusters and devices. SIP OPTIONS ping provides dynamic reachability detection for SIP trunk
destinations, rather than per-call reachability determination. SIP Early Offer support for voice and
video calls (insert MTP if needed) can reduce or eliminate the need to use MTPs and allows voice,
video, and encrypted calls to be made over SIP Early Offer trunks.
For the complete list of new enhancements for SIP trunks for this release, refer to theNew and Changed
for Cisco Unified Communications Manager 8.5(1) document available at
http://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_release_notes_list.html
Trunk Type and Feature Recommendations for Multi-ClusterDeployments
This section describes the following multi-cluster deployments:
Multiple Clusters That Run Cisco Unified CM 8.5, page 1-7
Multiple Clusters That Run Cisco Unified CM 8.5 and Pre-8.5 Versions, page 1-8
Multiple Clusters That Run Cisco Unified CM 8.5
When all Cisco Unified CM clusters run version 8.5, the following SIP trunk features and functionality
should be used where applicable:
SIP OPTIONS Ping
Early offer support for voice and video (insert MTP if needed)
Capability to run on all nodes
Multiple destination IP addresses
QSIG over SIP
Deploying these features reduces MTP usage, provides high availability, even call distribution, and
dynamic SIP trunk failure detection. For inbound SIP trunk calls to Cisco Unified CM, Cisco
recommends SIP Early Offer.
SIP ICTs support voice, video, and encrypted media between Cisco Unified CM clusters, as well as all
of the features previously listed. If multiple trunks are used with route lists, enable the "Run on All
Nodes" feature on the route list.
http://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_release_notes_list.htmlhttp://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_release_notes_list.html -
8/6/2019 Sme Deploy 861
18/96
1-8
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 1 Overview
Trunk Type and Feature Recommendations for Multi-Cluster Deployments
For SIP trunks to an IP PSTN, SIP Early Offer is typically required by the service provider and most
providers support voice calls only; however, video calls and encrypted media are also supported. For
inbound SIP trunk calls to Cisco Unified CM, Cisco recommends SIP Early Offer.
SIP trunks to third party Cisco Unified CM systems may support voice, video, and encrypted media.
Check the capabilities of the end system to determine the SIP trunk features and media capabilities that
it supports. For inbound SIP trunk calls to Cisco Unified CM, Cisco recommends SIP Early Offer.
Note Be aware that SIP trunks on IOS gateways always send SIP Early Offer.
For SIP trunk connections to the IP PSTN and third party Cisco Unified CM systems, you can use
Normalization and Transparency scripts to address SIP interoperability issues. Cisco also recommends
the deployment of the CUBE on any IP PSTN SIP trunk connection from Cisco Unified CM to a voice
service provider. Figure 1-2 provides an example of multi-cluster deployments with Cisco Unified
CM 8.5.
Figure 1-2 Multi-Cluster Deployments With Cisco Unified CM 8.5
Multiple Clusters That Run Cisco Unified CM 8.5 and Pre-8.5 Versions
This section describes the trunk types and features that you should use when Cisco Unified CM leaf
clusters run release 8.5 and pre-8.5 versions of Cisco Unified CM.
When the leaf cluster runs an earlier version (pre-8.5) of Cisco Unified CM and voice, video and
encryption are required, use H.323 Slow Start ICTs and Annex M1 (QSIG), if desired. Deploy one or
more H.323 Slow Start ICTs that use standard Cisco Unified CM groups and up to three destination IP
addresses. If multiple trunks are used with route lists, and to avoid the route local rule described in the
Route Lists Run on All Active Unified CM Nodes section on page 2-13, ensure that the primary server
in the route list's Cisco Unified CM group is not co-resident on the same node as an associated outbound
H.323 trunk.
254879
SIP Early Offer
SIP Early Offer (insert MTP if needed)
Unified CM 8.5
IP
IP
IP PSTN
IP
IP
CUBE CUBESIP
Unified CM 8.5
Unified CMSession Management
Edition 8.5
-
8/6/2019 Sme Deploy 861
19/96
1-9
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 1 Overview
Trunk Type and Feature Recommendations for Multi-Cluster Deployments
For leaf clusters that run Cisco Unified CM 8.5, use a SIP Delayed Offer ICT, enable the Run on All
Nodes feature, and use multiple destination IP addresses and SIP OPTIONS Ping for high availability
and even call distribution. If multiple trunks are used with route lists, enable the "Run on All Nodes"
feature on the route list.
Using SIP Delayed Offer ICTs on Cisco Unified CM 8.5 leaf clusters and H.323 Slow Start ICTs on leaf
clusters using earlier versions of Cisco Unified CM, allows voice, video and encrypted calls to be madebetween clusters and reduces the number of MTPs required (MTPs are only inserted when required for
DTMF translation, transcoding and so on).
For Unified CM Session Management Edition SIP trunks to IP PSTN deployments, SIP Early Offer is
typically required by the service provider and most providers support voice calls only. Use Early Offer
support for voice and video (insert MTP if needed), or Delayed Offer on this SIP trunk and, if supported
by the end system, SIP OPTIONS Ping, Run on All Nodes, and multiple destination IP addresses. For
inbound SIP trunk calls to Cisco Unified CM, Cisco recommends SIP Early Offer.
Unified CM Session Management Edition SIP trunks to third party Cisco Unified CM systems may
support voice, video and encrypted media. Use Early Offer support for voice and video (insert MTP if
needed), or Delayed Offer on this SIP trunk. Check the capabil ities of the end system to determine which
other Cisco Unified CM SIP trunk features are available. For inbound SIP trunk calls to Cisco Unified
CM, Cisco recommends SIP Early Offer.
Note Be aware that SIP trunks on IOS gateways always send SIP Early Offer.
For Unified CM Session Management Edition SIP trunk connections to the IP PSTN and third party
Cisco Unified CM systems, you can use Normalization and Transparency scripts to address SIP
interoperability issues. Cisco also recommends the deployment of the CUBE on any IP PSTN SIP trunk
connection from Cisco Unified CM to a voice service provider.
Figure 1-3 provides an example of multi-cluster deployments with Unified CM Session Management
Edition 8.5 and Cisco Unified CM leaf clusters that run release 8.5 and pre-8.5 versions of Cisco Unified
CM.
-
8/6/2019 Sme Deploy 861
20/96
1-10
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 1 Overview
Unified CM Session Management Edition Components
Figure 1-3 Multi-Cluster Deployments With Unified CM Session Management Edition 8.5, Cisco Unified CM 8.5 and
Cisco Unified CM Pre-8.5
Unified CM Session Management Edition ComponentsThis section describes the components of the Unified CM Session Management Editionand contains the
following topics:
Unified CM Session Management Edition Clusters, page 1-10 Unified CM Leaf Clusters, page 1-11
Third Party Leaf Cisco Unified CM Systems, page 1-11
IP PSTN Connectivity, page 1-11
Unified CM Session Management Edition Clusters
Unified CM Session Management Edition cluster servers can be deployed on the following platforms:
UCS B200 M1/M2 blade server
UCS C210 M1/M2 2U rack server
MCS 7845-I3 and HP DL380G6
As a general recommendation, Cisco Unified CM 8.5 or later should be deployed on the Unified CM
Session Management Edition cluster, as these versions benefit from a number of trunk-specific feature
enhancements. If you want to use an earlier version of Cisco Unified CM, Cisco recommends Cisco
Unified CM 7.1(2) or later. Although you can deploy versions of Cisco Unified CM that are earlier than
release 7.1(2), be aware that you may experience problems that can be resolved only by upgrading your
cluster to a Cisco Unified CM 7.1(2) or later release.
254880
SIP Early Offer
SIP Early Offer (insert MTP if needed)
Unified CM 8.0
IP
IP
IP PSTN
IP
IP
CUBE CUBESIP
Unified CM 8.5
Unified CMSession Management
Edition 8.5
H.323 Slow Start
H.323 Slow Start
SIP Delayed Offer
-
8/6/2019 Sme Deploy 861
21/96
1-11
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 1 Overview
Centralized Applications
Unified CM Leaf Clusters
Cisco recommends that you deploy Cisco Unified CM leaf clusters with a Cisco Unified CM 7.1(2) or
later release. Earlier versions of Cisco Unified CM can be deployed but might experience problems that
can be resolved only by upgrading your cluster to Cisco Unified CM 7.1(2) or later release.
Third Party Leaf Cisco Unified CM Systems
In most cases, the third party Cisco Unified CM system's capabilities (for example, support for SIP
and/or H.323) determines the trunking protocol that is used by Unified CM Session Management
Edition. When an application supports both SIP and H.323 protocols, use SIP trunks with Unified CM
Session Management Edition 8.5 clusters. For Unified CM Session Management Edition clusters that
run versions prior to version 8.5, use either SIP trunks or H.323-based gateways/trunks.
Where possible, if SIP is used, the third party Cisco Unified CM system should send SIP Early Offer
over the SIP trunk to Unified CM Session Management Edition. If H.323 is used, the third party Cisco
Unified CM system should send H.323 Fast Start over the H.323 trunk to Unified CM Session
Management Edition.
IP PSTN Connectivity
CUBE is a key component in the enterprise network and is deployed at the edge of the enterprise network
for IP PSTN connectivity to service providers. It provides a controlled demarcation and security
network-to-network interface point. CUBE is a licensed Cisco IOS application that is available on the
following platforms:
Cisco Integrated Service Routers Generation 2 (ISR-G2s such as 29xx, 39xx)
Cisco 1000 Series Aggregation Services Routers (ASRs)
Cisco Integrated Service Routers (ISRs such as 28xx, 38xx)
Cisco AS5000XM Media Gateways
Depending on the hardware platform, CUBE can provide session scalability from 4 to 16,000 concurrent
voice calls. For scalability and redundancy, CUBE offers the following functionality:
The ISR-G2 platforms offer Box-to-box redundancy with media preservation for stable active calls
(CUBE 8.5 in Cisco IOS Release 15.1.2T)
The ASR platforms offer box-to-box or inbox redundancy with media and signaling preservation
(stateful failover) for stable active calls (Release 3.2)
Centralized ApplicationsThe deployment of a Unified CM Session Management Edition enables commonly used applications,
such as conferencing or videoconferencing to connect directly to the session management cluster, which
reduces the overhead of managing multiple trunks to leaf systems.
Unified CM Session Management Edition supports the following applications:
Unity, Unity Connection
Meeting Place, Meeting Place Express
-
8/6/2019 Sme Deploy 861
22/96
1-12
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 1 Overview
Before you Begin
SIP and H.323-based video conferencing systems
Third Party voice mail systems
Fax servers
Cisco Unified Mobility
The following applications must connect to the leaf cluster:
Unified Contact Centre, Unified Contact Centre Express
Cisco Unified Presence Server
Attendant Console
Manager Assistant
IP IVR
Cisco Voice Portal
As a general rule, applications that rely only on numbering to establish calls can connect to Unified CM
Session Management Edition. Applications that require additional interfaces or need to track device
state, such as CTI, must connect to the leaf cluster.
If phones are deployed on the Unified CM Session Management Edition cluster, any standard Cisco
Unified CM applications can be deployed to serve these phones.
Before you BeginMindy, reformat and possibly add info to this section to tie all of these loose ends together. Consider a
checklist with these sections linked from the checklist.
Licensing
You can purchase Unified CM Session Management Edition session licenses as part of the hardware and
software purchasing process, or as part of a Cisco Unified CM system upgrade. You can purchase
additional session licenses and install them at any time after the initial Unified CM Session Management
Edition installation.
For information about ordering Unified CM Session Management Edition licenses, refer to the Cisco
Unified Communications Solutions Ordering Guide at the following URL:
http://www.cisco.com/web/partners/downloads/partner/WWChannels/technology/ipc/downloads/uc_so
l_og_ucl_final.pdf
Unified CM Session Management Edition licenses are based on the number of sessions. The number of
Sessions is the number of Concurrent calls that are supported through the Unified CM Session
Management Edition system.
Interoperability Testing
Although most vendors do conform to standards, differences can and do exist between protocol
implementations from various vendors. As with any standard Cisco Unified CM cluster, Cisco strongly
recommends that you conduct end-to-end system interoperability testing with any unverified third party
unified communications system before deploying the system in a production environment. The
interoperability testing should verify call flows and features from Cisco and third party leaf systems
http://www.cisco.com/web/partners/downloads/partner/WWChannels/technology/ipc/downloads/us_sol_og_ucl_final.pdfhttp://www.cisco.com/web/partners/downloads/partner/WWChannels/technology/ipc/downloads/us_sol_og_ucl_final.pdfhttp://www.cisco.com/web/partners/downloads/partner/WWChannels/technology/ipc/downloads/us_sol_og_ucl_final.pdfhttp://www.cisco.com/web/partners/downloads/partner/WWChannels/technology/ipc/downloads/us_sol_og_ucl_final.pdf -
8/6/2019 Sme Deploy 861
23/96
1-13
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 1 Overview
Before you Begin
through the Cisco Unified CM cluster. To learn which third party unified communications systems have
been tested by the Cisco Interoperability team, go to http://www.cisco.com/go/interoperability and
select the link for Cisco Unified Communications ManagerSession Management Edition.
CUBE has also been tested for interoperability with different service providers for their SIP trunk
offerings, as well as connectivity to different IP-PBXs. The detailed list and configuration guides are
available at http://www.cisco.com/go/interoperability .Make sure that you have a discussion about system testing with your Cisco account team. Cisco can
provide a generic system test plan if you require it and Cisco advanced services can also be engaged to
conduct onsite interoperability testing.
Installation Considerations
Unified CM Session Management Edition uses exactly the same software as Cisco Unified CM and
supports a subset of Cisco Unified CM hardware platforms. The installation of an Unified CM Session
Management Edition cluster is exactly the same as a Cisco Unified CM cluster.
Unified CM Session Management Edition Design Considerations
Unified CM Session Management Edition cluster designs are a variation on distributed call processing
designs for Cisco Unified CM clusters, as described in the Cisco Unified Communications System 8.x
SRND document. The key difference between Cisco Unified CM and Unified CM Session Management
Edition cluster designs is that, with a Unified CM Session Management Edition design the focus is on
trunks rather than endpoints, such as IP Phones. Use the design guidelines that are provided in the Cisco
Unified Communications System 8.x SRND document for aspects of Unified CM Session Management
Edition cluster design that are not covered in this document. You can access the Cisco Unified
Communications System 8.x SRND document at the following URL:
http://www.cisco.com/en/US/partner/products/sw/voicesw/ps556/products_implementation_design_gu
ides_list.htmlAll Unified CM Session Management Edition deployments use either one, or a combination of Cisco
Unified CM trunks to interconnect leaf Cisco Unified CM systems, IP PSTN connections and Cisco
Unified CM applications. The following chapter discusses Cisco Unified CM trunks in detail.
http://www.cisco.com/go/interoperabilityhttp://www.cisco.com/go/interoperabilityhttp://www.cisco.com/en/US/partner/products/sw/voicesw/ps556/products_implementation_design_guides_list.htmlhttp://www.cisco.com/en/US/partner/products/sw/voicesw/ps556/products_implementation_design_guides_list.htmlhttp://www.cisco.com/en/US/partner/products/sw/voicesw/ps556/products_implementation_design_guides_list.htmlhttp://www.cisco.com/go/interoperabilityhttp://www.cisco.com/go/interoperability -
8/6/2019 Sme Deploy 861
24/96
1-14
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 1 Overview
Before you Begin
-
8/6/2019 Sme Deploy 861
25/96
C H A P T E R
2-1
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
2Cisco Unified Communications Manager Trunks
A trunk is a communications channel on Cisco Unified Communications Manager (Cisco Unified CM)
that enables Cisco Unified CM to connect to other servers. Using one or more trunks, Cisco Unified CM
can receive or place voice, video, and encrypted calls, exchange real-time event information, and
communicate in other ways with call control servers and other external servers.
Trunks are an integral and a crucial part of a Cisco Unified Communications deployment, hence it isimportant to understand the types of trunks available, their capabilities, and design and deployment
considerations such as resiliency, capacity, load balancing, and so forth.
There are two basic types of trunks that can be configured in Cisco Unified CM:
SIP and H.323 trunks, both of which can be used for external communications
Intercluster trunks (ICTs)
This chapter describes the general capabilities and functions of these trunks:
This chapter discusses the following topics:
A Comparison of SIP and H.323 Trunks, page 2-1
SIP Trunks Overview, page 2-4
H.323 Trunks Overview, page 2-34
General SIP and H.323 Trunk Design Considerations, page 2-53
Other Design Considerations for Unified CM Session Management Edition Deployments
A Comparison of SIP and H.323 TrunksCisco Unified CM trunk connections support both SIP and H.323. In many cases, the decision to use SIP
or H.323 is driven by the unique feature(s) offered by each protocol. There are also a number of external
factors that can affect the choice of trunk protocol, such as customer preference or the protocol's maturity
and degree of interoperability offered between various vendors' products.
For trunk connections between Cisco devices, this decision is relatively straightforward. For trunk
connections to other vendors' products and to service provider networks, it is important to understand
which features are required by the customer and the extent of interoperability between any two vendors'
products.
Table 2-1 compares some of the features offered over SIP and H.323 trunks between Cisco Unified CM
clusters.
-
8/6/2019 Sme Deploy 861
26/96
2-2
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 2 Cisco Unified Communications Manager Trunks
A Comparison of SIP and H.323 Trunks
Table 2-1 Comparison of SIP and H.323 Features on Cisco Unified Communications ManagerTrunks
Feature SIP QSIG over SIP H.323 QSIG over H.323
Calling Line (Number) Identification Presentation Yes Yes Yes Yes
Calling Line (Number) Identification Restriction Yes Yes Yes Yes
Calling Name Identification Presentation Yes Yes Yes Yes
Calling Name Identification Restriction Yes Yes Yes Yes
Connected Line (Number) Identification Presentation Yes Yes Yes Yes
Connected Line (Number) Identification Restriction Yes Yes Yes Yes
Connected Name Identification Presentation Yes Yes Yes Yes
Connected Name Identification Restriction Yes Yes Yes Yes
Alerting Name Yes Yes No Yes
Call Transfer (Blind/Attended) Yes/Yes Yes/Yes Yes/Yes Yes/Yes
Call Forward All Yes Yes Yes Yes
Call Forward Busy Yes Yes Yes Yes
Call Forward No Reply Yes Yes Yes Yes
Call Completion to Busy Subscriber No Yes No Yes
Call Completion No Reply No Yes No Yes
Subscribe/Notify, Publish Presence Yes Yes No No
Message Waiting Indication (MWI: lamp ON,
lamp OFF)
Yes Yes No Yes
Path Replacement No Yes No Yes
Call Hold/Resume Yes Yes Yes Yes
Music On Hold (unicast and multicast) Yes Yes Yes YesDTMF-relay RFC 2833,
KPML (OOB),
Unsolicited
Notify (OOB)
RFC 2833,
KPML (OOB),
Unsolicited
Notify (OOB)
H.245 Out Of
Band (OOB)1H.245 Out Of
Band (OOB)1
SIP Early Offer Yes MTP
may be
required
Yes MTP
may be
required
N/A N/A
SIP Delayed Offer Yes Yes N/A N/A
H.323 Fast Start N/A N/A Yes MTP
always
required forOutbound Fast
Start
Yes MTP
always required
for OutboundFast Start
H.323 Slow Start N/A N/A Yes Yes
Audio codecs G.711, G.722,
G.723, G.729,
iLBC, AAC,
iSAC
G.711, G.722,
G.723, G.729,
iLBC, AAC,
iSAC
G.711, G.722,
G.723, G.729
G.711, G.722,
G.723, G.729
-
8/6/2019 Sme Deploy 861
27/96
2-3
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 2 Cisco Unified Communications Manager Trunks
A Comparison of SIP and H.323 Trunks
Codecs with MTP All codecs
supported
when EarlyOffer support
for voice and
video calls
(insert MTP if
needed) is
checked
G.711, G.729
when MTP
Required is
checked
All codecs
supported
when EarlyOffer support
for voice and
video calls
(insert MTP if
needed) is
checked
G.711, G.729
when MTP
Required is
checked
G.711, G.723,
G.729
G.711, G.723,
G.729
Video Yes Yes Yes Yes
Video codecs H.261, H.263,H.263+,
H.264 AVC
H.261, H.263,H.263+,
H.264 AVC
H.261, H.263,H.263+,
H.264 AVC
H.261, H.263,H.263+,
H.264 AVC
T.38 Fax Yes Yes Yes Yes
Signaling Authentication Digest, TLS Digest, TLS No No
Signaling Encryption TLS TSL No No
Media Encryption (audio) SRTP SRTP SRTP SRTP
RSVP-based QoS and call admission control Yes Yes No No
Support for + character Yes Yes No No
Inbound Calls Called Party: Significant Digits,
Prefix-Digits
Yes Yes Yes Yes
Incoming Calling Party Settings: Strip Digits,
Prefix-Digits based on Number Type
SIP does not
support
Number Type -
"Unknown"
used for all
calls
SIP does not
support
Number Type -
"Unknown"
used for all
calls
Cisco Unified
CM, Unknown,
National,
International,
Subscriber
Cisco Unified
CM, Unknown,
National,
International,
Subscriber
Incoming Called Party Settings: Strip Digits,
Prefix-Digits based on Number Type
N/A N/A Cisco Unified
CM, Unknown,
National,
International,
Subscriber
Cisco Unified
CM, Unknown,
National,
International,
Subscriber
Connected Party Transformation Yes Yes No No
Outbound Calling Party Transformations Yes Yes Yes Yes
Outbound Called Party Transformations Yes Yes Yes Yes
Table 2-1 Comparison of SIP and H.323 Features on Cisco Unified Communications ManagerTrunks (continued)
Feature SIP QSIG over SIP H.323 QSIG over H.323
-
8/6/2019 Sme Deploy 861
28/96
2-4
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 2 Cisco Unified Communications Manager Trunks
SIP Trunks Overview
SIP Trunks OverviewSIP trunks on Cisco Unified CM/Unified CM Session Management Edition can be used for two different
purposes:
Intra-enterprise SIP trunks provide connectivity to other SIP devices such as gateways, Unified CM
Session Management Edition, SIP proxies, Unified Communications applications, and other Cisco
Unified CM clusters within the enterprise network.
Service provider SIP trunks provide offnet IP PSTN connectivity to a service provider network.
Today, SIP is arguably the most commonly chosen protocol when connecting to service providers and
Unified Communications applications. Cisco Unified CM 8.5 and later releases provide the following
SIP trunk and call routing enhancements:
Run on all Cisco Unified CM nodes
Up to 16 destination IP addresses per trunk
SIP OPTIONS ping keepalives
SIP Early Offer support for voice and video calls (insert MTP if needed)
QSIG over SIP
SIP trunk normalization and transparency
Run route lists on all Cisco Unified CM nodes
The SIP trunk features available in the 8.5 release make SIP the preferred choice for new and existing
trunk connections. The QSIG over SIP feature provides parity with H.323 intercluster trunks and canalso be used to provide QSIG over SIP trunk connections to Cisco IOS gateways (and on to QSIG-based
TDM PBXs). The ability to run on all Cisco Unified CM nodes and to handle up to 16 destination IP
addresses improves outbound call distribution from Cisco Unified CM clusters and reduces the number
of SIP trunks required between clusters and devices. SIP OPTIONS ping provides dynamic reachability
detection for SIP trunk destinations, rather than per-call reachability determination. SIP Early Offer
support for voice and video calls (insert MTP if needed) can reduce or eliminate the need to use MTPs
and allows voice, video, and encrypted calls to be made over SIP Early Offer trunks.
Outbound Calling/Called Party Number Type Setting SIP does not
support
Number Type
SIP does not
support
Number Type
Cisco Unified
CM, Unknown,
National,International,
Subscriber
Cisco Unified
CM, Unknown,
National,International,
Subscriber
Outbound Called/Called Party Numbering Plan
Setting
SIP does not
support
Number Plan
SIP does not
support
Number Plan
Cisco Unified
CM, ISDN,
National
Standard,
Private,
Unknown
Cisco Unified
CM, ISDN,
National
Standard,
Private,
Unknown
Trunk destination State detection mechanism OPTIONS Ping OPTIONS Ping Per call attempt Per call attempt
1. H.323 trunks support signaling of RFC 2833 for certain connection types.
Table 2-1 Comparison of SIP and H.323 Features on Cisco Unified Communications ManagerTrunks (continued)
Feature SIP QSIG over SIP H.323 QSIG over H.323
-
8/6/2019 Sme Deploy 861
29/96
2-5
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 2 Cisco Unified Communications Manager Trunks
SIP Trunks Overview
SIP trunk normalization and transparency improve native Cisco Unified CM interoperability with and
between third-party unified communications systems. Normalization allows inbound and outbound SIP
messages and SDP information to be modified on a per-SIP-trunk basis. Transparency allows Cisco
Unified CM to pass SIP headers, parameters, and content bodies from one SIP trunk call leg to another,
even if Cisco Unified CM does not understand or support the parts of the message that are being passed
through.
These features are discussed in detail later in this section.
For the complete list of new enhancements for SIP trunks, refer to the New and Changed for Cisco
Unified Communications Manager 8.5(1) document available at
http://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_release_notes_list.html
General Deployment Considerations
Cisco Unified CM SIP trunks offer a greater set of features in comparison with H.323 intercluster trunks,
thus making SIP the protocol of choice for intercluster trunk connections (although H.323 Annex M1
may still be preferred for intercluster trunk connections to Cisco Unified CM clusters using earlier
software versions). Also, given the wide support of SIP in the industry, SIP trunks are usually a goodchoice for connectivity to third-party applications and service providers.
SIP Trunk Features and Operation
This section explains how Cisco Unified CM SIP trunks operate and describes several key SIP trunk
features that should be taken into account when designing and deploying Cisco Unified CM SIP trunks.
SIP Trunks Can Run on All Active Unified CM Nodes
When the Run on all Active Unified CM Nodes option is checked on a SIP trunk, Cisco Unified CM
creates an instance of the SIP trunk daemon on every call processing subscriber within the cluster, thusallowing SIP trunk calls to be made or received on any call processing subscriber. (Prior to this feature,
up to three nodes could be selected per trunk by using Cisco Unified CM Groups.) With Run on all
Active Unified CM Nodes enabled, outbound SIP trunk calls originate from the same node on which
the inbound call (for example, from a phone or trunk) is received. As with all Cisco Unified CM SIP
trunks, the SIP daemons associated with the trunk will accept inbound calls only from end systems with
IP addresses that are defined in the trunk's destination address fields. Running SIP trunks on all nodes
is recommended where the SIP trunk is required to process a large number of calls so that outbound and
inbound call distribution can be evenly spread across all call processing subscribers within a cluster.
Also, when multiple SIP trunks to the same destination(s) are using the same subscriber, a unique
incoming and destination port number must be defined per trunk to allow each trunk to be identified
uniquely.
Up to 16 SIP Trunk Destination IP Addresses
SIP trunks can be configured with up to 16 destination IP addresses, 16 fully qualified domain names,
or a single DNS SRV entry. Support for additional destination IP addresses reduces the need to create
multiple trunks associated with route lists and route groups for call distribution between two Unified
Communications systems, thus simplifying Cisco Unified CM trunk design. (See Figure 2-1.) This
feature can be used in conjunction with the Run on all Active Unified CM Nodes feature or with a SIP
trunk that uses standard Cisco Unified CM Groups to create a SIP daemon on up to three nodes within
http://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_release_notes_list.htmlhttp://www.cisco.com/en/US/products/sw/voicesw/ps556/prod_release_notes_list.html -
8/6/2019 Sme Deploy 861
30/96
2-6
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 2 Cisco Unified Communications Manager Trunks
SIP Trunks Overview
the cluster. Bear in mind, however, that the SIP daemons associated with a Cisco Unified CM SIP trunk
will accept inbound calls only from end systems with IP addresses that are defined in the trunk's
destination address fields.
Figure 2-1 SIP Trunks with Multiple Destination IP Addresses Running on All Active Nodes
SIP OPTIONS Ping
The SIP OPTIONS Ping feature can be enabled on the SIP Profile associated with a SIP trunk to
dynamically track the state of the trunk's destination(s). When this feature is enabled, each node running
the trunk's SIP daemon will periodically send an OPTIONS Request to each of the trunk's destination IP
addresses to determine its reachability and will send calls only to reachable nodes. A destination address
is considered to be "out of service" if it fails to respond to an OPTIONS Request, if it sends a Service
Unavailable (503) response or Request Timeout (408) response, or if a TCP connection cannot be
established. The trunk state is considered to be "in service" when at least one node receives a response(other than a 408 or 503) from a least one destination address. SIP trunk nodes can send OPTIONS
Requests to the trunk's configured destination IP addresses or to the resolved IP addresses of the trunk's
DNS SRV entry. Enabling SIP OPTIONS Ping is recommended for all SIP trunks because it allows
Cisco Unified CM to dynamically track trunk state rather than determining trunk state on a per-call and
timeout basis.
SIP Early Offer Support over Cisco Unified CM SIP Trunks
SIP negotiates media exchange by means of the Session Description Protocol (SDP), where one side
offers a set of capabilities to which the other side answers, thus converging on a set of media
characteristics. SIP allows the initial offer to be sent either by the caller in the initial INVITE message
(Early Offer) or, if the caller chooses not to, the called party can send the initial offer in the first reliableresponse (Delayed Offer).
By default, Cisco Unified CM SIP trunks send the INVITE without an initial offer (Delayed Offer).
Cisco Unified CM has two configurable options to enable a SIP trunk to send the offer in the INVITE
(Early Offer):
Media Termination Point Required, page 2-7
Early Offer Support for Voice and Video Calls (Insert MTP If Needed), page 2-7
25
4784
CUBE
CUBE
Interclustertrunk
Trunk A
Trunk B
IP
IP
IP
IP
IP
-
8/6/2019 Sme Deploy 861
31/96
2-7
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 2 Cisco Unified Communications Manager Trunks
SIP Trunks Overview
Media Termination Point Required
Enabling the Media Termination Point Required option on the SIP trunk assigns an MTP from the
trunk's media resources group (MRG) to every outbound call. (See Figure 2-2.) This statically assigned
MTP supports only the G.711 or G.729 codecs, thus limiting media to voice calls only.
Figure 2-2 SIP Early Offer with Media Termination Point Required
Early Offer Support for Voice and Video Calls (Insert MTP If Needed)
Enabling Early Offer support for voice and video calls (insert MTP if needed) on the SIP Profile
associated with the SIP trunk inserts an MTP only if the calling device cannot provide Cisco Unified CM
with the media characteristics required to create the Early Offer. In general, Early Offer support for
voice and video calls (insert MTP if needed) is recommended because this configuration option
reduces MTP usage (see Figure 2-3). Calls from older SCCP-based phones registered to Cisco Unified
CM over SIP Early Offer trunks configured with this option will use an MTP to create the Offer SDP,
and these calls support voice, video, and encrypted media (see Endpoint Features Summary,page 19-50). Inbound calls to Cisco Unified CM from SIP Delayed Offer trunks or H.323 Slow Start
trunks that are extended over an outbound SIP Early Offer trunk will use an MTP to create the Offer
SDP; however, these calls support audio only in the initial call set up but can be escalated mid-call to
support video and SRTP if the call media is renegotiated (for example, after hold/resume). For guidance
on when to use Early Offer support for voice and video calls (insert MTP if needed) , see Design
Considerations for SIP Trunks, page 2-25.
Note MTP resources are not required for incoming INVITE messages, whether or not they contain an initial
offer SDP.
2547
85
SIP Trunk with Early OfferSIP Line
SCCP Line
SIP Trunk
H.323 Trunk
MGCP Trunk
SIP Trunk with Early Offer
SIP Trunk with Early Offer
SIP Trunk with Early Offer
SIP Trunk with Early Offer
MTP
MTP
MTP
MTP
MTP
IP
IP
http://../srnd/8x/endpnts.pdfhttp://../srnd/8x/endpnts.pdfhttp://../srnd/8x/endpnts.pdfhttp://../srnd/8x/endpnts.pdf -
8/6/2019 Sme Deploy 861
32/96
2-8
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 2 Cisco Unified Communications Manager Trunks
SIP Trunks Overview
Figure 2-3 Early Offer Support for Voice and Video Calls
Cisco Unified CM does not need to insert an MTP to create an outbound Early Offer call over a SIP trunk
if the inbound call to Cisco Unified CM is received by any of the following means:
On a SIP trunk using Early Offer
On an H.323 trunk using Fast Start
On an MGCP trunk
From a SIP-based IP phone registered to Cisco Unified CM
From newer SCCP-based Cisco Unified IP Phone models registered to Cisco Unified CM (see the
Endpoint Features Summary, page 19-50, for details)For the above devices, Cisco Unified CM uses the media capabilities of the endpoint and applies the
codec filtering rules based on the region-pair of the calling device and outgoing SIP trunk to create the
offer SDP for the outbound SIP trunk. In most cases, the offer SDP will have the IP address and port
number of the endpoint initiating the call. This is assuming that Cisco Unified CM does not have to insert
an MTP for other reasons such as a DTMF mismatch, TRP requirements, or a transcoder requirement
when there is no common codec between the regions of the calling device and the SIP trunk.
When Early Offer support for voice and video calls (insert MTP if needed) is configured on a trunk's
SIP Profile, calls from older SCCP-based phones (see Endpoint Features Summary, page 19-50), SIP
Delayed Offer trunks, and H.323 Slow Start trunks will cause Cisco Unified CM to allocate an MTP if
an MTP or transcoder has not already been allocated for that call for another reason. The MTP is used
to generate an offer SDP with a valid media port and IP address. The MTP will be allocated from the
media resources associated with the calling device rather than from the outbound SIP trunk's mediaresources. (This prevents the media path from being anchored to the outbound SIP trunk's MTP). If the
MTP cannot be allocated from the calling device's media resource group list (MRGL), then the MTP
allocation is attempted from the SIP trunk's MRGL.
For calls from older SCCP phones (see Endpoint Features Summary, page 19-50) registered to Cisco
Unified CM, some of the media capabilities of the calling device (for example, supported voice codecs,
video codecs, and encryption keys if supported) are available for media exchange through the Session
Description Protocol (SDP). Cisco Unified CM will create a superset of the endpoint and MTP codec
254786
H.323 Trunk
MGCP Trunk
IP
IP
SIP Line
SCCP Line
SCCP
Trunk
SIP Trunk
SIP Trunk with
Early Offer
SIP Trunk with
Early Offer
SIP Trunk with
Early Offer
SIP Trunk with
Early Offer
IP
Cisco SIPPhones
Newer SCCPPhones
Older SCCPPhones
SIP Early
Offer
SIP Trunk with
Early OfferIP
SIP DelayedOffer
SIP Trunk
SIP Trunk with
Early OfferIPSIP Trunk
SIP Trunk with
Early Offer
SIP Trunk with
Early Offer
H.323 SlowStart
H.323 FastStart
MGCP
Gateway
http://../srnd/8x/endpnts.pdfhttp://../srnd/8x/endpnts.pdfhttp://../srnd/8x/endpnts.pdfhttp://../srnd/8x/endpnts.pdfhttp://../srnd/8x/endpnts.pdfhttp://../srnd/8x/endpnts.pdf -
8/6/2019 Sme Deploy 861
33/96
2-9
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 2 Cisco Unified Communications Manager Trunks
SIP Trunks Overview
capabilities and apply the codec filtering based on the applicable region-pair settings. The outbound
Offer SDP will use the MTP's IP address and port number and can support voice, video, and encrypted
media. Note that the MTP should be configured to support the pass-through codec.
When Cisco Unified CM receives an inbound call on an H.323 Slow Start or SIP Delayed Offer trunk,
the media capabilities of the calling device are not available when the call is initiated. In this case, Cisco
Unified CM must insert an MTP and will use its IP address and UDP port number to advertise allsupported audio codecs (after region pair filtering) in the Offer SDP of the initial INVITE sent over the
outbound SIP trunk. When the Answer SDP is received on the SIP trunk, if it contains a codec that is
supported by the calling endpoint, then no additional offer-answer transaction is needed. In case of codec
mismatch, Cisco Unified CM can either insert a transcoder to address the mismatch or send a reINVITE
or UPDATE to trigger media negotiation. Calls from H.323 Slow Start or SIP Delayed Offer trunks
support audio only in the initial call setup, but they can be escalated mid-call to support video and SRTP
if the call media is renegotiated (for example, after Hold/Resume).
QSIG over SIP Trunks
Cisco Unified CM can encapsulate QSIG content in SIP messages, thus allowing features such as Call
Back, MWI, and Path Replacement to be invoked over SIP QSIG intercluster trunks and over SIP QSIG
trunks to Cisco IOS gateways. (See Figure 2-4.) QSIG over SIP trunks provides parity with the QSIG
feature set on H.323 Annex M1 intercluster trunks and MGCP QSIG trunks. (ISO and ECMA variants
of QSIG are supported on a per-trunk basis.)
Figure 2-4 QSIG over SIP Trunks
SIP Trunk Message Normalization and Transparency
Normalization and transparency provide powerful script-based functionality for SIP trunks that can be
used to transparently forward and/or modify SIP messages and message body contents as they traverse
Cisco Unified CM. Normalization and transparency scripts are designed to address SIP interoperability
issues, allowing Cisco Unified CM to interoperate with SIP-based third-party PBXs, applications, and
IP PSTN services.
SIP Trunk Normalization
Normalization allows incoming and outgoing SIP messages to be modified on their way through Cisco
Unified CM. Normalization applies to all calls that traverse a SIP trunk with an associated script,
regardless of what protocol is being used for the other endpoint involved in the call. For example, a SIP
trunk normalization script can operate on a call from a SIP line device to a SIP trunk, from an
SCCP-based device to a SIP trunk, from MGCP to SIP trunk, from H.323 to SIP trunk, and so forth. (See
Figure 2-5.) Normalization does not require end-to-end SIP.
254787
QSIG over
SIP Trunk
QSIG over
SIP Trunk
QSIG over
SIP Trunk
QSIG over
SIP Trunk
QSIG over
SIP Trunk
IP
QSIG over
SIP Trunk
IPIP
-
8/6/2019 Sme Deploy 861
34/96
2-10
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 2 Cisco Unified Communications Manager Trunks
SIP Trunks Overview
Figure 2-5 SIP Trunk Normalization
SIP Trunk Transparency
Transparency allows Cisco Unified CM to pass SIP headers, parameters, and content bodies from one
SIP trunk call leg to another, even if Cisco Unified CM does not understand or support the parts of the
message that are being passed through. Transparency (or transparent pass-through) is applicable only
when the call through Cisco Unified CM is from SIP trunk to SIP trunk, as illustrated in Figure 2-6.
Figure 2-6 SIP Trunk Transparency
Normalization and transparency scripts use Lua, a powerful, fast, lightweight, embeddable scriptinglanguage to modify SIP messages and SDP body content on SIP trunks. (For more information on Lua,
refer to the documentation available at http://lua-users.org/wiki/LuaOrgGuide .)
Cisco has created a library of Lua-based SIP Message APIs that allow specified information in the SIP
message and SDP body to be retrieved, modified, replaced, removed, passed through, ignored, appended
to, transformed, and so on. The underlying Lua language allows retrieved information to be stored as
variables and operated on using a series of operations such as: If, elseif, while, do, , =, and so forth.
The scripting approach naturally supports multiple variables and state-specific contexts for making
254788
Script
Script
Script
Script
H.323 Trunk
SIP/SCCP
SIP TrunkSIP Trunk
SIP Trunk
MGCP Truck SIP Trunk
SIP Trunk
IP PSTN
IP
IP PSTN
OCSServer
Script
Script
Script254789SIP Trunk
SIP Trunk
SIP TrunkSIP Trunk
SIP Trunk
SIP Trunk
OCSServer
OCSServer
OCSServer
http://lua-users.org/wiki/LuaOrgGuidehttp://lua-users.org/wiki/LuaOrgGuide -
8/6/2019 Sme Deploy 861
35/96
2-11
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 2 Cisco Unified Communications Manager Trunks
SIP Trunks Overview
script decisions. The combination of Cisco's SIP Message Library APIs and the functionality underlying
the Lua language creates a very powerful scripting environment that allows almost any SIP message
and/or its SDP body content to be modified.
For inbound messages on a SIP trunk, normalization and transparency script processing occurs
immediately after receiving the message from the network. For outbound messages, script processing
occurs immediately before sending the message to the network.Within a Lua script, callback functions (also known as message handlers) are used to request message
types of interest. The Cisco Lua environment constructs the name of the message handler based on the
message direction and method for requests (for example, inbound_INVITE) and based on the message
direction, response code, and method (from the CSeq header) for responses (for example,
outbound_180_INVITE). A message object (for example, msg) is passed to the message handler, thereby
allowing the script to modify the message (for example, inbound_INVITE(msg)).
Callback Function (message Handler) examples:
The Lua script then uses APIs defined in the Cisco SIP Message library to access and manipulate
message parameters. For example:
getHeader(header-name) returns header-value or ""
getHeaderValues(header-name) returns a table of header values
addHeaderValueParameter(header-name,parameter-name, [parameter-value])
getUri(header-name) retrieves the URI from the specified header
block() blocks the specified SIP message
applyNumberMask(header-name, mask) retrieves the specified header and applies the specified
number mask to the URI getSdp() returns the SDP content
sdp:getLine(start of line, line contains) returns line in SDP that starts with "start of line" and also
has string "line contains"
sdp:modifyLine(start of line, line contains,new-line) finds the in SDP that starts with "start of
line", the line matching "line contains" is replaced with the new-line parameter
The following examples illustrate the use of SIP Message API scripts.
Example 2-1 SIP Message API getRequestLine
getRequestLine() returns the method, request-uri, and version.
This method returns three values:
The method name
The request-uri
The protocol version
inbound_INVITE() outbound_INVITE()
inbound_UPDATE() outbound_SUBSCRIBE()
inbound_3XX_INVITE() outbound_180_INVITE()
-
8/6/2019 Sme Deploy 861
36/96
2-12
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 2 Cisco Unified Communications Manager Trunks
SIP Trunks Overview
Example script:
Line 1 initializes the set of callback functions to an empty value. This set of callback functions, named
M, is essentially a Lua table.
Lines 2 to 4 define a message handler. This callback function is executed when an outbound INVITE is
sent from Cisco Unified CM. The script then gets the method, request-uri, and version from the request
line and stores these values.
The script can define multiple message handlers. The name of the message handler dictates which
message handler is invoked (if any) for a given SIP message.
The last line returns the set of callbacks. This line is absolutely required.Message:
INVITE sip:[email protected] SIP/2.0
Output and result:
method == "INVITE"
ruri == "sip:[email protected]"
version == "SIP/2.0"
Example 2-2 A script that simply removes the "Cisco-Guid" header in an outbound INVITE
Line 1 initializes the set of callback functions to an empty value. This set of callback functions, named
M, is essentially a Lua Table.
Lines 2 to 4 define a message handler. This callback function is executed when an outbound INVITE is
sent from Cisco Unified CM. The script can define multiple message handlers. The name of the message
handler dictates which message handler is invoked (if any) for a given SIP message.
The last line returns the set of callbacks. This line is absolutely required.
Message:
INVITE sip:[email protected] SIP/2.0
.
P-Asserted-Identity: "1234"
Cisco-Guid: 1234-4567-1234
Session-Expires: 1800
Line 1 M = {}
Line 2 function M.outbound_INVITE(message)
Line 3 local method, ruri, ver = message:getRequestLine()
Line 4 end
Line 5 return M
Line 1 M = {}
Line 2 function M.outbound_INVITE(message)
Line 3 message:removeHeader("Cisco-Guid")
Line 4 end
Line 5 return M
-
8/6/2019 Sme Deploy 861
37/96
2-13
Cisco Unified Communications Manager Session Management Edition, Release 8.6(1)
OL-25265-01
Chapter 2 Cisco Unified Communications Manager Trunks
SIP Trunks Overview
Output and results:
INVITE sip:[email protected] SIP/2.0
.
P-Asserted-Identity: "1234"
For more information on SIP trunk normalization and transparency scripts, refer to theDeveloper Guide
for SIP Transparency and Normalization, available at
http://www.cisco.com/en/US/docs/voice_ip_comm/cucm/sip_tn/8_5_1/sip_t_n.html
Route Lists Run on All Active Unified CM Nodes
Although this is not specifically a SIP trunk feature, running route lists on all nodes provides benefits
for trunks in route lists and route groups. Running route lists on all nodes improves outbound call
distribution by using the "route local" rule to avoid unnecessary intra-cluster traffic.
For route lists, the route local rule operates as follows:
For outbound calls that use route lists (and associated route groups and trunks), when a call from a
registered phone or inbound trunk arrives at the node with the route list instance, Cisco Unified CM
checks to see if an instance of the selected outbound trunk exists on the same node as the route list.If so, Cisco Unified CM will use this