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.
Note
•
You 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
|
|
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. • mgcpio—MGCP 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: • open—Enables the use of the test functionality. • close—Disables 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. • onhook—Simulates a handset on-hook event. • offhook—Simulates a handset off-hook event. • show—Shows test feedback. • hide—Hides 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-address—The 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
---------------------------------------------------
ResErr 00000154, RcvCnt 00137436, RcvErr 00000000, DrpCnt 00001421
BrdCst 00122041, TooLng 00000363, TxCnt 00012322, TxQCnt 00000000
TxQue 00000000, TxQMax 00000000, TxXCol 00000000, TxFram 00012322
UDP 00000000, ICMP 00000000, NonIP 00000000, TCP 00000000
CDP 00000000, Unknown 00000000, Arp 00000000
IP Statistics
The following sample output shows 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.