Information About Configuring Online Diagnostics
With online diagnostics, you can test and verify the hardware functionality of a device while the device is connected to a live network. Online diagnostics contains packet-switching tests that check different hardware components and verify the data path and control signals.
Online diagnostics detects 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 device is connected to a live network; and health-monitoring runs in the background with user-defined intervals. The health-monitoring test runs every 90, 100, or 150 seconds based on the test.
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 device and the diagnostic tests that have already run.
Generic Online Diagnostics (GOLD) Tests
Note |
|
The following sections provide information about GOLD tests.
DiagGoldPktTest
This GOLD packet loopback test verifies the MAC-level loopback functionality. In this test, a GOLD packet is sent, for which Unified Access Data Plane (UADP) ASIC provides support in the hardware. The packet loops back at the MAC-level and is matched against the stored packet.
Attribute |
Description |
---|---|
Disruptive or Nondisruptive |
Nondisruptive. |
Recommendation |
Run this on-demand test as per requirement. |
Default |
Off. |
Intitial release |
Cisco IOS XE Everest 16.6.1. |
Corrective action |
– |
Hardware support |
Supervisors. |
DiagThermalTest
This test verifies the temperature reading from a device sensor.
Attribute |
Description |
---|---|
Disruptive or Nondisruptive |
Nondisruptive |
Recommendation |
Do not disable. Run this as an on-demand test, and as a health-monitoring test if the administrator is down. |
Default |
On. |
Intitial release |
Cisco IOS XE Everest 16.6.1. |
Corrective action |
– |
Hardware support |
Supervisors. |
DiagFanTest
This test verifies if all the fan modules that have been inserted are working properly on the board.
Attribute |
Description |
---|---|
Disruptive or Nondisruptive |
Nondisruptive |
Recommendation |
Run this as a health-monitoring test in case you experience any problem with the fan module. |
Default |
On. |
Intitial release |
Cisco IOS XE Everest 16.6.1. |
Corrective action |
– |
Hardware support |
Supervisors. |
DiagPhyLoopbackTest
This PHY loopback test verifies the PHY-level loopback functionality. In this test, a packet, which loops back at the PHY level and is matched against the stored packet, is sent. It cannot be run as a health-monitoring test.
Note |
In certain cases when this test is run on-demand, ports are moved to the error-disabled state. In such cases, use the shut and no shut command in interface configuration mode to reenable these ports. |
Attribute |
Description |
---|---|
Disruptive or Nondisruptive |
Disruptive. |
Recommendation |
If the link to the external connector is down, run this on-demand test to check the health of the link. |
Default |
Off. |
Intitial release |
Cisco IOS XE Everest 16.6.1. |
Corrective action |
– |
Hardware support |
Supervisors. |
DiagScratchRegisterTest
This Scratch Register test monitors the health of ASICs by writing values into registers and reading back the values from these registers.
Attribute |
Description |
---|---|
Disruptive or Nondisruptive |
Nondisruptive. |
Recommendation |
Do not disable. Run this test if the task of writing values to the registers fails. This can be run as a health-monitoring test and also as an on-demand test. |
Default |
On. |
Intitial release |
Cisco IOS XE Everest 16.6.1. |
Corrective action |
– |
Hardware support |
Supervisors. |
DiagPoETest
This test checks the PoE controller functionality. Do not perform this test during normal switch operation.
Attribute |
Description |
---|---|
Disruptive or Nondisruptive |
Nondisruptive. |
Recommendation |
Run this test if you experience PoE controller issues with a port. This can be run only as an on-demand test. |
Default |
Off. |
Intitial release |
Cisco IOS XE Everest 16.6.1. |
Corrective action |
– |
Hardware support |
Linecards. |
DiagStackCableTest
This test verifies the stack-ring loopback functionality in the stacking environment. It cannot be run as a health-monitoring test.
Attribute |
Description |
---|---|
Disruptive or Nondisruptive |
Disruptive. |
Recommendation |
Run this test to verify the stack-ring loopback functionality in the stacking environment. |
Default |
Off. |
Intitial release |
Cisco IOS XE Everest 16.6.1. |
Corrective action |
If the test fails, check the stack cables and connectors. |
Hardware support |
Supervisors. |
DiagMemoryTest
This exhaustive ASIC memory test is run during normal switch operation. The switch utilizes memory built-in self-test for this test. The memory test requires switch reboot after the test.
Attribute |
Description |
---|---|
Disruptive or Nondisruptive |
Very disruptive. |
Recommendation |
Run this on-demand test only if you experience memory-related problems in the system. Do not run this test if you do not want to reload the Supervisor engine that is under test. |
Default |
Off. |
Intitial release |
Cisco IOS XE Everest 16.6.1. |
Corrective action |
– |
Hardware support |
Supervisors. |
TestUnusedPortLoopback
This test periodically verifies the data path between the supervisor module and network ports of a module during runtime, to determine if any incoming network interface ports are locked. In this test, a Layer 2 packet is flooded on to the VLAN associated with the test port and the inband port of the Supervisor engine. The packet loops back into the test port and returns to the Supervisor engine on the same VLAN. This test runs only on unused (admin down, that is, the ports are shut down) network ports irrespective of whether a cable is connected or not, and completes within a millisecond per port. This test substitutes the lack of a nondisruptive loopback test in current ASICs, and runs every 60 seconds.
Attribute |
Description |
---|---|
Disruptive or Nondisruptive |
Nondisruptive. |
Recommendation |
Do not disable. This test is automatically disabled during CPU usage spikes to maintain accuracy. |
Default |
On. |
Intitial release |
Cisco IOS XE Fuji 16.9.1. |
Corrective action |
Displays a syslog message indicating that a port has failed. In modules other than Supervisor engines, if all port groups fail (for example, at least one port per port ASIC fails more than the failure threshold for all port ASICs), the default action is to reset the module and power down the module after two resets. |
Hardware support |
Supervisors. |
TestPortTxMonitoring
This test periodically monitors data-path traffic in the transmitted direction of each network port that is physically connected to a device with status as UP. This test is completed within a millisecond per port. This test also monitors the transmit counters at the ASIC level to verify that the ports are not stuck. The test displays syslog messages, and users can take corrective actions using the Cisco IOS Embedded Event Manager (EEM).
Configure the time interval and threshold by entering the diagnostic monitor interval and diagnostic monitor threshold commands, respectively. The test leverages the Cisco Discovery Protocol that transmits packets. The test runs every 75 seconds, and the failure threshold is set to 5 secs by default.
Attribute |
Description |
---|---|
Disruptive or Nondisruptive |
Nondisruptive. |
Recommendation |
Do not disable. |
Default |
On. |
Intitial release |
Cisco IOS XE Everest 16.9.1. |
Corrective action |
Displays a syslog message indicating that a port has failed. |
Hardware support |
Supervisors. |