|
|
This feature module describes the implementation of Media Gateway Control Protocol (MGCP) for trunking gateways on the AS5300. MGCP provides simple call control functionality in a Voice over IP (VoIP) environment. In this VoIP environment, distributed call agent applications manage calls on trunking gateways.
This feature enables inter-exchange carriers (IXCs) that do not have time division multiplexing (TDM) equipment to provide both long distance services to corporate customers and provide connectivity to local exchange carriers (LECs) and other IXCs that use TDM equipment. This feature also offers IXCs IP networks as an alternative to congested TDM networks.
This feature provides standard MGCP implementing. MGCP will support SNMP through the XGCP-MIB which provides network management for external media gateway control protocols.
This feature also supports TDM hairpinning. Hairpinning allows trunking gateways to route a call back to the public switched telephone network or private or PBX if the IP network is too busy to handle the call. Hairpinning also can be used to connect the public switched telephone network (PSTN) to the network access server (NAS).
MGCP supports PBXs using common channel signaling (CCS) but not channel associated signaling (CAS).
This implementation of MGCP is based on the IETF MGCP draft version 0.1 dated November 9th, 1998.
RFCs
No RFCs are supported by this feature.
See the following sections for configuration tasks for MGCP. Each task in the list indicates if it is optional or required:
To configure MGCP, perform the following tasks:
| Step | Command | Purpose | ||
|---|---|---|---|---|
| router# config t | Enter global configuration mode. | ||
| router(config)# mgcp | Start the MGCP daemon. | ||
| router(config)# mgcp request timeout | Specify how long gateway should wait for a response to a request. | ||
| router(config)# mgcp request retries | Specify number of times to retry sending the mgcp command. | ||
| router(config)# mgcp call-agent | Configure the call agent's address. | ||
| router(config)# mgcp max-waiting-delay | Configure the maximum waiting delay to be used in an RSIP message as restart instructions for the call agent. | ||
| router(config)# mgcp restart-delay | Configure the restart delay value to be used in an RSIP message as graceful tear down instructions for the gateway connection. | ||
| router(config)# mgcp vad | Configure voice activity detection. | ||
| router(config)# mgcp package-capability | Specify a MGCP package capability. | ||
| router(config)# mgcp default-package | Configure the default package capability type. | ||
| router(config)# mgcp quality-threshold | Configure the jitter buffer size, packet-loss threshold, and latency threshold. | ||
| router(config)# mgcp playout | Tune the jitter buffer packet size used for MGCP connections. | ||
| router(config)# mgcp codec | Configure the default CODEC type. | ||
| router(config)# mgcp ip-tos | Enable the IP Type of Service for MGCP connections. | ||
| router(config)# controller t1 slot# | Enter the controller configuration mode for the T1 controller in the specified slot. | ||
| router(config-controller)# framing type | Configure the framing type. | ||
| router(config-controller)# clock source type | Configure the clock source. | ||
| router(config-controller)# linecode type | Configure the line coding. | ||
| router(config-controller)# ds0-group n timeslots range type signaling type service service type | Configure the DS0s. |
To verify your MGCP configuration and obtain MGCP statistics, enter the following commands beginning in the global configuration mode:
| Step | Command | Purpose | ||
|---|---|---|---|---|
| router# show mgcp | Displays all active MGCP connections on the router. | ||
| router# debug mgcp | Turns on debugging for the gateway. |
AS5300# version 12.0 AS5300# no service pad AS5300# service timestamps debug uptime AS5300# service timestamps log uptime AS5300# no service password-encryption ! AS5300(config)# hostname mgcpgw-rsvp1 ! ! ! ! AS5300(config)# resource-pool disable ! ! ! ! ! AS5300(config-if)# ip subnet-zero AS5300(config-if)# ip host mickey 209.165.1.2 AS5300(config-if)# ip host dirt 209.165.200.254 AS5300(config-if)# ip domain-name mgcpgw.cisco.com AS5300(config-if)# ip name-server 209.165.0.1 AS5300(config-if)# ip name-server 209.165.0.65 AS5300(config-if)# ip name-server 209.165.1.100 ! AS5300(config)# mgcp AS5300(config)# mgcp request timeout 3000 AS5300(config)# mgcp request retries 5 AS5300(config)# mgcp call-agent 209.165.167.3 8550 AS5300(config)# mgcp max-waiting-delay 3 AS5300(config)# mgcp restart-delay 10 AS5300(config)# mgcp vad AS5300(config)# mgcp package-capability gm-package AS5300(config)# mgcp package-capability dtmf-package AS5300(config)# mgcp package-capability trunk-package AS5300(config)# mgcp package-capability as-package AS5300(config)# mgcp default-package trunk-package AS5300(config)# cns event-service server AS5300(config)# mta receive maximum-recipients 0 AS5300(config)# ! AS5300(config)# ! AS5300(config)# controller T1 0 AS5300(config-controller)# framing esf AS5300(config-controller)# linecode b8zs AS5300(config-controller)# ds0-group 0 timeslots 1-24 type none service mgcp ! AS5300(config-controller)# controller T1 1 AS5300(config-controller)# framing esf AS5300(config-controller)# clock source line primary AS5300(config-controller)# linecode b8zs AS5300(config-controller)# ds0-group 0 timeslots 1-24 type none service mgcp ! AS5300(config-controller)# controller T1 2 AS5300(config-controller)# framing esf AS5300(config-controller)# clock source line secondary 2 AS5300(config-controller)# linecode b8zs AS5300(config-controller)# ds0-group 0 timeslots 1-24 type none service mgcp ! AS5300(config-controller)# controller T1 3 AS5300(config-controller)# framing esf AS5300(config-controller)# linecode b8zs AS5300(config-controller)# ds0-group 0 timeslots 1-24 type none service mgcp ! ! AS5300(config)# voice-port 0:0 ! AS5300(config)# voice-port 1:0 ! AS5300(config)# voice-port 2:0 ! AS5300(config)# voice-port 3:0 ! ! ! ! AS5300(config)# interface Ethernet0 AS5300(config-if)# ip address 209.165.200.1 255.255.0.0 AS5300(config-if)# no ip redirects AS5300(config-if)# no ip directed-broadcast AS5300(config-if)# no ip mroute-cache AS5300(config-if)# load-interval 30 AS5300(config-if)# hold-queue 4096 in AS5300(config-if)# hold-queue 4096 out ! AS5300(config-if)# interface FastEthernet0 AS5300(config-if)# no ip address AS5300(config-if)# no ip directed-broadcast AS5300(config-if)# no ip route-cache AS5300(config-if)# no ip mroute-cache AS5300(config-if)# shutdown AS5300(config-if)# duplex auto AS5300(config-if)# speed auto ! AS5300(config-if)# ip nat translation timeout never AS5300(config-if)# ip nat translation tcp-timeout never AS5300(config-if)# ip nat translation udp-timeout never AS5300(config-if)# ip nat translation finrst-timeout never AS5300(config-if)# ip nat translation syn-timeout never AS5300(config-if)# ip nat translation dns-timeout never AS5300(config-if)# ip nat translation icmp-timeout never AS5300(config-if)# ip classless AS5300(config-if)# ip route 0.0.0.0 0.0.0.0 209.165.200.1 AS5300(config-if)# ip route 209.165.0.0 255.0.0.0 Ethernet0 AS5300(config-if)# ip route 209.165.0.0 255.255.0.0 Ethernet0 AS5300(config-if)# ip route 209.165.0.0 255.0.0.0 Ethernet0 AS5300(config-if)# ip route 209.165.254.254 255.255.255.255 1.1.0.1 AS5300(config-if)# no ip http server ! ! ! ! AS5300(config)# line con 0 AS5300(config)# exec-timeout 0 0 AS5300(config)# transport input none AS5300(config)# line aux 0 AS5300(config)# line vty 0 4 AS5300(config)# login ! AS5300(config)# end
This section documents new or modified commands. All other commands used with this feature are documented in the Cisco IOS Release 12.0 command reference publications.
In Cisco IOS Release 12.0(1)T or later releases, you can search and filter the output for show and more commands. This functionality is useful when you need to sort through large amounts of output, or if you want to exclude output that you do not need to see.
To use this functionality, enter a show or more command followed by the "pipe" character (|), one of the keywords begin, include, or exclude, and an expression that you want to search or filter on:
command | {begin | include | exclude} regular-expression
The following is an example of the show atm vc command in which you want the command output to begin with the first line where the expression "PeakRate" appears:
show atm vc | begin PeakRate
For more information on the search and filter functionality, refer to the Cisco IOS Release 12.0(1)T feature module CLI String Search.
To reset the MGCP statistical counters, enter the clear mgcp statistics EXEC command.
clear mgcp statisticsThis command has no arguments or keywords.
No default behavior or values.
EXEC
| Release | Modification |
|---|---|
12.0(7)XR2 | This command was introduced on the AS5300. |
AS5300GW# clear mgcp statistics
| Command | Description |
mgcp | Starts the MGCP daemon. |
To configure channelized T1 timeslots, which enables an AS5300 modem to answer and send an analog call, enter the ds0-group controller configuration command. To disable a DS0 configuration for one or more timeslots, enter the no form of this command.
ds0-group channel-number timeslots range [type signaling type | tone type | addr info] [service service type]
no ds0-group channel-number [timeslots range]
channel-number | Specifies the DS0 group number. The group number 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. |
tone type | (Optional) Specifies the tone type as dtmf or mf. |
addr info | (Optional) Specifies the calling/called party numbers may be applied. |
service service type | (Optional) Specifies the type of service. The valid option is mgcp. |
No default behavior or values.
Controller CONFIG
| Release | Modification |
|---|---|
11.2 | This command was originally the cas-group command. |
12.0(5)T | This command was renamed. |
12.0(7)XR2 | The MGCP service type was added. |
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.
AS5300(config-controller)# ds0-group 5 timeslots 1-4 null service mgcp
| Command | Description |
cas-group | Configures channelized T1 timeslots with robbed bit signaling. |
To start and allocate resources for the MGCP daemon, enter the mgcp global configuration command. To terminate all calls, release all allocated resources, and kill the MGCP daemon, enter the no form of this command.
mgcp [port]
port | (Optional) Specifies a UDP port for the MGCP gateway. |
No default behavior or values.
Global CONFIG
| Release | Modification |
|---|---|
12.0(7)XR2 | This command was introduced on the AS5300. |
Once you start the MGCP daemon with the mgcp command, you can suspend it (for example, for maintenance) using the mgcp block-newcalls command. When you are ready to resume normal MGCP operations, enter the no mgcp block-newcalls command. Only enter the no mgcp command 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.
AS5300(config)# mgcp
| Command | Description |
Gracefully terminates all MGCP activity. | |
Specifies the number of times to retry sending the mgcp command. | |
Enable debugging on MGCP. |
To block new calls while maintaining existing calls, enter the mgcp block-newcalls global configuration command. To resume MGCP operation, enter the no form of this command.
mgcp block-newcallsThis command has no arguments or keywords.
No default behavior or values.
Global CONFIG
| Release | Modification |
|---|---|
12.0(7)XR2 | This command was introduced on the AS5300. |
Once you issue this command, all requests for new connections (CreateConnection requests) are denied. All existing calls will be maintained until users terminate them or you enter 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.
The following example blocks any requests for new connections:
AS5300(config)# mgcp block-newcalls AS5300(config)#
| Command | Description |
Starts and allocates resources for the MGCP daemon. |
To configure the call agent's (media gateway controller) address, enter the mgcp call-agent global configuration command. To unconfigure the call agent's address, enter the no form of this command.
mgcp call-agent {ipaddr | hostname} [port]
ipaddr | hostname | Specifies the IP address or domain name of the call-agent. |
port | (Optional) Specifies the port for the call-agent to use. |
No default behavior or values.
Global CONFIG
| Release | Modification |
|---|---|
12.0(7)XR2 | This command was introduced on the AS5300. |
If you do not specify a UDP port from the command line, MGCP will use 2427 as the default call agent UDP port.
The following example specifies the IP address of the call-agent:
AS5300(config)# mgcp call-agent 209.165.200.225
| Command | Description |
Gracefully terminates all MGCP activity. | |
Specifies the number of times to retry sending the mgcp command. | |
Enable debugging on MGCP. |
To select the default codec type from the available list of codec types and to select it's option parameter packetization period value, enter the mgcp codec global configuration command. To set the parameters to their default values, enter the no form of this command.
mgcp codec type [packetization-period value]
codec type | The types of CODEC supported. Valid CODECs include G711alaw, G711ulaw, G723ar53, G723ar63, G723r53, G723r63, G729ar8, G729br8, G729r8 |
packetization-period value | (Optional) This parameter may be 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. |
G711ulaw CODEC
Global CONFIG
| Release | Modification |
|---|---|
12.0(7)XR2 | This command was introduced on the AS5300. |
AS5300GW(config)# mgcp codec g711alaw
| Command | Description |
mgcp | Starts the MGCP daemon. |
To configure the default package capability type for the media gateway, enter the mgcp default-package global configuration command. To set the package type parameter to its default, enter the no form of this command.
mgcp default-package package-type
package-type | Specifies the package type. Valid types are announcement server package (as-package), DTMF package (dtmf-package), generic media package (gm-package), RTP package (rtp-package), and trunk package (trunk-package). |
trunk-package
Global CONFIG
| Release | Modification |
|---|---|
12.0(7)XR2 | This command was introduced on the AS5300. |
This command is helpful when the Media Gateway Controller does not provide the package capability to be used for the given connection. When configuring this parameter, make sure that the specified package type is in the supported package capability list.
AS5300GW(config)# mgcp default-package as-package as-package type will be the new default package type.
| Command | Description |
Includes a specific MGCP package that is supported by the gateway. | |
mgcp | Starts the MGCP daemon. |
To enable or disable the IP Type of Services (TOS) for MGCP-controlled connections, enter the mgcp ip-tos global configuration command. To set the parameters to their default values, enter the no form of this command.
mgcp ip-tos [high-reliability] [high-throughput] [low-cost] [low-delay] [precedence value]
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. |
Services disabled, IP precedence 3
Global CONFIG
| Release | Modification |
|---|---|
12.0(7)XR2 | This command was introduced on the AS5300. |
You can set any one of the high-reliability, high-throughput, low-cost, or low-delay parameters at any given time. When you configure a new value for a parameter, the old value is erased.
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
| Command | Description |
mgcp | Starts the MGCP daemon. |
To specify the MGCP maximum waiting delay (MWD), enter the mgcp max-waiting-delay global configuration command. To set this command to its default values, enter the no form of this command.
mgcp max-waiting-delay value
value | The number of seconds to wait after restart. Valid range is 0 to 600 seconds. |
3 seconds
Global CONFIG
| Release | Modification |
|---|---|
12.0(7)XR2 | This command was introduced on the AS5300. |
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.
AS5300GW(config)# mgcp max-waiting-delay 600
| Command | Description |
mgcp | Starts the MGCP daemon. |
mgcp restart-delay | Configures the graceful tear down method sent in the RSIP message. |
To include a specific MGCP package capability from the list of capabilities supported by this gateway, enter the mgcp package-capability global configuration command. To remove a specific MGCP package capability from the list of capabilities enter the no form of this command.
mgcp package-capability [as-package] [dtmf-package] [gm-package] [rtp-package] [trunk-package]
mgcp package-capability ... | (Optional) Specifies the MGCP package capabilities. The package capability list includes, gm-package (Generic Media Package), dtmf-package (DTMF Package), trunk-package (Trunk Package), rtp-package (RTP Package), and as-package (Announcement Server Package). |
None
Global CONFIG
| Release | Modification |
|---|---|
12.0(7)XR2 | This command was introduced on the AS5300. |
Events specified in the MGCP messages from the Call Agent must belong to one of the supported packages. Otherwise, the connection request will be refused by the media gateway.
AS5300(config)# mgcp package-capability dtmf-package AS5300(config)# mgcp package-capability trunk-package AS5300(config)# mgcp package-capability as-package AS5300(config)# mgcp default-package trunk-package
| Command | Description |
Configures the default package capability type for the media gateway. | |
mgcp | Starts the MGCP daemon. |
To tune the jitter buffer packet size attempted for MGCP-controlled connections, enter the mgcp playout global configuration command. Enter the no form of this command to restore the default value.
mgcp playout {adaptive init-value min-value max-value} | {fixed init-value}
adaptive init-value min-value max-value | Specifies a user-defined variable range (in milliseconds) for the jitter buffer packet size. The default values are init value of 60, a minimum of 4, and a maximum of 250. |
fixed init-value | Specifies a fixed size (in milliseconds) for the jitter buffer packet size. Valid values are from 4 to 200. |
Adaptive
Global CONFIG
| Release | Modification |
|---|---|
12.0(7)XR2 | This command was introduced on the AS5300. |
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
| Command | Description |
mgcp | Starts the MGCP daemon. |
To set the jitter buffer size threshold, packet-loss threshold, and latency threshold parameters, enter the mgcp quality-threshold global configuration command. To restore the default parameter values, enter 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]
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. |
The voice quality parameter defaults are: hwm-jitter-buffer 150, hwm-latency 300, hwm-packet-loss 10000, lwm-jitter-buffer 30, lwm-latency 300, and lwm-packet-loss 1000.
Global CONFIG
| Release | Modification |
|---|---|
12.0(7)XR2 | This command was introduced on the AS5300. |
11.3(3)T | The default was changed to 100 milliseconds. |
The jitter buffer, packet loss, and latency parameters are directly related to the voice quality.
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-jitt 50 AS5300GW(config)# mgcp quality-thres lwm-lat 200 AS5300GW(config)# mgcp quality-thres lwm-pack 20
| Command | Description |
mgcp | Starts the MGCP daemon. |
To specify the number of times to retry sending the mgcp command, enter the mgcp request retries global configuration command.
mgcp request retries count
count | Specifies the number of times a Notify message is retransmitted to the Call agent before it is dropped. The valid range is 1 to 1000. |
3
Global CONFIG
| Release | Modification |
|---|---|
12.0(7)XR2 | This command was introduced on the AS5300. |
This command applies to a trunking gateway.
The following example specifies that the system will try to send the mgcp command 10 times before dropping the request:
AS5300(config)# mgcp request retries 10 AS5300(config)#
| Command | Description |
Specifies how long the system will wait for a reply to a request. |
To specify how long the system should wait for a response to a request, enter the mgcp request timeout global configuration command.
mgcp request timeout timeout
timeout | Specifies the number of milliseconds to wait for a response to a request. Valid range is 1 to 100,000. |
500 milliseconds
Global CONFIG
| Release | Modification |
|---|---|
12.0(7)XR2 | This command was introduced on the AS5300. |
The following example specifies that the system waits 40 milliseconds for a reply to a request:
AS5300(config)# mgcp request timeout 40 AS5300(config)#
| Command | Description |
mgcp | Starts the MGCP daemon. |
To select the delay value sent in the RSIP graceful tear down method, enter the mgcp restart-delay global configuration command. To restore the default value, enter the no form of this command.
mgcp restart-delay value
value | Specifies the restart delay value in seconds. Valid range is from 1 to 600. |
0
Global CONFIG
| Release | Modification |
|---|---|
12.0(7)XR2 | This command was introduced on the AS5300. |
Use the restart value to send a restart in progress (RSIP) message indicating when the connection in the gateway will be torn down.
AS5300GW(config)# mgcp restart-delay 30
| Command | Description |
mgcp | Starts the MGCP daemon. |
mgcp max-waiting-delay | Specifies the MGCP maximum waiting delay (MWD) after a restart. |
To set the default voice activity detection parameter for MGCP, enter the mgcp vad global configuration command. To disable the VAD parameter, enter the no form of this command.
mgcp vadThis command has no arguments or keywords.
Disabled
Global CONFIG
| Release | Modification |
|---|---|
12.0(7)XR2 | This command was introduced on the AS5300. |
Use the MGCP voice activity detection (VAD) parameter to tell the MGCP gateway to turn silence suppression on or off.
AS5300GW(config)# mgcp vad
| Command | Description |
mgcp | Starts the MGCP daemon. |
To display MGCP configuration information, enter the show mgcp EXEC command.
show mgcp [connection | endpoint | statistics]
connection | Displays the active MGCP-controlled connections. |
endpoint | Displays the MGCP-controlled endpoints. |
statistics | Displays MGCP statistics. |
EXEC
| Release | Modification |
|---|---|
12.0(7)XR2 | This command was introduced on the AS5300. |
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 codec type , MGCP packetization period 20 MGCP JB threshold low water mark 30, JB threshold high water mark 150 MGCP LAT threshold low water mark 150, LAT threshold high water mark 300 MGCP PL threshold low water mark 1000, PL threshold high water mark 5000 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 type trunk-package Supported MGCP packages: trunk-package
MGCP Admin State... | The administrative and operational state of the MGCP daemon. The administrative state controls starting and stopping the application using the mgcp and mgcp block-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 codec type | The setting for the mgcp codec command. |
MGCP packetization period | The packetization period parameter setting for the mgcp codec command. |
MGCP JB threshold low water mark | The jitter buffer minimum threshold parameter setting for the mgcp quality-threshold command. |
JB threshold high water mark | The jitter buffer maximum threshold parameter setting for the mgcp quality-threshold command. |
MGCP LAT threshold low water mark | The latency minimum threshold parameter setting for the mgcp quality-threshold command. |
LAT threshold high water mark | The latency maximum threshold parameter setting for the mgcp quality-threshold command. |
MGCP PL threshold low water mark | The packet loss minimum threshold parameter setting for the mgcp quality-threshold command. |
PL threshold high water mark | The packet loss minimum threshold parameter setting for the mgcp quality-threshold command. |
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 type | The default-package parameter setting for the mgcp default-package command. |
Supported MGCP 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 send 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 ... | he 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
| Command | Description |
mgcp | Starts the MGCP daemon. |
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.
To enable debug traces for errors, events, packets, and parser, enter the debug mgcp privileged EXEC command. To disable debugging output, enter the no form of this command.
[no] debug mgcp [all | errors | events | packets | parser]
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. |
Debugging for DRiP packets is not enabled.
| Release | Modification |
|---|---|
12.0(7)XR2 | This command was introduced on the AS5300. |
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
| Command | Description |
mgcp | Starts the MGCP daemon. |
API Application Programming Interface.
Berlioz Code name for the MGCP Media Gateway Project.
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 eXternal media Gateway Control Protocols, includes SGCP and MGCP.
Posted: Wed Feb 16 09:38:36 PST 2000
Copyright 1989 - 2000©Cisco Systems Inc.