Login
- Table of Contents
-
- 17-Network Management and Monitoring Command Reference
- 00-Preface
- 01-System maintenance and debugging commands
- 02-NQA commands
- 03-NTP commands
- 04-EAA commands
- 05-Process monitoring and maintenance commands
- 06-NETCONF commands
- 07-Information center commands
- 08-SNMP commands
- 09-RMON commands
- 10-Flow log commands
- 11-Event MIB commands
- 12-Packet capture commands
- 13-Fast log output commands
- 14-Mirroring commands
- 15-GOLD commands
- 16-BFD commands
- 17-Track commands
- 18-Interface collaboration commands
- 19-Process placement commands
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 15-GOLD commands | 123.15 KB |
GOLD commands
Support for the diagnostic tests depends on the device model. To get the names of diagnostic tests supported by the device, enter ? at the test name position in a GOLD command. The diagnostic test names used in the following command examples are for illustration only.
diagnostic bootup level
Use diagnostic bootup level to configure whether or not to execute all boot-up diagnostic tests at the next startup.
Use diagnostic bootup level to restore the default.
Syntax
diagnostic bootup level { bypass | complete }
undo diagnostic bootup level
Default
The system does not run boot-up diagnostic tests during startup.
Views
System view
Predefined user roles
network-admin
context-admin
Parameters
bypass: Does not execute any boot-up diagnostic tests.
complete: Executes all boot-up diagnostic tests.
Usage guidelines
This command takes effect at the next startup.
Examples
# Configure the device to run all boot-up diagnostic tests at the next startup.
<Sysname> system-view
[Sysname] diagnostic bootup level complete
Related commands
display diagnostic bootup level
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
context-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
# Set the maximum number of log entries to 600.
<Sysname> system-view
[Sysname] diagnostic event-log size 600
diagnostic monitor action
Use diagnostic monitor action to configure the recovery action to take upon detection of an error for monitoring diagnostic tests.
Use undo diagnostic monitor action to restore the default.
Syntax
In standalone mode:
diagnostic monitor action slot slot-number-list [ cpu cpu-number ] [ test test-name ] mode { none | self-reboot | service-restart | switchover | system-reboot }
undo diagnostic monitor action slot slot-number-list [ cpu cpu-number ] [ test test-name ]
In IRF mode:
diagnostic monitor action chassis chassis-number slot slot-number-list [ cpu cpu-number ] [ test test-name ] mode { none | self-reboot | service-restart | switchover | system-reboot }
undo diagnostic monitor action chassis chassis-number slot slot-number-list [ cpu cpu-number ] [ test test-name ]
Default
By default, the settings for this command vary by test. Use the display diagnostic content verbose command to view the recovery action for a test. If a test does not support any recovery action, its recovery action is displayed as -NA-.
Views
System view
Predefined user roles
network-admin
context-admin
Parameters
test test-name: Specifies a test by its name, a case-sensitive character string. You can use the test ? command to verify the value range of the test name. If you do not specify this option, the command specifies all monitoring diagnostic tests.
none: Does not take any action.
self-reboot: Reboots faulty devices or cards.
service-restart: Restarts faulty services.
switchover: Performs an IRF master/subordinate switchover or an active/standby MPU switchover.
system-reboot: Reboots the device where an error is detected.
chassis chassis-number: Specifies an IRF member device by its member ID. (In IRF mode.)
slot slot-number-list: Specifies a space-separated list of up to seven slot number items. An item specifies a card by its slot number or specifies a range of cards 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.
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
Examples
# (In standalone mode.) Set the recovery action to self-reboot for test MonitorTest on slot 1.
<Sysname> system-view
[Sysname] diagnostic monitor action slot 1 test MonitorTest mode self-reboot
diagnostic monitor enable
Use diagnostic monitor enable to enable monitoring diagnostics.
Use undo diagnostic monitor enable to disable monitoring diagnostics.
Syntax
In standalone mode:
diagnostic monitor enable slot slot-number-list [ cpu cpu-number ] [ test test-name ]
undo diagnostic monitor enable slot slot-number-list [ cpu cpu-number ] [ test test-name ]
In IRF mode:
diagnostic monitor enable chassis chassis-number slot slot-number-list [ cpu cpu-number ] [ test test-name ]
undo diagnostic monitor enable chassis chassis-number slot slot-number-list [ cpu cpu-number ] [ test test-name ]
Default
Monitoring diagnostics are enabled.
Views
System view
Predefined user roles
network-admin
context-admin
Parameters
chassis chassis-number: Specifies an IRF member device by its member ID. (In IRF mode.)
slot slot-number-list: Specifies a space-separated list of up to seven slot number items. An item specifies a card by its slot number or specifies a range of cards 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.
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
test test-name: Specifies a test by its name, a case-sensitive character string. You can use the test ? command to verify the value range of the test name. If you do not specify this option, the command enables all monitoring diagnostic tests.
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
# (In standalone mode.) Enable test MonitorTest on the specified slot.
<Sysname> system-view
[Sysname] diagnostic monitor enable slot 1 test MonitorTest
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
In standalone mode:
diagnostic monitor interval slot slot-number-list [ cpu cpu-number ] [ test test-name ] time interval
undo diagnostic monitor interval slot slot-number-list [ cpu cpu-number ] [ test test-name ]
In IRF mode:
diagnostic monitor interval chassis chassis-number slot slot-number-list [ cpu cpu-number ] [ test test-name ] time interval
undo diagnostic monitor interval chassis chassis-number slot slot-number-list [ cpu cpu-number ] [ test test-name ]
Default
The execution interval varies by monitoring diagnostic test. To display the execution interval of a monitoring diagnostic test, execute the display diagnostic content command.
Views
System view
Predefined user roles
network-admin
context-admin
Parameters
chassis chassis-number: Specifies an IRF member device by its member ID. (In IRF mode.)
slot slot-number-list: Specifies a space-separated list of up to seven slot number items. An item specifies a card by its slot number or specifies a range of cards 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.
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
test test-name: Specifies a test by its name, a case-sensitive character string. You can use the test ? command to verify the value range of the test name. If you do not specify this option, the command applies to all monitoring diagnostic tests.
interval: 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
# (In standalone mode.) Set the execution interval to 1 minute for test MonitorTest on the specified slot.
<Sysname> system-view.
[Sysname] diagnostic monitor interval slot 1 test MonitorTest time 00:01:00
Related commands
diagnostic monitor enable
display diagnostic content
display diagnostic bootup
Use display diagnostic bootup to display boot-up diagnostic test information.
Syntax
In standalone mode:
display diagnostic bootup [ slot slot-number [ cpu cpu-number ] ] [ test test-name ]
In IRF mode:
display diagnostic bootup [ chassis chassis-number [ slot slot-number [ cpu cpu-number ] ] ] [ test test-name ]
Views
Any view
Predefined user roles
network-admin
network-operator
context-admin
context-operator
Parameters
slot slot-number: Specifies a card by its slot number. If you do not specify this option, the command applies to all cards. (In standalone mode.)
chassis chassis-number: Specifies an IRF member device by its member ID. If you do not specify a member device, the command applies to all member devices. (In IRF mode.)
slot slot-number: Specifies a card by its slot number. If you do not specify a card, the command applies to all cards. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
test test-name: Specifies a test by its name, a case-sensitive character string. You can use the test ? command to verify the value range of the test name. If you do not specify this option, the command displays information for all tests.
Examples
# (In standalone mode.) Display information about test BootTest on the specified slot.
<Sysname> display diagnostic bootup slot 1 test BootTest
slot 0:
Test name : BootTest
ExtPara : 123
State : Enabled
Related commands
diagnostic bootup enable test
display diagnostic bootup level
Use display diagnostic bootup level to display the boot-up diagnostics level for the most recent boot-up.
Syntax
display diagnostic bootup level
Views
Any view
Predefined user roles
network-admin
network-operator
context-admin
context-operator
Examples
# Display the boot-up diagnostics level for the most recent boot-up.
<Sysname> display diagnostic bootup level
Current bootup diagnostic level: complete
Related commands
diagnostic bootup level
display diagnostic content
Use display diagnostic content to display information about diagnostic tests.
Syntax
In standalone mode:
display diagnostic content [ slot slot-number [ cpu cpu-number ] ] [ verbose ]
In IRF mode:
display diagnostic content [ chassis chassis-number [ slot slot-number [ cpu cpu-number ] ] ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
context-admin
context-operator
Parameters
slot slot-number: Specifies a card by its slot number. If you do not specify this option, the command applies to all cards. (In standalone mode.)
chassis chassis-number: Specifies an IRF member device by its member ID. If you do not specify a member device, the command applies to all member devices. (In IRF mode.)
slot slot-number: Specifies a card by its slot number. If you do not specify a card, the command applies to all cards. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
verbose: Displays detailed information about diagnostic tests. If you do not specify this keyword, the command displays brief information about the diagnostic tests.
Examples
# (In standalone mode.) 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 cpu 0:
Name Attributes Interval
MonitorTest **M*PA 01:00:00
# (In standalone mode.) 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 cpu 0:
Test name : MonitorTest
Test attributes : **M*PA
Test interval : 01:00:00
Min interval : 00:00:06
Correct-action : -NA-
Description : A Real-time test, enabled by default that checks board status
between local master and other local boards.
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. |
|
Name |
Name of the diagnostic 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. |
|
Interval |
Execution interval for the test. If the execution interval for the test is not set, –NA–is displayed. |
|
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 of the executed scripts. If the test does not run scripts, –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
context-admin
context-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.
(In standalone mode.) GOLD logs are cleared when the device restarts or when an active/standby MPU switchover occurs.
(In IRF mode.) GOLD logs are cleared when the device restarts or when a global active/standby MPU switchover occurs.
Examples
# (In standalone mode.) Display all GOLD log entries.
<Sysname> display diagnostic event-log
Event: E_INFO, Wed Jan 7 11:39:53:314 2017, -Slot=1-Cpu=0 TestName->IPCMonitor, Event_INFO: Result->Success.
display diagnostic result
Use display diagnostic result to display test results.
Syntax
In standalone mode:
display diagnostic result [ slot slot-number [ cpu cpu-number ] [ test test-name ] ] [ verbose ]
In IRF mode:
display diagnostic result [ chassis chassis-number [ slot slot-number [ cpu cpu-number ] [ test test-name ] ] ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
context-admin
context-operator
Parameters
slot slot-number: Specifies a card by its slot number. If you do not specify this option, the command applies to all cards. (In standalone mode.)
chassis chassis-number: Specifies an IRF member device by its member ID. If you do not specify a member device, the command applies to all member devices. (In IRF mode.)
slot slot-number: Specifies a card by its slot number. If you do not specify a card, the command applies to all cards. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
test test-name: Specifies a test by its name, a case-sensitive character string. You can use the test ? command to verify the value range of the test name. If you do not specify this option, the command applies to all diagnostic tests.
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
# (In standalone mode.) Display brief test results for all diagnostic tests on the specified slot.
<Sysname> display diagnostic result slot 1
Slot 1 cpu 0:
Name Run count Failure count Last result
MonitorTest 386 0 Success
# (In standalone mode.) Display detailed test results for all diagnostic tests.
<Sysname> display diagnostic result verbose
Slot 1 cpu 0:
Test name : MonitorTest
Total run count : 386
Total failure count : 0
Consecutive failure count: 0
Last execution time : Fri Nov 21 23:00:01 2014
First failure time : -NA-
Last failure time : -NA-
Last pass time : Fri Nov 21 23:00:01 2014
Last execution result : Success
Last failure reason : -NA-
Next execution time : Sat Nov 22 00:00:07 2014
Slot check status : Normal
Table 2 Command output
|
Field |
Description |
|
Name |
Name of the test. |
|
Run count |
Total number of executions. |
|
Failure count |
Total number of failed tests. |
|
Last result |
Most recent test result. |
|
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 diagnostic 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 diagnostic test, –NA– is displayed. |
display diagnostic result statistics
Use display diagnostic result statistics to display statistics for packet-related diagnostic tests.
Syntax
In standalone mode:
display diagnostic result [ slot slot-number [ cpu cpu-number ] [ test test-name ] ] statistics
In IRF mode:
display diagnostic result [ chassis chassis-number [ slot slot-number [ cpu cpu-number ] [ test test-name ] ] ] statistics
Views
Any view
Predefined user roles
network-admin
network-operator
context-admin
context-operator
Parameters
slot slot-number: Specifies a card by its slot number. If you do not specify this option, the command applies to all cards. (In standalone mode.)
chassis chassis-number: Specifies an IRF member device by its member ID. If you do not specify a member device, the command applies to all member devices. (In IRF mode.)
slot slot-number: Specifies a card by its slot number. If you do not specify a card, the command applies to all cards. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
test test-name: Specifies a test by its name, a case-sensitive character string. You can use the test ? command to verify the value range of the test name. If you do not specify this option, the command applies to all packet-related diagnostic tests.
Examples
# (In standalone mode.) Display statistics for test MonitorTest on the specified slot.
<Sysname> display diagnostic result slot 1 test MonitorTest statistics
Slot 1 cpu 0:
Test name: MonitorTest
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. |
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
context-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
In standalone mode:
reset diagnostic result [ slot slot-number [ cpu cpu-number ] [ test test-name ] ]
In IRF mode:
reset diagnostic result [ chassis chassis-number [ slot slot-number [ cpu cpu-number ] [ test test-name ] ] ]
Views
User view
Predefined user roles
network-admin
context-admin
Parameters
slot slot-number: Specifies a card by its slot number. If you do not specify this option, the command applies to all cards. (In standalone mode.)
chassis chassis-number: Specifies an IRF member device by its member ID. If you do not specify a member device, the command applies to all member devices. (In IRF mode.)
slot slot-number: Specifies a card by its slot number. If you do not specify a card, the command applies to all cards. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number. This option is available only if multiple CPUs are available on the specified slot.
test test-name: Specifies a test by its name, a case-sensitive character string. You can use the test ? command to verify the value range of the test name. If you do not specify this option, the command applies to all diagnostic tests.
Usage guidelines
This command does not clear the next execution time.
Examples
# (In standalone mode.) Clear test results for test MonitorTest on the specified slot.
<Sysname> reset diagnostic result slot 1 test MonitorTest
Related commands
display diagnostic result
