- Index
- Preface
- Overview
- Using the Command-Line Interface
- Assigning the Switch IP Address and Default Gateway
- Configuring Cisco IOS Configuration Engine
- Administering the Switch
- Configuring SDM Templates
- Configuring Switch-Based Authentication
- Configuring IEEE 802.1x Port-Based Authentication
- Configuring Web-Based Authentication
- Configuring Interface Characteristics
- Configuring Smartports Macros
- Configuring VLANs
- Configuring VTP
- Configuring Voice VLAN
- Configuring Private VLANs
- Configuring IEEE 802.1Q and Layer 2 Protocol Tunneling
- Configuring STP
- Configuring MSTP
- Configuring Optional Spanning-Tree Features
- Configuring Flex Links and the MAC Address-Table Move Update Feature
- Configuring DHCP and IP Source Guard
- Configuring Dynamic ARP Inspection
- Configuring IGMP Snooping and MVR
- Configuring Port-Based Traffic Control
- Configuring CDP
- Configuring LLDP, LLDP-MED, and Wired Location Service
- Configuring UDLD
- Configuring SPAN and RSPAN
- Configuring RMON
- Configuring System Message Logging
- Configuring SNMP
- Configuring Network Security with ACLs
- Configuring QoS
- Configuring EtherChannels and Layer 2 Trunk Failover
- Configuring IP Unicast Routing
- Configuring IPv6 Host Functions
- Configuring IPv6 MLD Snooping
- Configuring IPv6 ACLs
- Configuring HSRP and Enhanced Object Tracking
- Configuring Cisco IOS IP SLAs Operations
- Troubleshooting
- Configuring Online Diagnostics
- Supported MIBs
- Working with the Cisco IOS File System, Configuration Files, and Software Images
- Unsupported Commands in Cisco IOS Release 12.2(52)SE
Configuring Online Diagnostics
This chapter describes how to configure the online diagnostics on the switch.
For complete syntax and usage information for the commands used in this chapter, see the switch command reference at this URL:
http://www.cisco.com/en/US/products/ps6748/prod_command_reference_list.html
This chapter consists of these sections:
•Understanding How Online Diagnostics Work
•Running Online Diagnostic Tests
Understanding How Online Diagnostics Work
With online diagnostics, you can test and verify the hardware functionality of the switch while the switch is connected to a live network.
The online diagnostics contain packet switching tests that check different hardware components and verify the data path and the control signals.
The online diagnostics detect problems in these areas:
•Hardware components
•Interfaces (Ethernet ports and so forth)
•Solder joints
Online diagnostics are categorized as on-demand, scheduled, or health-monitoring diagnostics. On-demand diagnostics run from the CLI; scheduled diagnostics run at user-designated intervals or at specified times when the switch is connected to a live network; and health-monitoring runs in the background.
Scheduling Online Diagnostics
You can schedule online diagnostics to run at a designated time of day or on a daily, weekly, or monthly basis for a specific switch. Use the no form of this command to remove the scheduling.
Beginning in global configuration mode, use this command to schedule online diagnostics:
This example shows how to schedule diagnostic testing on a specific date and time for a specific switch:
Switch(config)# diagnostic schedule test 1,2,4-6 on january 3 2006 23:32
This example shows how to schedule diagnostic testing to occur weekly at a certain time for a specific switch:
Switch(config)# diagnostic schedule test 1,2,4-6 weekly friday 09:23
Configuring Health-Monitoring Diagnostics
You can configure health-monitoring diagnostic testing while the switch is connected to a live network. You can configure the execution interval for each health-monitoring test, whether or not to generate a system message upon a test failure, or to enable or disable an individual test. Use the no form of this command to disable testing.
Beginning in global configuration mode, use these commands to configure health-monitoring diagnostics:
Use the no diagnostic monitor interval test {test-id | test-id-range} global configuration command to change the interval to the default value or to zero. Use the no diagnostic monitor syslog command to disable generation of syslog messages when a health-monitoring test fails. Use the diagnostic monitor threshold test {test_id | test_id_range} failure count command to remove the failure threshold.
This example shows how to configure the specified test to run every 2 minutes:
Switch(config)#
diagnostic monitor interval test 1 00:02:00 0 1
This example shows how to set the failure threshold for test monitoring on a switch:
Switch(config)#
diagnostic monitor threshold test 1 failure count 50
This example shows how to enable the generation of a syslog message when any health monitoring test fails:
Switch(config)#
diagnostic monitor syslog
Running Online Diagnostic Tests
After you configure online diagnostics, you can start diagnostic tests or display the test results. You can also see which tests are configured for each switch and what diagnostic tests have already run.
These sections describe how to run online diagnostic tests after they have been configured:
•Starting Online Diagnostic Tests
•Displaying Online Diagnostic Tests and Test Results
Starting Online Diagnostic Tests
After you configure diagnostic tests to run on the switch or on individual switches, you can use start to begin a diagnostic test.
Beginning in global configuration mode, use this command to start an online diagnostic test:
|
|
---|---|
diagnostic start test {test-id | test-id-range | all | basic | non-disruptive} |
Start a diagnostic test on a specific switch. |
This example shows how to start a diagnostic test on a specific switch:
Switch# diagnostic start test 1
Switch#
06:27:50: %DIAG-6-TEST_RUNNING: Running TestPortAsicStackPortLoopback{ID=1} ...
06:27:51: %DIAG-6-TEST_OK: TestPortAsicStackPortLoopback{ID=1} has completed
successfully
Switch#
Displaying Online Diagnostic Tests and Test Results
You can display the online diagnostic tests that are configured for specific switches and check the results of the tests using the show commands.
To display the diagnostic tests that are configured for a switch and the test results, use these privileged EXEC commands:
This example shows how to display the online diagnostics that are configured on a switch:
Switch# show diagnostic content
Diagnostics test suite attributes:
B/* - Basic ondemand test / NA
P/V/* - Per port test / Per device test / NA
D/N/* - Disruptive test / Non-disruptive test / NA
S/* - Only applicable to standby unit / NA
X/* - Not a health monitoring test / NA
F/* - Fixed monitoring interval test / NA
E/* - Always enabled monitoring test / NA
A/I - Monitoring is active / Monitoring is inactive
R/* - Switch will reload after test list completion / NA
P/* - will partition stack / NA
Test Interval Thre-
ID Test Name attributes day hh:mm:ss.ms shold
==== ================================== ============ =============== =====
1) TestPortAsicStackPortLoopback B*N****A** 000 00:01:00.00 n/a
2) TestPortAsicLoopback B*D*X**IR* not configured n/a
3) TestPortAsicCam B*D*X**IR* not configured n/a
4) TestPortAsicRingLoopback B*D*X**IR* not configured n/a
5) TestMicRingLoopback B*D*X**IR* not configured n/a
6) TestPortAsicMem B*D*X**IR* not configured n/a
This example shows how to display the online diagnostic results for a switch:
Switch# show diagnostic result
Overall diagnostic result: PASS
Test results: (. = Pass, F = Fail, U = Untested)
1) TestPortAsicStackPortLoopback ---> .
2) TestPortAsicLoopback ------------> .
3) TestPortAsicCam -----------------> .
4) TestPortAsicRingLoopback --------> .
5) TestMicRingLoopback -------------> .
6) TestPortAsicMem -----------------> .
This example shows how to display the online diagnostic test schedule for a switch:
Switch# show diagnostic schedule
Current Time = 14:39:49 PST Tue Jul 5 2005
Schedule #1:
To be run daily 12:00
Test ID(s) to be executed: 1.