|
|
This feature module describes the implementation of Media Gateway Control Protocol (MGCP) for trunking gateways on the Cisco AS5300 and includes the following sections:
MGCP provides simple call control functionality in a Voice over IP (VoIP) environment where distributed call agent applications manage calls on trunking gateways.
This feature offers the following benefits:
MGCP supports PBXs using common channel signaling (CCS) but not channel associated signaling (CAS).
Voice over IP
Cisco Access Server 5300
Standards
This implementation of MGCP is based on the IETF MGCP draft version 0.1 dated November 9th, 1998.
MIBs
XGCP-MIB
For descriptions of supported MIBs and how to use MIBs, see the Cisco MIB web site on CCO at http://www.cisco.com/public/sw-center/netmgmt/cmtk/mibs.shtml.
RFCs
No new or modified RFCs are supported by this feature.
See the following sections for configuring MGCP. Each task in the list indicates if the task is optional or required:
To configure MGCP, follow these commands, beginning in global configuration mode:
| Command | Purpose | |
|---|---|---|
Step 1 | router# config t | Enter global configuration mode. |
Step2 | router(config)# mgcp | Start the MGCP daemon. |
Step3 | router(config)# mgcp request timeout timeout | Specify how long the gateway should wait for a response to a request. |
Step4 | router(config)# mgcp request retries count | Specify the number of times to retry sending the mgcp command. |
Step5 | router(config)# mgcp call-agent {ipaddr | hostname} [port]
| Configure the call agent's address. |
Step6 | router(config)# mgcp max-waiting-delay value | Configure the maximum waiting delay to be used in an RSIP message as restart instructions for the call agent. |
Step7 | router(config)# mgcp restart-delay value | Configure the restart delay value to be used in an RSIP message as graceful tear down instructions for the gateway connection. |
Step8 | router(config)# mgcp vad | Configure voice activity detection. |
Step9 | router(config)# mgcp package-capability {as-package |
dtmf-package | gm-package | rtp-package | trunk-package}
| Specify an MGCP package capability. |
Step10 | router(config)# mgcp default-package {as-package |
dtmf-package | gm-package | rtp-package | trunk-package}
| Configure the default package capability type. |
Step11 | router(config)# mgcp quality-threshold {hwm-jitter-buffer
value | hwm-latency value | hwm-packet-loss value |
lwm-jitter-buffer value | lwm-latency value |
lwm-packet-loss value}
| Configure the jitter buffer size, packet-loss threshold, and latency threshold. |
Step12 | router(config)# mgcp playout {adaptive init-value min-value
max-value} | {fixed init-value}
| Tune the jitter buffer packet size used for MGCP connections. |
Step13 | router(config)# mgcp codec type [packetization-period value] | Configure the default codec type. |
Step14 | router(config)# mgcp ip-tos {high-reliability |
high-throughput | low-cost | low-delay | precedence value}
| Enable the IP Type of Service for MGCP connections. |
Step15 | router(config)# controller t1 slot# | Use the controller configuration mode for the T1 controller in the specified slot. |
Step16 | router(config-controller)# framing type | Configure the framing type. |
Step17 | router(config-controller)# clock source type | Configure the clock source. |
Step18 | router(config-controller)# linecode type | Configure the line coding. |
Step19 | router(config-controller)# ds0-group n timeslots range type signaling-type service mgcp | Configure the DS0s to support MGCP. |
To verify your MGCP configuration and obtain MGCP statistics, use the following commands:
| Command | Purpose |
|---|---|
Router# show mgcp [all | errors | events | packets | parser] | Displays all active MGCP connections on the router. |
Router# debug mgcp [connection | endpoint | statistics] | Turns on debugging for the gateway. |
Use these commands at any time to monitor the MGCP configuration:
| Command | Purpose |
|---|---|
| Router# show mgcp [all | errors | events | packets | parser] | Displays all active MGCP connections on the router. |
| Router# clear mgcp statistics | Resets the MGCP statistical counters. |
version 12.0 no service pad service timestamps debug uptime service timestamps log uptime no service password-encryption !hostname mgcpgw-rsvp1
! ! ! !resource-pool disable
! ! ! ! !
ip subnet-zero ip host mickey 209.165.1.2 ip host dirt 209.165.200.254 ip domain-name mgcpgw.cisco.com ip name-server 209.165.0.1 ip name-server 209.165.0.65 ip name-server 209.165.1.100
!mgcp mgcp request timeout 3000 mgcp request retries 5 mgcp call-agent 209.165.167.3 8550 mgcp max-waiting-delay 3 mgcp restart-delay 10 mgcp vad mgcp package-capability gm-package mgcp package-capability dtmf-package mgcp package-capability trunk-package mgcp package-capability as-package mgcp default-package trunk-package cns event-service server mta receive maximum-recipients 0 ! ! controller T1 0
framing esf linecode b8zs ds0-group 0 timeslots 1-24 type none service mgcp ! controller T1 1 framing esf clock source line primary linecode b8zs ds0-group 0 timeslots 1-24 type none service mgcp ! controller T1 2 framing esf clock source line secondary 2 linecode b8zs ds0-group 0 timeslots 1-24 type none service mgcp ! controller T1 3 framing esf linecode b8zs ds0-group 0 timeslots 1-24 type none service mgcp
! ! voice-port 0:0 ! voice-port 1:0 ! voice-port 2:0 ! voice-port 3:0 ! ! ! ! interface Ethernet0ip address 209.165.200.1 255.255.0.0 no ip redirects no ip directed-broadcast no ip mroute-cache load-interval 30 hold-queue 4096 in hold-queue 4096 out ! interface FastEthernet0 no ip address no ip directed-broadcast no ip route-cache no ip mroute-cache shutdown duplex auto speed auto ! ip nat translation timeout never ip nat translation tcp-timeout never ip nat translation udp-timeout never ip nat translation finrst-timeout never ip nat translation syn-timeout never ip nat translation dns-timeout never ip nat translation icmp-timeout never ip classless ip route 0.0.0.0 0.0.0.0 209.165.200.1 ip route 209.165.0.0 255.0.0.0 Ethernet0 ip route 209.165.0.0 255.255.0.0 Ethernet0 ip route 209.165.0.0 255.0.0.0 Ethernet0 ip route 209.165.254.254 255.255.255.255 1.1.0.1 no ip http server ! ! ! ! line con 0 exec-timeout 0 0 transport input none line aux 0 line vty 0 4 login ! end
This section documents new or modified commands. All other commands used with this feature are documented in the Cisco IOS Release 12.1 command reference publications.
To reset the MGCP statistical counters, use the clear mgcp statistics EXEC command.
clear mgcp statisticsSyntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
EXEC
Command History
12.0(7)XR2, 12.1(1)T This command was introduced with the Cisco AS5300.
Release
Modification
Examples
AS5300GW# clear mgcp statistics
Related Commands
mgcp Starts the MGCP daemon.
Command
Description
To configure channelized T1 timeslots that enable a Cisco AS5300 modem to answer and send an analog call, use the ds0-group controller configuration command. To disable a DS0 configuration for one or more timeslots, use the no form of this command.
ds0-group channel-number timeslots range [type signaling-type | tone type | addr info] [service service-type]
Syntax Description
channel-number Specifies the DS0 group number, which can be between 0 and 23 for T1 interfaces, and from 0 to 30 for E1 interfaces. timeslots range Specifies the DS0 timeslot range of values from 1 to 24 for T1 interfaces, and from 1 to 31 for E1 interfaces. The default value configures 24 timeslots with the channel associated signal called E&M (Ear and Mouth), which is the default signal type. type signaling-type (Optional) Specifies the signaling type to be applied to the selected group. To use mgcp functionality, choose none. tone type (Optional) Specifies the tone type as dtmf or mf. This option is not available with signaling type none. addr info (Optional) Specifies the calling/called party numbers may be applied. This option is not available with signaling type none. service service-type (Optional) Specifies the type of service. The valid option is mgcp.
Defaults
No default behavior or values.
Command Modes
Controller CONFIG
Command History
11.2 This command was originally the cas-group command. 12.0(5)T This command was renamed. 12.0(7)XR2, 12.1(1)T The MGCP service type was added.
Release
Modification
Usage Guidelines
The ds0-group command replaces the existing cas-group command. Making the command generic allows flexibility and scalability. It is not restricted to CAS signaling nor channel bundling.
Be sure to specify mgcp as the service type parameter if you want to run MGCP.
Examples
AS5300(config-controller)# ds0-group 5 timeslots 1-4 type none service mgcp
Related Commands
cas-group Configures channelized T1 timeslots with robbed bit signaling.
Command
Description
To start and allocate resources for the MGCP daemon, use the mgcp global configuration command. To terminate all calls, release all allocated resources, and kill the MGCP daemon, use the no form of this command.
mgcp [port]
Syntax Description
port (Optional) Specifies a UDP port for the MGCP gateway. Valid values are 1025 through 65535.
Defaults
No default behavior or values.
Command Modes
Global CONFIG
Command History
12.0(7)XR2, 12.1(1)T This command was introduced for the Cisco AS5300.
Release
Modification
Usage Guidelines
Once you start the MGCP daemon with the mgcp command, you can suspend it (for example, for maintenance) by using the mgcp block-newcalls command. When you are ready to resume normal MGCP operations, use the no mgcp block-newcalls command. Use the no mgcp command only if you intend to kill all MGCP applications and protocols.
When the MGCP daemon is not active, all MGCP messages are ignored.
If you do not specify a port from the command line, MGCP will use UDP port 2427.
Examples
AS5300(config)# mgcp
Related Commands
Gracefully terminates all MGCP activity. Specifies the number of times to retry sending the mgcp command. Enables debugging on MGCP.
Command
Description
To block new calls while maintaining existing calls, use the mgcp block-newcalls global configuration command. To resume MGCP operation, use the no form of this command.
mgcp block-newcallsSyntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
Global CONFIG
Command History
12.0(7)XR2, 12.1(1)T This command was introduced for the Cisco AS5300.
Release
Modification
Usage Guidelines
This command is valid only if the mgcp command is enabled.
Once you issue this command, all requests for new connections (CreateConnection requests) are denied. All existing calls will be maintained until participants terminate them or you use the no mgcp command. When the last active call is terminated, the MGCP daemon will be terminated and all resources allocated to it will be released. The no mgcp block-newcalls command returns the router to normal MGCP operations.
Examples
AS5300(config)# mgcp block-newcalls
Related Commands
Starts and allocates resources for the MGCP daemon.
Command
Description
To configure the call agent's (media gateway controller) address, use the mgcp call-agent global configuration command. To unconfigure the call agent's address, use the no form of this command.
mgcp call-agent {ipaddr | hostname} [port]
Syntax Description
ipaddr | hostname Specifies the IP address or domain name of the call-agent. port (Optional) Specifies the port for the call-agent to use. Valid values are 1025 through 65535.
Defaults
No default behavior or values.
Command Modes
Global CONFIG
Command History
12.0(7)XR2, 12.1(1)T This command was introduced for the Cisco AS5300.
Release
Modification
Usage Guidelines
If you do not specify a UDP port from the command line, MGCP will use 2427 as the default call agent UDP port.
Examples
See the following examples to specify the call-agent (use any one of these formats):
AS5300(config)# mgcp call-agent 209.165.200.225 AS5300(config)# mgcp call-agent 209.165.200.225 5530 AS5300(config)# mgcp call-agent igloo AS5300(config)# mgcp call-agent igloo 2009
Related Commands
Gracefully terminates all MGCP activity. Specifies the number of times to retry sending the mgcp command.
Command
Description
To select the default codec type and its optional packetization period value, use the mgcp codec global configuration command. To set the parameters to their default values, use the no form of this command.
mgcp codec type [packetization-period value]
Syntax Description
type The types of codec supported. Valid codecs include G711alaw, G711ulaw, G723ar53, G723ar63, G723r53, G723r63, G729ar8, G729br8, G729r8 packetization-period value (Optional) This parameter is useful when the preferred compression algorithm and/or packetization period parameter is not provided by the Media Gateway Controller. The value range depends on the type of codec selected. For example, the range for G729r8 is 10 to 220 in increments of 10. For G711ulaw, the range is 10 to 20 in increments of 10. For G723ur53, the range is 30 to 330 in increments of 10.
Defaults
G711ulaw
Command Modes
Global CONFIG
Command History
12.0(7)XR2, 12.1(1)T This command was introduced for the Cisco AS5300.
Release
Modification
Examples
AS5300(config)# mgcp codec g711alaw AS5300(config)# mgcp codec g729r8 packetization-period 150
Related Commands
mgcp Starts the MGCP daemon.
Command
Description
To configure the default package capability type for the media gateway, use the mgcp default-package global configuration command.
This command does not support a no form. To change the default package, use the mgcpdefault-package command with a different, actively-supported package.
mgcp default-package {as-package | dtmf-package | gm-package | rtp-package | trunk-package}
Syntax Description
as-package Announcement server package dtmf-package DTMF package gm-package Generic media package rtp-package RTP package trunk-package Trunk package
Defaults
trunk-package
Command Modes
Global CONFIG
Command History
12.0(7)XR2, 12.1(1)T This command was introduced for the Cisco AS5300.
Release
Modification
Usage Guidelines
This command is helpful when the Media Gateway Controller does not provide the package capability to be used for the given connection.
When configuring the package-type parameter, make sure that the specified package is actively supported. Use the show mgcp command to verify active supported packages. If the package you want as the default does not appear in the display, use the mgcp package-capability command to add the package to the supported list.
If only one package is actively supported, it becomes the default package.
Examples
AS5300GW(config)# mgcp default-package as-package as-package type will be the new default package type.
Related Commands
Includes a specific MGCP package that is supported by the gateway. mgcp Starts the MGCP daemon.
Command
Description
To enable or disable the IP Type of Services (TOS) for MGCP-controlled connections, use the mgcpip-tos global configuration command. To set the parameters to their default values, use the no form of this command.
mgcp ip-tos {high-reliability | high-throughput | low-cost | low-delay | precedence value}
Syntax Description
high-reliability (Optional) Specifies high-reliability TOS. high-throughput (Optional) Specifies high-throughput TOS. low-cost (Optional) Specifies low-cost TOS. low-delay (Optional) Specifies low-delay TOS. precedence value (Optional) Specifies the value of the IP precedence bit. Valid values are from 0 to 7. The default IP precedence value is 3.
Defaults
Services disabled, IP precedence 3
Command Modes
Global CONFIG
Command History
12.0(7)XR2, 12.1(1)T This command was introduced for the Cisco AS5300.
Release
Modification
Usage Guidelines
Only one of the high-reliability, high-throughput, low-cost, or low-delay parameters can be enabled at any given time. Enabling one parameter disables any other that was active. This has no effect on the precedence parameter.
When you configure a new value for precedence, the old value is erased.
The no form of the mgcp ip-tos command disables the first four parameters and sets precedence back to 3.
Examples
In the following example, activating low-delay disables the other three parameters.
AS5300GW(config)# mgcp ip-tos high-rel AS5300GW(config)# mgcp ip-tos high-throughput AS5300GW(config)# mgcp ip-tos low-cost AS5300GW(config)# mgcp ip-tos low-delay AS5300GW(config)# mgcp ip-tos prec 4
Related Commands
mgcp Starts the MGCP daemon.
Command
Description
To specify the MGCP maximum waiting delay (MWD), use the mgcp max-waiting-delay global configuration command. To set this command to its default values, use the no form of this command.
mgcp max-waiting-delay value
Syntax Description
value The number of seconds to wait after restart. Valid range is 0 to 600000 milliseconds (600 seconds).
Defaults
3000 msecs
Command Modes
Global CONFIG
Command History
12.0(7)XR2, 12.1(1)T This command was introduced for the Cisco AS5300.
Release
Modification
Usage Guidelines
Use the maximum wait delay to send out an RSIP message to the call agent with the restart method. This command helps prevent traffic bottlenecks caused by MGCP gateways all trying to connect at the same time after a restart.
Examples
The following examples show the max-waiting-delay in msecs:
AS5300(config)# mgcp max-waiting-delay 600 AS5300(config)# mgcp max-waiting-delay 2500 AS5300(config)# mgcp max-waiting-delay 300000
Related Commands
mgcp Starts the MGCP daemon. mgcp restart-delay Configures the graceful tear down method sent in the RSIP message.
Command
Description
To specify an MGCP package capability for this gateway, use the mgcp package-capability global configuration command. To remove a specific MGCP package capability from the list of capabilities, use the no form of this command.
mgcp package-capability {as-package | dtmf-package | gm-package | rtp-package | trunk-package}
Syntax Description
as-package Announcement server package dtmf-package DTMF package gm-package Generic media package rtp-package RTP package trunk-package Trunk package
Defaults
None
Command Modes
Global CONFIG
Command History
12.0(7)XR2, 12.1(1)T This command was introduced for the Cisco AS5300.
Release
Modification
Usage Guidelines
Select packages supported by your call agent. Events specified in the MGCP messages from the Call Agent must belong to one of the supported packages. Otherwise, the connection requests are refused by the media gateway.
Use this command before specifying a default package with the mgcp default-package command. Specify at least one package to have a default.
Enter each package as a separate command.
Examples
AS5300(config)# mgcp package-capability trunk-package AS5300(config)# mgcp package-capability dtmf-package AS5300(config)# mgcp default-package trunk-package
Related Commands
Configures the default package capability type for the media gateway. mgcp Starts the MGCP daemon.
Command
Description
To tune the jitter buffer packet size attempted for MGCP-controlled connections, use the mgcp playout global configuration command. Use the no form of this command to restore the default value.
mgcp playout {adaptive init-value min-value max-value | fixed init-value}
Syntax Description
adaptive init-value min-value max-value Specifies a user-defined variable range (in milliseconds) for the jitter buffer packet size. The range for each value is 4 to 250. The default values are init-value 60, min-value 4, and max-value 200. Note that init-value must be between min-value and max-value. fixed init-value Specifies a fixed size (in milliseconds) for the jitter buffer packet size. Valid values are from 4 to 250.
Defaults
adaptive 60 4 200
No default for fixed.
Command Modes
Global CONFIG
Command History
12.0(7)XR2, 12.1(1)T This command was introduced for the Cisco AS5300.
Release
Modification
Examples
The following example illustrates a jitter buffer configuration with an initial playout of 100, a minimum buffer size of 50, and a maximum buffer size of 150:
AS5300GW(config)# mgcp playout adaptive 100 50 150
The following example illustrates setting the jitter buffer to a fixed playout of 120:
AS5300GW(config)# mgcp playout fixed 120
Related Commands
mgcp Starts the MGCP daemon.
Command
Description
To set the jitter buffer size threshold, packet-loss threshold, and latency threshold parameters, use the mgcp quality-threshold global configuration command. To restore the default parameter values, use the no form of this command.
mgcp quality-threshold {hwm-jitter-buffer value | hwm-latency value | hwm-packet-loss value | lwm-jitter-buffer value | lwm-latency value | lwm-packet-loss value}
Syntax Description
hwm-jitter-buffer value Specifies the high-water-mark jitter buffer size. Valid range is from 100 to 200, and the default value is 150. hwm-latency value Specifies the high-water-mark latency value. Valid range is from 250 to 400, and the default value is 300. hwm-packet-loss value Specifies the high-water-mark packet-loss value. Valid range is from 5000 to 25000, and the default value is 10000. lwm-jitter-buffer value Specifies the low-water-mark jitter buffer size. Valid range is from 4 to 60, and the default value is 30. lwm-latency value Specifies the low-water-mark latency value. Valid range is from 125 to 200, and the default value is 150. lwm-packet-loss value Specifies the low-water-mark packet-loss value. Valid range is from 1 to 3000, and the default value is 1000.
Defaults
The voice quality parameter defaults are (in milliseconds): hwm-jitter-buffer 150, hwm-latency 300, hwm-packet-loss 10000, lwm-jitter-buffer 30, lwm-latency 300, and lwm-packet-loss 1000.
Command Modes
Global CONFIG
Command History
12.0(7)XR2, 12.1(1)T This command was introduced for the Cisco AS5300. 11.3(3)T The default was changed to 100 milliseconds.
Release
Modification
Usage Guidelines
The jitter buffer (storage area containing an active call's voice packets that have been received from the network and are waiting to be decoded and played), packet loss (number of packets lost per 100000 packets for a given call), and latency (network delay in sending/receiving packets) parameters are directly related to the quality of voice calls. For good voice quality, the system should perform below the lwm values. As the values go higher, voice quality degrades. The system generates a report when the values go above the hwm levels. Set the hwm and lwm values sufficiently apart so that you receive reports on poor performance, but not so close together that you receive too much feedback.
Enter each parameter as a separate command.
The following examples show how the different parameters can be set to new values:
AS5300GW(config)# mgcp quality-thres hwm-jit 100 AS5300GW(config)# mgcp quality-thres hwm-lat 250 AS5300GW(config)# mgcp quality-thres hwm-pack 5000 AS5300GW(config)# mgcp quality-thres lwm-jit 50 AS5300GW(config)# mgcp quality-thres lwm-lat 200 AS5300GW(config)# mgcp quality-thres lwm-pack 20
Related Commands
mgcp playout Tunes the jitter buffer packet size. mgcp Starts the MGCP daemon.
Command
Description
To specify the number of times to retry sending the mgcp command, use the mgcp request retries global configuration command. To restore the default value, use the no form of this command.
mgcp request retries count
Syntax Description
count Specifies the number of times a Notify message is retransmitted to the Call Agent before the request is dropped. The valid range is 1 to 10.
Defaults
3 times
Command Modes
Global CONFIG
Command History
12.0(7)XR2, 12.1(1)T This command was introduced for the Cisco AS5300.
Release
Modification
Usage Guidelines
This command applies to a trunking gateway.
Examples
The following example shows that the system will try to send the mgcp command 10 times before dropping the request:
AS5300(config)# mgcp request retries 10
Related Commands
Specifies how long the system will wait for a reply to a request. mgcp Starts the MGCP daemon.
Command
Description
To specify how long the system waits for a response to a request, use the mgcp request timeout global configuration command. To restore the default value, use the no form of this command.
mgcp request timeout timeout
Syntax Description
timeout Specifies the number of milliseconds to wait for a response to a request. Valid range is 1 to 10,000 (10 seconds).
Defaults
500 milliseconds
Command Modes
Global CONFIG
Command History
12.0(7)XR2, 12.1(1)T This command was introduced for the Cisco AS5300.
Release
Modification
Examples
The following example shows that the system waits 40 milliseconds for a reply to a request:
AS5300(config)# mgcp request timeout 40
Related Commands
mgcp request retries Specifies the number of times to retry sending the mgcp command. mgcp Starts the MGCP daemon.
Command
Description
To select the delay value sent in the RSIP graceful tear down method, use the mgcp restart-delay global configuration command. To restore the default value, use the no form of this command.
mgcp restart-delay value
Syntax Description
value Specifies the restart delay value in seconds. Valid range is from 0 to 600.
Defaults
0 seconds
Command Modes
Global CONFIG
Command History
12.0(7)XR2, 12.1(1)T This command was introduced for the Cisco AS5300.
Release
Modification
Usage Guidelines
Use the restart value to send a restart in progress (RSIP) message indicating when the connection in the gateway will be torn down.
Examples
AS5300GW(config)# mgcp restart-delay 30
Related Commands
mgcp Starts the MGCP daemon. mgcp max-waiting-delay Specifies the MGCP maximum waiting delay (MWD) after a restart.
Command
Description
To set the default voice activity detection (VAD) parameter for MGCP, use the mgcp vad global configuration command. To disable the VAD parameter, use the no form of this command.
mgcp vadSyntax Description
This command has no arguments or keywords.
Defaults
Disabled
Command Modes
Global CONFIG
Command History
12.0(7)XR2, 12.1(1)T This command was introduced for the Cisco AS5300.
Release
Modification
Usage Guidelines
Use the MGCP voice activity detection (VAD) parameter to tell the MGCP gateway to turn silence suppression on or off.
Examples
AS5300GW(config)# mgcp vad
Related Commands
mgcp Starts the MGCP daemon.
Command
Description
To display MGCP configuration information, use the show mgcp EXEC command.
show mgcp [connection | endpoint | statistics]
Syntax Description
connection (Optional) Displays the active MGCP-controlled connections. endpoint (Optional) Displays the MGCP-controlled endpoints. statistics (Optional) Displays MGCP statistics.
Command Modes
EXEC
Command History
12.0(7)XR2, 12.1(1)T This command was introduced for the Cisco AS5300.
Release
Modification
Examples
AS5300# show mgcp MGCP Admin State ACTIVE, Oper State ACTIVE - Cause Code NONE MGCP call-agent: 1.14.167.3, mgcp block-newcalls enabled? FALSE MGCP request timeout 500, MGCP request retries 3 MGCP gateway port: 2427, MGCP maximum waiting delay 180 MGCP restart delay 180, MGCP vad DISABLED MGCP simple-sdp DISABLED, MGCP cisco fgdos DISABLED MGCP codec type G711ulaw, MGCP packetization period 20 MGCP JB threshold lwm 30, JB threshold hwm 150 MGCP LAT threshold lwm 150, LAT threshold hwm 300 MGCP PL threshold lwm 1000, PL threshold hwm 5000 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 precedence 0, MGCP default package: trunk-package MGCP supported packages: trunk-package as-package
MGCP Admin State...Oper State | The administrative and operational state of the MGCP daemon. The administrative state controls starting and stopping the application using the mgcp and mgcpblock-newcalls commands. The operational state controls normal MGCP operations. |
MGCP call-agent | The address of the call agent specified in the mgcp command. |
MGCP block-newcalls enabled | The state of the mgcp block-newcalls command. |
MGCP request timeout | The setting for the mgcp request timeout command. |
MGCP request retries | The setting for the mgcp request retries command. |
MGCP gateway port | The UDP port specification. |
MGCP maximum waiting delay | The setting for the mgcp max-waiting-delay command. |
MGCP restart delay | The setting for the mgcp restart-delay command. |
MGCP vad | The setting for the mgcp vad command. |
MGCP simple-sdp | For Cisco use only. |
MGCP cisco fgdos | For Cisco use only. |
MGCP codec type | The setting for the mgcp codec command. |
MGCP packetization period | The packetization period parameter setting for the mgcpcodec command. |
MGCP JB threshold lwm | The jitter buffer minimum threshold parameter setting for the mgcp quality-threshold command. |
JB threshold hwm | The jitter buffer maximum threshold parameter setting for the mgcp quality-threshold command. |
MGCP LAT threshold lwm | The latency minimum threshold parameter setting for the mgcp quality-threshold command. |
LAT threshold hwm | The latency maximum threshold parameter setting for the mgcp quality-threshold command. |
MGCP PL threshold lwm | The packet loss minimum threshold parameter setting for the mgcp quality-threshold command. |
PL threshold hwm | The packet loss maximum threshold parameter setting for the mgcp quality-threshold command. |
MGCP playout mode | The jitter buffer packet size type and size. |
MGCP IP ToS low delay | The low-delay parameter setting for the mgcp ip-tos command. |
MGCP IP ToS high throughput | The high-throughput parameter setting for the mgcp ip-tos command. |
MGCP IP ToS high reliability | The high-reliability parameter setting for the mgcp ip-tos command. |
MGCP IP ToS low cost | The low-cost parameter setting for the mgcp ip-tos command. |
MGCP IP precedence | The precedence parameter setting for the mgcp ip-tos command. |
MGCP default package | The default-package parameter setting for the mgcp default-package command. |
MGCP supported packages | The packages supported in this session. |
AS5300# show mgcp connection Endpoint Call_ID(C) Conn_ID(I) (P)ort (M)ode (S)tate (C)odec (E)vent[SIFL] (R)esult[EA] 1. S0/DS1-0/1 C=100,1,2 I=0x2 P=16730,16436 M=3 S=4 C=6 E=2,0,0,2 R=0,0 2. S0/DS1-0/2 C=100,3,4 I=0x3 P=16436,16730 M=3 S=4 C=6 E=0,0,0,0 R=0,0 Total number of active calls 2
Endpoint | The endpoint for each call shown in the digital endpoint naming convention of slot number (S0) and digital line (DS1-0) number (1). |
Call_ID(C) | The MGCP call ID sent by the call agent, the internal Call Control Application Programming Interface (CCAPI) call ID for this endpoint, and the peer call legs CCAPI call ID. (CCAPI is an API to provide call control facilities to applications.) |
Conn_ID(I) | The connection ID generated by the gateway and sent in the ACK message. |
(P)ort | The ports used for this connection. The first port is the local UDP port. The second port is the remote UDP port. |
(M)ode | The call mode, where: 0---indicates an invalid value for mode 1---indicates the gateway should only send packets 2---indicates the gateway should only receive packets 3---indicates the gateway can send and receive packets 4---indicates the gateway should neither send nor receive packets 5---indicates the gateway should place the circuit in loopback mode 6---indicates the gateway should place the circuit in test mode 7---indicates the gateway should use the circuit for network access for data 8---indicates the gateway should place the connection in network loopback mode 9---indicates the gateway should place the connection in network continuity test mode 10--- indicates the gateway should place the connection in conference mode All other values are used for internal debugging. |
(S)tate | The call state. The values are used for internal debugging purposes. |
(C)odec | The codec identifier. The values are used for internal debugging purposes. |
(E)vent [SIFL] | Used for internal debugging. |
(R)esult [EA] | Used for internal debugging. |
AS5300# show mgcp statistics
UDP pkts rx 3, tx 8
Unrecognized rx pkts 0, MGCP message parsing errors 0
Duplicate MGCP ack tx 0, Invalid versions count 0
CreateConn rx 2, successful 2, failed 0
DeleteConn rx 0, successful 0, failed 0
ModifyConn rx 1, successful 1, failed 0
DeleteConn tx 0, successful 0, failed 0
NotifyRequest rx 0, successful 0, failed 0
AuditConnection rx 0, successful 0, failed 0
AuditEndpoint rx 0, successful 0, failed 0
RestartInProgress tx 1, successful 1, failed 0
Notify tx 0, successful 0, failed 0
ACK tx 3, NACK tx 0
ACK rx 0, NACK rx 0
IP address based Call Agents statistics:
IP address 209.165.200.224, Total msg rx 3,
successful 3, failed 0
UDP pkts | The number of UDP packets received (rx) and transmitted (tx). |
Unrecognized rx pkts | The number of packets received that are of unknown type. |
MGCP message parsing errors | The number of MGCP message parsing errors. |
Duplicate MGCP ack tx | The number of duplicate MGCP ACK transmission messages. |
Invalid versions count | The number of invalid versions. |
CreateConn rx ... | The number of Create Connection messages received from the call agent by the media gateway. Messages received are classified as being successful or failed. |
DeleteConn rx ... | The number of Delete Connection messages received from the call agent by the media gateway. Messages received are classified as being successful or failed. |
ModifyConn rx ... | The number of Modify Connection messages received from the call agent by the media gateway. Messages received are classified as being successful or failed. |
DeleteConn tx ... | The number of Delete Connection messages sent by the call agent. Messages received are classified as being successful or failed. |
NotifyRequest rx ... | The number of Notify messages received by the call agent from the media gateway. Messages received are classified as being successful or failed. |
AuditConnection rx ... | The number of Audit Connection messages received from the call agent by the media gateway. Messages received are classified as being successful or failed. |
AuditEndpoint rx ... | The number of Audit Endpoint messages received from the call agent by the media gateway. Messages received are classified as being successful or failed. |
RestartInProgress tx ... | The number of Restart In Progress (RSIP) messages transmitted by the call agent. Messages received are classified as being successful or failed. |
Notify tx ... | The number of Notify messages transmitted by the call agent. Messages received are classified as being successful or failed. |
ACK tx ... | The number of acknowledgement messages transmitted by the call agent. |
NACK tx ... | The number of negative acknowledgement messages transmitted by the call agent. |
ACK rx ... | The number of acknowledgement messages received by the gateway. |
NACK rx ... | The number of negative acknowledgement messages received by the gateway. |
IP address | The IP address of the call agent. |
Total msg rx ... | The total number of messages received by the gateway. Messages received are classified as being successful or failed. |
The following example shows how endpoints are configured:
AS5300# show mgcp endpoint T1/0 ds0-group 0 timeslots 1-24 type none T1/1 ds0-group 0 timeslots 1-24 type none T1/2 ds0-group 0 timeslots 1-24 type none T1/3 ds0-group 0 timeslots 1-24 type none
Related Commands
mgcp Starts the MGCP daemon.
Command
Description
This section documents new or modified debug commands. All other commands used with this feature are documented in the Cisco IOS Release 12.0 command reference publications.
debug mgcpTo enable debug traces for errors, events, packets, and parser, use the debug mgcp privileged EXEC command. To disable debugging output, use the no form of this command.
debug mgcp [all | errors | events | packets | parser]
Syntax Description
all (Optional) Debugs errors, events, packets, and the parser for MGCP modules. errors (Optional) Debugs errors for MGCP modules. events (Optional) Debugs events for MGCP modules. packets (Optional) Debugs packets for MGCP modules. parser (Optional) Debugs the parser for MGCP modules.
Defaults
Debugging for DRiP packets is not enabled.
Command Modes
EXEC
Command History
12.0(7)XR2, 12.1(1)T This command was introduced for the Cisco AS5300.
Release
Modification
Examples
AS5300GW# debug mgcp parser Media Gateway Control Protocol parser debugging is on AS5300GW# no debug mgcp parser Media Gateway Control Protocol parser debugging is off
Related Commands
mgcp Starts the MGCP daemon.
Command
Description
API ---Application Programming Interface.
CA ---Call Agent.
CAS--- Channel Associated Signaling.
CCS ---Common Channel Signaling.
CCAPI ---Call Control API.
CLI--- Command-Line Interface.
Dial Plan ---A scheme, specified by the networking manager, for associating telephone dialing sequences with VoIP endpoints.
IOS ---Internetworking Operating System.
IP ---Internet Protocol.
ISDN ---Integrated Services Digital Network.
MG ---Media Gateway.
MGC ---Media Gateway Controller.
MGCP ---Media Gateway Control Protocol.
PRI ---Primary Rate Interface.
PSTN ---Public Switched Telephone Network.
QoS ---Quality of Service.
RSIP ---ReStart In Progress.
RTCP ---Real Time Control Protocol.
SGCP---Simple Gateway Control Protocol.
SNMP--- Simple Network Management Protocol.
UDP ---User Datagram Protocol.
VAD ---Voice Activity Detection.
VoIP--- Voice over Internet Protocol.
VTSP ---Voice Telephony Service Provider.
XGCP---Xternal Media Gateway Control Protocols, includes SGCP and MGCP.
![]()
![]()
![]()
![]()
![]()
![]()
![]()
Posted: Thu Mar 30 13:57:09 PST 2000
Copyright 1989 - 2000©Cisco Systems Inc.