01-Fundamentals Command Reference

HomeSupportResource CenterSwitchesH3C S6300 Switch SeriesH3C S6300 Switch SeriesTechnical DocumentsCommandCommand ReferencesH3C S6300 Switch Series Command References-Release 243x-6W10001-Fundamentals Command Reference
10-Device management commands
Title Size Download
10-Device management commands 252.98 KB

Contents

Device management commands· 1

clock datetime· 1

clock protocol 2

clock summer-time· 2

clock timezone· 4

command· 5

copyright-info enable· 5

display clock· 7

display copyright 7

display cpu-usage· 8

display cpu-usage configuration· 8

display cpu-usage history· 9

display device· 11

display device manuinfo· 12

display device manuinfo fan· 13

display device manuinfo power 14

display diagnostic-information· 14

display environment 15

display fan· 16

display memory· 17

display memory-threshold· 18

display power 20

display scheduler job· 20

display scheduler logfile· 21

display scheduler reboot 22

display scheduler schedule· 22

display system stable state· 23

display system-working-mode· 25

display transceiver alarm·· 25

display transceiver diagnosis· 27

display transceiver interface· 28

display transceiver manuinfo· 29

display version· 30

display version-update-record· 30

fan prefer-direction· 31

header 31

job· 33

memory-threshold· 34

memory-threshold usage· 35

monitor cpu-usage enable· 35

monitor cpu-usage interval 36

monitor cpu-usage threshold· 37

password-recovery enable· 37

parity-error monitor log enable· 38

parity-error monitor period· 39

parity-error monitor threshold· 39

reboot 40

reset scheduler logfile· 41

reset version-update-record· 42

restore factory-default 42

scheduler job· 43

scheduler logfile size· 44

scheduler reboot at 44

scheduler reboot delay· 45

scheduler schedule· 46

shutdown-interval 47

sysname· 47

system-working-mode· 48

temperature-limit 49

time at 50

time once· 51

time repeating· 52

usb disable· 53

user-role· 54


Device management commands

clock datetime

Use clock datetime to set the UTC time.

Syntax

clock datetime time date

Default

The UTC time is the factory-default time.

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

When the system time source is the local system time, the system time varies by the following items:

·     Local time zone.

·     UTC time.

·     Daylight saving time.

To view the system time, use the display clock command.

The correct system time setting is essential to network management and communication. To run a device on a network, you must perform one of the following tasks on the device:

·     Set the system time correctly.

·     Use NTP or PTP to synchronize the device with a trusted time source.

Examples

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

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

# Set the UTC 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 uses the NTP time source.

Views

System view

Predefined user roles

network-admin

Parameters

none: Uses the local system time configured by using the clock datetime, clock timezone, and clock summer-time commands.

ptp: Uses the PTP time source. When the device uses the PTP time source, you cannot change the system time manually. For more information about PTP, see Network Management and Monitoring Configuration Guide..

ntp: Uses the NTP time source. When the device uses the NTP time source, you cannot change the system time manually. For more information about NTP, see Network Management and Monitoring Configuration Guide.

Usage guidelines

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

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 configure the device to use daylight saving time during a specific period of time.

Use undo clock summer-time to cancel the configuration.

Syntax

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

undo clock summer-time

Default

Daylight saving time is disabled.

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

When the system time source is the local system time, the system time varies by the following items:

·     Local time zone.

·     UTC time.

·     Daylight saving time.

To view the system time, use the display clock command.

The correct system time setting is essential to network management and communication. Set the system time correctly or use NTP or PTP to synchronize the device with a trusted time source before you run it on the network.

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 local time zone.

Use undo clock timezone to restore the default.

Syntax

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

undo clock timezone

Default

The local time zone is the UTC time zone.

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.

minus: Decreases the UTC time by an offset.

zone-offset: Specifies an offset to the UTC 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

When the system time source is the local system time, the system time varies by the following items:

·     Local time zone.

·     UTC time.

·     Daylight saving time.

To view the system time, use the display clock command.

The correct system time setting is essential to network management and communication. Set the system time correctly or use NTP or PTP to synchronize the device with a trusted time source before you run it on the network.

Examples

# Set the name of the local time zone to Z5, and add 5 hours to the UTC 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.

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

Usage guidelines

If a command uses the ID of an existing command, the existing command is replaced.

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

The system does not check the validity of the command argument. You must make sure the command is supported by the device, is input in the correct format, and uses valid values. If these requirements are not met, the command cannot be executed automatically.

Examples

# Assign commands to the backupconfig job to back up configuration file startup.cfg 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

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

·     When a Telnet user logs in, the following statement appears:

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

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

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

 

<Sysname>

·     When a console user quits user view, the device automatically restarts the console session and displays the following message:

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

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

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

 

User interface aux0 is available.

 

 

 

Press ENTER to get started.

# Disable copyright statement display.

<Sysname> system-view

[Sysname] undo copyright-info enable

·     When a Telnet user logs in, the user view prompt appears:

<Sysname>

·     When a console user quits user view, the following message appears:

User interface aux0 is available.

 

 

 

Press ENTER to get started.

display clock

Use display clock to display the system time, date, local 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 local time zone is not specified.

<Sysname> display clock

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

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

<Sysname> display clock

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

Time Zone : Z5 add 05:00:00

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

<Sysname> display clock

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

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, including software and hardware copyright statements, and third-party software license agreements.

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 CPU usage statistics.

Syntax

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

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify this option on an IRF fabric, the command displays the CPU usage statistics for all member devices.

cpu cpu-number: Displays the CPU usage statistics. The cpu-number argument must be 0.

Usage guidelines

After startup, the device tracks the average CPU usage at the following intervals:

·     5 seconds.

·     1 minute.

·     5 minutes.

This command displays the average CPU usage values during the last 5-second, 1-minute, and 5-minute intervals.

Examples

#  Display the current CPU usage statistics for all member devices.

<Sysname> display cpu-usage

Slot 1 CPU 0 CPU usage:

       6% in last 5 seconds

      10% in last 1 minute

       5% in last 5 minutes

Table 1 Command output

Field

Description

6% in last 5 seconds

Average CPU usage during the last 5-second interval.

10% in last 1 minute

Average CPU usage during the last 1-minute interval.

5% in last 5 minutes

Average CPU usage during the last 5-minute interval.

Slot x CPU y CPU usage

Usage statistics for CPU y of member device x.

 

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 an IRF member device by its member ID. If you do not specify this option, the command displays the CPU usage monitoring settings for the master device.

cpu cpu-number: Displays the CPU usage monitoring settings. The cpu-number argument must be 0.

Examples

# Display the CPU usage monitoring settings.

<Sysname> display cpu-usage configuration

CPU usage monitor is enabled.

Current monitor interval is 60 seconds.

Current monitor threshold is 99%.

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

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. If you do not specify this option, the command displays the historical CPU usage statistics for the entire system. 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 an IRF member device by its member ID. If you do not specify this option, the command displays the historical CPU usage statistics for the master device.

cpu cpu-number: Displays the historical CPU usage statistics. The cpu-number argument must be 0.

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.

·     Consecutive pound signs (#) indicate the CPU usage at a specific time. 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 for the entire system.

<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 historical CPU usage statistics for the entire system (with the name SYSTEM) in 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 than 2%.

# Display the historical CPU usage statistics for process 1.

<Sysname> display cpu-usage history job 1

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 (scmd)

The output shows the historical CPU usage statistics of process 1 (with the process name scmd) in the last 60 minutes. A process name with square brackets ([ ]) means that the process is a kernel process.

·     20 minutes ago: Approximately 5%.

·     Other time: 2% or lower than 2%.

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 [ subslot subslot-number ] | verbose ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

flash: Specifies the flash memory.

usb: Specifies the device connected to the USB interface.

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify this option on an IRF fabric, the command displays the device information for all member devices.

subslot subslot-number: Specifies a subcard by its subslot number. The switch does not support subcards.

verbose: Displays detailed hardware information. Without this keyword, the command displays brief information.

Examples

#  Display device information for all IRF member devices in the IRF fabric.

<Sysname> display device

Slot Type             State    Subslot  Soft Ver             Patch Ver         

1    S6300-48S         Master   0        2432P03              None

Table 2 Command output

Field

Description

Slot x

ID of the IRF member device.

Type

Type of the switch.

State

Status of the switch.

Subslot

Subslot number of the subcard. The switch does not support subcards.

Soft Ver

Software version.

Patch Ver

Patch version.

 

display device manuinfo

Use display device manuinfo to display the 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 an IRF member device by its member ID. If you do not specify this option on an IRF fabric, the command displays electronic label information for all member devices.

Usage guidelines

An electronic label is a profile of a device. It contains the permanent configuration, including the serial number, manufacturing date, MAC address, and vendor name. The data is written to the storage component during debugging or testing.

Examples

<Sysname> display device manuinfo

Slot 1 CPU 0:

DEVICE_NAME          : S6300-48S 

DEVICE_SERIAL_NUMBER : 210235A0U0H12A000002

MAC_ADDRESS          : 0CDA-415E-232E

MANUFACTURING_DATE   : 2012-10-29

VENDOR_NAME          : H3C

Fan 1

DEVICE_NAME          : LSWM1FANSCB

DEVICE_SERIAL_NUMBER : 210231A0WFH115000073

MANUFACTURING_DATE   : 2012-06-05

VENDOR_NAME          : H3C

Fan 2

DEVICE_NAME          : LSWM1FANSCB

DEVICE_SERIAL_NUMBER : 210231A0WFH115000070

MANUFACTURING_DATE   : 2012-06-05

VENDOR_NAME          : H3C

Power 1

DEVICE_NAME          : LSVM1AC300

MANU SERIAL NUMBER   : 210231A0QMX129000007

MANUFACTURING_DATE   : 2012-10-29

VENDOR_NAME          : H3C

Table 3 Command output

Field

Description

Slot x CPU y

Slot number of the device and number of the CPU.

DEVICE_SERIAL_NUMBER

Serial number.

MAC_ADDRESS

MAC address.

MANUFACTURING_DATE

Manufacturing date.

VENDOR_NAME

Vendor name.

 

display device manuinfo fan

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

Syntax

display device manuinfo slot slot-number fan fan-id

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

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

fan-id: Specifies a fan by its ID.

Examples

# Display the electronic label information for fan 1.

<Sysname> display device manuinfo slot 1 fan 1

Fan 1:

DEVICE_NAME          : LSWM1FANSCB

DEVICE_SERIAL_NUMBER : 210235A36L1234567890

MANUFACTURING_DATE   : 2010-01-20

VENDOR_NAME          : H3C

display device manuinfo power

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

Syntax

display device manuinfo slot slot-number power power-id

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

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

fan-id: Specifies a fan by its ID.

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

Examples

# Display the electronic label information for power supply 1.

<Sysname> display device manuinfo slot 1 power 1

Power 1:

DEVICE_NAME          : LSVM1AC650

DEVICE_SERIAL_NUMBER : 210235A36L1234567890

MANUFACTURING_DATE   : 2010-01-20

VENDOR_NAME          : H3C

display diagnostic-information

Use display diagnostic-information to display or save operating information for multiple feature modules in the system.

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

l2: Specifies operating information for the Layer 2 features.

l3: Specifies operating information for the Layer 3 features.

service: Specifies operating information for 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 for 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: Specifies a .tar.gz file to save the statistics to the file.

Usage guidelines

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

·     Use separate display commands to collect running status data module by module.

·     Use the display diagnostic-information command to bulk collect running data for multiple 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 (>), pipeline signs (|), and quotation marks ("). For example, device name A/B will change to A_B in the file name, as in flash:/diag_A_B_20160101-000438.tar.gz.

This display command does not support the | by-linenum option, the > filename option, or the >> filename option. However, this command asks you whether you want to save the output to a file or display the output on the screen. The file used to save the output is automatically compressed to save storage space.

Examples

# Display the operating statistics for multiple feature modules in the system.

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

display environment

Use display environment to display the temperature statistics for the temperature sensors, including the current temperature and temperature alarm thresholds.

Syntax

display environment [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify this option on an IRF fabric, the command displays the temperature statistics for all member devices.

Examples

#  Display the temperature statistics for all temperature sensors on the device.

<Sysname>display environment

System temperature information (degree centigrade):                           

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

 Slot  Sensor    Temperature  Lower  Warning  Alarm  Shutdown                   

 1     hotspot 1 40           0      50       55     NA                        

 1     hotspot 2 39           0      58       63     NA

Table 4 Command output

Field

Description

System temperature information (degree centigrade)

Temperature information (°C).

sensor

Temperature sensor, hotspot for a hotspot sensor.

Slot x

ID of the IRF member device.

Temperature

Current temperature.

Lower

Low-temperature threshold.

Warning

High-temperature warning threshold.

Alarm

High-temperature alarming threshold.

Shutdown

High-temperature shutdown threshold.

 

display fan

Use display fan to display the operating states of fans.

Syntax

display fan [ slot slot-number [ fan-id ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify this option on an IRF fabric, the command displays the operating states of fans on all member devices.

fan-id: Specifies a fan by its ID. If you do not specify this argument, the command displays the operating states of all fans on the specified member device.

Examples

# Display the operating states of all fans.

<Sysname> display fan

Slot 1:                                                                        

 Fan 1:                                                                        

 State    : Normal                                                  

 Airflow Direction: Port-to-power                                              

 Prefer Airflow Direction: Port-to-power                                       

 Fan 2:                                                                        

 State    : Normal                                                  

 Airflow Direction: Port-to-power                                              

 Prefer Airflow Direction: Port-to-power

Table 5 Command output

Field

Description

Slot x

ID of the IRF member device.

Fan 1

ID of the Fan.

State

Fan status:

·     AbsentNo fan is installed in the position.

·     Normal—The fan is operating correctly.

·     Fault—The fan has a problem.

·     FanDirectionFault—The current air direction is different from the preferred airflow direction.

Airflow Direction

Current airflow direction:

·     Port-to-power—From the port side to the power supply side.

·     Power-to-port—From the power supply side to the port side.

Prefer Airflow Direction

Preferred airflow direction:

·     Port-to-power—From the port side to the power supply side.

·     Power-to-port—From the power supply side to the port side.

 

display memory

Use display memory to display memory usage.

Syntax

display memory [ slot slot-number ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify this option on an IRF fabric, the command displays memory usage on all member devices.

cpu cpu-number: Specifies a CPU by its number. The cpu-number argument must be 0.

Examples

# Display memory usage.

<Sysname>display memory                                                            

The statistics about memory is measured in KB:                                 

Slot 10:                                                                       

             Total      Used      Free    Shared   Buffers    Cached   FreeRatio

Mem:       3854876    651188   3203688         0       740    157844       83.3%

-/+ Buffers/Cache:    492604   3362272                                         

Swap:            0         0         0                                         

LowMem:     709152    303772    405380        --        --        --       57.2%

HighMem:   3145724    347416   2798308        --        --        --       89.0%

Table 6 Command output

Field

Description

Slot

ID of an IRF member device.

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 codes, kernel management, and ISSU 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.

Buffers

Physical memory used for buffers.

Cached

Physical memory used for caches.

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

Swap memory.

LowMem

Low-memory usage information.

HighMem

High-memory usage information.

 

display memory-threshold

Use display memory-threshold to display memory usage thresholds and memory usage notification statistics.

Syntax

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

Views

Any view

Predefined user roles

network-admin

Parameters

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify this option, the command displays memory usage thresholds and memory usage notification statistics for the master device.

cpu cpu-number: Specifies a CPU by its number. The cpu-number argument must be 0.

Usage guidelines

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

Examples

# Display memory usage thresholds and memory usage notification statistics.

<Sysname>display memory-threshold                                                  

Memory usage threshold:  100% 

Free memory threshold:

    Minor: 96M                                                                  

    Severe: 64M                                                                

    Critical: 48M                                                              

    Normal: 128M                                                               

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

Related commands

·     memory-threshold

·     memory-threshold usage

display power

Use display power to display power supply information.

Syntax

display power [ slot slot-number [ power-id ] ]

Views

Any view

Predefined user roles

network-admin

network-operator

Parameters

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify this option on an IRF fabric, the command displays power supply information for all member devices.

power-id: Specifies a power supply by its ID. If you do not specify this option, the command displays information about all power supplies on the specified member device.

Examples

# Display power supply information.

<Sysname> display power

Slot 1:                                                                       

 PowerID State    Mode   Current(A)  Voltage(V)  Power(W)                      

 1       Normal   AC        --          --          --

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 this option, the command displays all jobs' configuration information.

Examples

# Display all jobs' configuration information.

<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 has no command, and the third has two commands. Jobs are separated by blank lines.

display scheduler logfile

Use display scheduler logfile to display log information for executed jobs.

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 range ten-gigabitethernet 1/0/1 to ten-gigabitethernet 1/0/3

[Sysname-if-range]shutdown

Table 7 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 has no 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 this option, the 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 8 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

Views

Any view

Predefined user roles

network-admin

network-operator

Usage guidelines

Before performing an ISSU or a master/subordinate switchover, use this command to verify that the system is stable. If the System State field does not display Stable, you cannot perform an ISSU. If the Redundancy Stable filed does not display Stable, you cannot perform a master/subordinate switchover.

At startup, an IRF fabric takes some time to enter Stable state. If an IRF fabric cannot enter Stable state, use this command to locate the member device that is not in Stable state. To locate the instability problem, also use the following commands:

·     display deviceDisplays device information to locate member devices that are faulty.

·     display ha service-groupDisplays service group status information to locate the service groups in Batch Backup state.

You can use these commands multiple times to observe status changes.

Examples

# Display system stability and status information.

<Sysname> display system stable state

System state    : Stable

Redundancy state: No redundance

  Slot   CPU   Role      State

  1      0     Active    Stable

Table 9 Command output

Field

Description

System state

IRF status:

·     StableThe IRF fabric is operating stably.

·     Not readyThe IRF fabric is not stable. You cannot perform an ISSU.

Redundancy state

Redundancy status:

·     StableThe IRF fabric is operating stably. You can perform a master/subordinate switchover.

·     No RedundanceThe IRF fabric has only one member device. You cannot perform a master/subordinate switchover.

·     Not readyThe IRF fabric is not stable. You cannot perform a master/subordinate switchover.

Role

Role of the member device in the IRF fabric:

·     Active—Master member.

·     Standby—Subordinate member.

State

Status of the member device:

·     StableThe member device is operating stably.

·     Board Inserted—The member device has just been installed.

·     Kernel InitThe member device kernel is being initialized.

·     Service StartingServices are starting on the member device.

·     Service StoppingServices are stopping on the member device.

·     HA Batch BackupAn HA batch backup is in progress on the member device.

·     Interface Data Batch Backup—An interface data batch backup is in progress on the member device.

*

The member device is not operating stably.

 

Related commands

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 next system working mode is advance.

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 10 shows the common transceiver alarms. If no error occurs, "None" is displayed.

Table 10 Common transceiver alarms

Field

Description

SFP/SFP+:

RX loss of signal

Signal loss occurred in the inbound direction.

RX power high

The received optical power is high.

RX power low

The received optical power is low.

TX fault

Transmission error.

TX bias high

The transmitted bias current is high.

TX bias low

The transmitted bias current is low.

TX power high

The transmitted optical power is high.

TX power low

The transmitted optical power is low.

Temp high

The temperature is high.

Temp low

The temperature is low.

Voltage high

The voltage is high.

Voltage low

The voltage is low.

Transceiver info I/O error

Transceiver information read/write error.

Transceiver info checksum error

Transceiver information checksum error.

Transceiver type and port configuration mismatch

The type of the transceiver module does not match the port configuration.

Transceiver type not supported by port hardware

The port does not support this type of transceiver modules.

QSFP+:

RX signal loss in channel x

Signal loss occurred in the inbound direction of the specified channel.

TX fault in channel x

Transmission error occurred in the specified channel.

TX signal loss in channel x

Transmitted signals were lost in the specified channel.

RX power high in channel x

The received optical power is high in the specified channel.

RX power low in channel x

The received optical power is low in the specified channel.

TX bias high in channel x

The transmitted bias current is high in the specified channel.

TX bias low in channel x

The transmitted bias current is low in the specified channel.

Temp high

The temperature is high.

Temp low

The temperature is low.

Voltage high

The voltage is high.

Voltage low

The voltage is low.

Transceiver info I/O error

Transceiver information read/write error.

Transceiver info checksum error

Transceiver information checksum error.

Transceiver type and port configuration mismatch

The type of the transceiver module does not match the port configuration.

Transceiver type not supported by port hardware

The port does not support this type of transceiver module.

 

Examples

# Display the alarms present on the transceiver module in interface Ten-GigabitEthernet 1/0/1.

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

Ten-GigabitEthernet1/0/1 transceiver current alarm information:

  RX loss of signal

  RX power low

Table 11 Command output

Field

Description

transceiver current alarm information

Alarms present on the transceiver module.

RX loss of signal

Received signals are lost.

RX power low

Received power is low.

Temp high

Temperature is high.

 

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.

Usage guidelines

This command cannot display information about some transceiver modules.

Examples

# Display the current values of the digital diagnosis parameters on the transceiver module in interface Ten-GigabitEthernet 1/0/2.

<Sysname> display transceiver diagnosis interface ten-gigabitethernet 1/0/2

Ten-GigabitEthernet1/0/2 transceiver diagnostic information:                                                                      

  Current diagnostic parameters:                                                                                                   

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

    43         3.31        6.23      -6.50          -2.15                                                                          

  Alarm thresholds:                                                                                                                 

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

    High   75         -63        10.50       2.00           1.50                                                                     

    Low    -5         2.97        2.00      -13.90         -11

Table 12 Command output

Field

Description

transceiver diagnostic information

Digital diagnosis information of the transceiver module in the interface.

Temp.(°C)

Temperature in °C, accurate to 1°C.

Voltage(V)

Voltage in V, accurate to 0.01 V.

Bias(mA)

Bias current in mA, accurate to 0.01 mA.

RX power(dBm)

RX power in dBm, accurate to 0.01 dBm.

TX power(dBm)

TX 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 this option, the command displays the key parameters of every transceiver module.

Examples

# Display the key parameters of the transceiver module in interface Ten-GigabitEthernet 1/0/3.

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

Ten-GigabitEthernet1/0/3 transceiver information:

  Transceiver Type              : 1000_BASE_SX_SFP

  Connector Type                : LC

  Wavelength(nm)                : 850

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

  Digital Diagnostic Monitoring : YES

  Vendor Name                   : H3C

  Ordering Name                 : SFP-GE-SX-MM850

Table 13 Command output

Field

Description

transceiver information

Transceiver information.

Transceiver Type

Transceiver type.

Connector Type

Connector type options:

·     MPO—Multi-fiber Push On.

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

·     RJ-45.

Wavelength(nm)

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

·     Copper cable: Displayed as N/A.

Transfer Distance(xx)

Transfer distance, with "xx" representing the distance unit: km (kilometers) for single-mode transceiver modules and m (meters) for other transceiver modules.

If the transceiver module supports multiple transfer media, the transfer distances are separated by commas. The transfer medium is included in the bracket following the transfer distance value. The following are the transfer media:

·     9 um9/125 um single-mode fiber.

·     50 um50/125 um multi-mode fiber.

·     62.5 um62.5/125 um multi-mode fiber.

·     TPTwisted pair.

·     CX4CX4 cable.

Digital Diagnostic Monitoring

Support for digital diagnosis:

·     YES—Supported.

·     NO—Not supported.

Ordering Name

Product code.

 

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 the transceiver modules on all interfaces.

Usage guidelines

This command displays only part of the electronic label information.

Examples

# Display the electronic label information for the transceiver module in interface Ten-GigabitEthernet 1/0/4.

<Sysname> display transceiver manuinfo interface ten-gigabitethernet 1/0/4

Ten-GigabitEthernet1/0/4 transceiver manufacture information:

  Manu. Serial Number  : 213410A0000054000251

  Manufacturing Date   : 2012-09-01

  Vendor Name          : H3C

Table 14 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 the startup software image upgrade history records of the master device.

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 and all subsequent version update information. Such information can survive reboots.

The maximum number of records is 10.

Examples

# Display the startup software image upgrade history records.

<Sysname>display version-update-record

  Name                                   Version                Compile time       

Record 1  (updated on Sep 18 2014 at 07:55:46):                                

* s6300-cmw710-boot-r2432p03.bin   7.1.045 Release 2432P03   Sep 16 2014 13:44:42

* s6300-cmw710-system-r2432p03.bin 7.1.045 Release 2432P03   Sep 16 2014 13:44:42

Table 15 Command output

Field

Description

Name

Software image file name.

*

The new software image is different from the old one.

 

Related commands

reset version-update-record

fan prefer-direction

Use fan prefer-direction to configure the preferred airflow direction.

Use undo fan prefer-direction to restore the default.

Syntax

fan prefer-direction slot slot-number { power-to-port | port-to-power }

undo fan prefer-direction slot slot-number

Default

The default preferred airflow direction is from the power supply side to the port side.

Views

System view

Predefined user roles

network-admin

Parameters

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

power-to-port: Specifies the airflow direction from the power supply side to the port side.

port-to-power: Specifies the airflow direction from the port side to the power supply side.

Examples

# Set the preferred airflow direction to port-to-power for member device 1.

<Sysname> system-view

[Sysname] fan prefer-direction slot 1 port-to-power

Related commands

display fan

header

Use header to create a banner.

Use undo header to clear a banner.

Syntax

header { incoming | legal | login | motd | shell } text

undo header { incoming | legal | login | motd | shell }

Default

The device does not have any banner.

Views

System view

Predefined user roles

network-admin

Parameters

incoming: Configures the banner to be displayed before a modem dial-up user accesses user view. If authentication is required, the incoming banner appears after the authentication is passed.

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

login: Configures the banner displayed to be 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 non-modem dial-in user accesses user view.

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

Examples

# Create the incoming banner, legal banner, login banner, MOTD banner, and shell banner.

<Sysname> system-view

[Sysname] header incoming

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

Welcome to incoming(header incoming)%

[Sysname] header legal

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

Welcome to legal (header legal)%

[Sysname] header login

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

Welcome to login(header login)%

[Sysname] header motd

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

Welcome to motd(header motd)%

[Sysname] header shell

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

Welcome to shell(header shell)%

In this example, the percentage sign (%) is the starting and ending character of the text argument. Entering the percentage sign after the text quits the header command. Because it is the starting and ending character, the percentage sign is not included in the banner.

# Test the configuration by using Telnet. The login banner appears only when password or scheme login authentication has been configured.

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

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

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

 

 

Welcome to legal (header legal)

 Press Y or ENTER to continue, N to exit.

 

Welcome to login(header login)

 

Password:

 

 

Welcome to motd(header motd)

 

 

 

Welcome to shell(header shell)

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 job save-job to schedule saveconfig.

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

[Sysname-schedule-saveconfig] job save-job

Related commands

·     scheduler job

·     scheduler schedule

memory-threshold

Use memory-threshold to set free-memory thresholds.

Use undo memory-threshold to restore the defaults.

Syntax

memory-threshold [ slot slot-number [ cpu cpu-number ] ] minor minor-value severe severe-value critical critical-value normal normal-value

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

Default

·     Minor alarm threshold: 96 MB.

·     Severe alarm threshold: 64 MB.

·     Critical alarm threshold: 48 MB.

·     Normal state threshold: 128 MB.

Views

System view

Predefined user roles

network-admin

Parameters

minor minor-value: Specifies the minor alarm threshold in the range of 0 to 1237. 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 in the range of 0 to 1237. 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 in the range of 0 to 1237. 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 in the range of 0 to 1237. This threshold must be equal to or less than the total memory size.

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify this option, the command sets free-memory thresholds for the master device.

cpu cpu-number: Specifies a CPU by its number. The cpu-number argument must be 0.

Usage guidelines

To ensure correct operation and improve memory utilization, the system monitors the amount of free memory space in real time. When a threshold is exceeded, the system sends an alarm notification or an alarm-removed notification to affected feature modules or processes so they can take countermeasures. For more information about the thresholds, see 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

Related commands

·     display memory-threshold

·     memory-threshold usage

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

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

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify this option, the command sets the memory usage threshold for the master device.

cpu cpu-number: Specifies a CPU by its number. The cpu-number argument must be 0.

Usage guidelines

The device samples memory usage at an interval of 1 minute, and compares the sample with the memory usage threshold. If the sample is greater, the device sends a trap.

Examples

# Set the memory usage threshold to 80%.

<Sysname> system-view

[Sysname] memory-threshold threshold 80

Related commands

·     display memory-threshold

·     memory-threshold

monitor cpu-usage enable

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

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

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 recording is enabled.

Views

System view

Predefined user roles

network-admin

Parameters

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify this option, the command enables CPU usage recording for the master device.

cpu cpu-number: Specifies a CPU by its number. The cpu-number argument must be 0.

Examples

# Enable CPU usage recording.

<Sysname> system-view

[Sysname] monitor cpu-usage enable

Related commands

·     display cpu-usage configuration

·     display cpu-usage history

·     monitor cpu-usage enable

·     monitor cpu-usage threshold

monitor cpu-usage interval

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

Syntax

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

Default

The CPU usage sampling interval is 1 minute.

Views

System view

Predefined user roles

network-admin

Parameters

interval-value: Specifies the CPU usage sampling interval. Valid values include 5Sec for 5 seconds, 1Min for 1 minute, and 5Min for 5 minutes.

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify this option, the command sets the CPU usage sampling interval for the master device.

cpu cpu-number: Specifies a CPU by its number. The cpu-number argument must be 0.

Examples

# Set the CPU usage sampling interval 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 threshold

monitor cpu-usage threshold

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

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

Syntax

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

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

Default

The CPU usage threshold is 99%.

Views

System view

Predefined user roles

network-admin

Parameters

cpu-threshold: Specifies a CPU usage threshold in percentage. The value range is 0 to 100.

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify this option, the command the CPU usage threshold for the master device.

cpu cpu-number: Specifies a CPU by its number. The cpu-number argument must be 0.

Usage guidelines

The device samples CPU usage at an interval of 1 minute, and compares the sample with the CPU usage threshold. If the sample is greater than the CPU usage threshold, the device sends a trap.

Examples

# Set the CPU usage threshold to 80%.

<Sysname> system-view

[Sysname] monitor cpu-usage threshold 80

Related commands

·     display cpu-usage

·     display cpu-usage configuration

·     display cpu-usage history

·     monitor cpu-usage enable

·     monitor cpu-usage interval

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 Boot ROM 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.

Availability of Boot ROM menu options varies by 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

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.

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 generates logs for the detected parity errors.

Examples

# Enable parity error logging for entries on forwarding chips.

<Sysname> system-view

[Sysname] parity-error monitor log enable

parity-error monitor period

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

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

Syntax

parity-error monitor period value

undo parity-error monitor period

Default

The parity error statistics interval is 60 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

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

Usage guidelines

The device detects parity errors in entries on forwarding chips, and collects parity error statistics at the interval set by using this command.

Examples

# Set the parity error statistics interval to 120 seconds.

<Sysname> system-view

[Sysname] parity-error monitor period 120

Related commands

parity-error monitor threshold

parity-error monitor threshold

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

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

Syntax

parity-error monitor threshold value

undo parity-error monitor threshold

Default

The parity error alarm threshold is 5000.

Views

System view

Predefined user roles

network-admin

Parameters

value: Specifies the parity error alarm threshold in the range of 1 to 1000000.

Usage guidelines

The device detects and collects statistics for parity errors in entries on forwarding chips. If the number of parity errors in a parity error statistics interval reaches the parity error alarm threshold, the system issues an alarm.

Examples

# Set the parity error alarm threshold to 8000.

<Sysname> system-view

[Sysname] parity-error monitor threshold 8000

Related commands

parity-error monitor period

reboot

Use reboot to reboot an IRF member device or all IRF member devices.

Syntax

reboot [ slot slot-number ] [ force ]

Default

The default setting varies by device model.

Views

User view

Predefined user roles

network-admin

Parameters

slot slot-number: Specifies an IRF member device by its member ID. If you do not specify this option on an IRF fabric, the command reboots all member devices.

force: Reboots the device immediately without performing any software check. If this keyword is not specified, the system first checks whether the reboot might result in data loss or a system failure. For example, the system checks 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 device reboot might interrupt network services.

·     If the main startup software images are corrupted 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.

Use the force keyword only when you cannot reboot the device without using it.

Examples

# Reboot the device when no configuration change has occurred since the last time you saved the running configuration.

<Sysname> reboot

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

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

Now rebooting, please wait...

# If any configuration has changed, reboot the device and save the configuration.

<Sysname> reboot

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

Current configuration may 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 flash successfully.

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

Now rebooting, please wait...

# If any configuration has changed, reboot the device but do not save the configuration.

<Sysname> reboot

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

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

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

Now rebooting, please wait...

# Reboot the device immediately without performing any software check.

<Sysname> reboot force

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

Now rebooting, please wait...

reset scheduler logfile

Use reset scheduler logfile to clear job execution log information.

Syntax

reset scheduler logfile

Default

None

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 the startup software image upgrade history records of the master device.

Syntax

reset version-update-record

Views

System view

Predefined user roles

network-admin

Examples

# Clear the startup software image upgrade history 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

restore factory-default

Use restore factory-default to restore the factory-default settings and states.

Syntax

restore factory-default

Views

User view

Predefined user roles

network-admin

Usage guidelines

CAUTION

CAUTION:

This command is disruptive. 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.

 

If a device fails or you want to use it in a different scenario, you can restore the factory-default settings and states for the device.

This command performs the following tasks:

·     Deletes all configuration files (.cfg files) in the root directories of the storage media.

·     Deletes all log files (.log files in the folder /logfile).

·     Clears all log information (in the log buffer), trap information, and debugging information.

·     Restores the parameters for the Boot ROM to the factory-default settings.

·     Deletes all license files (.ak files).

·     Deletes all files on an installed hot-swappable storage medium, such as a USB disk.

Before this operation, remove all hot-swappable storage media from the device.

Examples

# Restore the factory-default settings and states 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 job view. If the job already exists, you enter job view directly.

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: Sets 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 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 remove 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:

Device reboot interrupts network services.

 

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.

For data security, if you are performing file operations at the reboot time, the system does not reboot.

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

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 remove 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 consist up to six characters. When in the hh:mm format, mm must be in the range of 0 to 59.

Usage guidelines

CAUTION

CAUTION:

Device reboot interrupts network services.

 

For data security, if you are performing file operations at the reboot time, the system does not reboot.

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

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 schedule view. If the schedule already exists, you enter schedule view directly.

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 schedule a job 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.

2.     In job view, use the command command to assign commands to the job.

3.     Use the scheduler schedule command to create a schedule.

4.     In schedule view, 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.     In schedule view, use the user-role command to assign user roles to the schedule. You can assign up to 64 user roles to a schedule.

6.     In schedule view, 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 per schedule.

Examples

# Create a schedule named saveconfig.

<Sysname> system-view

[Sysname] scheduler schedule saveconfig

Related commands

·     job

·     time at

·     time once

shutdown-interval

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

Use undo shutdown-interval to restore the default.

Syntax

shutdown-interval time

undo shutdown-interval

Default

The port status detection interval is 30 seconds.

Views

System view

Predefined user roles

network-admin

Parameters

time: 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 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 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, if you change the timer from 30 seconds to 10 seconds two seconds after the port is shut down, the port will come up 8 seconds later. If you change the timer from 30 seconds to 2 seconds ten 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

sysname

Use sysname to set the device name.

Use undo sysname to restore the default.

Syntax

sysname sysname

undo sysname

Default

The default 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 as the user view prompt at the CLI. 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 { advance | standard | expert }

undo system-working-mode

Default

The device operates in standard mode.

Views

System view

Predefined user roles

network-admin

Parameters

advance: Sets the system operating mode to advanced.

standard: Sets the system operating mode to standard.

expert: Sets the system operating mode to expert.

Usage guidelines

After changing the operating mode, you must reboot the device to make the device operate in the new mode.

In different operating modes, the device supports different features. For more information about the operating modes, see device management in Fundamentals Configuration Guide.

If the prompt "Not enough hardware resources available." appears after you set the system operating mode, perform the following tasks:

1.     Use the display qos-acl resource command to display ACL resource usage.

2.     Use the undo acl command to release ACL resources as required.

3.     Set the system operating mode again.

For more information about the display qos-acl resource and undo acl commands, see ACL and QoS Command Reference.

Examples

# Set the system operating mode to advanced.

<Sysname> system-view

[Sysname] system-working-mode advance

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

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

temperature-limit

Use temperature-limit to set the temperature alarm thresholds for the device.

Use undo temperature-limit to restore the default.

Syntax

temperature-limit slot slot-number hotspot sensor-number lowlimit warninglimit [ alarmlimit ]

undo temperature-limit slot slot-number hotspot sensor-number

Default

To view the default settings, execute the undo temperature-limit and display environment commands in turn.

Views

System view

Predefined user roles

network-admin

Parameters

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

hotspot: Configures temperature alarm thresholds for hotspot sensors. A hotspot sensor is typically near the chip that generates a great amount of heat and used to monitor the chip.

sensor-number: Specifies a sensor by its number, an integer starting from 1. Each number represents a temperature sensor on the device.

lowlimit: Specifies the low-temperature threshold in Celsius degrees.

warninglimit: Specifies the high-temperature warning threshold in Celsius degrees. This threshold must be greater than the low-temperature threshold.

alarmlimit: Specifies the high-temperature alarming threshold in Celsius degrees. This threshold must be greater than the warning threshold.

Usage guidelines

The value ranges for the sensor number and thresholds vary by device model. To view the value ranges, use the CLI online help.

When the device temperature drops below the low-temperature threshold or reaches the high-temperature warning threshold, the device sends a log message.

When the device temperature reaches the high-temperature alarming threshold, the device sends log messages repeatedly and sets LEDs on the device panel.

Examples

# Set temperature alarm thresholds for Hotspot 1 on member device 1.

<Sysname> system-view

[sysname] temperature-limit slot 1 hotspot 1 -10 70 100

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 one another. The most recently configured command takes effect.

Examples

# Configure the device to execute schedule saveconfig 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 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 consist 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 one another. The most recently configured command takes effect.

Examples

# Configure the device to execute schedule saveconfig 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 schedule saveconfig 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 schedule saveconfig 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 schedule saveconfig 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

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-time: Specifies the execution time interval in the hh:mm or mm format. This argument can consist 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. Valid values include Mon, Tue, Wed, Thu, Fri, Sat, and Sun.

Usage guidelines

The time repeating [ at time [ date ] ] interval interval-time command configures the device to execute the schedule regularly 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 the 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 one another, whichever is configured most recently takes effect.

Examples

# Configure the device to execute schedule saveconfig 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 schedule saveconfig 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 schedule saveconfig 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 schedule saveconfig 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 schedule saveconfig 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

usb disable

Use usb disable to disable all USB interfaces.

Use undo usb disable to enable all 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 partitions.

Examples

# Unmount all USB partitions before disabling USB interfaces.

<Sysname> umount slot1#usba0:

<Sysname> system-view

[Sysname] usb disable

# Enable all 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, level-0 to level-15, and security-audit.

Usage guidelines

By assigning user roles to and removing user roles from a schedule, you can control the commands to be executed in the schedule. A command in a schedule can be executed if it is permitted by one or more user roles of the schedule.

A schedule must have one or more user roles, and can have up to 64 user roles. After the upper limit is reached, you cannot assign additional user roles to the schedule.

Assigning the security-audit user role to a schedule removes the other user role assignments for the schedule. Assigning any other user roles to a schedule removes the security-audit user role assignment for the schedule. Only the remaining user role assignments take effect. For more information about user roles, see the RBAC configuration in Fundamentals Configuration Guide.

Examples

# Assign user role rolename to schedule test.

<Sysname> system-view

[Sysname] scheduler schedule test

[Sysname-schedule-test] user-role rolename                                      

[Sysname-schedule-test] display this                                             

#                                                                              

scheduler schedule test                                                         

 user-role network-admin                                                       

 user-role network-operator

 user-role rolename                                                            

#                                                                               

return                                                                         

Related commands

·     command

·     scheduler schedule