cc/td/doc/product/voice/c_ipphon/english/ipp7960/addprot/sip/admin
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Troubleshooting
Using the Command-Line Interface (CLI)
Accessing Status Information

Troubleshooting


This chapter provides information on the following:

Using the Command-Line Interface (CLI)

You can use Telnet or a console to connect to your Cisco SIP IP phone and use the command-line interface (CLI) to debug or troubleshoot the phone. Table 4-1 shows the available CLI commands.

You will need the phone IP address to use the CLI in a Telnet session. To get the IP address of the phone, press Settings and select Network Configuration. You can then scroll down to IP Address and the address displays. The default Telnet password is "cisco."

Table 4-1   CLI Commands

Command  Purpose 
SIP Phone> clear {arp | ethernet | ip | malloc | tcp-stats}

Clears the following, depending on keywords used:

  • arp—Clears the Address Resolution Protocol (ARP) cache.
  • ethernetClears the network statistics.
  • ipClears the IP statistics.
  • malloc—Clears the memory allocation table.
  • tcp-statsClears the TCP statistics.
SIP Phone> debug {arp | console-stall | strlib | malloc | malloc-table | sk-platform | flash | dsp | vcm | dtmf | task-socket | lsm | fsm | auth | fim | gsm | cc | cc-msg | error | sip-task | sip-state | sip-messages | sip-reg-state | dns | config | sntp | sntp-packet | http | arp-broadcast | xml-events | xml-deck | xml-vars | xml-post}

Shows detailed debug output when used with the following keywords:

  • arp—Shows debug output for the ARP cache.
  • console-stall—Shows debug output for the console-stall driver output mode.
  • strlib—Shows debug output for the string library.
  • malloc—Shows debug output for memory allocation.
  • malloc-table—Enables the population of the memory allocation table. The table can be viewed with the show malloc-table command.
  • sk-platform—Shows debug output for the platform.
  • flash—Shows debug output for the Flash memory.
  • dspShows debug output for DSP accesses.
  • vcm—Shows debug output for the voice channel manager (VCM), including tones, ringing, and volume.
  • dtmf—Shows debug output for DTMF relay.
  • task-socket—Shows socket task debug output.
  • lsm—Shows debug output for the Line State Manager.
  • fsm—Shows debug output for the Feature State Manager.
  • auth—Shows debug output for the SIP authorization state machine.
  • fimShows debug output for the Feature Interaction Manager.
  • gsmShows debug output for the Global State Manager.
  • ccShows debug output for call control.
  • cc-msgShows debug output for the call control messages.

debug command keywords (continued)

  • errorShows general error debug output.
  • sip-taskShows debug output for the SIP task.
  • sip-stateShows debug output for the SIP state machine.
  • sip-messagesShows debug output for SIP messaging.
  • sip-reg-stateShows debug output for the SIP registration state machine.
  • dns—Shows the DNS command-line interface (CLI) configuration; allows you to clear the cache and set servers.
  • config—Shows output for the config system command.
  • sntp—Shows debug output for Simple Network Time Protocol (SNTP).
  • sntp-packet—Displays full SNTP packet data.
  • httpShows HTTP requests and responses.
  • arp-broadcastShows ARP broadcast messages.
  • xml-eventsShows XML events that are posted to the XML application chain.
  • xml-deckShows XML requests for XML cards and decks.
  • xml-varsShows XML content variables.
  • xml-post—Shows XML post strings.

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.

SIP Phone> dns

Manipulates the DNS system. The following arguments are used:

  • -p—Prints out the DNS cache table.
  • -c—Clears out the DNS cache table.
  • -s ip-addressSets the primary DNS server.
  • -b ip-addressSets the first backup server.
SIP 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.

SIP Phone> exit

Exits the Telnet or console session.

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

Sends an Internet Control Message Protocol (ICMP) ping to a network address. You can use a dotted IP address or an alphanumeric address. The number argument specifies how many pings to send; the default value is 5. The packetsize argument defines the size of the packet; you can send any size packet up to 1480 bytes and the default packet size is 100. The timeout argument is measured in seconds and identifies how long to wait before the request times out; the default is 2.

SIP Phone> register {option value | line value}

Instructs the Cisco SIP IP phone to register with the proxy server. The keywords and argument are as follows:

option value—Specifies each line as registered or not. Valid entries are 0 (unregistered) and 1 (registered).

line value—Registers the number of lines or specifies a backup proxy. The valid values are from 1 to 6 and backup. For example, if you input register 0 backup, the phone will register to the backup proxy.

SIP 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.

SIP Phone> show {arp | debug | ethernet | ip | strpool | memorymap | dump | malloctable | stacks | status | abort_vector | flash | dspstate | rtp | tcp | lsm | fsm | fsmdef | fsmcnf | fsmxfr | fim | gsm | register | network | config | personaldir | dialplan | timers}

Shows information about the SIP IP phone. The following keywords are used:

  • arpDisplays contents of the ARP cache.
  • debug—Shows which debug modes are activated.
  • ethernetShows the network statistics.
  • ipDisplays the IP packet statistics.
  • strpool—Shows the 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.
  • memorymap—Shows the memory mapping table, including free, used, and wasted blocks.
  • dump—Displays a 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—Shows the memory allocation table.
  • stacks—Shows tasks and buffer lists.
  • status—Shows the current phone status, including errors.
  • abort_vector—Shows the address of the last recorded abort vector.

show command keywords continued

  • flash—Shows Flash memory information.
  • dspstate—Shows the DSP status, including whether the DSP is ready, the audio mode, whether keepalive pending is turned on, and the ringer state.
  • rtpShows packet statistics for the RTP streams.
  • tcp—Shows the status of TCP ports, including the state (listen or closed) and the port number.
  • lsmShows the current status of the Line Manager control blocks.
  • fsmShows the current status of the Feature State function control blocks.
  • fsmdefShows the current status of the default Feature State Manager data control blocks.
  • fsmcnfShows the current status of the Conference Feature State Manager call control blocks.
  • fsmxfrShows the current status of the Transfer Feature State Manager transfer control blocks.
  • fimShows the current status of the Feature Interaction Manager control blocks (interface control blocks and state control blocks).
  • gsmTurns on debugging for vcm, lsm, fim, fsm, and gsm.

 

  • registerShows the current registration status of SIP lines.
  • network—Shows 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—Shows the 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.
  • personaldir—Displays the 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.
  • dialplanShows the phone dial plan.
  • timersShows the current status of the platform timers.
SIP Phone> test {open | close | key | onhook | offhook | show | hide}

Accesses the remote call test interface, allowing you to control the phone from a remote site. To use this feature, enter the test open command. To prevent use of this feature, enter the test close command. This command can be used only if the telnet_level parameter is set to allow privileged commands to be executed.

The following commands are available:

  • test key—When a test session is open, you can simulate key presses using the test key k1 k2 k3...k12 command, where k1 through k13 represent the following key names:
    • voldn—Volume down
    • volup—Volume up
    • headset—Headset
    • spkr—Speaker
    • mute—Mute
    • info—Info
    • msgs—Messages
    • serv—Services
    • dir—Directories
    • set—Settings
    • navup—Navigate up
    • 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 ky 23234.

  • test onhook—Simulates a handset onhook event.
  • test offhook—Simulates a handset offhook event.
  • test show—Shows test feedback.
  • test hide—Hides test feedback.
SIP 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.
  • mon—Sends all debug output to both the console and Telnet sessions.
  • timeout value—Sets the Telnet session timeout period based on the value. The value range is from 0 to 65535.
  • kill session—Tears down the Telnet session specified by the session argument.
  • msg—Send 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.

 

SIP 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 SIP 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.
  • ttlThe time-to-live value, or the number of routers (hops) through which the datagram can pass. The default value is 30.
SIP Phone> undebug {arp | console-stall | strlib | malloc | malloc-table | sk-platform | flash | vcm | dtmf | task-socket | lsm | fsm | auth | fim | gsm | cc | cc-msg | softkeys | error | sip-task | sip-state | sip-messages | sip-reg-state | dns | config | sntp | sntp-packet}

Turns off debugging.

Accessing Status Information

There are several types of status information that you can access via the settings key. The information that you can obtain via the settings key can aid in system management. To access status information, select settings and then select Status from the Settings menu. From the Status menu, the following three options are available:

In addition to the status messages available via the Setting Status menu, you can also obtain status messages for a current call.

Viewing Status Messages

To view status messages that you can use to diagnose network problems, perform the following steps:


Step 1   Press the Settings key. The Settings menu appears.

Step 2   Highlight Status.

Step 3   Press the Select soft key. The Setting Status menu appears.

Step 4   Highlight Status Messages.

Step 5   Press the Select soft key. The Status Messages panel appears.

Step 6   To exit the Status Messages panel, press the Exit soft key.



Viewing Network Statistics

To view statistical information about the phone and network performance, perform the following steps:


Step 1   Press the Settings key. The Settings menu appears.

Step 2   Highlight Status.

Step 3   Press the Select soft key. The Setting Status menu appears.

Step 4   Highlight Network Statistics.

Step 5   Press the Select soft key. The Network Statistics panel appears.

The following information is displayed on this panel:

Step 6   To exit the Network Statistics panel, press the Exit soft key.


Note   To reset the values displayed on the Network Statistics panel, power the phone off and on.


hometocprevnextglossaryfeedbacksearchhelp
Posted: Wed Nov 26 19:21:23 PST 2003
All contents are Copyright © 1992--2003 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.