Login
- Table of Contents
-
- 12-Network Management and Monitoring Command Reference
- 00-Preface
- 01-System maintenance and debugging commands
- 02-NQA commands
- 03-NTP commands
- 04-SNMP commands
- 05-NETCONF commands
- 06-RMON commands
- 07-EAA commands
- 08-Process monitoring and maintenance commands
- 09-sFlow commands
- 10-Mirroring commands
- 11-Information center commands
- 12-GOLD commands
- 13-Packet capture commands
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 12-GOLD commands | 81.06 KB |
GOLD commands
diagnostic event-log size
Use diagnostic event-log size to configure the maximum number of GOLD log entries.
Use undo diagnostic event-log size to restore the default.
Syntax
diagnostic event-log size number
undo diagnostic event-log size
Default
GOLD can save up to 512 log entries.
Views
System view
Predefined user roles
network-admin
Parameters
number: Specifies the maximum number of log entries, in the range of 0 to 1024.
Usage guidelines
If you specify a number smaller than the number of existing log entries, the system automatically deletes the oldest excess entries.
When the number of GOLD log entries exceeds the configured log buffer size, the system automatically deletes the oldest excess entries.
Examples
# Configure the maximum number of log entries as 600.
<Sysname> system-view
[Sysname] diagnostic event-log size 600
diagnostic monitor enable
Use diagnostic monitor enable to enable monitoring diagnostics.
Use undo diagnostic monitor enable to disable monitoring diagnostics.
Syntax
diagnostic monitor enable slot slot-number-list [ test test-name ]
undo diagnostic monitor enable slot slot-number-list [ test test-name ]
Default
The default enabling status varies by monitoring diagnostic test. To view the status of diagnostic tests, use the display diagnostic content command.
Views
System view
Predefined user roles
network-admin
Parameters
slot slot-number-list: Specifies a space-separated list of up to seven slot number items. An item can specify an IRF member device by its member ID or specify a PEX by its virtual slot number. An item can also specify a range of IRF member devices or PEXs in the form of start-slot-number to end-slot-number. The end slot number must be equal to or greater than the start slot number.
test test-name: Specifies a test by its name, a case-insensitive string of 1 to 31 characters. If you do not specify this option, the command enables all monitoring diagnostic tests on the specified IRF member devices or PEXs.
Usage guidelines
Monitoring diagnostics enable the system to periodically run diagnostic tests to detect hardware faults and record test results. Monitoring diagnostics execute only non-disruptive tests.
Disruptive diagnostic tests that are being executed affect device operation or even disable certain functions, but non-disruptive diagnostic tests do not.
The system automatically executes enabled monitoring diagnostic tests after the device starts. Use the diagnostic monitor enable command to enable diagnostic tests that are disabled by default.
Examples
# Enable test HGMonitor on the specified slot.
<Sysname> system-view
[Sysname] diagnostic monitor enable slot 1 test HGMonitor
Related commands
diagnostic monitor interval
diagnostic monitor interval
Use diagnostic monitor interval to configure an execution interval for monitoring diagnostic tests.
Use undo diagnostic monitor interval to restore the default.
Syntax
diagnostic monitor interval slot slot-number-list [ test test-name ] time time
undo diagnostic monitor interval slot slot-number-list [ test test-name ]
Default
The default execution interval varies by monitoring diagnostic test. To view the execution interval of diagnostic tests, use the display diagnostic content command.
Views
System view
Predefined user roles
network-admin
Parameters
slot slot-number-list: Specifies a space-separated list of up to seven slot number items. An item can specify an IRF member device by its member ID or specify a PEX by its virtual slot number. An item can also specify a range of IRF member devices or PEXs in the form of start-slot-number to end-slot-number. The end slot number must be equal to or greater than the start slot number.
test test-name: Specifies a test by its name, a case-insensitive string of 1 to 31 characters. If you do not specify this option, the command applies to all monitoring diagnostic tests on the specified IRF member devices or PEXs.
time: Sets an execution interval in the form of hh:mm:ss. The value range for the hh argument is 0 to 23. The value range for the mm and ss arguments is both 0 to 59. If you specify only the hh argument, you can omit the mm and ss segments. If you specify only the hh and mm arguments, you can omit the ss segment. For example, to specify 01:00:00, you can enter 1.
Usage guidelines
Use this command to configure the interval at which the system automatically executes enabled monitoring diagnostic tests.
The configured interval cannot be smaller than the minimum execution interval of the tests. Use the display diagnostic content verbose command to view the minimum execution interval of the tests.
Examples
# Set the execution interval to 1 minute for test HGMonitor on the specified slot.
<Sysname> system-view.
[Sysname] diagnostic monitor interval slot 1 test HGMonitor time 00:01:00
Related commands
· diagnostic monitor enable
· display diagnostic content
diagnostic ondemand failure
Use diagnostic ondemand failure to set the maximum number of failed on-demand diagnostic tests.
Use undo diagnostic ondemand failure to restore the default.
Syntax
diagnostic ondemand failure failure-number
undo diagnostic ondemand failure
Default
The maximum number of failed on-demand diagnostic tests is not specified.
Views
User view
Predefined user roles
network-admin
Parameters
failure-number: Specifies the maximum number of failed tests, in the range of 1 to 999.
Usage guidelines
After you use the diagnostic ondemand start command to enable on-demand diagnostics, you can stop the diagnostic tests by using any of the following commands:
· Use the diagnostic ondemand stop command to immediately stop the tests.
· Use the diagnostic ondemand repeating command to configure the number of executions for the tests. The system stops executing the tests when the threshold is reached.
· Use the diagnostic ondemand failure command to configure the maximum number of failed tests. The system stops a test when the number of failures reaches the configured threshold and the test is not executed as many times as specified.
Use this command to configure the maximum number of failed tests for diagnostic tests to be enabled. This command does not survive a device reboot.
Examples
# Configure the maximum number of failed tests as 5 for all on-demand diagnostic tests.
<Sysname> diagnostic ondemand failure 5
Related commands
· diagnostic ondemand repeating
· diagnostic ondemand start
· display diagnostic ondemand configuration
diagnostic ondemand repeating
Use diagnostic ondemand repeating to configure the number of executions for on-demand diagnostic tests.
Use undo diagnostic ondemand repeating to restore the default.
Syntax
diagnostic ondemand repeating repeating-number
undo diagnostic ondemand repeating
Default
The default number of executions is 1.
Views
User view
Predefined user roles
network-admin
Parameters
repeating-number: Specifies the number of executions for on-demand diagnostic tests, in the range of 1 to 999.
Usage guidelines
Use this command to configure the number of executions for diagnostic tests to be enabled. This command does not survive a device reboot.
Do not specify a number smaller than the configured number of failed tests.
Examples
# Configure the number of executions as 2 for all on-demand diagnostic tests.
<Sysname> diagnostic ondemand repeating 2
Related commands
· diagnostic ondemand failure
· diagnostic ondemand start
· display diagnostic configuration
diagnostic ondemand start
Use diagnostic ondemand start to enable on-demand diagnostics.
Syntax
diagnostic ondemand start slot slot-number-list test { non-disruptive | test-name } [ para parameters ]
Default
All on-demand diagnostic tests need to be manually enabled.
Views
User view
Predefined user roles
network-admin
Parameters
slot slot-number-list: Specifies a space-separated list of up to seven slot number items. An item can specify an IRF member device by its member ID or specify a PEX by its virtual slot number. An item can also specify a range of IRF member devices or PEXs in the form of start-slot-number to end-slot-number. The end slot number must be equal to or greater than the start slot number.
test-name: Specifies a test by its name, a case-insensitive string of 1 to 31 characters.
non-disruptive: Executes all non-disruptive diagnostic tests.
para parameters: Specifies an extended parameter. It is not supported.
Usage guidelines
On-demand diagnostics allow you to manually execute certain diagnostic tests. These tests are known as on-demand diagnostic tests.
You can configure the number of executions and the maximum number of failed tests for on-demand diagnostic tests at the CLI. When either threshold is reached, the system immediately stops executing the tests.
Examples
# Start all non-disruptive diagnostic tests on the specified slot.
<Sysname> diagnostic ondemand start slot 1 test non-disruptive
Related commands
· diagnostic ondemand failure
· diagnostic ondemand repeating
diagnostic ondemand stop
Use diagnostic ondemand stop to stop on-demand diagnostic tests.
Syntax
diagnostic ondemand stop slot slot-number-list test { non-disruptive | test-name }
Views
User view
Predefined user roles
network-admin
Parameters
slot slot-number-list: Specifies a space-separated list of up to seven slot number items. An item can specify an IRF member device by its member ID or specify a PEX by its virtual slot number. An item can also specify a range of IRF member devices or PEXs in the form of start-slot-number to end-slot-number. The end slot number must be equal to or greater than the start slot number.
test-name: Specifies a test by its name, a case-insensitive string of 1 to 31 characters.
non-disruptive: Executes all non-disruptive diagnostic tests.
Usage guidelines
You can configure the number of executions and the maximum number of failed tests for on-demand diagnostic tests at the CLI. When either threshold is reached, the system immediately stops executing the tests.
Examples
# Stop all non-disruptive diagnostic tests on the specified slot.
<Sysname> diagnostic ondemand stop slot 1 test non-disruptive
Related commands
· diagnostic ondemand failure
· diagnostic ondemand repeating
diagnostic simulation
Use diagnostic simulation to simulate diagnostic tests.
Use undo diagnostic simulation to restore the default.
Syntax
diagnostic simulation slot slot-number-list test test-name { failure | random-failure | success }
undo diagnostic simulation slot slot-number-list test test-name
Default
All diagnostic tests are executed instead of simulated.
Views
User view
Predefined user roles
network-admin
Parameters
slot slot-number-list: Specifies a space-separated list of up to seven slot number items. An item can specify an IRF member device by its member ID or specify a PEX by its virtual slot number. An item can also specify a range of IRF member devices or PEXs in the form of start-slot-number to end-slot-number. The end slot number must be equal to or greater than the start slot number.
test-name: Specifies a test by its name, a case-insensitive string of 1 to 31 characters.
failure: Configures the system to generate failure results.
random-failure: Configures the system to randomly generate results.
success: Configures the system to generate success results.
Usage guidelines
Test simulation is used to verify GOLD frame functionality. After you execute this command, the system simulates the specified test if the execution requirements for the test are met. The test is not actually executed and does not trigger hardware correcting actions.
This command only applies to monitoring diagnostic tests and on-demand diagnostic tests.
Examples
# Simulate test HGMonitor as failed on the specified slot.
<Sysname> diagnostic simulation slot 1 test HGMonitor failure
Related commands
display diagnostic simulation
display diagnostic content
Use display diagnostic content to display information about diagnostic tests.
Syntax
display diagnostic content [ slot slot-number ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device by its member ID or specifies a PEX by its virtual slot number. If you do not specify an IRF member device or PEX, the command applies to all IRF member devices and PEXs.
verbose: Displays detailed information about diagnostic tests. If you do not specify this keyword, the command displays brief information about the diagnostic tests.
Examples
# Display brief information about all diagnostic tests on the specified slot.
<Sysname> display diagnostic content slot 1
Diagnostic test suite attributes:
#B/*: Bootup test/NA
#O/*: Ondemand test/NA
#M/*: Monitoring test/NA
#D/*: Disruptive test/Non-disruptive test
#P/*: Per port test/NA
#A/I/*: Monitoring test is active/Monitoring test is inactive/NA
Slot 1 :
Name Attributes Interval
HGMonitor **M*PI 00:00:10
# Display detailed information about all diagnostic tests on the specified slot.
<Sysname> display diagnostic content slot 1 verbose
Diagnostic test suite attributes:
#B/*: Bootup test/NA
#O/*: Ondemand test/NA
#M/*: Monitoring test/NA
#D/*: Disruptive test/Non-disruptive test
#P/*: Per port test/NA
#A/I/*: Monitoring test is active/Monitoring test is inactive/NA
Slot 1 :
Test name : HGMonitor
Test attributes : **M*PI
Test interval : 00:00:10
Min interval : 00:00:10
Correct-action : -NA-
Description : A Real-time test, disabled by default that checks link status between ports.
exec : -NA-
Table 1 Command output
|
Field |
Description |
|
B/* |
Boot-up/Not boot-up. |
|
O/* |
On-demand/Not on-demand. |
|
M/* |
Monitoring/Not monitoring. |
|
D/* |
Disruptive/Non-disruptive. |
|
P/* |
Port-related/Not port-related. |
|
A/I/* |
Active and monitoring/Inactive and monitoring/Not monitoring. |
|
Test name |
Name of the diagnostic test. |
|
Test attributes |
Attributes of the diagnostic test. The characters from left to right indicate whether or not the test is boot-up, on-demand, monitoring, disruptive, port-related, or active. The asterisks (*) indicate that the test does not have the corresponding attributes. |
|
Test interval |
Execution interval for the test. If the execution interval for the test is not set, –NA–is displayed. |
|
Min interval |
Minimum execution interval for the test. If the test does not have a minimum execution interval, –NA–is displayed. |
|
Correct-action |
Correcting action triggered by failure of the test. |
|
Description |
Description for the test. |
|
exec |
Path for the Tcl script bound to the diagnostic test. If the diagnostic test is not bound to any Tcl script, –NA–is displayed. |
display diagnostic event-log
Use display diagnostic event-log to display GOLD log entries.
Syntax
display diagnostic event-log [ error | info ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
error: Displays all error log entries.
info: Displays all log entries except error log entries.
Usage guidelines
If you do not specify the error and info keywords, the command displays all GOLD log entries.
The system records information about test execution in the form of logs. A log entry contains test name, execution time, test result, and failure cause. Log entries are generated for every execution. To reduce the burden of the information center, GOLD logs are not sent to the information center.
GOLD logs are cleared when the device starts or when a master/subordinate switchover occurs.
Examples
# Display all GOLD log entries.
<Sysname> display diagnostic event-log
Event: E_INFO, Wed Jan 7 11:39:53:314 2014, -Slot=1-Cpu=0 TestName->SystemMgmtBus, Event_INFO: Result->Success.
Event: E_ERROR, Wed Jan 7 11:39:53:314 2014, -Slot=1-Cpu=0 TestName->SystemMgmtBus, Event_INFO: Result->Failure Reason->The port 9 is offline.
display diagnostic ondemand configuration
Use display diagnostic ondemand configuration to display configurations of on-demand diagnostic tests.
Syntax
display diagnostic ondemand configuration
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display the number of executions and the number of failed tests configured for on-demand diagnostic tests.
<Sysname> display diagnostic ondemand configuration
Maximum test-repeating times: 4
Maximum test-failure times: 1
# Display the number of executions configured for on-demand diagnostic tests.
<Sysname> display diagnostic ondemand configuration
Maximum test-repeating times: 4
Maximum test-failure times: Not configured
Related commands
· diagnostic ondemand failure
· diagnostic ondemand repeating
display diagnostic result
Use display diagnostic result to display test results.
Syntax
display diagnostic result [ slot slot-number [ test test-name ] ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device by its member ID or specifies a PEX by its virtual slot number. If you do not specify an IRF member device or PEX, the command applies to all IRF member devices and PEXs.
test test-name: Specifies a test by its name, a case-insensitive string of 1 to 31 characters. If you do not specify this option, the command applies to all diagnostic tests on the specified IRF member devices or PEXs.
verbose: Displays detailed test results for diagnostic tests that are enabled or executed. (Statistics are not included.) If you do not specify this parameter, the command displays brief test results for the diagnostic tests.
Examples
# Display brief test results for all diagnostic tests on the specified slot.
<Sysname> display diagnostic result slot 1
Slot 1 :
Name Run count Failure count Last result
HGMonitor 10 3 Failure
# Display detailed test results for all diagnostic tests.
<Sysname> display diagnostic result verbose
Slot 1 :
Test name : HGMonitor
Total run count : 10
Total failure count : 3
Consecutive failure count: 3
Last execution time : Tue Oct 30 10:36:55 2012
First failure time : Tue Oct 30 10:36:25 2012
Last failure time : Tue Oct 30 10:36:55 2012
Last pass time : Tue Oct 30 10:36:15 2012
Last execution result : Failure
Last failure reason : Failed to send packets.
Next execution time : Tue Oct 30 10:37:05 2012
Table 2 Command output
|
Field |
Description |
|
Test name |
Name of the test. |
|
Total run count |
Total number of executions. |
|
Total failure count |
Total number of failed tests. |
|
Consecutive failure count |
Number of consecutive failed tests. |
|
Last execution time |
Most recent execution time. |
|
First failure time |
First failed test time. If no failure occurs, –NA– is displayed. |
|
Last failure time |
Most recent failed test time. If no failure occurs, –NA– is displayed. |
|
Last pass time |
Most recent success test time. If no success occurs, –NA– is displayed. |
|
Last execution result |
Most recent test result. |
|
Last failure reason |
Cause for the most recent failed test. If the failed test is simulated, Simulated Test is displayed. If no failure occurs, –NA– is displayed. |
|
Next execution time |
Time for the next execution. If the test is a monitoring test, its next execution time is the most recent execution time plus the execution interval. If the test is an on-demand or boot-up test, –NA– is displayed. |
display diagnostic result statistics
Use display diagnostic result statistics to display statistics for packet-related diagnostic tests.
Syntax
display diagnostic result [ slot slot-number [ test test-name ] ] statistics
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device by its member ID or specifies a PEX by its virtual slot number. If you do not specify an IRF member device or PEX, the command applies to all IRF member devices and PEXs.
test test-name: Specifies a test by its name, a case-insensitive string of 1 to 31 characters. If you do not specify this option, the command applies to all packet-related diagnostic tests on the specified IRF member devices or PEXs.
Examples
# Display statistics for test PortLoopback on the specified slot.
<Sysname> display diagnostic result slot 1 test PortLoopback statistics
Slot 1 :
Test name: PortLoopback
Port Packets sent Packets received Packets lost
1 0 0 0
2 0 0 0
3 0 0 0
4 4 4 0
5 4 4 0
6 4 4 0
7 4 4 0
8 0 0 0
Table 3 Command output
|
Field |
Description |
|
Test name |
Name of the test. |
|
Port |
Port number. |
|
Packets sent |
Number of packets that the device sends. |
|
Packets received |
Number of packets that the device receives. |
|
Packets lost |
Number of lost packets. |
display diagnostic simulation
Use display diagnostic simulation to display configurations for simulated diagnostic tests.
Syntax
display diagnostic simulation [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device by its member ID or specifies a PEX by its virtual slot number. If you do not specify an IRF member device or PEX, the command applies to all IRF member devices and PEXs.
Usage guidelines
This command only displays configurations for simulated diagnostic tests. If no simulated diagnostic test exists, no information is displayed.
Examples
# Display configurations for all simulated diagnostic tests on the specified slot.
<Sysname> display diagnostic simulation slot 1
Slot 1 :
Name Mode
HGMonitor failure
Related commands
diagnostic simulation
reset diagnostic event-log
Use reset diagnostic event-log to clear GOLD logs.
Syntax
reset diagnostic event-log
Views
User view
Predefined user roles
network-admin
Examples
# Clear GOLD logs.
<Sysname> reset diagnostic event-log
Related commands
display diagnostic event-log
reset diagnostic result
Use reset diagnostic result to clear test results.
Syntax
reset diagnostic result [ slot slot-number [ test test-name ] ]
Views
User view
Predefined user roles
network-admin
Parameters
slot slot-number: Specifies an IRF member device by its member ID or specifies a PEX by its virtual slot number. If you do not specify an IRF member device or PEX, the command applies to all IRF member devices and PEXs.
test test-name: Specifies a test by its name, a case-insensitive string of 1 to 31 characters. If you do not specify this option, the command applies to all diagnostic tests on the specified IRF member devices or PEXs.
Usage guidelines
This command does not clear the next execution time in detailed test results.
Examples
# Clear test results for test HGMonitor on the specified slot.
<Sysname> reset diagnostic result slot 1 test HGMonitor
Related commands
display diagnostic result
