Table of Contents

Chapter 1 Basic Configuration Commands. 1-1

1.1 Basic Configuration Commands. 1-1

1.1.1 clock datetime. 1-1

1.1.2 clock summer-time one-off 1-2

1.1.3 clock summer-time repeating. 1-3

1.1.4 clock timezone. 1-4

1.1.5 command-privilege. 1-5

1.1.6 display clipboard. 1-6

1.1.7 display clock. 1-7

1.1.8 display current-configuration. 1-8

1.1.9 display diagnostic-information. 1-10

1.1.10 display history-command. 1-10

1.1.11 display hotkey. 1-11

1.1.12 display this. 1-12

1.1.13 display version. 1-13

1.1.14 header 1-14

1.1.15 hotkey. 1-16

1.1.16 quit 1-18

1.1.17 return. 1-18

1.1.18 super 1-19

1.1.19 super password. 1-20

1.1.20 sysname. 1-21

1.1.21 system-view. 1-22

Chapter 2 System Maintaining and Debugging Commands. 2-1

2.1 System Maintaining Commands. 2-1

2.1.1 ping. 2-1

2.1.2 ping ipv6. 2-3

2.1.3 tracert 2-4

2.1.4 tracert ipv6. 2-6

2.2 System Debugging Commands. 2-7

2.2.1 debugging. 2-7

2.2.2 display debugging. 2-8

Chapter 3 Device Management Commands. 3-1

3.1 Device Management Commands. 3-1

3.1.1 boot-loader 3-1

3.1.2 bootrom.. 3-2

3.1.3 display cpu-usage. 3-2

3.1.4 display boot-loader 3-5

3.1.5 display device. 3-5

3.1.6 display device manuinfo. 3-6

3.1.7 display fan. 3-7

3.1.8 display memory. 3-7

3.1.9 display power 3-8

3.1.10 display reboot-type. 3-9

3.1.11 display schedule reboot 3-9

3.1.12 display transceiver alarm interface. 3-10

3.1.13 display transceiver diagnosis interface. 3-13

3.1.14 display transceiver interface. 3-14

3.1.15 display transceiver manuinfo interface. 3-16

3.1.16 reboot 3-17

3.1.17 reset unused porttag. 3-18

3.1.18 schedule reboot at 3-18

3.1.19 schedule reboot delay. 3-20

3.1.20 shutdown-interval 3-22

 

Chapter 1  Basic Configuration Commands

1.1  Basic Configuration Commands

1.1.1  clock datetime

Syntax

clock datetime time date

View

User view

Parameters

time: Current time in the format of HH:MM:SS, where HH is hours in the range 0 to 23, MM is minutes in the range 0 to 59, and SS is seconds in the range 0 to 59. The zeros in the argument can be omitted except for indicating 0 hours.

date: Current date in the format of MM/DD/YYYY or YYYY/MM/DD. MM is the month of the year in the range 1 to 12, DD is the day of the month that varies with months, and YYYY is a year in the range 2000 to 2035.

Description

Use the clock datetime command to set the current time and date of the device.

The current time and date of the device must be set in an environment that requires the acquisition of absolute time.

You may choose not to provide seconds when inputting the time parameters.

Related commands: clock summer-time one-off, clock summer-time repeating, clock timezone, display clock.

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

1.1.2  clock summer-time one-off

Syntax

clock summer-time zone-name one-off start-time start-date end-time end-date add-time

undo clock summer-time

View

User view

Parameters

zone-name: Name of the summer time, a string of 1 to 32 characters. It is case sensitive.

start-time: Start time, in the format of HH:MM:SS (hours/minutes/seconds). The zeros in the argument can be omitted except for indicating 0 hours.

start-date: Start date, in the format of MM/DD/YYYY (months/days/years) or YYYY/MM/DD.

end-time: End time, in the format of HH:MM:SS (hours/minutes/seconds). The zeros in the argument can be omitted except for indicating 0 hours.

end-date: End date, in the format of MM/DD/YYYY (months/days/years) or YYYY/MM/DD.

add-time: Time added to the standard time of the device, in the format of HH:MM:SS (hours/minutes/seconds). The zeros in the argument can be omitted except for indicating 0 hours.

Description

Use the clock summer-time one-off command to adopt summer time from the start-time of the start-date to the end-time of the end-date. Summer time adds the add-time to the current time of the device.

Use the undo clock summer-time command to cancel the configuration of the summer time.

After the configuration takes effect, you can use the display clock command to view it. Besides, the time of the log or debug information is the local time of which the time zone and summer time have been adjusted.

Note that:

l           The time range from start-time in start-date to end-time in end-date must be longer than one day and shorter than one year. Otherwise, the argument is considered as invalid and the configuration fails.

l           If the current system time is in the time range specified with this command, the system time automatically adds “add-time” after the execution of this command.

Related commands: clock datetime, clock summer-time repeating, clock timezone, display clock.

Examples

# For daylight saving time in abc1 between 06:00:00 on 08/01/2006 and 06:00:00 on 09/01/2006, set the system clock ahead one hour.

<Sysname> clock summer-time abc1 one-off 6 08/01/2006 6 09/01/2006 1

1.1.3  clock summer-time repeating

Syntax

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

undo clock summer-time

View

User view

Parameters

zone-name: Name of the daylight saving time, a string of 1 to 32 characters.

start-time: Start time, in the format of HH:MM:SS (hours/minutes/seconds). The zeros in the argument can be omitted except for indicating 0 hours.

start-date: Start date which can be set in two ways:

l           Enter the year, month and date at one time, in the format of MM/DD/YYYY (months/days/years) or YYYY/MM/DD.

l           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: End time, in the format of HH:MM:SS (hours/minutes/seconds). The zeros in the argument can be omitted except for indicating 0 hours.

end-date: End date which can be set in two ways:

l           Enter the year, month and date at one time, in the format of MM/DD/YYYY (months/days/years) or YYYY/MM/DD.

l           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: Time added to the current standard time of the device, in the format of HH:MM:SS (hours/minutes/seconds). The zeros in the argument can be omitted except for indicating 0 hours.

Description

Use the clock summer-time repeating command to adopt summer-time repeatedly.

Use the undo clock summer-time command to cancel the configuration of the daylight saving time.

For example, when start-date and start-time are set to 2007/6/6 and 00:00:00, end-date and end-time to 2007/10/01 and 00:00:00, and add-time to 01:00:00, it specifies to adopt daylight saving time from 00:00:00 of June 6 until 00:00:00 of October 1 each year from 2007 (2007 inclusive). The daylight saving time adds one hour to the current device time.

After the configuration takes effect, use the display clock command to view the result. The information such as log file and debug adopts the local time modified by time-zone and daylight saving time.

Note that:

l           The time range from “start-time” in “start-date” to “end-time” in “end-date” must be longer than one day and shorter than one year. Otherwise, the argument is considered as invalid and the configuration fails.

l           If the current system time is in the time range specified with this command, the system time automatically adds “add-time” after the execution of this command.

Related commands: clock datetime, clock summer-time one-off, clock timezone, display clock.

Examples

# For the summer time in abc2 between 06:00:00 on 08/01/2007 and 06:00:00 on 09/01/2007 and from 06:00:00 08/01 to 06:00:00 on 09/01 each year after 2007, set the system clock ahead one hour.

<Sysname> clock summer-time abc2 repeating 06:00:00 08/01/2007 06:00:00 09/01/2007 01:00:00

1.1.4  clock timezone

Syntax

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

undo clock timezone

View

User view

Parameters

zone-name: Time zone name, a string of 1 to 32 characters. It is case sensitive.

add: Positive offset to universal time coordinated (UTC) time.

minus: Negative offset to UTC time.

zone-offset: In the format of HH/MM/SS (hours/minutes/seconds), where HH is hours in the range 0 to 23, MM is minutes in the range 0 to 59, and SS is seconds in the range 0 to 59. The zeros in the argument can be omitted except for indicating 0 hours.

Description

Use the clock timezone command to set the local time zone.

Use the undo clock timezone command to restore the local time zone to the default UTC time zone.

By default, the local time zone is UTC zone.

After the configuration takes effect, use the display clock command to view the result. The information such as log file and debug adopts the local time modified by time-zone and daylight saving time.

Related commands: clock datetime, clock summer-time one-off, clock summer-time repeating, display clock.

Examples

# Set the name of the local time zone to Z5, five hours ahead of UTC time.

<Sysname> clock timezone z5 add 5

1.1.5  command-privilege

Syntax

command-privilege level level view view command

undo command-privilege view view command

View

System view

Parameters

level level: Command level, in the range 0 to 3.

view view: Specifies a view.

command: Command to be set in the specified view.

Description

Use the command-privilege command to assign a level for the commands in the specified view.

Use the undo command-privilege view command to restore the default.

By default, each command in each view has its specified level. Therefore, you are not recommended to modify the default command levels for fear of inconvenience brought to your operation and maintenance.

Command privilege falls into four levels: visit, monitor, system, and manage, which are identified by 0 through 3.

The administrator can assign a privilege level for a user according to his need. When the user logs on a device, the commands available depend on the user’s privilege. For example, if a user’s privilege is 3 and the command privilege of VTY 0 user interface is 1, and the user logs on the system from VTY 0, he can use all the commands with privilege smaller than three (inclusive).

The following table describes the default level of the commands.

Table 1-1 Default level of the commands

Command level	Commands
Visit (0)	ping, tracert, telnet
Monitor (1)	refresh, reset, send
System (2)	Configuration commands
Manage (3)	FTP, Xmodem, TFTP, file system operation commands

 

Examples

# Set the command level of the interface command to 0.

<Sysname> system-view

[Sysname] command-privilege level 0 view system interface

1.1.6  display clipboard

Syntax

display clipboard

View

Any view

Parameters

None

Description

Use the display clipboard command to view the contents of the clipboard.

To copy the specified content to the clipboard:

Move the cursor to the starting position of the content and press the <Esc+Shift+,> combination (“,” is an English comma).

Move the cursor to the ending position of the content and press the <Esc+Shift+.> combination (“.” is an English dot) to copy the specified content to the clipboard.

Examples

# View the content of the clipboard.

<Sysname> display clipboard

---------------- CLIPBOARD-----------------

        ip route 10.1.0.0 255.0.0.0 eth 0

1.1.7  display clock

Syntax

display clock

View

Any view

Parameters

None

Description

Use the display clock command to view the current system time and date.

The current system time and date are decided by the clock datetime, clock summer-time one-off (or clock summer-time repeating), clock timezone. Refer to Configuring the system clock in the operation manual for the detailed rules.

Related commands: clock datetime, clock summer-time one-off, clock summer-time repeating, clock timezone.

Examples

# Display the current time and date.

<Sysname> display clock

09:41:23 UTC Thu 12/15/2005

1.1.8  display current-configuration

Syntax

display current-configuration [ [ configuration [ configuration ] | controller | interface [ interface-type ] [ interface-number ] ] [ by-linenum ] [ | { begin | include | exclude } text ] ]

View

Any view

Parameters

configuration [ configuration ]: Specifies to display non-interface configuration. If no parameter is used, all the non-interface configuration is displayed; if parameters are used, display the specified information. For example:

l           isis: Displays the isis configuration.

l           isp: Displays the ISP configuration.

l           post-system: Displays the post-system configuration.

l           radius-template: Displays the Radius template configuration.

l           system: Displays the system configuration.

l           user-interface: Displays the user interface configuration.

interface [ interface-type ] [ interface-number ]: Displays the interface configuration, where interface-type represents the interface type and interface-number represents the interface number.

by-linenum: Specifies to display the number of each line.

|: Specifies to use regular expression to filter the configuration of display device.

l           begin: Displays the configuration beginning with the specified text.

l           include: Displays the configuration including the specified text.

l           exclude: Displays the configuration excluding the specified text.

text: Regular expression in a case-insensitive string with space allowed.

Table 1-2 Special characters in regular expression

Character	Meaning	Note
^	Starting sign, the string following it appears only at the beginning of a line.	Regular expression “^user” matches a string begins with “user”, not “Auser”.
$	Ending sign, the string before it appears only at the end of a line.	Regular expression "user$” matches a string ends with “user”, not “userA”.
(	Left bracket, used as a stack symbol in a program	It is not recommended to use this character to establish a regular expression.
.	Full stop, a wildcard used in place of any character, including blank	None
*	Asterisk, used to match a subexpression zero or multiple times before it	zo* can map to “z” and “zoo”.
+	Addition, used to match a subexpression one or multiple times before it	zo+ can map to “zo” and “zoo”, but not “z”.
-	Hyphen. It connects two values (the smaller one before it and the bigger one after it) to indicate a range together with [ ].	For example, “1-9” means numbers from 1 to 9 (inclusive); “a-h” means from a to h (inclusive).
[ ]	Selects one character from the group.	For example, [1-36A] can match only one character among 1, 2, 3, 6, and A.
( )	A group of characters. It is usually used with “+” or “*”.	For example, (123A) means a string “123A”; “408(12)+” can match 40812 or 408121212. But it cannot match 408. That is, “12” can appear continuously and it must at least appear once.

 

Description

Use the display current-configuration command to display the current validated configuration of a device.

You can use the display current-configuration command to view the currently validated configuration. A parameter is not displayed if it has the default configuration. If the validated parameter is changed, although you have configured it, the validated parameter is displayed. For example, ip address 11.11.11.11 24 has been configured on a Loopback interface. In this case, if you execute the display current-configuration command, ip address 11.11.11.11 255.255.255.255 is displayed, meaning the validated subnet mask is 32 bits.

Related commands: save, reset saved-configuration, display saved-configuration.

Examples

# Display the configuration beginning with user.

<Sysname> display current-configuration | begin user

user-interface aux 0

user-interface vty 0 4

1.1.9  display diagnostic-information

Syntax

display diagnostic-information

View

Any view

Parameters

None

Description

Use the display diagnostic-information command to display or save the statistics of each module’s running status in the system.

When the system is out of order, you need to collect a lot of information to locate the problem. At this time you can use the display diagnostic-information command to collect prompt information of the commands display clock, display version, display device, display current-configuration.

Examples

# Save the statistics of each module's running status in the system.

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

You can view the content of the file aa.diag by executing the more.aa.diag command in user view, in combination of the <Page Up> and <Page Down> keys.

# Display the statistics of each module's running status in the system.

<Sysname> display diagnostic-information

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

……Omitted……

1.1.10  display history-command

Syntax

display history-command

View

Any view

Parameters

None

Description

Use the display history-command command to display commands saved in the history buffer.

The system will save validated history commands performed last in current user view to the history buffer, which can save up to ten commands by default. You can use the history-command max-size command to set the size of the history buffer. Refer to the history-command max-size command in Login Commands for related configuration.

Examples

# Display validated history commands in current user view (the display information varies with configuration).

<Sysname> display history-command

  display history-command

  system-view

  vlan 2

  quit

1.1.11  display hotkey

Syntax

display hotkey

View

Any view

Parameters

None

Description

Use the display hotkey command to display hotkey information.

Examples

# Display hotkey information.

<Sysname> display hotkey

----------------- HOTKEY -----------------

            =Defined hotkeys=

Hotkeys Command

CTRL_G  display current-configuration

CTRL_L  display ip routing-table

CTRL_O  undo debug all

 

           =Undefined hotkeys=

Hotkeys Command

CTRL_T  NULL

CTRL_U  NULL

 

            =System hotkeys=

Hotkeys Function

CTRL_A  Move the cursor to the beginning of the current line.

CTRL_B  Move the cursor one character left.

CTRL_C  Stop current command function.

CTRL_D  Erase current character.

CTRL_E  Move the cursor to the end of the current line.

CTRL_F  Move the cursor one character right.

CTRL_H  Erase the character left of the cursor.

CTRL_K  Kill outgoing connection.

CTRL_N  Display the next command from the history buffer.

CTRL_P  Display the previous command from the history buffer.

CTRL_R  Redisplay the current line.

CTRL_V  Paste text from the clipboard.

CTRL_W  Delete the word left of the cursor.

CTRL_X  Delete all characters up to the cursor.

CTRL_Y  Delete all characters after the cursor.

CTRL_Z  Return to the User View.

CTRL_]  Kill incoming connection or redirect connection.

ESC_B   Move the cursor one word back.

ESC_D   Delete remainder of word.

ESC_F   Move the cursor forward one word.

ESC_N   Move the cursor down a line.

ESC_P   Move the cursor up a line.

ESC_<   Specify the beginning of clipboard.

ESC_>   Specify the end of clipboard.

1.1.12  display this

Syntax

display this [ by-linenum ]

View

Any view

Parameters

by-linenum: Specifies to display the number of each line.

Description

Use the display this command to display the validated configuration information under the current view.

After finishing a set of configurations under a view, you can use the display this command to check whether the configuration takes effect.

Note that:

l           A parameter is not displayed if it has the default configuration.

l           A parameter is not displayed if the configuration has not taken effect.

l           When you use the command under interface view, protocol view or protocol child view, the command displays the configuration corresponding to the current view.

Examples

# Display configuration information of the current view (the display information varies with configuration).

<Sysname> system-view

[Sysname] user-interface vty 0

[Sysname-ui-vty0] display this

#

user-interface con 0

user-interface vty 0

 history-command max-size 256

user-interface vty 1 4

#

return

1.1.13  display version

Syntax

display version

View

Any view

Parameters

None

Description

Use the display version command to view system version information.

By viewing system version information, you can learn about the current software version, rack type and the information related to the main control board and interface boards.

Examples

# Display system version information.

<Sysname> display version

H3C Comware Platform Software

Comware Software, Version 5.20, Test 5301

Copyright (c) 2004-2007 Hangzhou H3C Tech. Co., Ltd. All rights reserved.

H3C S3610-52P uptime is 0 week, 0 day, 7 hours, 51 minutes

 

H3C S3610-52P

128M    bytes DRAM

16M     bytes Flash Memory

Config Register points to FLASH

 

Hardware Version is REV.B

CPLD Version is CPLD 001

Bootrom Version is 128

[SubSlot  0] 48FE Hardware Version is REV.B

[SubSlot  1]  4GE Hardware Version is REV.B

1.1.14  header

Syntax

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

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

View

System view

Parameters

incoming: Sets the banner displayed when a Modem login user enters user view. If authentication is needed, the incoming banner is displayed after the authentication is passed.

legal: Sets the authorization banner before a user logs onto the terminal interface. The legal banner is displayed before the user inputs the username and password.

login: Sets the login banner at authentication.

motd: Banner displayed before login. If authentication is required, the banner is displayed before authentication.

shell: Sets the banner displayed when a non Modem login user enters user view.

text: Banner message, which can be input in two formats. Refer to the Basic System Configuration part in the Operation Manual for the detailed information.

Description

Use the header command to create a banner.

Use the undo header command to clear a banner.

Examples

# Configure banners.

<Sysname> system-view

[Sysname] header incoming %

Input banner text, and quit with the character '%'.

Welcome to incoming(header incoming)%

[Sysname] header legal %

Input banner text, and quit with the character '%'.

Welcome to legal (header legal)%

[Sysname] header login %

Input banner text, and quit with the character '%'.

Welcome to login(header login)%

[Sysname] header motd %

Input banner text, and quit with the character '%'.

Welcome to motd(header motd)%

[Sysname] header shell %

Input banner text, and quit with the character '%'.

Welcome to shell(header shell)%

 

 

# Test the configuration remotely using Telnet. (only when login authentication is configured can the login banner be displayed).

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

* Copyright (c) 2004-2007 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)

<Sysname>

1.1.15  hotkey

Syntax

hotkey { CTRL_G | CTRL_L | CTRL_O | CTRL_T | CTRL_U } command

undo hotkey { CTRL_G | CTRL_L | CTRL_O | CTRL_T | CTRL_U }

View

System view

Parameters

CTRL_G: Assigns the hot key <Ctrl+G> to a command.

CTRL_L: Assigns the hot key <Ctrl+L> to a command.

CTRL_O: Assigns the hot key <Ctrl+O> to a command.

CTRL_T: Assigns the hot key <Ctrl+T> to a command.

CTRL_U: Assigns the hot key <Ctrl+U> to a command.

command: The command line associated with the hot key.

Description

Use the hotkey command to assign a hot key to a command line.

Use the undo hotkey command to restore the default.

By default, the system specifies corresponding commands for <Ctrl+G>, <Ctrl+L> and <Ctrl+O>, while the others are null.

l           <Ctrl+G> corresponds to display current-configuration

l           <Ctrl+L> corresponds to display ip routing-table

l           <Ctrl+O> corresponds to undo debugging all

You can customize this scheme as needed however.

Examples

# Assign the hot key <Ctrl+T> to the display tcp status command.

<Sysname> system-view

[Sysname] hotkey ctrl_t display tcp status

# Display the configuration of hotkeys.

[Sysname] display hotkey

----------------- HOTKEY -----------------

 

            =Defined hotkeys=

Hotkeys Command

CTRL_G  display current-configuration

CTRL_L  display ip routing-table

CTRL_O  undo debug all

CTRL_T  display tcp status

           =Undefined hotkeys=

Hotkeys Command

CTRL_U  NULL

 

            =System hotkeys=

Hotkeys Function

CTRL_A  Move the cursor to the beginning of the current line.

CTRL_B  Move the cursor one character left.

CTRL_C  Stop current command function.

CTRL_D  Erase current character.

CTRL_E  Move the cursor to the end of the current line.

CTRL_F  Move the cursor one character right.

CTRL_H  Erase the character left of the cursor.

CTRL_K  Kill outgoing connection.

CTRL_N  Display the next command from the history buffer.

CTRL_P  Display the previous command from the history buffer.

CTRL_R  Redisplay the current line.

CTRL_V  Paste text from the clipboard.

CTRL_W  Delete the word left of the cursor.

CTRL_X  Delete all characters up to the cursor.

CTRL_Y  Delete all characters after the cursor.

CTRL_Z  Return to the user view.

CTRL_]  Kill incoming connection or redirect connection.

ESC_B   Move the cursor one word back.

ESC_D   Delete remainder of word.

ESC_F   Move the cursor forward one word.

ESC_N   Move the cursor down a line.

ESC_P   Move the cursor up a line.

ESC_<   Specify the beginning of clipboard.

ESC_>   Specify the end of clipboard.

1.1.16  quit

Syntax

quit

View

Any view

Parameters

None

Description

Use the quit command to exit to a lower-level view. If the current view is user view, the quit command terminates the current connection and reconnects to the device.

Examples

# Switch from Ethernet 1/0/1 port view to system view, and then to user view.

[Sysname-Ethernet1/0/1] quit

[Sysname] quit

<Sysname>

1.1.17  return

Syntax

return

View

Any view except user view

Parameters

None

Description

Use the return command to return to user view from current view, as you do with the hot key <Ctrl+Z>.

Related commands: quit.

Examples

# Return to user view from Ethernet port view.

[Sysname] interface ethernet 1/0/1

[Sysname-Ethernet1/0/1] return

<Sysname>

1.1.18  super

Syntax

super [ level ]

View

User view

Parameters

level: User level, in the range 0 to 3.

Description

Use the super command to switch from the current user level to a specified user level.

There are four levels of commands:

l           Visit: involves commands for network diagnosis (such as ping and tracert), commands for accessing an external device (such as Telnet client, SSH client, RLOGIN). Saving the configuration file is not allowed at this level.

l           Monitor: includes the display and debugging commands for system maintenance, and service fault diagnosis. Saving the configuration file is not allowed at this level.

l           System: provides service configuration commands, including routing and commands at each level of the network for providing services.

l           Manage: influences the basic operation of the system and the system support modules for service support. Commands at this level involve file system, FTP, TFTP, Xmodem download and configuration file switch, power control, standby board control, user management, level setting, as well as parameter setting within a system (the last case involves those non-protocol or non RFC provisioned commands).

Login users are also classified into four levels that correspond to the four command levels. After users at different levels log in, they can only use commands at their own, or lower, levels.

Note that:

Users can switch to a lower user level unconditionally. To log in through AUX, or VTY user interface and switch to a higher user level, however, they need to enter the password (The password can be set with the super password command.). If the entered password is incorrect or no password is configured, the switch fails. Therefore, before switching to a higher user level, users should configure the password needed.

Related commands: super password.

Examples

# Set the user level to 2 (The current user level is 3.).

<Sysname> super 2

User privilege level is 2, and only those commands can be used

whose level is equal or less than this.

Privilege note: 0-VISIT, 1-MONITOR, 2-SYSTEM, 3-MANAGE

# Switch the user level back to 3 (Suppose password 123 has been set; otherwise, the user level cannot be switched to 3.).

<Sysname> super 3

 Password:

User privilege level is 3, and only those commands can be used

whose level is equal or less than this.

Privilege note: 0-VISIT, 1-MONITOR, 2-SYSTEM, 3-MANAGE

1.1.19  super password

Syntax

super password [ level user-level ] { simple | cipher } password

undo super password [ level user-level ]

View

System view

Parameters

level level: User level in the range 1 to 3, with the default as 3.

simple: Plain text password.

cipher: Cipher text password.

password: Password, a string of characters. It is case-sensitive.

l           For simple password, it is a string of 1 to 16 characters.

l           For cipher password, it is a string of 1 to 16 characters in plain text or 24 characters in cipher text. For example, the simple text “1234567” corresponds to the cipher text “(TT8F]Y\5SQ=^Q`MAF4<1!!”.

Description

Use the super password command to set the password needed to switch from a lower user level to a higher one.

Use the undo super password command to restore the default.

By default, no password is set to switch from a lower user level to a higher one.

Note that:

l           If simple is specified, the configuration file saves a simple password.

l           If cipher is specified, the configuration file saves a cipher password.

l           The user must always enter a simple password, no matter simple or cipher is specified.

l           Cipher passwords are recommended, as simple ones are easily getting cracked.

Examples

# Set the password to abc in simple form for switching user-level to 3.

<Sysname> system-view

[Sysname] super password level 3 simple abc

Display the password for switching user-level.

[Sysname] display current-configuration

#

 super password level 3 simple abc

# Set the password to abc in cipher form for switching user-level to 3.

<Sysname> system-view

[Sysname] super password level 3 cipher abc

Display the password for switching user-level.

[Sysname] display current-configuration

#

 super password level 3 cipher =`*Y=F>*.%-a_SW8\MYM2A!!

1.1.20  sysname

Syntax

sysname sysname

undo sysname

View

System view

Parameters

sysname: Name of the device, a string of 1 to 30 characters.

Description

Use the sysname command to set the name of the device.

Use the undo sysname demand to restore the device name to the default.

The default name of the device is H3C.

Modifying device name affects the prompt of the CLI. For example, if the device name is Sysname, the prompt of user view is <Sysname>.

Examples

# Set the name of the device to R2000.

<Sysname> system-view

[Sysname] sysname R2000

[R2000]

1.1.21  system-view

Syntax

system-view

View

User view

Parameters

None

Description

Use the system-view command to enter system view from the current user view.

Related commands: quit, return.

Examples

# Enter system view from the current user view.

<Sysname> system-view

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

[Sysname]

 

Chapter 2  System Maintaining and Debugging Commands

2.1  System Maintaining Commands

2.1.1  ping

Syntax

ping [ ip ] [ -a source-ip | -c count | -f | -h ttl | -i interface-type interface-number | -m interval | -n | -p pad | -q | -r | -s packet-size | -t timeout | -tos tos | -v | -vpn-instance vpn-instance-name ] * remote-system

View

Any view

Parameters

ip: Supports IPv4 protocol.

-a source-ip: Specifies the source IP address of an ICMP echo request. It must be a legal IP address configured on the device.

-c count: Specifies the number of times that an ICMP echo request is sent, in the range 1 to 4294967295. The default value is 5.

-f: Discards packets larger than the MTU of a given interface, that is, the ICMP echo request is not allowed to be fragmented.

-h ttl: Specifies the TTL value for an ICMP echo request, in the range 1 to 255. The default value is 255.

-i interface-type interface-number: Specifies the ICMP echo request sending interface by its type and number. With the interface specified, the TTL of packets are set to 1 automatically to test the directly-connected device (the IP address of the device is in the same network segment with that of the interface).

-m interval: Specifies the interval (in milliseconds) to send an ICMP echo response, in the range 1 to 65535. The default value is 200 ms.

l           If a response from the destination is received within the timeout time, the interval to send the next echo request equals the actual response period plus the value of interval.

l           If no response from the destination is received within the timeout time, the interval to send the next echo request equals the timeout value plus the value of interval.

-n: Specifies that the Domain Name System (DNS) is disabled. DNS is enabled by default, that is, the hostname is translated into an address.

-p pad: Specifies the padded bytes in an ICMP echo request, in hexadecimal format. For example, if pad is configured as ff, then the packets will be padded with ff. By default, the padded bytes start from 0x01 up to 0x09, where another round starts again if necessary.

-q: Presence of this parameter indicates that only statistics are displayed. By default, all information is displayed.

-r: Records routes. By default, routes are not recorded.

-s packet-size: Specifies length (in bytes) of an ICMP echo request, in the range 20 to 8100. The default value is 56.

-t timeout: Specifies the timeout value (in milliseconds) of an ICMP echo request, in the range 0 to 65535. It defaults to 2000.

-tos tos: Specifies type of service (ToS) of an echo request, in the range 0 to 255. The default value is 0.

-v: Displays non ICMP echo reply received. By default, the system does not display non ICMP echo reply.

-vpn-instance vpn-instance-name: Specifies the name of an MPLS VPN instance, which is a string of 1 to 31 characters. It is case insensitive.

remote-system: IP address or host name (a string of 1 to 20 characters) of the destination device.

Description

Use the ping command to verify whether the destination device in an IP network is reachable, and to display the related statistics.

Note that:

l           You must use the command in the form of ping ip ip instead of ping ip if the destination name is a key word, such as ip.

l           Only the directly connected segment address can be pinged if the outgoing interface is specified with the -i argument.

Examples

# Check whether the device with an IP address of 10.1.1.5 is reachable.

<Sysname> ping 10.1.1.5

PING 10.1.1.5 : 56 data bytes, press CTRL_C to break

Reply from 10.1.1.5 : bytes=56 Sequence=1 ttl=255 time = 1 ms

Reply from 10.1.1.5 : bytes=56 Sequence=2 ttl=255 time = 2 ms

Reply from 10.1.1.5 : bytes=56 Sequence=3 ttl=255 time = 1 ms

Reply from 10.1.1.5 : bytes=56 Sequence=4 ttl=255 time = 3 ms

Reply from 10.1.1.5 : bytes=56 Sequence=5 ttl=255 time = 2 ms

 

--- 10.1.1.5 ping statistics ---

5 packet(s) transmitted

5 packet(s) received

0.00% packet loss

round-trip min/avg/max = 1/2/3 ms

2.1.2  ping ipv6

Syntax

ping ipv6 [ -a source-ipv6 | -c count | -m interval | -s packet-size | -t timeout ] * remote-system [ -i interface-type interface-number ]

View

Any view

Parameters

-a source-ipv6: Specifies the source IPv6 address of an ICMP echo request. It must be a legal IPv6 address configured on the device.

-c count: Specifies the number of times that an ICMPv6 echo request is sent, in the range 1 to 4294967295. The default value is 5.

-m interval: Specifies the interval (in milliseconds) to send an ICMPv6 echo reply, in the range 1 to 65535. The default value is 200 ms.

l           If a response from the destination is received within the timeout time, the interval to send the next echo request equals the actual response period plus the value of interval.

l           If no response from the destination is received within the timeout time, the interval to send the next echo request equals the timeout value plus the value of interval.

-s packet-size: Specifies length (in bytes) of an ICMPv6 echo request, in the range 20 to 8100. It defaults to 56.

-t timeout: Specifies the timeout value (in milliseconds) of an ICMPv6 echo request, in the range 0 to 65535. It defaults to 2000.

remote-system: IPv6 address or host name (a string of 1 to 46 characters) of the destination device.

-i interface-type interface-number: Specifies an outgoing interface by its type and number. This parameter can be used only in case that the destination address is the link local address and the specified outgoing interface must have a link local address (For the configuration of link local address, see the IPv6 Configuration part of the manual.

Description

Use the ping ipv6 command to verify whether an IPv6 address is reachable, and display the corresponding statistics.

You must use the command in the form of ping ipv6 ipv6 instead of ping ipv6 if the destination name is an ipv6 name.

Examples

# Verify whether the IPv6 address 2001::1 is reachable.

<Sysname> ping ipv6 2001::1

  PING 2001::1 : 56  data bytes, press CTRL_C to break

  Reply from 2001::1  bytes=56 Sequence=1 hop limit=64  time = 20 ms

  Reply from 2001::1  bytes=56 Sequence=2 hop limit=64  time = 0 ms

  Reply from 2001::1  bytes=56 Sequence=3 hop limit=64  time = 0 ms

  Reply from 2001::1  bytes=56 Sequence=4 hop limit=64  time = 0 ms

  Reply from 2001::1  bytes=56 Sequence=5 hop limit=64  time = 0 ms

 

  --- 2001::1 ping statistics ---

    5 packet(s) transmitted

    5 packet(s) received

    0.00% packet loss

    round-trip min/avg/max = 0/4/20 ms

The “hop limit” field in this prompt information has the same meaning as the “ttl” field in the prompt information displayed by the IPv4 ping command, indicating the TTL value in the ICMPv6 echo request.

2.1.3  tracert

Syntax

tracert [ -a source-ip | -f first-ttl | -m max-ttl | -p port | -q packet-number | -vpn-instance vpn-instance-name | -w timeout ] * remote-system

View

Any view

Parameters

-a source-ip: Specifies the source IP address of a tracert packet. It must be a legal IP address configured on the device.

-f first-ttl: Specifies the first TTL, that is, the allowed number of hops for the first packet, in the range 1 to 255. It defaults to 1 and must be less than the maximum TTL.

-m max-ttl: Specifies the maximum TTL, that is, the maximum allowed number of hops for a packet, in the range 1 to 255. It defaults to 30, and must be greater than the first TTL.

-p port: Specifies the UDP port number of the destination device, in the range 1 to 65535. The default value is 33434. You do not need to modify this parameter.

-q packet-number: Specifies the number of probe packets sent each time, in the range 1 to 65535. The default value is 3.

-vpn-instance vpn-instance-name: Specifies the name of an MPLS VPN instance, which is a string of 1 to 31 characters.

-w timeout: Specifies the packet timeout time, in the range 1 to 65535, in milliseconds. The default value is 5000 ms.

remote-system: IP address or host name (a string of 1 to 20 characters) of the destination device.

Description

Use the tracert command to trace the routers the packets traverse from the source to the destination device.

After having identified network failure with the ping command, you can use the tracert command to determine the failed node(s).

Output information of the tracert command includes IP addresses of all the routers the packets traverse from the source to the destination device. If a router times out, "* * *" will be displayed.

Examples

# Display the routers the packets traverse from the current device, with an IP address of 8.26.0.115, to the destination device.

<Sysname> tracert 18.26.0.115

traceroute to 18.26.0.115(18.26.0.115) 30 hops max,40 bytes packet, press CTRL_C to break

1  128.3.112.1  10 ms 10 ms 10 ms

2  128.32.210.1  19 ms 19 ms 19 ms

3  128.32.216.1  39 ms 19 ms 19 ms

4  128.32.136.23  19 ms 39 ms 39 ms

5  128.32.168.22  20 ms 39 ms 39 ms

6  128.32.197.4  59 ms 119 ms 39 ms

7  131.119.2.5  59 ms 59 ms 39 ms

8  129.140.70.13  80 ms 79 ms 99 ms

9  129.140.71.6  139 ms 139 ms 159 ms

10  129.140.81.7  199 ms 180 ms 300 ms

11  129.140.72.17  300 ms 239 ms 239 ms

12  * * *

13  128.121.54.72  259 ms 499 ms 279 ms

14  * * *

15  * * *

16  * * *

17  * * *

18  18.26.0.115  339 ms 279 ms 279 ms

2.1.4  tracert ipv6

Syntax

tracert ipv6 [ -f first-ttl | -m max-ttl | -p port | -q packet-number | -w timeout ] * remote-system

View

Any view

Parameters

-f first-ttl: Specifies the first TTL, that is, the allowed number of hops for the first packet, in the range 1 to 255. It defaults to 1 and must be less than the maximum TTL.

-m max-ttl: Specifies the maximum TTL, that is, the maximum allowed number of hops for a packet, in the range 1 to 255. It defaults to 30 and must be greater than the first TTL.

-p port: Specifies the UDP port number of the destination device, in the range 1 to 65535. The default value is 33434. It is unnecessary to modify this parameter.

-q packet-number: Specifies the number of probe packets sent each time, in the range 1 to 65535, defaulting to 3.

-w timeout: Specifies the timeout time of the probe packets, in the range 1 to 65535, in milliseconds. The default value is 5000 ms.

remote-system: IPv6 address or host name of the destination device. An IPv6 address can be up to 46 characters; a host name is a string of 1 to 20 characters.

Description

Use the tracert ipv6 command to view the routers the IPv6 packets traverse from the source to the destination device.

Examples

# View the routes involved for packets to travel from the source to the destination with IPv6 address 3002::1.

<Sysname> tracert ipv6 3002::1

 traceroute to 3002::1  30 hops max,60 bytes packet

 1 3003::1 30 ms 10 ms 10 ms

 2 3002::1 10 ms 11 ms 9 ms

2.2  System Debugging Commands

2.2.1  debugging

Syntax

debugging { all [ timeout time ] | module-name [ option ] }

undo debugging { all | module-name [ option ] }

View

User view

Parameters

all: All debugging functions.

timeout time: Specifies the timeout time for the debugging all command. When all debugging is enabled, the system automatically executes the undo debugging all command after the time. The value ranges from 1 to 1440, in minutes.

module-name: Module name, such as ARP or NTP. You can use the debugging ? command to display the current module name.

option: Specifies the debugging option for a specific module. Different modules have different debugging options in terms of their number and content. You can use the debugging module-name ? command to display the currently supported options.

Description

Use the debugging command to enable the debugging of a specific module.

Use the undo debugging command to disable the debugging of a specific module.

By default, debugging functions of all modules are disabled.

Note the following:

l           This command is intended for network administrators to diagnose network failure.

l           Output of the debugging information may degrade system efficiency, especially during the execution of the debugging all command. Therefore, use the command with caution.

l           After finishing debugging, you can use the undo debugging all command to disable all the debugging functions.

l           You must configure the debugging, terminal debugging and terminal monitor commands first to display detailed debugging information on the terminal. For the detailed description on the terminal debugging and terminal monitor commands, refer to Information Center Commands.

Related commands: display debugging.

Examples

# Enable IP packet debugging.

<Sysname> debugging ip packet

2.2.2  display debugging

Syntax

display debugging [ interface interface-type interface-number ] [ module-name ]

View

Any view

Parameters

interface interface-type interface-number: Displays the debugging settings of the specified interface, where interface-type interface-number represents the interface type and number.

module-name: Module name.

Description

Use the display debugging command to display enabled debugging functions.

Related commands: debugging.

Examples

# Display all enabled debugging functions.

<Sysname> display debugging

IP packet debugging is on

 

Chapter 3  Device Management Commands

 

 

3.1  Device Management Commands

3.1.1  boot-loader

Syntax

boot-loader file file-url

View

User view

Parameters

file file-url: Specifies a file name, a string of 1 to 64 characters.

Description

Use the boot-loader command to specify a host file for next boot.

Related commands: display boot-loader.

Examples

# Specify the host file for next boot as plat.bin.

<Sysname> boot-loader file plat.bin

  This command will set the boot file, Continue? [Y/N]:y

  The specified file will be used as the boot file at the next reboot!

3.1.2  bootrom

Syntax

bootrom update file file-url

View

User view

Parameters

update file file-url: Upgrades Boot ROM, where file-url represents name of the file to be upgraded.

Description

Use the bootrom command to upgrade the Boot ROM program on a switch. The upgraded Boot ROM is used for the next boot.

Examples

# Use the a.btm file to upgrade the Boot ROM file on the switch.

<Sysname> bootrom update file a.btm

  This command will update bootrom file, Continue?[Y/N]:y

  Now updating bootrom, please wait...

  BootRom file updating finished!

3.1.3  display cpu-usage

Syntax

display cpu-usage [ task | number [ offset ] [ verbose ] [ from-device ] ]

View

Any view

Parameters

task: Displays CPU usage of each task.

number: Number of CPU usage statistics records to be displayed.

offset: Offset between the serial number of the first CPU usage statistics record to be displayed and that of the last CPU usage record to be displayed.

verbose: Specifies to display detailed information of CPU usage statistics.

from-device: Displays external storage devices such as Flash and hard disk. The device currently does not support the from-device keyword.

Description

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

The system takes statistics of CPU usage at intervals (usually every 60 seconds) and saves the statistical results in the history record area. display cpu-usage number indicates the system displays number records from the newest (last) record. display cpu-usage number offset indicates the system displays number records from the last but offset+1 record.

Equivalent to the display cpu-usage 1 0 verbose command, the display cpu-usage command displays detailed information of the last CPU usage statistics record.

Examples

# Display information of the current CPU usage statistics.

<Sysname> display cpu-usage

Unit CPU usage:

     14% in last 5 seconds

     12% in last 1 minute

      8% in last 5 minutes

# Display detailed information of the last CPU usage statistics record of the current tasks.

<Sysname> display cpu-usage task

===== Current CPU usage info =====

CPU Usage Stat. Cycle: 41 (Second)

CPU Usage            : 3%

CPU Usage Stat. Time : 2006-07-10  11:02:20

CPU Usage Stat. Tick : 0x1da0(CPU Tick High) 0x62a5077f(CPU Tick Low)

Actual Stat. Cycle   : 0x0(CPU Tick High) 0x3d5b5ad1(CPU Tick Low)

 

TaskName        CPU        Runtime(CPU Tick High/CPU Tick Low)

b2X0             0%               0/   ce77f

VIDL            97%               0/3bc6e650

TICK             0%               0/  23ec62

STMR             0%               0/    ad24

DrTF             0%               0/   28b6b

DrTm             0%               0/   18a28

bCN0             0%               0/   d840e

…omitted…

# Display the last fifth and sixth records of the CPU usage statistics history.

<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 : 2006-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 : 2006-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 3-1 Description on fields of the display cpu-usage command

Field	Description
CPU usage info (no:  idx:)	Information of CPU usage records (no: The (no+1)th record is currently 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 measurement period in seconds
CPU Usage	CPU usage in percentage
CPU Usage Stat. Time	CPU usage statistics time in seconds
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 measurement period 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 records may differ slightly.
TaskName	Task name
CPU	CPU usage of the current task
Runtime(CPU Tick High/CPU Tick Low)	Running time of the current task

 

3.1.4  display boot-loader

Syntax

display boot-loader

View

Any view

Parameters

None

Description

Use the display boot-loader command to display the bo ot file for the current boot and next boot.

Related commands: boot-loader.

Examples

# Display the file adopted for the current and next boot of the device.

<Sysname> display boot-loader

  The current boot app is: Switch.bin

  The app that will boot upon reboot is: New.bin

3.1.5  display device

Syntax

display device [ subslot subslot-number | verbose ]

View

Any view

Parameters

subslot subslot-number: Displays detailed information of the specified subcard. The subslot-number represents the subslot of a subcard.

verbose: Displays detailed information.

Description

Use the display device command to display information about the device card(s) and subcard.

Examples

# Display brief information of cards on a device.

<Sysname> display device

Slot No.   Brd Type   Brd Status   Subslot Num    Sft Ver

1          MAIN       Normal           2          Test 5301

Table 3-2 Description on the fields of the display device command

Field	Description
Slot No.	Slot number of a card
Board Type	Hardware type of a card
Brd Status	Card status
Subslot Num	Number of the sub-slots.
Sft Ver	Software version

 

3.1.6  display device manuinfo

Syntax

display device manuinfo

View

Any view

Parameters

None

Description

Use the display device manuinfo command to display manufacture information about the device.

Examples

# Display manufacturing information of a device.

<Sysname> display device manuinfo

DEVICE_NAME:

DEVICE_SERIAL_NUMBER: 210235A045B05B004350

MAC_ADDRESS: 000f-e200-5600

MANUFACTURING_DATE: 2006-04-13

VENDOR_NAME: H3C

Table 3-3 Description on the fields of the display device manuinfo command

Field	Description
DEVICE_NAME	Device name
DEVICE_SERIAL_NUMBER	Device serial number
MAC_ADDRESS	MAC address of the device
MANUFACTURING_DATE	Manufacturing date of the device
VENDOR_NAME	Manufacturer name

 

3.1.7  display fan

Syntax

display fan [ fan-id ]

View

Any view

Parameters

fan-id: Built-in fan number. The value varies with devices.

Description

Use the display fan command to display the operating state of built-in fans.

Examples

# Display the operating state of all fans in a device.

<Sysname> display fan

 Fan  1 State: Normal

The above information displays that the fan works normally.

3.1.8  display memory

Syntax

display memory

View

Any view

Parameters

None

Description

Use the display memory command to display the usage of the memory of a device.

Examples

# Display the usage of the memory of a device.

<Sysname> display memory

System Total Memory(bytes): 431869088

Total Used Memory(bytes): 71963156

Used Rate: 16%

Table 3-4 Description on fields on the display memory command

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

 

3.1.9  display power

Syntax

display power [ power-id ]

View

Any view

Parameters

power-id: Power supply number.

Description

Use the display power to display the status of the power supply of a device.

Examples

# Display the status of the power supply of a device.

<Sysname> display power

 Power   1 State: Normal

 Power   2 State: Fault

The above information indicates that power supply 1 works normally, and power supply 2 is absent or faulty.

3.1.10  display reboot-type

Syntax

display reboot-type

View

Any view

Parameters

None

Description

Use the display reboot-type command to display the reboot type of the device.

Examples

# Display the reboot type of the device.

<Sysname> display reboot-type

  The rebooting type this time is: Cold

The above information indicates that the last reboot type of the device is Cold boot. (If it is displayed as Warm, it indicates the reboot type is warm boot).

3.1.11  display schedule reboot

Syntax

display schedule reboot

View

Any view

Parameters

None

Description

Use the display schedule reboot command to display the device reboot time set by the user.

Related commands: schedule reboot at and schedule reboot delay.

Examples

# Display the reboot time of a device.

<Sysname> display schedule reboot

System will reboot at 16:00:00 2006/03/10 (in 2 hours and 5 minutes).

The above information indicates the system will reboot at 16:00:00 on March 10, 2006 (in two hours and five minutes).

3.1.12  display transceiver alarm interface

Syntax

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

View

Any view

Parameters

interface-type interface-number: Interface type and interface number.

Description

Use the display transceiver alarm interface command to display the current alarm information of a single or all transceivers.

If no error occurs, None is displayed.

Table 3-5 shows the alarm information that may occur for the four types of transceivers.

Table 3-5 Description on the fields of display transceiver alarm interface

Field	Remarks	Alarm type
GBIC/SFP
RX loss of signal	RX signal is lost.	—
RX power high	RX power is high.	Digital diagnosis alarm
RX power low	RX power is low.	Digital diagnosis alarm
TX fault	TX fault	TX alarm
TX bias high	TX bias current is high.	Digital diagnosis alarm
TX bias low	TX bias current is low.	Digital diagnosis alarm
TX power high	TX power is high.	Digital diagnosis alarm
TX power low	TX power is low.	Digital diagnosis alarm
Temp high	Temperature is high.	Digital diagnosis alarm
Temp low	Temperature is low.	Digital diagnosis alarm
Voltage high	Voltage is high.	Digital diagnosis alarm
Voltage low	Voltage is low.	Digital diagnosis alarm
Transceiver info I/O error	Transceiver information read and write error	—
Transceiver info checksum error	Transceiver information checksum error	—
XFP
RX loss of signal	RX signal is lost.	—
RX not ready	RX is not ready	RX alarm
RX CDR loss of lock	RX clock cannot be recovered.	RX alarm
RX power high	RX power is high.	Digital diagnosis alarm
RX power low	RX power is low.	Digital diagnosis alarm
TX not ready	TX is not ready.	TX alarm
TX fault	TX fault	TX alarm
TX CDR loss of lock	TX clock cannot be recovered.	TX alarm
TX bias high	TX bias current is high.	Digital diagnosis alarm
TX bias low	TX bias current is low.	Digital diagnosis alarm
TX power high	TX power is high.	Digital diagnosis alarm
TX power low	TX power is low.	Digital diagnosis alarm
Module not ready	Module is not ready.	Other alarm
APD supply fault	APD (Avalanche Photo Diode) supply fault	Other alarm
TEC fault	TEC (Thermoelectric Cooler) fault	Other alarm
Wavelength unlocked	Wavelength of optical signal exceeds the manufacturer’s tolerance.	Other alarm
Temp high	Temperature is high.	Digital diagnosis alarm
Temp low	Temperature is low.	Digital diagnosis alarm
Voltage high	Voltage is high.	Digital diagnosis alarm
Voltage low	Voltage is low.	Digital diagnosis alarm
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	Transceiver type is not supported on the port.	—
XENPAK
WIS local fault	WIS (WAN Interface Sublayer) local fault	Other alarm
Receive optical power fault	Receive optical power fault	RX alarm
PMA/PMD receiver local fault	PMA/PMD (Physical Medium Attachment/Physical Medium Dependent) receiver local fault	RX alarm
PCS receive local fault	PCS (Physical Coding Sublayer) receiver local fault	RX alarm
PHY XS receive local fault	PHY XS (PHY Extended Sublayer) receive local fault	RX alarm
RX power high	RX power is high.	Digital diagnosis alarm
RX power low	RX power is low.	Digital diagnosis alarm
Laser bias current fault	Laser bias current fault	TX alarm
Laser temperature fault	Laser temperature fault	Other alarm
Laser output power fault	Laser output power fault	TX alarm
TX fault	TX fault	TX alarm
PMA/PMD receiver local fault	PMA/PMD receiver local fault	TX alarm
PCS receive local fault	PCS receive local fault	TX alarm
PHY XS receive local fault	PHY XS receive local fault	TX alarm
TX bias high	TX bias current is high.	Digital diagnosis alarm
TX bias low	TX bias current is low.	Digital diagnosis alarm
TX power high	TX power is high.	Digital diagnosis alarm
TX power low	TX power is low.	Digital diagnosis alarm
Temp high	Temperature is high.	Digital diagnosis alarm
Temp low	Temperature is low.	Digital diagnosis alarm
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	Transceiver type is not supported on the port.	—

 

 

Examples

# Display the alarm information of the transceiver on interface GigabitEthernet 1/1/1.

<Sysname> display transceiver alarm interface gigabitethernet 1/1/1

GigabitEthernet1/1/1 transceiver current alarm information:

  RX loss of signal

Table 3-6 Description on the fields of display transceiver alarm interface

Field	Description
transceiver current alarm information	Current alarm information of the transceiver
RX loss of signal	RX signal is lost.

 

3.1.13  display transceiver diagnosis interface

Syntax

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

View

Any view

Parameters

interface-type interface-number: Interface type and interface number.

Description

Use the display transceiver diagnosis interface command to display the currently measured value of digital diagnosis parameters of a single or all anti-spoofing transceivers customized by H3C.

Examples

# Display the currently measured value of digital diagnosis parameters of the anti-spoofing pluggable optical transceiver customized by H3C on interface GigabitEthernet 1/1/2.

<Sysname> display transceiver diagnosis interface gigabitethernet 1/1/2

GigabitEthernet1/1/2 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 3-7 Description on the fields of display transceiver diagnosis interface

Field	Description
transceiver diagnostic information	Digital diagnosis information of the transceiver carried by an 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.

 

3.1.14  display transceiver interface

Syntax

display transceiver interface [ interface-type interface-number ]

View

Any view

Parameters

interface-type interface-number: Interface type and interface number.

Description

Use the display transceiver interface command to display main parameters of a single or all transceivers.

Examples

# Display main parameters of the pluggable transceiver on interface GigabitEthernet 1/1/3.

<Sysname> display transceiver interface gigabitethernet 1/1/3

GigabitEthernet1/1/3 transceiver information:

  Transceiver Type              : 1000_BASE_SX_SFP

  Connector Type                : LC

  Wavelength(nm)                : 850

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

  Digital Diagnostic Monitoring : YES

  Vendor Name                   : H3C

  Ordering Name                 : SFP-GE-SX-MM850

Table 3-8 Description on the fields of the display transceiver interface command

Field	Description
transceiver information	Transceiver information of the interface
Transceiver Type	Transceiver type
Connector Type	Type of the connectors of the transceiver: l      Optical connectors, including SC (SC connector, developed by NTT) and LC (LC connector, 1.25 mm/RJ45 optical connector developed by Lucent). l      Other connectors, including RJ-45 and CX4.
Wavelength(nm)	l      Optical transceiver: central wavelength of the laser sent, in nm. If the transceiver supports multiple wavelengths, every two wavelength values are separated by a comma. l      Electrical transceiver: displayed as N/A.
Transfer distance(xx)	Transfer distance, with xx representing km for single-mode transceivers and m for other transceivers. If the transceiver supports multiple transfer medium, every two values of the transfer distance are separated by a comma. The corresponding transfer medium is included in the bracket following the transfer distance value. The following are the transfer media: l      9 um: 9/125 um single-mode fiber l      50 um: 50/125 um multi-mode fiber l      62.5 um: 62.5/125 um multi-mode fiber l      TP: Twisted pair l      CX4: CX4 cable
Digital Diagnostic Monitoring	Whether the digital diagnosis function is supported, where: l      YES: supported l      NO: not supported
Vendor Name	Vendor name or vendor name specified of the transceiver: l      The anti-spoofing transceiver customized by H3C: H3C is displayed. l      Other transceivers: The original vendor name is displayed.
Ordering Name	Ordering name of the transceiver

 

3.1.15  display transceiver manuinfo interface

Syntax

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

View

Any view

Parameters

interface-type interface-number: Interface type and interface number.

Description

Use the display transceiver manuinfo interface command to display part of the electrical label information of a single or all anti-spoofing pluggable transceivers customized by H3C.

Examples

# Display part of the electrical label information of the anti-spoofing pluggable transceiver customized by H3C on interface GigabitEthernet 1/1/4.

<Sysname> display transceiver manuinfo interface gigabitethernet 1/1/4

GigabitEthernet1/1/4 transceiver manufacture information:

  Manu. Serial Number  : 213410A0000054000251

  Manufacturing Date   : 2006-09-01

  Vendor Name          : H3C

Table 3-9 Description on the fields of display transceiver manuinfo interface

Field	Description
Manu. Serial Number	Serial number generated during debugging and testing
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 specified, that is, H3C.

 

3.1.16  reboot

Syntax

reboot

View

User view

Parameters

None

Description

Use the reboot command to reboot the device.

 

 

Examples

# Reboot the device.

<Sysname> reboot

Start to check configuration with next startup configuration file, please wait

......                                                          

  This command will reboot the device. Current configuration will be lost in next startup if you continue. Continue? [Y/N]:y

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

Now rebooting, please wait

3.1.17  reset unused porttag

Syntax

reset unused porttag

View

User view

Parameters

None

Description

Use the reset unused porttag command to clear the 16-bit index saved but not used in the current system.

A confirmation is required when you carry out this command. If you fail to make a confirmation within 30 seconds or enter “N” to cancel the operation, the command will not be carried out.

Examples

# Clear the 16-bit index saved but not used in the current system.

<Sysname> reset unused porttag

Current operation will delete all unused port tag(s). Continue? [Y/N]:y

<Sysname>

3.1.18  schedule reboot at

Syntax

schedule reboot at hh:mm [ date ]

undo schedule reboot

View

User view

Parameters

hh:mm: Reboot time of a device, in the format of hh:mm (hours:minutes). The value of the hh argument ranges of is 0 to 23, and the value of the mm argument ranges from 0 to 59.

date: Reboot date of a device, in the format mm/dd/yyyy (Month/day/year) or in the format yyyy/mm/dd (year/month/day) The yyyy value ranges from 2000 to 2035, the mm value ranges from 1 to 12, and the dd value depends on a specific month.

Description

Use the schedule reboot at command to enable the scheduled reboot function and specify a specific reboot time and date.

Use the undo schedule reboot command to disable the scheduled reboot function.

By default, the scheduled reboot function is disabled.

There are two cases if no specific reboot date is specified:

l           When the specified reboot time is later than the current time, the device will be rebooted at the reboot time of the current day.

l           When the specified reboot time is earlier than the current time, the device will be rebooted at the reboot time the next day.

l           If you are performing file operations when the device is to be rebooted, the system does not execute the command for the sake of security.

Note that:

l           The precision of the device timer is 1 minute. One minute before the reboot time, the device will prompt “REBOOT IN ONE MINUTE” and will be rebooted in one minute.

l           The difference between the reboot date and the current date cannot exceed 30 x 24 hours (namely, 30 days).

l           After you execute the above command, the device will prompt you to confirm the configuration. You must enter <Y> or <y> to make the configuration take effect. The original configuration will be overwritten at the same time.

l           If a date (month/day/year or year/month/day) later than the current date is specified for the schedule reboot at command, the device will be rebooted at the reboot time.

l           If you use the clock command after the schedule reboot at command to adjust the system time, the reboot time set by the schedule reboot at command will become invalid.

 

 

Examples

# Configure the device to reboot at 12:00 AM (supposing that the current time is 11:43).

<Sysname> schedule reboot at 12:00

Reboot system at 12:00 2006/06/06(in 0 hour(s) and 16 minute(s))

confirm? [Y/N]:

# If you have used the terminal logging command to enable the log display function on the terminal before setting a reboot time, the system will automatically display related log information after you enter <y>. By default, the log display function is enabled.

<Sysname>

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

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

3.1.19  schedule reboot delay

Syntax

schedule reboot delay { hh:mm | mm }

undo schedule reboot

View

User view

Parameters

hh:mm: Device reboot wait time, in the format of hh:mm (hours:minutes). The value of the hh argument ranges of is 0 to 720, and the value of the mm argument ranges from 0 to 59, and the value of the hh:mm argument cannot exceed 720:00.

mm: Device reboot wait time in minutes, in the range of 0 to 43,200.

Description

Use the schedule reboot delay command to enable the scheduled reboot function and set a reboot wait time.

Use the undo schedule reboot command to disable the scheduled reboot function.

By default, the scheduled reboot function is disabled.

Note that:

l           The reboot wait time can be in the format of hh:mm (hours:minutes) or mm (absolute minutes). The absolute minutes cannot exceed 30 x 24 x 60 minutes, namely, 30 days.

l           The precision of the device timer is 1 minute. One minute before the reboot time, the device will prompt “REBOOT IN ONE MINUTE” and will be rebooted in one minute.

l           After you execute the above command, the device will prompt you to confirm the configuration. You must enter <Y> or <y> to make the configuration take effect. The original configuration will be overwritten at the same time.

l           If you use the clock command after the schedule reboot delay command to adjust the system time, the reboot wait time set by the schedule reboot delay command will become invalid.

l           If you are performing file operations when the device is to be rebooted, the system does not execute the command for the sake of security.

 

 

Examples

# Configure the device to reboot in 88 minutes (supposing the current time is 11:48).

<Sysname> schedule reboot delay 88

Reboot system at 13:16 2006/06/06(in 1 hour(s) and 28 minute(s))

confirm? [Y/N]:

# If you have used the terminal logging command to enable the log display function on the terminal before setting a reboot time, the system will automatically display related log information after you enter <y>. By default, the log display function is enabled on the terminal.

<Sysname>

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

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

3.1.20  shutdown-interval

Syntax

shutdown-interval time

View

System view

Parameters

time: Detection interval in seconds, in the range of 1 to 300.

Description

Use the shutdown-interval command to set a detection interval.

By default, the detection interval is 30 seconds.

Note that:

l           If a protocol module such as the operation, administration and maintenance (OAM) module detects an exception on a port (for example, signal loss of the link on the peer end), the port will be closed automatically, without execution of the shutdown command. You can set the automatic recovery time of the port by using the shutdown-interval command.

l           The shutdown-interval command helps you to dynamically set a detection interval to cooperate with the OAM module.

l           If you change the detection interval to T1 during interface detection, the interval from when you change the interval to the time when detection starts is T. If T<T1, the interface which is down will be brought up after T1-T time; if T>=T1, the interface which is down will be brought up immediately.

Examples

# Set the detection interval to 100 seconds.

<Sysname> system-view

[Sysname] shutdown-interval 100