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.
TestGoldPktLoopback
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 and linecards. |
TestFantray
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. |
TestPhyLoopback
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.
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 and linecards. |
TestThermal
This test verifies 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 and linecards. |
TestScratchRegister
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 and linecards. |
TestPoe
This test checks the PoE controller functionality.
Attribute |
Description |
---|---|
Disruptive or Nondisruptive |
Nondisruptive. |
Recommendation |
Run this as a PoE health-monitoring test. |
Default |
Off. |
Intitial release |
Cisco IOS XE Everest 16.6.1. |
Corrective action |
– |
Hardware support |
Linecards. |
TestUnusedPortLoopback
This test verifies the PHY-level loopback functionality for admin-down ports. In this test, a packet is sent which loops back at PHY level and is matched against the stored packet.
Attribute |
Description |
---|---|
Disruptive or Nondisruptive |
Nondisruptive. |
Recommendation |
This can be run as a health-monitoring test and also as an on-demand test. |
Default |
Off. |
Intitial release |
Cisco IOS XE Fuji 16.9.1. |
Corrective action |
Displays a syslog message if the test fails for any port. |
Hardware support |
Supervisors and linecards. |
TestPortTxMonitoring
This test monitors the transmit counters of a connected interface. It verifies if the connected port is able to send the packets or not. This test runs every 150 seconds.
Attribute |
Description |
---|---|
Disruptive or Nondisruptive |
Nondisruptive. |
Recommendation |
Do not disable. This can be run as a health-monitoring test and also as an on-demand test. |
Default |
On. |
Intitial release |
Cisco IOS XE Fuji 16.9.1. |
Corrective action |
Displays a syslog message if the test fails for any port. |
Hardware support |
Supervisors and linecards. |