21-8
Catalyst 6500 Series Switch Software Configuration Guide—Release 8.7
OL-8978-04
Chapter 21 Configuring GOLD
Configuring Online Diagnostics
• After running the test:
–
For supervisor engines—Reboot the switch but do not save the configuration while rebooting
because the configuration was changed during the test.
–
For other modules—Power cycle the modules. After the modules come online, reenable the
health-monitor tests that were disabled.
Configuring Diagnostics Operations
You can specify that the on-demand online diagnostics continue to run until a configurable number of
failures occur by entering the continue failure_limit keyword. The failure_limit range is 0 to
65534 failures. You can specify that the on-demand online diagnostics stop running when a single failure
occurs by entering the stop keyword. You can specify that an on-demand test be run multiple times by
entering the iterations number_of_iterations keyword. The number_of_iterations range is 1 to 999.
The complete syntax for these commands is as follows:
set diagnostic ondemand action-on-failure [continue failure_limit | stop]
set diagnostic ondemand iterations number_of_iterations
Configuring Online Diagnostic Health-Monitoring Tests
You can configure health-monitoring diagnostic testing on specified modules while the switch is
connected to a live network. You can specify the execution interval for each health-monitoring test,
whether or not to generate a system message upon test failure, or whether an individual test should be
enabled or disabled.
The disruptive tests are disabled by default. A set number of nondisruptive tests (not all) are enabled by
default. Use the show diagnostic content module mod_list command to determine which tests are
disruptive (D) and nondisruptive (N) by checking the “Attributes” column. Use this information for
configuring additional health-monitoring tests. We recommend that you use only nondisruptive tests for
health monitoring.
To configure online diagnostic health-monitoring tests, perform this task in privileged mode:
This example shows how to specify that the online diagnostic health-monitoring tests (test 18) be run on
module 7 at 12:12:12 and 100 milliseconds every 10 days:
Console> (enable) set diagnostic monitor interval module 7 test 18 12:12:12 100 10
Diagnostic monitor interval set at 12:12:12 100 10 for module 7 test 18
Task Command
Step 1
Specify the online diagnostic monitoring interval. set diagnostic monitor interval module
mod_num test {all | test_ID_num | test_list}
hh:mm:ss
1
1. For the interval keyword, the range of milliseconds that can be specified is 0 to 999 and the number of days specified is 0 to 20.
Step 2
(Optional) Enable health-monitoring diagnostic
tests.
set diagnostic monitor module mod_num test
{test-id | test-id-range | all}
Step 3
Enable syslog generation when a test fails. set diagnostic monitor syslog
Step 4
Display the online diagnostic monitoring
configuration.
show diagnostic content module {mod_list | all}