- Table of Contents
-
- 01-Fundamentals Command Reference
- 00-Preface
- 01-CLI commands
- 02-RBAC commands
- 03-Login management commands
- 04-FTP and TFTP commands
- 05-File system management commands
- 06-Configuration file management commands
- 07-Software upgrade commands
- 08-ISSU commands
- 09-Emergency shell commands
- 10-Device management commands
- 11-Security zone commands
- 12-Tcl commands
- 13-Python commands
- 14-License management commands
- Related Documents
-
Title | Size | Download |
---|---|---|
10-Device management commands | 292.81 KB |
Device management commands
card-mode
Use card-mode to set the operating mode for an interface module.
Syntax
In standalone mode:
card-mode slot slot-number subslot subslot-number mode-name
In IRF mode:
card-mode chassis chassis-number slot slot-number subslot subslot-number mode-name
Default
See device management in Fundamentals Configuration Guide.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
chassis chassis-number: Specifies an IRF member device by its member ID. (In IRF mode.)
slot slot-number: Specifies a slot number.
subslot subslot-number: Specifies an interface module by its subslot number.
mode-name: Specifies an operating mode. Available operating modes include:
· e1: Specifies the E1 mode. All interfaces on the interface module act as CPOS E1 interfaces.
· e-cpos: Specifies the E-CPOS mode. All interfaces on the interface module act as 2.5 Gbps CPOS interfaces.
· oc-12-pos: Specifies the oc-12-pos mode. All interfaces on the interface module act as POS interfaces.
· oc-3-pos: Specifies the oc-3-pos mode. All interfaces on the interface module act as POS interfaces.
· pos: Specifies the POS mode. All interfaces on the interface module act as POS interfaces.
· t1: Specifies the T1 mode. All interfaces on the interface module act as CPOS T1 interfaces.
Usage guidelines
This command is supported only on the default MDC.
For an operating mode change to take effect, you must reboot the device or hot swap the interface module.
Examples
# (In standalone mode.) Set the operating mode to E1 for interface module 1 in slot 1.
<Sysname> system-view
[Sysname] card-mode slot 1 subslot 1 e1
Please reboot or hot-swap the card or subcard (if supported) to make the configuration take effect.
# (In IRF mode.) Set the operating mode to E1 for interface module 1 in slot 1 of member device 1.
<Sysname> system-view
[Sysname] card-mode chassis 1 slot 1 subslot 1 e1
Please reboot or hot-swap the card or subcard (if supported) to make the configuration take effect.
clock datetime
Use clock datetime to set the system time.
Syntax
clock datetime time date
Default
The factory-default system time is used
Views
User view
Predefined user roles
network-admin
Parameters
time: Specifies a time in the hh:mm:ss format. The value range for hh is 0 to 23. The value range for mm is 0 to 59. The value range for ss is 0 to 59. The leading zero in a segment can be omitted. If the seconds segment is 0 (hh:mm:00), you can omit it. If both the minutes and seconds segments are 0 (hh:00:00), you can omit both of the segments. For example, to specify 08:00:00, you can enter 8.
date: Specifies a date in the MM/DD/YYYY or YYYY/MM/DD format. The value range for YYYY is 2000 to 2035. The value range for MM is 1 to 12. The value range for DD varies by month.
Usage guidelines
Correct system time is essential to network management and communication. You must configure the system time correctly before you run the device on the network.
For the device to use the local system time, execute the clock protocol none command and this command in turn. The specified system time takes effect immediately. Then, the device uses the clock signals generated by its built-in crystal oscillator to maintain the system time.
If you set the time zone after you configure this command, the device recalculates the system time. To view the system time, use the display clock command.
Examples
# Set the system time to 08:08:08 01/01/2015.
<Sysname> clock datetime 8:8:8 1/1/2015
# Set the system time to 08:10:00 01/01/2015.
<Sysname> clock datetime 8:10 2015/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 mdc mdc-id }
undo clock protocol
Default
The device uses the NTP time source specified on the default MDC.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
none: Uses the system time set by using the clock datetime command.
ntp: Uses NTP to obtain the UTC time. You must configure NTP correctly. For more information about NTP and NTP configuration, see Network Management and Monitoring Configuration Guide.
mdc mdc-id: Specifies the MDC to be used for time synchronization. The mdc-id argument is in the range of 1 to 8.
Usage guidelines
Correct system time is essential to network management and communication. You must configure the system time correctly before you run the device on the network.
· If you configure the clock protocol none and clock datetime commands in turn, the device uses the locally set system time. The device then uses the clock signals generated by its built-in crystal oscillator to maintain the system time.
· If you configure the clock protocol ntp command, the device obtains the UTC time through NTP and calculates the system time. The device then periodically synchronizes the UTC time and recalculates the system time. For more information about NTP, see Network Management and Monitoring Configuration Guide.
The system time calculated by using the UTC time from an NTP time source is more precise.
If you execute this command multiple times, the most recent configuration takes effect.
All MDCs on the device use the same system time. After obtaining the system time from an MDC, the device automatically synchronizes the system time to the other MDCs.
Examples
# Configure the device to use the local UTC time.
<Sysname> system-view
[Sysname] clock protocol none
clock summer-time
Use clock summer-time to set the daylight saving time.
Use undo clock summer-time to restore the default.
Syntax
clock summer-time name start-time start-date end-time end-date add-time
undo clock summer-time
Default
The daylight saving time is not set.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
name: Specifies a name for the daylight saving time schedule, a case-sensitive string of 1 to 32 characters.
start-time: Specifies the start time in the hh:mm:ss format. The value range for hh is 0 to 23. The value range for mm is 0 to 59. The value range for ss is 0 to 59. The leading zero in a segment can be omitted. If the seconds segment is 0 (hh:mm:00), you can omit it. If both the minutes and seconds segments are 0 (hh:00:00), you can omit both of the segments. For example, to specify 08:00:00, you can enter 8.
start-date: Specifies the start date in one of the following formats:
· MM/DD. The value range for MM is 1 to 12. The value range for DD varies by month.
· month week day, where:
¡ month—Takes January, February, March, April, May, June, July, August, September, October, November or December.
¡ week—Represents week of the month. It takes first, second, third, fourth, fifth, or last.
¡ day—Takes Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, or Saturday.
end-time: Specifies the end time in the hh:mm:ss format. The value range for hh is 0 to 23. The value range for mm is 0 to 59. The value range for ss is 0 to 59. The leading zero in a segment can be omitted. If the seconds segment is 0 (hh:mm:00), you can omit it. If both the minutes and seconds segments are 0 (hh:00:00), you can omit both of the segments. For example, to specify 08:00:00, you can enter 8.
end-date: Specifies the end date in one of the following formats:
· MM/DD. The value range for MM is 1 to 12. The value range for DD varies by month.
· month week day, where:
¡ month—Takes January, February, March, April, May, June, July, August, September, October, November or December.
¡ week—Represents week of the month. It takes first, second, third, fourth, fifth, or last.
¡ day—Takes Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, or Saturday.
add-time: Specifies the time to be added to the standard time, in the hh:mm:ss format. The value range for hh is 0 to 23. The value range for mm is 0 to 59. The value range for ss is 0 to 59. The leading zero in a segment can be omitted. If the seconds segment is 0 (hh:mm:00), you can omit it. If both the minutes and seconds segments are 0 (hh:00:00), you can omit both of the segments. For example, to specify 08:00:00, you can enter 8.
Usage guidelines
Correct system time is essential to network management and communication. You must configure the system time correctly before you run the device on the network.
After you set the daylight saving time, the device recalculates the system time. To view the system time, use the display clock command.
Make sure all devices on the network are using the same daylight saving time as the local time.
Examples
# Set the system time ahead 1 hour for the period between 06:00:00 on 08/01 and 06:00:00 on 09/01.
<Sysname> system-view
[Sysname] clock summer-time PDT 6 08/01 6 09/01 1
Related commands
clock datetime
clock timezone
display clock
clock timezone
Use clock timezone to set the 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 Greenwich Mean Time time zone is used.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
zone-name: Specifies a time zone by its name, a case-sensitive string of 1 to 32 characters.
add: Adds an offset to the UTC time or local system time.
minus: Decreases the UTC time or local system time by an offset.
zone-offset: Specifies the offset in the hh:mm:ss format. The value range for hh is 0 to 23. The value range for mm is 0 to 59. The value range for ss is 0 to 59. The leading zero in a segment can be omitted. If the seconds segment is 0 (hh:mm:00), you can omit it. If both the minutes and seconds segments are 0 (hh:00:00), you can omit both of the segments. For example, to specify 08:00:00, you can enter 8.
Usage guidelines
Correct system time is essential to network management and communication. You must configure the system time correctly before you run the device on the network.
After you set the time zone, the device recalculates the system time. To view the system time, use the display clock command.
Make sure all devices on the network are using the same time zone as the local time.
Examples
# Set the name of the local time zone to Z5, and add 5 hours to the UTC time or local system time.
<Sysname> system-view
[Sysname] clock timezone Z5 add 5
Related commands
clock datetime
clock summer-time
display clock
command
Use command to assign a command to a job.
Use undo command to revoke a command.
Syntax
command id command
undo command id
Default
No command is assigned to a job.
Views
Job view
Predefined user roles
network-admin
mdc-admin
Parameters
id: Specifies an ID for the command, in the range of 0 to 4294967295. A command ID uniquely identifies a command in a job. Commands in a job are executed in ascending order of their command IDs.
command: Specifies the command to be assigned to the job.
Usage guidelines
To assign a command (command A) to a job, you must first assign the job the command or commands for entering the view of command A.
If you specify the ID of an existing command for another command, the existing command is replaced.
Make sure all commands in a schedule are compliant to the command syntax. The system does not examine the syntax when you assign a command to a job.
If a command requires a yes or no answer, the system always assumes that a Y or Yes is entered. If a command requires a character string input, the system assumes that either the default character string (if any) or a null string is entered.
A job cannot contain the telnet, ftp, ssh2, or monitor process command.
Examples
# Assign commands to the backupconfig job to back up the 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
# Assign commands to the shutdownGE job to shut down GigabitEthernet 1/1/1.
<Sysname> system-view
[Sysname] scheduler job shutdownGE
[Sysname-job-shutdownGE] command 1 system-view
[Sysname-job-shutdownGE] command 2 interface gigabitethernet 1/1/1
[Sysname-job-shutdownGE] command 3 shutdown
Related commands
scheduler job
copyright-info enable
Use copyright-info enable to enable copyright statement display.
Use undo copyright-info enable to disable copyright statement display.
Syntax
copyright-info enable
undo copyright-info enable
Default
Copyright statement display is enabled.
Views
System view
Predefined user roles
network-admin
mdc-admin
Examples
# Enable copyright statement display.
<Sysname> system-view
[Sysname] copyright-info enable
The device will display the following statement when a user logs in:
******************************************************************************
* Copyright (c) 2004-2016 Hangzhou H3C Tech. Co., Ltd. All rights reserved. *
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
******************************************************************************
display alarm
Use display alarm to display alarm information.
Syntax
In standalone mode:
display alarm [ slot slot-number ]
In IRF mode:
display alarm [ chassis chassis-number slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays alarm information for all cards. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify a card, this command displays alarm information for all cards. (In IRF mode.)
Examples
# (In standalone mode.) Display alarm information.
<Sysname> display alarm
Slot CPU Level Info
0 0 ERROR faulty
1 0 ERROR faulty
Table 1 Command output
Field |
Description |
Slot |
Number of the slot with the alarm. If the value is a hyphen (-), the alarm was generated by the chassis. |
Level |
Alarm severity. Possible values include ERROR, WARNING, NOTICE, and INFO, in descending order. |
Info |
Detailed alarm information: · faulty—The card is starting up or faulty. · Fan n is absent—The specified fan is absent. · Power n is absent—The specified power supply is absent. · The temperature of sensor n exceeds the lower limit—The temperature of the specified sensor is lower than the low-temperature threshold. · The temperature of sensor n exceeds the upper limit—The temperature of the specified sensor is higher than the high-temperature warning threshold. |
# (In IRF mode.) Display alarm information.
<Sysname> display alarm
Chassis Slot CPU Level Info
1 0 0 ERROR Fan 2 is absent.
1 1 0 ERROR Power 2 is absent.
2 1 1 WARNING The temperature of sensor 3 exceeds the lower limit.
Table 2 Command output
Field |
Description |
Chassis |
ID of the IRF member device with the alarm. |
Slot |
Number of the slot number with the alarm. |
Level |
Alarm severity. Possible values include ERROR, WARNING, NOTICE, and INFO, in descending order. |
Info |
Detailed alarm information: · faulty—The card is starting up or faulty. · Fan n is absent—The specified fan is absent. · Power n is absent—The specified power supply is absent. · The temperature of sensor n exceeds the lower limit—The temperature of the specified sensor is lower than the low-temperature threshold. · The temperature of sensor n exceeds the upper limit—The temperature of the specified sensor is higher than the high-temperature warning threshold. |
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
mdc-admin
mdc-operator
Examples
# Display the system time and date when the local time zone is not specified.
<Sysname> display clock
16:38:36 UTC Wed 07/06/2016
# Display the system time and date when the local time zone Z5 is specified.
<Sysname> display clock
16:38:36 UTC Wed 07/06/2016
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
16:38:36 UTC Wed 07/06/2016
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 software license information.
network-admin
network-operator
mdc-admin
mdc-operator
# Display the copyright statement.
...
display cpu-usage
Use display cpu-usage to display the current CPU usage statistics.
Syntax
In standalone mode:
display cpu-usage [ summary ] [ slot slot-number [ cpu cpu-number ] ]
In IRF mode:
display cpu-usage [ summary ] [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
summary: Displays CPU usage statistics in table form. If you do not specify this keyword, the command displays CPU usage statistics in text form.
slot slot-number: Specifies the slot number of the device, which is fixed at 0. Alternatively, you can execute the command without specifying this option. The command execution results are the same. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the device, which is fixed at 0. If you do not specify an IRF member device, this command displays CPU usage statistics for all IRF member devices. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number.
Usage guidelines
This command displays the average CPU usage values during the last 5-second, 1-minute, and 5-minute intervals.
Examples
# (In standalone mode.) Display the current CPU usage statistics in text form.
<Sysname> display cpu-usage
Slot 0 CPU 0 CPU usage:
1% in last 5 seconds
0% in last 1 minute
0% in last 5 minutes
# (In standalone mode.) Display the current CPU usage statistics in table form.
<Sysname> display cpu-usage
Slot CPU Last 5 sec Last 1 min Last 5 min
0 0 22% 54% 44%
# (In IRF mode.) Display the current CPU usage statistics for all cards in text form.
<Sysname> display cpu-usage
Chassis 1 Slot 0 CPU 0 CPU usage:
9% in last 5 seconds
8% in last 1 minute
8% in last 5 minutes
Chassis 2 Slot 0 CPU 0 CPU usage:
6% in last 5 seconds
6% in last 1 minute
6% in last 5 minutes
# (In IRF mode.) Display the current CPU usage statistics for all cards in table form.
<Sysname> display cpu-usage
Chassis Slot CPU Last 5 sec Last 1 min Last 5 min
1 0 0 6% 5% 8%
2 0 0 6% 6% 8%
Table 3 Command output
Field |
Description |
x% in last 5 seconds |
Average CPU usage during the last 5-second interval. |
y% in last 1 minute |
Average CPU usage during the last 1-minute interval. |
z% in last 5 minutes |
Average CPU usage during the last 5-minute interval. |
display cpu-usage configuration
Use display cpu-usage configuration to display CPU usage monitoring settings.
Syntax
In standalone mode:
display cpu-usage configuration [ slot slot-number [ cpu cpu-number ] ]
In IRF mode:
display cpu-usage configuration [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]
Views
Any view
Predefined user roles
network-admin
mdc-admin
Parameters
slot slot-number: Specifies the slot number of the device, which is fixed at 0. Alternatively, you can execute the command without specifying this option. The command execution results are the same. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the device, which is fixed at 0. If you do not specify this option, the command displays the CPU usage monitoring settings for the master device. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number.
Examples
# Display the CPU usage monitoring settings.
<Sysname> display cpu-usage configuration
CPU usage monitor is enabled.
Current monitor interval is 60 seconds.
Current monitor threshold is 90%.
Related commands
monitor cpu-usage enable
monitor cpu-usage interval
monitor cpu-usage threshold
display cpu-usage history
Use display cpu-usage history to display the historical CPU usage statistics in a coordinate system.
Syntax
In standalone mode:
display cpu-usage history [ job job-id ] [ slot slot-number [ cpu cpu-number ] ]
In IRF mode:
display cpu-usage history [ job job-id ] [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
job job-id: Specifies a process by its ID. If you do not specify a process, this command displays the statistics for the entire system's CPU usage (the total CPU usage of all processes). To view the IDs and names of the running processes, use the display process command. For more information, see Network Management and Monitoring Configuration Guide.
slot slot-number: Specifies the slot number of the device, which is fixed at 0. Alternatively, you can execute the command without specifying this option. The command execution results are the same. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the device, which is fixed at 0. If you specify a process but do not specify an IRF member device, this command displays the statistics for the process on the master device. If you do not specify any options, this command displays the statistics for all processes on all IRF member devices. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number. If you specify a process but do not specify a CPU, this command displays the statistics for the default CPU. If you do not specify a process or CPU, this command displays the historical statistics for all CPUs.
Usage guidelines
After CPU usage monitoring is enabled, the system regularly samples CPU usage and saves the samples to the history record buffer. This command displays the most recent 60 samples in a coordinate system as follows:
· The vertical axis represents the CPU usage. If a statistic is not a multiple of the usage step, it is rounded up or down to the closest multiple of the usage step. For example, if the CPU usage step is 5%, the statistic 53% is rounded up to 55%, and the statistic 52% is rounded down to 50%.
· The horizontal axis represents the time.
· Pound signs (#) indicate the CPU usage. The value on the vertical axis for the topmost pound sign at a specific time represents the CPU usage at that time.
Examples
# Display the historical CPU usage statistics 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 (Chassis 1 slot 0 CPU 0) last 60 minutes (SYSTEM)
The output shows the following items:
· Process name. The name SYSTEM represents the entire system.
· CPU that is holding the process: CPU 0 in slot 0 of member device 1.
· Historical CPU usage statistics for the entire system during the last 60 minutes.
¡ 12 minutes ago: Approximately 5%.
¡ 13 minutes ago: Approximately 10%.
¡ 14 minutes ago: Approximately 15%.
¡ 15 minutes ago: Approximately 10%.
¡ 16 and 17 minutes ago: Approximately 5%.
¡ 18 minutes ago: Approximately 10%.
¡ 19 minutes ago: Approximately 5%.
¡ Other time: 2% or lower 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 (Chassis 1 slot 0 CPU 0) last 60 minutes (scmd)
The output shows the following items:
· Process name, which is scmd. A process name in a pair of square brackets ([ ]) represents a kernel process.
· CPU that is holding the process: CPU 0 in slot 0 of member device 1.
· Historical CPU usage statistics for process 1 in the last 60 minutes.
¡ 20 minutes ago: Approximately 5%.
¡ Other time: 2% or lower than 2%.
monitor cpu-usage enable
monitor cpu-usage interval
display device
Use display device to display device information.
Syntax
In standalone mode:
display device [ cf-card ] [ slot slot-number [ subslot subslot-number ] | verbose ]
In IRF mode:
display device [ cf-card ] [ chassis chassis-number [ slot slot-number [ subslot subslot-number ] ] | verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
cf-card: Specifies the CF cards.
chassis chassis-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays hardware information for all member devices. (In IRF mode.)
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays hardware information for all cards on the device. (In standalone mode.)
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays device information for all cards on the member device. (In IRF mode.)
subslot subslot-number: Specifies an interface module by its subslot number. If you do not specify an interface module, this command does not display information about any interface modules.
verbose: Displays detailed hardware information. If you do not specify this keyword, this command displays brief information, and does not display firewall card information.
Usage guidelines
If you do not specify the cf-card keyword, this command displays information about cards on the device.
Examples
# (In standalone mode.) Display device information.
<Sysname> display device
Slot No. Board type Status Primary SubSlots
---------------------------------------------------------------------
0 SR6602-X2 Normal Master 0
1 FIP-20 Normal N/A 2
The output shows that a FIP card is in slot 1. Slot 0 refers to the device.
# (In IRF mode.) Display device information on all IRF member devices.
<Sysname> display device
Slot No. Board type Status Primary SubSlots
---------------------------------------------------------------------
1/0 SR6602-X2 Normal Master 0
1/1 FIP-20 Normal N/A 2
The output shows that the IRF fabric has one member device, whose member ID is 1. A FIP card is in slot 1. Slot 0 refers to the member device
Table 4 Command output
Field |
Description |
Board type |
Type of the hardware in the slot. |
Status |
Status of the hardware: · Absent—The slot is empty. · Fault—The hardware is faulty and cannot start up. · Normal—The hardware is operating correctly. · Startup—The hardware is starting up. · Disable—The hardware has been removed. |
Primary |
Role of the hardware: · Master—The hardware is the device. (In standalone mode.) · Master—The hardware is the master device. (In IRF mode.) · Standby—The hardware is a subordinate device. (In IRF mode.) · N/A—The hardware is a card. |
SubSlots |
Maximum number of interface modules supported by the card. |
display device manuinfo
Use display device manuinfo to display electronic label information for the device.
Syntax
In standalone mode:
display device manuinfo [ slot slot-number [ subslot subslot-number ] ]
In IRF mode:
display device manuinfo [ chassis chassis-number [ slot slot-number [ subslot subslot-number ] ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
chassis chassis-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays electronic label information for all member devices. (In IRF mode.)
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays electronic label information of all cards on the device. (In standalone mode.)
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays electronic label information for all cards on the member device. (In IRF mode.)
subslot subslot-number: Specifies an interface module by its subslot number. If you do not specify an interface module, this command does not display information about any interface modules.
Usage guidelines
An electronic label is a profile of a device or card. 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. This command displays only part of the electronic label information.
Table 5 Command and hardware compatibility
Hardware |
Command compatibility |
Frame |
No |
Card and interface module |
Yes |
Fan tray |
Yes |
Examples
# Display electronic label information.
<Sysname> display device manuinfo
...
Table 6 Command output
Field |
Description |
DEVICE_NAME |
Device name. |
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
In standalone mode:
display device manuinfo fan fan-id
In IRF mode:
display device manuinfo chassis chassis-number fan fan-id
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
chassis chassis-number: Specifies an IRF member device by its member ID. (In IRF mode.)
fan-id: Specifies a fan by its ID.
Examples
# (In standalone mode.) Display electronic label information for fan 2.
<Sysname> display device manuinfo fan 2
Fan 2:
DEVICE_NAME : fan
DEVICE_SERIAL_NUMBER : 210235A36L1234567890
MAC_ADDRESS : NONE
MANUFACTURING_DATE : 2010-01-20
VENDOR_NAME : H3C
# (In IRF mode.) Display electronic label information for fan 2 on IRF member device 1.
<Sysname> display device manuinfo chassis 1 fan 2
Chassis 1:
Fan 2:
DEVICE_NAME : fan2
DEVICE_SERIAL_NUMBER : 210235A36L1234567891
MAC_ADDRESS : NONE
MANUFACTURING_DATE : 2010-01-20
VENDOR_NAME : H3C
display diagnostic-information
Use display diagnostic-information to display or save operating information for features and hardware modules.
Syntax
display diagnostic-information [ hardware | infrastructure | l2 | l3 | service ] [ key-info ] [ filename ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
hardware: Specifies hardware-related operating information.
infrastructure: Specifies operating information for the fundamental features.
l2: Specifies operating information for the Layer 2 features.
l3: Specifies operating information for the Layer 3 features.
service: Specifies operating information for Layer 4 and upper-layer features.
key-info: Displays or saves only critical operating information. The device might have a large amount of operating information if an exception occurs or after the device runs a long period of time. Specifying this keyword reduces the command execution time and helps you focus on critical operating information. If you do not specify this keyword, the command displays or saves both critical and non-critical operating information.
filename: Saves the information to a file. The filename argument must use the .tar.gz suffix.
Usage guidelines
You can use one of the following methods to collect operating statistics for diagnostics and troubleshooting:
· Use separate display commands to collect operating information feature by feature or module by module.
· Use the display diagnostic-information command to collect operating information for multiple or all features and hardware modules.
If you do not specify any feature parameters, this command displays or saves the operating information for all features and modules.
You can choose to display or save the operating information. To save storage space, this command automatically compresses the information before saving the information to a file. To view the file content:
1. Use the tar extract command to extract the file.
2. Use the gunzip command to decompress the extracted file.
3. Use the more command to view the content of the decompressed file.
If you 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, if the device name is A/B, the device name in the file name will be A_B, as in flash:/diag_A_B_20160101-000438.tar.gz.
The display diagnostic-information command does not support the |, >, and >> options.
Examples
# Display the operating information for all features and modules.
<Sysname> display diagnostic-information
Save or display diagnostic information (Y=save, N=display)? [Y/N]:n
===============================================
===============display clock===============
17:08:08 UTC Thu 07/07/2016
=================================================
===============display version===============
...
# Save the operating information to the default file.
<Sysname> display diagnostic-information
Save or display diagnostic information (Y=save, N=display)? [Y/N]:y
Please input the file name(*.tar.gz)[flash:/diag_Sysname_20160101-024601.tar.gz]:
Diagnostic information is outputting to flash:/diag_Sysname_20160101-024601.tar.gz.
Please wait...
Save successfully.
Press Enter when the system prompts you to enter the file name.
# Save the operating information for all features and modules to file test.tar.gz.
<Sysname> display diagnostic-information test.tar.gz
Diagnostic information is outputting to flash:/test.tar.gz.
Please wait...
Save successfully.
Related commands
gunzip
more
tar extract
display environment
Use display environment to display temperature information, including the temperature thresholds and the current temperature values.
Syntax
In standalone mode:
display environment [ slot slot-number ]
In IRF mode:
display environment [ chassis chassis-number [ slot slot-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
chassis chassis-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays temperature information for all member devices. (In IRF mode.)
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays information for all cards on the device. (In standalone mode.)
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays temperature information for all cards on the member device. (In IRF mode.)
Usage guidelines
In standalone mode, this command displays information about all temperature sensors on the device if you do not specify a card.
In IRF mode, this command displays information about all temperature sensors in the IRF fabric if you do not specify an IRF member device. If you specify an IRF member device but do not specify a card, this command displays information about all sensors on the member device.
Examples
# (In standalone mode.) Display information about all temperature sensors on the device.
<Sysname> display environment
System temperature information (degree centigrade):
------------------------------------------------------------------------------
Slot Sensor Temperature LowerLimit WarningLimit AlarmLimit ShutdownLimit
Vent Hotspot 1 28 0 120 255 255
0 Outflow 1 37 0 53 57 255
0 Hotspot 1 28 0 65 80 255
1 Inflow 1 28 0 50 57 255
1 Outflow 1 31 0 53 60 255
# (In IRF mode.) Display information about all temperature sensors in the IRF fabric.
<Sysname> display environment
System temperature information (degree centigrade):
------------------------------------------------------------------------------
Slot Sensor Temperature LowerLimit WarningLimit AlarmLimit ShutdownLimit
1/Vent Hotspot 1 28 0 120 255 255
1/0 Outflow 1 37 0 53 57 255
1/0 Hotspot 1 28 0 65 80 255
1/1 Inflow 1 28 0 50 57 255
1/1 Outflow 1 31 0 53 60 255
Table 7 Command output
Field |
Description |
System Temperature information (degree centigrade) |
Temperature information (°C). |
sensor |
Temperature sensor: · hotspot—Hotspot sensor. · inflow—Air inlet sensor. · outflow—Air outlet sensor. |
Slot |
A number in this field indicates a card. The value vent indicates a sensor on the frame or fan tray. (In standalone mode.) |
Slot |
The chassis-number/slot-number in this field indicates a card on an IRF member device. A value in the chassis-number/vent format indicates a sensor on the frame or fan tray of an IRF member device. (In IRF mode.) |
Temperature |
Current temperature. |
LowerLimit |
Lower temperature limit. |
WarningLimit |
Warning temperature threshold. |
AlarmLimit |
Alarming temperature threshold. |
ShutdownLimit |
Shutdown temperature threshold. When the sensor temperature reaches the limit, the system shuts down automatically. |
display fan
Use display fan to display fan operating status information.
Syntax
In standalone mode:
display fan [ fan-id ]
In IRF mode:
display fan [ chassis chassis-number [ fan-id ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
chassis chassis-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays fan operating status information for all member devices. (In IRF mode.)
fan-id: Specifies a fan by its ID, which is fixed at 1. If you do not specify a fan, this command displays operating status information for all fans at the specified position.
Examples
# Display the operating states of all fans.
<Sysname> display fan
Fan 1 : Normal
display memory
Use display memory to display memory usage information.
Syntax
In standalone mode:
display memory [ summary ] [ slot slot-number [ cpu cpu-number ] ]
In IRF mode:
display memory [ summary ] [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
summary: Displays brief information about memory usage. If you do not specify this keyword, the command displays detailed information about memory usage.
slot slot-number: Specifies the slot number of the device, which is fixed at 0. Alternatively, you can execute the command without specifying this option. The command execution results are the same. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the device, which is fixed at 0. If you do not specify an IRF member device, this command displays memory usage for all IRF member devices. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number.
Examples
# (In standalone mode.) Display detailed memory usage information.
<Sysname> display memory
Memory statistics are measured in KB:
Slot 0:
Total Used Free Shared Buffers Cached FreeRatio
Mem: 2035352 795948 1239404 0 0 151032 60.9%
-/+ Buffers/Cache: 644916 1390436
Swap: 0 0 0
# (In IRF mode.) Display brief memory usage information.
<Sysname> display memory summary
Memory statistics are measured in KB:
Chassis 1 Slot 0:
Total Used Free Shared Buffers Cached FreeRatio
Mem: 2035352 795948 1239404 0 0 151032 60.9%
-/+ Buffers/Cache: 644916 1390436
Swap: 0 0 0
Table 8 Command output
Field |
Description |
Mem |
Memory usage information. |
Total |
Total size of the physical memory space that can be allocated. The memory space is virtually divided into two parts. Part 1 is solely used for ISSU, kernel code, and kernel management. 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. |
display memory-threshold
Use display memory-threshold to display memory alarm thresholds and statistics.
Syntax
In standalone mode:
display memory-threshold [ slot slot-number [ cpu cpu-number ] ]
In IRF mode:
display memory-threshold [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]
Views
Any view
Predefined user roles
network-admin
mdc-admin
Parameters
slot slot-number: Specifies the slot number of the device, which is fixed at 0. Alternatively, you can execute the command without specifying this option. The command execution results are the same. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the device, which is fixed at 0. If you do not specify an IRF member device, this command displays the memory alarm thresholds and statistics for all IRF member devices. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number.
Usage guidelines
For more information about memory usage notifications, see log information containing MEM_EXCEED_THRESHOLD or MEM_BELOW_THRESHOLD.
Examples
# Display memory alarm thresholds and statistics.
<Sysname> display memory-threshold
Memory usage threshold: 100%
Free memory threshold:
Minor: 64M
Severe: 48M
Critical: 32M
Normal: 96M
Current memory state: Normal
Event statistics:
[Back to normal state]
First notification: 2012-5-15 09:21:35.546
Latest notification: 2012-5-15 09:21:35.546
Total number of notifications sent: 1
[Enter minor low-memory state]
First notification at: 2012-5-15 09:07:05.941
Latest notification at: 2012-5-15 09:07:05.941
Total number of notifications sent: 1
[Back to minor low-memory state]
First notification at: 0.0
Latest notification at: 0.0
Total number of notifications sent: 0
[Enter severe low-memory state]
First notification at: 0.0
Latest notification at: 0.0
Total number of notifications sent: 0
[Back to severe low-memory state]
First notification at: 0.0
Latest notification at: 0.0
Total number of notifications sent: 0
[Enter critical low-memory state]
First notification at: 0.0
Latest notification at: 0.0
Total number of notifications sent: 0
display power-supply
Use display power-supply to display power supply information.
Syntax
In standalone mode:
display power-supply [ verbose ]
In IRF mode:
display power-supply [ chassis chassis-number ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
chassis chassis-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command displays power supply information for all member devices. (In IRF mode.)
verbose: Displays detailed power supply information. If you do not specify this keyword, this command displays the brief information.
Examples
# Display detailed power supply information.
<Sysname> display power-supply verbose
Power No. State Description
------------------------------------------------
1/1 Absent Unknown
1/2 Normal VAPEL-300AC
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
mdc-admin
mdc-operator
Parameters
job-name: Specifies a job by its name, a case-sensitive string of 1 to 47 characters. If you do not specify a job, this command displays configuration information for all jobs.
Examples
# Display configuration information for all jobs.
<Sysname> display scheduler job
Job name: saveconfig
copy startup.cfg backup.cfg
Job name: backupconfig
Job name: creat-VLAN100
system-view
vlan 100
// The output shows that the device has three jobs: the first has one command, the second does not have any commands, and the third has two commands. Jobs are separated by blank lines.
display scheduler logfile
Use display scheduler logfile to display job execution log information.
Syntax
display scheduler logfile
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Examples
# Display job execution log information.
<Sysname> display scheduler logfile
Logfile Size: 1902 Bytes.
Job name : shutdown
Schedule name : shutdown
Execution time : Tue Dec 27 10:44:42 2011
Completion time : Tue Dec 27 10:44:47 2011
--------------------------------- Job output -----------------------------------
<Sysname>system-view
System View: return to User View with Ctrl+Z.
[Sysname]interface rang gigabitethernet 1/1/1 to gigabitethernet 1/1/3
[Sysname-if-range]shutdown
Table 9 Command output
Field |
Description |
Logfile Size |
Size of the log file, in bytes. |
Schedule name |
Schedule to which the job belongs. |
Execution time |
Time when the job was started. |
Completion time |
Time when the job was completed. If the job has never been executed or the job does not have any commands, this field is blank. |
Job output |
Commands in the job and their output. |
Related commands
reset scheduler logfile
display scheduler reboot
Use display scheduler reboot to display the automatic reboot schedule.
Syntax
display scheduler reboot
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Examples
# Display the automatic reboot schedule.
<Sysname> display scheduler reboot
System will reboot at 16:32:00 05/23/2016 (in 1 hours and 39 minutes).
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
mdc-admin
mdc-operator
Parameters
schedule-name: Specifies a schedule by its name, a case-sensitive string of 1 to 47 characters. If you do not specify a schedule, this command displays information about all schedules.
Examples
# Display information about all schedules.
<Sysname> display scheduler schedule
Schedule name : shutdown
Schedule type : Run once after 0 hours 2 minutes
Start time : Tue Dec 27 10:44:42 2011
Last execution time : Tue Dec 27 10:44:42 2011
Last completion time : Tue Dec 27 10:44:47 2011
Execution counts : 1
-----------------------------------------------------------------------
Job name Last execution status
shutdown Successful
Table 10 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 [ mdc { id | all } ]
Views
Any view
network-admin
mdc { id | all }: Specifies an MDC by its ID or specifies all MDCs.
If you do not specify any options, this command displays stability information for the system.
The device/card/MDC startup takes some time. If the values of the status fields do not change to Stable, execute this command multiple times to identify the devices/cards/MDCs that are not in Stable state. You can also use other commands to identify the faulty components. For example:
· Use the display device command to identify the cards in Fault state.
· Use the display ha service-group command to display the status of HA service groups and identify the groups in batch backup state.
· Use the display system internal process status command to display service operating status.
Examples
# (In standalone mode.) Display system stability and status information.
<Sysname> display system stable state
System state : Stable
Redundancy state : No redundance
Slot CPU Role State
0 0 Active Stable
# (In IRF mode.) Display system stability and status information.
<Sysname> display system stable state
System state : Stable
Redundancy state : No redundance
Chassis Slot CPU Role State
1 0 0 Active Stable
Table 11 Command output
Description |
|
System status: · Stable—The system is operating stably. · Not ready—The system is not operating stably. You cannot perform an ISSU when the system is in this state. |
|
System redundancy status: · Stable—Both MPUs are operating stably. You can perform a switchover. · Not ready—The system is not operating stably. You cannot perform a switchover. |
|
Role of the device in the system: · Active—The device is the master. · Standby—The device is a subordinate member. |
|
· Stable—The device is operating stably. · Kernel initiating—The kernel is being initialized. · Service starting—Services are starting. · Service stopping—Services are stopping. · HA batch backup—An HA batch backup is going on. · Interface data batch backup—An interface data batch backup is in progress. · MDC starting—MDCs are starting. · MDC stopping—MDCs are stopping. |
|
# Display stability and status information about all MDCs.
<Sysname> display system stable state mdc all
MDC 1 state: Stable
Chassis Slot CPU Role State
1 0 0 Active Stable
2 0 0 Standby Stable
* MDC 2 state: HA Batch Backup
Chassis Slot CPU Role State
1 0 0 Active Stable
* 2 0 0 Standby HA batch backup
Table 12 Command output
Description |
|
· Stable—The MDC is operating stably. · kernel initiating—The MDC kernel is being initialized. · Kernel finish—The MDC kernel is closed. · Service starting—Services are starting on the MDC. · Service stopping—Services are stopping on the MDC. · Automatic configuration—The MDC is being automatically configured. · HA batch backup—An HA batch backup is in progress on the MDC. · Interface data batch backup—An interface data batch backup is in progress on the MDC. |
|
Role of the device in the system: · Active—The device is the master. · Standby—The device is a subordinate member. |
|
Status of the device on the MDC. This field has the same values as the MDC n State field. |
|
The object is not operating stably. |
Related commands
display device
display ha service-group (High Availability Command Reference)
display mdc (Virtual Technologies Command Reference)
display system internal process status (Device management probe commands)
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
mdc-admin
mdc-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 13 shows the common transceiver alarm components. If no error occurs, "None" is displayed.
Table 13 Common transceiver alarm components
Field |
Description |
RX |
Receive |
TX |
Transmit |
power |
Optical power |
Temp |
Temperature |
APD |
Avalanche photo diode |
TEC |
Thermoelectric cooler |
Examples
# Display the alarms present on the transceiver module in interface GigabitEthernet 1/1/1.
<Sysname> display transceiver alarm interface gigabitethernet 1/1/1
GigabitEthernet1/1/1 transceiver current alarm information:
RX loss of signal
RX power low
Table 14 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. |
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
mdc-admin
mdc-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
Support for this command and the command output vary by transceiver module model.
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 GigabitEthernet 1/1/1.
<Sysname> display transceiver diagnosis interface gigabitethernet 1/1/1
GigabitEthernet1/1/1 transceiver diagnostic information:
Current diagnostic parameters:
Temp(°C) Voltage(V) Bias(mA) RX power(dBm) TX power(dBm)
36 3.31 6.13 -35.64 -5.19
Alarm thresholds:
Temp(°C) Voltage(V) Bias(mA) RX power(dBM) TX power(dBM)
High 50 3.55 1.44 -10.00 5.00
Low 30 3.01 1.01 -30.00 0.00
Table 15 Command output
Field |
Description |
transceiver diagnostic information |
Digital diagnosis information for 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) |
Receive power in dBm, accurate to 0.01 dBm. |
TX power(dBm) |
Transmit power in dBm, accurate to 0.01 dBm. |
display transceiver interface
Use display transceiver interface to display the key parameters of transceiver modules.
Syntax
display transceiver interface [ interface-type interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
interface-type interface-number: Specifies an interface by its type and number. If you do not specify an interface, this command displays the key parameters of every transceiver module.
Examples
# Display the key parameters of the transceiver module in interface GigabitEthernet 1/1/1.
<Sysname> display transceiver interface gigabitethernet 1/1/1
GigabitEthernet1/1/1 transceiver information:
Transceiver Type : 1000_BASE_T_AN_SFP
Connector Type : RJ45
Wavelength(nm) : N/A
Transfer Distance(m) : 100(TP)
Digital Diagnostic Monitoring : NO
Vendor Name : FINISAR CORP.
Table 16 Command output
Field |
Description |
Connector Type |
Connector types: · SC—Fiber connector developed by NTT. · LC—1.25 mm/RJ-45 fiber connector developed by Lucent. · RJ-45. |
Wavelength(nm) |
Central wavelength (in nm) of the transmit laser. If the transceiver supports multiple wavelengths, every two wavelength values are separated by a comma. For a copper cable, this field displays N/A. |
Transfer Distance(xx) |
Transmission distance, where xx indicates the distance unit: · km—Kilometers, for single-mode transceiver modules. · m—Meters, for other transceiver modules. If the transceiver module supports multiple types of transmission media, this field displays the transmission distance for each type, in the form transmission distance (medium type). Transmission medium types include: · 9 um—9/125 µm single-mode fiber. · 50 um—50/125 µm multimode fiber. · 62.5 um—62.5/125 µm multimode fiber. · TP—Twisted pair. |
Digital Diagnostic Monitoring |
Support for digital diagnosis: · YES—Supported. · NO—Not supported. |
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
mdc-admin
mdc-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 electronic label information for the transceiver module on interface GigabitEthernet 1/1/1.
<Sysname> display transceiver manuinfo interface gigabitethernet 1/1/1
GigabitEthernet1/1/1 transceiver manufacture information:
Manu. Serial Number : 213410A0000054000251
Manufacturing Date : 2012-09-01
Vendor Name : H3C
Table 17 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
mdc-admin
mdc-operator
Examples
# Display system version information.
<Sysname> display version
H3C Comware Software, Version 7.1.064, Ess 7602P02
Copyright (c) 2004-2016 Hangzhou H3C Tech. Co., Ltd. All rights reserved.
H3C SR6602-X2 uptime is 0 weeks, 0 days, 2 hours, 7 minutes
Last reboot reason : Power on
Boot image: flash:/SR6602X-CMW710-BOOT-E7602P02.bin
Boot image version: 7.1.064, Ess 7602P02
Compiled Apr 12 2016 16:00:00
System image: flash:/SR6602X-CMW710-SYSTEM-E7602P02.bin
System image version: 7.1.064, Ess 7602P02
Compiled Apr 12 2016 16:00:00
display version-update-record
Use display version-update-record to display the startup software image upgrade records of the device. (In standalone mode.)
Use display version-update-record to display the startup software image upgrade records of the master device. (In IRF mode.)
Syntax
display version-update-record
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Usage guidelines
The device records its current startup software version information and all subsequent version update information. Such information can survive reboots.
Examples
# Display the startup software image upgrade records.
<Sysname> display version-update-record
Record 1 (updated on Jul 07 2016 at 04:46:31):
*Name : SR6602X-CMW710-BOOT-test.bin
Version : 7.1.064 Ess 7602P02
Compile time: Apr 12 2016 16:00:00
*Name : SR6602X-CMW710-SYSTEM-test.bin
Version : 7.1.064 Ess 7602P02
Compile time: Apr 12 2016 16:00:00
Table 18 Command output
Field |
Description |
Record n |
Number of the startup software image upgrade record. Record 1 is the most recent record. |
Name |
Software image file name. |
* |
The software image version changed during the upgrade. |
Related commands
reset version-update-record
header
Use header to configure a banner.
Use undo header to delete a banner.
Syntax
header { incoming | legal | login | motd | shell } text
undo header { incoming | legal | login | motd | shell }
Default
No banner exists.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
incoming: Configures the banner to be displayed before a modem dial-in user accesses user view. If authentication is required, the incoming banner appears after the authentication is passed. This keyword is not supported in the current software version.
legal: Configures the banner to be displayed before a user inputs the username and password to access the CLI.
login: Configures the banner to be displayed before password or scheme authentication is performed for a login user.
motd: Configures the greeting banner to be displayed before the legal banner appears.
shell: Configures the banner to be displayed before a non-modem dial-in user accesses user view.
text: Specifies the banner message. You can enter the banner message on the same line as the keywords or on different lines. For more information, see Fundamentals Configuration Guide.
Examples
# Configure the incoming banner, legal banner, login banner, MOTD banner, and shell banner.
<Sysname> system-view
[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 for each banner and is not included in the banners.
# Telnet to the device to test the configuration. The login banner appears only when password or scheme login authentication has been configured.
******************************************************************************
* Copyright (c) 2004-2016 Hangzhou H3C Tech. 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 motd(header motd)
Welcome to login(header login)
Login authentication
Password:
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
mdc-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
In standalone mode:
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 ] ]
In IRF mode:
memory-threshold [ chassis chassis-number slot slot-number [ cpu cpu-number ] ] minor minor-value severe severe-value critical critical-value normal normal-value
undo memory-threshold [ chassis chassis-number 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
mdc-admin
Parameters
minor minor-value: Specifies the minor alarm threshold in MB. The value range is 0 to 1987. 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 MB. The value range varies by the specified minor alarm threshold. 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 MB. The value range varies by the specified severe alarm threshold. 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 MB. The value range varies by the specified minor alarm threshold. This threshold must be equal to or less than the total memory size.
slot slot-number: Specifies the slot number of the device, which is fixed at 0. Alternatively, you can execute the command without specifying this option. The command execution results are the same. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the device, which is fixed at 0. If you do not specify a member device, this command sets free-memory thresholds for the master. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number.
Usage guidelines
To ensure correct operation and improve memory efficiency, the system monitors the amount of free memory space in real time. If the amount of free memory space exceeds a free-memory threshold, the system generates an alarm notification and sends it to affected service modules or processes. For more information about the thresholds, see Fundamentals Configuration Guide.
# 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
display memory-threshold
memory-threshold usage
Use memory-threshold usage to set the memory usage threshold.
Use undo memory-threshold usage to restore the default.
Syntax
In standalone mode:
memory-threshold [ slot slot-number [ cpu cpu-number ] ] usage memory-threshold
undo memory-threshold [ slot slot-number [ cpu cpu-number ] ] usage
In IRF mode:
undo memory-threshold [ chassis chassis-number slot slot-number [ cpu cpu-number ] ] usage
Default
The memory usage threshold is 100%.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
memory-threshold: Specifies the memory usage threshold in percentage. The value range is 0 to 100.
slot slot-number: Specifies the slot number of the device, which is fixed at 0. Alternatively, you can execute the command without specifying this option. The command execution results are the same. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the device, which is fixed at 0. If you do not specify a member device, this command sets the memory usage threshold for the master. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number.
Usage guidelines
The device samples memory usage at an interval of 1 minute. If the sample is greater than the memory usage threshold, the device sends a trap.
Examples
# Set the memory usage threshold to 80%.
<Sysname> system-view
[Sysname] memory-threshold slot 1 cpu 1 usage 80
Related commands
display memory-threshold
monitor cpu-usage enable
Use monitor cpu-usage enable to enable CPU usage monitoring.
Use undo monitor cpu-usage enable to disable CPU usage monitoring.
Syntax
In standalone mode:
monitor cpu-usage enable [ slot slot-number [ cpu cpu-number ] ]
undo monitor cpu-usage enable [ slot slot-number [ cpu cpu-number ] ]
In IRF mode:
monitor cpu-usage enable [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]
undo monitor cpu-usage enable [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]
Default
CPU usage monitoring is enabled.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
slot slot-number: Specifies the slot number of the device, which is fixed at 0. Alternatively, you can execute the command without specifying this option. The command execution results are the same. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the device, which is fixed at 0. If you do not specify a member device, this command enables CPU usage monitoring for the master. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number.
Usage guidelines
After CPU usage monitoring is enabled, the system samples and saves CPU usage at the interval specified by the monitor cpu-usage interval command. You can use the display cpu-usage history command to view recent CPU usage.
Examples
# Enable CPU usage monitoring.
<Sysname> system-view
[Sysname] monitor cpu-usage enable
display cpu-usage configuration
display cpu-usage history
monitor cpu-usage interval
monitor cpu-usage interval
Use monitor cpu-usage interval to set the sampling interval for CPU usage monitoring.
Syntax
In standalone mode:
monitor cpu-usage interval interval [ slot slot-number [ cpu cpu-number ] ]
In IRF mode:
monitor cpu-usage interval interval [ chassis chassis-number slot slot-number [ cpu cpu-number ] ]
Default
The system samples CPU usage every 1 minute.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
interval: Specifies the sampling interval for CPU usage monitoring. Valid values include 5Sec for 5 seconds, 1Min for 1 minute, and 5Min for 5 minutes.
slot slot-number: Specifies the slot number of the device, which is fixed at 0. Alternatively, you can execute the command without specifying this option. The command execution results are the same. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the device, which is fixed at 0. If you do not specify a member device, this command sets the sampling interval for the master. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number.
Usage guidelines
After CPU usage monitoring is enabled, the system samples and saves CPU usage at the specified interval. You can use the display cpu-usage history command to view recent CPU usage.
Examples
# Set the sampling interval for CPU usage monitoring to 5 seconds.
<Sysname> system-view
[Sysname] monitor cpu-usage interval 5Sec
Related commands
display cpu-usage configuration
display cpu-usage history
monitor cpu-usage enable
monitor cpu-usage threshold
Use monitor cpu-usage threshold to set the CPU usage threshold.
Use undo monitor cpu-usage threshold to restore the default.
Syntax
In standalone mode:
monitor cpu-usage threshold cpu-threshold [ slot slot-number [ cpu cpu-number ] ]
undo monitor cpu-usage threshold [ slot slot-number [ cpu cpu-number ] ]
In IRF mode:
undo monitor cpu-usage threshold [ chassis chassis-number 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 the CPU usage threshold in percentage. The value range is 1 to 100.
slot slot-number: Specifies the slot number of the device, which is fixed at 0. Alternatively, you can execute the command without specifying this option. The command execution results are the same. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the device, which is fixed at 0. If you do not specify a member device, this command sets the CPU usage threshold for the master. (In IRF mode.)
cpu cpu-number: Specifies a CPU by its number.
Usage guidelines
The device samples CPU usage at an interval of 1 minute. 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 configuration
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
mdc-admin
Usage guidelines
Password recovery capability controls console user access to the device configuration and SDRAM from BootWare menus.
If password recovery capability is enabled, a console user can access the device configuration without authentication to configure new passwords.
If password recovery capability is disabled, console users must restore the factory-default configuration before they can configure new passwords. Restoring the factory-default configuration deletes the next-startup configuration files.
To enhance system security, disable password recovery capability.
Availability of BootWare menu options depends on the password recovery capability setting. For more information, see BootWare management in Fundamentals Configuration Guide.
Examples
# Disable password recovery capability.
<Sysname> system-view
[Sysname] undo password-recovery enable
reboot
Use reboot to reboot a card, an interface module, or the entire system. (In standalone mode.)
Use reboot to reboot an IRF member device, an interface module, or all IRF member devices. (In IRF mode.)
Syntax
In standalone mode:
reboot [ slot slot-number [ subslot subslot-number ] ] [ force ]
In IRF mode:
reboot [ chassis chassis-number [ slot slot-number [ subslot subslot-number ] ] ] [ force ]
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
chassis chassis-number: Specifies an IRF member device by its member ID. (In IRF mode.)
slot slot-number: Specifies a slot number.
subslot subslot-number: Specifies an interface module by its subslot number.
force: Reboots the device immediately without performing software or hard disk check. If this keyword is not specified, the system first identifies whether the reboot might result in data loss or a system failure. For example, the system identifies whether the main system software image file exists and whether a write operation is in progress on a storage medium. If the reboot might cause problems, the system does not reboot the device.
Usage guidelines
|
CAUTION: · A reboot might interrupt network services. · If the main startup software images are corrupt or missing, you must re-specify a set of main startup software images before executing the reboot command. · Use the force keyword only when the device fails or a reboot command without the force keyword cannot perform a reboot correctly. A reboot command with the force keyword might result in file system corruption because it does not perform data protection. |
For data security, the device does not reboot if you reboot the device while the device is performing file operations.
In standalone mode:
· To reboot the entire device, do not specify the slot number option.
· To reboot a card, specify the slot number and do not specify a subslot number. If the slot number is 0, the entire device reboots.
In IRF mode:
· To reboot all IRF member devices, do not specify the member ID option.
· To reboot an IRF member device, specify only the member ID.
· To reboot a card, specify both the member ID and the slot number. If the slot number is 0, the entire device reboots.
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...
# Reboot the device when the device has configuration changes that have not been saved. Choose to save the running configuration.
<Sysname> reboot
Start to check configuration with next startup configuration file, please wait.........DONE!
Current configuration will be lost after the reboot, save current configuration? [Y/N]:y
Please input the file name(*.cfg)[flash:/startup.cfg]
(To leave the existing filename unchanged, press the enter key):
flash:/startup.cfg exists, overwrite? [Y/N]:y
Validating file. Please wait...
Saved the current configuration to mainboard device successfully.
This command will reboot the device. Continue? [Y/N]:y
Now rebooting, please wait...
# Reboot the device when the device has configuration changes that have not been saved. Choose not to save the running configuration.
<Sysname> reboot
Start to check configuration with next startup configuration file, please wait.........DONE!
Current configuration will be lost after the reboot, save current configuration? [Y/N]:n
This command will reboot the device. Continue? [Y/N]:y
Now rebooting, please wait...
# Reboot the device immediately without performing software check.
<Sysname> reboot force
A forced reboot might cause the storage medium to be corrupted. Continue? [Y/N]:y
Now rebooting, please wait...
# (In standalone mode.) Reboot the card in slot 1.
<Sysname> reboot slot 1
Start to check configuration with next startup configuration file, please wait..
.......DONE!
This command will reboot the specified slot, Continue? [Y/N]:y
Now rebooting, please wait...
# (In standalone mode.) Reboot the card in slot 1 by force.
<Sysname> reboot slot 1 force
A forced reboot might cause the storage medium to be corrupted. Continue? [Y/N]:y
Now rebooting, please wait...
# (In IRF mode.) Reboot IRF member device 2.
<Sysname> reboot chassis 2
Start to check configuration with next startup configuration file, please wait..
.......DONE!
This command will reboot the specified chassis, Continue? [Y/N]:y
Now rebooting, please wait...
# (In IRF mode.) Reboot IRF member device 2 by force.
<Sysname> reboot chassis 2 force
A forced reboot might cause the storage medium to be corrupted. Continue? [Y/N]:y
Now rebooting, please wait...
# (In IRF mode.) Reboot the card in slot 1 on IRF member device 2.
<Sysname> reboot chassis 2 slot 1
Start to check configuration with next startup configuration file, please wait..
.......DONE!
This command will reboot the specified slot, Continue? [Y/N]:y
Now rebooting, please wait...
# (In IRF mode.) Reboot the card in slot 1 on IRF member device 2 by force.
<Sysname> reboot chassis 2 slot 1 force
A forced reboot might cause the storage medium to be corrupted. Continue? [Y/N]:y
Now rebooting, please wait...
display system stable state
remove
Use remove to unmount an interface card or module.
Use undo remove to mount an unmounted interface card or module.
Syntax
In standalone mode:
remove slot slot-number [ subslot subslot-number ]
undo remove slot slot-number [ subslot subslot-number ]
In IRF mode:
remove chassis chassis-number slot slot-number [ subslot subslot-number ]
undo remove chassis chassis-number slot slot-number [ subslot subslot-number ]
Views
User view
Predefined user roles
network-admin
Parameters
chassis chassis-number: Specifies an IRF member device by its member ID. (In IRF mode.)
slot slot-number : Specifies an interface card by its slot number.
subslot subslot-number: Specifies an interface module by its subslot number.
Usage guidelines
|
CAUTION: Unmounting an interface card or module stops all services provided by the card or module. |
An unmounted interface card or module
Before hot-swapping an interface card or module from the device, complete one of the following tasks:
· Use this command to unmount the interface card or module.
· Verify that interfaces on the interface card or module are displayed in the output from the display interface brief command. For more information about this command, see Interface Command Reference.
Examples
# (In standalone mode.) Unmount the interface module in subslot 1 of the interface card in slot 1.
<Sysname> remove slot 1 subslot 1
This command will remove the specified card, Continue? [Y/N]:y.
# (In IRF mode.) Unmount the interface module in subslot 1 of the interface card in slot 6 on member device 1.
<Sysname> remove chassis 1 slot 1 subslot 1
This command will remove the specified card, Continue? [Y/N]:y.
reset scheduler logfile
Use reset scheduler logfile to clear job execution log information.
Syntax
reset scheduler logfile
Views
User view
Predefined user roles
network-admin
mdc-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 records of the device. (In standalone mode.)
Use reset version-update-record to clear the startup software image upgrade records of the master device. (In IRF mode.)
Syntax
reset version-update-record
Views
System view
Predefined user roles
network-admin
mdc-admin
Examples
# Clear the startup software image upgrade records.
<Sysname> system-view
[Sysname] reset version-update-record
This command will delete all records of version update. Continue? [Y/N]:y
Related commands
display version-update-record
restore factory-default
Use restore factory-default to restore the factory-default configuration for the device.
Syntax
restore factory-default
Views
User view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
|
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. |
This command takes effect after the device reboots.
Examples
# Restore the factory-default configuration for the device.
<Sysname> restore factory-default
This command will restore the system to the factory default configuration and clear the operation data. Continue [Y/N]:y
Restoring the factory default configuration. This process might take a few minutes. Please wait..........................................................................................................Done.
Please reboot the system to place the factory default configuration into effect.
Related commands
reboot
scheduler job
Use scheduler job to create a job and enter its view, or enter the view of an existing job.
Use undo scheduler job to delete a job.
Syntax
scheduler job job-name
undo scheduler job job-name
Default
No job exists.
Views
System view
Predefined user roles
network-admin
mdc-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 for 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
mdc-admin
Parameters
value: Specifies the size of the job execution log file, in KB. The value range is 16 to 1024.
Usage guidelines
The job execution log file saves the execution information of jobs. If the file is full, old records are deleted to make room for new records. If the size of the log information to be written to the file is greater than the file size, the excessive information is not written to the file.
Examples
# Set the size of the job execution log file to 32 KB.
<Sysname> system-view
[Sysname] scheduler logfile size 32
Related commands
display scheduler logfile
scheduler reboot at
Use scheduler reboot at to specify the reboot date and time.
Use undo scheduler reboot to delete the reboot schedule configuration.
Syntax
scheduler reboot at time [ date ]
undo scheduler reboot
Default
No reboot date or time is specified.
Views
User view
Predefined user roles
network-admin
mdc-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: 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, the system does not reboot at the reboot time if a file operation is being performed.
The device supports only one device reboot schedule. If you execute both the scheduler reboot delay and scheduler reboot at commands or execute one of the commands multiple times, the most recent configuration takes effect.
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, 2016.
<Sysname> scheduler reboot at 12:00
Reboot system at 12:00:00 06/06/2016 (in 0 hours and 16 minutes). Confirm? [Y/N]:
Related commands
scheduler reboot delay
scheduler reboot delay
Use scheduler reboot delay to specify the reboot delay time.
Use undo scheduler reboot to delete the reboot schedule configuration.
Syntax
scheduler reboot delay time
undo scheduler reboot
Default
No reboot delay time is specified.
Views
User view
Predefined user roles
network-admin
mdc-admin
Parameters
time: Specifies the reboot delay time in the hh:mm or mm format. This argument can contain up to six characters. When in the hh:mm format, mm must be in the range of 0 to 59.
Usage guidelines
|
CAUTION: Device reboot interrupts network services. |
For data security, the system does not reboot at the reboot time if a file operation is being performed.
The device supports only one device reboot schedule. If you execute both the scheduler reboot delay and schedule reboot at commands or execute one of the commands multiple times, the most recent configuration takes effect.
Examples
# Configure the device to reboot after 88 minutes. This example assumes that the current time is 11:48 a.m. on June 6, 2016.
<Sysname> scheduler reboot delay 88
Reboot system at 13:16 06/06/2016(in 1 hours and 28 minutes). Confirm? [Y/N]:
scheduler schedule
Use scheduler schedule to create a schedule and enter its view, or enter the view of an existing schedule.
Use undo scheduler schedule to delete a schedule.
Syntax
scheduler schedule schedule-name
undo scheduler schedule schedule-name
Default
No schedule exists.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
schedule-name: Specifies the schedule name, a case-sensitive string of 1 to 47 characters.
Usage guidelines
You can configure a schedule to have the device automatically run a command or a set of commands without administrative interference.
To configure a schedule:
1. Use the scheduler job command to create a job and enter job view.
2. Use the command command to assign commands to the job.
3. Use the scheduler schedule command to create a schedule and enter schedule view.
4. Use the job command to assign the job to the schedule. You can assign multiple jobs to a schedule. The jobs must already exist.
5. Use the user-role command to assign user roles to the schedule. You can assign up to 64 user roles to a schedule.
6. Use the time at, time once, or time repeating command to specify an execution time for the schedule. You can specify only one execution time for a schedule.
Examples
# Create a schedule named saveconfig.
<Sysname> system-view
[Sysname] scheduler schedule saveconfig
Related commands
job
time at
time once
shutdown-interval
Use shutdown-interval to set the port status detection timer.
Use undo shutdown-interval to restore the default.
Syntax
shutdown-interval interval
undo shutdown-interval
Default
The port status detection timer setting is 30 seconds.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
interval: Specifies the port status detection timer value in seconds. The value range is 0 to 300. To disable port status detection, set this argument to 0.
Usage guidelines
The device starts a port status detection timer when a port is shut down by a protocol. Once the timer expires, the device brings up the port so the port status reflects the port's physical status.
If you change the timer setting during port detection, the device compares the new setting (T1) with the time that elapsed since the port was shut down (T).
· If T < T1, the port will be brought up after T1 – T seconds.
· If T ≥ T1, the port is brought up immediately.
For example, the timer setting is 30 seconds. If you change it to 10 seconds 2 seconds after the port is shut down, the port will come up 8 seconds later. If you change the timer setting to 2 seconds 10 seconds after the port is shut down, the port comes up immediately.
Examples
# Set the port status detection timer to 100 seconds.
<Sysname> system-view
[Sysname] shutdown-interval 100
sysname
Use sysname to set the device name.
Use undo sysname to restore the default.
Syntax
sysname sysname
undo sysname
Default
The device name is H3C.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
sysname: Specifies a name for the device, a string of 1 to 64 characters.
Usage guidelines
A device name identifies a device in a network and is used in CLI view prompts. For example, if the device name is Sysname, the user view prompt is <Sysname>.
Examples
# Set the name of the device to R2000.
<Sysname> system-view
[Sysname] sysname R2000
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
mdc-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 July 11, 2016.
<Sysname> system-view
[Sysname] scheduler schedule saveconfig
[Sysname-schedule-saveconfig] time at 1:1 2016/07/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
mdc-admin
Parameters
at time: Specifies the execution time in the hh:mm format. The value range for hh is 0 to 23. The value range for mm is 0 to 59.
month-date month-day: Specifies a day in the current month, in the range of 1 to 31. If you specify a day that does not exist in the current month, the configuration takes effect on that day in the next month.
week-day week-day&<1-7>: Specifies a space-separated list of up to seven week days for the schedule. Valid week day values include Mon, Tue, Wed, Thu, Fri, Sat, and Sun.
delay time: Specifies the delay time for executing the schedule, in the hh:mm or mm format. This argument can have up to six characters. When in the hh:mm format, mm must be in the range of 0 to 59.
Usage guidelines
If the specified time has already occurred, the schedule will be executed at the specified time the following day.
If the day in the month has already occurred, the schedule will be executed at the specified day in the following month.
If the specified day in a week has already occurred, the schedule will be executed at the specified day in the following week.
The time at command, the time once command, and the time repeating command overwrite 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 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
mdc-admin
Parameters
at time: Specifies the execution time in the hh:mm format. The value range for hh is 0 to 23. The value range for mm is 0 to 59. If you do not specify this option, the current system time is used as the execution time.
date: Specifies the start date for the periodic schedule, in the MM/DD/YYYY or YYYY/MM/DD format. The value range for YYYY is 2000 to 2035. The value range for MM is 1 to 12. The value range for DD varies by month. If you do not specify this argument, the execution start date is the first day when the specified time arrives.
interval interval: Specifies the execution time interval in the hh:mm or mm format. This argument can have up to six characters. When in the hh:mm format, mm must be in the range of 0 to 59. When in the mm format, this argument must be equal to or greater than 1 minute.
month-date [ month-day | last ]: Specifies a day in a month, in the range 1 to 31. The last keyword indicates the last day of a month. If you specify a day that does not exist in a month, the configuration takes effect on that day in the next month.
week-day week-day&<1-7>: Specifies a space-separated list of up to seven week days for the schedule. Valid week day values include Mon, Tue, Wed, Thu, Fri, Sat, and Sun.
Usage guidelines
The time repeating [ at time [ date ] ] interval interval command configures the device to execute a schedule at an interval from the specified time on.
The time repeating at time [ month-date [ month-day | last ] | week-day week-day&<1-7> ] command configures the device to execute a schedule at the specified time on every specified day in a month or week.
The time at command, the time once command, and the time repeating command overwrite 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
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, mdc-admin, mdc-operator, and level-0 to level-15.
A schedule must have one or more user roles, and can have up to 64 user roles. A command in a schedule can be executed if it is permitted by one or more user roles of the schedule.
You cannot assign user roles higher than the user role for the user line that you are using. If the user role of the user line you are using is mdc-admin, you cannot assign the network-admin user role to a schedule.
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
Related commands
command