Cisco CallManager and Cisco IOS Interoperability Guide
Cisco CallManager and Cisco IOS Interoperability Guide
Cisco CallManager and Cisco IOS Interoperability Guide
Corporate 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 526-4100
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.
CCSP, CCVP, the Cisco Square Bridge logo, Follow Me Browsing, and StackWise are trademarks of Cisco Systems, Inc.; Changing the Way We Work, Live, Play, and Learn, and
iQuick Study are service marks of Cisco Systems, Inc.; and Access Registrar, Aironet, ASIST, BPX, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, Cisco, the Cisco
Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Empowering the Internet Generation,
Enterprise/Solver, EtherChannel, EtherFast, EtherSwitch, Fast Step, FormShare, GigaDrive, GigaStack, HomeLink, Internet Quotient, IOS, IP/TV, iQ Expertise, the iQ logo, iQ
Net Readiness Scorecard, LightStream, Linksys, MeetingPlace, MGX, the Networkers logo, Networking Academy, Network Registrar, Packet, PIX, Post-Routing, Pre-Routing,
ProConnect, RateMUX, ScriptShare, SlideCast, SMARTnet, StrataView Plus, TeleRouter, The Fastest Way to Increase Your Internet Quotient, and TransPath are registered
trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or Website 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. (0502R)
Contents 9
Contents 13
Contents 24
Prerequisites for Configuring MGCP Gateway Support for Cisco Unified CallManager 24
Restrictions for Configuring MGCP Gateway Support for Cisco Unified CallManager 25
Additional References 64
Contents 66
Configuring MGCP PRI Backhaul and T1 CAS Support for Cisco Unified CallManager 111
Contents 112
Contents 144
Contents 162
MCID 163
Configuration Examples for MCID for Cisco IOS Voice Gateways 169
Configuring MCID in Cisco IOS Release 12.3(14)T (Cisco 2801): Example 169
Configuring MCID in Cisco IOS Release 12.3(11)T (Cisco 3745): Example 171
Contents 175
Index
This guide provides configuration information about Cisco IOS voice features for Cisco Unified
CallManager and Cisco IOS Interoperability. This first chapter describes how to access Cisco Feature
Navigator and lists Cisco Unified CallManager and Cisco IOS Interoperability features by Cisco IOS
release.
Note For information about the full set of Cisco IOS voice features, see the entire Cisco IOS Voice
Configuration Library—including library preface, glossary, and other documents—at
http://www.cisco.com/univercd/cc/td/doc/product/software/ios123/123cgcr/voice_c/vcl.htm.
Contents
• Platforms and Cisco IOS Software Images, page 9
• Cisco Unified CallManager and Cisco IOS Interoperability Feature List, page 9
Table 1 Cisco Unified CallManager and Cisco IOS Interoperability Features (continued)
This chapter provides an overview of Cisco Unified CallManager and Cisco IOS interoperability.
Note For more information about Cisco IOS voice features, see the entire Cisco IOS Voice Configuration
Library—including library preface and glossary, feature documents, and troubleshooting
information—at
http://www.cisco.com/univercd/cc/td/doc/product/software/ios123/123cgcr/voice_c/vcl.htm.
Contents
• Information About Cisco Unified CallManager and Cisco IOS Interoperability, page 13
• Additional References, page 18
Cisco AVVID
Cisco voice gateway routers can be deployed in a Cisco Unified CallManager IP-telephony network
using the Cisco Architecture for Voice, Video, and Integrated Data (AVVID), a baseline infrastructure
that enables enterprises to design networks that scale to meet e-business demands for business solutions
such as e-learning and customer care.
Voice and video solutions based on Cisco AVVID include:
• Client devices such as IP phones
• Directory services
• IP-based business applications
• Network management
• Scalable call processing
• Service and support
• Video conferencing
gateways also provide multiple levels of failover capabilities, including Survivable Remote Site
Telephony (SRST) support to prevent call-processing interruptions or dropped calls if there is a Cisco
Unified CallManager or WAN failure.
MGCP gateways support the following Cisco Unified CallManager features:
• MGCP Gateway Fallback, page 15
• MGCP PRI Backhaul, page 16
• MGCP BRI Backhaul, page 16
• Multicast Music-On-Hold, page 16
• Network Specific Facilities, page 16
• Single-Point Configuration, page 16
• Supplementary Services, page 16
• Switchover (Failover), page 17
• Switchback, page 17
• Tones and Cadences, page 17
WAN
Gateway fallback
MGCP
application
Default application
62328
(H.323)
Multicast Music-On-Hold
Multicast music-on-hold (MOH) functionality enables the streaming of music from an MOH server to
the voice interfaces of on-net and off-net callers that are placed on hold. This integrated multicast
capability is implemented through the H.323 signaling in Cisco Unified CallManager.
Single-Point Configuration
When you configure MGCP gateways to interoperate with Cisco Unified CallManager, you can use a
centralized TFTP boot directory on a host device in your network to automatically download most of the
Cisco IOS configuration in an XML file. A Cisco Unified CallManager server can be concurrently
configured as a TFTP server.
The XML file is generated by using the web-based Cisco Unified CallManager graphical user interface
(GUI). When the network administrator changes the configuration information in the database,
Cisco Unified CallManager instructs the MGCP gateway to download the modified XML file.
Supplementary Services
Supplementary services include call forwarding, call hold, call transfer when the line is busy or there is
no answer, and three-party call conferencing to and from the PSTN or a private branch exchange (PBX).
• Call forwarding—Enables you to forward calls dialed from the original location to a remote location
within or across the network.
• Call hold—Places the handset in mute mode. The transmitter and receiver functions are disengaged
until the hold button is pressed again to reconnect the parties.
• Call transfer—Transfers a call to a third party through a preprogrammed button that produces a
recall dial tone. The receiver of the call then dials the third-party number, waits for the line to ring
and for the new called party to answer, and then hangs up.
• Three-party call conferencing—Adds a third party to a call. It is similar to the transfer function, but
rather than the call being transferred to a third party, the third party called is added to the call.
Switchover (Failover)
A Cisco MGCP gateway first connects—that is, registers—to a primary Cisco Unified CallManager. If
connection to the primary fails, the gateway registers automatically to a backup if one exists and, if that
connection also fails, to a second backup if one exists. When connection to the primary is restored, the
gateway automatically registers to the primary. Existing connections are preserved during the
switchover.
Switchback
Switchback is the process that MGCP gateways use to reestablish communication with the primary
Cisco Unified CallManager server when it becomes available after losing connectivity. Switchback
mode can occur immediately, at a specified time after the last active call ends, or after a specified length
of time. During the switchback, existing connections are preserved.
Additional References
The following sections provide references for Cisco IOS Interoperability with Cisco Unified
CallManager.
Related Documents
Standards
Standards Title
H.225 Call Signaling Protocols and Media Stream Packetization for
Packet-based Multimedia Communication Systems
H.323 Annex M.1 Tunnelling of Signalling Protocol (QSIG) in H.323
I.251.7 Malicious Call Identification (MCID)
I.255.3 Multi-Level Precedence and Preemption Service (MLPP)
ITU-T Recommendation Q.931 ISDN User-Network Interface Layer 3 specification (ITU-T
specification for signaling to establish, maintain, and clear ISDN
network connections).
Q.81.7 Malicious Call Identification (MCID)
Q.951.7 Stage 3 Description for Number Identification Supplementary
Services Using DSS 1: Malicious Call Identification (MCID)
TIA/EIA-464-B Requirements for Private Branch Exchange (PBX) Switching
Equipment
MIBs
MIBs MIBs Link
• Transcoding: To locate and download MIBs for selected platforms, Cisco IOS
releases, and feature sets, use Cisco MIB Locator found at the
– Access Environment MIB
following URL:
– CDP MIB
http://www.cisco.com/go/mibs
– Cisco Stack MIB
– DSP Management MIB
– RFC 1157 SNMP
– RFC 1213 MIB II
– RFC 1573 MIB II Interface Extensions
– RFC 1643 Ethernet MIB
– RFC 1757 Ethernet RMON
– Voice Common Interface MIB
– Voice Dial MIB
RFCs
RFCs Title
RFC 2833 RTP Payload for DTMF Digits, Telephony Tones and Telephony
Signals
Technical Assistance
Description Link
The Cisco Technical Support & Documentation http://www.cisco.com/techsupport
website contains thousands of pages of searchable
technical content, including links to products,
technologies, solutions, technical tips, and tools.
Registered Cisco.com users can log in from this page to
access even more content.
This chapter describes the basic tasks for configuring Cisco IOS MGCP gateways to interoperate with
Cisco Unified CallManager.
Feature History for MGCP Generic Configuration Support for Cisco Unified CallManager
Release Modification
12.2(2)XN This feature was introduced.
12.2(11)T This feature was integrated into Cisco IOS Release 12.2(11)T.
Finding Support Information for Platforms and Cisco IOS Software Images
Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image
support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on
Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at
the login dialog box and follow the instructions that appear.
Note For more information about this and related Cisco IOS voice features, see the following:
• “Overview of Cisco Unified CallManager and Cisco IOS Interoperability” on page 13.
• Entire Cisco IOS Voice Configuration Library—including library preface and glossary, other feature
documents, and troubleshooting documentation—at
http://www.cisco.com/univercd/cc/td/doc/product/software/ios123/123cgcr/voice_c/vcl.htm.
Contents
• Prerequisites for Configuring MGCP Gateway Support for Cisco Unified CallManager, page 24
• Restrictions for Configuring MGCP Gateway Support for Cisco Unified CallManager, page 25
• Information about MGCP Gateway Support for Cisco Unified CallManager, page 25
• How to Configure MGCP Gateway Support for Cisco Unified CallManager, page 26
• Configuration Examples for MGCP Gateway Support for Cisco CallManager, page 54
• Where to Go Next, page 63
• Additional References, page 64
Note Any configuration update that affects MGCP should be performed during a planned maintenance
window while MGCP is disabled; otherwise updating the configuration could disrupt MGCP
functionality. Before making any configuration changes, disable MGCP using the no mgcp command.
After all configuration changes are completed, use the mgcp command to enable MGCP.
Figure 2 shows a typical MGCP gateway that is controlled by an MGCP call agent.
POTS phones
TCP/IP network
IP
33342
MGCP-managed endpoints
The MGCP gateway receives most of its required configuration from the call agent. To configure an
MGCP gateway, you simply identify the Cisco Unified CallManager server associated with the gateway
and identify the gateway to the call agent. The MGCP gateway handles the translation between voice
signals and the packet network and interacts with the Cisco Unified CallManager server. The server
performs signal and call processing.
SUMMARY STEPS
1. enable
2. configure terminal
3. interface ethernet slot/port
4. ip address ip-address subnetmask
5. no shutdown
6. exit
7. hostname name
8. mgcp validate domain-name
9. mgcp
10. mgcp call-agent {ip-address | host-name} [port] [service-type type] [version version-number]
11. mgcp dtmf-relay voip codec {all | low-bit-rate} mode {cisco | nse | out-of-band}
12. ccm-manager mgcp
13. exit
DETAILED STEPS
Command Purpose
Step 1 enable Enables privileged EXEC mode.
• Enter your password when prompted.
Example:
Router> enable
Step 2 configure terminal Enters global configuration mode.
Example:
Router# configure terminal
Step 3 interface ethernet slot/port Enters interface configuration mode so that you can
configure the Ethernet interface for communicating
with Cisco Unified CallManager.
Example:
Router(config)# interface ethernet 0/1 • Slot and port syntax is platform-dependent; type ?
to determine.
Step 4 ip address ip-address subnetmask Configures an IP address and subnet mask on the
router’s Ethernet interface.
Example:
Router(config-if)# ip address 10.10.2.23
255.255.255.255
Command Purpose
Step 5 no shutdown Activates the Ethernet port.
Example:
Router(config-if)# no shutdown
Step 6 exit Exits interface mode and enters global configuration
mode.
Example:
Router(config-if)# exit
Step 7 hostname name Assigns a unique name to a network router which
enables Cisco Unified CallManager to identify the
device.
Example:
Router(config)# hostname smith • Default device name is Router.
Step 8 mgcp validate domain-name (Optional) Verifies that the domain name or IP address
received as part of the endpoint names in the MGCP
messages match those configured on the gateway.
Example:
Router(config)# mgcp validate domain-name Note This command is enabled by default. You do
not need to enter it unless you have previously
disabled the functionality by using the
no mgcp validate domain-name command.
Step 9 mgcp Enables the MGCP protocol.
Example:
Router(config)# mgcp
Step 10 mgcp call-agent {ip-address | host-name} [port] Specifies the primary Cisco Unified CallManager
[service-type type] [version version-number] server’s IP address or domain name, and the port
gateway service type and version number.
Example:
Router(config)# mgcp call-agent 10.0.0.21 mgcp 0.1
Step 11 mgcp dtmf-relay voip codec {all | low-bit-rate} Selects the codec type and the dual tone
mode {cisco| nse | out-of-band} multifrequency (DTMF) relay services.
Example:
Router(config)# mgcp dtmf-relay voip codec all mode
cisco
Step 12 ccm-manager mgcp Enables the MGCP gateway to support Cisco Unified
CallManager.
Example:
Router(config)# ccm-manager mgcp
Step 13 exit Exits global configuration mode.
Example:
Router(config)# exit
1. show running-config
2. show interfaces ethernet [number]
3. show mgcp
DETAILED STEPS
MGCP Admin State ACTIVE, Oper State ACTIVE - Cause Code NONE
!MGCP call agent with IP address for Cisco CallManager:
MGCP call-agent: 10.0.0.21 2427 Initial protocol service is MGCP, v. 0.1
MGCP block-newcalls DISABLED
MGCP send RSIP for SGCP is DISABLED
MGCP quarantine mode discard/step
MGCP quarantine of persistent events is ENABLED
!DTMF-relay voip codec parameters:
MGCP dtmf-relay voip codec all mode out-of-band
MGCP dtmf-relay for VoAAL2 disabled for all codec types
MGCP voip modem passthrough mode: CISCO, codec: g711ulaw, redundancy: DISABLED,
MGCP voaal2 modem passthrough mode: NSE, codec: g711ulaw
MGCP TSE payload: 0
MGCP Network (IP/AAL2) Continuity Test timer: 200
MGCP 'RTP stream loss' timer: 5
MGCP request timeout 500, MGCP request retries 3
MGCP rtp unreachable timeout 1000
MGCP gateway port: 2427, MGCP maximum waiting delay 3000
MGCP restart delay 0, MGCP vad DISABLED
MGCP simple-sdp DISABLED
MGCP undotted-notation DISABLED
MGCP codec type g711ulaw, MGCP packetization period 20
MGCP JB threshold lwm 30, MGCP JB threshold hwm 150
MGCP LAT threshold lmw 150, MGCP LAT threshold hwm 300
MGCP PL threshold lwm 1000, MGCP PL threshold hwm 10000
MGCP CL threshold lwm 1000, MGCP CL threshold hwm 10000
MGCP playout mode is adaptive 60, 4, 200 in msec
MGCP IP ToS low delay disabled, MGCP IP ToS high throughput disabled
MGCP IP ToS high reliability disabled, MGCP IP ToS low cost disabled
MGCP IP RTP precedence 5, MGCP signaling precedence: 3
MGCP default package: line-package
MGCP supported packages: gm-package dtmf-package trunk-package line-package
hs-package rtp-package ms-package dt-package sst-packagc-package
MGCP VoAAL2 ignore-lco-codec DISABLED
MGCP T.38 Fax is DISABLED
Note For a description of the fields displayed in this output, see the Cisco IOS Voice Command Reference.
Switchover (Failover)
Cisco IOS gateways can maintain links to up to two backup Cisco Unified CallManager servers in
addition to a primary Cisco Unified CallManager. This redundancy enables a voice gateway to
switchover to a backup if the gateway loses communication with the primary. The backup server takes
control of the devices that are registered with the primary Cisco Unified CallManager. The second
backup takes control of the registered devices if both the primary and first backup Cisco Unified
CallManager fail. The gateway preserves existing connections during a switchover to a backup
Cisco Unified CallManager.
When the primary Cisco Unified CallManager server becomes available again, control reverts to that
server. Reverting to the primary server can occur immediately, after a configurable amount of time, or
only when all connected sessions are released.
Switchback
Switchback is the process a voice gateway uses to reestablish communication with the primary
Cisco Unified CallManager server when the server becomes available again. Switchback can occur
immediately, at a specified time after the last active call ends, or after a specified length of time.
Figure 3 Typical VoIP Network Topology Supporting the MGCP Gateway Fallback Feature
LAN
WAN
LAN LAN
MGCP/H323 MGCP/H323
Cisco Cisco
IP router router IP
IP phones IP phones
T1/E1 PRI
FXS FXO T1-CAS
PSTN
POTS
Any calls at the time of reregistration (even those in a transient state such as call setup) remain
undisturbed. The newly registered Cisco Unified CallManager determines the status of existing calls and
maintains or deletes them as appropriate.
SUMMARY STEPS
1. enable
2. configure terminal
3. ccm-manager redundant-host {ip-address | DNS-name} {ip-address | DNS-name}
4. ccm-manager switchback {graceful | immediate | schedule-time hh:mm | uptime-delay minutes}
5. ccm-manager fallback-mgcp
6. call application alternate
7. exit
8. ccm-manager switchover-to-backup
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ccm-manager redundant-host {ip-address | Identifies up to two backup Cisco Unified CallManager
DNS-name} [ip-address | DNS-name] servers.
Example:
Router(config)# ccm-manager redundant-host
10.0.0.50
Step 4 ccm-manager switchback {graceful | immediate | Configures switchback mode for returning control to the
schedule-time hh:mm | uptime-delay minutes} primary Cisco Unified CallManager.
• Default is graceful.
Example:
Router(config)# ccm-manager switchback immediate
Step 5 ccm-manager fallback-mgcp Enables the MGCP fallback feature.
Example:
Router(config)# ccm-manager fallback-mgcp
Step 6 call application alternate Specifies that the default voice application takes over if
the MGCP application is not available.
Example:
Router(config)# call application alternate
Step 7 exit Exits global configuration mode and returns to privileged
EXEC mode.
Example:
Router(config)# exit
Step 8 ccm-manager switchover-to-backup Manually redirects the MGCP gateway to the backup
Cisco Unified CallManager server. The switchover to the
backup Cisco Unified CallManager server occurs
Example:
Router# ccm-manager switchover-to-backup
immediately.
Note This command does not switch the gateway to the
backup Cisco Unified CallManager server if you
have set the ccm-manager switchback command
to immediate and the primary Cisco Unified
CallManager server is still running.
Note You must configure both commands. For instance, your configuration will not work if you only configure
the ccm-manager fallback-mgcp command.
Restrictions
Effective with Cisco IOS Release 12.3(14)T, the call application alternate command has been replaced
by the service command. You can use the service command cin all releases after Cisco IOS Release
12.3(14)T. Both commands are reflected in Step 4.
SUMMARY STEPS
1. enable
2. configure terminal
3. ccm-manager fallback-mgcp
4. call application alternate [application name]
or
service [alternate | default] service-name location
5. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ccm-manager fallback-mgcp Enables the gateway fallback feature and allows an
MGCP voice gateway to provide call processing services
through SRST or other configured applications when
Example:
Router(config)# ccm-mananger fallback-mgcp
Cisco CallManager is unavailable.
1. show running-config
2. show ccm-manager
3. show ccm-manager fallback-mgcp
DETAILED STEPS
Note For a description of the fields displayed in these output examples, see the Cisco IOS Voice Command
Reference.
SUMMARY STEPS
1. enable
2. configure terminal
3. dial-peer voice tag pots
4. application mgcpapp
5. direct-inward-dial
6. port slot/subunit/port
7. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 dial-peer voice tag pots Designates the specified dial peer as a POTS device and
enters dial-peer configuration mode.
Example:
Router(config)# dial-peer voice 101 pots
Step 4 application mgcpapp Enables MGCP on the dial peer.
Note Do not use this command in dial peers that support
Example: PRI backhaul or BRI backhaul.
Router(config-dial-peer)# application mgcpapp
Step 5 direct-inward-dial (Optional) Enables the direct inward dialing (DID) call
treatment for an incoming called number.
Example: • Required for T1/E1 PRI dial peers.
Router(config-dial-peer)# direct-inward-dial
Step 6 port slot/subunit/port Binds the MGCP application to the specified voice port.
• Slot and port syntax is platform-dependent; type ? to
Example: determine.
Router(config-dial-peer)# port 1/0/1
Step 7 exit Exits dial-peer configuration mode and returns to global
configuration mode.
Example:
Router(config-dial-peer)# exit
1. show running-config
2. show dial-peer voice tag
3. show voice port port
DETAILED STEPS
The following example shows a configuration on MGCP voice gateways for T1 CAS with
e&m-wink-start emulation.
ccm-manager switchback immediate
ccm-manager fallback-mgcp
ccm-manager mgcp
!
controller T1 1/0
framing esf
linecode b8zs
ds0-group 1 timeslots 1-24 type e&m-wink-start
!
voice-port 1/0:1
!
dial-peer voice 1 pots
application mgcpapp
destination-pattern 91..........
port 1/0:1
The following example shows a configuration on MGCP voice gateways for FXS ports.
dial-peer voice 1 pots
application mgcpapp
destination-pattern 555-1212
port 1/0/0
The following example shows a configuration on MGCP voice gateways for FXO ports.
dial-peer voice 2 pots
application mgcpapp
destination-pattern 527....
prefix 527
port 1/1/1
The following example shows a configuration on MGCP gateways for VoIP calls, when the fallback
feature is used.
dial-peer voice 555 voip
application mgcpapp
Note When you configure MGCP gateway fallback support, the POTS dial peer must include the
application mgcpapp command and must specify the voice port. For the default session
application to take over during fallback, you must also configure a destination pattern.
VoiceEncapPeer1000
information type = voice,
description = `',
tag = 1000, destination-pattern = `',
answer-address = `', preference=0,
numbering Type = `unknown'
group = 1000, Admin state is up, Operation state is down,
incoming called-number = `', connections/maximum = 0/unlimited,
DTMF Relay = disabled,
huntstop = disabled,
in bound application associated: 'mgcpapp'
out bound application associated: ''
dnis-map =
permission :both
incoming COR list:maximum capability
outgoing COR list:minimum requirement
type = pots, prefix = `',
forward-digits default
session-target = `', voice-port = `',
direct-inward-dial = disabled,
digit_strip = enabled,
register E.164 number with GK = TRUE
Connect Time = 0, Charged Units = 0,
Successful Calls=0, Failed Calls=0, Incomplete Calls=0
Accepted Calls = 0, Refused Calls = 0,
Last Disconnect Cause is "",
Last Disconnect Text is "",
Last Setup Time = 0.
In Gain is Set to 0 dB
Out Attenuation is Set to 3 dB
Echo Cancellation is enabled
Echo Cancellation NLP mute is disabled
Echo Cancellation NLP threshold is -21 dB
Echo Cancel Coverage is set to 8 ms
Playout-delay Mode is set to default
Playout-delay Nominal is set to 60 ms
Playout-delay Maximum is set to 200 ms
Playout-delay Minimum mode is set to default, value 40 ms
Playout-delay Fax is set to 300 ms
Connection Mode is normal
Connection Number is not set
Initial Time Out is set to 10 s
Interdigit Time Out is set to 10 s
Call Disconnect Time Out is set to 60 s
Ringing Time Out is set to 180 s
Wait Release Time Out is set to 30 s
Companding Type is u-law
Region Tone is set for US
Note For a description of the fields displayed in this output, see the Cisco IOS Voice Command Reference.
M
M
M
XML file
TFTP server
IP cloud M
MGCP MGCP
Cisco router Cisco router
FXS/FXO
PRI PRI/CAS
82979
PSTN
SUMMARY STEPS
1. enable
2. configure terminal
3. ccm-manager config server {ip-address | name}
4. ccm-manager config
5. exit
Example:
Router# configure terminal
Example:
Router(config)# ccm-manager config server
10.10.1.10
Step 4 ccm-manager config Enables the gateway to be configured by a centralized XML
file and triggers the gateway to download a new configuration.
Example:
Router(config)# ccm-manager config
Step 5 exit Exits global configuration mode.
Example:
Router(config)# exit
1. show running-config
2. show ccm-manager config-download
DETAILED STEPS
Download Failed : 0
Configuration Attempted : 1
Configuration Successful : 1
Configuration Failed(Parsing): 0
Configuration Failed(config) : 0
Last config download command: New Registration
Note For a description of the fields displayed in this output, see the Cisco IOS Voice Command Reference.
Multicast Music-on-Hold
The Music-on-Hold (MOH) feature enables you to subscribe to a music streaming service when you are
using a Cisco IOS MGCP voice gateway. Music streams from an MOH server to the voice interfaces of
on-net and off-net callers that have been placed on hold. Cisco CallManager supports the capability to
place callers on hold with music supplied from a streaming multicast MOH server. This integrated
multicast capability is implemented through the H.323 signaling in Cisco CallManager.
By means of a preconfigured multicast address on the gateway, the gateway can “listen” for Real-Time
Transport Protocol (RTP) packets that are broadcast from a default router in the network and can relay
the packets to designated voice interfaces in the network. Whenever a called party places a calling party
on hold, Cisco CallManager requests the MOH server to stream RTP packets to the “on-hold” interface
through the preconfigured multicast address. In this way, RTP packets are relayed to appropriately
configured voice interfaces that have been placed on hold. When you configure a multicast address on a
gateway, the gateway sends an Internet Gateway Management Protocol (IGMP) “join” message to the
default router, indicating to the default router that the gateway is ready to receive RTP multicast packets.
Multiple MOH servers can be present in the same network, but each server must have a different Class D
IP address, and the address must be configured in Cisco CallManager and the MGCP voice gateways.
SUMMARY STEPS
1. enable
2. configure terminal
3. ccm-manager music-on-hold
4. ccm-manager music-on-hold bind interface
5. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ccm-manager music-on-hold Enables music-on-hold.
Example:
Router(config)# ccm-manager music-on-hold
Step 4 ccm-manager music-on-hold bind interface (Optional) Binds the multicast MOH feature to a designated
interface.
Example:
Router(config)# ccm-manager music-on-hold bind
async
Step 5 exit Exits global configuration mode.
Example:
Router(config)# exit
Verifying Music-on-Hold
SUMMARY STEPS
1. show running-config
2. show ccm-manager music-on-hold
DETAILED STEPS
Note For a description of the fields displayed in this output, see the Cisco IOS Voice Command Reference.
Note If you downloaded the default configuration file from TFTP, you do not need to manually configure
MLPP on the MGCP gateway. The MLPP configuration is contained in the default configuration.
Prerequisites
• Cisco IOS Release 12.3(11)T or later
• Cisco CallManager 4.0 or later
• DSPWare 4.0
• Telogy DSP4 (Catalyst 6000 switches)
• Preemptions and precedences should be configured in Cisco CallManager. Interfaces, dial peers,
voice ports, controllers, framing, and line codes should also be configured.
• Cisco Catalyst 6500 series and Cisco 7600 series Communication Media Module (CMM) requires
WS-SVC-CMM-6T1 port adapter.
Restrictions
• Supported only for MGCP endpoints over T1 CAS (E&M wink start) and T1 PRI (backhaul).
• Supported only by Cisco CallManager; does not work with other call agents.
• Conferenced call legs are not supported for preemption with Cisco CallManager.
MLPP Overview
Multilevel Precedence and Preemption (MLPP) is a service that allows authorized users to preempt lower
priority voice calls to targeted stations or fully subscribed shared resources such as TDM trunks or
conference bridges. This capability ensures high-ranking personnel of communication to critical
organizations and personnel during network stress situations such as a national emergency. MLPP
enables the voice gateway to interoperate with other MLPP-capable networks for call preemption and
precedence. MLPP is supported only for MGCP endpoints over T1 CAS (E&M wink start) and T1 PRI
using the backhaul feature.
MLPP service applies only to the subscribers and network resources within a specific domain.
Connections and resources for a call from an MLPP subscriber are marked with a precedence level and
domain identifier. A call can only be preempted by calls of higher precedence from MLPP users in the
same domain. The Cisco CallManager or defense switched network (DSN) switch sets the maximum
precedence level of a subscriber at subscription time.
For more information about MLPP, see the “Multilevel Precedence and Preemption” chapter in the
Cisco CallManager Features and Services Guide, Release 4.0(1).
When a Cisco CallManager server fails during the processing of an MLPP call, the call is treated as a
transient call and is dropped. The gateway releases the trunks and does a switchover to the backup
Cisco CallManager server or falls back to H.323 mode, depending on the availability of the backup
server. All currently connected MLPP calls are preserved during the switchover, switchback, or fallback
process. After the gateway reregisters with Cisco CallManager, call precedence and domain are
preserved. During fallback, an incoming MLPP call is treated as a routine priority call.
SUMMARY STEPS
1. enable
2. configure terminal
3. mgcp package-capability pre-package
4. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 mgcp package-capability pre-package Enables MLPP as an MGCP package capability type on the
voice gateway.
Example:
Router(config)# mgcp package-capability
pre-package
Step 4 exit Exits to privileged EXEC mode.
Example:
Router(config)# exit
Note For information on configuring digit stripping options for your specific dial plan, see the “Setting Up
Call Handling” chapter in the Cisco Survivable Remote Site Telephony Version 3.2 System
Administration Guide.
SUMMARY STEPS
1. enable
2. configure terminal
3. call-manager-fallback
4. ip source-address ip-address [port port] [any-match | strict-match]
5. max-dn max-directory-numbers
6. max-ephones max-phones
7. dialplan-pattern tag pattern extension-length length [extension-pattern extension-pattern]
[no-reg]
8. translate {called | calling} translation-rule-tag
9. end
DETAILED STEPS
Example:
Router# configure terminal
Step 3 call-manager-fallback Enters call-manager-fallback configuration mode.
Example:
Router(config)# call-manager-fallback
Step 4 ip source-address ip-address [port port] Enables the voice gateway to receive messages from the
[any-match | strict-match] Cisco IP phones through the specified IP addresses and
provides for strict IP address verification.
Example:
Router(config-cm-fallback)# ip source-address
10.10.200.23 port 2000
Step 5 max-dn max-directory-numbers Sets the maximum number of directory numbers or
virtual voice ports that can be supported by the voice
gateway. The maximum number is platform dependent.
Example:
Router(config-cm-fallback)# max-dn 12
Step 6 max-ephones max-phones Configures the maximum number of Cisco IP phones
that can be supported by the voice gateway. The
maximum number is platform dependent.
Example:
Router(config-cm-fallback)# max-ephones 10
Step 7 dialplan-pattern tag pattern extension-length Creates a global prefix that can be used to expand the
length [extension-pattern extension-pattern] abbreviated extension numbers into fully qualified E.164
[no-reg]
numbers.
Example:
Router(config-cm-fallback)# dialplan-pattern 1
[A-D].... extension-length 4
Step 8 translate {called | calling} translation-rule-tag Applies a translation rule to modify the phone number
dialed or received by any Cisco IP phone user while
Cisco CallManager fallback is active.
Example:
Router(config-cm-fallback)# translate calling 1
Step 9 end Exits to privileged EXEC mode.
Example:
Router(config-cm-fallback)# end
1. show running-config
2. show mgcp
DETAILED STEPS
Step 1 Use the show running-config command to verify the configuration of the MGCP package, for example:
Router# show running-config
...
mgcp
mgcp call-agent OTHERCLUSTER 2427 service-type mgcp version 0.1
mgcp dtmf-relay voip codec all mode out-of-band
mgcp rtp unreachable timeout 1000 action notify
mgcp package-capability rtp-package
no mgcp package-capability res-package
mgcp package-capability sst-package
no mgcp package-capability fxr-package
mgcp package-capability pre-package
no mgcp timer receive-rtcp
mgcp sdp simple
no mgcp validate domain-name
mgcp fax t38 inhibit
mgcp rtp payload-type g726r16 static
!
mgcp profile default
!
Step 2 Use the show mgcp command to display the MGCP configuration details, for example:
Router# show mgcp
MGCP Admin State ACTIVE, Oper State ACTIVE - Cause Code NONE
MGCP call-agent: 172.18.195.147 2300 Initial protocol service is SGCP 1.5
MGCP block-newcalls DISABLED
MGCP send SGCP RSIP:forced/restart/graceful DISABLED, disconnected ENABLED
MGCP quarantine mode discard/step
MGCP quarantine of persistent events is ENABLED
MGCP dtmf-relay for VoIP disabled for all codec types
MGCP dtmf-relay voaal2 codec all
MGCP voip modem passthrough mode: NSE, codec: g711ulaw, redundancy: DISABLED,
MGCP voaal2 modem passthrough mode: NSE, codec: g711ulaw
MGCP TSE payload: 100
MGCP T.38 Named Signalling Event (NSE) response timer: 200
MGCP Network (IP/AAL2) Continuity Test timer: 3000
MGCP 'RTP stream loss' timer: 2
MGCP request timeout 500
MGCP maximum exponential request timeout 4000
MGCP gateway port: 2427, MGCP maximum waiting delay 3000
MGCP restart delay 0, MGCP vad DISABLED
MGCP rtrcac DISABLED
MGCP system resource check DISABLED
MGCP xpc-codec: DISABLED, MGCP persistent hookflash: DISABLED
MGCP persistent offhook: ENABLED, MGCP persistent onhook: DISABLED
MGCP piggyback msg DISABLED, MGCP endpoint offset DISABLED
MGCP simple-sdp DISABLED
MGCP undotted-notation DISABLED
MGCP codec type g711ulaw, MGCP packetization period 20
Note To view relevant configuration examples, go to the Cisco Systems Technologies website at
http://cisco.com/en/US/tech/index.html. From the website, select Voice > IP Telephony/VoIP, then
click Technical Documentation > Configuration Examples.
!
no ip dhcp-client network-discovery
frame-relay switching
mgcp
mgcp call-agent 10.0.0.21 service-type mgcp version 0.1
mgcp dtmf-relay voip codec all mode out-of-band
mgcp rtp unreachable timeout 1000
mgcp package-capability rtp-package
no mgcp timer receive-rtcp
call rsvp-sync
!
ccm-manager switchback immediate
ccm-manager fallback-mgcp
ccm-manager redundant-host 10.0.0.21
ccm-manager mgcp
!
controller T1 3/0
framing esf
linecode b8zs
ds0-group 1 timeslots 1 type e&m-wink-start
!
controller T1 3/1
framing sf
linecode ami
!
interface FastEthernet0/0
ip address 10.0.0.21 255.255.255.224
duplex auto
speed auto
!
interface Serial0/0
ip address 10.0.0.21 255.255.255.224
encapsulation frame-relay
no keepalive
frame-relay interface-dlci 300
!
interface Serial0/1
no ip address
shutdown
clockrate 2000000
!
interface Ethernet2/0
ip address 10.0.0.21 255.255.255.224
half-duplex
!
interface TokenRing2/0
no ip address
shutdown
ring-speed 16
!
ip classless
ip route 10.0.0.21 255.255.255.0 14.0.0.1
ip route 10.0.0.21 255.255.255.0 14.0.0.1
ip route 10.0.0.21 255.255.255.0 14.0.0.1
ip route 10.0.0.21 255.255.255.0 14.0.0.1
ip route 10.0.0.21 255.255.255.255 Ethernet2/0
ip route 10.0.0.21 255.255.255.255 Ethernet2/0
no ip http server
!
snmp-server manager
!
voice-port 1/0/0
!
voice-port 1/0/1
!
voice-port 1/1/0
!
voice-port 1/1/1
!
voice-port 3/0:1
!
dial-peer cor custom
!
dial-peer voice 44 pots
application mgcpapp
destination-pattern 4301
port 1/1/0
!
dial-peer voice 55 pots
application mgcpapp
destination-pattern 4302
port 1/1/1
!
dial-peer voice 85 voip
destination-pattern 805....
session target ipv4:10.0.0.21
codec g711ulaw
!
dial-peer voice 33 pots
application mgcpapp
destination-pattern 807....
port 3/0:1
!
line con 0
exec-timeout 0 0
line aux 0
line vty 0 4
login
end
Note If the ccm-manager config command is enabled and you separate the MGCP and H.323 dial peers under
different tags, make sure that the MGCP dial peers are configured before the H.323 dial peers.
no ip dhcp-client network-discovery
mgcp
mgcp call-agent 172.16.240.124 2427 service-type mgcp version 0.1
mgcp dtmf-relay voip codec all mode out-of-band
mgcp rtp unreachable timeout 1000 action notify
mgcp modem passthrough voip mode cisco
mgcp package-capability rtp-package
mgcp package-capability sst-package
no mgcp timer receive-rtcp
!
ccm-manager fallback-mgcp
ccm-manager redundant-host CM-B
ccm-manager mgcp
ccm-manager music-on-hold
ccm-manager config server cm-a
ccm-manager config
!
controller T1 1/0
framing esf
linecode b8zs
pri-group timeslots 1-24 service mgcp
!
controller T1 1/1
framing esf
linecode b8zs
pri-group timeslots 1-24 service mgcp
!
interface Serial1/0:23
no ip address
no logging event link-status
isdn switch-type primary-ni
isdn incoming-voice voice
isdn T306 30000
isdn bind-l3 ccm-manager
no cdp enable
!
voice-port 1/0:23
!
dial-peer voice 9991023 pots
application mgcpapp
direct-inward-dial
port 1/0:23
!
dial-peer voice 9991123 pots
application mgcpapp
direct-inward-dial
port 1/1:23
!
dial-peer voice 1640001 pots
destination-pattern 16.....
direct-inward-dial
port 1/0:23
!
line con 0
exec-timeout 0 0
line aux 0
line vty 0 4
login
!
end
framing esf
clock source internal
linecode b8zs
ds0-group 1 timeslots 1-3 type e&m-wink-start
!
controller T1 2/1
framing esf
linecode b8zs
pri-group timeslots 1,24 service mgcp
!
!
!
interface FastEthernet0/0
ip address 192.168.12.38 255.255.255.0
duplex auto
speed auto
!
interface FastEthernet0/1
no ip address
shutdown
duplex auto
speed auto
!
interface Serial2/1:23
no ip address
isdn switch-type primary-ni
isdn incoming-voice voice
isdn bind-l3 ccm-manager
no cdp enable
!
ip classless
ip http server
!
!
!
control-plane
!
!
voice-port 1/0
!
voice-port 1/1
!
voice-port 2/0:1
!
voice-port 2/1:23
!
mgcp
mgcp call-agent 192.168.12.125 2427 service-type mgcp version 0.1
mgcp rtp unreachable timeout 1000 action notify
mgcp package-capability rtp-package
no mgcp package-capability res-package
mgcp package-capability sst-package
no mgcp package-capability fxr-package
no mgcp timer receive-rtcp
mgcp sdp simple
mgcp fax t38 inhibit
mgcp rtp payload-type g726r16 static
!
mgcp profile default
!
!
!
dial-peer voice 1 pots
application mgcapp
port 2/0:1
!
!
line con 0
line aux 0
line vty 0 4
login
!
end
forward-digits all
!
!
call-manager-fallback
max-conferences 4
ip source-address 10.10.200.23 port 2000
max-ephones 10
max-dn 10
dialplan-pattern 1 [A-D].... extension-length 4
translate calling 1
!
!
line con 0
exec-timeout 0 0
line aux 0
exec-timeout 0 0
no exec
transport input all
line vty 0 4
password lab
login
!
exception core-file core_2621 compress
exception region-size 65536
exception dump 10.10.100.101
!
!
end
Where to Go Next
• To configure conferencing, transcoding, and MTP support on a Cisco IOS gateway, see “Configuring
Enhanced Conferencing and Transcoding for Voice Gateway Routers” on page 65.
• To enable MGCP PRI backhaul support, see “Configuring MGCP PRI Backhaul and T1 CAS
Support for Cisco Unified CallManager” on page 111.
• To enable MGCP BRI backhaul support, see “Configuring MGCP-Controlled Backhaul of
BRI Signaling in Conjunction with Cisco Unified CallManager” on page 127.
• To download region-specific tones and their associated frequencies, amplitudes, and cadences, see
“Configuring Tone Download to MGCP Gateways” on page 143.
Additional References
• “Cisco Unified CallManager and Cisco IOS Interoperability Features Roadmap” on
page 9—Describes how to access Cisco Feature Navigator; also lists and describes, by Cisco IOS
release, Cisco CallManager and Cisco IOS interoperability features.
• “Overview of Cisco Unified CallManager and Cisco IOS Interoperability” on page 13—Describes
basics of underlying technology and lists related documents.
• Configuring Media Gateway Control Protocol and Related Protocols—Describes MGCP concepts
and configuration procedures.
• Configuring the Cisco IOS MGCP Gateway—Describes the basics of configuring an MGCP
gateway to support Cisco CallManager.
• How to Configure MGCP with Digital PRI and Cisco CallManager—Describes how to configure
MGCP with PRI.
• MGCP Gateway Fallback Transition to Default H.323 Session Application—Describes how to
enable an MGCP gateway to fallback to an H323 session application when the WAN connection to
the primary Cisco CallManager server is lost, and no backup Cisco CallManager server is available.
• MGCP with Digital CAS and Cisco CallManager Configuration Example—Describes how to use
MGCP between a Cisco IOS gateway and a Cisco CallManager Media Convergence Server (MCS).
This chapter describes the steps for enabling conferencing and transcoding support on Cisco IOS voice
gateways in a Cisco Unified CallManager network. This feature provides enhanced multiservice support
by enabling audioconference and transcode functions in voice gateway routers. Locating conference
resources in the branch reduces WAN utilization and using transcoding services reduces bandwidth
needs resulting in tangible cost savings.
Digital signal processor (DSP) farms provide conferencing and transcoding services using DSP
resources on high-density digital voice/fax network modules.
Feature History for Out-of-Band to In-Band DTMF Relay for Voice Gateway Routers
Release Modification
12.3(8)XY This feature was introduced.
12.3(11)T This feature was integrated into Cisco IOS Release 12.3(11)T.
12.3(14)T Support was added for the PVDM2 on the Cisco 2800 series and
Cisco 3800 series voice gateway routers.
Feature History for Enhanced Conferencing and Transcoding for Voice Gateway Routers
Release Modification
12.3(8)T This feature was introduced for the NM-HDV2, NM-HD-1V, NM-HD-2V,
and NM-HD-2VE.
12.3(11)T Support was added for the PVDM2 on the Cisco 2800 series and
Cisco 3800 series voice gateway routers.
Feature History for Conferencing and Transcoding for Voice Gateway Routers
Release Modification
12.1(5)YH This feature was introduced for the NM-HDV-FARM on the Cisco VG200.
12.2(13)T This feature was integrated into Cisco IOS Release 12.2(13)T and support
was added for the NM-HDV on the Cisco 2600 series, Cisco 3600 series,
Cisco 3700 series, and Cisco VG200.
12.3(2)XE Support was added for the PVDM-256K on the Cisco 1751, Cisco 1751-V,
and Cisco 1760.
12.3(8)T Support for the PVDM-256K on the Cisco 1751, Cisco 1751-V, and
Cisco 1760 was integrated into Cisco IOS Release 12.3(8)T.
Finding Support Information for Platforms and Cisco IOS Software Images
Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image
support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on
Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at
the login dialog box and follow the instructions that appear.
Note For more information about this and related Cisco IOS voice features, see the following:
• “Overview of Cisco Unified CallManager and Cisco IOS Interoperability” on page 13.
• Entire Cisco IOS Voice Configuration Library—including library preface and glossary, other feature
documents, and troubleshooting documentation—at
http://www.cisco.com/univercd/cc/td/doc/product/software/ios123/123cgcr/voice_c/vcl.htm.
Contents
• Prerequisites for Conferencing and Transcoding for Voice Gateway Routers, page 66
• Information About Conferencing and Transcoding for Voice Gateway Routers, page 68
• How to Configure Conferencing and Transcoding for Voice Gateway Routers, page 77
• Configuration Examples for Conferencing and Transcoding, page 98
• Where to Go Next, page 110
• Additional References, page 110
• NM-HD-1V
• NM-HD-2V
• NM-HD-2VE
• NM-HDV2
• NM-HDV2-1T1/E1
• NM-HDV2-2T1/E1
• NM-HDV 1
• NM-HDV-FARM 1
• PVDM-256K 1
• Conference bridge, transcoder, and MTP services must be configured in Cisco Unified CallManager.
See the following chapters in the Cisco Unified CallManager Administration Guide:
Release 4.0(1):
– “Conference Bridge Configuration”
– “Media Termination Point Configuration”
– “Transcoder Configuration”
Release 3.3(4):
– “Conference Bridge Configuration”
– “Transcoder Configuration”
Codecs
End-user devices must be equipped with one of the following codecs:
DSP Farms
A DSP farm is the collection of DSP resources available for conferencing, transcoding, and MTP
services. DSP farms are configured on the voice gateway and managed by Cisco Unified CallManager
through Skinny Client Control Protocol (SCCP).
The DSP farm can support a combination of transcoding sessions, MTP sessions, and conferences
simultaneously. The DSP farm maintains the DSP resource details locally. Cisco Unified CallManager
requests conferencing or transcoding services from the gateway, which either grants or denies these
requests, depending on resource availability. The details of whether DSP resources are used, and which
DSP resources are used, are transparent to Cisco Unified CallManager.
The DSP farm uses the DSP resources in network modules on Cisco routers to provide
voice-conferencing, transcoding, and hardware MTP services.
Tip To determine how many DSP resources your router supports, see the “Allocation of DSP Resources”
section on page 73.
Conferencing
Voice conferencing involves adding several parties to a phone conversation. In a traditional
circuit-switched voice network, all voice traffic passes through a central device such as a PBX.
Conference services are provided within this central device. In contrast, IP phones normally send voice
signals directly between phones, without the need to go through a central device. Conference services,
however, require a network-based conference bridge.
In an IP telephony network using Cisco Unified CallManager, the Conferencing and Transcoding for
Voice Gateway Routers feature provides the conference-bridging service. Cisco Unified CallManager
uses a DSP farm to mix voice streams from multiple participants into a single conference-call stream.
The mixed stream is played out to all conference attendees, minus the voice of the receiving attendee.
The following conferencing features are supported:
• A conference can be either of the following types:
– Ad hoc—The person controlling the conference presses the telephone conference button and
adds callers one by one.
– Meet me—Participants call in to a central number and are joined in a single conference.
• Participants whose end devices use different codec types are joined in a single conference; no
additional transcoding resource is needed.
This feature provides voice conferencing at the remote site, without the need for access to the central
site (see Figure 5).
Headquarters
PSTN Branch
WAN
IP
IP
IP IP
82999
Transcoding
Transcoding compresses and decompresses voice streams to match endpoint-device capabilities.
Transcoding is required when an incoming voice stream is digitized and compressed (by means of a
codec) to save bandwidth, but the local device does not support that type of compression. Ideally, all IP
telephony devices would support the same codecs, but this is not the case. Rather, different devices
support different codecs.
Transcoding is processed by DSPs on the DSP farm; sessions are initiated and managed by Cisco Unified
CallManager. Cisco Unified CallManager also refers to transcoders as hardware MTPs.
This feature provides transcoding at the remote site, without the need for access to the central site
(see Figure 6).
Headquarters
Branch
WAN
IP
IP
IP IVR
88001
MTP
A Media Termination Point (MTP) bridges the media streams between two connections allowing
Cisco Unified CallManager to relay calls that are routed through SIP or H.323 endpoints.
The following MTP resources are supported for Cisco Unified CallManager 4.0 and later releases:
• Software MTP—Software-only implementation that does not use a DSP resource for endpoints
using the same codec and the same packetization time.
• Hardware MTP—Hardware-only implementation that uses a DSP resource for endpoints using the
same G.711 codec but a different packetization time. The repacketization requires a DSP resource
so it cannot be done by software only. Cisco Unified CallManager also uses the term software MTP
when referring to a hardware MTP.
For MTP and transcoding, the DSP farm supports only two IP streams connected to each other at a time.
If more than two streams need connecting, the streams must be connected using conferencing.
Transcoding
• Transcoding between G.711 and G.729, G.729a, G.729b, G.729ab, GSM FR, and GSM EFR codecs
• Up to 128 transcoding sessions on a single NM-HDV2
MTP
• Software-only implementation that does not use a DSP resource for endpoints with the same codec
and the same packetization time.
• Hardware-only implementation using a DSP resource for endpoints with the same G.711 codec but
a different packetization time.
Transcoding
• Transcoding between G.711 and G.729, G.729a, G.729b, and G.729ab codecs
• Up to 60 transcoding sessions on a single NM-HDV
Conferencing and Transcoding Features on the Cisco 1751 and Cisco 1760
Conferencing
• Cisco Unified CallManager meet-me and ad-hoc conferences with up to six participants each
• Up to 5 six-party conferences
• One conference on a single DSP
• Participants using G.711 and G.729 codecs joined in a single conference; no additional transcoding
resources are needed to include the disparate codec types
• Easy deployment of conference resources in routers across the network, reducing WAN use and
improving voice-network performance
Transcoding
• Transcoding between G.711 and G.729, G.729a, G.729b, and G.729ab codecs
• Up to 16 transcoding sessions on the Cisco 1751
• Up to 20 transcoding sessions on the Cisco 1760
• Two transcoding sessions on a single DSP
Table 4 lists the total number of network modules that are supported per router.
NM-HD-1V, NM-HD-2V,
Router NM-HDV2 NM-HD-2VE NM-HDV
Cisco 2600 series — — 1
Cisco 2600 XM 1 1 1
Cisco 2691 1 1 1
Cisco 2801 — — —
Cisco 3620 — — 11
Cisco 3640 — — 31
Cisco 3660 — 6 6
Cisco 3725 2 2 2
2 2
Cisco 3745 4 4 4
Cisco VG200 — — 1
1. Although the chassis has a slot for an additional module, it cannot operate with more than the specified number.
2. Provided processor resources are available.
Application G.711 a-law/u-law G729 a/ab G.729, G.729b GSM FR GSM EFR
Conferencing 8 sessions 2 sessions 2 sessions — —
(8 x 8 = 64 (8 x 2 = 16 (8 x 2 = 16
conferees) conferees) conferees)
Conferencing on 4 sessions 1 session 1 session — —
PVDM2-8 (4 x 8 = 32 (1 x 8 = 8 (1 x 8 = 8
conferees) conferees) conferees)
Hardware MTP 16 sessions — — — —
Transcoding 8 sessions 8 sessions 6 sessions 8 sessions 6 sessions
Device Capacity
A single DSP 4 transcoding sessions
1 conference call with up to 6 participants
A single PVDM (3 DSPs) 12 transcoding sessions
3 conference calls, each with up to 6 participants, for a
total of up to 18 participants
Device Capacity
A fully loaded NM-HDV 60 transcoding sessions
(5 PVDMs holding 15 DSPs) 15 concurrent conference calls, each with up to
6 participants, for a total of up to 90 participants
Use the following tables to determine the number of PVDMs required to support your DSP needs and
whether your router is capable of holding enough NM-HDVs to accommodate these PVDMs:
• See Table 8 if you use either of the following:
– 20-, 30-, 40-, 50-, or 60-ms packetization
– 10-ms packetization with voice-activity detection (VAD) enabled
• See Table 9 if you use 10-ms packetization with VAD disabled
Table 8 PVDM Requirements Using 20-, 30-, 40-, 50-, or 60-ms Packetization or 10-ms
Packetization with VAD Enabled 1
Table 9 PVDM Requirements Using 10-ms Packetization and with VAD Disabled 1
SUMMARY STEPS
DETAILED STEPS
Example:
8 G.711 conferences and 32 transcoding sessions
require 1 PVDM2-64 (4 DSPs) on the NM-HDV2.
Step 3 Determine the maximum number of network modules Establishes your router capabilities.
that your router can support (see Table 4 on page 74).
Example:
A Cisco 3745 router can support up to 4 NM-HDV2s
(provided processor resources are available).
Step 4 Ensure that your requirements fall within router Verifies your proposed solution.
capabilities, taking into account whether your router
supports multiple network modules. If necessary,
reassess performance requirements.
Step 5 Install PVDM2s and network modules, as needed (see Prepares your system for DSP-farm configuration.
the “Connecting Voice Network Modules” chapter in
the Cisco Network Modules Hardware Installation
Guide, and the Cisco Network Modules and Interface
Cards Regulatory Compliance and Safety
Information).
SUMMARY STEPS
1. enable
2. configure terminal
3. sccp ccm {ip-address | dns} identifier identifier-number [port port-number]
[version version-number]
or
sccp ccm {ip-address | dns} priority priority [port port-number] [version version-number]
4. sccp local interface-type interface-number
5. sccp ip precedence value
6. sccp
7. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 NM-HDV2, NM-HD-1V, NM-HD-2V, NM-HD-2VE, or PVDM2 Adds a Cisco Unified CallManager server to the list of
sccp ccm {ip-address | dns} identifier available servers to which the Cisco voice gateway can
identifier-number [port port-number] [version register.
version-number]
• Repeat this step for each Cisco Unified CallManager
NM-HDV, Cisco 1751, or Cisco 1760 server that the gateway registers with.
sccp ccm {ip-address | dns} priority priority
[port port-number] [version version-number]
Example:
Router(config)# sccp ccm 10.0.0.0 identifier 1
version 4.0
Example:
Router(config)# sccp ccm 10.0.0.0 priority 1
version
Example:
Router(config)# sccp
Step 7 exit Exits global configuration mode.
Example:
Router(config)# exit
Note Because a software-only MTP does not require DSP resources, you can configure a software-only MTP
without a voice network module, or on the NM-HDV if you do not enable the dsp services dspfarm
command for the voice card.
Prerequisites
SUMMARY STEPS
1. enable
2. configure terminal
3. voice-card slot
4. dsp services dspfarm
5. exit
6. dspfarm profile profile-identifier {conference | mtp | transcode}
7. description text
8. codec codec-type
9. maximum sessions number
or
maximum sessions {hardware | software} number
10. associate application sccp
11. no shutdown
12. exit
13. gateway
14. timer receive-rtp seconds
15. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 voice-card slot Enters voice-card configuration mode for the network
module on which you want to enable DSP-farm services.
Example:
Router(config)# voice-card 1
Step 4 dsp services dspfarm Enables DSP-farm services for the voice card.
Example:
Router(config-voicecard)# dsp services dspfarm
Example:
Router(config-voicecard)# exit
Step 6 dspfarm profile profile-identifier Enters DSP farm profile configuration mode to define a
{conference | mtp | transcode} profile for DSP farm services.
Note The profile-identifier and service type uniquely
Example: identifies a profile. If the service type and
Router(config)# dspfarm profile 20 conference profile-identifier pair is not unique, you are
prompted to choose a different profile-identifier.
Step 7 description text (Optional) Includes a specific description about the
Cisco DSP farm profile.
Example:
Router(config-dspfarm-profile)# description
art_dept
Step 8 codec codec-type Specifies the codecs supported by a DSP farm profile.
• Repeat this step for each codec supported by the profile.
Example: Note Hardware MTPs support only G.711 a-law and
Router(config-dspfarm-profile)# codec gsmefr
G.711 u-law. If you configure a profile as a
hardware MTP, and you want to change the codec to
other than G.711, you must first remove the
hardware MTP by using the no maximum sessions
hardware command.
Example:
Router(config-dspfarm-profile)# associate
application sccp
Step 11 no shutdown Enables the profile, allocates DSP farm resources, and
associates the application.
Example:
Router(config-dspfarm-profile)# no shutdown
Example:
Router(config-dspfarm-profile)# exit
Step 13 gateway Enters gateway configuration mode.
Example:
Router(config)# gateway
Step 14 timer receive-rtp seconds Sets the Real-Time Transport Protocol (RTP) timeout
interval to clear hanging connections.
Example: • seconds—Range is 180 to 1800. Default is 1200.
Router(config-gateway)# timer receive-rtp 600
Step 15 exit Exits to global configuration mode.
Example:
Router(config-gateway)# exit
Prerequisites
SUMMARY STEPS
1. enable
2. configure terminal
3. sccp ccm group group-number
4. associate ccm identifier-number priority priority-number
5. associate profile profile-identifier register device-name
6. bind interface interface-type interface-number
7. description string
8. end
DETAILED STEPS
Example:
Router# configure terminal
Step 3 sccp ccm group group-number Creates a Cisco Unified CallManager group and enters
SCCP Cisco Unified CallManager configuration mode.
Example:
Router(config)# sccp ccm group 118
Step 4 associate ccm identifier-number priority Adds a Cisco Unified CallManager server to the
priority-number Cisco Unified CallManager group and establishes its
priority within the group.
Example: • Repeat this step for each Cisco Unified CallManager
Router(config-sccp-ccm)# associate ccm 125 server that you want to add to the group.
priority 2
Step 5 associate profile profile-identifier register Associates a DSP farm profile to the Cisco Unified
device-name CallManager group.
• device-name—Must match the device name configured
Example: in Cisco Unified CallManager; otherwise profile is not
Router(config-sccp-ccm)# associate profile registered to Cisco Unified CallManager.
register abgz12345
• Repeat this step for each DSP farm profile that you
want to register with this Cisco Unified CallManager
group.
Step 6 bind interface interface-type interface-number Binds an interface to the Cisco Unified CallManager group.
Example:
Router(config-sccp-ccm)# bind interface
fastethernet 2:1
Step 7 description text (Optional) Includes a specific description of the
Cisco Unified CallManager group.
Example:
Router(config-sccp-ccm)# description boston
office
Step 8 end Exits to privileged EXEC mode.
Example:
Router(config)# end
Note The optimum settings for these commands depend on your platform and individual network
characteristics. Modify the defaults to meet your performance requirements.
SUMMARY STEPS
1. enable
2. configure terminal
3. sccp ccm group group-number
4. connect interval seconds
5. connect retries number
6. keepalive retries number
7. keepalive timeout seconds
8. registration retries retry-attempts
9. registration timeout seconds
10. switchover method {graceful | immediate}
11. switchback method {graceful | guard [timeout-value] | immediate | uptime uptime-value}
12. switchback interval seconds
13. end
DETAILED STEPS
Example:
Router# configure terminal
Step 3 sccp ccm group group-number Enters SCCP Cisco Unified CallManager configuration
mode.
Example: • group-number—Range is 1 to 65535.
Router(config)# sccp ccm group 118
Example:
Router(config-sccp-ccm)# end
SUMMARY STEPS
1. show running-config
2. show sccp ccm group [group-number]
3. show dspfarm profile [profile-number]
4. show dspfarm all
5. show sccp
6. show sccp connections
7. show media resource status
DETAILED STEPS
Step 1 Use the show running-config command to display the configuration of the MTP profile, for example:
Router# show running-config
...
sccp local FastEthernet0/0
sccp ccm 10.40.10.10 identifier 10 version 4.0
sccp
!
sccp ccm group 999
associate ccm 10 priority 1
associate profile 12 register MTP123456789
associate profile 2 register XCODE123456
!
dspfarm profile 12 mtp
codec g711ulaw
maximum sessions hardware 4
maximum sessions software 40
associate application SCCP
!
Step 2 show sccp ccm group [group-number]
Use this command to verify the configuration of the Cisco Unified CallManager group, for example:
Router# show sccp ccm group 999
Note This command is not supported on the NM-HDV or Cisco 1700 series.
SLOT DSP CHNL STATUS USE TYPE SESS-ID CONN-ID PKTS-RXED PKTS-TXED
0 0 1 UP FREE conf - - - -
0 0 2 UP FREE conf - - - -
0 0 3 UP FREE conf - - - -
0 0 4 UP FREE conf - - - -
0 0 5 UP FREE conf - - - -
0 0 6 UP FREE conf - - - -
Resource Providers:
SUMMARY STEPS
DETAILED STEPS
Example:
Router# debug sccp all
Step 2 debug dspfarm {all | errors | events | packets} (Optional) Sets debugging levels for DSP-farm service.
Example:
Router# debug dspfarm all
Step 3 debug media resource provisioning {all | errors (Optional) Sets debugging levels for media resource
| events} provisioning.
Example:
Router# debug media resource provisioning all
Note If you configured a DSP farm in Cisco IOS Release 12.1(5)YH and have now upgraded to Cisco IOS
Release 12.2(13)T or later, you must reconfigure the DSP farm, including enabling DSP-farm services
on the NM-HDV and specifying maximum session numbers in each category as appropriate. Your
previous configuration no longer works.
SUMMARY STEPS
1. enable
2. configure terminal
3. voice-card slot
4. dsp services dspfarm
5. exit
6. dspfarm confbridge maximum sessions number
7. dspfarm transcoder maximum sessions number
8. dspfarm
9. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 voice-card slot Enters voice-card configuration mode for the network
module on which you want to enable DSP-farm services.
Example:
Router(config)# voice-card 1
Step 4 dsp services dspfarm Enables DSP-farm services on the voice card.
Example:
Router(config-voicecard)# dsp services dspfarm
Step 5 exit Returns to global configuration mode.
Example:
Router(config-voicecard)# exit
Step 6 dspfarm confbridge maximum sessions number Specifies the maximum number of conferencing sessions to
be supported by the DSP farm. A DSP can support
1 conference session with up to 6 participants.
Example:
Router(config)# dspfarm confbridge maximum Note When you assign this value, take into account the
sessions 3 number of DSPs allocated for transcoding services.
Example:
Router(config)# dspfarm
Step 9 exit Exits global configuration mode.
Example:
Router(config)# exit
SUMMARY STEPS
1. enable
2. configure terminal
3. sccp switchback timeout guard seconds
4. dspfarm rtp timeout seconds
5. dspfarm connection interval seconds
6. exit
DETAILED STEPS
Example:
Router# configure terminal
Example:
Router(config)# sccp switchback timeout guard
180
Step 4 dspfarm rtp timeout seconds (Optional) Configures the Real-Time Transport Protocol
(RTP) timeout interval for when the error condition “RTP
port unreachable” occurs.
Example:
Router(config)# dspfarm rtp timeout 60
Step 5 dspfarm connection interval seconds (Optional) Specifies how long to monitor RTP inactivity
before deleting an RTP stream.
Example:
Router(config)# dspfarm connection interval 60
Step 6 exit Exits global configuration mode.
Example:
Router(config)# exit
What to Do Next
• To verify the configuration of conferencing and transcoding services on the NM-HDV, see the
“Verifying DSP Farm Configuration” section on page 87.
• For information on troubleshooting, see the “Troubleshooting DSP-Farm Services” section on
page 91.
Prerequisites for Conferencing and Transcoding on the Cisco 1751 or Cisco 1760
Determine that there are enough DSPs available for conferencing and transcoding services by using the
show voice dsp command.
SUMMARY STEPS
1. enable
2. configure terminal
3. dspfarm confbridge maximum sessions number
4. dspfarm transcoder maximum sessions number
5. dspfarm
6. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 dspfarm confbridge maximum sessions number Specifies the maximum number of conferencing sessions to
be supported by the DSP farm. A DSP can support
1 conference session with up to 6 participants.
Example:
Router(config)# dspfarm confbridge maximum Note When you assign this value, take into account the
sessions 3 number of DSPs allocated for transcoding services.
Step 4 dspfarm transcoder maximum sessions number Specifies the maximum number of transcoding sessions to
be supported by the DSP farm. A DSP can support up to
4 transcoding sessions.
Example:
Router(config)# dspfarm transcoder maximum Note When you assign this value, take into account the
sessions 12 number of DSPs allocated for conferencing
services.
Step 5 dspfarm Enables the DSP farm.
Example:
Router(config)# dspfarm
Step 6 exit Exits global configuration mode.
Example:
Router(config)# exit
What to Do Next
• To verify the configuration of conferencing and transcoding services on the NM-HDV, see the
“Verifying DSP Farm Configuration” section on page 87.
• For information on troubleshooting, see the “Troubleshooting DSP-Farm Services” section on
page 91.
Prerequisites
Hardware
• NM-HDV2, NM-HD-2VE, or onboard PVDM2 (Cisco 2800 series or Cisco 3800 series).
• WS-SVC-CMM-6T1 or WS-SVC-CMM-6E1 port adapter for Cisco Catalyst 6500 series and
Cisco 7600 series Communication Media Module (CMM).
Software
• Enable SCCP on the local interface that the MTP resource uses to communicate with Cisco Unified
CallManager. For instructions, see the “Enabling SCCP on the Cisco Unified CallManager
Interface” section on page 79.
• Configure a DSP farm profile for MTP resources. For instructions, see the “Configuring a DSP Farm
Profile” section on page 80.
• Associate the MTP profile with the Cisco Unified CallManager group. For instructions, see the
“Associating a DSP Farm Profile to a Cisco Unified CallManager Group” section on page 83.
• Configure DTMF relay in the SIP dial peers using the dtmf-relay rtp-nte command.
• Configure DTMF relay in Cisco Unified CallManager 4.0 or later. For information, see the
Cisco Unified CallManager 4.0 documentation.
• Consider your system requirements when configuring DSP farms and SCCP because the defaults for
some commands might not result in expected behavior. In particular, the correct settings for the
following commands are platform-specific and depend on your individual network characteristics:
– connect interval
– connect retries
– keepalive retries
– keepalive timeout
– sccp registration retries
– sccp registration timeout
– switchback interval
Restrictions
• Multifrequency is supported by MTPs but Cisco Unified CallManager does not support it.
• Software MTP supports G.711 codecs only.
DTMF detection and generation capabilities are added to the hardware and software MTP. The MTP
generates out-of-band SCCP events to Cisco Unified CallManager when it detects a DTMF tone. The
MTP creates event packets for DTMF digits and inserts the packets into the outgoing RTP stream after
receiving an SCCP request from Cisco Unified CallManager.
Figure 7 illustrates the media setup and DTMF tone flow between a SIP network and nonSIP network
over a DSP farm MTP.
PSTN
T1/E1/PRI/CAS
SIP media
V gateway V
In-band DTMF Out-of-band DTMF
SIP NonSIP
network network
MTP
resources
IP IP IP IP
SIP IP SCCP phones
phones
103192
Cisco Unified CallManager
This feature supports DTMF relay using the following MTP and transcoder resources for Cisco Unified
CallManager 4.0:
• Software MTP—Software-only implementation that does not use a DSP resource for endpoints
using the same codec and the same packetization time.
• Hardware MTP—Hardware-only implementation that uses a DSP resource for endpoints using the
same G.711 codec but a different packetization time. Cisco Unified CallManager refers to it also as
a software MTP.
• Transcoder—Hardware-only implementation using a DSP resource for endpoints using different
codecs. Cisco Unified CallManager also refers to it as a hardware MTP.
For MTP and transcoding, the DSP farm supports only two IP streams connected to each other at a time.
If more than two streams need connecting, the streams must be connected using conferencing.
Note For more information on MTPs and transcoders, see the Cisco Unified CallManager System Guide
Release 4.0(1).
framing sf
crc-threshold 0
linecode ami
!
!
!
interface FastEthernet0/0
ip address 10.4.20.7 255.255.255.0
no ip mroute-cache
speed auto
half-duplex
no cdp enable
!
interface FastEthernet0/1
no ip address
no ip mroute-cache
shutdown
duplex auto
speed auto
no cdp enable
!
ip default-gateway 10.4.0.1
ip classless
ip route 0.0.0.0 0.0.0.0 FastEthernet0/0
ip route 223.255.254.254 255.255.255.255 10.4.0.1
no ip http server
!
!
no cdp run
!
!
control-plane
!
!
voice-port 1/0/0
!
voice-port 1/0/1
!
!
sccp local FastEthernet0/0
sccp ccm 10.4.20.24 identifier 1 version 4.0
sccp ccm 10.4.20.25 identifier 2 version 4.0
sccp ccm 10.4.20.26 identifier 3 version 4.0
sccp ip precedence 3
sccp
!
sccp ccm group 988
associate ccm 1 priority 1
associate ccm 2 priority 2
associate ccm 3 priority 3
associate profile 10 register CFB123456789966
associate profile 6 register MTP123456789988
keepalive retries 5
switchover method immediate
switchback method immediate
switchback interval 15
!
dspfarm profile 6 transcode
codec g711ulaw
codec g711alaw
codec g729ar8
codec g729abr8
codec gsmfr
maximum sessions 4
!
dial-peer voice 10 pots
destination-pattern 3140001
port 1/0/0
!
! Following dial peer is for calls to H.323 end-point 313.... for transcoding.
! Session target is IP address of Cisco CallManager.
!
dial-peer voice 100 voip
destination-pattern 313....
session target ipv4:10.10.10.1
!
! Following dial peer is for calls to IP Phones for conferencing.
! Session target is IP address of Cisco CallManager.
!
dial-peer voice 200 voip
destination-pattern 700....
session target ipv4:10.10.10.1
codec g711alaw
!
line con 0
line aux 0
line vty 0 4
login
!
end
sccp ip precedence 4
sccp
!
sccp ccm group 1
bind interface FastEthernet0/0
associate ccm 1 priority 1
associate profile 2 register amalthea-mtp
associate profile 1 register amalthea-xcode
registration retries 20
registration timeout 30
keepalive retries 10
connect retries 30
connect interval 30
!
dspfarm profile 1 transcode
description xcode func
codec g711ulaw
codec g711alaw
codec g729ar8
codec g729abr8
codec gsmfr
codec g729r8
maximum sessions 2
associate application SCCP
!
dspfarm profile 2 mtp
codec g711ulaw
maximum sessions hardware 2
maximum sessions software 2
associate application SCCP
!
!
dial-peer voice 1 pots
destination-pattern 4444
port 3/0
!
dial-peer voice 2 voip
destination-pattern 52..
session target ipv4:192.168.12.131
dtmf-relay h245-alphanumeric
!
gateway
timer receive-rtp 1200
!
!
line con 0
line aux 0
line vty 0 4
login
!
end
duplex auto
speed auto
!
interface FastEthernet0/1
no ip address
shutdown
duplex auto
speed auto
!
interface BRI1/0
no ip address
!
ip default-gateway 10.4.0.1
ip classless
ip route 0.0.0.0 255.255.0.0 FastEthernet0/0
ip route 223.255.254.254 255.255.255.255 FastEthernet0/0
!
ip http server
!
!
voice-port 1/0/0
!
voice-port 1/0/1
!
voice-port 1/1/0
!
voice-port 2/0:1
!
mgcp profile default
!
!
dial-peer voice 1 voip
destination-pattern 2000
session protocol sipv2
session target ipv4:10.4.175.2
dtmf-relay rtp-nte
codec g711ulaw
!
dial-peer voice 3 pots
application mgcpapp
port 2/0:1
!
dial-peer voice 999201 pots
application mgcpapp
port 2/0:1
!
dial-peer voice 2 pots
destination-pattern 2005
port 1/0/0
!
dial-peer voice 5 pots
destination-pattern 2001
port 1/0/0
!
!
line con 0
line aux 0
line vty 0 4
login
!
!
end
Where to Go Next
• To enable MGCP on a Cisco IOS gateway, see Configuring MGCP Gateway Support for
Cisco Unified CallManager, page 23.
• To enable MGCP PRI backhaul support, see “Configuring MGCP PRI Backhaul and T1 CAS
Support for Cisco Unified CallManager” on page 111.
• To enable MGCP BRI backhaul support, see “Configuring MGCP-Controlled Backhaul of
BRI Signaling in Conjunction with Cisco Unified CallManager” on page 127.
• To download region-specific tones and the associated frequencies, amplitudes, and cadences, see
“Configuring Tone Download to MGCP Gateways” on page 143.
Additional References
• “Cisco Unified CallManager and Cisco IOS Interoperability Features Roadmap” on
page 9—Describes how to access Cisco Feature Navigator; also lists and describes, by Cisco IOS
release, Cisco Unified CallManager and Cisco IOS interoperability features.
• “Overview of Cisco Unified CallManager and Cisco IOS Interoperability” on page 13—Describes
basics of underlying technology and lists related documents.
• “Conference Bridges” chapter in the Cisco Unified CallManager System Guide, Release
4.0(1)—Overview of conference devices in Cisco Unified CallManager 4.0.
• “Conference Bridge Configuration” chapter in the Cisco Unified CallManager Administration
Guide, Release 4.0(1)—Describes how to configure conference bridges in Cisco Unified
CallManager 4.0.
• “Transcoders” chapter in the Cisco Unified CallManager System Guide—Overview of transcoder
devices in Cisco Unified CallManager 4.0.
• “Transcoder Configuration” chapter in the Cisco Unified CallManager Administration
Guide—Describes how to configure transcoders in Cisco Unified CallManager 4.0.
• IP Communications High-Density Digital Voice/Fax Network Module feature document—Describes
how to configure support for the NM-HDV2 in Cisco IOS gateways.
• “Connecting Voice Network Modules” chapter in the Cisco Network Modules Hardware Installation
Guide—Describes how to install the voice network modules.
This chapter describes the procedures for enabling MGCP PRI backhaul support on the Cisco IOS
gateway and describes related features.
Feature History for QSIG Supplementary Features for Voice Gateway Routers
Release Modification
12.3(8)XY This feature was introduced.
12.3(11)T This feature was integrated into Cisco IOS Release 12.3(11)T.
Feature History for MGCP Gateway Support for Cisco Unified CallManager Network Specific Facilities
Release Modification
12.2(15)ZJ This feature was introduced.
12.3(4)T This feature was integrated into Cisco IOS Release 12.3(4)T.
Feature History for MGCP PRI Backhaul and T1 CAS Support for Cisco CallManager
Release Modification
12.2(2)XN This feature was introduced for Cisco CallManager Version 3.0.
12.2(11)T Support was added for Cisco CallManager Version 3.2.
Finding Support Information for Platforms and Cisco IOS Software Images
Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image
support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on
Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at
the login dialog box and follow the instructions that appear.
Note For more information about this and related Cisco IOS voice features, see the following:
• “Overview of Cisco Unified CallManager and Cisco IOS Interoperability” on page 13.
• Entire Cisco IOS Voice Configuration Library—including library preface and glossary, other feature
documents, and troubleshooting documentation—at
http://www.cisco.com/univercd/cc/td/doc/product/software/ios123/123cgcr/voice_c/vcl.htm.
Contents
• Restrictions for MGCP PRI Backhaul and T1 CAS Support, page 112
• Information About MGCP PRI Backhaul and T1 CAS Support, page 112
• How to Configure MGCP PRI Backhaul Support for Cisco Unified CallManager, page 113
• Configuration Examples for MGCP PRI Backhaul and T1 CAS, page 124
• Where to Go Next, page 125
• Additional References, page 125
MGCP PRI backhaul terminates all ISDN PRI Layer 2 (Q.921) signaling functions on the MGCP
gateway while, at the same time, packaging all the ISDN PRI Layer 3 (Q.931) signaling information into
packets for transmission to Cisco Unified CallManager through an IP tunnel over a TCP connection. This
ensures the integrity of the Q.931 signaling information that passes through the network for managing
IP telephony devices. A rich set of user-side and network-side ISDN PRI calling functions is supported
by MGCP PRI backhaul.
The MGCP gateway also establishes a TCP link to the backup (secondary) Cisco Unified CallManager
server. In the event of a Cisco Unified CallManager switchover, the secondary Cisco Unified
CallManager server performs the MGCP PRI backhaul functions. During the switchover, all active ISDN
PRI calls are preserved, and the affected MGCP gateway is registered with the new Cisco Unified
CallManager server through a Restart-in-Progress (RSIP) message. In this way, continued gateway
operation is ensured.
T1 CAS is supported in nonbackhaul fashion. Cisco Unified CallManager supports the following CAS
signaling types: E&M, wink-start, and E&M delay-dial. E1 CAS is not supported.
SUMMARY STEPS
1. enable
2. configure terminal
3. controller {t1 | e1} slot/port
4. framing {esf | sf | crc4 | no crc4 | mp-crc4} [australia]
5. clock source {internal | line}
6. linecode {ami | b8zs | hdb3}
7. pri-group timeslots timeslot-range service mgcp
8. exit
9. interface serial slot/port:timeslot
10. isdn switch-type {primary-4ess | primary-5ess | primary-dms100 | primary-ni | primary-net5 |
primary-ntt | primary-qsig | primary-ts014}
11. isdn bind-L3 ccm-manager
12. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 controller {t1 | e1} slot/port Enters controller configuration mode.
Example:
Router(config)# controller t1 3/0
Step 4 framing {esf | sf | crc4 | no-crc4 | mp-crc4} Specifies the framing type on a E1 or T1 PRI line.
[australia]
• Default is sf (super frame) for T1 lines; CRC4 for E1
lines.
Example:
Router(config-controller)# framing esf
Example:
Router(config-if)# isdn bind-L3 ccm-manager
Step 12 exit Exits interface configuration mode and returns to global
configuration mode.
Example:
Router(config-if)# exit
DETAILED STEPS
Note For a description of the fields displayed in these output examples, see the Cisco IOS Voice Command
Reference, Release 12.3T.
Prerequisites for MGCP Gateway Support for Cisco Unified CallManager Network Specific
Facilities
• Cisco IOS Release 12.3(4)T or later
• NM-HDV or NM-HDV2
• Supported interface cards:
– AIM-ATM-VOICE-30
– AIM-VOICE-30
• Supported switch types:
– PRI 4ESS
– PRI 5E8
– PRI 5E9
– DMS 100
– DMS 250
– PRI NI-2
• MGCP PRI backhaul configuration. For information, see:
– “Configuring MGCP PRI Backhaul and T1 CAS Support for Cisco Unified CallManager” on
page 111
– How to Configure MGCP with Digital PRI and Cisco Unified CallManager
• Cisco CallManager Version 3.3(2) or later with the following configured:
– Network Service Protocol—Choose the PRI protocol that matches the protocol of the
terminating gateway from the Network Service Protocol drop-down field.
– Network Service—Choose the appropriate network service. The values vary depending on the
network service protocol that you choose from the Network Service Protocol drop-down field.
– Service Parameter Name—Displays the service parameter name that is associated with the
chosen network service. If no service parameter exists for the network service, the field displays
<Not Exist>.
– Service Parameter Value—Enter the appropriate service parameter value. Valid entries include
the digits 0 to 9. If a service parameter does not exist for the network service, Cisco Unified
CallManager disables this field.
– Route patterns—For more information, see the Cisco Unified CallManager Administration
Guide, Release 4.0(1).
• Cisco Unified CallManager supports NSF only if the appropriate carrier identification code (CIC)
is entered in the CIC field. CICs, which can be 3 or 4 digits or no digits, enable you to reach the
services of interexchange carriers. For a complete list of CICs, go to http://www.nanpa.com. The
following are examples of commonly used CICs:
– 0222—WorldCom and MCI
– 0288—ATT
– 0333—Sprint
1. show ccm-manager
2. show mgcp endpoints
3. debug ccm-manager backhaul
4. debug isdn q931
DETAILED STEPS
============================================================
Primary Registered 10.16.240.124
Packets xmitted: 32
Xmit failures: 0
PRI Ports being backhauled: Slot 1, port 0
!
Configuration Auto-Download Information
=======================================
No configurations downloaded
Current state: Automatic Configuration Download feature is disabled
Configuration Error History:
FAX mode: cisco
Interface T1 1/0
!
ENDPOINT-NAME V-PORT SIG-TYPE ADMIN
S1/ds1-0/1@AV-2620-4 1/0:23 none up
S1/ds1-0/2@AV-2620-4 1/0:23 none up
S1/ds1-0/3@AV-2620-4 1/0:23 none up
S1/ds1-0/4@AV-2620-4 1/0:23 none up
S1/ds1-0/5@AV-2620-4 1/0:23 none up
S1/ds1-0/6@AV-2620-4 1/0:23 none up
S1/ds1-0/7@AV-2620-4 1/0:23 none up
S1/ds1-0/8@AV-2620-4 1/0:23 none up
S1/ds1-0/9@AV-2620-4 1/0:23 none up
S1/ds1-0/10@AV-2620- 1/0:23 none up
S1/ds1-0/11@AV-2620- 1/0:23 none up
S1/ds1-0/12@AV-2620- 1/0:23 none up
S1/ds1-0/13@AV-2620- 1/0:23 none up
S1/ds1-0/14@AV-2620- 1/0:23 none up
S1/ds1-0/15@AV-2620- 1/0:23 none up
S1/ds1-0/16@AV-2620- 1/0:23 none up
S1/ds1-0/17@AV-2620- 1/0:23 none up
S1/ds1-0/18@AV-2620- 1/0:23 none up
S1/ds1-0/19@AV-2620- 1/0:23 none up
S1/ds1-0/20@AV-2620- 1/0:23 none up
S1/ds1-0/21@AV-2620- 1/0:23 none up
S1/ds1-0/22@AV-2620- 1/0:23 none up
S1/ds1-0/23@AV-2620- 1/0:23 none up
The bold portion of the above number is the NSF related information in the setup message of the
backhaul packet.
28086E616D65343430316C0600813434303170058039393939
1w0d:
cmbrl_send_pak: >-- Sending backhauled msg for Se1/1:23 :
| bk_msg_type = DATA_IND
| bk_chan_id (slot:port) = 1:1
| Q.931 length = 12
| Q.931 message type: STATUS
| Q.931 message = 080280047D080280E4140101
1w0d:
cmbrl_send_pak: --> Sending backhauled msg for Se1/1:23 :
| bk_msg_type = DATA_IND
| bk_chan_id (slot:port) = 1:1
| Q.931 length = 10
| Q.931 message type: CALL PROCEEDING
| Q.931 message = 08028004021803A98397
1w0d:
cmbrl_send_pak: --> Sending backhauled msg for Se1/1:23 :
| bk_msg_type = DATA_IND
| bk_chan_id (slot:port) = 1:1
| Q.931 length = 9
| Q.931 message type: PROGRESS
| Q.931 message = 08028004031E028188
1w0d:
cmbrl_send_pak: --> Sending backhauled msg for Se1/1:23 :
| bk_msg_type = DATA_IND
| bk_chan_id (slot:port) = 1:1
| Q.931 length = 9
| Q.931 message type: CONNECT
| Q.931 message = 08028004071E028182
1w0d:
cmbh_rcv_callback: <-- Receiving backhaul msg for Se1/1:23 :
| bk_msg_type = DATA_REQ
| bk_chan_id (slot:port) = 1:1
| Q.931 length = 5
| Q.931 message type: CONNECT ACK
| Q.931 message = 080200040F
1w0d:
cmbrl_send_pak: --> Sending backhauled msg for Se1/1:23 :
| bk_msg_type = DATA_IND
| bk_chan_id (slot:port) = 1:1
| Q.931 length = 9
| Q.931 message type: DISCONNECT
| Q.931 message = 080280044508028290
1w0d:
cmbh_rcv_callback: <-- Receiving backhaul msg for Se1/1:23 :
| bk_msg_type = DATA_REQ
| bk_chan_id (slot:port) = 1:1
| Q.931 length = 5
| Q.931 message type: RELEASE
| Q.931 message = 080200044D
1w0d:
cmbrl_send_pak: --> Sending backhauled msg for Se1/1:23 :
| bk_msg_type = DATA_IND
| bk_chan_id (slot:port) = 1:1
| Q.931 length = 5
| Q.931 message type: RELEASE COMPLETE
| Q.931 message = 080280045A
Use the debug isdn q931 command to display the ISDN Layer 3 processing, for example:
Router# debug isdn q931
!
debug isdn q931 is ON.
1w0d: ISDN Se1/1:23 Q931: TX -> SETUP pd = 8 callref = 0x0003
Bearer Capability i = 0x8090A2
Standard = CCITT
Transfer Capability = Speech
Transfer Mode = Circuit
Transfer Rate = 64 kbit/s
Channel ID i = 0xA98397
Exclusive, Channel 23
Progress Ind i = 0x8083 - Origination address is non-ISDN
Net Specific Fac i = 0x04A1323838E7
Display i = 'name4401'
Calling Party Number i = 0x0081, '4401'
Plan:Unknown, Type:Unknown
Called Party Number i = 0x80, '9999'
Plan:Unknown, Type:Unknown
1w0d: ISDN Se1/1:23 Q931: RX <- STATUS pd = 8 callref = 0x8003
Cause i = 0x80E4 - Invalid information element contents
Call State i = 0x01
1w0d: ISDN Se1/1:23 Q931: RX <- CALL_PROC pd = 8 callref = 0x8003
Channel ID i = 0xA98397
Exclusive, Channel 23
1w0d: ISDN Se1/1:23 Q931: RX <- PROGRESS pd = 8 callref = 0x8003
Progress Ind i = 0x8188 - In-band info or appropriate now available
1w0d: ISDN Se1/1:23 Q931: RX <- CONNECT pd = 8 callref = 0x8003
Progress Ind i = 0x8182 - Destination address is non-ISDN
1w0d: ISDN Se1/1:23 Q931: TX -> CONNECT_ACK pd = 8 callref = 0x0003
1w0d: ISDN Se1/1:23 Q931: RX <- DISCONNECT pd = 8 callref = 0x8003
Cause i = 0x8290 - Normal call clearing
1w0d: ISDN Se1/1:23 Q931: TX -> RELEASE pd = 8 callref = 0x0003
1w0d: ISDN Se1/1:23 Q931: RX <- RELEASE_COMP pd = 8 callref = 0x8003
Note For a description of the fields displayed in these output examples, see the Cisco IOS Voice Command
Reference, Release 12.3T and the Cisco IOS Debug Command Reference, Release 12.3.
Prerequisites
• Cisco IOS Release 12.3(11)T or later
• MGCP must be configured on the voice gateway. For information, see “Configuring MGCP Gateway
Support for Cisco Unified CallManager” on page 23.
• ISDN PRI Backhaul must be configured on the MGCP gateway. For information, see the
“Configuring MGCP PRI Backhaul on the Cisco Voice Gateway” section on page 114.
• QSIG signaling is required to support supplementary services over the T1 and E1 time-division
multiplexing (TDM) trunks that support the PRI backhaul mechanism.
• Cisco Catalyst 6500 series and Cisco 7600 series Communication Media Module (CMM) requires
WS-SVC-CMM-6T1 or WS-SVC-CMM-6E1 port adapter.
IP communications
Legacy telephony
systems
systems
QSIG and
supplementary
services
IP LAN
IP V
Cisco voice
gateway
IP
103193
IP
For more information about QSIG support in Cisco Unified CallManager, see the “Understanding IP
Telephony Protocols” chapter in the Cisco Unified CallManager System Guide.
Note To view relevant configuration examples, go to the Cisco Systems Technologies website at
http://cisco.com/en/US/tech/index.html. From the website, select Voice > IP Telephony/VoIP, then
click Technical Documentation > Configuration Examples.
Where to Go Next
• To configure conferencing, transcoding, and MTP support on a Cisco IOS gateway, see “Configuring
Enhanced Conferencing and Transcoding for Voice Gateway Routers” on page 65.
• To enable MGCP BRI backhaul support, see “Configuring MGCP-Controlled Backhaul of
BRI Signaling in Conjunction with Cisco Unified CallManager” on page 127.
• To download region-specific tones and their associated frequencies, amplitudes, and cadences, see
“Configuring Tone Download to MGCP Gateways” on page 143.
Additional References
• “Cisco Unified CallManager and Cisco IOS Interoperability Features Roadmap” on
page 9—Describes how to access Cisco Feature Navigator; also lists and describes, by Cisco IOS
release, Cisco Unified CallManager and Cisco IOS interoperability features.
• “Overview of Cisco Unified CallManager and Cisco IOS Interoperability” on page 13—Describes
basics of underlying technology and lists related documents.
• How to Configure MGCP with Digital PRI and Cisco Unified CallManager—Technical support
configuration document that includes sample configurations and troubleshooting tips.
The MGCP-Controlled Backhaul of Basic Rate Interface (BRI) Signaling in Conjunction with
Cisco Unified CallManager feature provides MGCP service to remote-office gateways that connect by
means of ISDN BRI trunks to a centralized Cisco Unified CallManager.
Feature benefits include the following:
• Centralized call-management architecture, enabling a high degree of network control
• Short voice cut-through times
• Graceful evolution to new technology and to AVVID
Only the ETSI BRI basic-net3 switch type is supported.
Feature History for MGCP-Controlled Backhaul of BRI Signaling in Conjunction with Cisco Unified CallManager
Release Modification
12.2(15)ZJ This feature was introduced for Cisco CallManager 3.3(2).
12.3(2)T This feature was integrated into Cisco IOS Release 12.3(2)T.
12.3(11)T Support was added for Cisco Unified CallManager 4.1.
12.4(2)T This feature was implemented on the Cisco 2600XM, Cisco 2691,
Cisco 2800 series, Cisco 3700 series, and Cisco 3800 series.
Finding Support Information for Platforms and Cisco IOS Software Images
Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image
support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on
Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at
the login dialog box and follow the instructions that appear.
Note For more information about this and related Cisco IOS voice features, see the following:
• “Overview of Cisco Unified CallManager and Cisco IOS Interoperability” on page 13.
• Entire Cisco IOS Voice Configuration Library—including library preface and glossary, other feature
documents, and troubleshooting documentation—at
http://www.cisco.com/univercd/cc/td/doc/product/software/ios123/123cgcr/voice_c/vcl.htm.
Contents
• Prerequisites for MGCP-Controlled Backhaul of BRI Signaling, page 128
• Restrictions for MGCP-Controlled Backhaul of BRI Signaling, page 129
• Information About MGCP-Controlled Backhaul of BRI Signaling, page 129
• How to Configure MGCP-Controlled Backhaul of BRI Signaling, page 131
• Configuration Examples for MGCP-Controlled Backhaul of BRI Signaling, page 135
• Where to Go Next, page 141
• Additional References, page 142
Note For MGCP configuration instructions, see “Configuring MGCP Gateway Support for
Cisco Unified CallManager” on page 23.
TE
NT
IP network/
WAN
82726
Media gateway
WAN M
V
HQ Cisco Unified CallManager
BRI
PSTN
82768
The following is the sequence of events during normal backhaul:
1. A call comes in from the PSTN and passes over the BRI trunk to the MGCP gateway.
2. The MGCP gateway passes signaling information from the call across the WAN to the Cisco Unified
CallManager at headquarters.
3. Cisco Unified CallManager instructs the MGCP gateway on how to set up and manage the call.
4. The call is established.
1. enable
2. configure terminal
3. interface bri slot/port
4. shutdown
5. isdn switch-type basic-net3
6. isdn bind-L3 ccm-manager service mgcp
7. no shutdown
8. no mgcp
9. mgcp
10. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 interface bri slot/port Configures the BRI interface as the MGCP-BRI backhaul
endpoint.
Example: • Slot and port syntax is platform-dependent; type ? to
Router(config)# interface bri 1/0 determine.
Note This command is supported only for a user-side
ETSI NET3 switch-type.
Example:
Router(config-if)# isdn bind-L3 ccm-manager
service mgcp
Step 7 no shutdown Restarts the interface if it was previously disabled.
Example:
Router(config-if)# no shutdown
Step 8 no mgcp Disables all MGCP applications and protocols.
Example:
Router(config-if)# no mgcp
Step 9 mgcp Restarts MGCP and reregisters the gateway to
Cisco Unified CallManager.
Example:
Router(config-if)# mgcp
Step 10 exit Exits interface-configuration mode.
Example:
Router(config-if)# end
DETAILED STEPS
Use the show isdn status command to verify that Layer 2 is established and that Layer 3 is configured
as Cisco Unified CallManager. This output displays only if TEI negotiation is performed at startup.
Router# show isdn status
Note Use this command only if TEI negotiation is done at startup. Otherwise, TEI negotiation is done
when the first call is placed, so output shows Layer 2 with no TEI negotiated and Layer 3 as
down.
Xmit failures: 0
BRI Ports being backhauled:
Slot 0, VIC 0, port 0
Slot 1, VIC 0, port 0
BRI/S1/SU0/P1/1@3745-1
BRI/S1/SU0/P1/2@3745-1
Command Purpose
command-type a-law Enables you to address poor voice quality. If your
system uses a-law pulse-code modulation (PCM),
use this command in interface-BRI configuration
mode to reconfigure the BRI voice port in the
gateway for a-law PCM. The system default is
mu-law PCM.
debug ccm-manager backhaul packets Displays debugging information about
Cisco Unified CallManager backhaul message
packets.
debug isdn q931 Displays debugging information about ISDN L3
Q.931 message packets.
debug mgcp packets Displays debugging information about MGCP
message packets.
SUMMARY STEPS
1. enable
2. configure terminal
3. mgcp package-capability srtp-package
4. mgcp validate call-agent source-ipaddr
5. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 mgcp package-capability srtp-package Enables the MGCP gateway capability to process SRTP
packages.
Example:
Router(config)# mgcp package-capability
srtp-package
Step 4 mgcp validate call-agent source-ipaddr (Optional) Enables the MGCP application validation that
packets received are sent by a configured call agent.
Example:
Router(config)# mgcp validate call-agent
source-ipaddr
Step 5 exit Exits global configuration mode.
Example:
Router(config)# exit
Building configuration...
interface FastEthernet0/0
ip address 10.3.102.2 255.255.0.0
duplex auto
speed auto
!
interface FastEthernet0/1
no ip address
shutdown
duplex auto
speed auto
!
interface BRI1/0
no ip address
isdn switch-type basic-net3
isdn incoming-voice voice
isdn bind-l3 ccm-manager service mgcp
isdn skipsend-idverify
!
interface BRI1/1
no ip address
isdn switch-type basic-net3
isdn protocol-emulate network
isdn layer1-emulate network
isdn incoming-voice voice
isdn skipsend-idverify
!
interface BRI2/0
no ip address
isdn switch-type basic-net3
isdn incoming-voice voice
isdn bind-l3 ccm-manager service mgcp
isdn skipsend-idverify
!
interface BRI2/1
no ip address
isdn switch-type basic-net3
isdn protocol-emulate network
isdn layer1-emulate network
isdn incoming-voice voice
isdn skipsend-idverify
!
interface BRI3/0
no ip address
isdn switch-type basic-net3
isdn incoming-voice voice
isdn bind-l3 ccm-manager service mgcp
isdn skipsend-idverify
!
interface BRI3/1
no ip address
isdn switch-type basic-net3
isdn protocol-emulate network
isdn layer1-emulate network
isdn incoming-voice voice
isdn skipsend-idverify
!
!
ip default-gateway 10.3.0.1
ip classless
ip route 0.0.0.0 0.0.0.0 10.3.0.1
!
ip http server
no ip http secure-server
!
!
access-list 10 deny 10.3.102.99 log
access-list 10 permit any
!
!
!
control-plane
!
!
call application alternate DEFAULT
!
!
voice-port 1/1/0
!
voice-port 1/1/1
!
voice-port 2/0/0
!
voice-port 2/0/1
!
voice-port 3/0/0
!
voice-port 3/0/1
!
voice-port 3/1/0
!
voice-port 3/1/1
!
voice-port 3/1/2
!
voice-port 3/1/3
!
!
mgcp
mgcp call-agent 10.3.102.99 service-type mgcp version 0.1
mgcp package-capability srtp-package
!
mgcp profile default
!
!
!
dial-peer voice 1 pots
application mgcpapp
direct-inward-dial
port 3/0/0
forward-digits all
!
dial-peer voice 100 voip
application mgcpapp
destination-pattern 9...
session target ipv4:10.3.102.1
incoming called-number .
!
dial-peer voice 2 pots
destination-pattern 5001
port 3/1/0
!
dial-peer voice 4 pots
destination-pattern 6T
direct-inward-dial
port 3/0/1
!
dial-peer voice 3 pots
destination-pattern 5002
port 3/1/3
!
dial-peer voice 11 pots
destination-pattern 2T
direct-inward-dial
port 2/0/1
!
dial-peer voice 12 pots
application mgcpapp
direct-inward-dial
port 2/0/0
forward-digits all
!
!
!
call-manager-fallback
max-conferences 8
ip source-address 10.3.102.2 port 2000
max-ephones 2
max-dn 4
!
!
line con 0
exec-timeout 0 0
line aux 0
line vty 0 4
login
!
end
!
controller T1 3/0
framing esf
clock source internal
linecode b8zs
pri-group timeslots 1-24 service mgcp
!
controller T1 3/1
framing esf
linecode b8zs
!
!
!
interface FastEthernet0/0
ip address 10.15.43.101 255.255.0.0
duplex auto
speed auto
no cdp enable
!
interface Serial0/0
no ip address
encapsulation frame-relay
shutdown
clockrate 125000
frame-relay lmi-type ansi
!
interface FastEthernet0/1
no ip address
shutdown
duplex auto
speed auto
!
interface Serial0/1
no ip address
shutdown
clockrate 125000
!
interface BRI1/0
no ip address
isdn switch-type basic-net3
isdn incoming-voice voice
isdn bind-l3 ccm-manager service mgcp
!
interface BRI1/1
no ip address
isdn switch-type basic-qsig
!
interface Serial3/0:23
no ip address
no logging event link-status
isdn switch-type primary-qsig
isdn incoming-voice voice
no cdp enable
!
ip default-gateway 10.15.10.11
ip classless
ip route 0.0.0.0 0.0.0.0 10.15.10.11
ip http server
!
ip pim bidir-enable
!
!
!
call rsvp-sync
!
voice-port 1/0/0
!
voice-port 1/0/1
!
voice-port 2/0/0
!
voice-port 2/0/1
!
voice-port 2/1/0
!
voice-port 2/1/1
!
voice-port 3/0:23
!
mgcp
mgcp call-agent 10.14.181.10 service-type mgcp version 0.1
mgcp sdp simple
!
mgcp profile default
!
!
!
dial-peer cor custom
!
!
!
dial-peer voice 6000 pots
application mgcpapp
port 2/0/0
!
dial-peer voice 4000 pots
application mgcpapp
port 2/0/1
!
!
line con 0
exec-timeout 0 0
line aux 0
line vty 0 4
login
!
!
end
Where to Go Next
• To configure conferencing, transcoding, and MTP support on a Cisco IOS gateway, see “Configuring
Enhanced Conferencing and Transcoding for Voice Gateway Routers” on page 65.
• To enable MGCP PRI backhaul support, see “Configuring MGCP PRI Backhaul and T1 CAS
Support for Cisco Unified CallManager” on page 111.
• To download region-specific tones and their associated frequencies, amplitudes, and cadences, see
“Configuring Tone Download to MGCP Gateways” on page 143.
Additional References
• “Cisco Unified CallManager and Cisco IOS Interoperability Features Roadmap” on
page 9—Describes how to access Cisco Feature Navigator; also lists and describes, by Cisco IOS
release, Cisco Unified CallManager and Cisco IOS interoperability features.
• “Overview of Cisco Unified CallManager and Cisco IOS Interoperability” on page 13—Describes
basics of underlying technology and lists related documents.
• “Configuring ISDN BRI” in the Cisco IOS Dial Technologies Configuration Guide,
Release 12.4—Describes how to configure ISDN BRI on the voice gateway.
• “ISDN Switch Types, Codes, and Values” appendix in the Debug Command Reference,
Release 12.4—Describes supported switch types.
• Cisco Unified CallManager documentation—Describes how to install and configure Cisco Unified
CallManager.
The Customizable Tone Download to Cisco IOS MGCP Gateways from Cisco Unified CallManager
feature enables the Cisco IOS gateway to download region-specific tones and the associated frequencies,
amplitudes, and cadences in its XML configuration files.
Cisco IOS gateways support static tone tables that are predefined for each country in Cisco IOS tone
tables. Voice ports use the static tone tables associated with the Cisco Unified CallManager network
locale unless the custom tone download feature is enabled
Feature History for Customizable Tone Download to Cisco IOS MGCP Gateways from Cisco Unified CallManager
Release Modification
12.2(15)ZJ This feature was introduced.
12.3(4)T This feature was integrated into Cisco IOS Release 12.3(4)T.
Feature History for Globalized Cadence and Tone for Cisco IOS Gateways
Release Modification
12.2(11)T This feature was introduced.
Finding Support Information for Platforms and Cisco IOS Software Images
Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image
support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on
Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at
the login dialog box and follow the instructions that appear.
Note For more information about this and related Cisco IOS voice features, see the following:
• “Overview of Cisco Unified CallManager and Cisco IOS Interoperability” on page 13.
• Entire Cisco IOS Voice Configuration Library—including library preface and glossary, other feature
documents, and troubleshooting documentation—at
http://www.cisco.com/univercd/cc/td/doc/product/software/ios123/123cgcr/voice_c/vcl.htm.
Contents
• Information About Tone Download to MGCP Gateways, page 144
• How to Configure Tone Download to MGCP Gateways, page 146
• Configuration Examples for Tone Download to MGCP Gateways, page 158
• Where to Go Next, page 159
• Additional References, page 159
Static Tones
The Globalized Cadence and Tone for Cisco IOS Gateways feature enables Cisco IOS gateways to
support Cisco Unified CallManager localization using static tone tables that are predefined for each
country in Cisco IOS tone tables. The static tone table that is used for a voice port is determined by the
network locale that is specified for the voice port in Cisco Unified CallManager. When an MGCP
gateway registers to Cisco Unified CallManager, or if the gateway restarts or resets, the network locale
for each voice port is downloaded in the gateway’s XML configuration file.
The static tones and cadences associated with the Cisco Unified CallManager network locale are used
by a voice port unless a custom tone table is downloaded. No configuration is required on the MGCP
gateway to use the static tones.
Table 11 shows the list of valid two-letter country codes and the corresponding countries.
Custom Tones
The Customizable Tone Download to Cisco IOS MGCP Gateways from Cisco Unified CallManager
feature enables an MGCP gateway to download locale-specific tones and their associated frequency,
amplitude, and cadence information from the XML-based configuration file.
The XML tone file includes all supported tones for one country with the frequency, amplitude, and
cadence information. The XML tone file is parsed and saved into a custom tone table on the MGCP
gateway. Each gateway supports up to two custom tone tables. The default values for North America are
overwritten with the new values specified in the XML file. Dual tones and sequential tones, and up to
4 frequencies for standard or custom tones are supported.
When Cisco Unified CallManager requests a specific tone, the gateway references the custom tone table
associated with the network locale of the voice port. After the custom tone specification is downloaded
to the gateway, it can be used even if the gateway loses connectivity to Cisco Unified CallManager and
reverts to H.323 control in fallback mode.
If custom tone download is not configured, the voice port uses the static tone table associated with the
network locale of the voice port. If custom tone download is configured but fails, the voice port continues
to use the static tone table for the network locale.
Figure 11 shows the download of the XML file from the TFTP server to the MGCP gateway.
XML file
TFTP server
IP cloud
MGCP gateway
After tone download
Static tone
Custom tone
82980
Note There are no configuration tasks necessary to enable globalized cadence and tone except those described
in Prerequisites.
Prerequisites
• Cisco IOS Release 12.2(11)T or later
• Cisco CallManager 3.2 or higher
• Cisco Unified CallManager 4.0 or higher
• Cisco IOS gateway must be configured for MGCP and must have single-point configuration enabled.
See “Configuring MGCP Gateway Support for Cisco Unified CallManager” on page 23 for
information.
Note The IP hostname should match the gateway name that is specified in the Cisco Unified
CallManager configuration.
• Ad-hoc conferencing and transcoding port adapter (WS-SVC-CMM-ACT) must be installed and
configured on the Cisco Catalyst 6500 Series and Cisco 7600 Series Router Communication Media
Module (CMM).
SUMMARY STEPS
DETAILED STEPS
Cisco 3660
Router# show voice port
Foreign Exchange Station 2/0/0 Slot is 2, Sub-unit is 0, Port is 0
Type of VoicePort is FXS
Operation State is DORMANT
Administrative State is UP
No Interface Down Failure
Description is not set
Noise Regeneration is enabled
Non Linear Processing is enabled
Non Linear Mute is disabled
Non Linear Threshold is -21 dB
Music On Hold Threshold is Set to -38 dBm
In Gain is Set to 0 dB
Out Attenuation is Set to 3 dB
Echo Cancellation is enabled
Echo Cancellation NLP mute is disabled
Echo Cancellation NLP threshold is -21 dB
Echo Cancel Coverage is set to 8 ms
Playout-delay Mode is set to default
Playout-delay Nominal is set to 60 ms
Playout-delay Maximum is set to 200 ms
Playout-delay Minimum mode is set to default, value 40 ms
Playout-delay Fax is set to 300 ms
Connection Mode is normal
Connection Number is not set
Initial Time Out is set to 10 s
Interdigit Time Out is set to 10 s
Call Disconnect Time Out is set to 60 s
Ringing Time Out is set to 180 s
Wait Release Time Out is set to 30 s
Companding Type is u-law
Region Tone is set for US
Cisco VG200
Router# show voice port
Prerequisites
• Cisco CallManager 3.3(2) or higher.
• Cisco Unified CallManager 4.0 or higher
• DSP 3.6.16 or later for analog interfaces; DSP 4.0 or later for digital interfaces.
• For languages other than English and countries other than the United States, locale files that provide
regional tones and cadences must be installed in Cisco Unified CallManager. The locale installer
adds the files to the correct directories and updates the Cisco Unified CallManager database.
See the Using the Cisco IP Telephony Locale Installer document for information.
• The following cards are supported:
– AIM-ATM-VOICE
– AIM-VOICE
– NM-HDA
– NM-HDV
– VIC-2FXO
– VIC-2FXS
Restrictions
Up to two custom tone tables are supported on a gateway; that is, no more than two custom tone tables
can be downloaded to one gateway even if there are more that two countries or regions configured for
the gateway.
SUMMARY STEPS
1. enable
2. configure terminal
3. ccm-manager config {server ip-address | name}
4. ccm-manager config
5. ccm-manager download-tones
6. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 ccm-manager config {server ip-address | name} Specifies the TFTP server that contains the XML
configuration file to download.
Example: Note Up to three servers can be configured.
Router(config)# ccm-manager config server
10.10.10.0
Step 4 ccm-manager config Enables single-point download and configuration.
Example:
Router(config)# ccm-manager config
Step 5 ccm-manager download-tones Enables the custom tone download to the gateway.
Example:
Router(config)# ccm-manager download-tones
Step 6 exit Exits the session.
Example:
Router(config)# exit
SUMMARY STEPS
DETAILED STEPS
Note Voice ports are automatically configured during the initial download of the XML file from the
TFTP server.
The following sample output shows the downloaded tone information including the number of
frequencies and cadences:
Router# show ccm-manager download-tones C1
!
Custom Tone 1 : United Kingdom
Pulse dial: normal, Percent make: 35%, DTMF low Amp. = 65438, high Amp. = 65463 Pcm: u-Law
FXS FXO E&M FXS FXO E&M
Dual Tone DR NF FOF FOS AOF AOF AOF AOS AOS AOS ONTF OFTF ONTS OFTS ONTT OFTT ONT4 OFT4
(optional) FOF2 FOS2 FOF3 FOS3 FOF4 FOS4 FOT FO4 AOT AO4 RCT1 RCT2 RCT3 RCT4
BUSY 0 1 400 0 -200 -200 -240 0 0 0 375 375 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
RING_BACK 0 2 400 450 -190 -190 -190 -190 -190 -190 400 200 400 2000 0 0 0 0 0 0 0 0 0 0
CONGESTION 0 1 400 0 -200 -200 -200 0 0 0 400 350 225 525 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
NUMBER_UNOBTAINABLE 0 1 400 0 -150 -150 -150 0 0 0 400 350 225 525 0 0 0 0 0 0 0 0 0 0 0 0
DIAL_TONE 0 2 350 440 -150 -150 -150 -150 -150 -150 65535 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
DIAL_TONE2 0 2 350 440 -150 -150 -150 -150 -150 -150 65535 0 0 0 0 0 0 0 0 0 0 0 0 00 0 0
OUT_OF_SERVICE 0 1 950 0 -150 -150 -185 0 0 0 330 330 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
ADDR_ACK 0 1 600 0 -240 -240 -240 0 0 0 125 125 125 65535 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
DISCONNECT 0 1 600 0 -150 -150 -150 0 0 0 330 330 330 65535 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
OFF_HOOK_NOTICE 0 2 1400 2040 -240 -240 -240 -240 -240 -240 100 100 0 0 0 0 0 0 0 0 0 0 0
OFF_HOOK_ALERT 0 2 1400 2040 -150 -150 -185 -150 -150 -185 100 100 0 0 0 0 0 0 0 0 0 0 0 0
WAITING 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
CONFIRM 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
CNFWRN_J 0 1 950 0 -170 -170 -190 0 0 0 100 100 100 65535 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
CNFWRN_D 0 1 600 0 -170 -170 -190 0 0 0 100 100 100 65535 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
STUTT_DIALTONE 0 2 350 440 -150 -150 -150 -150 -150 -150 100 100 100 100 100 100 65535 0 0
Sequence Tone DR NF F1C1 F2C1 AOF AOS C1ONT C1OFT C2ONT C2OFT C3ONT C3OFT C4ONT C4OFT F1C2
F2C2 F1C3 F2C3 F1C4 F2C4
INTERCEPT 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
TONE_ON_HOLD 0 1 500 500 0 0 100 150 100 150 100 150 0 10000 500 0 500 0 0 0
NO_CIRCUIT 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
!
Legend:
DR : direction NF : number of frequency
FO<F,S,T,4> : frequency of<1st,2nd,3rd,4th> AO<F,S,T,4> : amplitude of<1st,2nd,3rd,4th>
FOF<1-4> : frequency of 1st, cadence<1-4> FOS<1-4> : frequency of 2nd, cadence<1-4>
ONT<F,S,T,4> : on time<1st,2nd,3rd,4th> OFT<F,S,T,4> : off time<1st,2nd,3rd,4th>
RCT<1-4> : repeat count for cadence<l-4> F(1-4>C<1-4> : frequency<1-4> of cadence<1-4>
C<1-4>ONT : cadence<1-4> on time C<1-4>OFT : cadence<1-4> off time
Use the debug ccm-manager config-download tone command to troubleshoot the download procedure.
The following sample output shows the locale name as United Kingdom and lists all of the dual-tone
parameters for that region:
Router# debug ccm-manager config-download tone
00:09:07:
cmapp_prefix_process_tag_tones:
00:09:07: cmapp_process_tag_trkLocaleName: region = United Kingdom
00:09:07: cmapp_process_tag_pulse_ratio: pulse ratio = 40
00:09:07: cmapp_process_tag_dtmf_llevel: low frequency level = 65438
00:09:07: cmapp_process_tag_dtmf_hlevel: high frequency level = 65463
00:09:07: cmapp_process_tag_special_oper: operation = uLaw
00:09:07: cmapp_prefix_process_tag_lpig:
00:09:07: cmapp_process_tag_fxs: ignore LPIG for fxs
00:09:07: cmapp_process_tag_fxo: ignore LPIG for fxo
00:09:07: cmapp_process_tag_digital: ignore LPIG for digital
00:09:07: cmapp_prefix_process_tag_lpog:
00:09:07: cmapp_process_tag_fxs: ignore LPOG for fxsBoth ports are in service
00:09:07: cmapp_process_tag_fxo: ignore LPOG for fxo
00:09:07: cmapp_process_tag_digital: ignore LPOG for digital
00:09:07: cmapp_prefix_process_tag_tonetable_info:
00:09:07:
cmapp_prefix_process_tag_dualtone: TID=[0:CPTONE_BUSY]
00:09:07: cmapp_process_tag_nf: number of frequencies = 1
00:09:07: cmapp_process_tag_dr: direction = 0
00:09:07: cmapp_process_tag_fof: frequency 1 = 400
00:09:07: cmapp_process_tag_fos: frequency 2 = 0
00:09:07: cmapp_process_tag_fot: frequency 3 = 0
00:09:07: cmapp_process_tag_fo4: frequency 4 = 0
00:09:07: cmapp_prefix_process_tag_aof_level:
00:09:07: cmapp_process_tag_fxs: amplitude of 1st = -200
00:09:07: cmapp_process_tag_fxo: amplitude of 1st = -200
00:09:07: cmapp_process_tag_digital: amplitude of 1st = -240
00:09:07: cmapp_prefix_process_tag_aos_level:
00:09:07: cmapp_process_tag_fxs: amplitude of 2nd = 0
00:09:07: cmapp_process_tag_fxo: amplitude of 2nd = 0
00:09:07: cmapp_process_tag_digital: amplitude of 2nd = 0
00:09:07: cmapp_prefix_process_tag_aot_level:
00:09:07: cmapp_process_tag_fxs: amplitude of 3rd = 0
00:09:07: cmapp_process_tag_fxo: amplitude of 3rd = 0
00:09:07: cmapp_process_tag_digital: amplitude of 3rd = 0
00:09:07: cmapp_prefix_process_tag_ao4_level:
00:09:07: cmapp_process_tag_fxs: amplitude of 4th = 0
00:09:07: cmapp_process_tag_fxo: amplitude of 4th = 0
00:09:07: cmapp_process_tag_digital: amplitude of 4th = 0
00:09:07: cmapp_process_tag_ontf: frequency 1 on time = 375
00:09:07: cmapp_process_tag_oftf: frequency 1 off time = 375
00:09:07: cmapp_process_tag_onts: frequency 2 on time = 0
00:09:07: cmapp_process_tag_ofts: frequency 2 off time = 0
00:09:07: cmapp_process_tag_ontt: frequency 3 on time = 0
00:09:07: cmapp_process_tag_oftt: frequency 3 off time = 0
00:09:07: cmapp_process_tag_ont4: frequency 4 on time = 0
00:09:07: cmapp_process_tag_oft4: frequency 4 off time = 0
00:09:07: cmapp_process_tag_fof2: frequency 1 cadence 2 = 0
00:09:07: cmapp_process_tag_fos2: frequency 2 cadence 2 = 0
00:09:07: cmapp_process_tag_fof3: frequency 1 cadence 3 = 0
00:09:07: cmapp_process_tag_fos3: frequency 2 cadence 3 = 0
00:09:07: cmapp_process_tag_fof4: frequency 1 cadence 4 = 0
00:09:07: cmapp_process_tag_fos4: frequency 2 cadence 4 = 0
00:09:07: cmapp_process_tag_rct1: cadence 1 repeat count = 0
00:09:07: cmapp_process_tag_rct2: cadence 2 repeat count = 0
00:09:07: cmapp_process_tag_rct3: cadence 3 repeat count = 0
00:09:07: cmapp_process_tag_rct4: cadence 4 repeat count = 0
00:09:07:
cmapp_prefix_process_tag_dualtone: TID=[1:CPTONE_RING_BACK]
00:09:07: cmapp_process_tag_nf: number of frequencies = 2
00:09:07: cmapp_process_tag_dr: direction = 0
00:09:07: cmapp_process_tag_fof: frequency 1 = 400
00:09:07: cmapp_process_tag_fos: frequency 2 = 450
00:09:07: cmapp_process_tag_fot: frequency 3 = 0
00:09:07: cmapp_process_tag_fo4: frequency 4 = 0
00:09:07: cmapp_prefix_process_tag_aof_level:
00:09:07: cmapp_process_tag_fxs: amplitude of 1st = -190
00:09:07: cmapp_process_tag_fxo: amplitude of 1st = -190
00:09:07: cmapp_process_tag_digital: amplitude of 1st = -190
00:09:07: cmapp_prefix_process_tag_aos_level:
00:09:07: cmapp_process_tag_fxs: amplitude of 2nd = -190
00:09:07: cmapp_process_tag_fxo: amplitude of 2nd = -190
00:09:07: cmapp_process_tag_digital: amplitude of 2nd = -190
00:09:07: cmapp_prefix_process_tag_aot_level:
00:09:07: cmapp_process_tag_fxs: amplitude of 3rd = 0
00:09:07: cmapp_process_tag_fxo: amplitude of 3rd = 0
00:09:07: cmapp_process_tag_digital: amplitude of 3rd = 0
00:09:07: cmapp_prefix_process_tag_ao4_level:
00:09:07: cmapp_process_tag_fxs: amplitude of 4th = 0
00:09:07: cmapp_process_tag_fxo: amplitude of 4th = 0
00:09:07: cmapp_process_tag_digital: amplitude of 4th = 0
00:09:07: cmapp_process_tag_ontf: frequency 1 on time = 400
00:09:07: cmapp_process_tag_oftf: frequency 1 off time = 200
00:09:07: cmapp_process_tag_onts: frequency 2 on time = 400
00:09:07: cmapp_process_tag_ofts: frequency 2 off time = 2000
00:09:07: cmapp_process_tag_ontt: frequency 3 on time = 0
00:09:07: cmapp_process_tag_oftt: frequency 3 off time = 0
00:09:07: cmapp_process_tag_ont4: frequency 4 on time = 0
00:09:07: cmapp_process_tag_oft4: frequency 4 off time = 0
00:09:07: cmapp_process_tag_fof2: frequency 1 cadence 2 = 0
00:09:07: cmapp_process_tag_fos2: frequency 2 cadence 2 = 0
00:09:07: cmapp_process_tag_fof3: frequency 1 cadence 3 = 0
00:09:07: cmapp_process_tag_fos3: frequency 2 cadence 3 = 0
00:09:07: cmapp_process_tag_fof4: frequency 1 cadence 4 = 0
00:09:07: cmapp_process_tag_fos4: frequency 2 cadence 4 = 0
00:09:07: cmapp_process_tag_rct1: cadence 1 repeat count = 0
00:09:07: cmapp_process_tag_rct2: cadence 2 repeat count = 0
00:09:07: cmapp_process_tag_rct3: cadence 3 repeat count = 0
00:09:07: cmapp_process_tag_rct4: cadence 4 repeat count = 0
00:09:07:
cmapp_prefix_process_tag_dualtone: TID=[2:CPTONE_CONGESTION]
00:09:07: cmapp_process_tag_nf: number of frequencies = 1
00:09:07: cmapp_process_tag_dr: direction = 0
00:09:07: cmapp_process_tag_fof: frequency 1 = 400
00:09:07: cmapp_process_tag_fos: frequency 2 = 0
00:09:07: cmapp_process_tag_fot: frequency 3 = 0
00:09:07: cmapp_process_tag_fo4: frequency 4 = 0
00:09:07: cmapp_prefix_process_tag_aof_level:
00:09:07: cmapp_process_tag_fxs: amplitude of 1st = -200
00:09:07: cmapp_process_tag_fxo: amplitude of 1st = -200
00:09:07: cmapp_process_tag_digital: amplitude of 1st = -200
00:09:07: cmapp_prefix_process_tag_aos_level:
00:09:07: cmapp_process_tag_fxs: amplitude of 2nd = 0
00:09:07: cmapp_process_tag_fxo: amplitude of 2nd = 0
00:09:07: cmapp_process_tag_digital: amplitude of 2nd = 0
00:09:07: cmapp_prefix_process_tag_aot_level:
00:09:07: cmapp_process_tag_fxs: amplitude of 3rd = 0
00:09:07: cmapp_process_tag_fxo: amplitude of 3rd = 0
00:09:07: cmapp_process_tag_digital: amplitude of 3rd = 0
00:09:07: cmapp_prefix_process_tag_ao4_level:
00:09:07: cmapp_process_tag_fxs: amplitude of 4th = 0
The following sample output shows the network locales in the XML file:
Router# debug ccm-manager config-download tone
!
00:54:08: cmapp_xml_tftp_download_file line 170
File (tftp://10.10.10.55/Hong_Kong/gateway-tones.xml) read 20993 bytes
00:54:08: cmapp_prefix_process_tag_tones
00:54:08: cmapp_process_tag_trkLocaleName: region = Hong Kong
!
00:54:08: cmapp_xml_tftp_download_file line 170
File (tftp://10.10.10.55/United_Kingdom/gateway-tones.xml) read 20993 bytes
00:54:08: cmapp_prefix_process_tag_tones
00:54:08: cmapp_process_tag_trkLocaleName: region = United_Kingdom
Note For a description of the significant fields displayed in these output examples, see the Cisco IOS Voice
Command Reference and Cisco IOS Debug Command Reference, Release 12.3T.
Where to Go Next
• To configure conferencing, transcoding, and MTP support on a Cisco IOS gateway, see “Configuring
Enhanced Conferencing and Transcoding for Voice Gateway Routers” on page 65.
• To enable MGCP PRI backhaul support, see “Configuring MGCP PRI Backhaul and T1 CAS
Support for Cisco Unified CallManager” on page 111.
• To enable MGCP BRI backhaul support, see “Configuring MGCP-Controlled Backhaul of
BRI Signaling in Conjunction with Cisco Unified CallManager” on page 127.
Additional References
• “Cisco Unified CallManager and Cisco IOS Interoperability Features Roadmap” on
page 9—Describes how to access Cisco Feature Navigator; also lists and describes, by Cisco IOS
release, Cisco Unified CallManager and Cisco IOS interoperability features.
• “Overview of Cisco Unified CallManager and Cisco IOS Interoperability” on page 13—Describes
basics of underlying technology and lists related documents.
• “Enabling Single-Point Configuration for MGCP Gateways” section on page 44 in Configuring
MGCP Gateway Support for Cisco Unified CallManager—Describes how to configure MGCP
gateways by downloading XML configuration files.
• Using the Cisco IP Telephony Locale Installer—Describes how to install the Cisco IP Telephony
Locale Installer for Cisco Unified CallManager.
The MCID for Cisco IOS Voice Gateways feature supports the Malicious Call Identification (MCID)
supplementary service that enables Cisco Unified CallManager to identify the source of malicious calls.
Finding Support Information for Platforms and Cisco IOS Software Images
Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image
support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on
Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at
the login dialog box and follow the instructions that appear.
Note For more information about this and related Cisco IOS voice features, see the following:
• “Overview of Cisco Unified CallManager and Cisco IOS Interoperability” on page 13.
• Entire Cisco IOS Voice Configuration Library—including library preface and glossary, other feature
documents, and troubleshooting documentation—at
http://www.cisco.com/univercd/cc/td/doc/product/software/ios123/123cgcr/voice_c/vcl.htm.
Contents
• “Prerequisites for MCID for Cisco IOS Voice Gateways” on page 162
• “Restrictions for MCID for Cisco IOS Voice Gateways” on page 162
• “Information About MCID for Cisco IOS Voice Gateways” on page 163
• “How to Configure MCID for Cisco IOS Voice Gateways” on page 164
• “Configuration Examples for MCID for Cisco IOS Voice Gateways” on page 169
• “Where to Go Next” on page 173
• “Additional References” on page 173
– Receive MCID related response signals and information from the connected network using the
PRI protocol specified for the MCID service. Cisco Unified CallManager ignores the signals
and information.
• Not supported on the Access Gateway Module (AGM).
MCID
Malicious Call Identification (MCID) is a supplementary service that enables Cisco Unified
CallManager to identify the source of malicious calls. A user who receives a malicious call from another
network, typically the PSTN, can select a softkey on the IP phone which immediately notifies the system
administrator, flags the call detail record (CDR) for the Cisco Unified CallManager cluster, and notifies
the PSTN of the malicious nature of the call, allowing the offnet system to take action, such as notifying
legal authorities.
Figure 12 shows an example of the MCID call flow. After receiving an MCID request from an endpoint
device (victim), Cisco Unified CallManager sends an H.225 Facility message with the MCID
information element (IE) to the voice gateway. The gateway sends a Q.931 Facility message with the
MCID IE to the ISDN network (central office).
PSTN
Caller
IP LAN
V
H.225 Facility
103191
Victim message
MCID IE
A called party invokes MCID by pressing the appropriate softkey on the IP phone. A configurable timer
is available when awaiting a response after sending a Facility message to the PSTN. If a response is not
received within the specified time, the TCL IVR script is notified. Depending on how the script is
written, it could try to reinvoke MCID or perform some other action, for example, playing a message to
the user that the MCID attempt did not work.
SUMMARY STEPS
1. enable
2. configure terminal
3. interface serial slot/port:timeslot
4. isdn switch-type {primary-net5 | primary-ni2}
5. isdn incoming-voice {data | modem | voice}
6. isdn supp-service mcid
7. isdn t-activate msec
8. exit
DETAILED STEPS
Example:
Router# configure terminal
Example:
Router(config-if)# end
SUMMARY STEPS
1. enable
2. configure terminal
3. application
4. service mcid location
5. param mcid-release-timer seconds
6. param retry-count number
7. exit
8. dial-peer voice tag pots
9. service mcid
10. incoming called-number string
11. direct-inward-dial
12. port
13. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 application Enters application configuration mode.
Example:
Router(config)# application
Step 4 service mcid flash:app_mcid.2.0.0.40.tcl Specifies the name and location of the MCID script.
Example:
Router(config-app)# service mcid
flash:app_mcid.2.0.0.40.tcl
Step 5 param mcid-release-timer seconds (Optional) Number of seconds the script waits before
releasing both call legs after it receives a disconnect
message. Default is 60 seconds.
Example:
Router(config-app-param)# param
mcid-release-timer 30
Step 6 param retry-count number (Optional) Maximum number of times the called party can
trigger MCID if all previous attempts failed. Default is 0,
which means the user can invoke MCID as many times as
Example:
Router(config-app-param)# param retry-count 3
needed.
Step 7 exit Exits to global configuration mode.
Example:
Router(config-app-param)# exit
Example:
Router(config-dial-peer)# exit
SUMMARY STEPS
1. enable
2. configure terminal
3. call application voice mcid location
4. call application voice mcid mcid-release-timer seconds
5. dial-peer voice tag pots
6. application mcid
7. incoming called-number string
8. direct-inward-dial
9. port
10. exit
DETAILED STEPS
Example:
Router# configure terminal
Step 3 call application voice mcid location Specifies the name and location of the MCID script.
Example:
Router(config)# call application voice mcid
flash:app_mcid.2.0.0.40.tcl
Step 4 call application voice mcid mcid-release-timer (Optional) Number of seconds the script waits to release
seconds both call legs after it receives a disconnect message. Default
is 60 seconds.
Example:
Router(config)# call application voice mcid
mcid-release-timer 30
Step 5 dial-peer voice tag pots Configures incoming dial peer and enters dial-peer
configuration mode.
Example:
Router(config)# dial-peer voice 250 pots
Step 6 application mcid Configures the incoming dial peer to use the MCID
application.
Example:
Router(config-dial-peer)# application mcid
Step 7 incoming called-number string Configures the incoming called number for the MCID
application.
Example:
Router(config-dial-peer)# incoming
called-number 222....
Step 8 direct-inward-dial Configures direct-inward-dial (DID) for the MCID
application.
Example:
Router(config-dial-peer)# direct-inward-dial
Example:
Router(config-dial-peer)# exit
!
voice-card 0
!
!
!
application
service mcid flash:app_mcid.2.0.0.40.tcl
param mcid-release-timer 10
param retry-count 3
!
!
controller T1 0/2/0
framing esf
clock source internal
linecode b8zs
pri-group timeslots 1-24
!
controller T1 0/2/1
framing esf
linecode b8zs
!
!
interface FastEthernet0/0
ip address 9.1.0.102 255.255.0.0
duplex auto
speed auto
no keepalive
!
interface FastEthernet0/1
no ip address
shutdown
duplex auto
speed auto
!
interface Serial0/2/0:23
no ip address
isdn switch-type primary-net5
isdn incoming-voice voice
isdn supp-service mcid
isdn T-Activate 5000
no cdp enable
!
ip classless
!
ip http server
!
disable-eadi
!
!
control-plane
!
!
voice-port 0/2/0:23
!
ccm-manager music-on-hold
!
!
dial-peer voice 500 pots
service mcid
destination-pattern 111111....
incoming called-number 555555....
direct-inward-dial
port 0/2/0:23
prefix 111111
!
dial-peer voice 600 voip
destination-pattern 555555....
session target ipv4:9.1.0.2
incoming called-number 111111....
playout-delay minimum low
codec g711ulaw
no vad
!
!
line con 0
exec-timeout 0 0
line aux 0
line vty 0 4
login
!
end
speed auto
!
interface FastEthernet0/1
shutdown
duplex auto
speed auto
!
interface Serial3/0:23
no logging event link-status
isdn switch-type primary-net5
isdn incoming-voice voice
isdn supp-service mcid
no cdp enable
!
ip default-gateway 10.4.0.1
ip classless
ip route 0.0.0.0 0.0.0.0 FastEthernet0/0
!
ip http server
!
!
control-plane
!
!
call application voice mcid flash:app_mcid.2.0.0.40.tcl
call application voice mcid mcid-release-timer 10
!
voice-port 3/0:23
!
mgcp call-agent 10.4.175.2 service-type mgcp version 0.1
!
mgcp profile default
!
!
dial-peer voice 1 pots
application mcid
destination-pattern 2010
incoming called-number 2000
direct-inward-dial
port 3/0:23
forward-digits all
!
dial-peer voice 2 voip
destination-pattern 2000
session target ipv4:10.4.175.2
!
!
line con 0
line aux 0
line vty 0 4
login
!
end
Where to Go Next
• To configure conferencing, transcoding, and MTP support on a Cisco IOS gateway, see “Configuring
Enhanced Conferencing and Transcoding for Voice Gateway Routers” on page 65.
• To enable MGCP PRI backhaul support, see “Configuring MGCP PRI Backhaul and T1 CAS
Support for Cisco Unified CallManager” on page 111.
• To enable MGCP BRI backhaul support, see “Configuring MGCP-Controlled Backhaul of
BRI Signaling in Conjunction with Cisco Unified CallManager” on page 127.
Additional References
• “Cisco Unified CallManager and Cisco IOS Interoperability Features Roadmap” on
page 9—Describes how to access Cisco Feature Navigator; also lists and describes, by Cisco IOS
release, Cisco Unified CallManager and Cisco IOS interoperability features.
• “Malicious Call Identification” chapter in the Cisco Unified CallManager Features and Services
Guide—Describes how to configure MCID in Cisco Unified CallManager 4.0.
The RSVP Agent feature implements a Resource Reservation Protocol (RSVP) agent on Cisco IOS voice
gateways that support Cisco Unified CallManager 5.0.1. The RSVP agent enables Cisco Unified
CallManager to provide resource reservation for voice and video media to ensure QoS and call admission
control (CAC). Cisco Unified CallManager controls the RSVP agent through Skinny Client Control
Protocol (SCCP). This signaling is independent of the signaling protocol used for the call so SCCP, SIP,
H.323, and MGCP calls can all use the RSVP agent.
Benefits of this feature include the following:
• Improves flexibility and scalability of bandwidth management in a meshed network by
decentralizing call admission control
• Provides method of managing unpredictable bandwidth requirements of video media
• Enables RSVP across WAN for Cisco IP phones and other devices that do not support RSVP
Finding Support Information for Platforms and Cisco IOS Software Images
Use Cisco Feature Navigator to find information about platform support and Cisco IOS software image
support. Access Cisco Feature Navigator at http://www.cisco.com/go/fn. You must have an account on
Cisco.com. If you do not have an account or have forgotten your username or password, click Cancel at
the login dialog box and follow the instructions that appear.
Contents
• Prerequisites for RSVP Agent, page 176
• Restrictions for RSVP Agent, page 176
• Information About RSVP Agent, page 176
• How to Enable the RSVP Agent on the Voice Gateway, page 178
• Configuration Examples for RSVP Agent, page 184
• Additional References, page 187
• Additional References, page 187
RSVP Agent
Resource Reservation Protocol (RSVP) is the IP service that allows applications to request end-to-end
QoS guarantees from the network. Cisco VoIP applications use RSVP for call admission control, limiting
the accepted voice load on the IP network to guarantee the QoS levels of calls. In networks that include
both voice and video media, bandwidth requirements can vary considerably over any given time.
Cisco Unified CallManager ensures resource reservation for voice and video media by using RSVP.
The RSVP agent is a transcoding or MTP device on the Cisco IOS gateway that registers with
Cisco Unified CallManager as RSVP-capable. The RSVP agent is controlled by Cisco Unified
CallManager which communicates with the RSVP agent using SCCP.
Cisco Unified CallManager consults its policy configuration to determine if RSVP is required for a voice
or video call. If the configured QoS level for a call is optional or mandatory, and the RSVP agent is
enabled on the voice gateway, Cisco Unified CallManager inserts a pair of RSVP agents into the media
path to provide RSVP support. The RSVP agent on the Cisco IOS gateway creates the RSVP reservation
for the two endpoints and bridges the media connection so that resources are reserved for the media path,
providing QoS for the call.
Figure 13 shows where the RSVP agent fits in a Cisco Unified CallManager meshed network.
RSVP agent
V
IP IP IP
IP phones PC video
To support video calls, MTP and transcoding resources can process multiple streams in a single session,
including audio, video and data, one-way or two-way, using a pass-through mode. In pass-through mode,
a SCCP device processes streams using a pure software MTP, regardless of the type of stream, so it can
be used for any stream type. Video and data streams are processed using pass-through mode. Audio
streams can be processed with or without pass-through mode.
Note This document does not contain details about configuring Cisco Unified CallManager. See the
documentation and online help for Cisco Unified CallManager for configuration instructions.
SUMMARY STEPS
1. enable
2. configure terminal
3. dspfarm profile profile-identifier {mtp | transcode}
4. codec pass-through
5. maximum sessions number
or
maximum sessions {hardware | software} number
6. associate application sccp
7. rsvp
8. no shutdown
9. end
DETAILED STEPS
Example:
Router# configure terminal
Example:
Router(config-dspfarm-profile)# associate
application sccp
Step 7 rsvp Enables RSVP support in the DSP farm profile.
Example:
Router(config-dspfarm-profile)# rsvp
Step 8 no shutdown Enables the profile, allocates DSP farm resources, and
associates the application.
Example:
Router(config-dspfarm-profile)# no shutdown
Step 9 end Exits to privileged EXEC mode.
Example:
Router(config-dspfarm-profile)# end
What to Do Next
Assign the DSP-farm profile to the appropriate Cisco Unified CallManager group. See the “Associating
a DSP Farm Profile to a Cisco Unified CallManager Group” section on page 83.
SUMMARY STEPS
1. show running-config
2. show dspfarm profile profile-number
3. show sccp ccm group group-number
DETAILED STEPS
SUMMARY STEPS
1. show sccp
2. show sccp connections
3. show sccp connections details
4. show sccp connections rsvp
5. show ip rsvp installed
6. show sccp statistics
7. debug sccp all
8. debug call rsvp-sync [events | func-trace]
9. debug voip ccapi inout
DETAILED STEPS
…..
!
boot-start-marker
boot-end-marker
!
logging buffered 5000000 debugging
no logging console
enable password lab
!
no network-clock-participate slot 2
no network-clock-participate aim 0
no network-clock-participate aim 1
no aaa new-model
ip subnet-zero
ip cef
!
!
no ip domain lookup
no ftp-server write-enable
voice-card 2
dspfarm
dsp services dspfarm
!
!
!
interface Loopback0
ip address 192.168.26.1 255.255.255.255
max-reserved-bandwidth 100
ip rsvp bandwidth
!
interface FastEthernet0/0
ip address 192.168.20.1 255.255.255.0
max-reserved-bandwidth 100
duplex auto
speed auto
fair-queue 64 256 1000
ip rsvp bandwidth
!
interface Serial0/0
ip address 192.168.25.2 255.255.255.252
max-reserved-bandwidth 100
fair-queue 64 256 37
ip rsvp bandwidth
!
interface FastEthernet0/1
ip address 192.168.24.1 255.255.255.0
max-reserved-bandwidth 100
shutdown
duplex auto
speed auto
fair-queue 64 256 1000
ip rsvp bandwidth
!
interface Serial0/1
ip address 192.168.25.69 255.255.255.252
max-reserved-bandwidth 100
shutdown
fair-queue 64 256 37
ip rsvp bandwidth
!
router ospf 10
log-adjacency-changes
network 192.168.0.0 0.0.255.255 area 0
!
ip classless
ip http server
ip rsvp policy preempt
!
!
!
control-plane
!
!
!
voice-port 2/0/0
!
voice-port 2/0/1
!
!
sccp local FastEthernet0/0
sccp ccm 192.168.20.11 identifier 3 version 4.0
sccp ccm 192.168.20.13 identifier 2 version 5.1
sccp ccm 192.168.20.12 identifier 1 version 5.1
sccp
!
sccp ccm group 1
bind interface FastEthernet0/0
associate ccm 2 priority 3
associate ccm 1 priority 2
associate profile 10 register mtp_A1
associate profile 120 register xcoder_A2
associate profile 110 register mtp_A2
associate profile 20 register xcoder_A1
!
dspfarm profile 20 transcode
codec g711ulaw
codec gsmfr
codec pass-through
codec g711alaw
codec g729r8
codec g729ar8
codec g729br8
codec g729abr8
rsvp
maximum sessions 5
associate application SCCP
!
dspfarm profile 120 transcode
codec g729abr8
codec gsmfr
codec g711alaw
codec g711ulaw
codec g729r8
codec g729ar8
codec g729br8
codec pass-through
rsvp
maximum sessions 5
associate application SCCP
!
dspfarm profile 30 conference
codec g711ulaw
codec g711alaw
codec g729ar8
codec g729abr8
codec g729r8
codec g729br8
!
dspfarm profile 10 mtp
codec g711ulaw
codec pass-through
rsvp
maximum sessions hardware 2
maximum sessions software 10
associate application SCCP
!
dspfarm profile 110 mtp
codec pass-through
codec g711ulaw
rsvp
maximum sessions hardware 2
maximum sessions software 10
associate application SCCP
!
!
!
line con 0
exec-timeout 0 0
line aux 0
line vty 0 4
exec-timeout 0 0
no login
!
ntp clock-period 17175018
ntp server 192.168.20.12
end
Additional References
• Cisco Unified CallManager Administration Guide, Release 5.0(1)
• Cisco Unified CallManager System Guide, Release 5.0(1)
• Cisco Unified CallManager Features and Services Guide, Release 5.0(1)
description (DSP profile) command 82 isdn bind-L3 ccm-manager service mgcp command 132
dial-peer voice command 40, 168 isdn incoming-voice command 165
direct-inward-dial command 40, 167, 168 isdn supp-service mcid command 165
dspfarm command 93, 95 isdn switch-type basic-net3 command 132
dspfarm confbridge maximum sessions command 92, 95 isdn switch type command 165
dspfarm connection interval command 94 isdn switch-type command 115
dspfarm profile command 82, 179 isdn t-activate command 165
dspfarm rtp timeout command 94
DSP farms
K
allocation of resources 73
description 69 keepalive retries command 86
dspfarm transcoder maximum sessions command 93, 95 keepalive timeout command 86
dsp services dspfarm command 81, 92
L
E
linecode command 115
Enhanced Conferencing and Transcoding for Voice
Gateway Routers feature 65
M
Out-of-Band to In-Band DTMF Relay for Cisco IOS Voice show isdn status command 116, 132
Gateways feature 95 show media resource status command 89
show mgcp command 29
show mgcp endpoint command 134
P
show mgcp endpoints command 120
port command 40, 167, 169 show sccp ccm group command 87
pri-group timeslots command 115 show sccp command 89
show sccp connections command 89
show voice port command 42, 147, 153
Q
single-point configuration download, description 16
QSIG 122 supplementary services, description 16
QSIG Supplementary Features for Cisco IOS Voice switchback, description 17, 31
Gateways feature 122
switchback interval command 87
switchback method command 86