Table Of Contents
Troubleshooting
Introduction
Troubleshooting Overview
Information About Troubleshooting Tools
CLI Commands for Troubleshooting
Checking the LEDs
Problem Solving Using a Subsystems Approach
Identifying Startup Problems
Troubleshooting the Power Subsystem
Troubleshooting the Firmware Package Installation
Troubleshooting the Management Subsystem
Troubleshooting the Link Interface Subsystem
Troubleshooting with the User Log
Logging System
Copying the User Log to an External Source
How to Copy the User Log to an Internal Location
Viewing the User Log
Clearing the User Log
Viewing the User Log Counters
How to View the Non-volatile Logger Counters For Both the User Log File and the Debug Log File
How to View the Non-volatile Counter For the User-file-log Only
Generating a File for Technical Support
Troubleshooting
Revised: April 19, 2010, OL-7821-08
Introduction
Your SCE 1000 platform went through extensive testing before leaving the factory. However, if you encounter problems starting it, use the information in this chapter to help isolate the cause of the problems. The procedures in this chapter assume that you are troubleshooting the initial system startup, and that your SCE 1000 platform is in the original factory configuration. If you have removed or replaced components or changed any default settings, the recommendations in this chapter might not apply. Make sure to review the safety warnings listed in the Regulatory Compliance and Safety Information for the Cisco Service Control Engines (SCE) document that accompanied your SCE 1000 platform before using the troubleshooting procedures in this chapter.
•
Troubleshooting Overview
•
Troubleshooting with the User Log
Troubleshooting Overview
This section describes the troubleshooting methods used in this chapter and describes how the SCE 1000 platform is divided into subsystems for more efficient problem solving. If you are unable to easily solve the problem, contact a customer service representative for assistance and further instructions. Provide the representative with the following information:
•
Date you received the router
•
Chassis serial number
•
Type of software and release number
•
Brief description of the problem you are having
•
Brief explanation of the steps you have taken to isolate and resolve the problem
•
Maintenance agreement or warranty information
The following table shows the general troubleshooting strategy described in this chapter. Refer to this table, as necessary, to follow the steps to isolate problems to a specific subsystem and resolve the problem if possible.
Table 8-1 Troubleshooting Strategy for Startup Problems
| |
Action
|
Yes
|
No
|
Step 1
|
Turn power on. Go to Step 2
|
|
|
Step 2
|
Power A/Power B LEDs on?
|
Go to Step 3
|
Refer to Troubleshooting the Power Subsystem and go to Step 3.
|
Step 3
|
Status LED red (failure)
|
Refer to Troubleshooting the Firmware Package Installation and go to Step 4.
|
Go to Step 4
|
Step 4
|
Management interface operational?
|
Go to Step 5
|
Refer to Troubleshooting the Management Subsystem and go to Step 5.
|
Step 5
|
Link interfaces operational?
|
Go to Step 6
|
Refer to Troubleshooting the Link Interface Subsystem and go to Step 6.
|
Step 6
|
System startup successful (all interfaces operating normally).
|
-
|
-
|
•
Information About Troubleshooting Tools
•
Problem Solving Using a Subsystems Approach
Information About Troubleshooting Tools
There are two tools that will help you to successfully troubleshoot your SCE 1000 installation:
•
CLI Commands for Troubleshooting
•
Checking the LEDs
CLI Commands for Troubleshooting
Use the following commands to provide information to help you troubleshoot installation of your SCE 1000 platform. Refer to Cisco SCE 2000 and SCE 1000 Software Configuration Guide or the Cisco SCE 2000 and SCE 1000 CLI Command Reference for more information.
Remember that if the management interface is not operational, you should connect the SCE 1000 platform to a local console so that you can enter CLI commands for troubleshooting.
•
Troubleshooting firmware package installation:
–
boot system <filename>— Specifies and verifies the package file to be installed. Error messages or other output identify problems with the package file.
Following is a sample output from the Boot system command.
SCE 1000(config)#boot system ftp://vk:vk@10.1.1.230/downloads/SENum.pkg.pkgVerifying
package file SENum.pkg.pkg...
Package file verified OK.
•
Troubleshooting the management subsystem:
–
show interface Mng — Displays IP address and auto-negotiation information for the management interfaces.
Following is a sample output from the show interface Mng command.
Configured speed: auto, configured duplex: auto
AutoNegotiation is On, link is Up, actual speed: 100, actual duplex: half
–
show ip default-gateway — Displays the IP address of the configured default gateway.
Following is a sample output from the show ip default-gateway command.
Default gateway: 10.1.1.1
–
show ip route — Displays the entire routing table and the destination of last resort (default-gateway).
Following is a sample output from the show ip route command.
gateway of last resort is 10.1.1.1
–
show access-lists—Shows all access-lists or a specific access list.
Following is a sample output from the show access-lists command.
Standard IP access list 1
Permit 10.1.1.0, wildcard bits 0.0.0.255
–
show telnet—Displays the status of the telnet server daemon (status) or any active Telnet sessions (sessions).
Following is a sample output from the show telnet command.
show telnet sessions There is 1 active telnet session:
0 | 10.1.1.201show telnet status Telnet deamon is enabled.
–
show line vty timeout— Shows the timeout configured for Telnet sessions.
Following is a sample output from the show line vty timeout command.
•
Troubleshooting the link interface subsystem:
–
show interface Gigabit Ethernet 0/#—Displays information for a specific GBE Interface.
Following is a sample output from the show interface command.
AutoNegotiation is On, link is Up, actual duplex: half
–
show interface Gigabit Ethernet 0/# counters—Displays the values of counters of a GBE interface.
Following is a sample output from the show interface counters command.
In good unicast packets: 560
In good multicast packets: 0
In good broadcast packets: 0
In packets with CRC/Alignment error: 0
Out non unicast packets: 0
Refer toTroubleshooting with the User Log for an explanation of commands related to the user log.
Checking the LEDs
The front panel LEDS are the most immediate problem-detection mechanism of the platform. Refer to the following sections for information on SCE 1000 platform LEDS:
•
Front Panel
•
SCE 1000 Operational Status
SCE 1000 Operational Status
Table 8-2 lists the operational states of the SCE 1000. The Status LED on the SCE 1000 Front Panel reflects the current SCE 1000 operational status. The operational status can be displayed using CLI command show system operation-status.
Table 8-2 SCE 1000 Operational States
SCE 1000 Operational Status
|
Description
|
Status LED State
|
Booting
|
Initial state after reset
|
Orange
|
Operational
|
SCE 1000 becomes operational after completing the following process:
• Boot is completed
• Power self-tests are completed without failure
• Platform configuration is applied
|
Flashing green
|
Warning
|
SCE 1000 is fully operational (as above) but one of the following occurred:
• Line ports (GBE ports) to the link are down
• Management port link is down
• Temperature raised above threshold
• Voltage not in required range
• Fans problem
• Power supply problem o Insufficient space on the disk
Note Warning Note: If the condition that caused the SCE 1000 to be in Warning state is resolved (for example, link is up) the SCE 1000 reverts to Operational state. Flashing orange
|
Warning Flashing orange
|
Failure
|
System is in Failure state after Boot due to one of the following conditions:
• Power on test failure
• Three abnormal reboots in less than 20 minutes
• Platform configured to enter Failure mode consequent to failure-induced reboot (this is configurable using CLI command)
Note Depending on the cause of failure, the management interface and the platform configuration may or may not be active/available. Red
|
Red
|
Table 8-3 Power Supply LEDs
LED Label
|
Color
|
State
|
Function
|
IN
|
Green
|
On
|
The input voltage is in the required range.
|
| |
|
Off
|
The input voltage is not in the required range.
|
OK
|
Green
|
On
|
The output voltage is in the required range (between 11.9 and 12.1 VDC).
|
| |
|
Off
|
The output voltage is not within the required range (is greater than 12.1 VDC or less than 11.9 VDC).
|
Power A/B (front panel)
|
Green
|
Steady
|
Corresponding power supply unit is present and functioning normally.
|
| |
Red
|
Steady
|
Corresponding power supply unit present, but malfunctioning.
|
| |
|
Off
|
Corresponding power supply unit is either not present or has failed.
|
Problem Solving Using a Subsystems Approach
•
Identifying Startup Problems
•
Troubleshooting the Power Subsystem
•
Troubleshooting the Firmware Package Installation
•
Troubleshooting the Management Subsystem
•
Troubleshooting the Link Interface Subsystem
Identifying Startup Problems
Startup problems are commonly due to the source power or to a poor cable connection.
When you start up the SCE 1000 platform for the first time, you should observe the startup sequence described in Starting the SCE 1000 Platform. This section contains a more detailed description of the normal startup sequence and describes the steps to take if the system does not perform that sequence as expected. LEDs indicate all system states in the startup sequence. By checking the state of the LEDs, you can determine when and where the system failed in the startup sequence. Use the following descriptions to isolate the problem to a subsystem, and then proceed to the appropriate sections to try to resolve the problem.
When you start up the system by turning on the power supply switch, the following should occur:
•
You should immediately hear the fans operating.
•
When all LEDs come on to indicate that the system has booted successfully, the initial system banner should be displayed on the console screen. If it is not displayed, see How to Set Up the Local Console to verify that the terminal is set correctly and that it is properly connected to the console port.
•
If the banner is displayed, but the Status LED is flashing orange, indicating a warning state, check the user log:
At the prompt, type: more user log
If any of the following warning messages appear, turn the SCE 1000 platform off and call technical support.
–
"voltage problem"
–
"fans problem"
–
"abnormal raise in interior temperature"
•
If the following warning message appears, delete unneeded files from the disk.
–
"insufficient disk space"
Troubleshooting the Power Subsystem
Check the following to help isolate a problem in the power subsystem. In the normally configured SCE 1000 platform with redundant power supply units, it is unlikely that the device will not start at all.
However, at startup it should be verified that both power supply units are operational, and therefore the following steps should be followed if one of the Power LEDs on the front panel remains unlit when the SCE 1000 platform is powered up.
Note
If the system powers off due to an environmental shutdown, wait at least one minute before manually rebooting the system, or it will pause indefinitely.
Table 8-4 Troubleshooting the Power Subsystem
Symptom
|
Possible Cause
|
Possible Solution
|
Power LED on the front panel and LEDs on the power supply unit are not lit, or do not remain lit continuously.
|
Power cable not fully seated at system.
|
Turn the power switch to the off position and reseat the power cable in the system.
|
| |
Power cable not fully seated at source.
|
Turn the switch to the off position and reseat the power cable at the power source.
|
| |
Power source is faulty.
|
Turn the switch to the off position, connect the power cable to another power source, if available, and turn the switch back on.
|
| |
Faulty power cable.
|
Turn the switch to the off position, remove the cable and replace it.
|
| |
Faulty power supply.
|
If the system still fails to come up when the power supply is connected to a different power source with a new power cable, the power supply unit is probably faulty. Contact a service representative.
|
Troubleshooting the Firmware Package Installation
Check the following to help isolate a problem in the installation of the firmware package.
Problems related to the installation of the firmware package could be any of the following:
•
File not found in the expected location
•
Wrong file type.
•
Device to which the file is to be extracted is full.
Table 8-5 Troubleshooting the Firmware Package Installation
Diagnostic Action
|
|
|
Enter the CLI command:
• configure
• boot system <filename>
|
|
|
Symptom
|
Possible Cause
|
Possible Solution
|
Returned error is:
Error-File <filename>does
not exist
|
The package file does not exist in the specified location.
|
Verify package file location and try again.
|
In the output of the command, the package file type is management-image instead of system-image
|
Package file type mismatch.
|
Verify that you are trying to open the correct package file.
|
In the output of the command, the package file platform is not the correct installation file for the SCE 1000.
|
Package file platform mismatch.
|
Verify that you have the package file appropriate to your platform type.
|
Returned error is:
Package file <filename>does
not contain magic header
|
The file is not a software installation package file.
|
Verify that you are trying to open the ///////////////////////////////////////////// ///////////////////////////////////////////// ///////////////////////////////////////////// ///////////////////////////////////////////// ////////////////................................. .................................................. ...........correct package file.
|
Returned error is:
Error-There are only X free
bytes on device <device
name>, but Y bytes are
needed for the extraction
(where X and Y are stated in
bytes)
|
/tffs0/ device is full.
|
Delete old and unnecessary files and try the package extraction again.
|
Troubleshooting the Management Subsystem
Check the following to help isolate a problem in the management subsystem.
Problems in the management subsystem could be any of the following:
•
Management link is down. (Mng LINK LED not lit--also Status is WARNING)
•
Management link is up (Mng LINK LED lit) but does not answer ping
•
Telnet connection cannot be established due to link problems (Mng LINK LED not lit)
•
Management link is up (Mng LINK LED lit) but Telnet connection cannot be established
•
Telnet connection established, but terminates automatically
Note
When the management link is down and/or a Telnet connection cannot be established, you must open a CLI session on a local terminal connected to the CON port. This enables you to solve the problem and then reconnect through the management port.
Troubleshooting the Link Interface Subsystem
Check the following to help isolate a problem in the link interface subsystem.
In general, the case where no traffic is coming out of the SCE 1000 is often caused by link problems or GBE interface configuration. Note that in some cases, the problem which seems as a transmit problem could be in the Rx (no traffic is being received by the SCE 1000 or there is actually no traffic on the line, which could be a normal situation).
Note
In CLI commands of Gigabit Ethernet interfaces, # stands for the number of the interface. This can be 1 through 4.
Problems in the link interface subsystem could be any of the following:
•
Link is down. (LINK LED not lit and system status is WARNING)
•
Peer does not receive traffic from SCE 1000 (GBE link is lit and Tx LED is flashing)
•
GBE link is up but not receiving from peer (GBE link is lit, but Rx LED is not flashing)
Table 8-7 Troubleshooting the Link Interface Subsystem
Symptom
|
Diagnostic Action
|
Possible Cause
|
Possible Solution
|
• Link is down. (LINK LED not lit)
• Status is WARNING (Status LED is flashing orange)
• Output counters not incrementing.
|
CLI command:
• show interface Gigabit Ethernet 0/# counters
|
Connector is not connected to the platform or to the network.
|
Reconnect the cable to the GBE port and to network.
|
| |
|
GBE cable is broken.
|
Reconnect / replace the cable to the GBE port.
|
| |
|
|
If GBE counters are incrementing, this indicates LED problem. Contact customer support.
|
| |
CLI commands:
show interface Gigabit Ethernet 0/# counters
Check output of this command for: "In good unicast packet" and "Out unicast packet". These counters should be constantly incrementing.
|
Auto-negotiation may be incorrectly configured.
|
Check auto-negotiation configuration in the SCE 1000 and in peer. See "How to View the Gigabit Ethernet Counters" section on page 6-6.
|
• GBE link is up (GBE interface link LED is continuous green and GBE interface Tx LED is flashing)
• Peer does not receive traffic from SCE 1000
|
CLI commands:
• show interface Gigabit Ethernet 0/# counters
Check output of this command for: "Out unicast packet". This counter should be constantly incrementing.
show interface Gigabit Ethernet 0/#
|
Auto-negotiation is disabled at the SCE 1000 but enabled at peer.
|
Check auto-negotiation configuration in the SCE 1000 and in peer. See "How to View the Gigabit Ethernet Counters" section on page 6-6.
|
• GBE link is up (GBE interface link LED is continuous green)
• No traffic received (GBE interface Rx LED is not flashing)
|
|
No traffic is being transmitted to the SCE 1000 from its peers.
|
Check traffic connection at peer.
|
| |
|
Auto-negotiation is disabled at the SCE 1000 but enabled at peer.
|
Check auto-negotiation configuration in the SCE 1000 and in peer. See "How to View the Gigabit Ethernet Counters" section on page 6-6.
|
Troubleshooting with the User Log
The user log is an ASCII file that can be viewed in any editor. It contains a record of system events, including startup, shutdown and errors. You can use the Logger to view the user log to determine whether or not the system is functioning properly, as well as for technical support purposes.
•
Logging System
•
Generating a File for Technical Support
Logging System
Events are logged to one of two log files. After a file reaches maximum capacity, the events logged in that file are then temporarily archived. New events are then automatically logged to the alternate log file. When the second log file reaches maximum capacity, the system then reverts to logging events to the first log file, thus overwriting the temporarily archived information stored in that file.
Basic operations include:
•
Copying the User Log to an External Source
•
How to Copy the User Log to an Internal Location
•
Viewing the User Log
•
Clearing the User Log
•
Viewing the User Log Counters
•
How to View the Non-volatile Logger Counters For Both the User Log File and the Debug Log File
•
How to View the Non-volatile Counter For the User-file-log Only
Copying the User Log to an External Source
You can view the log file by copying it to an external source. This command copies both log files to any external host running a FTP server.
Step 1
From the SCE 1000# prompt, type logger get user-log file-name ftp://username:password@ipaddress/pathand press Enter.
The SCE 1000# prompt appears.
How to Copy the User Log to an Internal Location
You can view the log file by copying it to disk. This command copies both log files to the local SCE platform disk.
Step 1
From the SCE 1000# prompt, type logger get user-log file-name target-file name and press Enter.
The SCE 1000# prompt appears.
Viewing the User Log
Note
This command is not recommended when the user log is large. Copy a large log to a file to view it (see Copying the User Log to an External Source.)
Step 1
From the SCE 1000# prompt, type more user-log and press Enter.
The user log appears, followed by the SCE 1000# prompt.
Clearing the User Log
You can clear the contents of the user log at any time. The user log contains important information regarding the functioning of the system. It is recommended that a copy be made before the log is cleared.
Step 1
From the SCE 1000# prompt, type clear logger device user-file-log and press Enter.
Step 2
The system asks Are you sure?
Step 3
Type y and press Enter.
The SCE 1000# prompt appears.
Viewing the User Log Counters
There are two types of log counters:
•
User log counters—Count the number of system events logged from the SCE platform last reboot.
•
Non-volatile counters—Are not cleared during boot time
Step 1
From the SCE 1000# prompt, type show logger device user-file-log counters and press Enter.
The logger lines information appears, followed by the SCE 1000# prompt.
How to View the Non-volatile Logger Counters For Both the User Log File and the Debug Log File
Step 1
From the SCE 1000# prompt, type show logger nv-counters and press Enter.
The non-volatile log counter information appears, followed by the SCE 1000# prompt.
How to View the Non-volatile Counter For the User-file-log Only
Step 1
From the SCE 1000# prompt, type show logger device user-file-log nv-counters and press Enter.
The user-file-log non-volatile log counter information appears, followed by the SCE 1000# prompt.
Generating a File for Technical Support
In order for technical support to be most effective, the user should provide them with the information contained in the system logs. Use the logger get support-file command to generate a support file for the use of Cisco technical support staff.
Step 1
From the SCE 1000# prompt, type logger get support-file filename and press Enter.
The support information file is created using the specified filename, and the SCE 1000# prompt appears. This operation may take some time.