slot slot-number-list: Specifies a space-separated list of up to seven slot number items. Each item specifies a card by its slot number or a range of cards in the form of start-slot-number to end-slot-number. (In standalone mode.)

chassis chassis-number slot slot-number-list: Specifies cards on an IRF member device or specifies PEXs. The chassis-number argument represents the member ID of the IRF member device or the virtual chassis number of a PEX. The slot-number-list argument specifies a space-separated list of up to seven slot number items. An item specifies a card by its slot number, a range of cards in the form of start-slot-number to end-slot-number, or a PEX by its virtual slot number. The virtual slot number is fixed at 0 for the PEX. The end slot number must be equal to or greater than the start slot number. (In IRF mode.)

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 cards.

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 HGMonitor on card 2.

<Sysname> system-view

[Sysname] diagnostic monitor enable slot 2 test HGMonitor

# (In IRF mode.) Enable test HGMonitor on card 2 of IRF member device 2.

<Sysname> system-view

[Sysname] diagnostic monitor enable chassis 2 slot 2 test HGMonitor

Related commands

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 [ test test-name ] time time

undo diagnostic monitor interval slot slot-number-list [ test test-name ]

In IRF mode:

diagnostic monitor interval chassis chassis-number slot slot-number-list [ test test-name ] time time

undo diagnostic monitor interval chassis chassis-number 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

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 cards.

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

# (In standalone mode.) Set the execution interval to 1 minute for test HGMonitor on card 1.

<Sysname> system-view.

[Sysname] diagnostic monitor interval slot 1 test HGMonitor time 00:01:00

# (In IRF mode.) Set the execution interval to 1 minute for test HGMonitor on card 1 of IRF member device 2.

<Sysname> system-view

[Sysname] diagnostic monitor interval chassis 2 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

In standalone mode:

diagnostic ondemand start slot slot-number-list test { non-disruptive | test-name } [ para parameters ]

In IRF mode:

diagnostic ondemand start chassis chassis-number 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

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

# (In standalone mode.) Start all non-disruptive diagnostic tests on card 1.

<Sysname> diagnostic ondemand start slot 1 test non-disruptive

# (In IRF mode.) Start all non-disruptive diagnostic tests on card 2 of IRF member device 1.

<Sysname> diagnostic ondemand start chassis 1 slot 2 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

In standalone mode:

diagnostic ondemand stop slot slot-number-list test { non-disruptive | test-name }

In IRF mode:

diagnostic ondemand stop chassis chassis-number slot slot-number-list test { non-disruptive | test-name }

Views

User view

Predefined user roles

network-admin

Parameters

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

Examples

# (In standalone mode.) Stop all non-disruptive diagnostic tests on card 1.

<Sysname> diagnostic ondemand stop slot 1 test non-disruptive

# (In IRF mode.) Stop all non-disruptive diagnostic tests on card 1 of IRF member device 2.

<Sysname> diagnostic ondemand stop chassis 2 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

In standalone mode:

diagnostic simulation slot slot-number-list test test-name { failure | random-failure | success }

undo diagnostic simulation slot slot-number-list test test-name

In IRF mode:

diagnostic simulation chassis chassis-number slot slot-number-list test test-name { failure | random-failure | success }

undo diagnostic simulation chassis chassis-number 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

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

# (In standalone mode.) Simulate test HGMonitor as failed on card 1.

<Sysname> diagnostic simulation slot 1 test HGMonitor failure

# (In IRF mode.) Simulate test HGMonitor as failed on card 1 of IRF member device 1.

<Sysname> diagnostic simulation chassis 1 slot 1 test HGMonitor failure

Related commands

display diagnostic simulation

display diagnostic content

Use display diagnostic content to display information about diagnostic tests.

Syntax

In standalone mode:

display diagnostic content [ slot slot-number ] [ verbose ]

In IRF mode:

display diagnostic content [ chassis chassis-number [ slot slot-number ] ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-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 [ slot slot-number ]: Specifies a card on an IRF member device or specifies a PEX. The chassis-number argument represents the member ID of the IRF member device or the virtual chassis number of the PEX. The slot-number argument represents the slot number of the card or PEX. If you do not specify an IRF member device or virtual chassis, the command applies to all member devices and PEXs. If you do not specify a card or PEX, the command applies to all cards of the specified member device or all PEXs in the specified virtual chassis. (In IRF mode.)

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 card 1.

<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

# (In IRF mode.) Display brief information about all diagnostic tests on card 1 of IRF member device 1.

<Sysname> display diagnostic content chassis 1 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

Chassis 1 slot 1 :

Name Attributes Interval

HGMonitor **M*PI 00:00:10

# (In standalone mode.) Display detailed information about all diagnostic tests on card 1.

<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-

# (In IRF mode.) Display detailed information about all diagnostic tests on card 1 of IRF member device 1.

<Sysname> display diagnostic content chassis 1 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

Chassis 1 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 an active and standby switchover occurs.

Examples

# (In IRF mode.) Display all GOLD log entries.

<Sysname> display diagnostic event-log

Event: E_INFO, Wed Jan 7 11:39:53:314 2012, -Chassis=4-Slot=2 TestName->SystemMgmtBus, Event_INFO: Result->Success.

Event: E_ERROR, Wed Jan 7 11:39:53:314 2012, -Chassis=4-Slot=2 TestName->SystemMgmtBus, Event_INFO: Result->Failure Reason->The port 9 is offline.

# (In IRF mode.) Display all GOLD error log entries.

<Sysname> display diagnostic event-log error

Event: E_ERROR, Wed Jan 7 11:39:53:314 2012, -Chassis=4-Slot=2 TestName->SystemMgmtBus, Event_INFO: Result->Failure Reason->The port 9 is offline.

# (In IRF mode.) Display all GOLD log entries except error log entries.

<Sysname> display diagnostic event-log info

Event: E_INFO, Wed Jan 7 11:39:53:314 2012, -Chassis=4-Slot=2 TestName->SystemMgmtBus, Event_INFO: Result->Success.

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

In standalone mode:

display diagnostic result [ slot slot-number [ test test-name ] ] [ verbose ]

In IRF mode:

display diagnostic result [ chassis chassis-number [ slot slot-number [ test test-name ] ] ] [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-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 slot slot-number: Specifies a card on an IRF member device or specifies a PEX. The chassis-number argument represents the member ID of the IRF member device or the virtual chassis number of the PEX. The slot-number argument represents the slot number of the card or PEX. If you do not specify an IRF member device or virtual chassis, the command applies to all member devices and PEXs. If you do not specify a card or PEX, the command applies to all cards of the specified member device or all PEXs in the specified virtual chassis. (In IRF mode.)

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 card.

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 card 1.

<Sysname> display diagnostic result slot 1

Slot 1 :

Name Run count Failure count Last result

HGMonitor 10 3 Failure

# (In IRF mode.) Display brief test results for all diagnostic tests on card 1 of IRF member device 1.

<Sysname> display diagnostic result chassis 1 slot 1

Chassis 1 slot 1 :

Name Run count Failure count Last result

HGMonitor 10 3 Failure

# (In standalone mode.) 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

In standalone mode:

display diagnostic result [ slot slot-number [ test test-name ] ] statistics

In IRF mode:

display diagnostic result [ chassis chassis-number [ slot slot-number [ test test-name ] ] ] statistics

Views

Any view

Predefined user roles

network-admin

network-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.)

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 card.

Examples

# (In standalone mode.) Display statistics for test PortLoopback on card 1.

<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

# (In IRF mode.) Display statistics for test PortLoopback on card 1 of IRF member device 1.

<Sysname> display diagnostic result chassis 1 slot 1 test PortLoopback statistics

Chassis 1 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

In standalone mode:

display diagnostic simulation [ slot slot-number ]

In IRF mode:

display diagnostic simulation [ chassis chassis-number [ slot slot-number ] ]

Views

Any view

Predefined user roles

network-admin

network-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.)

Usage guidelines

This command only displays configurations for simulated diagnostic tests. If no simulated diagnostic test exists, no information is displayed.

Examples

# (In standalone mode.) Display configurations for all simulated diagnostic tests on card 1.

<Sysname> display diagnostic simulation slot 1

Slot 1 :

Name Mode

HGMonitor failure

# (In IRF mode.) Display configurations for all simulated diagnostic tests on card 1 of IRF member device 1.

<Sysname> display diagnostic simulation chassis 1 slot 1

Chassis 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

In standalone mode:

reset diagnostic result [ slot slot-number [ test test-name ] ]

In IRF mode:

reset diagnostic result [ chassis chassis-number [ slot slot-number [ test test-name ] ] ]

Views

User view

Predefined user roles

network-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.)

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 card.

Usage guidelines

This command does not clear the next execution time in detailed test results.

Examples

# (In standalone mode.) Clear test results for test HGMonitor on card 1.

<Sysname> reset diagnostic result slot 1 test HGMonitor

# (In IRF mode.) Clear test results for test HGMonitor on card 1 of IRF member device 1.

<Sysname> reset diagnostic result chassis 1 slot 1 test HGMonitor

Related commands

display diagnostic result

12-Network Management and Monitoring Command Reference

GOLD commands

diagnostic event-log size

diagnostic monitor enable

diagnostic monitor interval

diagnostic ondemand failure

diagnostic ondemand repeating

diagnostic ondemand start

diagnostic ondemand stop

diagnostic simulation

display diagnostic content

display diagnostic event-log

display diagnostic ondemand configuration

display diagnostic result

display diagnostic result statistics

display diagnostic simulation

reset diagnostic event-log

reset diagnostic result

Cloud & AI

InterConnect

Intelligent Computing

Security

SMB Products

Intelligent Terminal Products

Industry Solutions

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Training & Certification

Become a Partner

Partner Resources

Partner Business Management

Company Information

News & Events

Online Exhibition Center

Contact Us