Guest

Cisco IOS Software Releases 12.2 T

Cisco 2600 and 3600 Routers MGCP Voice Gateway Interoperability with Cisco CallManager

Table Of Contents

Cisco 2600 and 3600 Routers MGCP Voice Gateway Interoperability with Cisco CallManager

Feature Overview

Supplementary Services

Cisco CallManager Redundancy

Cisco CallManager Switchback

Benefits

Restrictions

Related Features and Technologies

Related Documents

Supported Platforms

Supported Standards, MIBs, and RFCs

Prerequisites

Configuration Tasks

Configuring the Router's Ethernet Interface

Configuring MGCP Globally

Configuring MGCP to Control Cisco CallManager

Configuring Dial Peers and Voice Ports for MGCP

Troubleshooting Tips

Monitoring and Maintaining MGCP Support for the Cisco CallManager

Configuration Examples

Router's Ethernet Interface Configuration Example

MGCP Global Configuration Example

MGCP Control of Cisco CallManager Example

Dial Peers and Voice Ports Configuration Example

Display of Configuration Example

Command Reference

ccm-manager application

ccm-manager mgcp

ccm-manager redundant-host

ccm-manager switchback

debug ccm-manager

mgcp call-agent

show ccm-manager

Glossary


Cisco 2600 and 3600 Routers MGCP Voice Gateway Interoperability with Cisco CallManager


Document Update Alert


This document was originally produced for Cisco IOS Release 12.2(4)T. This feature has been updated in subsequent releases, and more recent documentation is available.

If you are using Cisco IOS Release 12.2(4)T or higher, refer to the following documentation in the Cisco CallManager and Cisco IOS Interoperability Configuration Guide, Cisco IOS Voice Configuration Library, Release 12.3:

Configuring Cisco MGCP Gateways to Interoperate with Cisco CallManager


Feature History

Release
Modification

12.1(3)T

This feature was introduced with Cisco CallManager Version 3.0 and the Cisco Voice Gateway 200 (VG200).

12.2(2)XA

Support was added for Cisco CallManager Version 3.0(8), and Cisco 2600 series and Cisco 3600 series routers.

12.2(4)T

This feature was integrated into Cisco IOS Release 12.2(4)T.


This document describes the additional functionality and platforms offered by the Cisco 2600 and 3600 Routers Media Gateway Control Protocol (MGCP) Voice Gateway Interoperability with Cisco CallManager feature in Cisco IOS Release 12.2(4)T.

This document includes the following sections:

Feature Overview

Supported Platforms

Supported Standards, MIBs, and RFCs

Prerequisites

Configuration Tasks

Monitoring and Maintaining MGCP Support for the Cisco CallManager

Configuration Examples

Command Reference

Glossary

Feature Overview

MGCP voice gateway interoperability with Cisco CallManager allows modular access routers to act as redundant failover MGCP gateways. You can enable IP telephony and Cisco CallManager solutions using Cisco 2600 and Cisco 3600 series routers as voice gateways. This allows you to use the Cisco 2600 and 3600 platforms already in your networks as MGCP gateways within an IP telephony architecture.

An MGCP gateway handles the translation between audio signals and the packet network. The gateways interact with a call agent (also called a Media Gateway Controller or MGC) that performs signal and call processing on gateway calls.

In the MGCP configurations that Cisco IOS supports, the gateway can be any of the following:

Cisco router

Access server

Cable modem

The call agent is either of the following:

A server from a third-party vendor

Cisco CallManager

With MGCP, gateways are defined as secondary devices under control of the call agent. MGCP uses endpoints and connections to construct a call. Endpoints are sources of or destinations for data, and can be physical or logical locations in a device. Connections can be point-to-point or multipoint. The call agent manages connections between endpoints and controls how gateways function. (See Figure 1.)

Figure 1 MGCP

An MGCP gateway derives most of the configuration it requires from the call agent. To configure an MGCP gateway, you simply identify the call agent associated with the gateway and identify the gateway to the call agent.

MGCP optionally supports multiple call agents, which can eliminate a potential single point of failure in the voice network.

The Cisco IOS CLI allows you to set up MGCP on the gateway and to identify the Cisco CallManager. Cisco CallManager assumes control over establishing and tearing down connections between IP endpoints on your network and endpoints connected through the Public Switched Telephone Network (PSTN).

MGCP uses User Datagram Protocol (UDP) for establishing audio connections over IP networks. However, MGCP also uses hairpinning to return a call to the PSTN when the packet network is not available.

Creating a call connection involves a series of signals and events that make up the connection process. The signals might include such indicators as the off-hook status, a ringing signal, or a signal to play an announcement. These events and signals are specific to the type of endpoint involved in the call.

MGCP groups these events and signals into packages. A trunk package, for example, is a group of events and signals relevant to a trunking gateway, and an announcement package is a group of events and signals for an announcement server.

In an MGCP-enabled gateway, the out-of-band dual tone multi-frequency (DTMF) package is loaded upon startup. Once the out-of-band DTMF capabilities are configured in the Cisco CallManager MGCP gateway user interface, the router sends symbols over the UDP control channel to represent any DTMF tones it receives. Cisco CallManager interprets these symbols and passes on the DTMF signals, out of band, to the signaling endpoint.

The Cisco 2600 and 3600 Routers MGCP Voice Gateway Interoperability with Cisco CallManager feature includes the following:

Supplementary Services

Cisco CallManager Redundancy

Cisco CallManager Switchback

When you are using MGCP with a Cisco 2600 series or 3600 series router, all configuration elements associated with dial-plans are controlled by Cisco CallManager and should not be configured in the Cisco 2600 series or 3600 series gateway for MGCP-managed endpoints.

Supplementary Services

Supplementary services includes call hold, call transfer when the line is busy or there is no answer, call forwarding, and three-party call conferencing to and from the PSTN or a private branch exchange (PBX).

Call hold is a function that places the handset into mute mode. Both the transmitter and receiver function are disengaged for a period of time until the hold button is pressed again to reconnect the parties.

Call transfer is a function that transfers a call to a third party through a pre-programmed button that performs the hookswitch and draw with what is called the 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.

Call forwarding is a function that allows you to forward calls dialed from the original location to a remote location within or across the network.

Three-party call conferencing is similar to the transfer function, but rather than transferring the call to a third party, the third party called is added to the call. The conference feature allows the three parties to converse without worrying about cutting each other off.

Cisco CallManager Redundancy

Enabling MGCP and Cisco CallManager on the gateways provides optional redundancy or failover functionality. If the gateways loses communication with the primary Cisco CallManager due to a failure, services are switched to a backup Cisco CallManager. This capability allows existing connections to be preserved during the switchover.

Redundancy requires that you have two or three Cisco CallManagers available on your network. You identify the primary Cisco CallManager with the mgcp call agent command. Up to two backup Cisco CallManagers are added with the ccm-manager redundant-host command. If you do not configure a backup Cisco CallManager, redundancy is off.

If the Cisco CallManager redundancy feature is configured and the primary Cisco CallManager becomes unavailable, the first backup Cisco CallManager takes control of the devices that were registered with the primary Cisco CallManager. If you specified a second backup Cisco CallManager, it takes control of the devices if both the primary and first backup Cisco CallManagers fail. When the primary Cisco CallManager is brought back to service, control reverts back to that CallManager. This fallback can occur immediately, after a configurable amount of time, or only when all connected sessions have been released.

Cisco CallManager Switchback

Switchback is the way that the gateways reestablish communication with the primary Cisco CallManager when it becomes available again. The switchback mode can be immediately, at a specified time after the last active call ends, or after a specified length of time to ensure greater stability in the voice network. During the switchback, existing connections are not torn down.

Benefits

Supplementary Services

The hold, transfer, forward, and conference supplementary services are software applications. Therefore, you only have to upgrade the software on the server platform rather than upgrade hardware.

Redundancy

Redundancy allows you to designate up to two backup Cisco CallManagers to handle call processing for the disabled primary Cisco CallManager.

Cisco CallManager Switchback

Switchback eliminates a potential single point of failure in the VoIP network. Switchback lets you use redundant Cisco CallManagers so that your MGCP voice gateways can continue to work if the primary Cisco CallManager fails.

Restrictions

Caller ID is supported on Foreign Exchange Station (FXS) interfaces, but not on Foreign Exchange Office (FXO) interfaces in Cisco CallManager MGCP networks.

Related Features and Technologies

Cisco CallManager

Voice over IP

Related Documents

Cisco CallManager Administration Guide, Version 3.0:

http://www.cisco.com/univercd/cc/td/doc/product/voice/c_callmg/3_0/index.htm

Cisco IOS Interface Command Reference, Release 12.2:

http://www.cisco.com/univercd/cc/td/doc/product/software/ios122/122cgcr/finter_r/index.htm

Cisco IOS IP Command Reference, Vol. 1 of 3: Addressing and Services, Release 12.2:

http://www.cisco.com/univercd/cc/td/doc/product/software/ios122/122cgcr/fipras_r/index.htm

Cisco IOS Voice, Video, and Fax Command Reference, Release 12.2:

http://www.cisco.com/univercd/cc/td/doc/product/software/ios122/122cgcr/fvvfax_r/index.htm

Cisco IOS Voice, Video, and Fax Configuration Guide, Release 12.2:

http://www.cisco.com/univercd/cc/td/doc/product/software/ios122/122cgcr/fvvfax_c/index.htm

MGCP CAS PBX AAL2 and PVC:

http://www.cisco.com/univercd/cc/td/doc/product/software/ios122/122newft/122t/122t2/ftmgcptk.htm

Release Notes for Cisco 2600 Series, IOS Release 12.2 XA:

http://www.cisco.com/univercd/cc/td/doc/product/software/ios122/122relnt/2600/rn2600xa.htm

Release Notes for Cisco 3600 Series, IOS Release 12.2 XA:

http://www.cisco.com/univercd/cc/td/doc/product/software/ios122/122relnt/3600/rn3600xa.htm

Supported Platforms

Cisco 2600 series multiservice platforms

Cisco 3600 series multiservice platforms

Supported Standards, MIBs, and RFCs

Standards

No new or modified standards are supported by this feature.

MIBs

No new or modified MIBs are supported by this feature.

To obtain lists of supported MIBs by platform and Cisco IOS release, and to download MIB modules, go to the Cisco MIB website on Cisco.com at the following URL:

http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml

RFCs

No new or modified RFCs are supported by this feature.

Prerequisites

A Cisco 2600 series or Cisco 3600 series router that is running Cisco IOS software Release 12.2(2)XA or later  and that supports MGCP

Cisco CallManager, Version 3.0(8)

1-port network module—A 2-channel voice network module (Cisco product number NM-1V)

2-port network module—A 4-channel voice network module (Cisco product number NM-2V)

2-port FXS card—A 2-channel analog FXS voice interface (Cisco product number VIC-2FXS)

2-port FXO card—A 2-channel analog FXO voice interface (Cisco product number VIC-2FXO)

Voice network modules convert telephone voice signals into a form that can be transmitted over an IP network. These modules have no connectors.

Voice interface cards (2-port analog FXS and FXO) are installed in the voice network modules to provide the connection to the telephone equipment or network. You can install one voice interface card in a 2-channel voice network module and two voice interface cards in a 4-channel module.

Configuration Tasks

See the following sections for configuration tasks for the Cisco 2600 and 3600 Routers MGCP Voice Gateway Interoperability with Cisco CallManager feature. Each task in the list is identified as either required or optional.

Configuring the Router's Ethernet Interface (required)

Configuring MGCP Globally (required)

Configuring MGCP to Control Cisco CallManager (required)

Configuring Dial Peers and Voice Ports for MGCP (required)

Configuring the Router's Ethernet Interface

To configure an IP address on the router's Ethernet interface, use the following commands, beginning in global configuration mode:

 
Command
Purpose

Step 1 

Router(config)# interface ethernet slot/port

Enters interface configuration mode so that you can configure the Ethernet interface.

slot—Number of the slot being configured. Refer to the appropriate hardware manual for slot and port information.

port—Number of the port being configured. Refer to the appropriate hardware manual for slot and port information.

Step 2 

Router(config-if)# ip address ipaddress subnetmask

Configures an IP address and subnet mask on the router's Ethernet interface.

Step 3 

Router(config-if)# no shut

Activates the Ethernet port.

Step 4 

Router(config-if)# exit

Exits interface configuration mode.

To display information about the Ethernet interface, enter the show interfaces ethernet command in EXEC mode. Example 1 illustrates a typical display that appears in response to this command.

Example 1 Output of the show interfaces ethernet Command

Router# show interfaces ethernet 4/2

Ethernet4/2 is up, line protocol is up
  Hardware is cxBus Ethernet, address is 0000.0c02.d0ce (bia 0000.0c02.d0ce)
  Internet address is 131.108.7.1, subnet mask is 255.255.255.0
  MTU 1500 bytes, BW 10000 Kbit, DLY 1000 usec, rely 255/255, load 1/255
  Encapsulation ARPA, loopback not set, keepalive set (10 sec)
  ARP type: ARPA, ARP Timeout 4:00:00
  Last input 0:00:00, output 0:00:09, output hang never
  Last clearing of "show interface" counters 0:56:40
  Output queue 0/40, 0 drops; input queue 0/75, 0 drops
  Five minute input rate 3000 bits/sec, 4 packets/sec
  Five minute output rate 0 bits/sec, 0 packets/sec
     4961 packets input, 715381 bytes, 0 no buffer
     Received 2014 broadcasts, 0 runts, 0 giants
     0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
     567 packets output, 224914 bytes, 0 underruns
     0 output errors, 168 collisions, 0 interface resets, 0 restarts
     0 babbles, 2 late collision, 7 deferred
     0 lost carrier, 0 no carrier
     0 output buffer failures, 0 output buffers swapped out

Table 1 describes the significant fields in this example.

Table 1 show interfaces ethernet Field Descriptions 

Field
Description

Ethernet ... is up

Ethernet ... is administratively down

Indicates whether the interface hardware is currently active and if it has been taken down by an administrator. "Disabled" indicates the router has received over 5000 errors in a keepalive interval, which is 10 seconds by default.

Line protocol is {up | down | administratively down}

Indicates whether the software processes that handle the line protocol consider the line usable or if it has been taken down by an administrator.

Hardware

Hardware type (for example, MCI Ethernet, SCI, cBus Ethernet) and address.

Internet address

Internet address followed by subnet mask.

MTU

Maximum transmission unit of the interface.

BW

Bandwidth of the interface in kilobits per second.

DLY

Delay of the interface in microseconds.

Rely

Reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability), calculated as an exponential average over 5 minutes.

Load

Load on the interface as a fraction of 255 (255/255 is completely saturated), calculated as an exponential average over 5 minutes.

Encapsulation

Encapsulation method assigned to the interface.

Loopback

Indicates whether loopback is set or not.

Keepalive

Indicates whether keepalives are set or not.

ARP type

Type of Address Resolution Protocol assigned.

Last input

Number of hours, minutes, and seconds since the last packet was successfully received by an interface and processed locally on the router. Useful for knowing when a dead interface failed. This field is not updated by fast-switched traffic.

Output

Number of hours, minutes, and seconds since the last packet was successfully transmitted by the interface. Useful for knowing when a dead interface failed.

Output hang

Number of hours, minutes, and seconds (or never) since the interface was last reset because of a transmission that took too long. When the number of hours in any of the "last" fields exceeds 24, the number of days and hours is printed. If that field overflows, asterisks are printed.

Last clearing

Time at which the counters that measure cumulative statistics (such as number of bytes transmitted and received) shown in this report were last reset to 0. Variables that might affect routing (for example, load and reliability) are not cleared when the counters are cleared.

In this field, *** indicates the elapsed time is too large to be displayed, and 0:00:00 indicates the counters were cleared more than 231 ms (and less than 232 ms ago).

Output queue, input queue, drops

Number of packets in output and input queues. Each number is followed by a slash, the maximum size of the queue, and the number of packets dropped because of a full queue.

Five minute input rate
Five minute output rate

Average number of bits and packets transmitted per second in the last 5 minutes. If the interface is not in promiscuous mode, it senses only network traffic it sends and receives (rather than all network traffic).

The 5-minute input and output rates should be used only as an approximation of traffic per second during a given 5-minute period. These rates are exponentially weighted averages with a time constant of 5 minutes. A period of four time constants must pass before the average is within 2 percent of the instantaneous rate of a uniform stream of traffic over that period.

Packets input

Total number of error-free packets received by the system.

Bytes

Total number of bytes, including data and MAC encapsulation, in the error-free packets received by the system.

No buffer

Number of received packets discarded because there was no buffer space in the main system. Compare with ignored count. Broadcast storms on Ethernets and bursts of noise on serial lines are often responsible for no input buffer events.

Received ... broadcasts

Total number of broadcast or multicast packets received by the interface.

Runts

Number of packets that are discarded because they are smaller than the minimum packet size of the medium. For instance, any Ethernet packet that is less than 64 bytes is considered a runt.

Giants

Number of packets that are discarded because they exceed the maximum packet size of the medium. For example, any Ethernet packet that is greater than 1518 bytes is considered a giant.

Input errors

Includes runts, giants, no buffer, CRC, frame, overrun, and ignored counts. Other input-related errors can also cause the input errors count to be increased, and some datagrams might have more than one error; therefore, this sum might not balance with the sum of enumerated input error counts.

CRC

Cyclic redundancy checksum generated by the originating LAN station or far-end device does not match the checksum calculated from the data received. On a LAN, this usually indicates noise or transmission problems on the LAN interface or the LAN bus itself. A high number of CRCs is usually the result of collisions or a station transmitting bad data.

Frame

Number of packets received incorrectly having a CRC error and a noninteger number of octets. On a LAN, this is usually the result of collisions or a malfunctioning Ethernet device.

Overrun

Number of times the receiver hardware was unable to hand received data to a hardware buffer because the input rate exceeded the receiver's ability to handle the data.

Ignored

Number of received packets ignored by the interface because the interface hardware ran low on internal buffers. These buffers are different from the system buffers mentioned previously in the buffer description. Broadcast storms and bursts of noise can cause the ignored count to be increased.

Abort

Number of packets whose receipt was aborted.

Packets output

Total number of messages transmitted by the system.

Bytes

Total number of bytes, including data and MAC encapsulation, transmitted by the system.

Underruns

Number of times that the transmitter has run faster than the router can handle. This might never be reported on some interfaces.

Output errors

Sum of all errors that prevented the final transmission of datagrams out of the interface being examined. This might not balance with the sum of the enumerated output errors because some datagrams might have more than one error, and others might have errors that do not fall into any of the specifically tabulated categories.

Collisions

Number of messages retransmitted because of an Ethernet collision. A retransmission of this type is usually the result of an overextended LAN (Ethernet or transceiver cable too long, more than two repeaters between stations, or too many cascaded multiport transceivers). A packet that collides is counted only once in output packets.

Interface resets

Number of times an interface has been completely reset. Such a reset can happen if packets queued for transmission were not sent within several seconds. On a serial line, this can be caused by a malfunctioning modem that is not supplying the transmit clock signal, or by a cable problem. If the system notices that the carrier detect line of a serial interface is up but the line protocol is down, it periodically resets the interface in an effort to restart it. Interface resets can also occur when an interface is looped back or shut down.

Restarts

Number of times a Type 2 Ethernet controller was restarted because of errors.

Babbles

The transmit jabber timer expired.

Late collision

Number of late collisions. Late collision happens when a collision occurs after the preamble is transmitted.

Deferred

Deferred indicates that the chip had to defer even though it was ready to transmit a frame because the carrier was asserted.

Lost carrier

Number of times the carrier was lost during transmission.

No carrier

Number of times the carrier was not present during transmission.

Output buffer failures

Number of failed buffers.

Output buffers swapped out

Number of buffers swapped out.


Configuring MGCP Globally

To configure MGCP globally, use the following commands in privileged EXEC mode:

 
Command
Purpose

Step 1 

Router(config)# hostname name 

Assigns a unique name to the router so that the Cisco CallManager can identify it. The default name is Router.

Step 2 

Router(config)# mgcp

Enables the MGCP protocol.

Step 3 

Router(config)# mgcp call-agent {ipaddr | hostname} [service-type type] [version version-number]

(Required) Specifies the primary Cisco CallManager's IP address or domain name, and the port gateway service type and version number.

ipaddr—Specifies the IP address of the Cisco CallManager.

hostname—Specifies the Cisco CallManager's host name in the format host.name.ext

service-type type—(Optional) Specifies the type of gateway control service supported by the Cisco CallManager. Valid values are mgcp or sgcp. For MGCP configurations, use mgcp.

version version-number—(Optional) Specifies the version of service-type. For mgcp, the only valid value is 0.1. For sgcp, valid values are 1.1 and 1.5.

Step 4 

Router(config)# mgcp dtmf-relay voip codec {all | low-bit-rate} mode {cisco| nse | out-of-band}

Selects the codec type and enables dual-tone multi-frequency (DTMF) relay.

voip—(required) Specifies Voice over IP calls.

codec—Specifies use of either a G.711 or a G.726 codec.

all—Specifies use of any codec.

low-bit-rate—Specifies any version of the G.729 low-bit-rate codecs.

cisco—Removes DTMF tone from the voice stream and sends FRF.11 with a special payload 121 for DTMF digits.

nse—Uses the NSE-based forwarding method.

out-of-band—Removes DTMF tone from the voice stream and does not send FRF.11.

To verify the MGCP global configuration, enter the show mgcp command in privileged EXEC mode. Example 2 illustrates a typical display that appears in response to this command.

Example 2 Output of the show mgcp Command

Router# show mgcp

GCP Admin State ACTIVE, Oper State ACTIVE - Cause Code NONE 
MGCP call-agent: 11.0.0.50 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 
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

Configuring MGCP to Control Cisco CallManager

To configure MGCP to control Cisco CallManager, use the following commands in global configuration mode:

 
Command
Purpose

Step 1 

Router(config)# ccm-manager MGCP

Enables support for Cisco CallManager within MGCP.

Step 2 

Router(config)# ccm-manager redundant-host {ip-address | DNS-name} [ip-address | DNS-name]

(Optional) Identifies up to two backup Cisco CallManagers.

ip-address—Internet protocol address of the backup Cisco CallManager.

DNS-name—Domain name system of the backup Cisco CallManager.

Step 3 

Router(config)# ccm-manager switchback {graceful | immediate | schedule-time hh:mmm | uptime -delay minutes}

(Optional) If you configured one or two backup Cisco CallManagers, you can enter this command to configure switchback mode. This determines when the primary Cisco CallManager is used if it becomes available again while a backup Cisco CallManager is being used. The default is graceful.

graceful—Completes all outstanding calls before returning the gateway to the control of the primary Cisco CallManager.

immediate—Returns the gateway to the control of the primary Cisco CallManager without delay, as soon as the network connection to the Cisco CallManager is reestablished.

schedule-time hh:mmm—Returns the gateway to the control of the primary Cisco Call Manager at the specified hour and minute, based on a 24-hour clock. If the specified time is earlier than the current time, the switchback will occur at the specified time on the following day.

uptime-delay minutes—Returns the gateway to the control of the primary Cisco Call Manager when the primary Cisco CallManager has run for a specified number of minutes after a network connection is reestablished to the primary CallManager. Permitted values are from 1 to 1440 (1 minute to 24 hours).

To verify the configuration, enter the show ccm-manager command in privileged EXEC mode. Example 3 illustrates a typical display that appears in response to this command.

Example 3 Output of the show ccm-manager Command

Router# show ccm-manager

c3660A#show ccm-manager
MGCP Domain Name: c3660A.cisco.com
Total number of host: 2
Priority        Status         Host
===================================================
Primary         Registered     10.0.0.201
First backup    Backup polling 10.0.0.50
Second backup   Undefined 

Current active Call Manager: 10.0.0.201
Current backup Call Manager: 10.0.0.50
Redundant link port:         2428
Failover Interval:           30 seconds
Keepalive Interval:          15 seconds
Last keepalive sent:         00:20:18 (elapsed time: 00:00:06)
Last MGCP traffic time:      00:20:18 (elapsed time: 00:00:06)
Last switchover time:        None
Switchback mode:             Not selected (Default:Graceful)

Example 2 describes the significant fields shown in the display.

Table 2 show ccm-manager Field Descriptions  

Field
Description

MGCP Domain Name (System)

System used in the Internet for translating names of network nodes into IP addresses.

Total number of host

Number of Cisco CallManagers.

Priority

Priority of the Cisco CallManagers. The order of priority is primary, first backup, and second backup.

Status

Current usage of the Cisco CallManager. Possible values are registered, idle, backup polling, and down.

Host

Host address of the Cisco CallManager.

Current active Call Manager

Active Cisco CallManager. Can be the primary, first backup, or second backup Cisco CallManager.

Current backup Call Manager

Backup Cisco CallManager currently being used. Empty when no backup is available.

Redundant link port

Port that the Cisco CallManager will use.

Failover Interval

Maximum amount of time that can elapse without the gateway receiving messages from the currently active Cisco Call Manager, or the gateway switches to the backup Cisco Call Manager.

Keepalive Interval

If the gateway hasn't received any messages from the currently active Cisco CallManager within the specified amount of time, the gateway sends a keepalive message to the Cisco CallManager to be sure that it is OK.

Last keepalive sent

Indicates when the last keepalive message was sent.

Last switchover time

Last time switchover occurred.

Switchback mode

Displays the switchback mode configuration that determines when the primary Cisco CallManager will be used if it becomes available again while a backup Cisco CallManager is being used.


Configuring Dial Peers and Voice Ports for MGCP

To configure dial peers and voice ports for MGCP, use the following commands, beginning in global configuration mode:

 
Command
Purpose

Step 1 

Router(config)# dial-peer voice number pots



Designates that the specified dial peer is a POTS dial peer using VoIP encapsulation.

Step 2 

Router(config-dial-peer)# application MGCPAPP

Enables MGCP on the dial peer.

Note In some Cisco IOS versions, the application MGCPAPP command is case-sensitive. Unless you know that your version is not case sensitive, always enter MGCPAPP in uppercase letters. You can check whether your version is case sensitive after configuring this command by looking at the output of the show running-configuration command.

Step 3 

Router(config-dial-peer)# port slot-number/subunit-number/port

Binds the MGCP application to the specified voice port.

Step 4 

Router(config-dial-peer)# exit

Exits dial-peer configuration mode.

Step 5 

Router(config)# voice-port slot/subunit/port


Enters voice port configuration mode. Valid values vary by router platform.

Step 6 

Router(config-voiceport)# no shut

Activates the voice port. If a voice port is not being used, shut the voice port down with the shutdown command.

Note The shutdown and no shutdown commands affect both ports on a voice interface card (VIC). It is only necessary to enter the command on one of the ports.

The router is now ready to communicate with the Cisco CallManager. It periodically sends out messages attempting to establish a connection. When the Cisco CallManager configuration is complete, the connection should automatically establish itself. You should not have to make any further changes on the router.

To display configuration information for dial peers, use the show dial-peer voice command in privileged EXEC mode or the show voice-port command in privileged EXEC mode. The commands are described briefly below.

Command
Purpose

Router# show dial-peer voice [number] [summary]

Displays the configuration for all Voice over IP (VoIP) and POTS dial peers configured for the router.

number—(Optional) A specific dial peer. This option displays configuration information for a single dial peer identified by the number argument. Valid entries are any integer that identifies a specific dial peer, from 1 to 32767.

summary—(Optional) Displays a summary of all voice dial peers.

Router# show voice port [slot/subunit/port | summary]

Note This command format is applicable only to Cisco 2600 and 3600 series routers that have analog voice ports.

(Optional) Displays configuration information for the analog voice port you specify with the slot/subunit/port designation.

slot—Specifies a router slot in which a voice network module (NM) is installed. Valid entries are router slot numbers for the particular platform.

subunit—Specifies a voice interface card (VIC) where the voice port is located. Valid entries are 0 and 1. (The VIC fits into the voice network module.)

port—Specifies an analog voice port number. Valid entries are 0 and 1.

summary—(Optional) Displays a summary of all voice ports.

Router# show voice port [slot/port:ds0-group | summary]

Note This command format is applicable only to Cisco 2600 and 3600 series routers that have digital voice ports (with T1 packet voice trunk network modules).

(Optional) Displays information for the digital voice port you specify with the slot/port:ds0-group designation.

slot—Specifies a router slot in which the packet voice trunk network module (NM) is installed. Valid entries are router slot numbers for the particular platform.

port—Specifies a T1 or E1 physical port in the voice WAN interface card (VWIC). Valid entries are 0 and 1. (One VWIC fits in an NM.)

ds0-group—Specifies a T1 or E1 logical port number. Valid entries are from 0 to 23 for T1 and from 0 to 30 for E1.

summary—(Optional) Displays a summary of all voice ports.


Example 4 illustrates a typical display that appears in response to the show dial-peer voice command for a VoIP dial peer.

Example 4 Output of the show dial-peer voice Command

Router# show dial-peer voice 1000

c3660A#show dial-peer voice 1000
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.

Table 3 describes the significant fields in this example.

Table 3 show dial-peer voice Field Descriptions 

Field
Description

destination-pattern

Destination pattern (telephone number) for this peer.

answer-address

Answer address configured for this dial peer.

group

Group number associated with this peer.

Admin state

Administrative state of this peer.

Operation state

Operational state of this peer.

incoming called-number

Indicates the incoming called number if it has been set by means of the incoming-called number command.

DTMF Relay

Indicates for this dial peer whether or not dual-tone multifrequency (DTMF) relay has been enabled, by using the dtmf-relay command.

huntstop

Indicates whether dial-peer hunting has been turned on, by means of the huntstop command, for this dial peer.

Permission

Configured permission level for this peer.

session-target

Session target of this peer.

Connect Time

Accumulated connect time to the peer since system startup for both incoming and outgoing calls. The value is given in hundredths of a second.

Charged Units

Total number of charged units applying to this peer since system startup. The value is given in hundredths of a second.

Failed Calls

Number of failed call attempts to this peer since system startup.

Accepted Calls

Number of calls accepted from this peer since system startup.

Refused Calls

Number of calls from this peer refused since system startup.

Last Disconnect Cause

Encoded network cause associated with the last call. This value is updated whenever a call is started or cleared and depends on the interface type and session protocol being used on this interface.

Last Disconnect Text

ASCII text describing the reason for the last call termination.

Last Setup Time

Value of the system up time when the last call to this peer was started.


Example 5 illustrates sample output from the show voice-ports command for an FXS analog voice port on a Cisco 3600 router.

Example 5 Output of the show voice ports Command

Router# show voice port 1/0/0

c3660A#show voice port 1/0/0 

Foreign Exchange Office 1/0/0 Slot is 1, Sub-unit is 0, Port is 0
Type of VoicePort is FXO
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

Analog Info Follows:
Currently processing none
Maintenance Mode Set to None (not in mtc mode)
Number of signaling protocol errors are 0
Impedance is set to 600r Ohm
Station name None, Station number None

Voice card specific Info Follows:
Signal Type is loopStart
Number Of Rings is set to 1
Supervisory Disconnect is inactive
Answer Supervision is inactive
Hook Status is On Hook
Ring Detect Status is inactive
Ring Ground Status is inactive
Tip Ground Status is inactive
Dial Type is dtmf
Digit Duration Timing is set to 100 ms
InterDigit Duration Timing is set to 100 ms
Pulse Rate Timing is set to 10 pulses/second
InterDigit Pulse Duration Timing is set to 750 ms
Percent Break of Pulse is 60 percent
GuardOut timer is 2000 ms

Table 4 describes the significant fields in this example.

Table 4 show voice ports Field Descriptions 

Field
Description

Slot

Slot used in the VIC for this port.

Sub-unit

Subunit used in the VIC for this port.

Port

Port number for this interface associated with the VIC.

Type of VoicePort

Type of voice port: FXO, FXS, or E&M.

Operation State

Operation state of the port.

Administrative State

Administrative state of the voice port.

Description

Description of the voice port.

Noise Regeneration

Whether or not background noise should be played to fill silent gaps if voice activity detection (VAD) is activated.

Non-Linear Processing

Whether or not nonlinear processing is enabled for this port.

Music on Hold Threshold

Configured Music-On-Hold Threshold value for this interface.

In Gain

Amount of gain inserted at the receiver side of the interface.

Out Attenuation

Amount of attenuation inserted at the transmit side of the interface.

Echo Cancellation

Whether or not echo cancellation is enabled for this port.

Echo Cancel Coverage

Echo cancel coverage for this port.

Connection Mode

Connection mode of the interface.

Connection Number

Full E.164 telephone number used to establish a connection with the trunk or private line, automatic ringdown (PLAR) mode.

Initial Time Out

Amount of time the system waits for an initial input digit from the caller.

Interdigit Time Out

Amount of time the system waits for a subsequent input digit from the caller.

Ringing Time Out

Ringing timeout duration.

Wait Release Time Out

The length of time a voice port stays in the call-failure state while the Cisco MC3810 multiservice concentrator sends a busy tone, a reorder tone, or an out-of-service tone to the port.

Companding Type

Companding standard used to convert between analog and digital signals in PCM systems.

Region Tone

Configured regional tone for this interface.

Analog Information Fields

Currently processing

Type of call currently being processed: none, voice, or fax.

Maintenance Mode

Maintenance mode of the voice port.

Number of signaling protocol errors

Number of signaling protocol errors.

Impedance

Configured terminating impedance for the E&M interface.

Voice Card Information Fields

Signal Type

Type of signaling for a voice port: loop-start, ground-start, wink-start, immediate, or delay-dial.

Hook Status

Hook status of the FXO/FXS interface.

Ring Ground Status

Ring ground indication.

Tip Ground Status

Tip ground indication.

Dial Type

Out-dialing type of the voice port.

Digit Duration Timing

DTMF digit duration, in milliseconds.

InterDigit Duration Timing

DTMF interdigit duration, in milliseconds.

Pulse Rate Timing

Pulse dialing rate, in pulses per second (pps).

InterDigit Pulse Duration Timing

Pulse dialing interdigit timing, in milliseconds.


Troubleshooting Tips

All dial plan-related configuration elements are controlled by the Cisco CallManager, and should not be configured in the MGCP gateway for MGCP-managed endpoints (any endpoint with an application mgcapp command in its dial-peer statement). You should not use the destination-pattern or session-target dial-peer configuration commands, nor the connection voice-port configuration command.

Monitoring and Maintaining MGCP Support for the Cisco CallManager

Command
Purpose

Router# debug ccm-manager [errors | packets | events]

Displays Cisco CallManager errors.

errors—Displays Cisco CallManager errors.

packets—Displays errors related to Cisco CallManager packets.

events—Displays errors related to Cisco CallManager events such as when the primary Cisco CallManager failed and control switched to the backup Cisco CallManager.

Router# show ccm-manager [hosts | redundancy]

Displays a list of Cisco CallManagers, as well as their status and availability.

hosts—Displays each configured Cisco CallManager, its operational status, and its host address.

redundancy—Displays failover mode and status information, including the redundant link port, the failover interval, keepalives, MGCP traffic time, switchover, and switchback.


Configuration Examples

This section provides the following configuration examples:

Router's Ethernet Interface Configuration Example

MGCP Global Configuration Example

MGCP Control of Cisco CallManager Example

Dial Peers and Voice Ports Configuration Example

Following the configuration examples there is a display of a current configuration. Go to Display of Configuration Example.

Router's Ethernet Interface Configuration Example

In the following example, there is a Cisco 3600 series router and one FastEthernet 10/100 port.

router(config)# interface fastethernet 0/0
router(config-if)# ip address 10.0.0.200 255.255.255.0
router(config-if)# no shut

MGCP Global Configuration Example

In the following example, the IP address for the Cisco CallManager is 10.0.0.201, the DTMF relay is enabled, and the router is communicating with a Cisco CallManager.

router(config)# hostname 3660A
3660A(config)# mgcp
3660A(config)# mgcp call-agent 10.0.0.201
3660A(config)# mgcp dtmf-relay voip codec all mode out-of-band 
3660A(config)# ccm-manager mgcp 

MGCP Control of Cisco CallManager Example

In the following example, the commands required to configure the gateway and redundancy are shown.

mgcp !Configures router to run MGCP 
mgcp call-agent 10.0.0.201 service-type mgcp version 0.1 ! Defines Primary CallManager
mgcp dtmf-relay voip codec all mode out-of-band !Voice over IP calls, no DTMF 

To configure redundancy, enter the following commands:

ccm-manager switchback graceful !After last call ends, use primary Cisco CallManager
ccm-manager redundant-host 10.0.0.50 !Defines redundant Cisco CallManager (first backup)
ccm-manager mgcp !Enables support for Cisco CallManager within MGCP

Dial Peers and Voice Ports Configuration Example

In the following example, voice port 0 is configured in voice interface card 1 with MGCP. There are two FXO ports, and two FXS ports. (Voice ports are always installed in slot 1 of the gateway, and slot and port numbering begins at 0.) The MGCP application is applied to a dial peer. The voice-port command specifies that the voice network module will be installed in router slot 1, the location of the VIC is 1, and the voice port is 0.

3660A(config)# dial-peer voice 1 pots
3660A(config)# application MGCPAPP
3660A(config)# port 1/0/0

/* FXO port */

3660A(config)# dial-peer voice 2 pots
3660A(config)# application MGCPAPP
3660A(config)# port 1/0/1

/* FXO port */

3660A(config)# dial-peer voice 3 pots