Your software release may not support all the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
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:
Interfaces (Ethernet ports and so forth)
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 with user-defined intervals. By default, the health-monitoring test runs for every 30 seconds.
After you configure online diagnostics, you can manually start diagnostic tests or display the test results. You can also see which tests are configured for the switch or switch stack and the diagnostic tests that have already run.
Controller(config)# diagnostic schedule switch 3 test 1,2,4-6 on november 3 2006 23:10
Schedules on-demand diagnostic tests for a specific day and time.
The switchnumber keyword is supported only on stacking switches.
The range is from 1 to 4.
When specifying the tests to be scheduled, use these options:
name—Name of the test that appears in the
show diagnostic content command
test-id—ID number of the test that appears
in the show diagnostic content command
test-id-range—ID numbers of the tests that
appear in the show diagnostic content
all—All test IDs.
basic—Starts the basic on-demand diagnostic tests.
complete—Starts the complete test suite.
minimal—Starts the minimal bootup test suite.
non-disruptive—Starts the non-disruptive test suite.
per-port—Starts the per-port test suite.
You can schedule the tests as follows:
Daily—Use the dailyhh:mm parameter.
Specific day and time—Use the onmm dd yyyy hh:mm parameter.
Weekly—Use the weeklyday-of-week hh:mm parameter.
Configuring Health-Monitoring Diagnostics
You can configure health-monitoring diagnostic testing on a switch while it is connected to a live network. You can configure the execution interval for each health-monitoring test, enable the switch to generate a syslog message because of a test failure, and enable a specific test.
By default, health monitoring is disabled, but the switch generates a syslog message when a test fails.
This example shows how to start a diagnostic test by using the test name:
Controller# diagnostic start switch 2 test TestInlinePwrCtlr
This example shows how to start all of the basic diagnostic tests:
Controller# diagnostic start switch 1 test all
Configure a Health Monitoring Test: Example
This example shows how to configure a health-monitoring test:
Controller(config)# diagnostic monitor threshold switch 3 test 1 failure count 50Controller(config)# diagnostic monitor interval switch 3 test TestPortAsicRingLoopback
Schedule Diagnostic Test: Examples
This example shows how to schedule diagnostic testing for a specific day and time on a nonstacking switch:
Controller(config)# diagnostic schedule test TestPortAsicCam on december 3 2006 22:25
This example shows how to schedule diagnostic testing to occur weekly at a specific time on member switch 6 when this command is entered on switch:
Controller(config)# diagnostic schedule switch 6 test 1-4,7 weekly saturday 10:30
Displaying Online Diagnostics: Examples
This example shows how to display on demand diagnostic settings:
Controller# show diagnostic ondemand settings
Test iterations = 1
Action on test failure = continue
This example shows how to display diagnostic events for errors:
Controller# show diagnostic events event-type error
Diagnostic events (storage for 500 events, 0 events recorded)
Number of events matching above criteria = 0
No diagnostic log entry exists.
This example shows how to display the description for a diagnostic test:
Controller# show diagnostic description switch 1 test all
The GOLD packet Loopback test verifies the MAC level loopback
functionality. In this test, a GOLD packet, for which doppler
provides the support in hardware, is sent. The packet loops back
at MAC level and is matched against the stored packet. It is a non
This test verifies the temperature reading from the sensor is below the yellow
temperature threshold. It is a non-disruptive test and can be run as a health monitoring test.
This test verifies all fan modules have been inserted and working properly on the board
It is a non-disruptive test and can be run as a health monitoring test.
The PHY Loopback test verifies the PHY level loopback
functionality. In this test, a packet is sent which loops back
at PHY level and is matched against the stored packet. It is a
disruptive test and cannot be run as a health monitoring test.
The Scratch Register test monitors the health of application-specific
integrated circuits (ASICs) by writing values into registers and reading
back the values from these registers. It is a non-disruptive test and can
be run as a health monitoring test.
This test checks the PoE controller functionality. This is a disruptive test
and should not be performed during normal switch operation.
This test verifies the stack ring loopback functionality
in the stacking environment. It is a disruptive test and
cannot be run as a health monitoring test.
This test runs the exhaustive ASIC memory test during normal switch operation
NG3K utilizes mbist for this test. Memory test is very disruptive
in nature and requires switch reboot after the test.
This example shows how to display the boot up level:
Controller# show diagnostic bootup level
Current bootup diagnostic level: minimal
Additional References for Online Diagnostics
Online diagnostics commands
Platform-independent command references
Cisco IOS 15.3M&T Command References
Platform-independent configuration information
Cisco IOS 15.3M&T Configuration Guides
Standards and RFCs
All supported MIBs for this release.
To locate and download MIBs for selected platforms, Cisco IOS
releases, and feature sets, use Cisco MIB Locator found at the
The Cisco Support website provides extensive online resources,
including documentation and tools for troubleshooting and
resolving technical issues with Cisco products and technologies.
To receive security and technical information about your
products, you can subscribe to various services, such as the
Product Alert Tool (accessed from Field Notices), the Cisco
Technical Services Newsletter, and Really Simple Syndication
Access to most tools on the Cisco Support website requires a
Cisco.com user ID and password.