Table of Contents

Related Documents

07-Device Management Commands

Title	Size	Download
07-Device Management Commands	218.29 KB

Device management commands

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/2005.

<Sysname> clock datetime 14:10:20 8/1/2005

# Set the current system time to 00:06:00 01/01/2007.

<Sysname> clock datetime 0:6 2007/1/1

Related commands

· 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/2011 and 06:00:00 on 09/01/2011.

<Sysname> system-view

[Sysname] clock summer-time abc1 one-off 6 08/01/2011 6 09/01/2011 1

Related commands

· 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

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 2011 (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/2011 06:00:00 09/01/2011 01:00:00

Related commands

· 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

Related commands

· clock datetime

· clock summer-time one-off

· clock summer-time repeating

· display clock

configure-user count

Use configure-user count to configure the maximum number of users allowed to enter system view at the same time.

Use undo configure-user count to restore the default.

Syntax

configure-user count number

undo configure-user count

Views

System view

Default command level

2: System level

Parameters

number: Specifies the maximum number of concurrent users, in the range of 1 to 6.

Usage guidelines

Two users are allowed to enter system view by default.

When multiple users enter system view to configure certain attribute, only the last configuration applies.

When the number of users has already reached the limit, other users can not enter system view.

Examples

# Configure to allow up to four users to enter system view concurrently.

<Sysname> system-view

[Sysname] configure-user count 4

Related commands

display configure-user

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

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:

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

* Without the owner's prior written consent, *

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

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

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

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

* Without the owner's prior written consent, *

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

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

User interface con0 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:

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

User interface con0 is available.

Please press ENTER.

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.

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/2005

Related commands

· clock datetime

· clock summer-time one-off

· clock summer-time repeating

· clock timezone

display configure-user

Use display configure-user to display the users that have logged in to the device but are not in user view.

Syntax

display configure-user [ | { 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.

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 users that have logged into the system but are not in user view.

<Sysname> display configure-user

The information of current configuration user(s):

Idx UI Delay Type Userlevel

+ 178 VTY 0 01:10:16 TEL 3

+ 179 VTY 1 00:00:00 TEL 3

Following are more details.

VTY 0 :

Location: 192.168.1.59

VTY 1 :

Location: 192.168.1.54

+ : User-interface is active.

F : User-interface is active and work in async mode.

Table 1 Command output

Field	Description
The information of current configuration user(s)	Information of the users that have logged in and are not in user view.
Idx	Absolute ID of the user interface.
UI	Type and relative ID of the user interface that the user used for login.
Delay	Delay between the last CLI input and the execution of the display configure-user command, in the format hh:mm:ss.
Type	User type, Telnet or SSH.
Userlevel	User level, level 0 (visit level), level 1 (monitor level), level 2 (system level), or level 3 (manage level).
Following are more details.	Detailed information about the login user.
Location	IP address of the login user.
+ : User-interface is active.	User interface that is being used.
F : User-interface is active and work in async mode.	User interface that is being used and operating in asynchronous mode.

Related commands

configure-user count

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.

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. (The output is omitted here.)

<Sysname> display copyright

display cpu-usage

Use display cpu-usage to display CPU usage statistics.

Syntax

display cpu-usage [ entry-number [ offset ] [ verbose ] ] [ | { begin | exclude | include } regular-expression ]

Views

Any view

Default command level

1: Monitor level

Parameters

entry-number: Number of entries to be displayed, which ranges from 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.

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

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

Unit CPU usage:

1% in last 5 seconds

1% in last 1 minute

1% in last 5 minutes

Table 2 Command output

Field	Description
Unit CPU usage	CPU usage rates.
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.

display cpu-usage history

Use display cpu-usage history to display historical CPU usage statistics in charts.

Syntax

display cpu-usage history [ task task-id ] [ | { 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 task-id 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).

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

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 the historical CPU usage statistics for the whole system.

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

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 No. Board Type Status Max Ports

1 WA4620i-ACN Board Normal 5

Table 3 Command output

Field

Description

Status

Status:

· Fault—Cannot start normally because an error occurred.

· Normal—Operating normally.

Table 4 Max Ports

Table 5 Maximum number of physical ports supported.

display device manuinfo

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

Syntax

display device manuinfo [ | { 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.

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 serial number, manufacturing date, 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 the electronic label data for the device.

<Sysname> display device manuinfo

DEVICE_NAME:WA4620i-ACN

DEVICE_SERIAL_NUMBER:210236A35VA10A482300

MAC_ADDRESS: 70F9-6DFB-1300

MANUFACTURING_DATE:2012-05-24

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.

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/2008

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

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

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

...

display environment

Use display environment to display temperature information, including the current temperature and temperature thresholds of cards.

Syntax

display environment [ | { 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.

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 temperature information.

<Sysname> display environment

System Temperature information (degree centigrade):

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

SlotNo Temperature Lower limit Upper limit

1 35 5 70

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: Specifies the 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.

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

Related commands

· job

· time

· view

display memory

Use display memory to display memory usage statistics.

Syntax

display memory [ | { 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.

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

<Sysname> display memory

System Total Memory(bytes): 187547920

Total Used Memory(bytes): 57525268

Used Rate: 30%

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

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.

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/2007 (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, the command displays nothing.

Table 8 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.

Related commands

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.

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/2006 (in 2 hours and 5 minutes).

Related commands

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

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

Related commands

system-failure

display version

Use display version to display system version information, including the system software version, chassis model, and basic MPU and interface card data.

Syntax

display version [ | { 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.

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

...

header

Use header to create a banner.

Use undo header to clear a banner.

Syntax

header { legal | login | motd | shell } text

undo header { legal | login | motd | shell }

Views

System view

Default command level

2: System level

Parameters

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

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

shell: Configures the banner displayed before a 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 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.)

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

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

# Verify the configuration by using Telnet. (Password authentication is configured.)

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

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

Password:

Welcome to shell(header shell)

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]

Related commands

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

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

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

undo schedule job

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/2007 (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/2007 (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 switch 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/2006(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.

%Jun 6 11:43:11:629 2006 Sysname CMD/4/REBOOT:

vty0(192.168.1.54): Set schedule reboot parameters at 11:43:11 06/06/2006, and system will reboot at 12:00 06/06/2006.

Related commands

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, 2006.

<Sysname> schedule reboot delay 88

Reboot system at 13:16 06/06/2006(in 1 hour(s) and 28 minute(s)). confirm? [Y/N]:

%Jun 6 11:48:44:860 2006 Sysname CMD/4/REBOOT:

vty0(192.168.1.54): Set schedule reboot parameters at 11:48:44 06/06/2006, and system will reboot at 13:16 06/06/2006.

Related commands

schedule reboot at

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 the device model name.

Views

System view

Default command level

2: System level

Parameters

sysname: Name of the device, which is a string of 1 to 64 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 R2000.

<Sysname> system-view

[Sysname] sysname R2000

[R2000]

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 system adopts 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 9 when you add commands in a job.

Table 9 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, 2009.

<Sysname> system-view

[Sysname] job saveconfig

[Sysname-job-saveconfig] view monitor

[Sysname-job-saveconfig] time 1 at 3:00 2009/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 5^th 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 5^th 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

Related commands

· 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 10 when you add commands in a job.

Table 10 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.

NOTE:

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

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

Related commands

· 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

01-Fundamentals Command Reference

clock datetime

clock summer-time one-off

display clock

display job

job

schedule job

time at

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us