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, for which Unified Access Data Plane (UADP) ASIC provides support in hardware, is sent. 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 Gibraltar 16.11.1. |
Corrective action |
Displays a syslog message if the test fails for a port. |
Hardware support |
All line cards. Not supported on supervisor engines. |
TestOBFL
This test verifies the on-board failure logging capabilities. During this test, a diagnostic message is logged to the Onboard Failure Logging (OBFL).
Attribute |
Description |
---|---|
Disruptive or Nondisruptive |
Nondisruptive. |
Recommendation |
Run this on-demand test as per requirement. |
Default |
Off. |
Intitial release |
Cisco IOS XE Gibraltar 16.11.1. |
Corrective action |
Displays a syslog message if the test fails for a port. |
Hardware support |
All line cards and supervisor engines. |
TestFantray
This test verifies if a fan tray has been inserted and is working properly on the board. This test runs every 100 seconds.
Attribute |
Description |
---|---|
Disruptive or Nondisruptive |
Nondisruptive |
Recommendation |
Do not disable. This can be run as a health-monitoring test and as an on-demand test. |
Default |
On. |
Intitial release |
Cisco IOS XE Gibraltar 16.11.1. |
Corrective action |
Displays a syslog message if the fan tray is not present, or if any of the fans fail. |
Hardware support |
Only supervisor engines. |
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 |
Run this as an on-demand test as per requirement. |
Default |
Off. |
Intitial release |
Cisco IOS XE Gibraltar 17.1.1. |
Corrective action |
Displays a syslog message if the test fails for any port. |
Hardware support |
Only on the C9600-LC-48TX line card. |
TestThermal
This test verifies the temperature reading from a device sensor if it is below the yellow temperature threshold. This test runs every 90 seconds.
Attribute |
Description |
---|---|
Disruptive or Nondisruptive |
Nondisruptive |
Recommendation |
Do not disable. Run this as an on-demand test and a health-monitoring test. |
Default |
On. |
Intitial release |
Cisco IOS XE Gibraltar 16.11.1. |
Corrective action |
Displays a syslog message if the test fails. |
Hardware support |
All line cards and supervisor engines. |
TestScratchRegister
This Scratch Register test monitors the health of ASICs by writing values into registers and reading back the values from these registers. This test runs every 90 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 Gibraltar 16.11.1. |
Corrective action |
Displays a syslog message if the test fails. |
Hardware support |
Only supervisor engines. |
TestConsistencyCheck
This test checks if the hardware programming is correct. It checks with the forwarding object manager to identify incomplete entries or long-pending configurations to hardware. This test runs every 90 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 Gibraltar 17.2.1. |
Corrective action |
Displays a syslog message if the test fails. |
Hardware support |
Only supervisor engines. |
TestPortTxMonitoring
This test monitors the transmit counters of a connected interface. It verifies if a connected port is able to send 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 Gibraltar 16.11.1. |
Corrective action |
Displays a syslog message if the test fails for a port. |
Hardware support |
All line cards. Not supported on supervisor engines. |