Troubleshooting the Gigabit Ethernet SPAs

Table Of Contents

Troubleshooting the Gigabit Ethernet SPA

General Troubleshooting Information

Using Debug Commands

Using show Commands

Performing Basic Interface Troubleshooting

Verifying the Interface is Up

Verifying the Line Protocol is Up

Verifying Output Hang Status

Verifying the CRC Counter

Verifying Late Collisions

Verifying the Carrier Signal

Understanding SPA Automatic Recovery

When Automatic Recovery Occurs

If Automatic Recovery Fails

Configuring the Interface for Internal Loopback

Configuring the Interface for Internal Loopback

Configuring the Interface for External Loopback

Verifying Loopback Status

Using the Cisco IOS Event Tracer to Troubleshoot Problems

Preparing for Online Insertion and Removal of a SPA


Troubleshooting the Gigabit Ethernet SPA


This chapter describes techniques that you can use to troubleshoot the operation of your GigabitEthernet SPAs.

It includes the following sections:

General Troubleshooting Information

Performing Basic Interface Troubleshooting

Understanding SPA Automatic Recovery

Configuring the Interface for Internal Loopback

Using the Cisco IOS Event Tracer to Troubleshoot Problems

Preparing for Online Insertion and Removal of a SPA

The first section provides information about basic interface troubleshooting. If you are having a problem with your SPA, use the steps in the "Performing Basic Interface Troubleshooting" section to begin your investigation of a possible interface configuration problem.

To perform more advanced troubleshooting, see the other sections in this chapter.

General Troubleshooting Information

This section describes general information for troubleshooting SIPs and SPAs. It includes the following sections:

Using Debug Commands

Using show Commands

Using Debug Commands

Along with the other debug commands supported on the Cisco 12000 Series Router, you can obtain specific debug information for SPAs on the Cisco 12000 Series Router using the debug hw-module subslot privileged exec command.

The debug hw-module subslot command is intended for use by Cisco Systems technical support personnel. For more information about the debug hw-module subslot command, see Chapter 19, "SIP and SPA Command Reference."


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.

For information about other debug commands supported on the Cisco 12000 Series Router, refer to the Cisco IOS Debug Command Reference and any related feature documents for the applicable Cisco IOS Release.

Using show Commands

There are several show commands that you can use to monitor and troubleshoot the SIPs and SPAs on the Cisco 12000 Series Router. This chapter describes using the show interfaces and show controllers commands to perform troubleshooting of your SPA.

For more information about show commands to verify and monitor SIPs and SPAs, see the following chapters of this guide:

"Configuring the Fast Ethernet and Gigabit Ethernet SPAs"

"Command Summary for Gigabit Ethernet SPAs"

Chapter 19, "SIP and SPA Command Reference"

Performing Basic Interface Troubleshooting

You can perform most of the basic interface troubleshooting using the show interfaces gigabitethernet command and examining several areas of the output to determine how the interface is operating.

The following example shows output from the show interfaces gigabitethernet command with some of the significant areas of the output to observe shown in bold:


Router# show interfaces gigabitethernet 3/0/0
GigabitEthernet3/0/0 is up, line protocol is up 
  Hardware is GigMac 1 Port 10 GigabitEthernet, address is 0008.7db3.8dfe (bia )
  Internet address is 10.0.0.2/24
  MTU 1500 bytes, BW 10000000 Kbit, DLY 10 usec, rely 255/255, load 1/255
  Encapsulation ARPA, loopback not set
  Keepalive set (10 sec)
  Full Duplex, 10000Mbps, link type is autonegotiation, media type is T
  output flow-control is on, input flow-control is on
  ARP type: ARPA, ARP Timeout 04:00:00
  Last input 00:00:01, output 00:00:01, output hang never
  Last clearing of "show interface" counters never
  Queueing strategy: fifo
  Output queue 0/40, 0 drops; input queue 0/75, 0 drops
        Available Bandwidth 10000000 kilobits/sec
  30 second input rate 0 bits/sec, 0 packets/sec
  30 second output rate 0 bits/sec, 0 packets/sec
     11 packets input, 1154 bytes, 0 no buffer
     Received 1 broadcasts, 0 runts, 0 giants, 0 throttles
     0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
     0 watchdog, 0 multicast, 0 pause input
     67 packets output, 20951 bytes, 0 underruns
     0 output errors, 0 collisions, 1 interface resets
     0 babbles, 0 late collision, 0 deferred
     0 lost carrier, 0 no carrier, 0 pause output
     0 output buffer failures, 0 output buffers swapped out


To verify that your interface is operating properly, complete the steps in Table 6-1:

Table 6-1 Basic Interface Troubleshooting Steps

 
Action
Example

Step 1 

From global configuration mode, enter the show interfaces gigabitethernet command.

Router# show interfaces gigabitethernet 2/1/1

Step 2 

Verify that the interface is up.

Router# show interfaces gigabitethernet 2/1/1
GigabitEthernet2/1/1 is up, line protocol is up 

Step 3 

Verify that the line protocol is up.

Router# show interfaces gigabitethernet 2/1/1
GigabitEthernet2/1/1 is up, line protocol is up 

Step 4 

Verify that the interface duplex mode matches the remote interface configuration.

The following example shows that the local interface is currently operating in full-duplex mode:

Router# show interfaces gigabitethernet 2/1/1
[text omitted]

  Keepalive set (10 sec)
  Full-duplex, 100Mb/s, 100BaseTX/FX

Step 5 

Verify that the interface speed matches the speed on the remote interface.

The following example shows that the local interface is currently operating at 100Mbps:

Router# show interfaces gigabitethernet 2/1/1
. 
.
.
  Keepalive set (10 sec)
  Full-duplex, 100Mb/s, 100BaseTX/FX
. 
.
.

Step 6 

Observe the output hang status on the interface.

Router# show interfaces gigabitethernet 2/1/1
. 
.
.
  ARP type: ARPA, ARP Timeout 04:00:00
  Last input 00:00:22, output 00:00:02, output hang never
.
.
.

Step 7 

Observe the CRC counter.

Router# show interfaces gigabitethernet 2/1/1
. 
.
.
     5 minute output rate 0 bits/sec, 0 packets/sec
     5 packets input, 320 bytes
     Received 1 broadcasts (0 IP multicast)
     0 runts, 0 giants, 0 throttles
     0 input errors, 0 CRC, 0 frame, 0 overrun, 0 ignored
.
.
.

Step 8 

Observe the late collision counter.

Router# show interfaces gigabitethernet 2/1/1
.
.
.
     0 input packets with dribble condition detected
     8 packets output, 529 bytes, 0 underruns
     0 output errors, 0 collisions, 2 interface resets
     0 babbles, 0 late collision, 0 deferred
.
.
.

Step 9 

Observe the carrier signal counters.

Router# show interfaces gigabitethernet 2/1/1
.
.
.
     0 output errors, 0 collisions, 2 interface resets
     0 babbles, 0 late collision, 0 deferred
     2 lost carrier, 0 no carrier
.
.
.

For more information about the verification steps in and possible responses to correct detected problems, see the following sections:

Verifying the Interface is Up

Verifying the Line Protocol is Up

Verifying Output Hang Status

Verifying the CRC Counter

Verifying Late Collisions

Verifying the Carrier Signal

Verifying the Interface is Up

In the output from the show interfaces gigabitethernet command, verify that the interface is up. If the interface is down, perform the following corrective actions:

If the interface is administratively down, use the no shutdown interface configuration command to enable the interface.

Be sure that the cable is fully connected.

Verify that the cable is not bent or damaged. If the cable is bent or damaged, the signal will be degraded.

Verify that a hardware failure has not occurred. Observe the LEDs to confirm the failure. See the other troubleshooting sections of this chapter, and refer to the Cisco 12000 Series Router SIP and SPA Hardware Installation Guide. If the hardware has failed, replace the SPA as necessary.

Verifying the Line Protocol is Up

In the output from the show interfaces gigabitethernet command, verify that the line protocol is up. If the line protocol is down, the line protocol software processes have determined that the line is unusable.

Perform the following corrective actions:

Swap the cable.

Check the local and remote interface for misconfiguration.

Verify that a hardware failure has not occurred. Observe the LEDs to confirm the failure. See the other troubleshooting sections of this chapter, and refer to the Cisco 12000 Series Router SIP and SPA Hardware Installation Guide. If the hardware has failed, replace the SPA as necessary.

Verifying Output Hang Status

In the output from the show interfaces gigabitethernet command, observe the value of the output hang field.

The output hang provides the number of hours, minutes, and seconds since the last reset caused by a lengthy transmission. When the number of hours the field exceeds 24 hours, the number of days and hours is shown. If the field overflows, asterisks are printed. The field shows a value of never if no output hangs have occurred.

Verifying the CRC Counter

In the output from the show interfaces gigabitethernet command, observe the value of the CRC counter. Excessive noise will cause high CRC errors accompanied by a low number of collisions.

Perform the following corrective actions if you encounter high CRC errors:

Check the cables for damage.

Verify that the correct cables are being used for the SPA interface.

Verifying Late Collisions

In the output from the show interfaces gigabitethernet command, observe the value of the late collision counter.

Perform the following corrective actions if you encounter late collisions on the interface:

Verify that the duplex mode on the local and remote interface match. Late collisions occur when there is a duplex mode mismatch.

Verify the length of the Ethernet cables. Late collisions result from cables that are too long.

Verifying the Carrier Signal

In the output from the show interfaces gigabitethernet command, observe the value of the carrier signal counters. The lost carrier counter shows the number of times that the carrier was lost during transmission. The no carrier counter shows the number of times that the carrier was not present during transmission.

Carrier signal resets can occur when an interface is in loopback mode or shut down.

Perform the following corrective actions if you observe the carrier signal counter incrementing outside of these conditions:

Check the interface for a malfunction.

Check for a cable problem.

Understanding SPA Automatic Recovery

When the Gigabit Ethernet SPAs encounter thresholds for certain types of errors and identifies a fatal error, the SPA initiates an automatic recovery process.

You do not need to take any action unless the error counters reach a certain threshold, and multiple attempts for automatic recovery by the SPA fail.

The GigabitEthernet SPAs might perform automatic recovery for the following types of errors:

SPI4 TX/RX out of frame

SPI4 TX train valid

SPI4 TX DIP4

SPI4 RX DIP2


Note These SPA error counters do not appear in the show controllers gigabitethernet command output until at least one SPI4 error occurs.


When Automatic Recovery Occurs

If the SPI4 errors occur more than 25 times within 10 milliseconds, the SPA automatically deactivates and reactivates itself. Error messages are logged on the console indicating the source of the error and the status of the recovery.

If Automatic Recovery Fails

If the SPA attempts automatic recovery more than five times in an hour, then the SPA deactivates itself and remains deactivated.

To troubleshoot automatic recovery failure for a SPA, perform the following steps:


Step 1 Use the show hw-module subslot slot/subslot oir command to verify the status of the SPA. The status is shown as "failed" if the SPA has been powered off due to five consecutive failures.

Step 2 If you verify that automatic recovery has failed, perform OIR of the SPA. For information about performing an OIR, see the "Preparing for Online Insertion and Removal of a SPA" section.

Step 3 If reseating the SPA after OIR does not resolve the problem, replace the SPA hardware.


Configuring the Interface for Internal Loopback

Loopback support is useful for testing the interface without connectivity to the network, or for diagnosing equipment malfunctions between the interface and a device. The Gigabit Ethernet SPAs supports both an internal and an external loopback mode. The external loopback mode requires the use of a loopback cable and implements a loopback through the transceiver on the SPA.

You can also configure an internal loopback without the use of a loopback cable that implements a loopback at the PHY device internally on a Gigabit Ethernet interface port, or at the MAC device internally on a Gigabit Ethernet interface port. By default, loopback is disabled.

Configuring the Interface for Internal Loopback

To enable internal loopback at the PHY device for an interface on a SPA, use the following commands beginning in interface configuration mode:

 
Command or Action
Purpose

Step 10 

Router(config-if)# loopback internal

Enables an interface for internal loopback on the Gigabit Ethernet SPA.

Configuring the Interface for External Loopback

Before beginning external loopback testing, remember that the external loopback mode requires the use of a loopback cable.

To enable external loopback, use the following commands beginning in interface configuration mode:

Command
Purpose

Router(config-if)# loopback external

Enables an interface for external loopback on the Gigabit Ethernet SPA.


Verifying Loopback Status

To verify whether loopback is enabled on an interface port on a SPA, use the show interfaces gigabitethernet privileged EXEC command and observe the value shown in the "loopback" field.

The following example shows that loopback is disabled for interface port 0 (the first port) on the SPA installed in the top (0) subslot of the SIP that is located in slot 3 of the Cisco 12000 Series Router:

Router# show interfaces gigabitethernet 3/0/0
GigabitEthernet3/0/0 is up, line protocol is up 
  Hardware is GigMac 1 Port 10 GigabitEthernet, address is 0008.7db3.8dfe (bia )
  Internet address is 10.0.0.2/24
  MTU 1500 bytes, BW 10000000 Kbit, DLY 10 usec, rely 255/255, load 1/255
  Encapsulation ARPA, loopback not set
.
.
.

Using the Cisco IOS Event Tracer to Troubleshoot Problems


Note This feature is intended for use as a software diagnostic tool and should be configured only under the direction of a Cisco Technical Assistance Center (TAC) representative.


The Event Tracer feature provides a binary trace facility for troubleshooting Cisco IOS software. This feature gives Cisco service representatives additional insight into the operation of the Cisco IOS software and can be useful in helping to diagnose problems in the unlikely event of an operating system malfunction or, in the case of redundant systems, route processor switchover.

Event tracing works by reading informational messages from specific Cisco IOS software subsystem components that have been preprogrammed to work with event tracing, and by logging messages from those components into system memory. Trace messages stored in memory can be displayed on the screen or saved to a file for later analysis.

The SPAs currently support the "spa" component to trace SPA OIR-related events.

For more information about using the Event Tracer feature, refer to the following URL:

http://www.cisco.com/univercd/cc/td/doc/product/software/ios120/120newft/120limit/120s/120s18/evnttrcr.htm

Preparing for Online Insertion and Removal of a SPA

The Cisco 12000 Series Router supports online insertion and removal (OIR) of the SIP, in addition to each of the SPAs. Therefore, you can remove a SIP with its SPAs still intact, or you can remove a SPA independently from the SIP, leaving the SIP installed in the router.

This means that a SIP can remain installed in the router with one SPA remaining active, while you remove another SPA from one of the SIP subslots. If you are not planning to immediately replace a SPA into the SIP, then be sure to install a blank filler plate in the subslot. The SIP should always be fully installed with either functional SPAs or blank filler plates.