17-Network Management and Monitoring Command Reference

HomeSupportReference GuidesCommand ReferencesH3C SecPath M9000 Command Reference(V7)(R9153P39 R9001P39)-6W40017-Network Management and Monitoring Command Reference
16-GOLD commands
Title Size Download
16-GOLD commands 102.27 KB

GOLD commands

The following compatibility matrix shows the support of hardware platforms for GOLD:

 

Hardware platform

Module type

GOLD compatibility

M9006

M9010

M9014

Blade IV firewall module

No

Blade V firewall module

No

NAT module

No

Application delivery engine (ADE) module

No

Anomaly flow cleaner (AFC) module

No

M9010-GM

Encryption module

No

M9016-V

Blade V firewall module

No

M9008-S

M9012-S

Blade IV firewall module

No

Application delivery engine (ADE) module

No

Intrusion prevention service (IPS) module

No

Video network gateway module

No

Anomaly flow cleaner (AFC) module

No

M9008-S-6GW

IPv6 module

No

M9008-S-V

Blade IV firewall module

No

M9000-AI-E8

Blade V firewall module

Yes

Application delivery engine (ADE) module

Yes

M9000-AI-E16

Blade V firewall module

Yes

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 DBMMonitor on slot 1.

<Sysname> system-view

[Sysname] diagnostic monitor action slot 1 test DBMMonitor 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 DBMMonitor on the specified slot.

<Sysname> system-view

[Sysname] diagnostic monitor enable slot 1 test DBMMonitor

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 DBMMonitor on the specified slot.

<Sysname> system-view.

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

Related commands

diagnostic monitor enable

display diagnostic content

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 [ cpu cpu-number ] test test-name { failure | random-failure | success }

undo diagnostic simulation slot slot-number-list [ cpu cpu-number ] test test-name

In IRF mode:

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

undo diagnostic simulation chassis chassis-number slot slot-number-list [ cpu cpu-number ] test test-name

Default

All diagnostic tests are executed instead of simulated.

Views

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

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.

Examples

# (In standalone mode.) Simulate test DBMMonitor as failed on the specified slot.

<Sysname> diagnostic simulation slot 1 test DBMMonitor failure

Related commands

display diagnostic simulation

diagnostic start test

Use diagnostic start test to start script-bound diagnostics.

Syntax

diagnostic start test test-name

Views

User view

Predefined user roles

network-admin

context-admin

Parameters

test-name: Specifies a script-bound test by its name, a case-insensitive string of 1 to 31 characters. You can use the diagnostic start test ? command to verify available test names.

Usage guidelines

The device is configured with tests that are bound with scripts before the device is shipped. The system supports TCL scripts, such as scripts for verifying chip and port basic information after the device is powered on. After you use this command to start a test, the system automatically runs the scripts and displays the results at the CLI.

This command is available only when the device is in standalone mode.

Examples

# Start script-bound test EquipSelfCheck.

<Sysname> diagnostic start test EquipSelfCheck

This command requires null configuration and reboot device afterwards. Continue?

[Y/N]:y                                                                         

=================================================                              

  ===============display clock===================                              

10:55:19.115 UTC Fri 06/27/2017                           

  ===============system-view=====================                              

System View: return to User View with Ctrl+Z.                                  

  ===============undo stp enable=====================                           

  ===============probe-view=====================                               

  ===========undo monitor inner-channel=================

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                

DBMMonitor                      **M**A                 -NA-                    

LIPCMonitor                     **M**A                 00:04: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        : DBMMonitor                                                  

Test attributes  : **M**A                                                      

Test interval    : -NA-                                                        

Min interval     : -NA-                                                        

Correct-action   : none                                                        

Description      : This is a global monitor test.                              

Exec             : -NA-                                                        

                                                                               

Test name        : LIPCMonitor                                                 

Test attributes  : **M**A                                                      

Test interval    : 00:04:00                                                    

Min interval     : 00:01:00                                                    

Correct-action   : -NA-                                                         

Description      : This is a real-time test.                                   

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

LIPCMonitor                     404          0                Success

# (In standalone mode.) Display detailed test results for all diagnostic tests.

<Sysname> display diagnostic result verbose

Slot 1 cpu 0:

  Test name                : DBMMonitor                                        

  Total run count          : 0                                                 

  Total failure count      : 0                                                 

  Consecutive failure count: 0                                                 

  Last execution time      : -NA-                                              

  First failure time       : -NA-                                              

  Last failure time        : -NA-                                              

  Last pass time           : -NA-                                              

  Last execution result    : -NA-                                              

  Last failure reason      : -NA-                                              

  Next execution time      : -NA-                                              

                                                                                

  Test name                : LIPCMonitor                                       

  Total run count          : 404                                               

  Total failure count      : 0                                                  

  Consecutive failure count: 0                                                 

  Last execution time      : Fri Jun 21 18:36:13 2019                          

  First failure time       : -NA-                                               

  Last failure time        : -NA-                                              

  Last pass time           : Fri Jun 21 18:36:13 2019                          

  Last execution result    : Success                                            

  Last failure reason      : -NA-                                              

  Next execution time      : Fri Jun 21 18:40:13 2019

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. It is the most recent execution time plus the execution interval.

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 DBMMonitor on the specified slot.

<Sysname> display diagnostic result slot 1 test DBMMonitor statistics

Slot 1 cpu 0:

  Test name: DBMMonitor

  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 [ cpu cpu-number ] ]

In IRF mode:

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

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.

Examples

# (In standalone mode.) Display configurations for all simulated diagnostic tests on the specified slot.

<Sysname> display diagnostic simulation slot 1

Slot 1 cpu 0:

  Name                            Mode

  DBMMonitor                      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

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 DBMMonitor on the specified slot.

<Sysname> reset diagnostic result slot 1 test DBMMonitor

Related commands

display diagnostic result

  • Cloud & AI
  • InterConnect
  • Intelligent Computing
  • Security
  • SMB Products
  • Intelligent Terminal Products
  • Product Support Services
  • Technical Service Solutions
All Services
  • Resource Center
  • Policy
  • Online Help
All Support
  • Become a Partner
  • Partner Resources
  • Partner Business Management
All Partners
  • Profile
  • News & Events
  • Online Exhibition Center
  • Contact Us
All About Us
新华三官网