Troubleshooting This chapter presents general troubleshooting information and a discussion of tools and techniques for troubleshooting serial connections. The chapter consists of the following sections: Troubleshooting Using the show interfaces serial Command Detailed Information on the show interfaces serial Command Using ping and Extended ping Tests Using traceroute and Extended traceroute tests Troubleshooting using the show interfaces serial Command The output of the show interfaces serial exec command displays information specific to serial interfaces. Figure 1-1 shows the output of the show interfaces serial exec command for a High-Level Data Link Control (HDLC) serial interface. This section describes how to use the show interfaces serial command to diagnose serial line connectivity problems in a wide-area network (WAN) environment. The following sections describe some of the important fields of the command output. Other fields shown in the display are described in detail in the section "Detailed Information on the show interfaces serial Command," later in this chapter. Serial Lines: show interfaces serial Status Line Conditions You can identify five possible problem states in the interface status line of the show interfaces serial display (see Figure 1-1): Serial x is down, line protocol is down Serial x is up, line protocol is down Serial x is up, line protocol is up (looped) Serial x is up, line protocol is down (disabled) Serial x is administratively down, line protocol is down Figure 1-1: Output of the HDLC show interface serial Command Table 1-1 shows the interface status conditions, possible problems associated with the conditions, and solutions to those problems. Table 15-1: Serial Lines: show interfaces serial Status Line Conditions Status Line Condition Possible Problem Solution Serial x is up, line protocol is up — This is the proper status line condition. No action is required. Serial x is down, line protocol is down (DTE1 mode) The router is not sensing a CD2 signal (that is, the CD is not active). A telephone company problem has occurred— line is down or is not connected to CSU3/DSU4. 1. Check the LEDs on the CSU/DSU to see whether the CD is active, or insert a breakout box on the line to check for the CD signal. 2. Verify that you are using the proper cable and interface (see your hardware installation documentation). Cabling is faulty or 3. Insert a breakout box and incorrect. check all control leads. Hardware failure has occurred (CSU/DSU). 4. Contact your leased-line or other carrier service to see whether there is a problem. 5. Swap faulty parts. 6. If you suspect faulty router hardware, change the serial line to another port. If the connection comes up, the previously connected interface has a problem. Serial x is up, line protocol is down (DTE mode) A local or remote router is misconfigured. Keepalives are not being sent by the remote router. A leased-line or other carrier service problem has occurred (noisy line or misconfigured or failed switch). A timing problem has occurred on the cable (SCTE5 not set on CSU/DSU). A local or remote CSU/DSU has failed. Router hardware (local or remote) has failed. 1. Put the modem, CSU, or DSU in local loopback mode and use the show interfaces serial command to determine whether the line protocol comes up. If the line protocol comes up, a telephone company problem or a failed remote router is the likely problem. 2. If the problem appears to be on the remote end, repeat Step 1 on the remote modem, CSU, or DSU. 3. Verify all cabling. Make certain that the cable is attached to the correct interface, the correct CSU/DSU, and the correct telephone company network termination point. Use the show controllers exec command to determine which cable is attached to which interface. 4. Enable the debug serial interface exec command.mmm ,,,, Serial x is up, line protocol is down (DTE mode) (continued) Caution: Because debugging output is assigned high priority in the CPU process, it can render the system unusable. For this reason, use debug commands only to troubleshoot specific problems or during troubleshooting sessions with Cisco technical support staff. Moreover, it is best to use debug commands during periods of lower network traffic and fewer users. Debugging during these periods decreases the likelihood that increased debug command processing overhead will affect system use. 5. If the line protocol does not come up in local loopback mode, and if the output of the debug serial interface exec command shows that the keepalive counter is not incrementing, a router hardware problem is likely. Swap router interface hardware. 6. If the line protocol comes up and the keepalive counter increments, the problem is not in the local router. Troubleshoot the serial line, as described in the sections "Troubleshooting Clocking Problems" and "CSU and DSU Loopback Tests," later in this chapter. 7. If you suspect faulty router hardware, change the serial line to an unused port. If the connection comes up, the previously connected interface has a problem. Serial x is up, line protocol is down (DCE6 mode) The clockrate interface configuration command is missing. 1. Add the clockrate interface configuration command on the serial interface. The DTE device does not support or is not set up for SCTE mode (terminal timing). Syntax: clock rate bps Syntax Description: The remote CSU or DSU has failed. Serial x is up, line protocol is down (DCE mode) (continued) The clockrate interface configuration command is missing. bps—Desired clock rate in bits per second: 1200, 2400, 4800, 9600, 19200, 38400, 56000, 64000, 72000, 125000, 148000, 250000, 500000, 800000, 1000000, 1300000, 2000000, 4000000, or 8000000. The DTE device does not support or is not set up for SCTE mode (terminal timing). 2. Set the DTE device to SCTE modem if possible. If your CSU/DSU does not support SCTE, you might have to disable SCTE on the Cisco router interface. Refer to the section "Inverting the Transmit Clock," later in this chapter. The remote CSU or DSU has failed. 3. Verify that the correct cable is being used. 4. If the line protocol is still down, there is a possible hardware failure or cabling problem. Insert a breakout box and observe leads. 5. Replace faulty parts, as necessary. Serial x is up, line protocol is up (looped) A loop exists in the circuit. The sequence number in the keepalive packet changes to a random number when a loop is initially detected. If the same random number is returned over 1. Use the show running-config privileged exec command to look for any loopback interface configuration command entries. 2. If you find a loopback interface configuration command entry, use the no loopback the link, a loop exists. interface configuration command to remove the loop. 3. If you do not find the loopback interface configuration command, examine the CSU/DSU to determine whether they are configured in manual loopback mode. If they are, disable manual loopback. 4. Reset the CSU or DSU, and inspect the line status. If the line protocol comes up, no other action is needed. 5. If the CSU or DSU is not configured in manual loopback mode, contact the leased-line or other carrier service for line troubleshooting assistance. Serial x is up, line protocol is down (disabled) A high error rate has occurred due to a telephone company service problem. 1. Troubleshoot the line with a serial analyzer and breakout box. Look for toggling CTS7 and DSR8 signals. A CSU or DSU hardware problem has occurred. 2. Loop CSU/DSU (DTE loop). If the problem continues, it is likely that there is a hardware problem. If the problem does not continue, it is likely that there is a telephone company problem. Router hardware (interface) is bad. 3. Swap out bad hardware, as required (CSU, DSU, switch, local or remote router). Serial x is administratively down, line protocol is down The router configuration includes the shutdown interface configuration command. A duplicate IP address 1. Check the router configuration for the shutdown command. 2. Use the no shutdown interface configuration command to remove the shutdown exists. command. 3. Verify that there are no identical IP addresses using the show running-config privileged exec command or the show interfaces exec command. 4. If there are duplicate addresses, resolve the conflict by changing one of the IP addresses. 1 DTE = data terminal equipment CD = carrier detect 3 CSU = channel service unit 4 DSU = digital service unit 5 SCTE = serial clock transmit external 6 DCE = data circuit-terminating equipment or data communications equipment 7 CTS = clear-to-send 8 DSR = data-set ready 2 Detailed Information on the show interfaces serial Command This section covers the show interfaces serial command's parameters, syntax description, sample output display, and field descriptions. show interfaces serial To display information about a serial interface, use the show interfaces serial privileged exec command: show interfaces serial [number] [accounting] Syntax Description Number—(Optional) Port number. accounting—(Optional) Displays the number of packets of each protocol type that have been sent through the interface. Sample Displays The following is sample output from the show interfaces command for a synchronous serial interface: Router# show interfaces serial Serial 0 is up, line protocol is up Hardware is MCI Serial Internet address is 150.136.190.203, subnet mask is 255.255.255.0 MTU 1500 bytes, BW 1544 Kbit, DLY 20000 usec, rely 255/255, load 1/255 Encapsulation HDLC, loopback not set, keepalive set (10 sec) Last input 0:00:07, output 0:00:00, output hang never Output queue 0/40, 0 drops; input queue 0/75, 0 drops Five minute input rate 0 bits/sec, 0 packets/sec Five minute output rate 0 bits/sec, 0 packets/sec 16263 packets input, 1347238 bytes, 0 no buffer Received 13983 broadcasts, 0 runts, 0 giants 2 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored, 2 abort 1 carrier transitions 22146 packets output, 2383680 bytes, 0 underruns 0 output errors, 0 collisions, 2 interface resets, 0 restarts Table 1-2 describes significant fields shown in the output. Table 15-9: Show Interfaces Serial Field Descriptions Field Description Serial...is {up | down}...is administratively down Indicates whether the interface hardware is currently active (whether carrier detect is present) or whether it has been taken down by an administrator. line protocol is {up | down} Indicates whether the software processes that handle the line protocol consider the line usable (that is, whether keepalives are successful), or whether it has been taken down by an administrator. Hardware is Specifies the hardware type. Internet address is Specifies the Internet address and subnet mask. MTU Specifies the maximum transmission unit of the interface. BW Indicates the value of the bandwidth parameter that has been configured for the interface (in kilobits per second). The bandwidth parameter is used to compute IGRP metrics only. If the interface is attached to a serial line with a line speed that does not match the default (1536 or 1544 for T1, and 56 for a standard synchronous serial line), use the bandwidth command to specify the correct line speed for this serial line. DLY Gives the delay of the interface in microseconds. rely Expresses reliability of the interface as a fraction of 255 (255/255 is 100 percent reliability), calculated as an exponential average over 5 minutes. load Expresses load on the interface as a fraction of 255 (255/255 is completely saturated), calculated as an exponential average over five minutes. Encapsulation Gives the encapsulation method assigned to the interface. loopback Indicates whether loopback is set. keepalive Indicates whether keepalives are set. Last input Gives the number of hours, minutes, and seconds since the last packet was successfully received by an interface. Useful for knowing when a dead interface failed. Last output Gives the number of hours, minutes, and seconds since the last packet was successfully transmitted by an interface. output hang Gives the number of hours, minutes, and seconds (or never) since the interface was last reset because of a transmission that took too long. When the number of hours in any of the last fields exceeds 24, the number of days and hours is printed. If that field overflows, asterisks are printed. Output queue, drops input queue, drops Gives the number of packets in output and input queues. Each number is followed by a slash, the maximum size of the queue, and the number of packets because the queue is full. 5 minute input rate 5 minute output rate Gives the average number of bits and packets transmitted per second in the past 5 minutes. The 5-minute input and output rates should be used only as an approximation of traffic per second during a given 5minute period. These rates are exponentially weighted averages with a time constant of 5 minutes. A period of four time constants must pass before the average will be within 2 percent of the instantaneous rate of a uniform stream of traffic over that period. packets input Gives the total number of error-free packets received by the system. bytes Gives the total number of bytes, including data and MAC encapsulation, in the error-free packets received by the system. no buffer Gives the number of received packets discarded because there was no buffer space in the main system. Compare with ignored count. Broadcast storms on Ethernet networks and bursts of noise on serial lines are often responsible for no input buffer events. Received...broadcasts Gives the total number of broadcast or multicast packets received by the interface. runts Gives the number of packets that are discarded because they are smaller than the medium's minimum packet size. Giants Gives the number of packets that are discarded because they exceed the medium's maximum packet size. input errors Gives the total number of no buffer, runts, giants, CRCs, frame, overrun, ignored, and abort counts. Other inputrelated errors can also increment the count, so this sum might not balance with the other counts. CRC The Cyclic Redundancy Check (CRC) counter is incremented by the originating station or far-end device when the checksum calculated from the data received does not match the checksum from the transmitted data. On a serial link, CRCs usually indicate noise, gain hits, or other transmission problems on the data link. frame Gives the number of packets received incorrectly, having a CRC error and a noninteger number of octets. On a serial line, this is usually the result of noise or other transmission problems. overrun Gives the number of times that the serial receiver hardware was incapable of handing received data to a hardware buffer because the input rate exceeded the receiver's capability to handle the data. ignored Gives the number of received packets ignored by the interface because the interface hardware ran low on internal buffers. Broadcast storms and bursts of noise can cause the ignored count to be increased. abort Indicates an illegal sequence of 1 bit on a serial interface. This usually indicates a clocking problem between the serial interface and the data link equipment. carrier transitions Gives the number of times that the carrier detect signal of a serial interface has changed state. For example, if data carrier detect (DCD) goes down and comes up, the carrier transition counter will increment two times. This indicates modem or line problems if the carrier detect line is changing state often. packets output Gives the total number of messages transmitted by the system. bytes output Gives the total number of bytes, including data and MAC encapsulation, transmitted by the system. underruns Gives the number of times that the transmitter has been running faster than the router can handle. This might never be reported on some interfaces. output errors Gives the sum of all errors that prevented the final transmission of datagrams out of the interface being examined. Note that this might not balance with the sum of the enumerated output errors because some datagrams can have more than one error, and others can have errors that do not fall into any of the specifically tabulated categories. collisions Gives the number of messages retransmitted because of an Ethernet collision. This usually is the result of an overextended LAN (Ethernet or transceiver cable too long, more than two repeaters between stations, or too many cascaded multiport transceivers). Some collisions are normal. However, if your collision rate climbs to around 4 percent or 5 percent, you should consider verifying that there is no faulty equipment on the segment, or moving some existing stations to a new segment. A packet that collides is counted only once in output packets. interface resets Gives the number of times that an interface has been completely reset. This can happen if packets queued for transmission were not sent within several seconds. On a serial line, this can be caused by a malfunctioning modem that is not supplying the transmit clock signal, or by a cable problem. If the system notices that the carrier detect line of a serial interface is up but the line protocol is down, it periodically resets the interface in an effort to restart it. Interface resets can also occur when an interface is looped back or shut down. restarts Gives the number of times that the controller was restarted because of errors. alarm indications, remote alarms, rx LOF, rx LOS Gives the number of CSU/DSU alarms, and the number of occurrences of receive loss of frame and receive loss of signal. BER inactive, NELR inactive, FELR inactive Shows the status of G.703-E1 counters for bit error rate (BER) alarm, near-end loop remote (NELR), and far-end loop remote (FELR). Note that you cannot set the NELR or FELR. Using Ping and Extended ping Tests The Ping Command The ping command (which stands for "Packet Internetwork Groper") is a very common method for troubleshooting the accessibility of devices. It uses a series of Internet Control Message Protocol (ICMP) Echo messages to determine: if a remote host is active or inactive, and the round-trip delay in communicating with the host. The ping command first sends an echo request packet to an address, then waits for a reply. The ping is successful only if: the echo request gets to the destination, and the destination is able to get an echo reply back to the source. Below is an output example using the ping command Router1#ping (another routers ip address) Type escape sequence to abort. Sending 5, 100-byte ICMP Echos to 12.0.0.2, timeout is 2 seconds: !!!!! Success rate is 100 percent (5/5), round-trip min/avg/max = 4/6/8 ms Table 1-3 below lists possible ICMP type values. IP Ping Test Characters Character Description ! Each exclamation point indicates receipt of a reply . Each period indicates the network server timed out while waiting for a reply U A destination unreachable error PDU was received Q Source quench (destination too busy) M Could not fragment ? Unknown packet type & Packet lifetime exceeded The Extended Ping Command When a normal ping command is sent from a router, the source address of the ping is the IP address of the interface that the packet uses to exit the router. If an extended ping command is used, the source IP address can be changed to any IP address on the router. Figure 15-5 illustrates the menu used to specify extended ping options. This example specifies 20 successive pings. However, when testing the components on your serial line, you should specify a much larger number, such as 1000 pings. Also increase the datagram size to a larger number, such as 1500. Figure 1-4: Extended ping Specification Menu In general, perform serial line ping tests as follows: Figure 1-5: All-Zeros 1500-Byte ping Test Figure 1-6: All-Ones 1500-Byte ping Test Ping Command Field Descriptions The following table lists the ping command field descriptions. As show above, these fields can be modified with the use of the extended ping command. Figure 1-7: Field Description Protocol [ip]: Prompts for a supported protocol. Enter appletalk, clns, ip, novell, apollo, vines, decnet, or xns. Default: ip. Target IP address: Prompts for the IP address or host name of the destination node you plan to ping. If you have specified a supported protocol other than IP, enter an appropriate address for that protocol here. Default: none. Repeat count [5]: Number of ping packets that will be sent to the destination address. Default: 5. Datagram size [100]: Size of the ping packet (in bytes). Default: 100 bytes. Timeout in seconds [2]: Timeout interval. Default: 2 (seconds). Extended commands [n]: Specifies whether or not a series of additional commands appears. Source address or interface: The interface or IP addresses of the router to use as a source address for the probes. The router will normally pick the IP address of the outbound interface to use. Type of service [0]: Specify the Type of Service (TOS). The requested TOS will be placed in each probe but there is no guarantee that all routers will process the TOS. Set DF bit in IP header? [no]: Specify whether or not the Don't Fragment (DF) bit is set on the ping packet. This is useful for checking the MTU along the path to a destination. Validate reply data? [no]: Specify whether of not to validate the reply data. Data pattern [0xABCD] Specify the data pattern. Different data patterns are used to troubleshoot framing errors and clocking problems on serial lines. Loose, Strict, Record, Timestamp, Verbose[none]: IP header options. You can specify any combination. The traceroute command issues prompts for the required fields. Note that traceroute command will place the requested options in each probe; however, there is no guarantee that all routers (or end nodes) will process the options. Sweep range of sizes [n]: Each exclamation point (!) indicates receipt of a reply. A period (.) indicates the network server timed out while waiting for a reply. Other characters may appear in the ping output display, depending on the protocol type. Success rate is 100 percent Percentage of packets successfully echoed back to the router. Anything less than 80 percent is usually considered problematic. round-trip min/avg/max = 1/2/4 ms Round-trip travel time intervals for the protocol echo packets, including minimum/average/maximum (in milliseconds). The Traceroute Command Where ping can be used to verify connectivity between devices, the traceroute command can be used to discover the routes packets take to a remote destination, as well as where routing breaks down. The device executing the traceroute command sends out a sequence of User Datagram Protocol (UDP) datagrams, each with incrementing TimeTo-Live (TTL) values, to an invalid port address at the remote host. First, three datagrams are sent, each with a TTL field value set to 1. The TTL value of 1 causes the datagram to "timeout" as soon as it hits the first router in the path; this router then responds with an ICMP "time exceeded" message indicating that the datagram has expired. Next, three more UDP messages are sent, each with the TTL value set to 2. This causes the second router in the path to the destination to return ICMP "time exceeded" messages. This process continues until the packets reach the destination and until the system originating the traceroute has received ICMP "time exceeded" messages from every router in the path to the destination. Since these datagrams are trying to access an invalid port at the destination host, the host will respond with ICMP"port unreachable" messages indicating an unreachable port. This event signals the traceroute program to finish. The purpose behind the traceroute command is to record the source of each ICMP "time exceeded" message to provide a trace of the path the packet took to reach the destination. Router1#traceroute (another routers IP address) Type escape sequence to abort. Tracing the route to 34.0.0.4 1 12.0.0.2 4 msec 4 msec 4 msec 2 23.0.0.3 20 msec 16 msec 16 msec 3 34.0.0.4 16 msec * 16 msec IP Traceroute Text Characters Figure 1-8: Character Description nn msec For each node, the round-trip time in milliseconds for the specified number of probes * The probe timed out A Administratively prohibited (example, access-list) Q Source quench (destination too busy) I User interrupted test U Port unreachable H Host unreachable N Network unreachable P Protocol Unreachable T Timeout ? Unknown packet type Extended Traceroute Command The extended traceroute command is a variation of the traceroute command. An extended traceroute command can be used to see what path packets are taking to get to a destination, and the command can be used to check routing at the same time. This is helpful for troubleshooting routing loops, or for determining where packets are getting lost (if a route is missing, or if packets are being blocked by an Access Control List (ACL) or firewall). You can use the extended ping command to determine the type of connectivity problem, and then use the extended traceroute command to narrow down to where the problem is occurring. Example Router_A#traceroute Protocol [ip]: Target IP address: 192.168.40.2 Source address: 172.16.23.2 Numeric display [n]: Timeout in seconds [3]: Probe count [3]: Minimum Time to Live [1]: Maximum Time to Live [30]: Port Number [33434]: Loose, Strict, Record, Timestamp, Verbose[none]: Type escape sequence to abort. Tracing the route to 192.168.40.2 1 172.31.20.2 [AS 3] 4 msec 0 msec 4 msec 2 172.20.10.2 [AS 3] 4 msec 4 msec 8 msec 3 192.168.40.2 [AS 3] 24 msec * 24 msec Router_A# Extended Traceroute Command Field Descriptions The following table lists the traceroute command field descriptions. Figure 1-9: Field Description Protocol [ip]: Prompts for a supported protocol. Enter appletalk, clns, ip, novell, apollo, vines, decnet, or xns. Default: ip. Target IP addres You must enter a host name or an IP address. There is no default. Source address: The interface or IP addresses of the router to use as a source address for the probes. The router will normally pick the IP address of the outbound interface to use. Numeric display [n]: The default is to have both a symbolic and numeric display; however, you can suppress the symbolic display. Timeout in seconds [3]: The number of seconds to wait for a response to a probe packet. The default is 3 seconds. Probe count [3]: The number of probes to be sent at each TTL level. The default count is 3. Minimum Time to The TTL value for the first probes. The Live [1]: default is 1, but it can be set to a higher value to suppress the display of known hops. Maximum Time to The largest TTL value that can be used. Live [30]: The default is 30. The traceroute command terminates when the destination is reached or when this value is reached. Port Number [33434]: The destination port used by the UDP probe messages. The default is 33434. Loose, Strict, Record, Timestamp, Verbose[none]: IP header options. You can specify any combination. The traceroute command issues prompts for the required fields. Note that traceroute command will place the requested options in each probe; however, there is no guarantee that all routers (or end nodes) will process the options.