1. Cisco MGCP IP Phone Administrator Guide, Versions 6.x and 7.x
5. Monitoring Cisco MGCP IP Phones (Versions 6.x and 7.x)
Downloads: This chapterpdf (PDF - 214.0KB) The complete bookPDF (PDF - 881.0KB) | Feedback

Monitoring Cisco MGCP IP Phones

Table Of Contents

Monitoring Cisco MGCP IP Phones

How to Use the Command-Line Interface to Monitor Phones

Output Examples

How to Use the Phone Menus to Access Status Information

Viewing Status Messages

Viewing Network Statistics


Monitoring Cisco MGCP IP Phones


This chapter provides information on the following:

How to Use the Command-Line Interface to Monitor Phones

How to Use the Phone Menus to Access Status Information

How to Use the Command-Line Interface to Monitor Phones

You can use Telnet or a console to connect to your Cisco IP 7960G/7940G phone, and you can use the command-line interface (CLI) to debug or troubleshoot the phone. Table 5-1 shows the available CLI commands and their syntax.


NoteYou need the phone IP address to use the CLI in a Telnet session. To get the IP address, select Settings > Network Configuration > IP Address. The default Telnet password is "cisco."

You can conduct only two Telnet sessions at any time.

The phone cannot originate a Telnet session to another address.


Table 5-1 describes the available commands.

Table 5-1 CLI Commands 

Command
Purpose

MGCP Phone> clear {arp | ethernet | ip | malloc | mwi | tcp-stats}

Clears the following, depending on the keywords used:

arp—Address Resolution Protocol (ARP) cache.

ethernet—Network statistics.

ip—IP statistics.

malloc—Memory allocation.

mwi—Message-waiting indicator.

tcp-stats—TCP statistics.

MGCP Phone> debug {arp | console-stall | strlib | malloc | malloctable | sk-platform | flash | dsp | vcm | dtmf | task-socket | mgcpio | mgcp_parse | dns | config | sntp | sntp-packet}

Shows detailed debug output for the following, depending on the keywords used:

arp—ARP cache.

console-stall—Console-stall driver output mode.

strlib—String library.

malloc—Memory allocation.

malloctable—Memory allocation table. The table can be viewed with the show malloctable command.

sk-platform—The platform.

flash—Flash memory information.

dsp—Digital signal processor (DSP) accesses.

vcm—Voice Channel Manager (VCM), including tones, ringing, and volume.

dtmf—Dual-tone multifrequency (DTMF) relay.

task-socket—Socket task.

mgcpioMGCP input and output.

mgcp_parse—Detailed MGCP output; displays each MGCP message as it is parsed or built.

dns—DNS command-line interface (CLI) configuration; allows you to clear the cache and set servers.

config—Output for the config system command.

sntp—Simple Network Time Protocol (SNTP).

sntp-packet—Full SNTP packet data.

Note Do not use the debug all command because it can cause the phone to become inoperable. This command is for use only by Cisco TAC personnel.

Note To turn the debugging off, use the undebug command (works just as does the no debug command).

MGCP Phone> dns {-p | -c | -s ip-address | -b ip-address}

Manipulates the DNS system. Keywords and arguments are as follows:

-p—Prints the DNS cache table.

-c—Clears the DNS cache table.

-s ip-address—Sets the primary DNS server.

-b ip-address—Sets the first backup server.

MGCP Phone> erase protflash

Erases the protocol area of flash memory. Forces the phone to reset its IP stack and request its configuration files again. This command can be used only if the telnet_level parameter is set to allow privileged commands to be executed.

MGCP Phone> exit

Exits the Telnet or console session.

MGCP Phone> ping ip-address number packet-size timeout

Sends an Internet Control Message Protocol (ICMP) ping to a network address. Arguments are as follows:

ip-address—Dotted IP address or alphanumeric address (host name) to ping.

number—Number of pings to send; default is 5.

packet-size—Size of the packet, in bytes. Range is 1 to 1480. Default is 100.

timeout—Time, in seconds, to wait before a request times out. Default is 2.

MGCP Phone> reset

Resets the phone line. This command can be used only if the telnet_level parameter is set to allow privileged commands to be executed.

MGCP Phone> show {arp | debug | ethernet | ip | strpool | memorymap | dump | malloctable | stacks | status | abort_vector | flash | dspstate | rtp | tcp | network | config | mgcp_lists | personaldir | dialplan | timers}

Shows information about the MGCP IP phone, depending on the keywords used:

arp—Contents of the ARP cache.

debug—Which debug modes are activated.

ethernet—Network statistics.

ip—IP packet statistics.

strpool—String library pool of strings. This command can be used only if the telnet_level parameter is set to allow privileged commands to be executed.

show command keywords (continued)

memorymap—Memory mapping table, including free, used, and wasted blocks.

dump—Dump of the memory contents. This command can be used only if the telnet_level parameter is set to allow privileged commands to be executed.

malloctable—Memory allocation table.

stacks—Tasks and buffer lists.

status—Current phone status, including errors.

abort_vector—Address of the last recorded abort vector.

 

flash—Flash memory information.

dspstate—DSP status, including whether the DSP is ready, the audio mode, whether keepalive pending is turned on, and the ringer state.

rtp—Packet statistics for the RTP streams.

tcp—Status of TCP ports, including the state (listen or closed) and the port number.

 

network—Network information, such as phone platform, DHCP server, phone IP address and subnet mask, default gateway, address of the TFTP server, phone MAC address, domain name, and phone name.

config—Current flash configuration, including network information, phone label and password, SNTP server address, DST information, time and date format, and input and output port numbers.

mgcp_lists—Filter list and duplicate message list lengths.

personaldir—Current contents of the personal directory. This command can be used only if the telnet_level parameter is set to allow privileged commands to be executed.

dialplan—Phone dial plan.

timers—Current status of the platform timers.

MGCP Phone> test {open | close | key {k1 ... k12} | onhook | offhook | show | hide}

Accesses the remote call test interface, allowing you to control the phone from a remote site. You can use this command only if the telnet_level parameter is set to allow privileged commands to be executed. Keywords are as follows:

openEnables the use of the test functionality.

closeDisables the use of the test functionality.

key—Simulates key presses. The arguments k1 through k12 are as follows:

k1—voldn—Volume down

k2—volup—Volume up

k3—headset—Headset

k4—spkr—Speaker

k5—mute—Mute

k6—info—Info

k7—msgs—Messages

k8—serv—Services

k9—dir—Directories

k10—set—Settings

k11—navup—Navigate up

k12—navdn—Navigate down

The keys 0 through 9, #, and * may be entered in continuous strings to better express typical dialing strings. A typical command would be test key 23234.

onhookSimulates a handset on-hook event.

offhookSimulates a handset off-hook event.

showShows test feedback.

hideHides test feedback.

MGCP Phone> traceroute ip-address [ttl]

Initiates a traceroute session from the console or from a Telnet session. Traceroute shows the route that IP datagrams follow from the MGCP IP phone to the specified IP address. The arguments are as follows:

ip-addressThe dotted IP address or alphanumeric address (host name) of the host to which you are sending the traceroute.

ttl—(Optional) The time-to-live value or the number of routers (hops) through which the datagram can pass. The default value is 30.

MGCP Phone> tty {echo {on | off} | mon | timeout value | kill session | msg}

Controls the Telnet system. The arguments and keywords are as follows:

echo—Controls local echo.

on—Turns the echo on.

off—Turns the echo off.

mon—Sends all debug output to both the console and the Telnet sessions.

timeout value—Sets the Telnet session timeout period, in seconds. The value range is from 0 to 65535.

kill session—Tears down the Telnet session specified by the session argument.

msg—Sends a message to another terminal logged into the phone; for example, you can send a message telling everyone else that is logged in to log off.


Output Examples

Ethernet Statistics

The following sample output shows Ethernet statistics:

MGCP Phone> show ethernet

Ethernet Mib:
---------------------------------------------------
 ResErr 00000154, RcvCnt 00137436, RcvErr 00000000, DrpCnt 00001421
 BrdCst 00122041, TooLng 00000363, TxCnt  00012322, TxQCnt 00000000
 TxQue  00000000, TxQMax 00000000, TxXCol 00000000, TxFram 00012322

Overflow Counters...
 UDP 00000000, ICMP    00000000, NonIP 00000000, TCP 00000000
 CDP 00000000, Unknown 00000000, Arp   00000000

IP Statistics

The following sample output shows IP statistics:

MGCP Phone> show ip

IP Statistics:
---------------------------------------------------
 Received    01426183, RxDrops     00002181
 RxFrags     00000000, RxFragDrops 00000000, RxReassembled 00000000
 Transmitted 00011996, TxDrops     00000010, TxFragments   00000000

How to Use the Phone Menus to Access Status Information

There are several types of status information that you can access using the Settings button. The information that you can obtain can aid in system management. This section contains the following subsections:

Viewing Status Messages

Viewing Network Statistics

Viewing Status Messages

You can view status messages that you can use to diagnose network problems.

Procedure


Step 1 Select Settings > Status > Status Messages. The Status Messages menu displays.

Step 2 View information as needed.

Step 3 Select Exit.


Viewing Network Statistics

You can view statistical information about the phone and network performance.

Procedure


Step 1 Select Settings > Status > Network Statistics. The Network Statistics menu displays.

Step 2 View the following information as needed:

Rcv—Number of packets received by the phone, not through the switch.

Xmit—Number of packets sent by the phone, not through the switch.

REr—Number of packets received by the phone that contained errors.

BCast—Number of broadcast packets received by the phone.

Phone State Message—TCP messages indicating the state of the phone. Possible messages are as follows:

Phone Initialized—TCP connection has not gone down since the phone was powered on.

Phone Closed TCP—TCP connection was closed by the phone.

TCP Timeout—TCP connection was closed because of a retry timeout.

Error Code—Error messages that indicate unusual reasons for which the TCP connection was closed.

Elapsed Time—Length of time (in days, hours, minutes, and seconds) since the last power cycle.

Port 0 Full, 100—Indicates that the network is in a linked state and has autonegotiated a full-duplex 100-Mbps connection.

Port 0 Half, 100—Indicates that the network is in a linked state and has autonegotiated a half-duplex 100-Mbps connection.

Port 0 Full, 10—Indicates that the network is in a linked state and has autonegotiated a full-duplex 10-Mbps connection.

Port 0 Half, 10—Indicates that the network is in a linked state and has autonegotiated a half-duplex 10-Mbps connection.

Port 1 Full, 100—Indicates that the network is in a linked state and has autonegotiated a full-duplex 100-Mbps connection.

Port 1 Half, 100—Indicates that the network is in a linked state and has autonegotiated a half-duplex 100-Mbps connection.

Port 1 Full, 10—Indicates that the network is in a linked state and has autonegotiated a full-duplex 10-Mbps connection.

Port 1 Half, 10—Indicates that the network is in a linked state and has autonegotiated a half-duplex 10-Mbps connection.

ethernet—Indicates the status of the Ethernet connection.

Step 3 Select Exit.


Note To reset the values, power the phone off and on.