Title | Size | Download |
---|---|---|
06-Device management commands | 255.71 KB |
clock datetime
Use clock datetime to set the system time and date.
Syntax
clock datetime time date
Views
User view
Default command level
3: Manage level
Parameters
time: Specifies a time, in the hh:mm:ss format. The hh value ranges from 00 to 23, the mm value ranges from 00 to 59, and the ss value ranges from 00 to 59. Zeros can be omitted, unless you specify 00:00:00.
date: Specifies a date, in the MM/DD/YYYY or YYYY/MM/DD format. The YYYY value ranges from 2000 to 2035, the MM value ranges from 1 to 12, and the DD value ranges from 1 to 31.
Usage guidelines
You can leave the ss field blank when you specify the time parameters.
Examples
# Set the current system time to 14:10:20 08/01/2013.
<Sysname> clock datetime 14:10:20 8/1/2013
# Set the current system time to 00:06:00 01/01/2013.
<Sysname> clock datetime 0:6 2013/1/1
· clock summer-time one-off
· clock summer-time repeating
· clock timezone
· display clock
clock summer-time one-off
Use clock summer-time one-off to adopt daylight saving time from the start-time of the start-date to the end-time of the end-date. Daylight saving time adds the add-time to the standard time of the device.
Use undo clock summer-time to cancel the configuration of the daylight saving time.
Syntax
clock summer-time zone-name one-off start-time start-date end-time end-date add-time
undo clock summer-time
Default
Daylight saving time is disabled and the UTC time zone applies.
Views
System view
Default command level
3: Manage level
Parameters
zone-name: Specifies a daylight saving time schedule by a zone name, a case-sensitive string of 1 to 32 characters.
start-time: Specifies a start time, in the hh:mm:ss format. Zeros can be omitted, unless you specify 00:00:00.
start-date: Specifies a start date, in the MM/DD/YYYY or YYYY/MM/DD format.
end-time: Specifies an end time, in the hh:mm:ss format. Zeros can be omitted, unless you specify 00:00:00.
end-date: Specifies an end date, in the MM/DD/YYYY or YYYY/MM/DD format.
add-time: Specifies a time to be added to the standard time of the device, in the hh:mm:ss format. Zeros can be omitted, unless you specify 00:00:00.
Usage guidelines
The interval between start-time start-date and end-time end-date must be longer than one day and shorter than one year. If the current system time is in the specified daylight saving days, the add-time value automatically adds to the system time.
To verify the setting, use the display clock command.
The timestamps in system messages are adjusted in reference to the time zone and daylight saving schedule.
Examples
# Set the system time ahead one hour for the period between 06:00:00 on 08/01/2013 and 06:00:00 on 09/01/2013.
<Sysname> system-view
[Sysname] clock summer-time abc1 one-off 6 08/01/2013 6 09/01/2013 1
· clock datetime
· clock summer-time repeating
· clock timezone
· display clock
clock summer-time repeating
Use clock summer-time repeating to set a recurring daylight saving schedule.
Use undo clock summer-time to cancel the configuration of the daylight saving time.
Syntax
clock summer-time zone-name repeating start-time start-date end-time end-date add-time
undo clock summer-time
Default
Daylight saving time is disabled and UTC time zone applies.
Views
System view
Default command level
3: Manage level
Parameters
zone-name: Specifies a daylight saving time schedule by a zone name, a case-sensitive string of 1 to 32 characters.
start-time: Specifies a start time, in the hh:mm:ss format. Zeros can be omitted, unless you specify 00:00:00.
start-date: Specifies a start date, which can be set in the following ways:
· Enter the year, month and date at one time, in the MM/DD/YYYY or YYYY/MM/DD format.
· Enter the year, month and date one by one, separated by spaces. The year ranges from 2000 to 2035; the month can be January, February, March, April, May, June, July, August, September, October, November or December; the start week can be the first, second, third, fourth, fifth or last week of the month; the start date is Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday.
end-time: Specifies an end time, in the hh:mm:ss format. Zeros can be omitted, unless you specify 00:00:00.
end-date: Specifies an end date, which can be set in the following ways:
· Enter the year, month and date at one time, in the MM/DD/YYYY or YYYY/MM/DD format.
· Enter the year, month and date one by one, separated by spaces. The year ranges from 2000 to 2035; the month can be January, February, March, April, May, June, July, August, September, October, November or December; the end week can be the first, second, third, fourth, fifth or last week of the month; the end date is Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday.
add-time: Specifies a time to be added to the standard time of the device, in the hh:mm:ss format. Zeros can be omitted, unless you specify 00:00:00.
Usage guidelines
The interval between start-time start-date and end-time end-date must be longer than one day and shorter than one year. If the current system time is in the specified daylight saving days, the add-time value automatically adds to the system time.
To verify the setting, use the display clock command.
The timestamps in system messages are adjusted in reference to the time zone and daylight saving schedule.
Examples
# Set the system time ahead one hour every year after 2013 (inclusive) for the period from August 1 at 06:00:00 to September 1 at 06:00:00.
<Sysname> system-view
[Sysname] clock summer-time abc2 repeating 06:00:00 08/01/2013 06:00:00 09/01/2013 01:00:00
· clock datetime
· clock summer-time one-off
· clock timezone
· display clock
clock timezone
Use clock timezone to set the local time zone.
Use undo clock timezone to restore the local time zone to the default UTC time zone.
Syntax
clock timezone zone-name { add | minus } zone-offset
undo clock timezone
Default
The local time zone is UTC zone.
Views
System view
Default command level
3: Manage level
Parameters
zone-name: Specifies a time zone by its name, a case-sensitive string of 1 to 32 characters.
add: Adds a specified offset to UTC.
minus: Subtracts a specified offset to UTC.
zone-offset: Specifies an offset to the UTC, in the hh:mm:ss format. Zeros can be omitted, unless you specify 00:00:00.
Usage guidelines
To verify the setting, use the display clock command.
The timestamps in system messages are adjusted in reference to the time zone and daylight saving schedule.
Examples
# Set the local time zone to add five hours to UTC time.
<Sysname> system-view
[Sysname] clock timezone z5 add 5
· clock datetime
· clock summer-time one-off
· clock summer-time repeating
· display clock
copyright-info enable
Use copyright-info enable to enable displaying the copyright statement.
Use undo copyright-info enable to disable displaying the copyright statement.
Syntax
copyright-info enable
undo copyright-info enable
Default
This feature is enabled.
Views
System view
Default command level
3: Manage level
Examples
# Enable displaying the copyright statement.
<Sysname> system-view
[Sysname] copyright-info enable
· When a Telnet user logs in, the following statement appears:
**************************************************************************
* Copyright (c) 2004-2013 Hangzhou H3C Tech. Co., Ltd. All rights reserved.*
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
****************************************************************************
<Sysname>
· When an OAP user quits user view, the following message appears:
**************************************************************************
* Copyright (c) 2004-2013 Hangzhou H3C Tech. Co., Ltd. All rights reserved.*
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
****************************************************************************
User interface aux0 is available.
Please press ENTER.
# Disable displaying the copyright statement.
<Sysname> system-view
[Sysname] undo copyright-info enable
· When a Telnet user logs in, the user view prompt appears:
<Sysname>
· When an OAP user quits user view, the following message appears:
User interface aux0 is available.
Please press ENTER.
display alarm
Use display alarm to display alarm information.
Syntax
display alarm [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
2: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display the alarm information of the device.
<Sysname> display alarm
Slot Level Info
6 ERROR Fan 2 is absent.
6 ERROR Power 2 is absent.
3 WARNING The temperature of sensor 3 exceeds the lower limit.
Field |
Description |
Slot |
Device ID. |
Level |
Alarm severity level: · ERROR · WARNING · NOTICE · INFO |
display clock
Use display clock to display the system time and date.
Syntax
display clock [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
The current system time and date are decided by the clock datetime, clock summer-time one-off, or clock summer-time repeating, and clock timezone commands. For more information about how the system time and date are decided, see Fundamentals Configuration Guide.
Examples
# Display the system time and date.
<Sysname> display clock
09:41:23 UTC Thu 12/15/2013
· clock datetime
· clock summer-time one-off
· clock summer-time repeating
· clock timezone
display copyright
Use display copyright to display the software and hardware copyright statements.
Syntax
display copyright [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
With this command, you can view the software and hardware copyright statements, and third-party software license agreements.
Examples
# Display the software and hardware copyright statements. (Output not shown.)
<Sysname> display copyright
display cpu-usage
Use display cpu-usage to display CPU usage statistics.
Syntax
display cpu-usage [ slot slot-number [ cpu cpu-number ] ] [ | { begin | exclude | include } regular-expression ]
display cpu-usage entry-number [ offset ] [ verbose ] [ slot slot-number [ cpu cpu-number ] ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
entry-number: Number of entries to be displayed, in the range of 1 to 60.
offset: Offset between the serial number of the first CPU usage rate record to be displayed and that of the last CPU usage rate record to be displayed. It ranges from 0 to 59.
For example, the idx of the latest statistics record is 12. If the offset is set to 3, the system will display the statistics records from the one with the idx of 9, where idx represents the serial number of the period for the statistics, and its value ranges from 0 to 60 cyclically. The system collects CPU usage rates periodically, and the system records the average CPU usage rate during this period, and the idx value is added by 1 automatically.
verbose: Displays the average CPU usage statistics for each task in the specified period. If this keyword is not provided, this command displays the brief information of the CPU usage statistics.
slot slot-number: Displays the CPU usage statistics for the device. The slot-number argument is always 1.
cpu cpu-number: Displays the usage statistics for the specified CPU. The cpu-number argument represents the CPU ID, in the range of 0 to 3. If the cpu-number argument is not provided, this command displays the usage statistics for all CPUs.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
The system regularly (typically at 60-second intervals) collects CPU usage statistics and saves the statistical results in the history record area. The maximum number of records that can be saved depends on your device model.
The display cpu-usage entry-number command displays entry-number latest records, starting from the latest record. The display cpu-usage entry-number offset command displays number latest records, starting from the last (offset+1)th record.
Examples
# Display the current CPU usage statistics.
<Sysname> display cpu-usage
Slot 1 CPU usage:
6% in last 5 seconds
10% in last 1 minute
5% in last 5 minutes
# Display the last fifth and sixth record entries in CPU usage statistics.
<Sysname> display cpu-usage 2 4
===== CPU usage info (no: 0 idx: 58) =====
CPU Usage Stat. Cycle: 60 (Second)
CPU Usage : 3%
CPU Usage Stat. Time : 2013-07-10 10:56:55
CPU Usage Stat. Tick : 0x1d9d(CPU Tick High) 0x3a659a70(CPU Tick Low)
Actual Stat. Cycle : 0x0(CPU Tick High) 0x95030517(CPU Tick Low)
===== CPU usage info (no: 1 idx: 57) =====
CPU Usage Stat. Cycle: 60 (Second)
CPU Usage : 3%
CPU Usage Stat. Time : 2013-07-10 10:55:55
CPU Usage Stat. Tick : 0x1d9c(CPU Tick High) 0xa50e5351(CPU Tick Low)
Actual Stat. Cycle : 0x0(CPU Tick High) 0x950906af(CPU Tick Low)
Table 2 Command output
Field |
Description |
1% in last 5 seconds |
After a boot, the system calculates and records the average CPU usage rate every five seconds. This field displays the average CPU usage rate in the last five seconds. |
1% in last 1 minute |
After a boot, the system calculates and records the average CPU usage rate every one minute. This field displays the average CPU usage rate in the last minute. |
1% in last 5 minutes |
After a boot, the system calculates and records the average CPU usage rate every five minutes. This field displays the average CPU usage rate in the last five minutes. |
Slot 1 CPU usage |
CPU usage rates of the device. |
CPU usage info (no: idx:) |
CPU usage rate records (no: The (no+1)th record is displayed. no numbers from 0, a smaller number equals a newer record. idx: index of the current record in the history record table). If only the information of the current record is displayed, no and idx are not displayed. |
CPU Usage Stat. Cycle |
CPU usage rate measurement interval, in seconds. For example, if the value is 41, it indicates that the average CPU usage rate during the last 41 seconds is calculated. The value range of this field is 1 to 60. |
CPU Usage |
Average CPU usage rate in a measurement interval, in percentage. |
CPU Usage Stat. Time |
CPU usage rate statistics time in seconds, that is, the system time when the command is executed. |
CPU Usage Stat. Tick |
System runtime in ticks, represented by a 64-bit hexadecimal. CPU Tick High represents the most significant 32 bits and the CPU Tick Low the least significant 32 bits. |
Actual Stat. Cycle |
Actual CPU usage rate measurement interval in ticks, represented by a 64-bit hexadecimal. CPU Tick High represents the most significant 32 bits and the CPU Tick Low the least significant 32 bits. Owing to the precision of less than one second, the actual measurement periods of different CPU usage rate records might differ slightly. |
display cpu-usage history
Use display cpu-usage history to display historical CPU usage statistics in a chart.
Syntax
display cpu-usage history [ task task-id ] [ slot slot-number [ cpu cpu-number ] ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
task task-id: Displays the historical CPU usage statistics for the specified task, where the task-id argument represents the task number. If the task-id argument is not provided, this command displays the historical CPU usage statistics for the entire system (the CPU usage rates of the entire system is the sum of CPU usage rates of all tasks).
slot slot-number: Displays the historical CPU usage statistics for the device. The slot-number argument is always 1.
cpu cpu-number: Displays the historical CPU usage statistics for the specified CPU. The cpu-number argument represents the CPU ID, in the range of 0 to 3. If the cpu-number argument is not provided, this command displays the historical CPU usage statistics for the main CPU.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
If no argument is provided, this command displays all historical CPU usage statistics for the device.
The system regularly collects CPU usage statistics and saves the statistics in the history record area. The display cpu-usage history command displays the CPU usage statistics for the last 60 minutes in axes, where:
· 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, whichever is closer. For example, if the CPU usage step is 5%, the statistic 53% is rounded up to 55%, and the statistic 52% is rounded down to 50%.
· The horizontal axis represents the time.
· Consecutive pound signs (#) indicate the CPU usage at a specific time. The value on the vertical axis for the topmost # sign at a specific time represents the CPU usage at that time.
Examples
# Display historical CPU usage statistics.
<Sysname> display cpu-usage history
100%|
95%|
90%|
85%|
80%|
75%|
70%|
65%|
60%|
55%|
50%|
45%|
40%|
35%|
30%|
25%|
20%|
15%| #
10%| ### #
5%| ########
------------------------------------------------------------
10 20 30 40 50 60 (minutes)
cpu-usage last 60 minutes(SYSTEM)
The output shows the historical CPU usage statistics (with the task name SYSTEM) in the last 60 minutes:
· 5%: 12 minutes ago
· 10%: 13 minutes ago
· 15%: 14 minutes ago
· 10%: 15 minutes ago
· 5%: 16 and 17 minutes ago
· 10%: 18 minutes ago
· 5%: 19 minutes ago
· 2% or lower than 2%: other time
# Display the historical CPU usage statistics for task 6.
<Sysname> display cpu-usage history task 6
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 last 60 minutes(T03M)
The output shows the historical CPU usage statistics of task 6 (with the task name T03M) in the last 60 minutes:
· 5%: 20 minutes ago
· 2% or lower than 2%: other time
display device
Use display device to display device information.
Syntax
display device [ verbose ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
2: System level
Parameters
verbose: Displays detailed information.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display device information.
<Sysname> display device
Slot 1
SubSNo PortNum PCBVer FPGAVer CPLDVer BootRomVer AddrLM Type State
0 33 Ver.A NULL 003 003 1.02 IVL MAIN Normal
Table 3 Command output
Field |
Description |
Slot 1 |
Information about the device. |
SubSNo |
Number of the slot in which the device resides. |
PortNum |
Maximum number of ports that the device supports. |
PCBVer |
PCB version of the device. |
FPGAVer |
FPGA version of the device. |
CPLDVer |
CPLD version of the device. |
BootRomVer |
Boot ROM version of the device. |
AddrLM |
Address learning mode: · Independent VLAN learning (IVL). · Shared VLAN learning (SVL). |
Type |
Type of the device. |
State |
State of the device: · Normal—The device is operating properly. · Absent—The device is not present. · Fault—The device is faulty. |
display device manuinfo
Use display device manuinfo to display the electronic label data.
Syntax
display device manuinfo slot slot-number [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
3: Manage level
Parameters
slot slot-number: Displays the electronic label data for the device. The slot-number argument is always 1.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
An electronic label is a profile of a device and contains the permanent configuration including the device name, serial number, MAC address, and vendor name. The data is written to the storage component during debugging or testing.
This command displays part of the electronic label data.
Examples
# Display electrical label information.
<Sysname> display device manuinfo
Slot 1:
DEVICE_NAME : WX5540E_LSW
DEVICE_SERIAL_NUMBER : DPPMWWB123456
MAC_ADDRESS : 00E0-FC00-5800
MANUFACTURING_DATE : 2013-05-08
VENDOR_NAME : H3C
display diagnostic-information
Use display diagnostic-information to display or save running status data for multiple feature modules.
Syntax
display diagnostic-information [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
For diagnosis or troubleshooting, you can use separate display commands to collect running status data module by module, or use the display diagnostic-information command to bulk collect running data for multiple modules.
Examples
# Save running status data for multiple feature modules.
<Sysname> display diagnostic-information
Save or display diagnostic information (Y=save, N=display)?[Y/N]y
Please input the file name(*.diag)[flash:/default.diag]:aa.diag
Diagnostic information is outputting to flash:/aa.diag.
Please wait...
Save succeeded.
To view the content of file aa.diag, execute the more.aa.diag command in user view, in combination of the Page Up and Page Down keys.
# Display running status data for multiple feature modules.
<Sysname> display diagnostic-information
Save or display diagnostic information (Y=save, N=display)? [Y/N]:n
=================================================
===============display clock===============
=================================================
08:54:16 UTC Fri 11/15/2013
===================================================
===============display version===============
===================================================
…
display job
Use display job to display information about scheduled jobs configured by using the job command.
Syntax
display job [ job-name ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
job-name: Displays information about the specified job. The job-name argument represents a job name, which is a string of 1 to 32 characters.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
If no job is specified, this command displays information about all scheduled jobs.
Examples
# Display detailed information about the scheduled job saveconfig.
<Sysname> display job saveconfig
Job name: saveconfig
Specified view: monitor
Time 1: Execute command save 1.cfg after 40 minutes
The output shows that the current configuration will be automatically saved to the configuration file 1.cfg in 40 minutes.
Table 4 Command output
Field |
Description |
Job name |
Name of the scheduled job. |
Specified view |
View containing the commands in the job. |
Time timeID |
Execution time of each command in the job. |
Execute command |
Command string. |
· job
· time
· view
display memory
Use display memory to display memory usage statistics.
Syntax
display memory [ slot slot-number [ cpu cpu-number ] ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
slot slot-number: Displays the memory usage statistics for the device. The slot-number argument is always 1.
cpu cpu-number: Displays the memory usage statistics for a CPU. The cpu-number represents the ID of the CPU.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
If no CPU is specified, this command displays the memory usage statistics for the main CPU.
Examples
# Display memory usage statistics.
<Sysname> display memory
System Total Memory(bytes): 785239520
Total Used Memory(bytes): 129757852
Used Rate: 16%
System Total Memory(bytes): 337495520
Total Used Memory(bytes): 108441564
Used Rate: 32%
Table 5 Command output
Field |
Description |
System Total Memory(bytes) |
Total size of the system memory (in bytes) |
Total Used Memory(bytes) |
Size of the memory used (in bytes) |
Used Rate |
Percentage of the memory used to the total memory. |
display reboot-type
Use display reboot-type to display the mode of the last reboot.
Syntax
display reboot-type [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
2: System level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display the mode of the last reboot.
<Sysname> display reboot-type
The rebooting type this time is: Cold
The output shows that the last reboot mode is Cold boot (cold boot will restart a device by powering it on). (The display of Warm represents a warm boot, which means to restart a device by using the commands like reboot).
display schedule job
Use display schedule job to display the job configured by using the schedule job command.
Syntax
display schedule job [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display the configuration of the job configured by using the schedule job command.
<Sysname> display schedule job
Specified command: execute 1.bat
Specified view: system view
Executed time: at 12:00 10/31/2013 (in 0 hours and 16 minutes)
If you change the system time within 16 minutes after you execute the schedule job command, the scheduled task becomes invalid. Then, if you execute the display schedule job command again, no information is displayed.
Table 6 Command output
Field |
Description |
Specified command |
Command to be executed. |
Specified view |
View for the command to be executed. |
Executed time |
Execution time of the command and the difference between the current system time and scheduled time. |
schedule job
display schedule reboot
Use display schedule reboot to display the reboot schedule.
Syntax
display schedule reboot [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
3: Manage level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display the reboot schedule.
<Sysname> display schedule reboot
System will reboot at 16:00:00 03/10/2013 (in 2 hours and 5 minutes).
· schedule reboot at
· schedule reboot delay
display system-failure
Use display system-failure to display the exception handling method.
Syntax
display system-failure [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
3: Manage level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display the exception handling method.
<Sysname> display system-failure
System failure handling method: reboot
system-failure
display transceiver
Use display transceiver to display the key parameters of transceiver modules.
Syntax
display transceiver interface [ interface-type interface-number ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
2: System level
Parameters
interface [ interface-type interface-number ]: Displays the key parameters of the transceiver module in an interface. The interface-type interface-number argument specifies an interface by its type and number. If no interface is specified, this command displays the key parameters of the transceiver modules in all interfaces.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display the key parameters of the transceiver module in interface GigabitEthernet 1/0/22.
<Sysname> display transceiver interface gigabitethernet 1/0/22
GigabitEthernet1/0/22 transceiver information:
Transceiver Type : 1000_BASE_SX_SFP
Connector Type : LC
Wavelength(nm) : 850
Transfer Distance(m) : 550(50um),270(62.5um)
Digital Diagnostic Monitoring : YES
Vendor Name : H3C
Ordering Name : SFP-GE-SX-MM850
Table 7 Command output
Field |
Description |
transceiver information |
Transceiver module information. |
Transceiver Type |
Transceiver module type. |
Connector Type |
Connector type options: · SC—Fiber connector developed by NTT. · LC—1.25 mm/RJ-45 fiber connector developed by Lucent. · RJ-45. · CX 4. |
Wavelength(nm) |
· Fiber transceiver: central wavelength (in nm) of the transmit laser. If the transceiver supports multiple wavelengths, every two wavelength values are separated by a comma. · Copper transceiver: displayed as N/A. |
Transfer Distance(xx) |
Transfer distance, with xx representing km for single-mode transceiver modules and m for other transceiver modules. If the transceiver module supports multiple transfer media, every two transfer distance values are separated by a comma. The corresponding transfer medium is included in the bracket following the transfer distance value. The following are the supported transfer media: · 9 um—9/125 um single-mode fiber. · 50 um—50/125 um multi-mode fiber. · 62.5 um—62.5/125 um multi-mode fiber. · TP—Twisted pair. · CX4—CX4 cable. |
Digital Diagnostic Monitoring |
Support for the digital diagnosis function: · YES—Supported. · NO—Not supported. |
Vendor Name |
Vendor name. |
Ordering Name |
Product code. |
display transceiver alarm
Use display transceiver alarm to display alarms present on transceiver modules.
Syntax
display transceiver alarm interface [ interface-type interface-number ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
2: System level
Parameters
interface [ interface-type interface-number ]: Displays the alarms that are present on the transceiver module in an interface. The interface-type interface-number argument specifies an interface by its type and number. If no interface is specified, this command displays alarm information for the transceiver modules in all interfaces.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
If no error occurs, None is displayed. Table 8 describes the transceiver module alarms that might occur. Support for the transceiver modules depends on your device model.
Table 8 Common transceiver module alarms
Field |
Remarks |
SFP/SFP+ |
|
RX loss of signal |
Incoming (RX) signal is lost. |
RX power high |
Incoming (RX) power is high. |
RX power low |
Incoming (RX) power is low. |
TX fault |
Transmit (TX) fault. |
TX bias high |
TX bias current is high. |
TX bias low |
TX bias current is low. |
TX power high |
TX power is high. |
TX power low |
TX power is low. |
Temp high |
Temperature is high. |
Temp low |
Temperature is low. |
Voltage high |
Voltage is high. |
Voltage low |
Voltage is low. |
Transceiver info I/O error |
Transceiver information read and write error. |
Transceiver info checksum error |
Transceiver information checksum error. |
Transceiver type and port configuration mismatch |
Transceiver type does not match port configuration. |
Transceiver type not supported by port hardware |
The port does not support the transceiver type. |
Examples
# Display the alarms present on the transceiver module in interface GigabitEthernet 1/0/22.
<Sysname> display transceiver alarm interface gigabitethernet 1/0/22
GigabitEthernet1/0/22 transceiver current alarm information:
RX loss of signal
RX power low
Table 9 Command output
Field |
Description |
transceiver current alarm information |
Alarms present on the transceiver module. |
RX loss of signal |
Incoming (RX) signal is lost. |
RX power low |
Incoming (RX) power level is low. |
display transceiver diagnosis
Use display transceiver diagnosis to display the measured values of the digital diagnosis parameters for transceiver modules.
Syntax
display transceiver diagnosis interface [ interface-type interface-number ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
2: System level
Parameters
interface [ interface-type interface-number ]: Displays the measured values of the digital diagnosis parameters for the transceiver module in an interface. The interface-type interface-number argument specifies an interface by its type and number. If no interface is specified, this command displays the measured values of the digital diagnosis parameters for the transceiver modules in all interfaces.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
The display transceiver diagnosis command cannot display information for some transceiver modules.
Examples
# Display the measured values of the digital diagnosis parameters for the transceiver module in interface GigabitEthernet 1/0/22.
<Sysname> display transceiver diagnosis interface gigabitethernet 1/0/22
GigabitEthernet1/0/22 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
Table 10 Command output
Field |
Description |
transceiver diagnostic information |
Digital diagnosis information of the transceiver in the interface. |
Current diagnostic parameters |
Current diagnostic parameters. |
Temp.(°C) |
Digital diagnosis parameter-temperature, in °C, with the precision to 1°C. |
Voltage(V) |
Digital diagnosis parameter-voltage, in V, with the precision to 0.01 V. |
Bias(mA) |
Digital diagnosis parameter-bias current, in mA, with the precision to 0.01 mA. |
RX power(dBM) |
Digital diagnosis parameter-RX power, in dBM, with the precision to 0.01 dBM. |
TX power(dBM) |
Digital diagnosis parameter-TX power, in dBM, with the precision to 0.01 dBM. |
display transceiver manuinfo
Use display transceiver manuinfo to display the electronic label data for transceiver modules.
Syntax
display transceiver manuinfo interface [ interface-type interface-number ] [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
2: System level
Parameters
interface [ interface-type interface-number ]: Displays the electronic label data for the transceiver module in an interface. The interface-type interface-number argument specifies represents interface type and interface number. If no interface is specified, this command displays the electronic label data for the transceiver modules in all interfaces.
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
The display transceiver manuinfo command cannot display information for some transceiver modules.
Examples
# Display the electronic label data for the transceiver module in interface GigabitEthernet 1/0/22.
<Sysname> display transceiver manuinfo interface gigabitethernet 1/0/22
GigabitEthernet1/0/22 transceiver manufacture information:
Manu. Serial Number : 213410A0000054000251
Manufacturing Date : 2013-03-01
Vendor Name : H3C
Table 11 Command output
Field |
Description |
Manu. Serial Number |
Serial number generated during debugging and testing of the transceiver module. |
Manufacturing Date |
Debugging and testing date. The date takes the value of the system clock of the computer that performs debugging and testing. |
Vendor Name |
Vendor name of the transceiver module. |
display version
Use display version to display system version information, including the system software version, chassis model, and device data.
Syntax
display version [ | { begin | exclude | include } regular-expression ]
Any view
Default command level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display system version information.
<Sysname> display version
H3C Comware Platform Software
Comware Software, Version 5.20, Alpha 2607P04
Copyright (c) 2004-2013 Hangzhou H3C Tech. Co., Ltd. All rights reserved.
H3C WX5540E-LSW uptime is 1 week, 1 day, 20 hours, 57 minutes
H3C WX5540E-LSW with 2 Processors
1024M bytes DDR3
16M bytes Nor Flash Memory
Config Register points to Nor Flash
Hardware Version is Ver.A
CPLDA Version is 003, CPLDB Version is 003
BootRom Version is 1.02
[SubSlot 0] 12GE+12SFP+4SFP Plus Hardware Version is Ver.A
display version-update-record
Use display version-update-record to display the system software update history of the device.
Syntax
display version-update-record [ | { begin | exclude | include } regular-expression ]
Views
Any view
Default command level
3: Manage level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular expressions, see Fundamentals Configuration Guide.
begin: Displays the first line that matches the specified regular expression and all lines that follow.
exclude: Displays all lines that do not match the specified regular expression.
include: Displays all lines that match the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
The system records the system software version at each reboot. If the software is updated while the device is running, the system records the update time and new software version. The number of update records that can be stored depends on your device model.
Examples
# Display the system software update history.
<Sysname> display version-update-record
No. Update time version
1 2013-04-28 14:39:11 5.20 Release 0000
Related commands
reset version-update-record
header
Use header to create a banner.
Use undo header to clear a banner.
Syntax
header { incoming | legal | login | motd | shell } text
undo header { incoming | legal | login | motd | shell }
Views
System view
Default command level
2: System level
Parameters
incoming: Configures the banner displayed before a Modem dial-in user accesses user view.
legal: Configures the banner displayed before a user inputs the username and password to access the CLI.
login: Configures the banner displayed before password or scheme authentication is performed for a login user.
motd: Configures the greeting banner displayed before the legal banner appears.
shell: Configures the banner displayed before a non-Modem dial-in user accesses user view.
text: Banner message, which can be input in two formats. For more information, see Fundamentals Configuration Guide.
Usage guidelines
Banners are greeting or alert messages that the system displays during the login process of a user.
Examples
# Configure banners.
<Sysname> system-view
[Sysname] header incoming %
Please input banner content, and quit with the character '%'.
Welcome to incoming(header incoming)%
[Sysname] header legal %
Please input banner content, and quit with the character '%'.
Welcome to incoming(header incoming)%
[Sysname] header legal %
Please input banner content, and quit with the character '%'.
Welcome to legal (header legal)%
[Sysname] header login %
Please input banner content, and quit with the character '%'.
Welcome to login(header login)%
[Sysname] header motd %
Please input banner content, and quit with the character '%'.
Welcome to motd(header motd)%
[Sysname] header shell %
Please input banner content, and quit with the character '%'.
Welcome to shell(header shell)%
In this example, the percentage sign (%) is the starting and ending characters of text. Entering % after the displayed test quits the header command. As the starting and ending characters, % is not part of the banners.
# Verify the configuration by using Telnet. (The login authentication is not configured.)
******************************************************************************
* Copyright (c) 2004-2013 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 shell(header shell)
<Sysname>
# Verify the configuration by using Telnet. (Password authentication is configured.)
******************************************************************************
* Copyright (c) 2004-2013 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)
<Sysname>
job
Use job to create a job or enter job view.
Use undo job to delete a scheduled job.
Syntax
job job-name
undo job job-name
Default
No job is created.
Views
System view
Default command level
3: Manage level
Parameters
job-name: Specifies the name for a job, a string of 1 to 32 characters.
Usage guidelines
You can add commands in job view to execute at certain times.
You can use the job command to create multiple jobs.
Examples
# Create the job saveconfiguration or enter its view.
<Sysname> system-view
[Sysname] job saveconfiguration
[Sysname-job-saveconfiguration]
· time
· view
reboot
Use reboot to reboot the device.
Syntax
reboot
Views
User view
Default command level
3: Manage level
Usage guidelines
|
CAUTION: · Device reboot can interrupt network services. · If the main system software image file has been corrupted or does not exist, the device cannot reboot. You must re-specify a main system software image file, or power off the device and then power it on so the system can reboot with the backup system software image file. |
For data security, if you are performing file operations at the reboot time, the system does not reboot.
Examples
# Reboot the device.
<Sysname> reboot
…
reset unused porttag
Use reset unused porttag to clear unused 16-bit interface indexes of the device.
Syntax
reset unused porttag
Views
User view
Default command level
1: Monitor level
Usage guidelines
A confirmation is required when you execute this command. The command will not run if you enter N to cancel the operation or fail to make a confirmation within 30 seconds.
Examples
# Clear unused 16-bit interface indexes.
<Sysname> reset unused porttag
Current operation will delete all unused port tag(s). Continue? [Y/N]:y
<Sysname>
reset version-update-record
Use reset version-update-record to clear the system software update history of the device.
Syntax
reset version-update-record
Views
System view
Default command level
3: Manage level
Usage guidelines
Examples
# Clear the system software update history of the device.
<Sysname> system-view
[Sysname] reset version-update-record
display version-update-record
schedule job
Use schedule job to schedule a job in the non-modular approach.
Use undo schedule job to remove the scheduled job.
Syntax
schedule job { at time1 [ date ] | delay time2 } view view-name command
Views
User view
Default command level
3: Manage level
Parameters
at time1 [ date ]: Specifies the time and/or date to execute a command.
· time1: Sets time to execute the command, in the hh:mm format. The hh value ranges from 0 to 23, and the mm value ranges from 0 to 59.
· date: Sets the date to execute the command, in the MM/DD/YYYY or YYYY/MM/DD format. The YYYY value ranges from 2000 to 2035, the MM value ranges from 1 to 12, and the DD value ranges from 1 to 31.
delay time2: Runs the job after a delay. The time2 argument specifies the delay in one of the following formats:
· hh:mm format—The hh value ranges from 0 to 720, and the mm value ranges from 0 to 59. When the hh value is 720, the mm value cannot be more than 0.
· mm format—It ranges from 0 to 432000 minutes, with 0 indicating that the command is executed immediately.
view view: Specifies the view in which the command is executed. The view argument represents the view name, and it can take only one of the following keywords:
· shell—Represents user view.
· system—Represents system view.
command: Command to execute.
Usage guidelines
You can schedule a job to automatically run a command or a set of commands without administrative interference. The commands in a job are polled every minute. When the scheduled time for a command is reached, the job automatically executes the command. If a confirmation is required while the command is running, the system automatically enters Y or Yes. If characters are required, the system automatically enters a default character string or an empty character string when no default character string is available.
Follow these guidelines when you schedule a job in the non-modular approach:
· You can schedule only one job and run only one command in this approach. If you perform the schedule job command multiple times, the last configuration takes effect.
· To have the command successfully executed, check that the specified view and command are valid. The system does not verify their validity.
· If you specify both the time1 and date arguments, the execution time or date must be later than the current system time or date.
· If you specify the time1 argument, but not the date argument:
? When time1 is earlier than the current system time, the command runs at time1 the next day.
? When time1 is later than the current system time, the command runs at time1 of the current day.
· The interval between the scheduled time and the current system time cannot exceed 720 hours, or 30 days.
· Changing any clock setting can cancel the job set by using the schedule job command.
· After job execution, the configuration interface, view, and user status that you have before job execution restore even if the job has run a command that changes the user interface (for example, telnet, ftp, and ssh2), the view (for example, system-view and quit), or the user status (for example, super).
Examples
# Schedule a job to execute the batch file 1.bat in system view in 60 minutes (assuming that the current time is 11:43).
<Sysname> schedule job delay 60 view system execute 1.bat
Info: Command execute 1.bat in system view will be executed at 12:43 10/31/2013 (in 1 hours and 0 minutes).
# Schedule a job to execute the batch file 1.bat in system view at 12:00 (assuming that the current time is 11:43).
<Sysname> schedule job at 12:00 view system execute 1.bat
Info: Command execute 1.bat in system view will be executed at 12:00 10/31/2013 (in 0 hours and 16 minutes).
schedule reboot at
Use schedule reboot at to schedule a device reboot to occur at a specific time and date.
Use undo schedule reboot to disable the scheduled reboot function.
Syntax
schedule reboot at hh:mm [ date ]
undo schedule reboot
Default
The scheduled reboot function is disabled.
Views
User view
Default command level
3: Manage level
Parameters
hh:mm: Specifies a reboot time, in the hh:mm format. The hh value ranges from 0 to 23, and the mm value ranges from 0 to 59.
date: Specifies a reboot date, in the MM/DD/YYYY or YYYY/MM/DD format. The YYYY value ranges from 2000 to 2035, the MM value ranges from 1 to 12, and the DD value ranges from 1 to 31.
Usage guidelines
|
CAUTION: · Device reboot can interrupt network services. · Changing any clock setting can cancel the reboot schedule. |
The interval between the reboot date and the current date cannot exceed 30 x 24 hours, or 30 days.
When no reboot date is specified:
· If the reboot time is later than the current time, a reboot occurs at the reboot time of the current day.
· If the reboot time is earlier than the current time, a reboot occurs at the reboot time the next day.
The device supports only one device reboot schedule. If you configure the schedule reboot at command multiple times, the last configuration takes effect. The schedule reboot at command and the schedule reboot delay command overwrite each other, and whichever is configured last takes effect.
The alert "REBOOT IN ONE MINUTE" appears one minute before the reboot time.
For data security, if you are performing file operations at the reboot time, the system does not reboot.
Examples
# Configure the device to reboot at 12:00 AM. This example assumes that the current time is 11:43.
<Sysname> schedule reboot at 12:00
Reboot system at 12:00 06/06/2013(in 0 hour(s) and 16 minute(s))
confirm? [Y/N]:
Enter y at the prompt. If you have used the terminal logging command to enable the log display function (enabled by default) on the terminal, the system automatically displays a reboot schedule log message.
<Sysname>
%Jun 6 11:43:11:629 2013 Sysname CMD/4/REBOOT:
vty0(192.168.1.54): Set schedule reboot parameters at 11:43:11 06/06/2013, and system will reboot at 12:00 06/06/2013.
schedule reboot delay
schedule reboot delay
Use schedule reboot delay to schedule a device reboot to occur after a delay.
Use undo schedule reboot to disable the scheduled reboot function.
Syntax
schedule reboot delay { hh:mm | mm }
undo schedule reboot
Default
The scheduled reboot function is disabled.
Views
User view
Default command level
3: Manage level
Parameters
hh:mm: Specifies a delay for the device reboot, in the hh:mm format. The hh value ranges from 0 to 720, and the mm value ranges from 0 to 59. When the hh value is 720, the mm value cannot be more than 0.
mm: Specifies a delay for the device reboot in minutes, which ranges from 0 to 43200.
Usage guidelines
|
CAUTION: · Device reboot can interrupt network services. · Changing any clock setting can cancel the reboot schedule. |
The reboot delay cannot exceed 30 x 24 x 60 minutes, or 30 days.
The device supports only one device reboot schedule. If you configure the schedule reboot delay command multiple times, the last configuration takes effect. The schedule reboot at command and the schedule reboot delay command overwrite each other, and whichever is configured last takes effect.
The alert "REBOOT IN ONE MINUTE" appears one minute before the reboot time.
For data security, if you are performing file operations at the reboot time, the system does not reboot.
Examples
# Schedule a device reboot in 88 minutes. This example assumes that the current time is 11:48 on June 6, 2013.
<Sysname> schedule reboot delay 88
Reboot system at 13:16 06/06/2013(in 1 hour(s) and 28 minute(s)). confirm? [Y/N]:
Enter y at the prompt. If you have used the terminal logging command to enable the log display function (enabled by default) on the terminal, the system automatically displays a reboot schedule log message.
<Sysname>
%Jun 6 11:48:44:860 2013 Sysname CMD/4/REBOOT:
vty0(192.168.1.54): Set schedule reboot parameters at 11:48:44 06/06/2013, and system will reboot at 13:16 06/06/2013.
schedule reboot at
shutdown-interval
Use shutdown-interval to set the port status detection timer.
Use undo shutdown-interval to restore the default.
Syntax
shutdown-interval time
undo shutdown-interval
Default
The port status detection timer is 30 seconds.
Views
System view
Default command level
2: System level
Parameters
time: Specifies the port status detection timer in seconds, which ranges from 0 to 300.
Usage guidelines
Some protocols might shut down ports under specific circumstances. For example, MSTP shuts down a BPDU guard–enabled port when the port receives a BPDU. In this case, you can set the port status detection timer. If the port is still down when the detection timer expires, the protocol module automatically cancel the shutdown action and restore the port to its original physical status.
· If you change the detection timer to T1 during port detection, the interval from when you change the timer to the time when the protocol module shuts down the port is T. If T<T1, the down port will be recovered after T1-T time. If T>=T1, the down port is recovered immediately. For example, if the detection timer is set to 30 seconds and you change it to 10 seconds (T1=10) two seconds after the port is shut down (T=2), this port will be recovered 8 seconds later. If the detection timer is set to 30 seconds and you change it to 2 seconds ten seconds after the port is shut down, this port is recovered immediately.
· If the detection timer is set to 0, the protocol module never automatically recovers the port. You need to manually bring up the port by using the undo shutdown command or change the detection timer to a non-zero value.
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
Default command level
2: System level
Parameters
sysname: Name of the device, which is a string of 1 to 30 characters.
Usage guidelines
A device name identifies a device in a network and works as the user view prompt at the CLI. For example, if the device name is Sysname, the user view prompt is <Sysname>.
Examples
# Set the name of the device to S2000.
<Sysname> system-view
[Sysname] sysname S2000
[S2000]
system-failure
Use system-failure to configure the exception handling method.
Use undo system-failure to restore the default.
Syntax
system-failure { maintain | reboot }
undo system-failure
Default
The device uses the reboot method to handle exceptions.
Views
System view
Default command level
3: Manage level
Parameters
maintain: Specifies that when the system detects any software abnormality, it maintains the current situation, and does not take any measure to recover itself.
reboot: Specifies that when the system detects any software abnormality, it recovers itself through automatic reboot.
Examples
# Set the exception handling method to reboot.
<Sysname> system-view
[Sysname] system-failure reboot
time at
Use time at to add a command to run at a specific time and date in the job schedule.
Use undo time to remove a command from the job schedule.
Syntax
time time-id at time date command command
time time-id { one-off | repeating } at time [ month-date month-day | week-day week-daylist ] command command
undo time time-id
Views
Job view
Default command level
3: Manage level
Parameters
time timeid: Time setting entry, an integer that ranges from 1 to 10.
at time: Specifies an execution time, in the hh:mm format, where the hh value ranges from 0 to 23 and the mm value ranges from 0 to 59.
one-off: Specifies that the specified command is executed for once.
repeating: Specifies a recurring time schedule.
date: Specifies an execution date, in the MM/DD/YYYY or YYYY/MM/DD format. The YYYY value ranges from 2000 to 2035, the MM value ranges from 1 to 12, and the DD value ranges from 1 to 31. The specified execution date must be ahead of the current date.
month-date month-day: Specifies the date for executing the command. month-day specifies the date, and ranges from 1 to 31.
week-day week-daylist: Specifies the day or days for executing the command. The week-daylist argument specifies one day or up to seven days, which can be any combination of Sun, Mon, Tue, Wed, Thu, Fri, and Sat. For example, to have a command executed on Monday, you can enter week-day Mon; to have a command executed on Friday and Saturday, enter week-day Fri Sat. Use a space between every two days for separation.
command command: Specifies the command to be automatically executed, in the text format. The command must be executable in the view specified by the view command. Otherwise this command cannot be automatically executed. Therefore, ensure the correctness of the configuration.
Usage guidelines
The commands in a job must be in the same view.
Every job can have up to 10 commands.
The time ID (time-id) must be unique in a job. If two time and command bindings have the same time ID, the one configured last takes effect.
Changing a clock setting does not affect the schedule set by using the time at command.
Use Table 12 when you add commands in a job.
Table 12 Command schedule options
Command |
Description |
time timeid at time date command command |
Schedules a command to run at a specific time and date. The time or date must be later than the current system time or date. |
time timeid one-off at time command command |
Schedules a command to run at a specific time on the current day. If the specified time has passed, the command runs the next day. The command runs only once. |
time timeid one-off at time month-date month-day command command |
Schedules a command to run at a specific day in the current month. If the specified time or day has passed, the command runs in the next month. The command runs only once. |
time timeid one-off at time week-day week-daylist command command |
Schedules a command to run at a specific time on a specific day or days in the current week. If the specified time or day has passed, the command runs in the next week. The command runs only once. |
time timeid repeating at time command command |
Schedules a command to run at a specific time every day. |
time timeid repeating at time month-date month-day command command |
Schedules a command to run on a specific day every month. |
time timeid repeating at time week-day week-daylist command command |
Schedules a command to run at a specific time in a specific day or days every week. |
Examples
# Schedule a job to save the configuration file a.cfg at 3:00 on May 18, 2013.
<Sysname> system-view
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 at 3:00 2013/05/18 command save a.cfg
# Schedule a job to save the configuration file at 12:00 every day.
<Sysname> system-view
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 repeating at 12:00 command save a.cfg
# Schedule a job to save the configuration file at 8:00 AM on 5th in the current month, which might be executed in the second month if the time has passed.
<Sysname> system-view
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 one-off at 8:00 month-date 5 command save a.cfg
# Schedule a job to save the configuration file at 8:00 AM on 5th every month.
<Sysname> system-view
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 repeating at 8:00 month-date 5 command save a.cfg
# Schedule a job to save the configuration file at 8:00 AM on Friday and Saturday in the current week, which might be delayed to the next week if the time has passed.
<Sysname> system-view
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 one-off at 8:00 week-day fri sat command save a.cfg
# Schedule a job to save the configuration file at 8:00 every Fridays and Saturdays.
<Sysname> system-view
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 repeating at 8:00 week-day fri sat command save a.cfg
· job
· view
time delay
Use time delay to add a command to run after a delay in the job schedule.
Use undo time to remove a command from the job schedule.
Syntax
time time-id { one-off | repeating } delay time command command
undo time time-id
Views
Job view
Default command level
3: Manage level
Parameters
time timeid: Time setting entry, an integer that ranges from 1 to 10.
one-off: Specifies that the specified command is executed for once.
repeating: Specifies a recurring time schedule.
delay time: Specifies the delay time for executing the command, in the hh:mm format or mm format.
· When the time argument is in the hh:mm format, the hh value ranges from 0 to 720, and the mm value ranges from 0 to 59. When the hh value is 720, the mm value can be only 00.
· When the time argument is in the mm format, the mm value ranges from 1 to 43,200. That is, the maximum value of the delay timer is 30 days.
command command: Specifies the command to be automatically executed, in the text format. The specified command must be a complete command without interactive input.
Usage guidelines
The commands in a scheduled job must be in the same view.
Every job can have up to 10 commands.
The time ID (time-id) must be unique in a job. If two time and command bindings have the same time ID, the one configured last takes effect.
Changing a clock setting does not affect the schedule set by using the time delay command.
Use Table 13 when you add commands in a job.
Table 13 Command schedule options
Command |
Description |
time timeid one-off delay time2 command command |
Schedules a command to run after a delay time. The command runs only once. |
time timeid repeating delay time2 command command |
Schedules a command to run every the delay time. |
Examples
# Save the configuration file five minutes later.
<Sysname> system-view
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 one-off delay 5 command save a.cfg
# Save the configuration file every five minutes.
<Sysname> system-view
[Sysname] job saveconfig
[Sysname-job-saveconfig] view monitor
[Sysname-job-saveconfig] time 1 repeating delay 5 command save a.cfg
· job
· view
view
Use view to specify a view for a job.
Use undo view to remove the view of a job.
Syntax
view view-name
undo view
Default
No view is specified for a job.
Views
Job view
Default command level
3: Manage level
Parameters
view-name: Specifies a view in which commands in the job run. A view name is a string of 1 to 90 characters.
Usage guidelines
Every job can have only one view. If you specify multiple views, the one specified the last takes effect.
Enter a view name in its complete form and make sure the view name is available on the device. Most commonly used view names include monitor for user view, system for system view, GigabitEthernetx/x/x for Ethernet interface view, and Vlan-interfacex for VLAN interface view.
Examples
# Specify system view for the job creatvlan.
<Sysname> system-view
[Sysname] job creatvlan
[Sysname-job-creatvlan] view system
Related commands
· job
· time