- Overview
- Assigning the Switch IP Address and Default Gateway
- Configuring Switch Boot Optimization
- Administering the Switch
- Configuring the Switch Alarms
- Configuring SDM Templates
- Configuring Smartports Macros
- Configuring LLDP and LLDP-MED
- Configuring Port-Based Traffic Control
- Configuring CDP
- Configuring SPAN and RSPAN
- Configuring RMON
- Configuring System Message Logging
- Configuring SNMP
- Configuring Embedded Event Manager
- Configuring Cisco IOS IP SLAs Operations
- Configuring Ethernet OAM, CFM, and E-LMI
- Configuring Online Diagnostics
- Supported MIBs
Configuring Online Diagnostics
This chapter describes how to configure the online diagnostics on the Cisco Industrial Ethernet 2000U Series (IE 2000U) and Connected Grid Switches, hereafter referred to as switch .
NoteFor complete syntax and usage information for the commands used in this chapter, see the documents listed in the“Related Documents” section.
Information About Online Diagnostics
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 monitor different hardware components and verify the data path and the control signals.
The online diagnostics detect problems in these areas:
Table 18-1 lists the diagnostic test IDs and names. For information about test attributes, see the output from the show diagnostic content privileged EXEC command.
|
|
---|---|
Online diagnostics are categorized as on-demand, scheduled, or health-monitoring diagnostics.
Prerequisites
Before you enable any online diagnostics tests, enable console logging to see all warning messages. See Chapter13, “Configuring System Message Logging”
Guidelines and Limitations
- We recommend that when you are running disruptive tests that you only run the tests when connected through console. When disruptive tests are complete a warning message on the console recommends that you reload the system to return to normal operation: strictly follow this warning.
- While tests are running, all ports are shut down as a stress test is being performed with looping ports internally and external traffic might affect the test results. The switch must be rebooted to bring the switch to normal operation. When you issue the command to reload the switch, the system will ask you if the configuration should be saved. Do not save the configuration.
- If you are running the tests on other modules, after the test is initiated and complete, you must reset the module.
- After starting the tests, you cannot stop the testing process.
Default Settings
By default, health monitoring is disabled. When enabled, the switch generates a syslog message when a test fails.
Configuring Online Diagnostics
You must configure the failure threshold and the interval between tests before enabling diagnostic monitoring.
Scheduling Online Diagnostics
You can schedule online diagnostics to run at a designated time of day or on a daily, weekly, or monthly basis. Use the no form of this command to remove the scheduling. For detailed information about this command, see the Cisco IOS Configuration Fundamentals Command Reference, Release 15.2M&T .
BEFORE YOU BEGIN
Review the “Information About Online Diagnostics” section and “Guidelines and Limitations” section.
DETAILED STEPS
|
|
|
---|---|---|
diagnostic schedule test { name | test-id | test-id-range | all | basic | non-disruptive } { daily hh : mm | on mm dd yyyy hh : mm | weekly day-of-week hh : mm } |
Schedule on-demand diagnostic tests for a specific day and time. When specifying the tests to be scheduled, use these options:
|
|
Use the no diagnostic schedule test { name | test-id | test-id-range | all | basic | non-disruptive } { daily hh : mm | on mm dd yyyy hh : mm | weekly day-of-week hh : mm } global configuration command to remove the scheduled tests.
EXAMPLE
This example shows how to schedule diagnostic testing for a specific day and time and verify the schedule:
At the scheduled time, the switch runs the test:
Configuring Health-Monitoring Diagnostics
You can configure health-monitoring diagnostic testing while a switch 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. When enabled, the switch generates a syslog message when a test fails.
BEFORE YOU BEGIN
Review the “Information About Online Diagnostics” section and “Guidelines and Limitations” section.
DETAILED STEPS
|
|
|
---|---|---|
diagnostic monitor interval test { name | test-id | test-id-range | all } hh:mm:ss milliseconds day |
Configure the health-monitoring interval of the specified tests. Specify the tests by using one of these parameters:
|
|
(Optional) Configure the switch to generate a syslog message when a health-monitoring test fails. |
||
diagnostic monitor threshold test { name | test-id | test-id-range | all } failure count count |
(Optional) Set the failure threshold for the health-monitoring tests. Specify the tests by using one of these parameters:
|
|
diagnostic monitor test { name | test-id | test-id-range | all } |
Enable the specified health-monitoring tests. Specify the tests by using one of these parameters:
|
|
show diagnostic { content | post | result | schedule | status | switch } |
Display the online diagnostic test results and the supported test suites. See the “Displaying Online Diagnostic Tests and Results” section for more information. |
|
To disable diagnostic testing and return to the default settings, use these commands:
- To disable online diagnostic testing, use the no diagnostic monitor test { name | test-id | test-id-range | all } global configuration command.
- To return to the default health-monitoring interval, use the no diagnostic monitor interval test { name | test-id | test-id-range | all } global configuration command.
- To configure the switch to not generate a syslog message when the health-monitoring test fails, use the no diagnostic monitor syslog global configuration command.
- To return to the default failure threshold, use the no diagnostic monitor threshold test { name | test-id | test-id-range | all } failure count count global configuration command.
EXAMPLE
This example shows how to configure a health-monitoring test:
Switch(config)#
diagnostic monitor threshold test 1 failure count 50
Running Online Diagnostic Tests
After you configure online diagnostics, you can manually start diagnostic tests or display the test results. You can also see the tests configured for the switch and the tests that have already run.
Starting Online Diagnostic Tests
NoteAfter starting the tests, you cannot stop the testing process.
BEFORE YOU BEGIN
- Configure the diagnostics tests as described in the Configuring Online Diagnostics.
- Review the “Guidelines and Limitations” section.
DETAILED STEPS
|
|
---|---|
diagnostic start test { name | test-id | test-id-range | all | basic | non-disruptive } |
Specify the tests by using one of these parameters:
|
EXAMPLE
This example shows how to start a diagnostic test by using the test name:
This example shows how to start a non-disruptive diagnostic test:
This example shows how to start all of the basic diagnostic tests:
Displaying Online Diagnostic Tests and Results
|
|
---|---|
show diagnostic result [ detail | test { name | test-id | test-id-range | all [ detail ]}] |
|
Displays the POST results. (The output is the same as the show post command output.) |
EXAMPLE
This is an example of the output from the show diagnostic result command:
This is an example of the output from the show diagnostic post command:
For more examples of other show diagnostic command outputs, see the “Examples” section of the show diagnostic command in the Cisco IOS Configuration Fundamentals Command Reference, Release 15.2M&T .
Configuration Example
This example shows how to schedule diagnostic testing for a specific day and time and verify the schedule:
At the scheduled time, the switch runs the test:
This example shows how to configure a health-monitoring test:
Switch(config)#
diagnostic monitor threshold test 1 failure count 50
Related Documents
Feature History
|
|
---|---|