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
}