01-Fundamentals Command Reference

HomeSupportSwitchesS12500R SeriesReference GuidesCommand ReferencesH3C S12500R Switch Router Series Command References(R36xx)-6W10101-Fundamentals Command Reference
09-Device management commands
Title Size Download
09-Device management commands 487.03 KB

Contents

Device management commands· 1

clock datetime· 1

clock protocol 2

clock summer-time· 3

clock timezone· 4

command· 5

copyright-info enable· 6

display alarm·· 7

display alarm active· 8

display alarm history· 9

display asset-info· 10

display clock· 11

display copyright 12

display cpu-usage· 12

display cpu-usage configuration· 13

display cpu-usage history· 14

display device· 16

display device manuinfo· 17

display device manuinfo chassis-only· 18

display device manuinfo fan· 19

display device manuinfo power 19

display diagnostic-information· 20

display environment 21

display fan· 22

display hardware-failure-detection· 23

display hardware-resource· 24

display health· 25

display memory· 26

display memory-threshold· 27

display power 29

display resource-monitor 31

display scheduler job· 32

display scheduler logfile· 33

display scheduler reboot 33

display scheduler schedule· 34

display system stable state· 35

display system-working-mode· 37

display transceiver alarm·· 37

display transceiver diagnosis· 38

display transceiver interface· 39

display transceiver itu-channel 40

display transceiver manuinfo· 42

display version· 43

display version-update-record· 43

hardware-failure-detection· 44

hardware-failure-protection aggregation· 45

hardware-resource tcam·· 45

header 47

itu-channel 47

job· 48

locator blink· 49

memory-threshold· 49

memory-threshold usage· 51

memory-threshold usage resend-interval 52

monitor cpu-usage enable· 52

monitor cpu-usage interval 53

monitor cpu-usage statistics-interval core· 54

monitor cpu-usage threshold· 55

monitor cpu-usage threshold core· 56

monitor resend cpu-usage· 57

monitor resend cpu-usage core-interval 58

monitor resend memory-threshold· 59

monitor disable-port 60

parity-error consistency-check log enable· 61

parity-error consistency-check threshold· 62

parity-error monitor log enable· 62

parity-error monitor period· 63

parity-error monitor threshold· 64

parity-error unrecoverable log enable· 65

parity-error unrecoverable period· 65

parity-error unrecoverable reboot 66

parity-error unrecoverable threshold· 67

password-recovery enable· 68

power-exception-monitor 69

power-monitor enable· 69

power-supply policy enable· 70

power-supply policy redundant 71

power-supply surplus-power enable· 71

reboot 72

reset asset-info· 73

reset scheduler logfile· 74

reset version-update-record· 75

resource-monitor minor resend enable· 75

resource-monitor output 76

resource-monitor resource· 77

restore factory-default 79

scheduler job· 80

scheduler logfile size· 80

scheduler reboot at 81

scheduler reboot delay· 82

scheduler schedule· 82

set asset-info· 83

shutdown-interval 84

switch-fabric isolate· 85

switch-fabric removal-signal-suppression· 86

switch-linecard isolate· 87

sysname· 87

system-working-mode· 88

temperature-limit 89

time at 90

time once· 90

time repeating· 92

transceiver monitor enable· 93

transceiver monitor interval 94

usb disable· 95

user-role· 95


Device management commands

clock datetime

Use clock datetime to set the system time.

Syntax

clock datetime time date

Default

The factory-default system time is used.

Views

User view

Predefined user roles

network-admin

Parameters

time: Specifies a time in the hh:mm:ss format. The value range for hh is 0 to 23. The value range for mm is 0 to 59. The value range for ss is 0 to 59. The leading zero in a segment can be omitted. If the seconds segment is 0 (hh:mm:00), you can omit it. If both the minutes and seconds segments are 0 (hh:00:00), you can omit both of the segments. For example, to specify 08:00:00, you can enter 8.

date: Specifies a date in the MM/DD/YYYY or YYYY/MM/DD format. The value range for YYYY is 2000 to 2035. The value range for MM is 1 to 12. The value range for DD varies by month.

Usage guidelines

CAUTION

CAUTION:

This command changes the system time, which affects the execution of system time-related features (for example, scheduled tasks) and collaborative operations of the device with other devices (for example, log reporting and statistics collection). Before executing this command, make sure you fully understand its impact on your live network.

Correct system time is essential to network management and communication. You must configure the system time correctly before you run the device on the network.

For the device to use the local system time, execute the clock protocol none command and this command in turn. The specified system time takes effect immediately. Then, the device uses the clock signals generated by its built-in crystal oscillator to maintain the system time.

If you set the time zone or daylight saving time after you configure this command, the device recalculates the system time. To view the system time, use the display clock command.

Examples

# Set the system time to 08:08:08 01/01/2012.

<Sysname> clock datetime 8:8:8 1/1/2012

# Set the system time to 08:10:00 01/01/2012.

<Sysname> clock datetime 8:10 2012/1/1

Related commands

clock protocol

clock summer-time

clock timezone

display clock

clock protocol

Use clock protocol to specify the system time source.

Use undo clock protocol to restore the default.

Syntax

clock protocol { none | ntp | ptp }

undo clock protocol

Default

The device obtains the UTC time from an NTP time source.

Views

System view

Predefined user roles

network-admin

Parameters

none: Uses the system time set by using the clock datetime command.

ptp: Uses PTP to obtain the UTC time. You must configure PTP correctly. For more information about PTP and PTP configuration, see Network Management and Monitoring Configuration Guide.

ntp: Uses NTP to obtain the UTC time. You must configure NTP correctly. For more information about NTP and NTP configuration, see Network Management and Monitoring Configuration Guide.

Usage guidelines

Correct system time is essential to network management and communication. You must configure the system time correctly before you run the device on the network.

The device can use the locally set system time, or obtain the UTC time from a time source on the network and calculate the system time.

·     If you execute the clock protocol none command, the device uses the locally set system time. The device then uses the clock signals generated by its built-in crystal oscillator to maintain the system time.

·     If you execute the clock protocol { ntp | ptp } command, the device obtains the UTC time through NTP or PTP and calculates the system time. The device then periodically synchronizes the UTC time and recalculates the system time.

The system time calculated by using the UTC time from an NTP or PTP time source is more precise.

If you execute this command multiple times, the most recent configuration takes effect.

If you set the time zone or daylight saving time after you configure this command, the device recalculates the system time. To view the system time, use the display clock command.

Examples

# Configure the device to use the local system time.

<Sysname> system-view

[Sysname] clock protocol none

clock summer-time

Use clock summer-time to set the daylight saving time.

Use undo clock summer-time to restore the default.

Syntax

clock summer-time name start-time start-date end-time end-date add-time

undo clock summer-time

Default

The daylight saving time is not set.

Views

System view

Predefined user roles

network-admin

Parameters

name: Specifies a name for the daylight saving time schedule, a case-sensitive string of 1 to 32 characters.

start-time: Specifies the start time in the hh:mm:ss format. The value range for hh is 0 to 23. The value range for mm is 0 to 59. The value range for ss is 0 to 59. The leading zero in a segment can be omitted. If the seconds segment is 0 (hh:mm:00), you can omit it. If both the minutes and seconds segments are 0 (hh:00:00), you can omit both of the segments. For example, to specify 08:00:00, you can enter 8.

start-date: Specifies the start date in one of the following formats:

·     MM/DD. The value range for MM is 1 to 12. The value range for DD varies by month.

·     month week day, where:

¡     month—Takes January, February, March, April, May, June, July, August, September, October, November, or December.

¡     week—Represents week of the month. It takes first, second, third, fourth, fifth, or last.

¡     day—Takes Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, or Saturday.

end-time: Specifies the end time in the hh:mm:ss format. The value range for hh is 0 to 23. The value range for mm is 0 to 59. The value range for ss is 0 to 59. The leading zero in a segment can be omitted. If the seconds segment is 0 (hh:mm:00), you can omit it. If both the minutes and seconds segments are 0 (hh:00:00), you can omit both of the segments. For example, to specify 08:00:00, you can enter 8.

end-date: Specifies the end date in one of the following formats:

·     MM/DD. The value range for MM is 1 to 12. The value range for DD varies by month.

·     month week day, where:

¡     month—Takes January, February, March, April, May, June, July, August, September, October, November or December.

¡     week—Represents week of the month. It takes first, second, third, fourth, fifth, or last.

¡     day—Takes Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, or Saturday.

add-time: Specifies the time to be added to the standard time, in the hh:mm:ss format. The value range for hh is 0 to 23. The value range for mm is 0 to 59. The value range for ss is 0 to 59. The leading zero in a segment can be omitted. If the seconds segment is 0 (hh:mm:00), you can omit it. If both the minutes and seconds segments are 0 (hh:00:00), you can omit both of the segments. For example, to specify 08:00:00, you can enter 8.

Usage guidelines

Correct system time is essential to network management and communication. You must configure the system time correctly before you run the device on the network.

After you set the daylight saving time, the device recalculates the system time. To view the system time, use the display clock command.

Make sure all devices on the network are using the same daylight saving time as the local time.

Examples

# Set the system time ahead 1 hour for the period between 06:00:00 on 08/01 and 06:00:00 on 09/01.

<Sysname> system-view

[Sysname] clock summer-time PDT 6 08/01 6 09/01 1

Related commands

clock datetime

clock timezone

display clock

clock timezone

Use clock timezone to set the time zone.

Use undo clock timezone to restore the default.

Syntax

clock timezone zone-name { add | minus } zone-offset

undo clock timezone

Default

The UTC time zone is used.

Views

System view

Predefined user roles

network-admin

Parameters

zone-name: Specifies a time zone by its name, a case-sensitive string of 1 to 32 characters.

add: Adds an offset to the UTC time or local system time.

minus: Decreases the UTC time or local system time by an offset.

zone-offset: Specifies the offset in the hh:mm:ss format. The value range for hh is 0 to 23. The value range for mm is 0 to 59. The value range for ss is 0 to 59. The leading zero in a segment can be omitted. If the seconds segment is 0 (hh:mm:00), you can omit it. If both the minutes and seconds segments are 0 (hh:00:00), you can omit both of the segments. For example, to specify 08:00:00, you can enter 8.

Usage guidelines

Correct system time is essential to network management and communication. You must configure the system time correctly before you run the device on the network.

After you set the time zone, the device recalculates the system time. To view the system time, use the display clock command.

Make sure all devices on the network are using the same time zone as the local time.

Examples

# Set the name of the time zone to Z5, and add 5 hours to the UTC time or local system time.

<Sysname> system-view

[Sysname] clock timezone Z5 add 5

Related commands

clock datetime

clock summer-time

display clock

command

Use command to assign a command to a job.

Use undo command to revoke a command.

Syntax

command id command

undo command id

Default

No command is assigned to a job.

Views

Job view

Predefined user roles

network-admin

Parameters

id: Specifies an ID for the command, in the range of 0 to 4294967295. A command ID uniquely identifies a command in a job. Commands in a job are executed in ascending order of their command IDs.

command: Specifies the command to be assigned to the job.

Usage guidelines

To assign a command (command A) to a job, you must first assign the job the command or commands for entering the view of command A.

If you specify the ID of an existing command for another command, the existing command is replaced.

Make sure all commands in a schedule are compliant to the command syntax. The system does not examine the syntax when you assign a command to a job.

If a command requires a yes or no answer, the system always assumes that a Y or Yes is entered. If a command requires a character string input, the system assumes that either the default character string (if any) or a null string is entered.

A job cannot contain the telnet, ftp, ssh2, or monitor process command.

Examples

# Assign commands to the backupconfig job to back up the startup.cfg file to the TFTP server at 192.168.100.11.

<Sysname> system-view

[Sysname] scheduler job backupconfig

[Sysname-job-backupconfig] command 2 tftp 192.168.100.11 put flash:/startup.cfg backup.cfg

# Assign commands to the shutdownGE job to shut down HundredGigE 1/0/1.

<Sysname> system-view

[Sysname] scheduler job shutdownGE

[Sysname-job-shutdownGE] command 1 system-view

[Sysname-job-shutdownGE] command 2 interface hundredgige 1/0/1

[Sysname-job-shutdownGE] command 3 shutdown

Related commands

scheduler job

copyright-info enable

Use copyright-info enable to enable copyright statement display.

Use undo copyright-info enable to disable copyright statement display.

Syntax

copyright-info enable

undo copyright-info enable

Default

Copyright statement display is enabled.

Views

System view

Predefined user roles

network-admin

Examples

# Enable copyright statement display.

<Sysname> system-view

[Sysname] copyright-info enable

The device will display the following statement when a user logs in:

******************************************************************************

* Copyright (c) 2004-2017 New H3C Technologies Co., Ltd. All rights reserved.*

* Without the owner's prior written consent,                                 *

* no decompiling or reverse-engineering shall be allowed.                    *

****************************************************************************** 

display alarm

Use display alarm to display alarm information.

Syntax

display alarm [ 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 a card, this command displays alarm information for all cards.

If a power module, CPU, or fan is operating abnormally on the device, you can use the display alarm command to view the alarm information. To view historical alarms that have been cleared, use the display alarm history command. To view active alarms that were generated in the past and have not been cleared on the device, use the display alarm active command.

Examples

# Display alarm information.

Slot   CPU   Level   Info                                                      

-      -     ERROR   Power 2 is faulty.                                        

-      -     INFO    Power 3 is absent.                                        

-      -     INFO    Power 4 is absent.                                        

Table 1 Command output

Field

Description

Slot

Slot that generated the alarm. If the alarm was generated by the frame, this field displays a hyphen (-).

Level

Alarm severity. Possible values include ERROR, WARNING, NOTICE, and INFO, in descending order.

Info

Detailed alarm information:

·     Board is faulty—The slot is starting up or faulty.

·     Fan n is absent—The specified fan is absent.

·     Fan n is faulty—The specified fan is faulty.

·     Power n is absent—The specified power module is absent.

·     Power n is faulty—The specified power module is faulty.

·     Slot n temperature is too high, above the shutdown limit—The temperature of the specified card is higher than the shutdown temperature threshold.

·     Slot n temperature is too high, above the high limit—The temperature of the specified card is is higher than the high-temperature threshold.

·     Slot n temperature is too high, above the warning limit—The temperature of the specified card is is higher than the high-temperature warning threshold.

·     Slot n temperature is too low, below the low limit—The temperature of the specified card is is lower than the low-temperature threshold.

display alarm active

Use display alarm active to display information about active alarms.

 

 

NOTE:

This command is supported only in F3607P02 and later.

 

Syntax

display alarm active

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

If a power module, CPU, or fan is operating abnormally on the device, you can use the display alarm command to view the alarm information. To view historical alarms that have been cleared, use the display alarm history command. To view active alarms that were generated in the past and have not been cleared on the device, use the display alarm active command.

Examples

# Display information about active alarms.

<Sysname> display alarm active

Seq    Level    Time                  Info

24     WARNING  2020-01-11  12:40:00  CPU usage is in minor alarm state.

23     WARNING  2020-01-11  12:30:00  Memory minor threshold has been exceeded.

Table 2 Command output

Field

Description

Seq

Alarm sequence number, assigned when an alarm occurs.

Level

Alarm severity. The values include ERROR, WARNING, NOTICE, and INFO, in descending order of severity.

Time

Time when the alarm occurs.

Info

Detailed alarm information. The values include:

·     Fan n is absent—The specified fan is absent.

·     Fan n is failed—The specified fan is abnormal.

·     Power n is absent—The specified power module is absent.

·     Power n failed—The specified power module is abnormal.

·     Temperature is higher than the high-temperature alarming threshold on sensor inflow—The temperature of the specified sensor has exceeded the high-temperature warning threshold.

·     Memory minor threshold has been exceeded—The amount of free memory space has exceeded the minor alarm threshold.

·     CPU usage is in minor alarm state—The CPU usage has exceeded the minor alarm threshold.

·     Interface-name: RX power is high!—The optical power on the specified interface is too high.

·     Interface-name:The bit error ratio exceeds the upper threshold—The bit error rate of the specified interface has exceeded the upper limit.

Related commands

display alarm

display alarm history

display alarm history

Use display alarm history to display information about historical alarms that have been cleared.

 

 

NOTE:

This command is supported only in F3607P02 and later.

 

Syntax

display alarm history [ verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

verbose: Displays detailed information. If you do not specify this keyword, this command displays brief information.

Usage guidelines

If a power module, CPU, or fan is operating abnormally on the device, use the display alarm command to view the alarm information. To view historical alarms that have been cleared, use the display alarm history command. To view active alarms that were generated in the past and have not been cleared on the device, use the display alarm active command.

Examples

# Display brief information about historical alarms.

<Sysname> display  alarm history

Seq        Time                  Info

23         2020-01-11 12:40:00 CPU usage recovered to normal state.

For information about the fields in the command output, see Table 2.

# Display detailed information about historical alarms.

<Sysname> display alarm history verbose

Seq 23

Alarm name: CPUUsageMinor

Start time: 2020-01-11 12:30:00

Level: WARNING

Info: CPU usage is in minor alarm state.

Recovery time: 2020-01-11 12:40:30

Info: CPU usage minor alarm removed.

Table 3 Command output

Field

Description

Seq

Alarm sequence number, assigned automatically by the system when an alarm occurs.

AlarmPosition

Location where the alarm occurs.

Start time

Time when the alarm occurs.

Level

Alarm severity. The values include ERROR, WARNING, NOTICE, and INFO, in descending order of severity.

Recovery time

Time when the alarm is cleared.

Info

Detailed alarm information.

Related commands

display alarm

display alarm active

display asset-info

Use display asset-info to display the asset profile for a physical component.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

display asset-info { chassis | fan fan-id | power power-id | slot slot-number } [ csn | custom | department | description | location | service-date | state ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

chassis: Displays the asset profile for the frame.

fan fan-id: Displays the asset profile for the specified fan tray. The value range for the fan-id argument is 1 to 6.

power power-id: Displays the asset profile for the specified power module. The value range for the power-id argument is 1 to 36.

slot slot-number: Displays the asset profile for the card in the specified slot.

csn: Displays the asset ID for the asset.

custom: Displays the customized asset items.

department: Displays the department name.

description: Displays the asset description.

location: Displays the asset location.

service-date: Displays the service start date.

state: Displays the asset usage status.

Usage guidelines

To display an item in an asset profile, specify the corresponding keyword for the command. To display all items in an asset profile, do not specify the item keywords.

If an item is not configured, the system displays an empty field.

If you specify a fan tray or power module that does not exist, the system prompts that the fan tray or power module is absent.

Examples

# Display the asset ID for fan tray 1.

<Sysname> system-view

[Sysname] display asset-info fan 1 csn

Type        : Fan 1

csn         : 123456

# Display the asset information for fan tray 1.

<Sysname> system-view

[Sysname] display asset-info fan 1

Type        : Fan 1

csn         : 123456

description : FAN 1

location    :

service-date:

department  : MKT

state       : Normal

custom      : 1:789

Related commands

reset asset-info

set asset-info

display clock

Use display clock to display the system time, date, time zone, and daylight saving time.

Syntax

display clock

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display the system time and date when the time zone is not specified.

<Sysname> display clock

10:09:00 UTC Fri 03/16/2015

The time is in the hour:minute:second.milliseconds format.

# Display the system time and date when the time zone Z5 is specified.

<Sysname> display clock

15:10:00 Z5 Fri 03/16/2015

Time Zone : Z5 add 05:00:00

# Display the system time and date when the time zone Z5 and daylight saving time PDT are specified.

<Sysname> display clock

15:11:00 Z5 Fri 03/16/2015

Time Zone : Z5 add 05:00:00

Summer Time : PDT 06:00:00 08/01 06:00:00 09/01 01:00:00

Related commands

clock datetime

clock timezone

clock summer-time

display copyright

Use display copyright to display the copyright statement.

Syntax

display copyright

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display the copyright statement.

<Sysname> display copyright

...

display cpu-usage

Use display cpu-usage to display the current CPU usage statistics.

Syntax

display cpu-usage [ summary ] [ slot slot-number [ cpu cpu-number [ core { core-number| all } ] ] ]

display cpu-usage [ control-plane ] [ summary ] [ slot slot-number [ cpu cpu-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

control-plane: Displays CPU usage statistics for the control plane.

summary: Displays CPU usage statistics in table form. If you do not specify this keyword, the command displays CPU usage statistics in text form.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays the CPU usage statistics for all cards.

cpu cpu-number: Specifies a CPU by its number.

core core-number: Specifies a CPU core by its number.

core all: Specifies all CPU cores.

Usage guidelines

If you do not specify the control-plane keyword, the command displays the total CPU usage statistics for the control plane.

In F3607 and later, if two hyphens (--) are displayed for the CPU usage during the most recent 5-second, 1-minute, and 5-minute intervals, the command might fail to obtain data from the database on the device. Try the command later.

In a version earlier than F3607, no information is displayed when the command fails to obtain data.

Examples

# Display the current CPU usage statistics in text form.

<Sysname> display cpu-usage

Slot 1 CPU 0 CPU usage:

       1% in last 5 seconds

       1% in last 1 minute

       1% in last 5 minutes

# Display the current CPU usage statistics in table form.

<Sysname> display cpu-usage

Slot CPU        Last 5 sec        Last 1 min        Last 5 min

1    0          17%               29%               28%

Table 4 Command output

Field

Description

x% in last 5 seconds

Last 5 sec

Average CPU or CPU core usage during the most recent 5-second interval.

y% in last 1 minute

Last 1 min

Average CPU or CPU core usage during the most recent 1-minute interval.

z% in last 5 minutes

Last 5 min

Average CPU or CPU core usage during the most recent 5-minute interval.

display cpu-usage configuration

Use display cpu-usage configuration to display CPU usage monitoring settings.

Syntax

display cpu-usage configuration [ slot slot-number [ cpu cpu-number ] ]

Views

Any view

Predefined user roles

network-admin

Parameters

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays the CPU usage monitoring settings for the active MPU.

cpu cpu-number: Specifies a CPU by its number.

Examples

# Display the CPU usage monitoring settings.

<Sysname> display cpu-usage configuration

CPU usage monitor is enabled.

Current monitor interval is 60 seconds.

Current severe alarm threshold is 90%.

Current minor alarm threshold is 80%.

Current recovery-threshold is 40%.

Table 5 Command output

Field

Description

CPU usage monitor is xxx.

Whether CPU usage tracking is enabled.

Current monitor interval is xxx.

Sampling interval for CPU usage tracking.

Current severe alarm monitor threshold is xxx.

Severe CPU usage alarm threshold.

Current minor alarm threshold is xxx.

Minor CPU usage alarm threshold.

Current recovery threshold is xxx.

CPU usage recovery threshold.

Related commands

monitor cpu-usage enable

monitor cpu-usage interval

monitor cpu-usage threshold

display cpu-usage history

Use display cpu-usage history to display the historical CPU usage statistics in a coordinate system.

Syntax

display cpu-usage history [ job job-id ] [ slot slot-number [ cpu cpu-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

job job-id: Specifies a process by its ID. The value range for job-id is 1 to 2147483647. If you do not specify a process, this command displays the statistics for the entire system's CPU usage (the total CPU usage of all processes). To view the IDs and names of the running processes, use the display process command. For more information, see Network Management and Monitoring Configuration Guide.

slot slot-number: Specifies a card by its slot number. If you specify a process but do not specify a card, this command displays the statistics for the process on the active MPU. If you do not specify any options, this command displays the statistics for all processes on all cards.

cpu cpu-number: Specifies a CPU by its number. If you specify a process but do not specify a CPU, this command displays the statistics for the default CPU. If you do not specify a process or CPU, this command displays the historical statistics for all CPUs.

Usage guidelines

After CPU usage monitoring is enabled, the system regularly samples CPU usage and saves the samples to the history record buffer. This command displays the most recent 60 samples in a coordinate system as follows:

·     The vertical axis represents the CPU usage. If a statistic is not a multiple of the usage step, it is rounded up or down to the closest multiple of the usage step. For example, if the CPU usage step is 5%, the statistic 53% is rounded up to 55%, and the statistic 52% is rounded down to 50%.

·     The horizontal axis represents the time.

·     Pound signs (#) indicate the CPU usage. The value on the vertical axis for the topmost pound sign at a specific time represents the CPU usage at that time.

Examples

# Display the historical CPU usage statistics.

<Sysname> display cpu-usage history

100%|

 95%|

 90%|

 85%|

 80%|

 75%|

 70%|

 65%|

 60%|

 55%|

 50%|

 45%|

 40%|

 35%|

 30%|

 25%|

 20%|

 15%|             #

 10%|            ###  #

  5%|           ########

     ------------------------------------------------------------

              10        20        30        40        50        60  (minutes)

                      cpu-usage (Slot 1 CPU 0)  last 60 minutes (SYSTEM)

The output shows the following items:

·     Process name. The name SYSTEM represents the entire system.

·     CPU that is holding the process: CPU 0 in slot 1.

·     Historical CPU usage statistics for the entire system during the last 60 minutes.

¡     12 minutes ago—Approximately 5%.

¡     13 minutes ago—Approximately 10%.

¡     14 minutes ago—Approximately 15%.

¡     15 minutes ago—Approximately 10%.

¡     16 and 17 minutes ago—Approximately 5%.

¡     18 minutes ago—Approximately 10%.

¡     19 minutes ago—Approximately 5%.

¡     Other time—2% or lower.

Related commands

monitor cpu-usage enable

monitor cpu-usage interval

display device

Use display device to display device information.

Syntax

display device [ flash | usb ] [ slot slot-number | verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

flash: Displays flash memory information.

usb: Displays USB interface information.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays information for all cards.

verbose: Displays detailed information. If you do not specify this keyword, this command displays brief information.

Usage guidelines

If you do not specify the flash and usb keywords, this command displays information about cards.

Examples

# Display device information.

<Sysname> display device

Slot Type                State    Subslot  Soft Ver             Patch Ver      

0    NONE                Absent   0        NONE                 None           

1    LSXM1SUPER1         Master   0        S12508R              None           

2    NONE                Absent   0        NONE                 None           

3    LSXM1CGQ36HBR1      Normal   0        S12508R              None           

4    NONE                Absent   0        NONE                 None           

5    NONE                Absent   0        NONE                 None           

6    NONE                Absent   0        NONE                 None           

7    NONE                Absent   0        NONE                 None           

8    NONE                Absent   0        NONE                 None           

9    NONE                Absent   0        NONE                 None           

10   NONE                Absent   0        NONE                 None           

11   NONE                Absent   0        NONE                 None           

12   NONE                Absent   0        NONE                 None           

13   NONE                Fault    0        NONE                 None           

14   NONE                Absent   0        NONE                 None           

15   NONE                Absent   0        NONE                 None

Table 6 Command output

Field

Description

Brd Type

Hardware type of the card.

Brd Status

Card status:

·     Standby—The card is the standby MPU.

·     Master—The card is the active MPU.

·     Absent—The slot is not installed with a card.

·     Fault—The card is faulty and cannot start up.

·     Normal—The card is an interface card and is operating correctly.

·     Offline—The card is isolated.

Soft Ver

Software version of the card.

Patch Ver

Most recently released patch image version that is running on the card. If no patch image is installed, this field displays None.

If both incremental and non-incremental patch images are running on the card, this field displays the most recently released incremental patch image version. For more information about patch image types, see "Upgrading software."

 

display device manuinfo

Use display device manuinfo to display electronic label information for the device.

Syntax

display device manuinfo [ 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 a card, this command displays electronic label information of all cards.

Usage guidelines

An electronic label contains the permanent configuration information, including the hardware serial number, manufacturing date, MAC address, and vendor name. The data is written to the storage component during hardware debugging or testing. This command displays only part of the electronic label information.

Examples

# Display electronic label information for the device.

<Sysname> display device manuinfo

Slot 0 CPU 0:                                                                 

DEVICE_NAME          :  LSXM2SUPT1                                            

DEVICE_SERIAL_NUMBER :  210231A8C3H182000106                                  

MAC_ADDRESS          :  NONE                                                  

MANUFACTURING_DATE   :  2018-02-13                                            

VENDOR_NAME          :  H3C

Table 7 Command output

Field

Description

DEVICE_NAME

Card name.

DEVICE_SERIAL_NUMBER

Serial number of the card.

MAC_ADDRESS

MAC address of the card.

MANUFACTURING_DATE

Manufacturing date of the card.

VENDOR_NAME

Vendor name.

display device manuinfo chassis-only

Use display device manuinfo chassis-only to display electronic label information for the backplane.

Syntax

display device manuinfo chassis-only

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

Examples

# Display electronic label information for the backplane.

<Sysname> display device manuinfo chassis-only

Chassis self:

DEVICE_NAME          : LS-12516X-AF                                           

DEVICE_SERIAL_NUMBER : 210235A1ELX155000005                                   

MAC_ADDRESS          : 3C8C-4002-8867                                         

MANUFACTURING_DATE   : 2015-05-20                                             

VENDOR_NAME          : H3C

display device manuinfo fan

Use display device manuinfo fan to display electronic label information for a fan tray.

Syntax

display device manuinfo fan fan-id

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

fan-id: Specifies a fan tray by its ID.

Examples

# Display electronic label information for a fan tray.

<Sysname> display device manuinfo fan 1

Fan 1:

DEVICE_NAME          : fan

DEVICE_SERIAL_NUMBER : 210235A36L1234567890

MAC_ADDRESS          : NONE

MANUFACTURING_DATE   : 2010-01-20

VENDOR_NAME          : H3C

 

display device manuinfo power

Use display device manuinfo power to display electronic label information for a power module.

Syntax

display device manuinfo power power-id

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

power-id: Specifies a power module by its ID.

Examples

# Display electronic label information for a power module.

<Sysname> display device manuinfo power 1

...

display diagnostic-information

Use display diagnostic-information to display or save operating information for features and hardware modules.

Syntax

display diagnostic-information [ hardware | infrastructure | l2 | l3 | service ] [ key-info ] [ filename ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

hardware: Specifies hardware-related operating information.

infrastructure: Specifies operating information for the fundamental features.

l2: Specifies operating information for the Layer 2 features.

l3: Specifies operating information for the Layer 3 features.

service: Specifies operating information for Layer 4 and upper-layer features.

key-info: Displays or saves only critical operating information. The device might have a large amount of operating information if an exception occurs or after the device runs a long period of time. Specifying this keyword reduces the command execution time and helps you focus on critical operating information. If you do not specify this keyword, the command displays or saves both critical and non-critical operating information.

filename: Saves the information to a file. The filename argument must use the .tar.gz suffix. If you do not specify this argument, the command prompts you to choose whether to save the information to a file or display the information.

Usage guidelines

You can use one of the following methods to collect operating statistics for diagnostics and troubleshooting:

·     Use separate display commands to collect operating information feature by feature or module by module.

·     Use the display diagnostic-information command to collect operating information for multiple or all features and hardware modules.

To save storage space, the display diagnostic-information command automatically compresses information before saving information to a file. To view the file content:

1.     Use the tar extract command to extract the file.

2.     Use the gunzip command to decompress the extracted file.

3.     Use the more command to view the content of the decompressed file.

If you abort the display diagnostic-information command, the gunzip command might not be able to decompress the extracted file. To decompress the extracted file, export the extracted file to a PC that is running Linux, and use the gunzip -c command.

If you do not specify any feature parameters, this command displays or saves the operating information for all features and modules.

If you do not specify a file name for the command, the system prompts you to choose whether to display or save the information. If you choose to save the information, the system automatically assigns a file name and displays the file name in brackets. For file name uniqueness, the file name includes the device name and the current system time. If the device name contains any of the following special characters, the system uses an underscore (_) to replace each special character: forward slashes (/), backward slashes (\), colons (:), asterisks (*), question marks (?), less than signs (<), greater than signs (>), and pipeline signs (|). For example, if the device name is A/B, the device name in the file name will be A_B, as in flash:/diag_A_B_20160101-000438.tar.gz.

This command does not support the |, >, or >> option.

While the device is executing this command, do not execute any other commands. Executing other commands might affect the collected operating information.

Examples

# Display the operating information for all features and modules.

<Sysname> display diagnostic-information

Save or display diagnostic information (Y=save, N=display)? [Y/N]:n

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

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

14:03:55 UTC Thu 01/05/2012

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

  ===============display version=============== 

...

# Save the operating information for all features and modules to the default file.

<Sysname> display diagnostic-information

Save or display diagnostic information (Y=save, N=display)? [Y/N]:y

Please input the file name(*.tar.gz)[flash:/diag_Sysname_20160101-024601.tar.gz]:

Diagnostic information is outputting to flash:/diag_Sysname_20160101-024601.tar.gz.

Please wait...

Save successfully.

Press Enter when the system prompts you to enter the file name.

# Save the operating information for all features and modules to the test.tar.gz file.

<Sysname> display diagnostic-information test.tar.gz

Diagnostic information is outputting to flash:/test.tar.gz.

Please wait...

Save successfully.

Related commands

gunzip

more

tar extract

display environment

Use display environment to display temperature information.

Syntax

display environment [ 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 a card, this command displays information for all cards.

Usage guidelines

This command displays information about all temperature sensors on the device if you do not specify a card.

Examples

# Display information about all temperature sensors on the device.

<Sysname> display environment

 System temperature information (degree centigrade):

 -----------------------------------------------------------------------------

 Slot  Sensor       Temperature  Lower       Warning       Alarm       Shutdown

 1     hotspot 1    38           10          40            50          100

 1     hotspot 2    42           10          50            80          100

Table 8 Command output

Field

Description

System Temperature information (degree centigrade)

Temperature information (°C).

sensor

Temperature sensor:

·     hotspot—Hotspot sensor.

·     inflow—Air inlet sensor.

Slot

Sensor position.

Temperature

Current temperature.

Lower

Lower temperature limit. If the device does not support this field, this field displays NA.

Warning

Warning temperature threshold. If the device does not support this field, this field displays NA.

Alarm

Alarming temperature threshold. If the device does not support this field, this field displays NA.

Shutdown

Shutdown temperature threshold. When the sensor temperature reaches the limit, the system shuts down automatically. If the device does not support this field, this field displays NA.

display fan

Use display fan to display fan tray operating status information.

Syntax

display fan [ fan-id ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

fan-id: Specifies a fan tray by its ID. If you do not specify a fan tray, this command displays operating status information for all fan trays at the specified position.

Examples

# Display the operating states of all fan trays.

<Sysname> display fan

 Fan-tray 1:                                                                   

 Status    : Normal                                                            

 Fan Type  : LSXM108XFAN                                                       

 Fan number: 3                                                                 

 Fan mode  : Auto                                                              

 Airflow Direction: Front-to-back                                              

 Fan  Speed(rpm)                                                                

 ---  ----------                                                               

  1   7249                                                                     

  2   7239                                                                      

  3   7239                                                                      

Table 9 Command output

Field

Description

Fan-tray 1

Fan tray number.

Status

Fan tray status:

·     Normal—The fan tray is operating correctly.

·     Fault—The fan tray is faulty.

·     Absent—The slot is not installed with a fan tray.

Fan Type

Model of the fan tray.

Fan number

Number of fans in the fan tray.

Fan mode

Fan speed adjustment mode.

Airflow Direction

Airflow direction of the fans.

Fan

Fan number.

Speed(rpm)

Fan speed in RPM.

display hardware-failure-detection

Use display hardware-failure-detection to display the hardware failure detection settings and the latest 10 fix records for each card.

Syntax

display hardware-failure-detection

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

The fix records are stored on the active MPU. You can use this command to display the records for a card even if the card is removed or replaced. The fix records are lost only when you remove or power cycle the active MPU.

Examples

# Display hardware failure detection settings and fix records.

<Sysname> display hardware-failure-detection

Current level:

    chip       : isolate

    board      : isolate

    forwarding : warning

Recent record:

--------------------------Slot  0 executed records:-----------------------------

                 There is no record.

--------------------------Slot  0 trapped records:-----------------------------

                 There is no record.

Table 10 Command output

Field

Description

Current level

Fix actions specified for hardware failures.

chip

Fix action for hardware failures on components of cards.

board

Fix action for hardware failures on control paths.

forwarding

Fix action for hardware failures on the forwarding plane.

Recent record

Recent failure fix records.

Slot n executed records

Fix records of all cards stored on the specified MPU.

Slot n trapped records

Trap records of all cards stored on the specified MPU.

display hardware-resource

Use display hardware-resource to display hardware resource operating mode information.

Syntax

display hardware-resource [ tcam ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

tcam: Displays only operating mode information about the ternary content addressable memory (TCAM). If you do not specify this keyword, the command displays operating mode information about all hardware resources. In this release, the command can display only operating mode information about the TCAM.

Usage guidelines

Examples

# Display hardware resource operating mode information.

<Sysname> display hardware-resource

Tcam resource(tcam), all supported modes:

  routing           The routing working mode

  normal            The normal working mode

  acl               The acl working mode

  -----------------------------------------------

  Default         Current         Next

  routing         routing         routing

Table 11 Command output

Field

Description

Default

Default operating mode.

Current

Current operating mode.

Next

Operating mode for the next startup.

Related commands

hardware-resource tcam

display health

Use display health to display CPU and memory usage.

Syntax

display health [ slot slot-number [ cpu cpu-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 a card, this command displays CPU and memory usage on all cards.

cpu cpu-number: Specifies a CPU by its number.

Examples

# Display the CPU and memory usage on all cards.

<Sysname> display health

Slot CPU Role         CPU Usage(%) Memory Usage(%) Used/Total(MB)

1    0   MPU(Master)  10           45              3593/7978

3    0   LPU          6            20              3349/16114

Table 12 Command output

Field

Description

Role

Card role:

·     MPU(Master)—Active MPU.

·     MPU(Standby)—Standby MPU.

·     LPU—LPU.

CPU Usage(%)

Average CPU usage during the past 5 seconds, in percentage.

Memory Usage(%)

Memory usage in percentage.

Used/Total(MB)

Memory usage and total amount of memory in MB.

display memory

Use display memory to display memory usage information.

Syntax

display memory [ summary ] [ slot slot-number [ cpu cpu-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

summary: Displays brief information about memory usage. If you do not specify this keyword, the command displays detailed information about memory usage.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays memory usage for all cards.

cpu cpu-number: Specifies a CPU by its number.

Usage guidelines

In F3607 and later, if two hyphens (--) are displayed for all the fields in a line of the command output, the command might fail to obtain data from the database on the device. Try the command later.

In a version earlier than F3607, no information is displayed when the command fails to obtain data.

Examples

# Display detailed memory usage information.

<Sysname> display memory

Memory statistics are measured in KB:                                          

Slot 1:                                                                         

             Total      Used      Free    Shared   Buffers    Cached   FreeRatio

Mem:        984560    456128    528432         0         4     45616       53.7%

-/+ Buffers/Cache:    410508    574052                                          

Swap:            0         0         0                                         

# Display brief memory usage information.

<Sysname> display memory summary

Memory statistics are measured in KB:                                          

Slot CPU        Total      Used      Free  Buffers    Caches FreeRatio         

   1   0       984560    456128    528432        4     45616     53.7%         

Table 13 Command output

Field

Description

Mem

Memory usage information.

Total

Total size of the physical memory space that can be allocated.

The memory space is virtually divided into two parts. Part 1 is solely used for kernel code and kernel management functions. Part 2 can be allocated and used for such tasks as running service modules and storing files. The size of part 2 equals the total size minus the size of part 1.

Used

Used physical memory.

Free

Free physical memory.

Shared

Physical memory shared by processes.

If this field is not supported, two hyphens (--) are displayed.

Buffers

Physical memory used for buffers.

If this field is not supported, two hyphens (--) are displayed.

Cached

Caches

Physical memory used for caches.

If this field is not supported, two hyphens (--) are displayed.

FreeRatio

Free memory ratio.

-/+ Buffers/Cache

-/+ Buffers/Cache:used = Mem:Used – Mem:Buffers – Mem:Cached, which indicates the physical memory used by applications.

-/+ Buffers/Cache:free = Mem:Free + Mem:Buffers + Mem:Cached, which indicates the physical memory available for applications.

Swap

Memory space for swapping.

display memory-threshold

Use display memory-threshold to display memory alarm thresholds and statistics.

Syntax

display memory-threshold [ slot slot-number [ cpu cpu-number ] ]

Views

Any view

Predefined user roles

network-admin

Parameters

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays the memory usage thresholds and statistics for the active MPU.

cpu cpu-number: Specifies a CPU by its number.

Usage guidelines

For more information about memory usage notifications, see log information containing MEM_EXCEED_THRESHOLD or MEM_BELOW_THRESHOLD.

Examples

# Display memory alarm thresholds and statistics.

<Sysname> display memory-threshold

Memory usage threshold: 100%                                                   

Free memory threshold:                                                         

    Minor: 256M                                                                

    Severe: 192M                                                               

    Critical: 128M                                                             

    Normal: 320M                                                               

    Early-warning: 384M                                                        

    Secure: 448M                                                               

Current memory state: Normal                                                   

Event statistics:                                                              

 [Back to normal state]                                                        

    First notification: 0.0                                                    

    Latest notification: 0.0                                                   

    Total number of notifications sent: 0                                      

 [Enter minor low-memory state]                                                 

    First notification at: 0.0                                                 

    Latest notification at: 0.0                                                

    Total number of notifications sent: 0                                       

 [Back to minor low-memory state]                                              

    First notification at: 0.0                                                 

    Latest notification at: 0.0                                                 

    Total number of notifications sent: 0                                      

 [Enter severe low-memory state]                                               

    First notification at: 0.0                                                  

    Latest notification at: 0.0                                                

    Total number of notifications sent: 0                                      

 [Back to severe low-memory state]                                             

    First notification at: 0.0                                                 

    Latest notification at: 0.0                                                

    Total number of notifications sent: 0                                      

 [Enter critical low-memory state]                                             

    First notification at: 0.0                                                 

    Latest notification at: 0.0                                                

    Total number of notifications sent: 0                                      

display power

Use display power to display power module information.

Syntax

display power [ power-id | verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

power-id: Specifies a power module by its ID. If you do not specify a power module, this command displays information about all power modules at the specified position.

verbose: Displays detailed information. In the current software version, the command displays same information no matter whether you specify this keyword or not.

Examples

# Display detailed power module information.

<Sysname> display power verbose

 Power supply policy     : Enabled                                              

 Surplus sleeping        : Disabled                                            

 Power modules installed : 2                                                   

 Power modules usable    : 2                                                    

 Total power             : 4000W                                               

 Redundant power         : 0W                                                  

 Sleeping power          : 0W                                                  

 Available power         : 4000W                                               

   Allocated power       : 2375W                                               

   Remaining power       : 1625W                                               

                                                                               

 PowerID State     InPower(W)  Current(A)  Voltage(V)  OutPower(W)     Type    

  1      Normal      2000        5.80       54.00       313.20     CP2000AC    

  2      Absent       --          --          --           --          ---     

  3      Normal      2000        4.40       54.00       237.60     CP2000AC    

  4      Absent       --          --          --           --          ---     

  5      Absent       --          --          --           --          ---     

  6      Absent       --          --          --           --          ---     

  7      Absent       --          --          --           --          ---     

  8      Absent       --          --          --           --          ---     

                                                                               

 Information about reserved power:                                             

                                                                                

  Slot  Status  Power(W)   Remarks                                             

   7    Normal    275      Powered on                                          

  10    Normal    170      Powered on                                           

  11    Fault     450      Powered on                                          

  12    Normal    170      Powered on                                          

  16    Normal     50      Reserved for MPU                                     

  17    Absent     50      Reserved for MPU                                    

                                                                               

 Power information for fans:                                                   

  Fan[2]: 1200W                                                                 

Table 14 Command output

Field

Description

Power supply policy

Status of power supply management:

·     Enabled.

·     Disabled.

Surplus sleeping

Status of the surplus sleeping feature. Disabled indicates that the surplus sleeping feature is disabled for power modules.

Power modules installed

Number of power modules installed on the device.

Power modules usable

Number of used power modules. The used power modules are the power modules in Normal and Sleeping states.

Total power

Total power, in watts.

Redundant power

Redundant power, in watts.

Sleeping power

Sleeping power, in watts.

Available power

Available power, in watts.

Allocated power

Used power, in watts.

Remaining power

Remaining power, in watts.

PowerID

Power module ID.

State

Power module status:

·     Absent—The slot is not installed with a power module.

·     Normal—The power module is operating correctly.

·     Fault—The power module is faulty.

InPower(W)

Input power of the power module, in watts.

If this field is not supported, two hyphens (--) are displayed.

Current(A)

Output current of the power module, in amperes.

If this field is not supported, two hyphens (--) are displayed.

Voltage(V)

Output voltage of the power module, in volts.

If this field is not supported, two hyphens (--) are displayed.

OutPower(W)

Output power of the power module, in watts.

If this field is not supported, two hyphens (--) are displayed.

Type

Power module model.

If this field is not supported, two hyphens (--) are displayed.

Information about reserved power

Information about reserved power on cards.

Slot

Slot number of the card.

Status

Status of the card:

·     Absent—The slot is not installed with a card.

·     Normal—The card is operating correctly.

·     Fault—The card is faulty or does not start up.

Power(W)

Reserved power on the card, in watts.

Remarks

Description of the reserved power:

·     Reserved for MPU.

·     Powered on—The card is powered on.

·     Not enough power to power it on—Reserved power is not enough for the card to be powered on.

·     Reserved for a non-MPU card.

Power information for fans

Information about the reserved power for fans.

Fan[x]

Fan number

display resource-monitor

Use display resource-monitor to display resource monitoring information.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

display resource-monitor [ resource resource-name ] [ slot slot-number [ cpu cpu-number ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

resource resource-name: Specifies a resource type by its name. For the available resource types, see Table 27.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays resource monitoring information for all cards.

cpu cpu-number: Specifies a CPU by its number.

Examples

# Display ARP resource monitoring information.

<Sysname> display resource-monitor resource arp

Minor alarms resending: Enabled

Slot 1:

Resource                         Minor Severe Free/Total

                                 (%)   (%)    (absolute)

arp                              50    20     90095/90098

Table 15 Command output

Field

Description

Minor alarms resending

Status of the minor resource depletion alarm resending feature, Enabled or Disabled.

Resource

Monitored resource type.

Minor

(%)

Minor resource depletion threshold, in percentage.

Severe

(%)

Severe resource depletion threshold, in percentage.

Free/Total

(absolute)

Numbers of available resources and total resources, in absolute values.

Related commands

resource-monitor minor resend enable

resource-monitor resource

display scheduler job

Use display scheduler job to display job configuration information.

Syntax

display scheduler job [ job-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

job-name: Specifies a job by its name, a case-sensitive string of 1 to 47 characters. If you do not specify a job, this command displays configuration information for all jobs.

Examples

# Display configuration information for all jobs.

<Sysname> display scheduler job

Job name: saveconfig

 copy startup.cfg backup.cfg

 

Job name: backupconfig

 

Job name: creat-VLAN100

 system-view

 vlan 100

// The output shows that the device has three jobs: the first has one command, the second does not have any commands, and the third has two commands. Jobs are separated by blank lines.

display scheduler logfile

Use display scheduler logfile to display job execution log information.

Syntax

display scheduler logfile

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display job execution log information.

<Sysname> display scheduler logfile

Logfile Size: 1902 Bytes.

 

Job name        : shutdown

Schedule name   : shutdown

Execution time  : Tue Dec 27 10:44:42 2011

Completion time : Tue Dec 27 10:44:47 2011

--------------------------------- Job output -----------------------------------

<Sysname>system-view

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

[Sysname]interface rang hundredgige 1/0/1 to hundredgige 1/0/3

[Sysname-if-range]shutdown

Table 16 Command output

Field

Description

Logfile Size

Size of the log file, in bytes.

Schedule name

Schedule to which the job belongs.

Execution time

Time when the job was started.

Completion time

Time when the job was completed. If the job has never been executed or the job does not have any commands, this field is blank.

Job output

Commands in the job and their output.

Related commands

reset scheduler logfile

display scheduler reboot

Use display scheduler reboot to display the automatic reboot schedule.

Syntax

display scheduler reboot

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display the automatic reboot schedule.

<Sysname> display scheduler reboot

System will reboot at 16:32:00 05/23/2011 (in 1 hours and 39 minutes).

Related commands

scheduler reboot at

scheduler reboot delay

display scheduler schedule

Use display scheduler schedule to display schedule information.

Syntax

display scheduler schedule [ schedule-name ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

schedule-name: Specifies a schedule by its name, a case-sensitive string of 1 to 47 characters. If you do not specify a schedule, this command displays information about all schedules.

Examples

# Display information about all schedules.

<Sysname> display scheduler schedule

Schedule name        : shutdown

Schedule type        : Run once after 0 hours 2 minutes

Start time           : Tue Dec 27 10:44:42 2011

Last execution time  : Tue Dec 27 10:44:42 2011

Last completion time : Tue Dec 27 10:44:47 2011

Execution counts     : 1

-----------------------------------------------------------------------

Job name                                          Last execution status

shutdown                                          Successful

Table 17 Command output

Field

Description

Schedule type

Execution time setting of the schedule. If no execution time is specified, this field is not displayed.

Start time

Time to execute the schedule for the first time. If no execution time is specified, this field is not displayed.

Last execution time

Last time when the schedule was executed. If no execution time is specified, this field is not displayed. If the schedule has never been executed, "Yet to be executed" is displayed for this field.

Last completion time

Last time when the schedule was completed. If no execution time is specified, this field is not displayed.

Execution counts

Number of times the schedule has been executed. If the schedule has never been executed, this field is not displayed.

Job name

Name of a job under the schedule.

Last execution status

Result of the most recent execution:

·     Successful.

·     Failed.

·     Waiting—The device is executing the schedule and the job is waiting to be executed.

·     In process—The job is being executed.

·     -NA-—The execution time has not arrived yet.

To view information about whether the commands in the job has been executed and the execution results, execute the display scheduler logfile command.

display system stable state

Use display system stable state to display system stability and status information.

Syntax

display system stable state [ summary ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

summary: Displays brief information about system stability and status, including system status, redundancy status, and NSR status. If you do not specify this keyword, the command displays detailed information about system status, redundancy status, and CPU role and status.

Usage guidelines

Before performing an ISSU or a switchover, execute this command multiple times to identify whether the system is operating stably. If the value of the System State field is not Stable, you cannot perform an ISSU. If the value of the Redundancy Stable field is not Stable, you cannot perform a switchover.

The card startup process takes some time. If the values of the status fields do not change to Stable, execute this command multiple times to identify the cards that are not in Stable state. You can also use other commands to identify the faulty components. For example:

·     Use the display device command to identify the device operating status.

·     Use the display ha service-group command to display the status of HA service groups and identify the groups in batch backup state.

·     Use the display system internal process state command in probe view to display service operating status.

Examples

# Display brief information about system stability and status.

<Sysname> display system stable state summary

System state      : Stable

Redundancy state  : No redundance

NSR     state     : No standby

# Display system stability and status information.

<Sysname> display system stable state

System state     : Stable

Redundancy state : Stable

  Slot    CPU    Role       State

  0       0      Active     Stable

  1       0      Standby    Stable

  3       0      Other      Stable

  15      0      Other      Stable

Table 18 Command output

Field

Description

System state

Operating status of all cards:

·     Stable—All cards are operating stably.

·     Not ready—One or more cards are not operating stably. You cannot perform an ISSU.

Redundancy state

System redundancy status:

·     Stable—Both MPUs are operating stably. You can perform a switchover.

·     No redundance—The system has only one MPU. You cannot perform a switchover.

·     Not ready—The system is not operating stably. You cannot perform a switchover.

Role

Role of the card in the system:

·     Active—The card is the active MPU.

·     Standby—The card is the standby MPU.

·     Other—The card is a service card.

State

Operating status of the card:

·     Stable—The card is operating stably.

·     Board inserted—The card has just been installed.

·     Kernel initiating—Card kernel is being initialized.

·     Service starting—Services are starting.

·     Service stopping—Services are stopping.

·     HA Batch backup—An HA batch backup is going on.

·     Interface data batch backup—An interface data batch backup is in progress.

*

The object is not operating stably.

Related commands

display device

display ha service-group (High Availability Command Reference)

display system-working-mode

Use display system-working-mode to display system working mode information.

Syntax

display system-working-mode

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display system working mode information.

<Sysname> display system-working-mode

The current system working mode is standard.

The system working mode for next startup is standard.

display transceiver alarm

Use display transceiver alarm to display transceiver alarms.

Syntax

display transceiver alarm interface [ interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface [ interface-type interface-number ]: Specifies an interface by its type and number. If no interface is specified, this command displays the alarms present on every transceiver module.

Usage guidelines

Table 19 shows the common transceiver alarm components. If no error occurs, "None" is displayed.

Table 19 Common transceiver alarm components

Field

Description

APD

Avalanche photo diode

PCS

Physical coding sublayer

PHY XS

PHY extended sublayer

PMA/PMD

Physical medium attachment/physical medium dependent

power

Optical power

REFCLK

Reference clock

RX

Receive

TEC

Thermoelectric cooler

Temp

Temperature

TX

Transmit

WIS

WAN interface sublayer

Examples

# Display the alarms present on the transceiver module in interface HundredGigE 1/0/1.

<Sysname> display transceiver alarm interface hundredgige 1/0/1

HundredGigE1/0/1 transceiver current alarm information:

  RX signal loss

  RX power low

Table 20 Command output

Field

Description

transceiver current alarm information

Alarms present on the transceiver module.

RX signal loss

Input signal loss occurred.

RX power low

Received power is low.

display transceiver diagnosis

Use display transceiver diagnosis to display the current values of the digital diagnosis parameters on transceiver modules.

Syntax

display transceiver diagnosis interface [ interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface [ interface-type interface-number ]: Specifies an interface by its type and number. If no interface is specified, this command displays the current values of the digital diagnosis parameters on every transceiver module.

Examples

# Display the current values of the digital diagnosis parameters on the transceiver module in interface HundredGigE 1/0/1.

<Sysname> display transceiver diagnosis interface HundredGigE1/0/1

HundredGigE1/0/1 transceiver diagnostic information:

  Current diagnostic parameters:

[module]  Temp.(°C) Voltage(V)     Total RX power(dBm)   Total TX power(dBm)

          29         3.33          -33.61                7.34

[channel] Bias(mA)  RX power(dBm)  TX power(dBm)

    1     0.00      -36.96         -36.96

    2     0.00      -36.96         -36.96

    3     0.00      -36.96         -36.96

    4     0.00      -36.96         -36.96

  Alarm thresholds:

          Temp.(°C) Voltage(V)  Bias(mA)  RX power(dBm)  TX power(dBm)

    High  75         3.47        13.00     3.40           5.00

    Low   -5         3.13        3.00      -14.00         -10.00

  Warning thresholds:

          Temp.(°C) Voltage(V)  Bias(mA)  RX power(dBm)  TX power(dBm)

    High  70         3.45        11.00     2.40           3.00

    Low   0          3.15        5.00      -11.00         -8.00

Table 21 Command output

Field

Description

transceiver diagnostic information

Digital diagnosis information for the transceiver module in the interface.

Wave.er(nm)

Wavelength offset in nm, accurate to 0.001 nm. This field is supported only on the HPE X130 10G SFP+ LC LH80 tunable Transceiver (JL250A) module and SFP-XG-LH80-Tunable Transceiver module.

Freq.er(GHz)

Frequency offset in GHz, accurate to 0.1 GHz. This field is supported only on the HPE X130 10G SFP+ LC LH80 tunable Transceiver (JL250A) module and SFP-XG-LH80-Tunable Transceiver module.

Temp.(°C)

Temperature in °C, accurate to 1°C.

Voltage(V)

Voltage in V, accurate to 0.01 V.

Total RX power(dBm)

Total receive power for lanes in dBM, accurate to 0.01 dBM.

This field is supported only in F3607P02 and later.

Total TX power(dBm)

Total transmit power for lanes in dBM, accurate to 0.01 dBM.

This field is supported only in F3607P02 and later.

Bias(mA)

Bias current in mA, accurate to 0.01 mA.

RX power(dBm)

Receive power in dBm, accurate to 0.01 dBm.

TX power(dBm)

Transmit power in dBm, accurate to 0.01 dBm.

display transceiver interface

Use display transceiver interface to display the key parameters of transceiver modules.

Syntax

display transceiver interface [ interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays the key parameters of every transceiver module.

Examples

# Display the key parameters of the transceiver module in interface HundredGigE 1/0/1.

<Sysname> display transceiver interface hundredgige 1/0/1

HundredGigE1/0/1 transceiver information:

  Transceiver Type              : 1000_BASE_SX_SFP

  Connector Type                : LC

  Wavelength(nm)                : 850

  Transfer Distance(m)          : 550(50um),275(62.5um)

  Digital Diagnostic Monitoring : YES

  Vendor Name                   : H3C

Table 22 Command output

Field

Description

Connector Type

Connector types:

·     SC—Fiber connector developed by NTT.

·     LC—1.25 mm/RJ-45 fiber connector developed by Lucent.

·     RJ-45.

·     CX 4.

Wavelength(nm)

Central wavelength (in nm) of the transmit laser. If the transceiver supports multiple wavelengths, every two wavelength values are separated by a comma.

For a copper cable, this field displays N/A.

Transfer Distance(xx)

Transmission distance, where xx indicates the distance unit:

·     km—Kilometers, for single-mode transceiver modules.

·     m—Meters, for other transceiver modules.

If the transceiver module supports multiple types of transmission media, this field displays the transmission distance for each type, in the form of transmission distance (medium type).

Transmission medium types include:

·     9 um—9/125 µm single-mode fiber.

·     50 um—50/125 µm multimode fiber.

·     62.5 um—62.5/125 µm multimode fiber.

·     TP—Twisted pair.

·     CX4—CX4 cable.

Digital Diagnostic Monitoring

Support for digital diagnosis:

·     YES—Supported.

·     NO—Not supported.

display transceiver itu-channel

Use display transceiver itu-channel to display ITU channel information for transceiver modules.

Syntax

display transceiver itu-channel interface [ interface-type interface-number [ supported-channel ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface [ interface-type interface-number ]: Specifies an interface by its type and number. If no interface is specified, this command displays ITU channel information for all transceiver modules.

supported channel: Specifies ITU channels supported on the interface. If this keyword is not specified, the command displays the ITU channel that is being used on the interface.

Usage guidelines

This command is supported only by the SFP-XG-LH80-Tunable Transceiver module.

Examples

# Display ITU channels used by the transceiver module in Ten-GigabitEthernet 1/0/1.

<Sysname> display transceiver itu-channel interface ten-gigabitethernet 1/0/1

Interface                           Channel        WaveLength(nm)  Frequency(THz)

XGE1/0/1                            1              1566.72         191.35 

# Display ITU channels supported by the transceiver module in Ten-GigabitEthernet 1/0/1.

<Sysname> display transceiver itu-channel interface ten-gigabitethernet 1/0/1 supported-channel

ITU channel settings supported on Ten-GigabitEthernet1/0/1 :                  

Channel    WaveLength(nm)    Frequency(THz)                                    

1          1566.72           191.35                                            

2          1566.31           191.40                                            

3          1565.90           191.45                                            

4          1565.50           191.50                                            

5          1565.09           191.55                                            

6          1564.68           191.60                                            

7          1564.27           191.65                                            

8          1563.86           191.70 

...

Table 23 Command output

Field

Description

WaveLength(nm)

Wavelength of the channel in nm, accurate to 0.01 nm. This field displays a hyphen (-) in the following situations:

·     No transceiver module is installed on the interface.

·     The transceiver module does not support specifying an ITU channel number.

·     The command failed to obtain the ITU channel information.

·     The device does not support the ITU channel number stored on the transceiver module.

Frequency(THz)

Frequency of the channel in THz, accurate to 0.01 THz. This field displays a hyphen (-) in the following situations:

·     No transceiver module is installed on the interface.

·     The transceiver module does not support specifying an ITU channel number.

·     The command failed to obtain the ITU channel information.

·     The device does not support the ITU channel number stored on the transceiver module.

Related commands

itu-channel

display transceiver manuinfo

Use display transceiver manuinfo to display electronic label information for transceiver modules.

Syntax

display transceiver manuinfo interface [ interface-type interface-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

interface [ interface-type interface-number ]: Specifies an interface by its type and number. If no interface is specified, this command displays electronic label information for all transceiver modules.

Examples

# Display electronic label information for the transceiver module in interface HundredGigE 1/0/1.

<Sysname> display transceiver manuinfo interface hundredgige 1/0/1

HundredGigE1/0/1 transceiver manufacture information:

  Manu. Serial Number  : 213410A0000054000251

  Manufacturing Date   : 2012-09-01

  Vendor Name          : H3C

Table 24 Command output

Field

Description

Manu. Serial Number

Serial number generated during production of the transceiver module.

Manufacturing Date

Date when the electronic label information was written to the transceiver module.

display version

Use display version to display system version information.

Syntax

display version

Views

Any view

Predefined user roles

network-admin

network-operator

Examples

# Display system version information.

<Sysname> display version

display version-update-record

Use display version-update-record to display startup software image upgrade records.

Syntax

display version-update-record

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

The device records its current startup software version information whenever it starts up, and records all software version update information. Such information can survive reboots.

Examples

# Display the startup software image upgrade records.

<Sysname> display version-update-record

Record 1  (updated on Mar 26 2020 at 11:26:23):                                

 *Name        : S12508R-CMW710-BOOT-R2713.bin                                  

  Version     : 7.1.070P2216 Release 2713                                      

  Compile time: Aug 24 2018 11:00:00                                           

                                                                               

 *Name        : S12508R-CMW710-SYSTEM-R2713.bin                                

  Version     : 7.1.070 Release 2713                                           

  Compile time: Aug 24 2018 11:00:00 

Table 25 Command output

Field

Description

Record n (updated on Mar 26 2020 at 11:26:23)

Number of the startup software image upgrade record. Record 1 is the most recent record.

Name

Software image file name.

*

The software image version changed during the upgrade.

Related commands

reset version-update-record

hardware-failure-detection

Use hardware-failure-detection to specify the action to be taken in response to hardware failures.

Use undo hardware-failure-detection to restore the default.

Syntax

hardware-failure-detection { board | chip | forwarding } { isolate | off | reset | warning }

undo hardware-failure-detection { board | chip | forwarding }

Default

The system takes the action of warning in response to hardware failures on chips, cards, and the forwarding plane.

Views

System view

Predefined user roles

network-admin

Parameters

board: Specifies failures on control paths and cards.

chip: Specifies failures on components of cards such as the chips, capacitances, resistances.

forwarding: Specifies failures on the forwarding plane (including services and other relevant items).

isolate: Takes one or more of the following actions:

·     Shuts down the relevant ports.

·     Prohibits loading software for the relevant cards.

·     Isolates the relevant cards.

·     Powers off the relevant cards to reduce impact from the failures.

off: Takes no action.

reset: Restarts the relevant components or cards to recover from failures.

warning: Sends traps to notify you of the failures.

Usage guidelines

The device automatically detects hardware failures on components, cards, and the forwarding plane. You can specify the actions to be taken in response to detected failures.

Examples

# Configure the device to send traps in response to failures on components.

<Sysname> system-view

[Sysname] hardware-failure-detection chip warning

hardware-failure-protection aggregation

Use hardware-failure-protection aggregation to enable hardware failure protection for aggregation groups.

Use undo hardware-failure-protection aggregation to disable hardware failure protection for aggregation groups.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

hardware-failure-protection aggregation

undo hardware-failure-protection aggregation

Default

Hardware failure protection is disabled for aggregation groups.

Views

System view

Predefined user roles

network-admin

Usage guidelines

This command takes effect only when the hardware-failure-detection forwarding isolate command is executed.

This command does not take effect on a member interface in the following situations:

·     Loopback testing is enabled (using the loopback { external | internal } command).

·     The interface is forcibly brought up (using the port up-mode command).

Examples

# Enable hardware failure protection for aggregation groups.

<Sysname> system-view

[Sysname] hardware-failure-protection aggregation

Related commands

hardware-failure-detection

hardware-resource tcam

Use hardware-resource tcam to set the TCAM operating mode.

Use undo hardware-resource tcam to restore the default.

Syntax

hardware-resource tcam { routing | normal | acl | ipv6 | mix }

undo hardware-resource tcam

Default

The TCAM operating mode is routing.

Views

System view

Predefined user roles

network-admin

Parameters

routing: Specifies the routing mode.

normal: Specifies the normal mode.

acl: Specifies the ACL mode.

ipv6: Specifies the IPv6 mode.

mix: Specifies the mixed mode.

 

NOTE:

The HBR card supports only the mixed mode.

Usage guidelines

For a TCAM operating mode change to take effect, perform the following tasks:

·     Save the running configuration to the next-startup configuration file.

·     Delete the .mdb binary file for the next-startup configuration file.

·     Reboot the device

The TCAM provides an extended memory space for the device to store ARP, ACL, and routing entries, or others. The TCAM operating mode determines the types of entries that the TCAM stores.

Table 26 describes the TCAM operating modes and the supported entry types.

Table 26 TCAM operating modes and supported entry types

TCAM operating mode

Description

ACL mode

Stores IPv4 ACLs.

IPv6 mode

Stores ARP entries, ND entries, IPv4 routing entries, and IPv6 routing entries.

Mixed mode

Stores ARP entries, ND entries, IPv4 routing entries, and IPv6 routing entries.

Normal mode

Does not store any entries.

Routing mode

Stores ARP entries, ND entries, IPv4 routing entries, and IPv6 routing entries.

Examples

# Set the TCAM operating mode to routing.

<Sysname> system-view

[Sysname] hardware-resource tcam routing

Do you want to change the specified hardware resource working mode? [Y/N]:y

The hardware resource working mode is changed, please save the configuration and reboot the system to make it effective.

Related commands

display hardware-resource

header

Use header to configure a banner.

Use undo header to delete a banner.

Syntax

header { legal | login | motd | shell } text

undo header { legal | login | motd | shell }

Default

No banner is configured.

Views

System view

Predefined user roles

network-admin

Parameters

legal: Configures the banner to be displayed before a user inputs the username and password to access the CLI.

login: Configures the banner to be displayed before password or scheme authentication is performed for a login user.

motd: Configures the greeting banner to be displayed before the legal banner appears.

shell: Configures the banner to be displayed before a user accesses user view.

text: Specifies the banner message. You can enter the banner message on the same line as the keywords or on different lines. For more information, see Fundamentals Configuration Guide.

Examples

# Configure the legal banner.

<Sysname> system-view

[Sysname] header legal

Please input banner content, and quit with the character '%'.

Welcome to use the legal banner%

itu-channel

Use itu-channel to set the ITU channel number for a transceiver module.

Use undo itu-channel to restore the default.

Syntax

itu-channel channel-number

undo itu-channel

Default

The ITU channel number is 1.

Views

Ethernet interface view

Predefined user roles

network-admin

Parameters

channel-number: Specifies the ITU channel number.

Usage guidelines

This command is supported only by the SFP-XG-LH80-Tunable Transceiver module.

The ITU channel number is saved in a register on the transceiver module. It is not saved to the configuration file.

Examples

# Set the ITU channel number to 2 for the transceiver module in Ten-GigabitEthernet 1/0/1.

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 1/0/1

[Sysname-Ten-GigabitEthernet1/0/1] itu-channel 2

Changing the channel number causes the service to be down for a while. Continue? [Y/N]:Y

Related commands

display transceiver itu-channel

job

Use job to assign a job to a schedule.

Use undo job to revoke a job.

Syntax

job job-name

undo job job-name

Default

No job is assigned to a schedule.

Views

Schedule view

Predefined user roles

network-admin

Parameters

job-name: Specifies the job name, a case-sensitive string of 1 to 47 characters.

Usage guidelines

You can assign multiple jobs to a schedule. The jobs in a schedule are executed concurrently.

The jobs to be assigned to a schedule must already exist. To create a job, use the scheduler job command.

Examples

# Assign the save-job job to the saveconfig schedule.

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] job save-job

Related commands

scheduler job

scheduler schedule

locator blink

Use locator blink blink-time to start LED flashing to locate devices.

Use locator blink stop to stop LED flashing.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

locator blink blink-time

locator blink stop

Views

User view

Predefined user roles

network-admin

Parameters

blink-time: Specifies the flash duration in seconds. The value range varies by device model.

stop: Stops flashing.

Usage guidelines

The device provides a LED for device locating. The locator blink blink-time command flashes the specified LEDs quickly for a period of time unless you execute the locator blink stop command. You can observe the LEDs to locate the devices.

Examples

# Start LED flashing to locate devices.

<Sysname> locator blink 30

# Stop LED flashing.

<Sysname> locator blink stop

memory-threshold

Use memory-threshold to set free-memory thresholds.

Use undo memory-threshold to restore the default.

Syntax

memory-threshold [ slot slot-number [ cpu cpu-number ] ] [ ratio ] minor minor-value severe severe-value critical critical-value normal normal-value [ early-warning early-warning-value secure secure-value ]

undo memory-threshold [ slot slot-number [ cpu cpu-number ] ]

Default

The free-memory thresholds vary by card model. To obtain the default free-memory thresholds, execute the display memory-threshold command.

Views

System view

Predefined user roles

network-admin

Parameters

ratio: Specifies free-memory thresholds in percentage. If you do not specify this keyword, the command sets free-memory thresholds in MB.

minor minor-value: Specifies the minor alarm threshold. To view the value range for this threshold, enter a question mark (?) in the place of the minor-value argument. This threshold must be equal to or less than the normal state threshold. Setting this threshold to 0 disables the minor alarm feature.

severe severe-value: Specifies the severe alarm threshold. To view the value range for this threshold, enter a question mark (?) in the place of the severe-value argument. This threshold must be equal to or less than the minor alarm threshold. Setting this threshold to 0 disables the severe alarm feature.

critical critical-value: Specifies the critical alarm threshold. To view the value range for this threshold, enter a question mark (?) in the place of the critical-value argument. This threshold must be equal to or less than the severe alarm threshold. Setting this threshold to 0 disables the critical alarm feature.

normal normal-value: Specifies the normal state threshold. To view the value range for this threshold, enter a question mark (?) in the place of the normal-value argument. This threshold must be equal to or less than the total memory size.

early-warning early-warning-value: Specifies the early-warning threshold. To view the value range for this threshold, enter a question mark (?) in the place of the early-warning-value argument. Setting this threshold to 0 disables the early warning feature.

secure secure-value: Specifies the sufficient-memory threshold. To view the value range for this threshold, enter a question mark (?) in the place of the secure-value argument.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command sets free-memory thresholds for the active MPU.

cpu cpu-number: Specifies a CPU by its number.

Usage guidelines

To ensure correct operation and improve memory efficiency, the system monitors the amount of free memory space in real time. If the amount of free memory space decreases to or below the minor, severe, or critical alarm threshold, the system issues an alarm to affected service modules or processes.

For slots that support low memory, the system monitors only the amount of free low-memory space. You can use the display memory command to display memory usage information. If the LowMem field is displayed for a slot, the slot supports low memory.

The early warning feature warns you of an approaching insufficient-memory condition.

If a memory alarm occurs, delete unused configuration items or disable some features to increase the free memory space. Because the memory space is insufficient, some configuration items might not be able to be deleted.

The system automatically restarts a card if the free memory size on the card reaches the severe alarm threshold.

For more information about the alarm thresholds, see device management configuration in Fundamentals Configuration Guide.

Examples

# Set the minor alarm, severe alarm, critical alarm, and normal state thresholds to 64 MB, 48 MB, 32 MB, and 96 MB, respectively.

<Sysname> system-view

[Sysname] memory-threshold minor 64 severe 48 critical 32 normal 96

# Set the minor alarm, severe alarm, critical alarm, and normal state thresholds to 3%, 2%, 1%, and 5% of the total memory size, respectively.

<Sysname> system-view

[Sysname] memory-threshold ratio minor 3 severe 2 critical 1 normal 5

Related commands

display memory-threshold

memory-threshold usage

Use memory-threshold usage to set the memory usage threshold.

Use undo memory-threshold usage to restore the default.

Syntax

memory-threshold [ slot slot-number [ cpu cpu-number ] ] usage memory-threshold

undo memory-threshold [ slot slot-number [ cpu cpu-number ] ] usage

Default

The memory usage threshold is 100%.

Views

System view

Predefined user roles

network-admin

Parameters

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command sets the memory usage threshold for the active MPU.

cpu cpu-number: Specifies a CPU by its number.

memory-threshold: Specifies the memory usage threshold in percentage. The value range is 0 to 100.

Usage guidelines

The device samples memory usage at 1-minute intervals. If the sample is greater than the memory usage threshold, the device sends a trap.

Examples

# Set the memory usage threshold to 80%.

<Sysname> system-view

[Sysname] memory-threshold usage 80

Related commands

display memory-threshold

memory-threshold usage resend-interval

Use memory-threshold usage resend-interval to set the memory usage alarm resending interval.

Use undo memory-threshold usage resend-interval to restore the default.

Syntax

memory-threshold [ slot slot-number [ cpu cpu-number ] ] usage resend-interval interval-value

undo memory-threshold [ slot slot-number [ cpu cpu-number ] ] usage resend-interval

Default

The memory usage alarm resending interval is 5 minutes.

Views

System view

Predefined user roles

network-admin

Parameters

interval-value: Specifies the memory usage alarm resending interval, in the range of 1 to 3600 minutes.

Usage guidelines

The device samples memory usage at intervals, and compares the samples with memory usage thresholds to identify the memory usage status and send alarms or notifications accordingly.

Examples

# Set the memory usage alarm resending interval to 300 minutes for a slot.

<Sysname> system-view

[Sysname] memory-threshold slot 1 cpu 0 usage resend-interval 300

Related commands

memory-threshold usage

monitor cpu-usage enable

Use monitor cpu-usage enable to enable CPU usage monitoring.

Use undo monitor cpu-usage enable to disable CPU usage monitoring.

Syntax

monitor cpu-usage enable [ slot slot-number [ cpu cpu-number ] ]

undo monitor cpu-usage enable [ slot slot-number [ cpu cpu-number ] ]

Default

CPU usage monitoring is enabled.

Views

System view

Predefined user roles

network-admin

Parameters

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command enables CPU usage monitoring for the active MPU.

cpu cpu-number: Specifies a CPU by its number.

Usage guidelines

After CPU usage monitoring is enabled, the system samples and saves CPU usage at the interval specified by the monitor cpu-usage interval command. You can use the display cpu-usage history command to view recent CPU usage.

Examples

# Enable CPU usage monitoring.

<Sysname> system-view

[Sysname] monitor cpu-usage enable

Related commands

display cpu-usage configuration

display cpu-usage history

monitor cpu-usage interval

monitor cpu-usage interval

Use monitor cpu-usage interval to set the sampling interval for CPU usage monitoring.

Use undo monitor cpu-usage interval to restore the default.

Syntax

monitor cpu-usage interval interval [ slot slot-number [ cpu cpu-number ] ]

undo monitor cpu-usage interval [ slot slot-number [ cpu cpu-number ] ]

Default

The system samples CPU usage every 1 minute.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Specifies the sampling interval for CPU usage monitoring. Valid values include 5Sec (5 seconds), 1Min (1 minute), and 5Min (5 minutes), case insensitive.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command sets the interval for the active MPU.

cpu cpu-number: Specifies a CPU by its number.

Usage guidelines

After CPU usage monitoring is enabled, the system samples and saves CPU usage at the specified interval. You can use the display cpu-usage history command to view recent CPU usage.

Examples

# Set the sampling interval for CPU usage monitoring to 5 seconds.

<Sysname> system-view

[Sysname] monitor cpu-usage interval 5Sec

Related commands

display cpu-usage configuration

display cpu-usage history

monitor cpu-usage enable

monitor cpu-usage statistics-interval core

Use monitor cpu-usage statistics-interval core to set CPU core usage statistics intervals.

Use undo monitor cpu-usage statistics-interval core to restore the default.

Syntax

monitor cpu-usage statistics-interval interval slot slot-number cpu cpu-number core core-id-list

undo monitor cpu-usage statistics-interval slot slot-number cpu cpu-number core core-id-list

Default

The CPU core usage statistics interval is 60 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Specifies the CPU core usage statistics interval in seconds. The value range for this argument is 10 to 3600. As a best practice, set this argument to a multiple of the sampling interval, which is fixed at 5 seconds. If you do not do so, the effective statistics interval is the biggest multiple of the sampling interval that is smaller than the setting. For example, if you set this argument to 12 seconds, the effective statistics interval is 10 seconds.

slot slot-number: Specifies a card by its slot number.

cpu cpu-number: Specifies a CPU by its number.

core core-id-list: Specifies a space-separated list of up to 10 CPU core items. Each item specifies a CPU core or a range of CPU cores in the form of core-id1 [ to core-id2 ]. The value for core-id2 must be greater than or equal to the value for core-id1.

Usage guidelines

The device samples CPU core usage at 5-second intervals and calculates the average value during each CPU core usage statistics interval. If the value during an interval is greater than a CPU core usage alarm threshold, the device issues an alarm and logs the event.

Examples

# Set the usage statistics interval to 60 seconds for a CPU core.

<Sysname> system-view

[Sysname] monitor cpu-usage statistics-interval 60 slot 1 cpu 0 core 0

Related commands

monitor resend cpu-usage core-interval

monitor cpu-usage threshold

Use monitor cpu-usage threshold to set the CPU usage threshold.

Use undo monitor cpu-usage threshold to restore the default.

Syntax

monitor cpu-usage threshold cpu-threshold [ minor-threshold minor-threshold recovery-threshold recovery-threshold ] [ slot slot-number [ cpu cpu-number ] ]

undo monitor cpu-usage threshold [ minor-threshold recovery-threshold ] [ slot slot-number [ cpu cpu-number ] ]

Default

The severe CPU usage alarm threshold is 99%. The minor CPU usage alarm threshold is 79%.

Views

System view

Predefined user roles

network-admin

Parameters

cpu-threshold: Specifies the severe CPU usage alarm threshold in percentage. The value range for this argument is 2 to 100.

minor-threshold minor-threshold: Specifies the minor CPU usage alarm threshold in percentage. The value range for this argument is 1 to the severe CPU usage alarm threshold minus 1. If you do not specify this option, the minor CPU usage alarm threshold is 80 percent of the severe CPU usage alarm threshold.

recovery-threshold recovery-threshold: Specifies the CPU usage recovery threshold in percentage. The value range for this argument is 0 to the minor CPU usage alarm threshold minus 1. If you do not specify this option, the CPU usage recovery threshold is 70 percent of the severe CPU usage alarm threshold.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command sets the CPU usage threshold for the active MPU.

cpu cpu-number: Specifies a CPU by its number.

Usage guidelines

CAUTION

CAUTION:

If you set the severe CPU usage alarm threshold to a too low value, the device will reach the threshold easily. Normal services will be affected.

The device samples CPU usage at 1-minute intervals. If the sample is greater than a CPU usage alarm threshold, the device sends a trap. If the sample is equal to or less than the CPU usage recovery threshold, the device determines that the CPU usage is normal.

Examples

# Set the severe CPU usage threshold to 80%.

<Sysname> system-view

[Sysname] monitor cpu-usage threshold 80

Related commands

display cpu-usage configuration

monitor cpu-usage threshold core

Use monitor cpu-usage threshold core to set CPU core usage alarm thresholds.

Use undo monitor cpu-usage threshold core to restore the default.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

monitor cpu-usage threshold severe-threshold [ minor-threshold minor-threshold recovery-threshold recovery-threshold ] slot slot-number cpu cpu-number core core-id-list

undo monitor cpu-usage threshold [ minor-threshold recovery-threshold ] slot slot-number cpu cpu-number core core-id-list

Default

No CPU core usage alarm thresholds are set.

Views

System view

Predefined user roles

network-admin

Parameters

severe-threshold: Specifies the severe CPU core usage alarm threshold in percentage. The value range for this argument is 2 to 100.

minor-threshold minor-threshold: Specifies the minor CPU core usage alarm threshold in percentage. The value range for this argument is 1 to the severe CPU core usage alarm threshold minus 1. If you do not specify this option, the minor CPU core usage alarm threshold is 80 percent of the severe CPU core usage alarm threshold.

recovery-threshold recovery-threshold: Specifies the CPU core usage recovery threshold in percentage. The value range for this argument is 0 to the minor CPU core usage alarm threshold minus 1. If you do not specify this option, the CPU core usage recovery threshold is 70 percent of the severe CPU core usage alarm threshold.

slot slot-number: Specifies a card by its slot number.  

cpu cpu-number: Specifies a CPU by its number.

core core-id-list: Specifies a space-separated list of up to 10 CPU core items. Each item specifies a CPU core or a range of CPU cores in the form of core-id1 [ to core-id2 ]. The value for core-id2 must be greater than or equal to the value for core-id1.

Usage guidelines

The device samples CPU core usage at 5-second intervals and calculates the average value during each CPU core usage statistics interval. If the value during an interval is greater than a CPU core usage alarm threshold, the device issues an alarm and logs the event.

Examples

# Set the severe CPU core usage alarm threshold to 90% for a CPU core.

<Sysname> system-view

[Sysname] monitor cpu-usage threshold 90 slot 1 cpu 0 core 0

Related commands

display cpu-usage configuration

monitor cpu-usage statistics-interval core

monitor resend cpu-usage

Use monitor resend cpu-usage to set CPU usage alarm resending intervals.

Use undo monitor resend cpu-usage to restore the default.

Syntax

monitor resend cpu-usage { minor-interval minor-interval | severe-interval severe-interval } * [ slot slot-number [ cpu cpu-number ] ]

undo monitor resend cpu-usage [ minor-interval | severe-interval ] [ slot slot-number [ cpu cpu-number ] ]

Default

The minor CPU usage alarm resending interval is 300 seconds. The severe CPU usage alarm resending interval is 60 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

minor-interval minor-interval: Specifies the minor CPU usage alarm resending interval in seconds, a multiple of 5 in the range of 10 to 3600.

severe-interval severe-interval: Specifies the severe CPU usage alarm resending interval in seconds, a multiple of 5 in the range of 10 to 3600.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command sets the interval for the active MPU.

cpu cpu-number: Specifies a CPU by its number.

Usage guidelines

The device samples CPU usage at intervals, and compares the samples with CPU usage thresholds to identify the CPU usage status and send alarms or notifications accordingly.

In minor alarm state, the device sends minor alarms periodically until the CPU usage increases above the severe threshold or the minor alarm is removed. In severe alarm state, the device sends severe alarms periodically until the severe alarm is removed. This command sets the alarm resending intervals.

If you do not specify a keyword for the undo monitor resend cpu-usage command, the command restores the default minor and severe CPU usage alarm resending intervals.

Examples

# Set the minor CPU usage alarm resending interval to 60 seconds for a slot.

<Sysname> system-view

[Sysname] monitor resend cpu-usage minor-interval 60 slot 1 cpu 0

monitor resend cpu-usage core-interval

Use monitor resend cpu-usage core-interval to set CPU core usage alarm resending intervals.

Use undo monitor resend cpu-usage core-interval to restore the default.

Syntax

monitor resend cpu-usage core-interval { minor-interval minor-interval | severe-interval severe-interval } * [ slot slot-number [ cpu cpu-number ] ]

undo monitor resend cpu-usage core-interval [ minor-interval | severe-interval ] [ slot slot-number [ cpu cpu-number ] ]

Default

The resending intervals for minor CPU core usage alarms and severe CPU core usage alarms are all 300 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

minor-interval minor-interval: Specifies the resending interval for minor CPU core usage alarms in seconds, a multiple of 5 in the range of 10 to 3600.

severe-interval severe-interval: Specifies the resending interval for severe CPU core usage alarms in seconds, a multiple of 5 in the range of 10 to 3600.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command sets the interval for the active MPU.

cpu cpu-number: Specifies a CPU by its number.

Usage guidelines

The device samples CPU core usage at intervals, and compares the samples with CPU core usage thresholds to identify the CPU core usage status and send alarms or notifications accordingly.

In minor alarm state, the device sends minor alarms periodically until the CPU core usage increases above the severe threshold or the minor alarm is removed. In severe alarm state, the device sends severe alarms periodically until the severe alarm is removed. This command sets the alarm resending intervals.

Examples

# Set the resending interval for minor CPU core usage alarms to 100 seconds and the resending interval for severe CPU core usage alarms 60 seconds.

<Sysname> system-view

[Sysname] monitor resend cpu-usage core-interval minor-interval 100 severe-interval 60

monitor resend memory-threshold

Use monitor resend memory-threshold to set memory depletion alarm resending intervals.

Use undo monitor resend memory-threshold to restore the default.

Syntax

monitor resend memory-threshold { critical-interval critical-interval | early-warning-interval early-warning-interval | minor-interval minor-interval | severe-interval severe-interval } * [ slot slot-number [ cpu cpu-number ] ]

undo monitor resend memory-threshold [ critical-interval | early-warning-interval | minor-interval | severe-interval ] * [ slot slot-number [ cpu cpu-number ] ]

Default

·     Early warning resending interval: 1 hour.

·     Minor alarm resending interval: 12 hours.

·     Severe alarm resending interval: 3 hours.

·     Critical alarm resending interval: 1 hour.

Views

System view

Predefined user roles

network-admin

Parameters

critical-interval critical-interval: Specifies the critical alarm resending interval in hours, in the range of 1 to 48.

early-warning-interval early-warning-interval: Specifies the early warning resending interval in hours, in the range of 1 to 48.

minor-interval minor-interval: Specifies the minor alarm resending interval in hours, in the range of 1 to 48.

severe-interval severe-interval: Specifies the severe alarm resending interval in hours, in the range of 1 to 48.

slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command sets alarm resending intervals for the active MPU.

cpu cpu-number: Specifies a CPU by its number.

Usage guidelines

The device samples the amount of free memory space periodically and compares the sample with free-memory thresholds. If the sample decreases to or below a threshold, the device enters a memory depletion alarm state and sends an alarm.

In critical alarm state, the device sends critical alarm notifications periodically until the critical alarm is removed.

In a lower alarm state, the device sends notifications for the alarm state periodically until it enters a higher alarm state or the current alarm is removed.

You can use this command to change the alarm resending intervals.

If you do not specify any memory depletion alarm resending intervals, the undo monitor resend memory-threshold command restores default settings for all memory depletion alarm resending intervals.

Examples

# Set the minor memory depletion alarm resending interval to 12 hours for CPU 0 in slot 1.

<Sysname> system-view

[Sysname] monitor resend memory-threshold minor-interval 12 slot 1 cpu 0

Related commands

memory-threshold

monitor disable-port

Use monitor disable-port to enable shutdown of all service ports.

Use undo monitor disable-port to disable shutdown of all service ports.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

monitor { handshake-timeout | fab-absent } disable-port

undo monitor { handshake-timeout | fab-absent } disable-port

Default

By default, shutdown of service ports is enabled.

Views

System view

Predefined user roles

network-admin

Parameters

handshake-timeout: Shuts down all service ports when the connection between the MPU and service modules times out.

fab-absent: Shuts down all service ports when no fabric modules are detected.

Usage guidelines

This command is typically used in active/standby dual host scenarios (such as VRRP). After the monitor disable-port command is executed, the system will shut down all service ports on the active device when the connection between the MPU and the service modules on the active device times out, or no fabric modules are detected. As a consequence, all services will be switched to the standby device rapidly.

Examples

# Disable shutdown of all service ports when the connection between the MPU and service module times out.

<Sysname> system-view

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

[Sysname] monitor handshake-timeout disable-port

 

Set successful!

parity-error consistency-check log enable

Use parity-error consistency-check log enable to enable consistency error logging for software and hardware forwarding entries.

Use undo parity-error consistency-check log enable to disable consistency error logging for software and hardware forwarding entries.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

parity-error consistency-check log enable

undo parity-error consistency-check log enable

Default

Consistency error logging is disabled for software and hardware forwarding entries.

Views

System view

Predefined user roles

network-admin

Usage guidelines

To forward packets, the device generates hardware forwarding entries in forwarding chips and software forwarding entries in memory at the same time. The device automatically detects whether the hardware forwarding entries and the software forwarding entries are consistent.

After you execute this command, the device collects consistency errors periodically. If the number of consistency errors in a statistics period reaches or exceeds the logging threshold, the device generates a log message.

Examples

# Enable consistency error logging for software and hardware forwarding entries.

<Sysname> system-view

[Sysname] parity-error consistency-check log enable

Related commands

parity-error consistency-check threshold

parity-error consistency-check threshold

Use parity-error consistency-check threshold to set the logging threshold for consistency errors between software and hardware forwarding entries.

Use undo parity-error consistency-check threshold to restore the default.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

parity-error consistency-check threshold value

undo parity-error consistency-check threshold

Default

The logging threshold is 10.

Views

System view

Predefined user roles

network-admin

Parameters

value: Specifies the logging threshold for consistency errors between software and hardware forwarding entries, in the range of 1 to 2147483647.

Usage guidelines

To forward packets, the device generates hardware forwarding entries in forwarding chips and software forwarding entries in memory at the same time. The device automatically detects whether the hardware forwarding entries and the software forwarding entries are consistent.

After you enable consistency error logging for software and hardware forwarding entries, the device collects statistics for consistency errors periodically. If the number of consistency errors reaches or exceeds the logging threshold, the device generates a log message.

Examples

# Set the logging threshold to 20 for consistency errors between software and hardware forwarding entries.

<Sysname> system-view

[Sysname] parity-error consistency-check threshold 20

Related commands

parity-error consistency-check log enable

parity-error monitor log enable

Use parity-error monitor log enable to enable parity error logging for entries on forwarding chips.

Use undo parity-error monitor log enable to disable parity error logging for entries on forwarding chips.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

parity-error monitor log enable

undo parity-error monitor log enable

Default

Parity error logging is disabled for entries on forwarding chips.

Views

System view

Predefined user roles

network-admin

Usage guidelines

The device detects parity errors in entries on forwarding chips. The parity error logging feature collects parity error statistics periodically and generates log messages as defined.

Examples

# Enable parity error logging for entries on forwarding chips.

<Sysname> system-view

[Sysname] parity-error monitor log enable

Related commands

parity-error monitor period

parity-error monitor threshold

parity-error monitor period

Use parity-error monitor period to set the parity error statistics period for entries on forwarding chips.

Use undo parity-error monitor period to restore the default.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

parity-error monitor period value

undo parity-error monitor period

Default

The parity error statistics period is 600 seconds for entries on forwarding chips.

Views

System view

Parameters

value: Specifies the parity error statistics period in seconds, in the range of 1 to 86400.

Predefined user roles

network-admin

Usage guidelines

The device detects parity errors in entries on forwarding chips. The parity error logging feature collects parity error statistics periodically. This command sets the statistics period.

Examples

# Set the parity error statistics period to 120 seconds.

<Sysname> system-view

[Sysname] parity-error monitor period 120

Related commands

parity-error monitor log enable

parity-error monitor threshold

parity-error monitor threshold

Use parity-error monitor threshold to set the parity error logging threshold for entries on forwarding chips.

Use undo parity-error monitor threshold to restore the default.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

parity-error monitor threshold value

undo parity-error monitor threshold

Default

The parity error logging threshold is 5000 for entries on forwarding chips.

Views

System view

Parameters

value: Specifies the parity error logging threshold for entries on forwarding chips, in the range of 1 to 1000000.

Predefined user roles

network-admin

Usage guidelines

The device detects parity errors in entries on forwarding chips. The parity error logging feature collects parity error statistics periodically, and generates a log message if the number of parity errors reaches the logging threshold. This command sets the logging threshold.

Examples

# Set the parity error logging threshold to 8000 for entries on forwarding chips.

<Sysname> system-view

[Sysname] parity-error monitor threshold 8000

Related commands

parity-error monitor log enable

parity-error monitor period

parity-error unrecoverable log enable

Use parity-error unrecoverable log enable to enable uncorrectable parity error and ECC error logging for entries on forwarding chips.

Use undo parity-error unrecoverable log enable to disable uncorrectable parity error and ECC error logging for entries on forwarding chips.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

parity-error unrecoverable log enable

undo parity-error unrecoverable log enable

Default

Uncorrectable parity error and ECC error logging is enabled for entries on forwarding chips

Views

System view

Predefined user roles

network-admin

Usage guidelines

The device automatically detects parity errors and ECC errors in entries on forwarding chips and tries to correct the error when an error is detected. The uncorrectable parity error and ECC error logging feature enables the device to collect uncorrectable parity error and ECC error statistics periodically. If the number of uncorrectable parity errors and ECC errors reaches or exceeds the logging threshold, the device generates and sends an uncorrectable parity error and ECC error log message to the information center module. The information center module determines how and where to send the log message. For more information about the information center module, see information center configuration in Network Management and Monitoring Configuration Guide.

Examples

# Enable uncorrectable parity error and ECC error logging for entries on forwarding chips

<Sysname> system-view

[Sysname] parity-error unrecoverable log enable

Related commands

parity-error unrecoverable period

parity-error unrecoverable reboot

parity-error unrecoverable threshold

parity-error unrecoverable period

Use parity-error unrecoverable period to set the statistics period for uncorrectable parity errors and ECC errors for entries on forwarding chips.

Use undo parity-error unrecoverable period to restore the default.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

parity-error unrecoverable period period

undo parity-error unrecoverable period

Default

The statistics period for uncorrectable parity errors and ECC errors for entries on forwarding chips is 600 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

period: Specifies the statistics period for uncorrectable parity errors and ECC errors for entries on forwarding chips. The value is in the range of 1 to 86400, in seconds.

Usage guidelines

The device automatically detects parity errors and ECC errors in entries on forwarding chips and tries to correct the error when an error is detected. The uncorrectable parity error and ECC error logging feature enables the device to collect uncorrectable parity error and ECC error statistics periodically. If the number of uncorrectable parity errors and ECC errors reaches or exceeds the logging threshold, the device generates an uncorrectable parity error and ECC error log message.

This command sets the period for the device to collect uncorrectable parity error and ECC error statistics.

Examples

# Set the statistics period for uncorrectable parity errors and ECC errors in entries on forwarding chips to 120 seconds.

<Sysname> system-view

[Sysname] parity-error unrecoverable period 120

Related commands

parity-error unrecoverable log enable

parity-error unrecoverable reboot

parity-error unrecoverable threshold

parity-error unrecoverable reboot

Use parity-error unrecoverable reboot to enable automatic system reboot upon generation of an uncorrectable parity error and ECC error log.

Use undo parity-error unrecoverable reboot to disable automatic system reboot upon generation of an uncorrectable parity error and ECC error log.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

parity-error unrecoverable reboot

undo parity-error unrecoverable reboot

Default

The system reboots automatically upon generation of an uncorrectable parity error and ECC error log.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Uncorrectable parity errors and ECC errors in entries on forwarding chips might affect system services. To remove the errors from the entries on forwarding chips, you can execute this command to enable automatic system reboot upon generation of an uncorrectable parity error and ECC error log.

Examples

# Enable automatic system reboot upon generation of an uncorrectable parity error and ECC error log.

<Sysname> system-view

[Sysname] parity-error unrecoverable reboot

Related commands

parity-error unrecoverable log enable

parity-error unrecoverable period

parity-error unrecoverable threshold

parity-error unrecoverable threshold

Use parity-error unrecoverable threshold to set the logging threshold for uncorrectable parity errors and ECC errors on entries on forwarding chips.

Use undo parity-error unrecoverable threshold to restore the default.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

parity-error unrecoverable threshold value

undo parity-error unrecoverable threshold

Default

The logging threshold for uncorrectable parity errors and ECC errors in entries on forwarding chips is 1.

Views

System view

Predefined user roles

network-admin

Parameters

value: Specifies the logging threshold for uncorrectable parity errors and ECC errors in entries on forwarding chips. The value is in the range of 1 to 1000000.

Usage guidelines

The device automatically detects parity errors and ECC errors in entries on forwarding chips and tries to correct the error when an error is detected. The uncorrectable parity error and ECC error logging feature enables the device to collect uncorrectable parity error and ECC error statistics periodically. If the number of uncorrectable parity errors and ECC errors reaches or exceeds the logging threshold, the device generates an uncorrectable parity error and ECC error log message.

This command sets the logging threshold.

Examples

# Set the logging threshold for uncorrectable parity errors and ECC errors in entries on forwarding chips to 10.

<Sysname> system-view

[Sysname] parity-error unrecoverable log threshold 10

Related commands

parity-error unrecoverable log enable

parity-error unrecoverable period

parity-error unrecoverable reboot

password-recovery enable

Use password-recovery enable to enable password recovery capability.

Use undo password-recovery enable to disable password recovery capability.

Syntax

password-recovery enable

undo password-recovery enable

Default

Password recovery capability is enabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

Password recovery capability controls console user access to the device configuration and SDRAM from BootWare menus.

If password recovery capability is enabled, a console user can access the device configuration without authentication to configure new passwords.

If password recovery capability is disabled, console users must restore the factory-default configuration before they can configure new passwords. Restoring the factory-default configuration deletes the next-startup configuration files.

To enhance system security, disable password recovery capability.

To access the device configuration without authentication, you must connect to the active MPU and access the BootWare menu while the MPU is starting up.

Availability of BootWare menu options depends on the password recovery capability setting. For more information, see the release notes.

Examples

# Disable password recovery capability.

<Sysname> system-view

[Sysname] undo password-recovery enable

power-exception-monitor

Use power-exception-monitor to configure the exception monitoring mode for power modules.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

power-exception-monitor { normal | enhanced }

Default

The normal exception monitoring mode applies to power modules.

Views

System view

Predefined user roles

network-admin

Parameters

normal: Generates alarm information when a power module exception occurs.

enhanced: Monitors power modules continuously and generates alarm information when a temperature, voltage, or current exception occurs on a power module.

Usage guidelines

The enhanced exception monitoring mode for power modules occupies lots of system resources.

Examples

# Set the exception monitoring mode for power modules to normal.

<Sysname> system-view

[Sysname] power-exception-monitor normal

power-monitor enable

Use power-monitor enable to enable power on/off management of cards.

Use undo power-monitor enable to disable power on/off management of cards.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

power-monitor enable

undo power-monitor enable

Default

Power on/off management of cards is enabled.

Views

System view

Predefined user roles

network-admin

Parameters

chassis chassis-number: Specifies an IRF member device by its member ID.

Usage guidelines

CAUTION

CAUTION:

Disabling power on/off management of cards might result in unpredictable risks. Execute the undo power-monitor enable command with caution.

 

After the power-monitor enable command is executed, the system performs the following operations:

·     Check the total system power and the power distribution on the cards to determine whether to power on cards.

·     Check the card temperature and fan tray conditions to determine whether to power off cards.

If power on/off management of cards is disabled, the device will not manage the power-on and -off of the cards, and all cards are powered on by default.

Examples

# Enable power on/off management of cards.

<Sysname> system-view

[Sysname] power-monitor enable

power-supply policy enable

Use power-supply policy enable to enable power supply management.

Use undo power-supply policy enable to disable power supply management.

Syntax

power-supply policy enable

undo power-supply policy enable

Default

Power supply management is disabled.

Views

System view

Predefined user roles

network-admin

Examples

# Enable power supply management.

<Sysname> system-view

[Sysname] power-supply policy enable

power-supply policy redundant

Use power-supply policy redundant to specify the number of redundant power modules.

Use undo power-supply policy redundant to restore the default.

Syntax

power-supply policy redundant module-count

undo power-supply policy redundant

Default

The number of redundant power modules is 0.

Views

System view

Predefined user roles

network-admin

Parameters

module-count: Specifies the number of redundant power modules. To view the value range for this argument, enter a question mark (?) in the place of this argument. The upper limit for the value range is the maximum number of redundant power modules supported by the system. The actual number of redundant power modules that you can specify varies by the number of the interface cards and their power consumption. The actual number is smaller than or equal to the maximum number.

Usage guidelines

This command takes effect only if power supply management is enabled.

Examples

# Set the number of redundant power modules to 1.

<Sysname> system-view

[Sysname] power-supply policy redundant 1

Related commands

power-supply policy enable

power-supply surplus-power enable

Use power-supply surplus-power enable to enable power module sleeping.

Use undo power-supply surplus-power enable to disable power module sleeping.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

power-supply surplus-power enable

undo power-supply surplus-power enable

Views

System view

Predefined user roles

network-admin

Usage guidelines

This feature is supported only on switches that contain the PSR2400-54A, PSR2400-54D, or PSR3000-54A power module.

This feature takes effect only when power supply management is enabled.

Power modules in sleeping state cannot act as the backup power modules. When an operating power module fails or is removed, the device might not be able to operate correctly.

To view the operating status of power modules, execute the display power command.

This feature enables the device to monitor the remaining power in real time.

·     If the remaining power is greater than the power of a power module, the device places the power module into sleeping state.

·     When the remaining power becomes insufficient, the device wakes up a sleeping power module.

Examples

# Enable power module sleeping.

<Sysname> system-view

[Sysname] power-supply surplus-power enable

Related commands

power-supply policy enable

reboot

Use reboot to reboot the device.

Syntax

reboot [ slot slot-number ] [ force ]

Views

User view

Predefined user roles

network-admin

Parameters

slot slot-number: Specifies a card by its slot number. If you do not specify a card, the command reboots the entire device.

force: Reboots the device immediately without performing software or hard disk check. If this keyword is not specified, the system first identifies whether the reboot might result in data loss or a system failure. For example, the system identifies whether the main system software image file exists and whether a write operation is in progress on a storage medium. If the reboot might cause problems, the system does not reboot the device.

Usage guidelines

CAUTION

CAUTION:

·     A reboot might interrupt network services.

·     Use the force keyword only when the device fails or a reboot command without the force keyword cannot perform a reboot correctly. A reboot command with the force keyword might result in file system corruption because it does not perform data protection.

If the main startup software images are corrupt or missing, you must re-specify a set of main startup software images before executing the reboot command.

For data security, the device does not reboot if you reboot the device while the device is performing file operations.

If the device does not have a standby MPU, rebooting the active MPU reboots the entire device. If the device has a standby MPU and the standby MPU is operating correctly, rebooting the active MPU triggers a switchover.

To ensure correct operation of the system and cards, do not trigger a switchover by rebooting the active MPU if the standby MPU is not in Stable state. To view the status of the standby MPU, execute the display system stable state command.

Examples

# Reboot the device. Save the running configuration at prompt.

<Sysname> reboot

Start to check configuration with next startup configuration file, please wait.........DONE!

Current configuration will be lost after the reboot, save current configuration? [Y/N]:y

Please input the file name(*.cfg)[flash:/startup.cfg]

(To leave the existing filename unchanged, press the enter key):

flash:/startup.cfg exists, overwrite? [Y/N]:y

Validating file. Please wait...

Configuration is saved to mainboard device successfully.

This command will reboot the device. Continue? [Y/N]:y

Now rebooting, please wait...

# Reboot the device immediately without performing software check.

<Sysname> reboot force

A forced reboot might cause the storage medium to be corrupted. Continue? [Y/N]:y

Now rebooting, please wait...

Related commands

display system stable state

reset asset-info

Use reset asset-info to clear the asset profile for a physical component.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

reset asset-info { chassis | fan fan-id | power power-id | slot slot-number } [ csn | custom | department | description | location | service-date | state ]

Views

System view

Predefined user roles

network-admin

network-operator

Parameters

chassis: Clears the asset profile for the frame.

fan fan-id: Clears the asset profile of the specified fan tray. The value range for the fan-id argument is 1 to 6.

power power-id: Clears the asset profile for the specified power module. The value range for the power-id argument is 1 to 36.

slot slot-number: Clears the asset profile for the card in the specified slot.

csn: Clears the asset ID.

custom: Clears customized asset items.

department: Clears the department name.

description: Clears the asset description.

location: Clears the asset location.

service-date: Clears the service start date.

state: Clears the usage status

Usage guidelines

To clear an item in an asset profile, specify the corresponding keyword for the command. To clear all items in an asset profile, do not specify the item keywords.

If you specify a fan tray or power module that does not exist, the system prompts that the fan tray or power module is absent.

Examples

# Clear the asset ID for card 0.

<Sysname> system-view

[Sysname] reset asset-info slot 0 csn

Related commands

display asset-info

set asset-info

reset scheduler logfile

Use reset scheduler logfile to clear job execution log information.

Syntax

reset scheduler logfile

Views

User view

Predefined user roles

network-admin

Examples

# Clear job execution log information.

<Sysname> reset scheduler logfile

Related commands

display scheduler logfile

reset version-update-record

Use reset version-update-record to clear startup software image upgrade records.

Syntax

reset version-update-record

Views

System view

Predefined user roles

network-admin

Examples

# Clear the startup software image upgrade records.

<Sysname> system-view

[Sysname] reset version-update-record

This command will delete all records of version update. Continue? [Y/N]:y

Related commands

display version-update-record

resource-monitor minor resend enable

Use resource-monitor minor resend enable to enable resending of minor resource depletion alarms.

Use undo resource-monitor minor resend enable to disable resending of minor resource depletion alarms.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

resource-monitor minor resend enable

undo resource-monitor minor resend enable

Default

Resending of minor resource depletion alarms is enabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

When a resource type enters minor alarm state, the device issues a minor alarm. If the resource type stays in minor alarm state or changes from severe alarm state to minor alarm state, the device identifies whether resending of minor resource depletion alarms is enabled. If the feature is disabled, the device does not issue additional minor alarms. If the feature is enabled, the device resends minor alarms periodically.

The resending interval of severe alarms is 24 hours and the resending interval of minor alarms is 7×24 hours.

Examples

# Enable resending of minor resource depletion alarms.

<sysname> system-view

[Sysname] resource-monitor minor resend enable

Related commands

display resource-monitor

resource-monitor output

resource-monitor resource

resource-monitor output

Use resource-monitor output to specify destinations for resource depletion alarms.

Use undo resource-monitor output to remove destinations for resource depletion alarms.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

resource-monitor output { netconf-event | snmp-notification | syslog } *

undo resource-monitor output [ netconf-event | snmp-notification | syslog ]*

Default

Resource depletion alarms are sent to NETCONF, SNMP, and the information center.

Views

System view

Predefined user roles

network-admin

Parameters

netconf-event: Sends resource depletion alarms to the NETCONF feature to encapsulate the alarms in NETCONF events. For more information, see NETCONF in Network Management and Monitoring Configuration Guide.

snmp-notification: Sends resource depletion alarms to the SNMP feature to encapsulate the alarms in SNMP traps and informs. For more information, see SNMP in Network Management and Monitoring Configuration Guide.

syslog: Sends resource depletion alarms to the information center to encapsulate the alarms in log messages. For more information, see information center in Network Management and Monitoring Configuration Guide.

Usage guidelines

If you do not specify any keywords for the undo resource-monitor output command, the command disables resource depletion alarm output.

Examples

# Specify the information center module as the output destination for resource depletion alarms.

<Sysname> system-view

[Sysname] resource-monitor output syslog

Related commands

resource-monitor minor resend enable

resource-monitor resource

resource-monitor resource

Use resource-monitor resource to set resource depletion thresholds.

Use undo resource-monitor resource to disable resource depletion thresholds.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

resource-monitor resource resource-name slot slot-number cpu cpu-number by-percent minor-threshold minor-threshold severe-threshold severe-threshold

undo resource-monitor resource resource-name slot slot-number cpu cpu-number

Default

The default settings vary by resource type. Use the display resource-monitor command to display the resource depletion thresholds.

Views

System view

Predefined user roles

network-admin

Parameters

resource-name: Specifies a resource type by its name. The values for this argument are case insensitive and cannot be abbreviated. Table 27 shows the resource types that can be monitored.

Table 27 Resource types that can be monitored

Resource type

Description

ac

VXLAN service instance resources

agg_group

Aggregation group resources.

arp

ARP resources.

arp_encap

Egress encapsulation database resources.

ecmp_fec_1

ECMP FEC resources.

ecmp_fec_2

Cascaded ECMP FEC hardware resources.

global_ecmp

Global ECMP group resources.

global_fec

Global FEC resources.

lem

Exact-match resources.

local_ecmp

Local ECMP group resources.

local_fec

Local FEC resources.

mac

MAC address table resources.

mc

Multicast resources.

mqcin

Inbound MQC resources.

mqcout

Outbound MQC resources.

nd

ND resources.

openflow

OpenFlow resources.

pbr

PBR resources.

pfilterin

Inbound packet filter resources.

pfilterout

Outbound packet filter resources.

route

Routing resources.

rport

Layer 3 Ethernet interface resources.

subrport

Layer 3 Ethernet subinterface resources.

vlaninterface

VLAN interface resources.

vrf

VPN instance resources.

vsi

VSIs.

vsiintf

VSI interface resources.

slot slot-number: Specifies a card by its slot number.

cpu cpu-number: Specifies a CPU by its number.

by-percent: Specifies resource depletion thresholds in percentage.

minor-threshold minor-threshold: Specifies the minor resource depletion threshold. To view the value range, enter a question mark (?) in the place of the minor-threshold argument.

severe-threshold severe-threshold: Specifies the severe resource depletion threshold. To view the value range, enter a question mark (?) in the place of the severe-threshold argument.

Usage guidelines

After you execute this command for a resource type, the device monitors the available amount of the type of resource. The device samples the available amount at intervals, compares the sample with the resource depletion thresholds to identify the resource depletion status, and sends alarms as configured.

Examples

# Set the minor resource depletion threshold to 30% and the severe resource depletion threshold to 10% for ARP entry resources on slot 1.

<Sysname> system-view

[Sysname] resource-monitor resource arp slot 1 cpu 0 by-percent minor-threshold 30 severe-threshold 10

Related commands

display resource-monitor

resource-monitor minor resend enable

resource-monitor output

restore factory-default

Use restore factory-default to restore the factory-default configuration for the device.

Syntax

restore factory-default

Views

User view

Predefined user roles

network-admin

Usage guidelines

CAUTION

CAUTION:

This command restores the device to the factory default settings. Before using this command, make sure you fully understand its impact on your live network.

CAUTION

CAUTION:

This command restores the device to the factory default settings. Before using this command, make sure you fully understand its impact on your live network.

The command takes effect after the device reboots.

Use this command only when you cannot troubleshoot the device by using other methods, or you want to use the device in a different scenario.

Examples

# Restore the factory-default configuration for the device.

<Sysname> restore factory-default

This command will restore the system to the factory default configuration and clear the operation data. Continue [Y/N]:y

Restoring the factory default configuration. This process might take a few minutes. Please wait..........................................................................................................Done.

Please reboot the system to place the factory default configuration into effect.

Related commands

reboot

scheduler job

Use scheduler job to create a job and enter its view, or enter the view of an existing job.

Use undo scheduler job to delete a job.

Syntax

scheduler job job-name

undo scheduler job job-name

Default

No job exists.

Views

System view

Predefined user roles

network-admin

Parameters

job-name: Specifies the job name, a case-sensitive string of 1 to 47 characters.

Usage guidelines

A job can be referenced by multiple schedules. In job view, you can assign commands to the job.

Examples

# Create a job named backupconfig and enter job view.

<Sysname> system-view

[Sysname] scheduler job backupconfig

[Sysname-job-backupconfig]

Related commands

command

scheduler schedule

scheduler logfile size

Use scheduler logfile size to set the size of the job execution log file.

Syntax

scheduler logfile size value

Default

The size of the job execution log file is 16 KB.

Views

System view

Predefined user roles

network-admin

Parameters

value: Specifies the size of the job execution log file, in KB. The value range is 16 to 1024.

Usage guidelines

The job execution log file saves the execution information of jobs. If the file is full, old records are deleted to make room for new records. If the size of the log information to be written to the file is greater than the file size, the excessive information is not written to the file.

Examples

# Set the size of the job execution log file to 32 KB.

<Sysname> system-view

[Sysname] scheduler logfile size 32

Related commands

display scheduler logfile

scheduler reboot at

Use scheduler reboot at to specify the reboot date and time.

Use undo scheduler reboot to delete the reboot schedule configuration.

Syntax

scheduler reboot at time [ date ]

undo scheduler reboot

Default

No reboot date or time is specified.

Views

User view

Predefined user roles

network-admin

Parameters

time: Specifies the reboot time in the hh:mm format. The value range for hh is 0 to 23. The value range for mm is 0 to 59.

date: Specifies the reboot date in the MM/DD/YYYY or YYYY/MM/DD format. The value range for YYYY is 2000 to 2035. The value range for MM is 1 to 12. The value range for DD varies by month.

Usage guidelines

CAUTION

CAUTION:

This command enables the device to reboot at a scheduled time, which causes service interruption. Before using this command, make sure you fully understand its impact on your live network.

When the date argument is not specified, the system uses the following rules to determine the reboot time:

·     If the reboot time is later than the current time, a reboot occurs at the reboot time of the current day.

·     If the reboot time is earlier than the current time, a reboot occurs at the reboot time the next day.

The device supports only one device reboot schedule. If you execute both the scheduler reboot delay and scheduler reboot at commands or execute one of the commands multiple times, the most recent configuration takes effect.

For data security, the system does not reboot at the reboot time if a file operation is being performed.

Examples

# Configure the device to reboot at 12:00 p.m. This example assumes that the current time is 11:43 a.m. on June 6, 2011.

<Sysname> scheduler reboot at 12:00

Reboot system at 12:00:00 06/06/2011 (in 0 hours and 16 minutes). Confirm? [Y/N]:

Related commands

scheduler reboot delay

scheduler reboot delay

Use scheduler reboot delay to specify the reboot delay time.

Use undo scheduler reboot to delete the reboot schedule configuration.

Syntax

scheduler reboot delay time

undo scheduler reboot

Default

No reboot delay time is specified.

Views

User view

Predefined user roles

network-admin

Parameters

time: Specifies the reboot delay time in the hh:mm or mm format. This argument can contain up to six characters. When in the hh:mm format, mm must be in the range of 0 to 59.

Usage guidelines

CAUTION

CAUTION:

This command enables the device to reboot at a scheduled time, which causes service interruption. Before using this command, make sure you fully understand its impact on your live network.

The device supports only one device reboot schedule. If you execute both the scheduler reboot delay and schedule reboot at commands or execute one of the commands multiple times, the most recent configuration takes effect.

For data security, the system does not reboot at the reboot time if a file operation is being performed.

Examples

# Configure the device to reboot after 88 minutes. This example assumes that the current time is 11:48 a.m. on June 6, 2011.

<Sysname> scheduler reboot delay 88

Reboot system at 13:16 06/06/2011(in 1 hours and 28 minutes). Confirm? [Y/N]:

scheduler schedule

Use scheduler schedule to create a schedule and enter its view, or enter the view of an existing schedule.

Use undo scheduler schedule to delete a schedule.

Syntax

scheduler schedule schedule-name

undo scheduler schedule schedule-name

Default

No schedule exists.

Views

System view

Predefined user roles

network-admin

Parameters

schedule-name: Specifies the schedule name, a case-sensitive string of 1 to 47 characters.

Usage guidelines

You can configure a schedule to have the device automatically run a command or a set of commands without administrative interference.

To configure a schedule:

1.     Use the scheduler job command to create a job and enter job view.

2.     Use the command command to assign commands to the job.

3.     Use the scheduler schedule command to create a schedule and enter schedule view.

4.     Use the job command to assign the job to the schedule. You can assign multiple jobs to a schedule. The jobs must already exist.

5.     Use the user-role command to assign user roles to the schedule. You can assign up to 64 user roles to a schedule.

6.     Use the time at, time once, or time repeating command to specify an execution time for the schedule. You can specify only one execution time for a schedule.

Examples

# Create a schedule named saveconfig.

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

Related commands

job

time at

time once

set asset-info

Use set asset-info to configure an asset profile for a physical component.

 

 

NOTE:

This command is supported only in R3608 and later.

 

Syntax

set asset-info { chassis | fan fan-id | power power-id | slot slot-number } { csn csn-number | custom name value | department department | description description | location location | service-date date | state state }

Views

System view

Predefined user roles

network-admin

network-operator

Parameters

chassis: Configures an asset profile for the chassis.

fan fan-id: Configures an asset profile for the specified fan tray. The value range for the fan-id argument is 1 to 6.

power power-id: Configures an asset profile for the specified power module. The value range for the power-id argument is 1 to 36.

slot slot-number: Configures an asset profile for the card in the specified slot.

csn csn-number: Specifies an asset ID for the asset. The asset ID is a string of 1 to 62 characters.

custom name value: Defines an asset profile item and specifies the value. The value can be a string of 1 to 62 characters.

department department: Specifies the department name, a string of 1 to 62 characters.

description description: Specifies the asset description, a string of 1 to 62 characters.

location location: Specifies the asset location, a string of 1 to 62 characters.

service-date date: Specifies the service start date, a string of 1 to 25 characters.

state state: Specifies the asset usage status, a string of 1 to 62 characters.

Usage guidelines

If you configure an asset profile for a fan tray or power module that does not exist, the system prompts that the fan tray or power module is not present.

Examples

# Set the asset ID to 123456 for slot 0.

<Sysname> system-view

[Sysname] set asset-info slot 0 csn 123456

Related commands

display asset-info

reset asset-info

shutdown-interval

Use shutdown-interval to set the port status detection timer.

Use undo shutdown-interval to restore the default.

Syntax

shutdown-interval interval

undo shutdown-interval

Default

The port status detection timer setting is 30 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Specifies the port status detection timer value in seconds. The value range is 0 to 300. To disable port status detection, set this argument to 0.

Usage guidelines

The device starts a port status detection timer when a port is shut down by a protocol. Once the timer expires, the device brings up the port so the port status reflects the port's physical status.

If you change the timer setting during port detection, the device compares the new setting (T1) with the time that elapsed since the port was shut down (T).

·     If T < T1, the port will be brought up after T1 – T seconds.

·     If T ≥ T1, the port is brought up immediately.

For example, the timer setting is 30 seconds. If you change it to 10 seconds 2 seconds after the port is shut down, the port will come up 8 seconds later. If you change the timer setting to 2 seconds 10 seconds after the port is shut down, the port comes up immediately.

Examples

# Set the port status detection timer to 100 seconds.

<Sysname> system-view

[Sysname] shutdown-interval 100

switch-fabric isolate

Use switch-fabric isolate to isolate a switching fabric module or channel from the data plane.

Use undo switch-fabric isolate to cancel the isolation of a switching fabric module or channel.

Syntax

switch-fabric isolate slot slot-number [ channel channel-number ]

undo switch-fabric isolate slot slot-number [ channel channel-number ]

Default

A switching fabric module is not isolated from the data plane and can forward traffic.

Views

System view

Predefined user roles

network-admin

Parameters

slot slot-number: Specifies a switching fabric module by its slot number.

channel channel-number: Specifies a data channel by its number. If you do not specify this option, the command isolates the entire switching fabric module.

Usage guidelines

CAUTION

CAUTION:

·     Use this command only if required. If the device has multiple switching fabric modules, isolating a switching fabric module or channel decreases the forwarding bandwidth and reduces the forwarding performance.

·     Do not isolate the only switching fabric module of the device.

·     Do not reboot the device when a switching fabric module is isolated.

 

This command does not isolate an MPU.

An isolated switching fabric module continues to communicate with the MPU, and can forward traffic immediately after the isolation is canceled. The isolation does not affect protocol packet parsing and protocol calculation on the control plane.

You can use this command to identify whether switching fabric modules can forward traffic correctly.

Before replacing a switching fabric module, isolate the module to prevent packet loss.

To use an isolated switching fabric module or channel, use the undo switch-fabric isolate command to cancel the isolation.

Examples

# Isolate the switching fabric module in slot 10.

<Sysname> system-view

[Sysname] switch-fabric isolate slot 10

The command will isolate the switch fabric from the system. Continue? [Y/N]y

switch-fabric removal-signal-suppression

Use switch-fabric removal-signal-suppression to suppress removal interrupt signals from switching fabric modules.

Use undo switch-fabric removal-signal-suppression to restore the default.

Syntax

switch-fabric removal-signal-suppression

undo switch-fabric removal-signal-suppression

Default

Removal interrupt signals from switching fabric modules are not suppressed.

Views

System view

Predefined user roles

network-admin

Usage guidelines

CAUTION

CAUTION:

Use this command with caution. This command might result in packet loss and service outage.

 

Typically, removing a switching fabric module triggers one removal interrupt signal. Upon receiving the signal, the system switches traffic on the switching fabric module to other switching fabric modules to ensure service continuity. Upon hardware failure or signal interference, however, removal interrupt signals might be frequently triggered. To prevent the interrupt signals from affecting system operation, you can execute this command to suppress the interrupt signals.

Examples

# Suppress removal interrupt signals from switching fabric modules.

<Sysname> system-view

[Sysname] switch-fabric removal-signal-suppression

switch-linecard isolate

Use switch-linecard isolate to isolate a service module.

Syntax

switch-linecard isolate slot slot-number

Views

System view

Predefined user roles

network-admin

Parameters

slot slot-number: Specifies a service module by its slot number.

Usage guidelines

A service module reboot or device reboot cancels the isolation of the module or all service modules. To continue to isolate a service module after the service module starts up, you must use this command to isolate the module again.

When a service module fails, you can use this command to isolate it to prevent it from affecting traffic forwarding.

To view operating status of service modules, execute the display device command. An isolated service module is in Offline state.

Examples

# Isolate the service module in slot 1.

<Sysname> system-view

[Sysname] switch-linecard isolate slot 1

All ports on the interface module will be disabled and can come up only after the interface module is restarted. Continue? [Y/N]:y

sysname

Use sysname to set the device name.

Use undo sysname to restore the default.

Syntax

sysname sysname

undo sysname

Default

The device name is H3C.

Views

System view

Predefined user roles

network-admin

Parameters

sysname: Specifies a name for the device, a string of 1 to 64 characters.

Usage guidelines

A device name identifies a device in a network and is used in CLI view prompts. For example, if the device name is Sysname, the user view prompt is <Sysname>.

Examples

# Set the name of the device to R2000.

<Sysname> system-view

[Sysname] sysname R2000

[R2000]

system-working-mode

Use system-working-mode to set the system operating mode.

Use undo system-working-mode to restore the default.

Syntax

system-working-mode{ bridgee | standard }

undo system-working-mode

Default

The device operates in standard mode.

Views

System view

Predefined user roles

network-admin

Parameters

bridgee: Sets the system operating mode to enhanced Layer 2. This system operating mode supports Y.1731, and does not support VXLAN and ERSPAN.

standard: Sets the system operating mode to standard, which is the most common mode. This system operating mode supports VXLAN and ERSPAN, and does not support Y.1731.

Usage guidelines

The supported features and the specifications of the supported features vary by system operating mode.

Change to the operating mode takes effect after a reboot.

Examples

# Set the system operating mode to enhanced Layer 2.

<Sysname> system-view

[Sysname] system-working-mode bridgee

Do you want to change the system working mode? [Y/N]:y

System working mode changed. For the change to take effect, save the running configuration and reboot the device.

temperature-limit

Use temperature-limit to set the temperature alarm thresholds.

Use undo temperature-limit to restore the default.

Syntax

temperature-limit slot slot-number { hotspot | inflow } sensor-number lowlimit warninglimit [ alarmlimit ]

undo temperature-limit slot slot-number { hotspot | inflow } sensor-number

Default

The defaults vary by temperature sensor model. To view the defaults, execute the undo temperature-limit and display environment commands in turn.

Views

System view

Predefined user roles

network-admin

Parameters

slot slot-number: Specifies a card by its slot number.

hotspot: Configures temperature alarm thresholds for hotspot sensors. A hotspot sensor is typically located near a high-heat chip to monitor the chip temperature.

inflow: Configures temperature alarm thresholds for inlet sensors. An inflow sensor is located near an air inlet to monitor the ambient temperature.

sensor-number: Specifies a sensor by its number. To view the value range, enter a question mark (?) in the place of this argument.

lowlimit: Specifies the low-temperature threshold in Celsius degrees. The value range varies by temperature sensor. To view the value range, enter a question mark (?) in the place of this argument.

warninglimit: Specifies the high-temperature warning threshold in Celsius degrees. This threshold must be greater than the low-temperature threshold. To view the value range, enter a question mark (?) in the place of this argument.

alarmlimit: Specifies the high-temperature alarming threshold in Celsius degrees. This threshold must be greater than the warning threshold. To view the value range, enter a question mark (?) in the place of this argument.

Usage guidelines

When the device temperature drops below the low-temperature threshold or reaches the high-temperature warning or alarming threshold, the device performs the following operations:

·     Sends log messages and traps.

·     Sets LEDs on the device panel.

Examples

# Set temperature alarm thresholds for hotspot sensor 1 in a slot.

<Sysname> system-view

[Sysname] temperature-limit slot 1 hotspot 1 -10 50 60

Related commands

display environment

time at

Use time at to specify an execution date and time for a non-periodic schedule.

Use undo time to delete the execution date and time configuration for a non-periodic schedule.

Syntax

time at time date

undo time

Default

No execution time or date is specified for a non-periodic schedule.

Views

Schedule view

Predefined user roles

network-admin

Parameters

time: Specifies the schedule execution time in the hh:mm format. The value range for hh is 0 to 23. The value range for mm is 0 to 59.

date: Specifies the schedule execution date in the MM/DD/YYYY or YYYY/MM/DD format. The value range for YYYY is 2000 to 2035. The value range for MM is 1 to 12. The value range for DD varies by month.

Usage guidelines

The specified time (date plus time) must be later than the current system time.

The time at command, the time once command, and the time repeating command overwrite each other. The most recently configured command takes effect.

Examples

# Configure the device to execute the saveconfig schedule at 01:01 a.m. on May 11, 2011.

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] time at 1:1 2011/05/11

Related commands

scheduler schedule

time once

Use time once to specify one or more execution days and the execution time for a non-periodic schedule.

Use undo time to delete the execution day and time configuration for a non-periodic schedule.

Syntax

time once at time [ month-date month-day | week-day week-day&<1-7> ]

time once delay time

undo time

Default

No execution time or day is specified for a non-periodic schedule.

Views

Schedule view

Predefined user roles

network-admin

Parameters

at time: Specifies the execution time in the hh:mm format. The value range for hh is 0 to 23. The value range for mm is 0 to 59.

month-date month-day: Specifies a day in the current month, in the range of 1 to 31. If you specify a day that does not exist in the current month, the configuration takes effect on that day in the next month.

week-day week-day&<1-7>: Specifies a space-separated list of up to seven week days for the schedule. Valid week day values include Mon, Tue, Wed, Thu, Fri, Sat, and Sun.

delay time: Specifies the delay time for executing the schedule, in the hh:mm or mm format. This argument can have up to six characters. When in the hh:mm format, mm must be in the range of 0 to 59.

Usage guidelines

If the specified time has already occurred, the schedule will be executed at the specified time the following day.

If the day in the month has already occurred, the schedule will be executed at the specified day in the following month.

If the specified day in a week has already occurred, the schedule will be executed at the specified day in the following week.

The time at command, the time once command, and the time repeating command overwrite each other. The most recently configured command takes effect.

Examples

# Configure the device to execute the saveconfig schedule once at 15:00.

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] time once at 15:00

Schedule starts at 15:00 5/11/2011.

# Configure the device to execute the saveconfig schedule once at 15:00 on the coming 15th day in a month.

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] time once at 15:00 month-date 15

# Configure the device to execute the saveconfig schedule at 12:00 p.m. on the coming Monday and Friday.

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] time once at 12:00 week-day mon fri

# Configure the device to execute the saveconfig schedule after 10 minutes.

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] time once delay 10

Related commands

scheduler schedule

time repeating

Use time repeating to specify an execution time table for a periodic schedule.

Use undo time to delete the execution time table configuration for a periodic schedule.

Syntax

time repeating [ at time [ date ] ] interval interval

time repeating at time [ month-date [ month-day | last ] | week-day week-day&<1-7> ]

undo time

Default

No execution time table is specified for a periodic schedule.

Views

Schedule view

Predefined user roles

network-admin

Parameters

at time: Specifies the execution time in the hh:mm format. The value range for hh is 0 to 23. The value range for mm is 0 to 59. If you do not specify this option, the current system time is used as the execution time.

date: Specifies the start date for the periodic schedule, in the MM/DD/YYYY or YYYY/MM/DD format. The value range for YYYY is 2000 to 2035. The value range for MM is 1 to 12. The value range for DD varies by month. If you do not specify this argument, the execution start date is the first day when the specified time arrives.

interval interval: Specifies the execution time interval in the hh:mm or mm format. This argument can have up to six characters. When in the hh:mm format, mm must be in the range of 0 to 59. When in the mm format, this argument must be equal to or greater than 1 minute.

month-date [ month-day | last ]: Specifies a day in a month, in the range 1 to 31. The last keyword indicates the last day of a month. If you specify a day that does not exist in a month, the configuration takes effect on that day in the next month.

week-day week-day&<1-7>: Specifies a space-separated list of up to seven week days for the schedule. Valid week day values include Mon, Tue, Wed, Thu, Fri, Sat, and Sun.

Usage guidelines

The time repeating [ at time [ date ] ] interval interval command configures the device to execute a schedule at intervals from the specified time on.

The time repeating at time [ month-date [ month-day | last ] | week-day week-day&<1-7> ] command configures the device to execute a schedule at the specified time on every specified day in a month or week.

The time at command, the time once command, and the time repeating command overwrite each other, whichever is configured most recently takes effect.

Examples

# Configure the device to execute the saveconfig schedule once an hour from 8:00 a.m. on.

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] time repeating at 8:00 interval 60

# Configure the device to execute the saveconfig schedule at 12:00 p.m. every day.

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] time repeating at 12:00

# Configure the device to execute the saveconfig schedule at 8:00 a.m. on the 5th of every month.

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] time repeating at 8:00 month-date 5

# Configure the device to execute the saveconfig schedule at 8:00 a.m. on the last day of every month.

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] time repeating at 8:00 month-date last

# Configure the device to execute the saveconfig schedule at 8:00 a.m. every Friday and Saturday.

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] time repeating at 8:00 week-day fri sat

Related commands

scheduler schedule

transceiver monitor enable

Use transceiver monitor enable to enable transceiver monitoring.

Use undo transceiver monitor enable to restore the default.

 

 

NOTE:

This command is supported only in F3607P02 and later.

 

Syntax

transceiver monitor enable

undo transceiver monitor enable

Default

Transceiver monitoring is disabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

After transceiver monitoring is enabled, the device samples the parameters of transceiver modules periodically, including the input power and output power of transceiver modules. If a sampled value reaches the alarm threshold, the device generates a log to notify users.

Examples

# Enable transceiver monitoring.

<Sysname> system-view

[Sysname] transceiver monitor enable

Related commands

transceiver monitor interval

transceiver monitor interval

Use transceiver monitor interval to set a transceiver monitoring interval.

Use undo transceiver monitor interval to restore the default.

 

 

NOTE:

This command is supported only in F3607P02 and later.

 

Syntax

transceiver monitor interval interval

undo transceiver monitor interval

Default

The transceiver monitoring interval is 600 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

interval: Specifies the transceiver monitoring interval in seconds. The value range is 300 to 3600.

Usage guidelines

After transceiver monitoring is enabled, the device samples the parameters of transceiver modules periodically, including the input power and output power of transceiver modules. If a sampled value reaches the alarm threshold, the device generates a log entry to notify users.

This command takes effect only when the transceiver monitor enable command is executed.

Examples

# Set the transceiver monitoring interval to 500 seconds.

<Sysname> system-view

[Sysname] transceiver monitor interval 500

Related commands

transceiver monitor enable

usb disable

Use usb disable to disable USB interfaces.

Use undo usb disable to enable USB interfaces.

Syntax

usb disable

undo usb disable

Default

All USB interfaces are enabled.

Views

System view

Predefined user roles

network-admin

Usage guidelines

You can use USB interfaces to upload or download files. By default, all USB interfaces are enabled.

Before executing this command, use the umount command to unmount all USB file systems..

Examples

# Unmount all USB file systems before disabling USB interfaces.

<Sysname> umount usba0:

<Sysname> system-view

[Sysname] usb disable

# Enable USB interfaces.

<Sysname> system-view

[Sysname] undo usb disable

user-role

Use user-role to assign user roles to a schedule.

Use undo user-role to remove user roles from a schedule.

Syntax

user-role role-name

undo user-role role-name

Default

A schedule has the user roles of the schedule creator.

Views

Schedule view

Predefined user roles

network-admin

Parameters

role-name: Specifies a user role name, a case-sensitive string of 1 to 63 characters. The user role can be user-defined or predefined. Predefined user roles include network-admin, network-operator, and level-0 to level-15.

Usage guidelines

A schedule must have one or more user roles. A command in a schedule can be executed if it is permitted by one or more user roles of the schedule. For more information about user roles, see the RBAC configuration in Fundamentals Configuration Guide.

A schedule can have a maximum of 64 user roles. After the limit is reached, you cannot assign additional user roles to the schedule.

Examples

# Assign the rolename user role to the test schedule.

<sysname> system-view

[Sysname] scheduler schedule test

[Sysname-schedule-test] user-role rolename

Related commands

command

scheduler schedule

 

  • 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
新华三官网