Академический Документы
Профессиональный Документы
Культура Документы
Fundamentals
Command Reference
Abstract
This document describes the commands and command syntax options available for the HP 5820X &
5800 Series products.
This document is intended for network planners, field technical support and servicing engineers, and
network administrators who work with HP 5820X & 5800 Series products.
Contents
CLI configuration commands 1
command-alias enable 1
command-alias mapping 1
command-privilege 2
display clipboard 3
display command-alias 4
display history-command 4
display hotkey 5
hotkey 7
quit 9
return 9
screen-length disable 10
super 10
super authentication-mode 11
super password 12
system-view 13
shell 45
speed (user interface view) 45
stopbits 46
telnet 47
telnet client source 48
telnet ipv6 49
telnet server enable 49
terminal type 50
user privilege level 51
user-interface 52
iv
Index 202
vii
Syntax
command-alias enable
undo command-alias enable
View
System view
Default level
2: System level
Parameters
None
Examples
1.
2.
command-alias mapping
Description
Use command-alias mapping to configure command aliases.
Use undo command-alias mapping to restore the original configuration. By default, a command has no
alias.
Syntax
command-alias mapping cmdkey alias
undo command-alias mapping cmdkey
View
System view
1
Default level
2: System level
Parameters
cmdkey: The complete form of the first keyword of a command.
alias: Specifies the command alias, which cannot be the same as the first keyword of an existing
command.
Examples
1.
Configure command aliases by specifying show as the replacement of the display keyword.
<Sysname> system-view
[Sysname] command-alias mapping display show
After you configure the command aliases, the display commands have aliases. For example, if the
original command is display clock, now its alias is show clock and you can input the alias to view the
system time and date.
2.
Delete the command aliases by canceling the replacement of the display keyword.
<Sysname> system-view
[Sysname] undo command-alias mapping display
command-privilege
Description
Use command-privilege to change the command privilege level in the specified view. Command levels
include four privileges: visit (0), monitor (1), system (2), and manage (3).
By default, each command in a view has a specified privilege level. Changes can cause maintenance,
operation, and security problems. HP recommends that you use the default command level or that you
modify the command level under the guidance of professional staff.
Assign a privilege level according to the users need. When logging in to the switch, the user can access
the assigned level and all levels below it.
The command specified in command-privilege must be complete and have valid arguments. For
example, the default level of the tftp server-address { get | put | sget } source-filename [ destinationfilename ] [ source { interface interface-type interface-number | ip source-ip-address } ] command is
3. After command-privilege level 0 view shell tftp 1.1.1.1 put a.cfg is executed, users with privilege
level 0 log in to the switch, and can execute the tftp server-address put source-filename command
(such as tftp 192.168.1.26 put syslog.txt). They cannot execute the command with the get, sget or
source keyword, and cannot specify the destination-filename argument.
The command specified in undo command-privilege view can be incomplete. For example, after
undo command-privilege view system ftp is executed, all commands starting with the keyword ftp
(such as ftp server acl, ftp server enable, and ftp timeout) are restored to their default levels. If you
have modified the level of ftp server enable and ftp timeout and you want to restore only ftp server
enable to its default level, use undo command-privilege view system ftp server.
If you modify the command level of in a specified view from the default level to a lower level, modify
the command levels of the quit command and the corresponding command that is used to enter this
view. For example, the default command level of interface and system-view is 2 (system level). If you
want to make the interface command available to the level 1 users, execute the following three
commands: command-privilege level 1 view shell system-view, command-privilege level 1
view system interface GigabitEthernet 1/0/1, and command-privilege level 1 view system quit. The
2
level 1 users can enter system view, execute the interface GigabitEthernet command, and return to
user view.
Syntax
command-privilege level level view view command
undo command-privilege view view command
View
System view
Default level
3: Manage level
Parameters
level level: Command level, which ranges from 0 to 3.
view view: Specifies a view. The value represents a user view. The view argument must be the view where
the command resides.
command: Command to be set in the specified view.
Example
# Set the command level of the system-view command to 3 in system view. (By default, level 2 and level
3 users can use the system-view command. After the configuration, only level 3 users can use this
command.)
<Sysname> system-view
[Sysname] command-privilege level 3 view shell system-view
display clipboard
Description
Use display clipboard to view the contents of the clipboard.
To copy content to the clipboard:
Move the cursor to the starting position of the content and press Esc+Shift+,.
Move the cursor to the ending position of the content and press Esc+Shift+..
Syntax
display clipboard [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see CLI configuration.
3
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, which is a case-sensitive string of 1 to 256 characters.
Example
# View the content of the clipboard.
<Sysname> display clipboard
---------------- CLIPBOARD----------------display current-configuration
display command-alias
Description
Use display command-alias to display defined command aliases and their corresponding commands.
Syntax
display command-alias [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see CLI configuration.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display the defined command aliases and the corresponding commands.
<Sysname> display command-alias
Command alias is enabled
index
alias
command key
show
display
display history-command
Description
Use display history-command to display commands saved in the history command buffer.
By default, the system saves the last 10 executed commands. To set the buffer size, use the historycommand max-size command. For more information, see Logging in to the switch commands.
Syntax
display history-command [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see CLI configuration.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display history commands in current user view.
<Sysname> display history-command
display history-command
system-view
vlan 2
quit
display hotkey
Description
Use display hotkey to display hotkey information.
Syntax
display hotkey [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see "CLI configuration.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
5
Example
# Display hotkey information.
<Sysname> display hotkey
----------------- HOTKEY -----------------
=Defined hotkeys=
Hotkeys Command
CTRL_G
display current-configuration
CTRL_L
display ip routing-table
CTRL_O
=Undefined hotkeys=
Hotkeys Command
CTRL_T
NULL
CTRL_U
NULL
=System hotkeys=
Hotkeys Function
CTRL_A
CTRL_B
CTRL_C
CTRL_D
CTRL_E
CTRL_F
CTRL_H
CTRL_K
CTRL_N
CTRL_P
CTRL_R
CTRL_V
CTRL_W
CTRL_X
CTRL_Y
CTRL_Z
CTRL_]
ESC_B
ESC_D
ESC_F
ESC_N
ESC_P
ESC_<
ESC_>
hotkey
Description
Use hotkey to associate a hot key to a command.
Use undo hotkey to remove the association. By default, Ctrl+G, Ctrl+L, and Ctrl+O are associated with
these commands:
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
Default level
2: System level
Parameters
CTRL_G: Associates hot key Ctrl+G to a command.
CTRL_L: Associates hot key Ctrl+L to a command.
CTRL_O: Associates hot key Ctrl+O to a command.
CTRL_T: Associates hot key Ctrl+T to a command.
CTRL_U: Associates hot key Ctrl+U to a command.
command: The command line associated with the hot key.
Examples
1.
Associate the hot key Ctrl+T to the display tcp status command.
<Sysname> system-view
[Sysname] hotkey ctrl_t display tcp status
2.
Display hotkeys.
[Sysname] display hotkey
----------------- HOTKEY ----------------=Defined hotkeys=
Hotkeys Command
CTRL_G
display current-configuration
CTRL_L
display ip routing-table
CTRL_O
CTRL_T
Hotkeys Command
CTRL_U
NULL
=System hotkeys=
Hotkeys Function
CTRL_A
CTRL_B
CTRL_C
CTRL_D
CTRL_E
CTRL_F
CTRL_H
CTRL_K
CTRL_N
CTRL_P
CTRL_R
CTRL_V
CTRL_W
CTRL_X
CTRL_Y
CTRL_Z
CTRL_]
ESC_B
ESC_D
ESC_F
ESC_N
ESC_P
ESC_<
ESC_>
quit
Description
Use quit to return to a lower-level view.
In user view, quit terminates the connection and reconnects to the switch.
Syntax
quit
View
Any view
Default level
0: Visit level (in user view)
2: System level (in other views)
Parameters
None
Example
# Switch from GigabitEthernet 1/0/1 interface view to system view, and then to user view.
[Sysname-GigabitEthernet1/0/1] quit
[Sysname] quit
<Sysname>
return
Description
Use return to go back into user view, which can also be done with the hot key Ctrl+Z.
Related commands: quit.
Syntax
return
View
Any view except user view
Default level
2: System level
Parameters
None
Example
# Return to user view from GigabitEthernet 1/0/1 view.
[Sysname-GigabitEthernet1/0/1] return
<Sysname>
screen-length disable
Description
Use screen-length disable to disable the multiple-screen output function.
Use undo screen-length disable to enable the multiple-screen output function.
The default settings of the screen-length command are: multiple-screen output enabled and 24 lines
displayed on the next screen. For more information about screen-length, see Logging in to the switch
commands.
When the user logs out, the settings restore to their default values.
Syntax
screen-length disable
undo screen-length disable
View
User view
Default level
1: Monitor level
Parameters
None
Example
# Disable multiple-screen output for the current user.
<Sysname> screen-length disable
super
Description
Use super to switch user privilege levels.
If no level is specified, the command switches the user privilege level to 3. Command levels include four
privileges: visit (0), monitor (1), system (2), and manage (3). Assign privilege level according to the users
need. When logging in to the switch, the user can access the assigned level and all levels below it.
10
A user can switch to a lower privilege level unconditionally. To switch to a higher privilege level:
An AUX user can switch to a higher privilege level without entering any password.
A VTY user must input the switching password set by the super password command to switch to a
higher privilege level. If the password is incorrect or no password is configured, the switching
operation fails.
Syntax
super [ level ]
View
User view
Default level
0: Visit level
Parameter
level: User level, which ranges from 0 to 3 and defaults to 3.
Examples
1.
2.
Switch the user privilege level back to 3 (the switching password 123 has been set). If no
password is set, the user privilege 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
super authentication-mode
Description
Use super authentication-mode to set the authentication mode for user privilege level switch.
Use undo super authentication-mode to restore the default condition (authentication mode).
Related commands: super password.
Syntax
super authentication-mode { local | scheme } *
undo super authentication-mode
View
System view
11
Default level
2: System level
Parameters
local: Authenticates a user by using the local password set by the super password command. When no
password is set, two results can occur: the privilege level switch succeeds if the user is logged in through
the AUX user interface; the switch operation fails if the user logs in through a VTY user interface. If the
user enters the incorrect password, the switch operation fails.
scheme: AAA authentication. For more information about AAA, see the Security Configuration Guide.
local scheme: First local and then scheme, which authenticates a user by using the local password first. If
no password is set, the user logged in through the AUX user interface can switch the privilege level; other
users need to pass AAA authentication before they can switch the privilege level.
scheme local: First scheme and then local, which authenticates a user by performing the AAA
authentication first. If the AAA configuration is invalid (the domain parameters or authentication scheme
are not configured) or the server does not respond, the local password authentication is performed.
Examples
1.
Set the authentication mode for the user privilege level switch to local.
<Sysname> system-view
[Sysname] super authentication-mode local
2.
Set the authentication mode for the user privilege level switch to scheme local.
<Sysname> system-view
[Sysname] super authentication-mode scheme local
super password
Description
Use super password to set the password used to switch user privilege to a higher level.
Use the cipher parameter to set a cipher-text password. A cipher-text password is recommended.
During authentication, you must input a cipher-text password regardless of the password type you set.
Use undo super password to restore the default condition (no password is set).
Syntax
super password [ level user-level ] { simple | cipher } password
undo super password [ level user-level ]
View
System view
Default level
2: System level
Parameters
level user-level: User privilege level, which ranges from 1 to 3 and defaults to 3.
Examples
1.
2.
3.
system-view
Description
Use system-view to enter system view from the user view.
Related commands: quit, return.
Syntax
system-view
View
User view
Default level
2: System level
Parameters
None
13
Example
# Enter system view from the user view.
<Sysname> system-view
System View: return to User View with Ctrl+Z.
[Sysname]
14
If no ACL is referenced in VTY user interface view, the VTY user interface has no access control over
establishing a Telnet or SSH connection.
If an ACL is referenced in VTY user interface view, the connection is permitted only when packets
establishing a Telnet or SSH connection match a permit statement in the ACL.
The system regards the basic/advanced ACL with the inbound keyword, the basic/advanced ACL
with the outbound keyword, Ethernet frame header ACL as four different types of ACLs, which can
coexist in one VTY user interface.
The match order is basic/advanced ACL, Ethernet frame header ACL. At most one ACL of each type
can be referenced in the same VTY user interface, and the last configured one takes effect.
Use undo acl to cancel the ACL application. For more information about ACL, see the ACL and QoS
Configuration Guide. By default, access to the VTY user interface is not restricted.
Syntax
View
VTY user interface view
Default level
2: System level
Parameters
ipv6: When this keyword is present, the command supports IPv6; otherwise, it supports IPv4.
acl-number: Number of the ACL. The value range varies with devices:
inbound: Restricts Telnet or SSH connections established in the inbound direction through the VTY user
interface. If the received packets for establishing a Telnet or SSH connection are permitted by an ACL rule,
15
the connection is allowed to be established. When the device functions as a Telnet server or SSH server,
this keyword is used to control access of Telnet clients or SSH clients.
outbound: Restricts Telnet connections established in the outbound direction through the VTY user
interface. If the packets sent for establishing a Telnet connection are permitted by an ACL rule, the
connection is allowed to be established. When the device functions as a Telnet client, this keyword is
used to define Telnet servers accessible to the client.
Example
# Allow only the user with the IP address of 192.168.1.26 to access the device through Telnet or SSH.
<Sysname> system-view
[Sysname] acl number 2001
[Sysname-acl-basic-2001] rule permit source 192.168.1.26 0
[Sysname-acl-basic-2001] quit
[Sysname] user-interface vty 0
[Sysname-ui-vty0] acl 2001 inbound
With this configuration, user A (with IP address 192.168.1.26) can Telnet to the device but user B (with IP
address 192.168.1.60) cannot. If a connection failure occurs, the "%connection closed by remote
host!" message will appear.
activation-key
Description
Use activation-key to define a shortcut key for starting a terminal session.
To display the shortcut key you have defined, use the display current-configuration| include
activation-key command.
If a new shortcut key is defined with the activation-key command, the Enter key no longer functions.
Use undo activation-key to restore the default. By default, pressing the Enter key starts a terminal session.
Syntax
activation-key character
undo activation-key
View
User interface view
Default level
3: Manage level
16
Parameters
character: Shortcut key for starting a terminal session, a single character (or its ASCII code value that
ranges from 0 to 127) or a string of one to three characters. Only the first character functions as the
shortcut key. For example, if you input an ASCII code value of 97, the system uses its character a as the
shortcut key. If you input string b@c, the system uses the first character b as the shortcut key.
Examples
1.
Configure character s as the shortcut key for starting a terminal session on the console port.
<Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] activation-key s
3.
******************************************************************************
4.
At this moment, pressing Enter does not start a session. To start the terminal session, enter s.
<Sysname>
%Mar
auto-execute command
Description
CAUTION:
Applying auto-execute command to the user interface may disable you from configuring the system.
Before configuring the command and saving the configuration (by using the save command), make
sure that you can access the device through VTY and AUX interfaces to remove the configuration when
a problem occurs.
auto-execute command is not supported by the console port.
Use auto-execute command to specify a command automatically executed when a user logs in to the
current user interface.
The system automatically executes the command when a user logs in to the user interface, and tears
down the user connection after the command is executed.
17
If the command triggers another task, the system does not tear down the user connection until the
task is completed.
Use undo auto-execute command to remove the configuration. By default, command auto-execution is
disabled.
Syntax
auto-execute command command
undo auto-execute command
View
User interface view
Default level
3: Manage level
Parameter
command: Specifies a command to be automatically executed.
Examples
1.
Configure the device to automatically Telnet to 192.168.1.41 after a user logs in to interface VTY
0.
<Sysname> system-view
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] auto-execute command telnet 192.168.1.41
% This action will lead to configuration failure through ui-vty0. Are you
sure?
[Y/N]:y
[Sysname-ui-vty0]
2.
****************************************************************************
18
<Sysname>
Trying 192.168.1.41 ...
Press CTRL+K to abort
Connected to 192.168.1.41 ...
****************************************************************************
* Copyright (c) 2010-2011 Hewlett-Packard Development Company, L.P.
****************************************************************************
<Sysname.41>
This operation is the same as directly logging in to the device at 192.168.1.41. If the Telnet
connection to 192.168.1.41 breaks down, the Telnet connection to 192.168.1.40 breaks down at the
same time.
authentication-mode
Description
Use authentication-mode to set the authentication mode for the user interface.
Use undo authentication-mode to restore:
Syntax
authentication-mode { none | password | scheme }
undo authentication-mode
View
User interface view
Default level
3: Manage level
Parameters
none: Performs no authentication.
password: Performs local password authentication.
scheme: Performs AAA authentication. For more information about AAA, see the Security Configuration
Guide.
19
Examples
1.
Specify that no authentication is needed when users log in to the device through VTY 0. This mode
is insecure.
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] authentication-mode none
2.
Use password authentication when users log in to the device through VTY 0, and set the
authentication password to 321.
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] authentication-mode password
[Sysname-ui-vty0] set authentication password cipher 321
3.
Authenticate users by username and password when users log in to the device through VTY 0. Set
the username to 123 and the password to 321.
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] authentication-mode scheme
[Sysname-ui-vty0] quit
[Sysname] local-user 123
[Sysname-luser-123] password cipher 321
[Sysname-luser-123] service-type telnet
[Sysname-luser-123] authorization-attribute level 3
command accounting
Description
Use command accounting to enable command accounting.
When command accounting is enabled and command authorization is not, every executed
command is recorded on the HWTACACS server.
When both command accounting and command authorization are enabled, only the authorized and
executed commands are recorded on the HWTACACS server.
Use undo command accounting to restore the default (command accounting disabled). The accounting
server does not record the commands that users have executed.
Syntax
command accounting
undo command accounting
View
User interface view
Default level
3: Manage level
Parameters
None
20
Example
# Enable command accounting on VTY 0. The HWTACACS server records the commands executed by
users that have logged in through VTY 0.
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] command accounting
command authorization
Description
Use command authorization to enable command authorization. When enabled, users can only perform
commands authorized by the server.
Use undo command authorization to restore the default (command authorization disabled). Logged-in
users can execute commands without authorization.
Syntax
command authorization
undo command authorization
View
User interface view
Default level
3: Manage level
Parameters
None
Example
# Enable command accounting for VTY 0 so that users logging in from VTY 0 can perform only the
commands authorized by the HWTACACS server.
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] command authorization
databits
Description
This command only applies to the console port.
Use databits to set data bits for each character. The data bits setting must be the same for the user
interface of the connecting port on the device and the terminal device for communication.
Use undo databits to restore the default (8 data bits per character).
Syntax
databits { 5 | 6 | 7 | 8 }
undo databits
21
View
User interface view
Default level
2: System level
Parameters
5: Sets 5 data bits for each character.
6: Sets 6 data bits for each character.
7: Sets 7 data bits for each character.
8: Sets 8 data bits for each character.
Example
# Specify 5 data bits for each character.
<Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] databits 5
display ip http
Description
Use display ip http to display HTTP information.
Syntax
display ip http [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see CLI configuration.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display information about HTTP.
<Sysname> display ip http
HTTP port: 80
Basic ACL: 2222
Current connection: 0
22
Description
HTTP port
Basic ACL
Current connection
Operation status
display ip https
Description
Use display ip https to display information about HTTPS.
Syntax
display ip https [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see CLI configuration.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
23
Example
# Display information about HTTPS.
<Sysname> display ip https
HTTPS port: 443
SSL server policy: test
Certificate access-control-policy:
Basic ACL: 2222
Current connection: 0
Operation status: Running
Description
HTTPS port
Certificate access-control-policy
Basic ACL
Current connection
Operation status
Syntax
display telnet client configuration [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
24
Example
# Display the configuration of the device when it serves as a Telnet client.
<Sysname> display telnet client configuration
The source IP address is 1.1.1.1.
The output shows that when the device serves as a client, the source IPv4 address for sending Telnet
packets is 1.1.1.1.
display user-interface
Description
Use display user-interface to display information about a specific interface or all user interfaces.
If the summary parameter is included, the command displays all user interface numbers and types.
If the summary parameter is not included, the command displays the type of the user interface, the
absolute or relative number, the transmission rate, the user privilege level, the authentication mode,
and the access port.
Syntax
display user-interface [ num1 | { aux | vty } num2 ] [ summary ] [ | { begin | exclude | include }
regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
num1: Absolute number of a user interface. The value range varies with devices.
aux: Specifies the AUX user interface.
vty: Specifies the VTY user interface.
num2: Relative number of a user interface. It ranges from 0 to 9 for an AUX user interface and 0 to 15 for
a VTY user interface.
summary: Displays summary about user interfaces.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see CLI configuration.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
25
Examples
1.
Type
+ 29
Tx/Rx
VTY 0
Int
Idx
Description
Idx
Type
Tx/Rx
Modem
Privi
Whether the modem is allowed to dial in (in), dial out (out), or both (inout).
By default, the hyphen (-) is displayed to indicate that this function is disabled.
Indicates the command level of a user under that user interface.
Authentication mode for the users:
Auth
AAAA authentication.
PPassword authentication.
LLocal authentication.
NNone authentication.
Int
26
2.
(U)
(X)
1 total UI in use
Description
0:X
(U)
(X)
display users
Description
Use display users to display information about the interfaces that are active.
Use display users all to display information about all interfaces supported by the device.
Syntax
display users [ all ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
all: Displays information about all user interfaces that the device supports.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see CLI configuration.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
27
Example
# Display information about the user interfaces that are being used.
<Sysname> display users
The user application information of the user interface(s):
Idx UI
+ 29
VTY 0
Delay
Type Userlevel
00:00:00 TEL
:
Location: 192.168.0.5
Description
Idx
UI
Relative number of the user interface. For example, with VTY, the first column
represents user interface type, and the second column represents the relative number
of the user interface.
Delay
Time elapsed since the user's last input, in the format of hh:mm:ss.
Type
Userlevel
User level: 0 for visit, 1 for monitor, 2 for system, and 3 for manage.
Current user.
Location
Syntax
display web users [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
28
Parameter
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see "CLI configuration.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display information about the current web users.
<Sysname> display web users
UserID
Name
Language
Level
State
ab890000
admin
Chinese
Management Enable
14:13:46
14:14:18
Description
UserID
ID of a web user.
Name
Language
Level
State
LinkCount
LoginTime
LastTime
escape-key
Description
Use escape-key to define a shortcut key for aborting a task. The new shortcut key functions to terminate a
task.
If you set the character parameter in a user interface of a device to log in to the device and then Telnet to
another device, the character argument can only be used as a control character to abort a task (not for
input as a common character). This can cause problems, which you can avoid by specifying character as
a key combination rather than as a single character.
For example, in a VTY 0 user interface, if you specify character as e on Device A and log in to Device A
on a PC (Hyper Terminal):
The problem does not occur on Device A. Enter e as a common character on the A, and also use e
to terminate the task running on Device A.
The problem occurs if you Telnet from Device A to Device B. On Device B, you can only use e to
terminate the task running on Device B. You cannot input e as a common character (as part of
another command, for example) To avoid this, specify character as a key combination.
To display the shortcut key you have defined, use the display current-configuration command.
Syntax
escape-key { default | character }
undo escape-key
View
User interface view
Default level
3: Manage level
Parameters
character: Specifies the shortcut key for aborting a task, a single character (or its ASCII code value in the
range 0 to 127), or a string of 1 to 3 characters. Only the first character of a string functions as the
shortcut key. If you enter an ASCII code value of 113, the system uses its character q as the shortcut key. If
you enter the string q@c, the system uses the first character q as the shortcut key.
default: Restores the default escape key combination of Ctrl+C.
Examples
# Define key a as the shortcut key for aborting a task.
<Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] escape-key a
Use the ping command to check the reachability of the device with the IP address of
192.168.1.49, and use the -c keyword to specify the number of ICMP echo packets to be
sent as 20.
<Sysname> ping -c 20 192.168.1.49
PING 192.168.1.49: 56
2.
Enter a. The task terminates immediately and the system returns to system view.
--- 192.168.1.49 ping statistics --2 packet(s) transmitted
2 packet(s) received
0.00% packet loss
round-trip min/avg/max = 3/3/3 ms
<Sysname>
30
flow-control
Description
Use flow-control to configure the flow control mode.
Use undo flow-control to restore the default (none is the default flow control mode). No flow control is
performed.
Syntax
flow-control { hardware | none | software }
View
User interface view
Default level
2: System level
Parameters
hardware: Performs hardware flow control.
none: Disables flow control.
software: Performs software flow control.
Example
# Configure no flow control in the inbound and outbound directions for AUX 0.
<Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] flow-control none
free user-interface
Description
This command cannot release the connection that you are using.
Use free user-interface to release the established connection.
Syntax
free user-interface { num1 | { aux | vty } num2 }
View
User view
Default level
3: Manage level
31
Parameters
num1: Absolute number of a user interface. The value range varies with devices.
aux: Specifies the AUX user interface.
vty: Specifies the VTY user interface.
num2: Relative number of a user interface. The value ranges from 0 to 9 for an AUX user interface and 0
to 15 for a VTY user interface.
Examples
1.
VTY 0
Delay
Type Userlevel
00:00:00 TEL
:
Location: 192.168.0.5
2.
You can display information about the users that are using the device.
<Sysname> free user-interface vty 1
Are you sure to free user-interface vty1? [Y/N]:y
3.
To make configurations without interruption from the user using VTY 1, you can release the
connection established on VTY 1.
free web-users
Description
Use free web-users to disconnect a specific web user or all web users by force.
Syntax
free web-users { all | user-id userid | user-name username }
View
User view
Default level
2: System level
Parameter
userid: Web user ID.
username: User name of the web user. This argument can contain 1 to 80 characters.
all: Specifies all web users.
32
Example
# Disconnect all web users by force.
<Sysname> free web-users all
history-command max-size
Description
Use history-command max-size to set the size of the history command buffer for the current user interface.
The history command buffer saves executed history commands for each user interface.
Buffers for different user interfaces do not affect each other.
To display the commands that are stored in the history buffer, use display history.
To view the recently executed commands, press the upper or lower arrow key. For more information
about display history-command, see CLI configuration commands.
After you terminate the current session, the system automatically removes the commands saved in the
history buffer.
Use undo history-command max-size to restore the default (10 commands saved).
Syntax
history-command max-size size-value
undo history-command max-size
View
User interface view
Default level
2: System level
Parameters
size-value: Specifies the maximum number of history commands that the buffer can store. The value
ranges from 0 to 256.
Example
# Set the buffer to store a maximum of 20 history commands.
<Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] history-command max-size 20
33
idle-timeout
Description
Use idle-timeout to set the idle-timeout timer.
Setting idle-timeout to 0 disables the timer and maintains the connection until you terminate it.
If no information interaction occurs between the device and the user within the timeout time, the
system automatically terminates the connection.
Syntax
idle-timeout minutes [ seconds ]
undo idle-timeout
View
User interface view
Default level
2: System level
Parameters
minutes: Specifies the timeout time, in minutes, which ranges from 0 to 35791 and defaults to 10 minutes.
seconds: Specifies the timeout time, in seconds, which ranges from 0 to 59 and defaults to 0 seconds.
Example
# Set the idle-timeout timer to 1 minute and 30 seconds.
<Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] idle-timeout 1 30
ip http acl
Description
Use ip http acl to associate an ACL with the HTTP service. After the HTTP service is associated with an
ACL, only the clients permitted by the ACL can access the device through HTTP.
Use undo ip http acl to remove the association and restore the default condition (HTTP service is not
associated with any ACL by default).
Related commands: display ip http; acl (see ACL and QoS Command Reference).
Syntax
ip http acl acl-number
undo ip http acl
View
System view
34
Default level
2: System level
Parameters
acl-number: ACL number. A basic IPv4 ACL ranges from 2000 to 2999.
Example
# Associate the HTTP service with ACL 2001 to only allow the clients within the 10.10.0.0/16 network to
access the device through HTTP.
<Sysname> system-view
[Sysname] acl number 2001
[Sysname-acl-basic-2001] rule permit source 10.10.0.0 0.0.255.255
[Sysname-acl-basic-2001] quit
[Sysname] ip http acl 2001
ip http enable
Description
Use ip http enable to enable the HTTP service. The device can act as the HTTP server when enabled.
Use undo ip http enable to disable the HTTP service.
Related commands: display ip http.
Syntax
ip http enable
undo ip http enable
View
System view
Default level
2: System level
Parameters
None
Example
# Enable the HTTP service.
<Sysname> system-view
[Sysname] ip http enable
ip http port
Description
Verify that the port number is not used by another service. This command does not check for conflicts with
configured port numbers.
Use ip http port to configure the port number of the HTTP service.
35
Use undo ip http port to restore the default port number (80 is the default port).
Related commands: display ip http.
Syntax
ip http port port-number
undo ip http port
View
System view
Default level
3: Manage level
Parameter
port-number: Port number of the HTTP service, which ranges from 1 to 65535.
Example
# Configure the port number of the HTTP service as 8080.
<Sysname> system-view
[Sysname] ip http port 8080
ip https acl
Description
Use ip https acl to associate HTTPS service with an ACL. After this association, only clients permitted by
the ACL rules can access the device.
Use undo ip https acl to remove the association and restore the default condition (no association is the
default).
Related commands: display ip https; acl (ACL and QoS Command Reference).
Syntax
ip https acl acl-number
undo ip https acl
View
System view
Default level
3: Manage level
Parameter
acl-number: ACL number. A basic IPv4 ACL ranges from 2000 to 2999. The value range depends on the
device model.
Example
# Associate the HTTPS service with ACL 2001 to only allow the clients in the 10.10.0.0/16 network
segment to access the HTTPS server through HTTP.
<Sysname> system-view
36
Syntax
ip https certificate access-control-policy policy-name
undo ip https certificate access-control-policy
View
System view
Default level
3: Manage level
Parameter
policy-name: Name of the certificate attribute access control policy, a string of 1 to 16 characters.
Example
# Associate the HTTPS server with certificate attribute access control policy myacl.
<Sysname> system-view
[Sysname] ip https certificate access-control-policy myacl
37
ip https enable
Description
Use ip https enable to enable the HTTPS service. The device can act as the HTTP server if enabled.
Enabling the HTTPS service triggers an SSL handshake negotiation process.
If the local certificate of the device exists, the SSL negotiation succeeds and the HTTPS service can
be started.
If no local certificate exists, the SSL negotiation triggers a certificate application process that often
fails because it times out. If that happens, execute the ip https enable command multiple times to
start the HTTPS service.
Use undo ip https enable to disable the HTTPS service (the default condition).
Related commands: display ip https.
Syntax
ip https enable
undo ip https enable
View
System view
Default level
3: Manage level
Parameters
None
Example
# Enable the HTTPS service.
<Sysname> system-view
[Sysname] ip https enable
ip https port
Description
Verify that the port number is not used by another service. This command does not check for conflicts with
configured port numbers.
Use ip https port to configure the port number of the HTTPS service.
Use undo ip https port to restore the default port number (443 is the default port).
Related commands: display ip https.
Syntax
ip https port port-number
undo ip https port
38
View
System view
Default level
3: Manage level
Parameter
port-number: Port number of the HTTPS service, which ranges from 1 to 65535.
Example
# Configure the port number of the HTTPS service as 6000.
<Sysname> system-view
[Sysname] ip https port 6000
ip https ssl-server-policy
Description
Use ip https ssl-server-policy to associate the HTTPS service with an SSL server-end policy.
Use undo ip https ssl-server-policy to remove the association and restore the default condition (no
association).
The HTTPS service can be enabled only after this command is configured. After the HTTPS service is
enabled, you cannot:
Remove the association between the HTTPS service and the SSL server-end policy.
Syntax
ip https ssl-server-policy policy-name
undo ip https ssl-server-policy
View
System view
Default level
3: Manage level
Parameter
policy-name: Name of an SSL server policy, a string of 1 to 16 characters.
Example
# Associate the HTTPS service with SSL server-end policy myssl.
<Sysname> system-view
[Sysname] ip https ssl-server-policy myssl
39
lock
Description
Use lock to prevent unauthorized users from using the user interface.
After locking the user interface, the next time you access it, you must press Enter and enter the
correct password.
Syntax
lock
View
User view
Default level
3: Manage level
Parameters
None
Example
# Lock the current user interface.
<Sysname> lock
Please input password<1 to 16> to lock current user terminal interface:
Password:
Again:
locked !
Password:
<Sysname>
parity
Description
This command only applies to the console port.
Use parity to set a parity check method. This setting must be identical for the user interface of the
connecting port on the device and the target terminal device.
Use undo parity to restore the default (no parity check performed).
Syntax
parity { even | mark | none | odd | space }
undo parity
40
View
User interface view
Default level
2: System level
Parameters
even: Performs an even parity check.
mark: Performs a mark parity check.
none: Performs no parity check.
odd: Performs an odd parity check.
space: Performs a space parity check.
Example
# Configure the console port to perform odd parity check.
<Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] parity odd
protocol inbound
Description
Use protocol inbound to enable the user interface to support Telnet, SSH, or both. The configuration is
effective next time you log in.
Before configuring a user interface to support SSH, set the authentication mode to scheme for users
logging in through the user interface. Otherwise, protocol inbound ssh fails. For more information,
see authentication-mode.
By default:
Syntax
protocol inbound { all | ssh | telnet }
View
VTY interface view
Default level
3: Manage level
Parameters
all: Supports all three protocols: Telnet, SSH, and both.
ssh: Supports SSH only.
telnet: Supports Telnet only.
41
Example
# Enable the VTYs 0 through 15 to support SSH only.
<Sysname> system-view
[Sysname] user-interface vty 0 15
[Sysname-ui-vty0-15] authentication-mode scheme
[Sysname-ui-vty0-15] protocol inbound ssh
screen-length
Description
Not all display terminals support this command setting.
Use screen-length to set the number of lines on the next screen.
Because terminal display varies, you may need to press the Space, Page Up, or Page Down key to display
additional lines of information. For example, if you set screen-length to 40, but the terminal screen can
display only 24 lines: When you press Space, the device sends 40 lines, but the next screen displays only
lines 18 through 40. To view the first 17 lines, you must press the Page Up or Page Down key.
Use undo screen-length to restore the default next screen display (24 lines).
To disable multiple-screen output of the current user interface, use the screen-length disable command. For
more information about the screen-length disable command, see CLI configuration commands.
Syntax
screen-length screen-length
undo screen-length
View
User interface view
Default level
2: System level
Parameter
screen-length: Number of lines on the next screen, which ranges from 0 to 512. Setting a value of 0
disables pausing between screens of output.
Example
# Set the next screen of the AUX user interface to display 30 lines.
<Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] screen-length 30
42
send
Description
Use send to send messages to the specified user interfaces.
To end the message input, press Ctrl+Z. To cancel the message input and return to user view, press Ctrl+C.
Syntax
send { all | num1 | { aux | vty } num2 }
View
User view
Default level
1: Monitor level
Parameters
all: Sends messages to all user interfaces.
num1: Absolute number of a user interface. The value range varies with devices.
aux: Specifies the AUX user interface.
vty: Specifies the VTY user interface.
num2: Relative number of a user interface. The value ranges from 0 to 9 for an AUX user interface and 0
to 15 for a VTY user interface.
Example
# Send message hello abc to the AUX user interface.
<Sysname> send aux 0
Enter message, end with CTRL+Z or Enter; abort with CTRL+C:
hello abc^Z
Send message? [Y/N]:y
<Sysname>
***
***
***Message from aux0 to aux0
***
hello abc
<Sysname>
43
Syntax
set authentication password { cipher | simple } password
undo set authentication password
View
User interface view
Default level
3: Manage level
Parameters
cipher: Cipher-text password.
simple: Plain-text password.
password: A case-sensitive string. If the password format is simple, the password argument must be in
plain text, and the configuration file saves the password in plain text. If the format is cipher, password
can be either in cipher text or in plain text, and the configuration file always saves the password in cipher
text. A plain-text password can be a string of up to 16 characters. A cipher-text password or the
encrypted
version
of
the
plain-text
password
comprises
24
characters,
such
as
_(TT8F]Y\5SQ=^Q`MAF4<1!!.
Example
# Set the local authentication password for the user interface of console port 0 to hello.
<Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] authentication-mode password
[Sysname-ui-aux0] set authentication password cipher hello
44
shell
Description
The command is not applicable to the console port.
Use shell to enable terminal services on the user interface. By default, terminal services are enabled on all
user interfaces.
Use undo shell to disable terminal services. You cannot disable the terminal services on the user interface
through which you are logged in.
Syntax
shell
undo shell
View
User interface view
Default level
3: Manage level
Parameters
None
Examples
1.
2.
The following message appears when a terminal tries to Telnet to the device:
The connection was closed by the remote host!
Syntax
speed speed-value
undo speed
45
View
User interface view
Default level
2: System level
Parameters
speed-value: Transmission rate in bps.
The transmission rates available with asynchronous serial interfaces follow:
300 bps
600 bps
1200 bps
2400 bps
4800 bps
9600 bps
19200 bps
38400 bps
57600 bps
115200 bps
Example
# Set the transmission rate on the user interface AUX 0 to 19200 bps.
<Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] speed 19200
stopbits
Description
This command only applies to the console port.
Use stopbits to set the number of stop bits transmitted per byte. This setting must be identical for the user
interface of the connecting port on the device and the target device for communication.
Use undo stopbits to restore the default stop bit (1).
Syntax
stopbits { 1 | 1.5 | 2 }
undo stopbits
View
User interface view
Default level
2: System level
46
Parameters
1: One stop bit.
1.5: One and a half stop bits.
2: Two stop bits.
Example
# Set the stop bits on the user interface AUX 0 to 1.5.
<Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0] stopbits 1.5
telnet
Description
Use telnet to establish Telnet connection with a remote host. The source IPv4 address or source interface
specified by this command applies to the current Telnet connection only.
To stop the current Telnet connection, press Ctrl+K or use the quit command.
Syntax
telnet remote-host [ service-port ] [ vpn-instance vpn-instance-name ] [ source { interface interface-type
interface-number | ip ip-address } ]
View
User view
Default level
0: Visit level
Parameters
remote-host: IPv4 address or host name of a remote host, a case-insensitive string of 1 to 20 characters.
service-port: TCP port number of the Telnet service on the remote host. It ranges from 0 to 65535 and
defaults to 23.
vpn-instance vpn-instance-name: Specifies the MPLS L3VPN that the remote system belongs to, where vpninstance-name is a case-sensitive string of 1 to 31 characters. If the remote system is on the public network,
do not specify this keyword and argument combination.
source: Specifies the source interface or source IPv4 address of Telnet packets.
interface interface-type interface-number: Specifies the source interface. The source IPv4 address of the
Telnet packets that are sent is the IPv4 address of the specified source interface. interface-type interfacenumber represents the interface type and number, respectively.
ip ip-address: Specifies the source IPv4 address of Telnet packets.
Example
# Telnet to the remote host 1.1.1.2, specifying the source IP address of Telnet packets as 1.1.1.1.
<Sysname> telnet 1.1.1.2 source ip 1.1.1.1
47
Syntax
telnet client source { interface interface-type interface-number | ip ip-address }
undo telnet client source
View
System view
Default level
2: System level
Parameters
interface interface-type interface-number: Specifies the source interface. The source IPv4 address of the
Telnet packets sent is the IPv4 address of a specific interface. interface-type interface-number represents
the interface type and number, respectively.
ip ip-address: Specifies the source IPv4 address of Telnet packets.
Example
# Specify the source IPv4 address for sending Telnet packets when the device serves as a Telnet client as
1.1.1.1.
<Sysname> system-view
[Sysname] telnet client source ip 1.1.1.1
48
telnet ipv6
Description
Use telnet ipv6 to establish a Telnet connection to a remote host in an IPv6 network. To stop the current
Telnet connection, press Ctrl+K or use the quit command.
Syntax
telnet ipv6 remote-host [ -i interface-type interface-number ] [ port-number ] [ vpn-instance vpn-instancename ]
View
User view
Default level
0: Visit level
Parameters
remote-host: IP address or host name of a remote host, a case-insensitive string of 1 to 46 characters.
-i interface-type interface-number: Specifies the outbound interface for sending Telnet packets, where
interface-type interface-number represents the interface type and number. You need to provide the -i
interface-type interface-number argument if the destination address is a link-local address.
port-number: TCP port number for the remote host to provide the Telnet service. It ranges from 0 to 65535
and defaults to 23.
vpn-instance vpn-instance-name: Specifies the MPLS L3VPN that the remote system belongs to, where vpninstance-name is a case-sensitive string of 1 to 31 characters. If the remote system is on the public network,
do not specify this keyword and argument combination.
Example
# Telnet to the remote host with the IPv6 address 5000::1.
<Sysname> telnet ipv6 5000::1
Syntax
telnet server enable
undo telnet server enable
View
System view
Default level
3: Manage level
49
Parameters
None
Example
# Enable the Telnet server.
<Sysname> system-view
[Sysname] telnet server enable
terminal type
Description
The device supports two types of terminal display: ANSI and VT100. HP recommends you to set the
display type to VT100 on both the device and the client to avoid anomalies when the total number of
characters of the edited command line exceeds 80.
Use terminal type to configure the current user interfaces type of terminal display.
Use undo terminal type to restore the default (ANSI is the default).
Syntax
terminal type { ansi | vt100 }
undo terminal type
View
User interface view
Default level
2: System level
Parameters
ansi: Specifies the terminal display type as ANSI.
vt100: Specifies the terminal display type as VT100.
Example
# Set the terminal display type to VT100.
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] terminal type vt100
50
Syntax
user privilege level level
undo user privilege level
View
User interface view
Default level
3: Manage level
Parameter
level: Specifies a user privilege level, which ranges from 0 to 3. User privilege levels include visit (0),
monitor (1), system (2), and manage (3). The administrator can change the user privilege level as
necessary.
Examples
# Set the command level for users logging in through VTY 0 to 0.
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] user privilege level 0
# After you Telnet to the device through VTY 0, the terminal only displays commands of level 0 in the help
information:
<Sysname> ?
User view commands:
cluster
display
ping
Ping function
quit
ssh2
super
telnet
tracert
51
user-interface
Description
Use user-interface to enter a single or multiple user interface views.
In single user interface view, the configuration takes effect in the user view only.
In multiple user interface view, the configuration takes effect in these user views.
Syntax
user-interface { first-num1 [ last-num1 ] | { aux | vty } first-num2 [ last-num2 ] }
View
System view
Default level
2: System level
Parameters
first-num1: Absolute number of the first user interface. The value range varies with devices.
last-num1: Absolute number of the last user interface. The value range varies with devices.
VTY user interfaces: from 0 to 15, but cannot be smaller than first-num 2.
Examples
#Enter AUX user interface view.
<Sysname> system-view
[Sysname] user-interface aux 0
[Sysname-ui-aux0]
52
Syntax
display ftp-server [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
3: Manage level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display the FTP server configuration.
<Sysname> display ftp-server
FTP server is running
Max user number:
User count:
30
Put Method:
fast
Description
53
Field
Description
User count
Put Method
display ftp-user
Description
Use display ftp-user to display detailed information for current FTP users.
Syntax
display ftp-user [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
3: Manage level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display the detailed information of FTP users.
<Sysname> display ftp-user
UserName
HostIP
Port
Idle
HomeDir
ftp
192.168.1.54
1190
flash:
54
# If the name of the logged-in user exceeds 10 characters, the exceeded characters will appear in the
next line and be right justified. For example, if the logged-in user name is administrator, this is how
the information would appear:
<Sysname> display ftp-user
UserName
HostIP
Port
Idle
HomeDir
192.168.0.152
1031
flash:
administra
tor
Description
UserName
HostIP
Port
Idle
HomeDir
Syntax
free ftp user username
View
User view
Default level
3: Manage level
Parameter
username: Use the display ftp-user command to view the logged-in user name of the current FTP
connection.
Example
# Manually release the FTP connection established with username ftpuser.
<Sysname> free ftp user ftpuser
Are you sure to free FTP user ftpuser? [Y/N]:y
<Sysname>
55
When associated with an ACL, the FTP server denies incoming client requests and permits client
access allowed by the ACL rules.
This configuration has no effect on already established FTP connections and operations.
If you execute the command multiple times, the last specified ACL takes effect.
Use undo ftp server acl to restore the default (no ACL used is the default condition).
Syntax
ftp server acl acl-number
undo ftp server acl
View
System view
Default level
3: Manage level
Parameter
acl-number: Basic access control list (ACL) number, ranging from 2000 to 2999.
Example
# Associate the FTP service with ACL 2001 to allow only the client 1.1.1.1 to access the device through
FTP.
<Sysname> system-view
[Sysname] acl number 2001
[Sysname-acl-basic-2001] rule 0 permit source 1.1.1.1 0
[Sysname-acl-basic-2001] rule 1 deny source any
[Sysname-acl-basic-2001] quit
[Sysname] ftp server acl 2001
Syntax
ftp server enable
undo ftp server
View
System view
56
Default level
3: Manage level
Parameters
None
Example
# Enable the FTP server.
<Sysname> system-view
[Sysname] ftp server enable
ftp timeout
Description
Use ftp timeout to set the idle-timeout timer.
You can set the timer to disconnect the user connection to the FTP server if no information is received
or transmitted before the timer expires.
Use undo ftp timeout to restore the default (30 minutes of idle time is the default condition).
Syntax
ftp timeout minute
undo ftp timeout
View
System view
Default level
3: Manage level
Parameter
minute: Idle-timeout timer in minutes, in the range 1 to 35791.
Example
# Set the idle-timeout timer to 36 minutes.
<Sysname> system-view
[Sysname] ftp timeout 36
ftp update
Description
Use ftp update to set the file update mode the FTP server uses while receiving data.
Use undo ftp update to restore the default (normal mode is the default condition).
Syntax
ftp update { fast | normal }
undo ftp update
57
View
System view
Default level
3: Manage level
Parameters
fast: Fast update.
normal: Normal update.
Example
# Set the FTP update mode to normal.
<Sysname> system-view
[Sysname] ftp update normal
58
ascii
Description
FTP transfers files in two modes:
Use ascii to set the file transfer mode to ASCII (the default mode).
Because carriage return characters vary with operating systems, the FTP transmission mode must be
applied to ensure the correct resolution of the files. For example, to indicate the end of a line and
transfer to the next line, the HP device system and Windows system use characters /r/n, and the Linux
system uses characters /n.
Related commands: binary.
Syntax
ascii
View
FTP client view
Default level
3: Manage level
Parameters
None
Example
# Set the file transfer mode to ASCII.
[ftp] ascii
200 Type set to A.
binary
Description
Use binary to set the file transfer mode to binary (flow) mode.
59
Syntax
binary
View
FTP client view
Default level
3: Manage level
Parameters
None
Examples
# Set the file transfer mode to binary.
[ftp] binary
200 Type set to I.
bye
Description
Use bye to disconnect from the remote FTP server and return to user view. Use this command to return
to user view directly if no connection is established between the device and the remote server.
Related commands: close, disconnect, and quit.
Syntax
bye
View
FTP client view
Default level
3: Manage level
Parameters
None
Example
# Terminate the connection with the remote FTP server and return to user view.
[ftp] bye
221 Server closing.
60
cd
Description
Use cd to change the current working directory on the remote FTP server to access another authorized
directory.
Related commands: pwd.
Syntax
cd { directory | .. | / }
View
FTP client view
Default level
3: Manage level
Parameters
directory: Name of the target directory, in the format of [drive:][/]path, where drive represents the
storage medium name, typically flash or cf. If no drive information is provided, the argument
represents a folder or subfolder in the current directory. For more information about the drive and path
arguments, see the Fundamentals Configuration Guide.
..: Returns to an upper directory. The execution of the cd .. command equals the execution of the cdup
command. If the current working directory is the root directory, or no upper directory exists, the
current working directory does not change when the cd .. command is executed. This argument does
not support command line online help.
/: Returns to the root directory of the storage medium. The keyword does not support command line
online help.
Examples
# Change the working directory to the sub-directory logfile of the current directory.
[ftp] cd logfile
250 CWD command successful.
# Change the working directory to the sub-directory folder of the authorized directory.
[ftp] cd /folder
250 CWD command successful.
cdup
Description
Use cdup to exit the current directory and enter the upper directory of the FTP server.
Execution of this command will not change the authorized directory if it is work-directory.
Related commands: cd and pwd.
Syntax
cdup
61
View
FTP client view
Default level
3: Manage level
Parameters
None
Example
# Change the current working directory path to the upper directory.
[ftp] pwd
257 "/ftp/subdir" is current directory.
[ftp] cdup
200 CDUP command successful.
[ftp] pwd
257 "/ftp" is current directory.
close
Description
Use close to terminate connection to the FTP server, but remain in FTP client view.
This command is equal to the disconnect command.
Syntax
close
View
FTP client view
Default level
3: Manage level
Parameters
None
Example
# Terminate the connection to the FTP server and remain in FTP client view.
[ftp] close
221 Server closing.
[ftp]
62
debugging
Description
Use debugging to enable FTP client debugging.
Use undo debugging to disable FTP client debugging (disabled is the default condition).
Syntax
debugging
undo debugging
View
FTP client view
Default level
1: Monitor level
Parameters
None
Example
# The device serves as the FTP client. Enable FTP client debugging and use the active mode to
download file sample.file from the current directory of the FTP server.
<Sysname> terminal monitor
<Sysname> terminal debugging
<Sysname> ftp 192.168.1.46
Trying 192.168.1.46 ...
Press CTRL+K to abort
Connected to 192.168.1.46.
220 FTP service ready.
User(192.168.1.46:(none)):ftp
331 Password required for ftp.
Password:
230 User logged in.
[ftp]undo passive
FTP: passive is off
[ftp] debugging
FTP: debugging switch is on
63
[ftp]
Description
---> PORT
---> RETR
delete
Description
Use delete to permanently delete a file on the remote FTP server. You must have delete permission on
the remote server to use this command.
Syntax
delete remotefile
View
FTP client view
Default level
3: Manage level
Parameter
remotefile: File name.
64
Example
#Delete file temp.c.
[ftp] delete temp.c
250 DELE command successful.
dir
Description
The dir command displays names of files and directories, as well as related information, such as the
size, and the date they were created.
Compare to the Is command, which can only display the names of files and directories.
Use:
dir to view the detailed information of the files and subdirectories in the current directory on the
remote FTP server.
dir remotefile to display the detailed information of a specific file or directory on the remote FTP
server.
dir remotefile localfile to display the detailed information of a specific file or directory on the
remote FTP server, and save the displayed information into a local file specified by the localfile
argument.
Syntax
dir [ remotefile [ localfile ] ]
View
FTP client view
Default level
3: Manage level
Parameters
remotefile: Name of the file or directory on the remote FTP server.
localfile: Name of the local file to save the displayed information.
Examples
#View the detailed information of the files and subdirectories under the current directory on the
remote FTP server.
[ftp] dir
227 Entering Passive Mode (192,168,1,46,5,68).
125 ASCII mode data connection already open, transfer starting for /*.
drwxrwxrwx
1 noone
nogroup
0 Aug 08
2006 logfile
-rwxrwxrwx
1 noone
nogroup
-rwxrwxrwx
1 noone
nogroup
4001 Dec 08
2007 config.cfg
-rwxrwxrwx
1 noone
nogroup
3608 Jun 13
2007 startup.cfg
drwxrwxrwx
1 noone
nogroup
0 Dec 03
-rwxrwxrwx
1 noone
nogroup
299 Oct 15
2007 test
2007 key.pub
65
[ftp]
#View the information of the file ar-router.cfg, and save the result to aa.txt.
[ftp] dir ar-router.cfg aa.txt
227 Entering Passive Mode (192,168,1,50,17,158).
125 ASCII mode data connection already open, transfer starting for /arrouter.cfg.
....226 Transfer complete.
FTP: 67 byte(s) received in 4.600 second(s), 14.00 byte(s)/sec.
1 noone
nogroup
disconnect
Description
Use disconnect to disconnect from the remote FTP server but remain in FTP client view.
This command is equal to the close command.
Syntax
disconnect
View
FTP client view
Default level
3: Manage level
Parameters
None
Example
#Disconnect from the remote FTP server but remain in FTP client view.
[ftp] disconnect
221 Server closing.
Syntax
display ftp client configuration [ | { begin | exclude | include } regular-expression ]
66
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
#Display the current configuration information of the FTP client.
<Sysname> display ftp client configuration
The source IP address is 192.168.0.123
ftp
Description
This command applies to IPv4 networks.
Use ftp to log in to the remote FTP server and enter FTP client view.
Without parameters, you enter the FTP client view without logging in to the FTP server.
With parameters, you are prompted to enter the username and password for accessing the FTP
server.
Syntax
ftp [ server-address [ service-port ] [ vpn-instance vpn-instance-name ] [ source { interface interfacetype interface-number | ip source-ip-address } ] ]
View
User view
Default level
3: Manage level
Parameters
server-address: IP address or host name of a remote FTP server, a string of 1 to 20 characters.
service-port: TCP port number of the remote FTP server, in the range 0 to 65535. The default value is
21.
vpn-instance vpn-instance-name: FTP servers VPN. The vpn-instance-name argument specifies the
instance name of the VPN, a case-sensitive string of 1 to 63 characters.
67
interface interface-type interface-number: source interface by its type and number. The primary
IP address configured on this interface is the source address of the transmitted FTP packets. If no
primary IP address is configured on the source interface, the connection fails.
ip source-ip-address: The source IP address (configured on the device) of the transmitted FTP
packets.
Example
#Log in from the current device Sysname1 to the device Sysname2 with the IP address of
192.168.0.211. The source IP address of the packets sent is 192.168.0.212.
<Sysname> ftp 192.168.0.211 source ip 192.168.0.212
Trying 192.168.0.211 ...
Press CTRL+K to abort
Connected to 192.168.0.211.
220 FTP Server ready.
User(192.168.0.211:(none)):abc
331 Password required for abc
Password:
230 User logged in.
The source address can be specified as the source interface and the source IP address. If you
use ftp client source to specify the source interface and then the source IP address, the newly
specified source IP address overwrites the configured source interface and vice versa.
If the source address is specified with ftp client source and then with the ftp command, the
source address specified with the latter one is used to communicate with the FTP server.
The source address specified with ftp client source is valid for all FTP connections and the source
address specified with the ftp command is valid only for the current FTP connection.
Use undo ftp client source to restore the default. By default, a device uses the IP address of the
interface determined by the matched route as the source IP address to communicate with an FTP
server.
Related commands: display ftp client configuration.
Syntax
ftp client source { interface interface-type interface-number | ip source-ip-address }
undo ftp client source
View
System view
Default level
2: System level
68
Parameters
interface interface-type interface-number: Source interface for the FTP connection, including interface
type and interface number. The primary IP address configured on the source interface is the source IP
address of the packets sent by FTP. If no primary IP address is configured on the source interface, the
connection fails.
ip source-ip-address: Source IP address of the FTP connection. It must be an IP address that has been
configured on the device.
Examples
# Specify the source IP address of the FTP client as 2.2.2.2.
<Sysname> system-view
[Sysname] ftp client source ip 2.2.2.2
ftp ipv6
Description
This command applies to IPv6 networks.
Use ftp ipv6 to log in to the FTP server and enter FTP client view.
Without parameters, you enter the FTP client view without logging in to an FTP server.
With parameters, you are asked to enter the username and password for accessing the FTP
server.
Syntax
ftp ipv6 [ server-address [ service-port ] [ source ipv6 source-ipv6-address ] [ -i interface-type
interface-number ] ]
View
User view
Default level
3: Manage level
Parameters
server-address: IP address or host name of the remote FTP server.
service-port: TCP port number of the FTP server, in the range 0 to 65535. The default value is 21.
source ipv6 source-ipv6-address: Specifies a source IPv6 address for transmitted FTP packets. This
address must be an IPv6 address that has been configured on the device.
-i interface-type interface-number: Specifies the type and number of the egress interface. This
parameter can only be used when the FTP server address is a link local address and the specified
egress interface has a link local address. For the configuration of link local addresses, see the Layer
3IP Services Configuration Guide.
vpn-instance vpn-instance-name: Specifies the VPN that the FTP server belongs to. The vpn-instancename argument is a case-sensitive string of 1 to 31 characters.
69
Example
#Log in to the FTP server with IPv6 address 3000::200.
<Sysname> ftp ipv6 3000::200
Trying 3000::200 ...
Press CTRL+K to abort
Connected to 3000::200.
220 Welcome!
User(3000::200:(none)): MY_NAME
331 Please specify the password.
Password:
230 Login successful.
[ftp]
get
Description
Use get to download a file from a remote FTP server and save it.
Syntax
get remotefile [ localfile ]
View
FTP client view
Default level
3: Manage level
Parameters
remotefile: Name of the file to be downloaded.
localfile: File name used after a file is downloaded and saved locally. If this argument is not specified,
the local file uses the name of the source file on the FTP server by default.
Examples
# Download file testcfg.cfg and save it as aa.cfg.
[ftp] get testcfg.cfg aa.cfg
70
# Download file testcfg.cfg to the root directory of the storage medium of the master, and save it as
newest.cfg.
[ftp] get testcfg.cfg newest.cfg
# Download file testcfg.cfg to the root directory of the storage medium of the subordinate switch (with
the member ID 2), and save it as newest.cfg.
[ftp] get testcfg.cfg slot2#flash:/newest.cfg
lcd
Description
Use lcd to display the local working directory of the FTP client.
Syntax
lcd
View
FTP client view
Default level
3: Manage level
Parameters
None
Example
# Display the local working directory.
[ftp] lcd
FTP: Local directory now flash:/clienttemp.
The above information indicates that the working directory of the FTP client before execution of the ftp
command is flash:/clienttemp.
71
ls
Description
Use ls to view the information of all the files and subdirectories in the current directory of the remote
FTP server. The file names and subdirectory names are displayed. Compare to the dir command,
which can display other related information of the files and directories, such as the size, and the date
they were created.
Use ls remotefile localfile to view the information of a file or subdirectory, and save the result to
a local file specified by the localfile argument.
Syntax
ls [ remotefile [ localfile ] ]
View
FTP client view
Default level
3: Manage level
Parameters
remotefile: Filename or directory on the remote FTP server.
localfile: Name of a local file used to save the displayed information.
Examples
# View the information of all files and subdirectories under the current directory of the FTP server.
[ftp] ls
227 Entering Passive Mode (192,168,1,50,17,165).
125 ASCII mode data connection already open, transfer starting for /*.
ar-router.cfg
logfile
mainar.bin
arbasicbtm.bin
ftp
test
bb.cfg
testcfg.cfg
226 Transfer complete.
FTP: 87 byte(s) received in 0.132 second(s) 659.00 byte(s)/sec.
72
# View the information of directory logfile, and save the result to file aa.txt.
[ftp] ls logfile aa.txt
227 Entering Passive Mode (192,168,1,46,4,3).
125 ASCII mode data connection already open, transfer starting for /logfile/*.
....226 Transfer complete.
FTP: 20 byte(s) received in 3.962 second(s), 5.00 byte(s)/sec.
mkdir
Description
Use mkdir to create a subdirectory in the current directory on the remote FTP server. You must have
permissions on the remote FTP server.
Syntax
mkdir directory
View
FTP client view
Default level
3: Manage level
Parameter
directory: Name of the directory to be created.
Example
#Create subdirectory mytest on the current directory of the remote FTP server.
[ftp] mkdir mytest
257 "/mytest" new directory created.
open
Description
Use open to log in to the IPv4 FTP server under FTP client view.
At login, enter the username and password for accessing the FTP server. If your input is correct, the
login succeeds.
If you have logged in to the IPv4 FTP server currently, you cannot use the open to log in to another
server. You need to disconnect with the current server first, and then try to connect with another one.
Related commands: close.
73
Syntax
open server-address [ service-port ]
View
FTP client view
Default level
3: Manage level
Parameters
server-address: IP address or host name of a remote FTP server.
service-port: Port number of the remote FTP server, in the range 0 to 65535. The default value is 21.
Example
# In FTP client view, log in to the FTP server with the IP address of 192.168.1.50.
<Sysname> ftp
[ftp] open 192.168.1.50
Trying 192.168.1.50 ...
Press CTRL+K to abort
Connected to 192.168.1.50.
220 FTP service ready.
User(192.168.1.50:(none)):aa
331 Password required for aa.
Password:
230 User logged in.
[ftp]
open ipv6
Description
Use open ipv6 to log in to the IPv6 FTP server in FTP client view.
At login, enter the username and password for accessing the FTP server. If your input is correct, the
login succeeds.
Related commands: close.
Syntax
open ipv6 server-address [ service-port ] [ -i interface-type interface-number ]
View
FTP client view
Default level
3: Manage level
74
Parameters
server-address: IP address or host name of the remote FTP server.
service-port: Port number of the remote FTP server, in the range 0 to 65535. The default value is 21.
-i interface-type interface-number: Specifies the egress interface by its type and number. This
parameter can be used only when the FTP server address is a link local address and the specified
egress interface has a link local address. For the configuration of link local addresses, see the Layer
3IP Services Configuration Guide.
Example
# Log in to the FTP server (with IPv6 address 3000::200) in FTP client view.
<Sysname> ftp
[ftp] open ipv6 3000::200
Trying 3000::200 ...
Press CTRL+K to abort
Connected to 3000::200.
220 Welcome!
User(3000::200:(none)): MY_NAME
331 Please specify the password.
Password:
230 Login successful.
passive
Description
This command is mainly used in conjunction with a firewall to restrict the FTP session connection
between private and public network users.
Data transmission modes fall into the passive mode and the active mode.
The active mode means that the data connection request is initiated by a server.
The passive mode means that the data connection request is initiated by a client. Syntax
Use the passive command to set the data transmission mode to passive (the default mode is passive).
Use the undo passive command to set the data transmission mode to active.
View
FTP client view
Default level
3: Manage level
Parameters
None
Example
# Set the data transmission mode to passive.
[ftp] passive
FTP: passive is on
75
put
Description
Use put to upload a file on the client to the remote FTP server.
By default, if no name is assigned to the file to be saved on the FTP server, the name of the
source file is used.
After a file is uploaded, it will be saved under the users authorized directory, which can be set
with the authorization-attribute command.
Syntax
put localfile [ remotefile ]
View
FTP client view
Default level
3: Manage level
Parameters
localfile: Name of the local file to be uploaded.
remotefile: File name used after a file is uploaded and saved on the FTP server.
Examples
# Upload source file cc.txt to the remote FTP server and save it as dd.txt.
[ftp] put cc.txt dd.txt
227 Entering Passive Mode (192,168,1,50,17,169).
125 ASCII mode data connection already open, transfer starting for /dd.txt.
226 Transfer complete.
FTP: 9 byte(s) sent in 0.112 second(s), 80.00 byte(s)/sec.
# Upload source file vrpcfg.cfg on the master to the remote FTP server and save it as ftpclient.cfg.
[ftp] put vrpcfg.cfg ftpclient.cfg
227 Entering Passive Mode (192,168,1,46,4,50).
125 ASCII mode data connection already open, transfer starting for
/ftpclient.cfg.
226 Transfer complete.
FTP: 1366 byte(s) sent in 0.064 second(s), 21.00Kbyte(s)/sec.
#Upload source file a.cfg on the subordinate switch (with the member ID 2) to the remote FTP server
and save it as ftpclienta.cfg.
[ftp] put slot2#flash:/a.cfg ftpclienta.cfg
227 Entering Passive Mode (192,168,1,46,4,52).
125 ASCII mode data connection already open, transfer starting for
/ftpclienta.cfg.
226 Transfer complete.
FTP: 1226 byte(s) sent in 0.065 second(s), 18.00Kbyte(s)/sec.
76
pwd
Description
Use pwd to display the accessed directory on the remote FTP server.
Syntax
pwd
View
FTP client view
Default level
3: Manage level
Parameters
None
Example
# Display the currently accessed directory on the remote FTP server.
[ftp] cd servertemp
[ftp] pwd
257 "/servertemp" is current directory.
The above information indicates that the servertemp folder under the root directory of the remote FTP
server is being accessed by the user.
quit
Description
Use quit to disconnect from the remote FTP server and exit to user view.
Syntax
quit
View
FTP client view
Default level
3: Manage level
Parameters
None
Example
# Disconnect from the remote FTP server and exit to user view.
[ftp] quit
221 Server closing.
<Sysname>
77
remotehelp
Description
Use remotehelp to display the help information of FTP-related commands supported by the remote FTP
server.
If no parameter is specified, remote servers FTP-related commands are displayed.
Syntax
remotehelp [ protocol-command ]
View
FTP client view
Default level
3: Manage level
Parameters
protocol-command: FTP command.
Examples
# Display FTP commands supported by the remote FTP server.
[ftp] remotehelp
214-Here is a list of available ftp commands
Those with '*' are not yet implemented.
USER
PASS
ACCT*
CWD
CDUP
SMNT*
QUIT
REIN*
PORT
PASV
TYPE
STRU*
MODE*
RETR
STOR
STOU*
APPE*
ALLO*
REST*
RNFR*
RNTO*
ABOR*
DELE
RMD
MKD
PWD
LIST
NLST
SITE*
SYST
STAT*
HELP
NOOP*
XCUP
XCWD
XMKD
XPWD
XRMD
[ftp]
Description
USER
Username
PASS
Password
CWD
CDUP
SMNT*
QUIT
Quit
REIN*
Re-initialization
78
Field
Description
PORT
Port number
PASV
Passive mode
TYPE
Request type
STRU*
File structure
MODE*
Transmission mode
RETR
Download a file
STOR
Upload a file
STOU*
Store unique
APPE*
Appended file
ALLO*
Allocation space
REST*
Restart
RNFR*
RNTO*
ABOR*
DELE
Delete a file
RMD
Delete a folder
MKD
Create a folder
PWD
LIST
List files
NLST
SITE*
Locate a parameter
SYST
STAT*
State
HELP
Help
NOOP*
No operation
XCUP
XCWD
XMKD
XPWD
XRMD
space + username
79
rmdir
Description
Only authorized users are allowed to use this command.
Use rmdir to remove a directory from the FTP server.
Delete all files and subdirectories in the directory before you delete a directory. For the deletion
of files, see the delete command.
When you execute the rmdir command, the files in the remote recycle bin in the directory will be
automatically deleted.
Syntax
rmdir directory
View
FTP client view
Default level
3: Manage level
Parameter
directory: Directory name on the remote FTP server.
Example
# Delete the temp1 directory from the authorized directory on the FTP server.
[ftp] rmdir /temp1
200 RMD command successful.
user
Description
Before using this command, you must configure the corresponding username and password on the
FTP server or the login will fail and the FTP connection will close.
Use user to relog in to the currently accessed FTP server with another username.
Syntax
user username [ password ]
View
FTP client view
Default level
3: Manage level
80
Parameters
username: Login username.
password: Login password. You can input this argument after the username argument plus a space; or
you can input this argument when the Password: prompt appears after you input the username and
then press Enter.
Example
# User ftp1 has logged in to the FTP server. Use username ftp2 to log in to the current FTP server.
(Suppose username ftp2 and password 123123123123 have been configured on the FTP server).
Method 1
[ftp] user ftp2
331 Password required for ftp2.
Password:
230 User logged in.
[ftp]
Method 2
[ftp] user ftp2 123123123123
331 Password required for ftp.
230 User logged in.
[ftp]
verbose
Description
Use verbose to enable the protocol information function to display detailed prompt information
(enabled is the default condition).
Use undo verbose to disable the protocol information function.
Syntax
verbose
undo verbose
View
FTP client view
Default level
3: Manage level
Parameters
None
81
Examples
# Enable the protocol information function.
[ftp] verbose
FTP: verbose is on
# Disable the protocol information function and perform the Get operation.
[ftp] undo verbose
FTP: verbose is off
[ftp] get startup.cfg bb.cfg
[ftp]
# Enable the protocol information function and perform the Get operation.
[ftp] verbose
FTP: verbose is on
82
Syntax
display tftp client configuration [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display the current configuration information of the TFTP client. This command displays the
configured source IP address or source interface of the TFTP client.
<Sysname> display tftp client configuration
The source IP address is 192.168.0.123
tftp-server acl
Description
Use tftp-server acl to use an ACLs rules to allow a device access to a specific TFTP server in a
network.
Use undo tftp-server acl to restore the default (no ACL is the default condition).
For more information about ACL, see the ACL and QoS Configuration Guide.
Syntax
tftp-server [ ipv6 ] acl acl-number
undo tftp-server [ ipv6 ] acl
83
View
System view
Default level
3: Manage level
Parameters
ipv6: References an IPv6 ACL. If it is not specified, an IPv4 ACL is referenced.
acl-number: Number of a basic ACL, in the range 2000 to 2999.
Examples
# Allow the device to access the TFTP server with the IP address of 1.1.1.1 only (in IPv4 networking
environment).
<Sysname> system-view
[Sysname] acl number 2000
[Sysname-acl-basic-2000] rule permit source 1.1.1.1 0
[Sysname-acl-basic-2000] quit
[Sysname] tftp-server acl 2000
# Allow the device to access the TFTP server with the IP address of 2001::1 only (in IPv6 networking
environment).
<Sysname> system-view
[Sysname] acl ipv6 number 2001
[Sysname-acl6-basic-2001] rule permit source 2001::1/128
[Sysname-acl6-basic-2001] quit
[Sysname] tftp-server ipv6 acl 2001
tftp
Description
This command applies to IPv4 networks.
Use tftp to upload files from the local device to a TFTP server and download files from the TFTP server
to the local device.
If no destination file name is specified, the saved file uses the source file name.
Syntax
tftp server-address { get | put | sget } source-filename [ destination-filename ] [ vpn-instance vpninstance-name ] [ source { interface interface-type interface-number | ip source-ip-address } ]
View
User view
Default level
3: Manage level
84
Parameters
server-address: IP address or host name of a TFTP server.
get: Downloads a file in normal mode.
put: Uploads a file.
sget: Downloads a file in secure mode.
source-filename: Source file name.
destination-filename: Destination file name.
vpn-instance vpn-instance-name: Specifies the TFTP servers VPN. The vpn-instance-name argument
refers to the name of a VPN instance, a case-sensitive string of 1 to 31 characters.
source: Configures parameters for source address binding.
interface interface-type interface-number: Specifies the source interface by its type and number. The
primary IP address configured on the source interface is the source IP address of the packets sent by
TFTP. If no primary IP address is configured on the source interface, the transmission fails.
ip source-ip-address: Specifies the source IP address for the current TFTP client to transmit packets. This
source address must be an IP address that has been configured on the device.
Examples
# Download the config.cfg file from the TFTP server with the IP address of 192.168.0.98 and save it
as config.bak. Specify the source IP address to be 192.168.0.92.
<Sysname> tftp 192.168.0.98 get config.cfg config.bak source ip 192.168.0.92
...
File will be transferred in binary mode
Downloading file from remote TFTP server, please wait....
TFTP:
# Upload the config.cfg file from the local device to the default path of the TFTP server with the IP
address of 192.168.0.98 and save it as config.bak. Specify the source IP interface to be Ethernet 1/1.
<Sysname> tftp 192.168.0.98 put config.cfg config.bak source interface ethernet
1/1
# To upgrade the device, download the newest.bin file from the TFTP server with the IP address of
192.168.1.26 and save it to both the root directory on the flash of the master and the root directory on
the flash of the subordinate switch (with the member ID 2).
<Sysname> tftp 192.168.1.26 get newest.bin startup.bin
.
File will be transferred in binary mode
Downloading file from remote TFTP server, please wait..................
TFTP:
85
# Download the file from the TFTP server to the root directory on the flash of the master.
<Sysname> tftp 192.168.1.26 get newest.bin slot2#flash:/startup.bin
// Download the file from the TFTP server to the root directory on the flash of the subordinate switch.
The source address can be specified as the source interface and the source IP. If you use tftp
client source to specify the source interface and then the source IP, the newly specified source IP
overwrites the configured source interface and vice versa.
If the source address is specified with tftp client source and then with the tftp command, the
source address specified with the latter one is used to communicate with the TFTP server.
The source address specified with tftp client source is valid for all tftp connections and the source
address specified with the tftp command is valid for the current tftp command.
Use undo telnet client source to restore the default. By default, a device uses the IP address of the
interface determined by the matched route as the source IP address to communicate with a TFTP
server.
Related commands: display tftp client configuration.
Syntax
tftp client source { interface interface-type interface-number | ip source-ip-address }
undo tftp client source
View
System view
Default level
2: System level
Parameters
interface interface-type interface-number: Specifies the source interface by its type and number. The
primary IP address configured on the source interface is the source IP address of the packets sent by
TFTP. If no primary IP address is configured on the source interface, the transmission fails.
ip source-ip-address: The source IP address of TFTP connections. It must be an IP address that has
been configured on the device.
Examples
# Specify the source IP address of the TFTP client as 2.2.2.2.
<Sysname> system-view
[Sysname] tftp client source ip 2.2.2.2
86
tftp ipv6
Description
This command applies to IPv6 networks.
Use tftp ipv6 to download files from a TFTP server or upload local files to a TFTP server.
Syntax
tftp ipv6 tftp-ipv6-server [ -i interface-type interface-number ] { get | put } source-file [ destination-file ]
[ vpn-instance vpn-instance-name ]
View
User view
Default level
3: Manage level
Parameters
tftp-ipv6-server: IPv6 address or host name (a string of 1 to 46 characters) of a TFTP server.
-i interface-type interface-number: Specifies the egress interface by its type and number. This
parameter can be used only when the TFTP server address is a link local address and the specified
egress interface has a link local address. For the configuration of a link local address, see the Layer
3IP Services Configuration Guide.
get: Downloads a file.
put: Uploads a file.
source-file: Source filename.
destination-file: Destination filename. If not specified, this filename is the same as the source filename.
vpn-instance vpn-instance-name: Specifies the VPN that the TFTP server belongs to. The vpn-instancename argument is a case-sensitive string of 1 to 31 characters.
Example
# Download filetoget.txt from the TFTP server.
<Sysname> tftp ipv6 fe80::250:daff:fe91:e058 -i Vlan-interface1 get
filetoget.txt
...
File will be transferred in binary mode
Downloading file from remote TFTP server, please wait....
TFTP:
87
cd
Description
Use cd to change the working directory.
Syntax
cd { directory | .. | / }
View
User view
Default level
3: Manage level
Parameters
directory: Name of the target directory, in the format of [drive:/]path. For the detailed introduction to
the drive and path arguments, see the Fundamentals Configuration Guide. If no drive information is
provided, the argument represents a folder or subfolder in the directory.
..: Returns to an upper directory. This argument does not support command online help. If the working
directory is the root directory, or if no upper directory exists, the working directory does not change
when the cd .. command is executed.
/: Returns to the root directory of the storage medium. The keyword does not support command line
online help.
Examples
# Enter the test folder after logging in to the device.
<Sysname> cd test
# Return to the upper directory (Remember to enter a space after the keyword cd).
<Sysname> cd ..
After you change the directory by using the cd command, use the pwd to view the path of the
working directory.
# Enter the root directory of the Flash on a subordinate with the member ID 2 after logging in to the
master.
<Sysname> cd slot2#flash:/
88
# Change the current directory from the file system of the subordinate to the test folder in the root
directory of the master.
<Sysname> cd flash:/
copy
Description
Use copy to copy a file.
If you specify a target folder, the system will copy the file to the folder and use the name of the source
file as the file name.
Syntax
copy fileurl-source fileurl-dest
View
User view
Default level
3: Manage level
Parameters
fileurl-source: Name of the source file.
fileurl-dest: Name of the target file or folder.
Examples
# Copy file testcfg.cfg in the current folder and save it as testbackup.cfg.
<Sysname> copy testcfg.cfg testbackup.cfg
Copy flash:/test.cfg to flash:/testbackup.cfg?[Y/N]:y
....
%Copy file flash:/test.cfg to flash:/testbackup.cfg...Done.
# Copy the configuration file of the master to the root directory of a subordinate (with the member ID
2).
<Sysname> copy vrcfg.cfg slot2#flash:/
Copy flash:/vrcfg.cfg to slot2#flash:/vrcfg.cfg?[Y/N]:y
%Copy file flash:/vrcfg.cfg to slot2#flash:/vrcfg.cfg...Done.
delete
Description
CAUTION:
If you delete one file, and then delete another one with the same filename but in a different directory,
only the last one deleted is retained in the recycle bin.
Use delete file-url to temporarily delete a file. The deleted file is saved in the recycle bin.
The delete /unreserved file-url command permanently deletes a file. The deleted file cannot be
restored. Use it with caution.
89
Syntax
delete [ /unreserved ] file-url
View
User view
Default level
3: Manage level
Parameters
/unreserved: Permanently deletes the specified file, and the deleted file can never be restored.
file-url: Name of the file to be deleted. Asterisks (*) are acceptable as wildcards. For example, to
remove files with the extension of .txt in the current directory, you may use the delete *.txt command.
Examples
# Remove file tt.cfg from the root directory of the storage medium on the master.
<Sysname> delete tt.cfg
.
Delete flash:/tt.cfg?[Y/N]:y
.
%Delete file flash:/tt.cfg...Done.
# Remove file tt.cfg from the root directory of the storage medium on a subordinate (with the member
ID 2).
Approach 1
<Sysname> delete slot2#flash:/tt.cfg
Delete slot2#flash:/tt.cfg?[Y/N]:y
%Delete file slot2#flash:/tt.cfg...Done.
Approach 2
<Sysname> cd slot2#flash:/
<Sysname> delete tt.cfg
Delete slot2#flash:/tt.cfg?[Y/N]:y
%Delete file slot2#flash:/tt.cfg...Done.
dir
Description
Use dir to display information about all visible files and folders in the current directory.
Use dir /all to display information about all files and folders in the current directory, including
hidden files, hidden sub-folders and the files in the recycle bin that originally belong to the
current directory. The names of these deleted files are enclosed in pairs of square brackets [ ].
90
Syntax
dir [ /all ] [ file-url ]
View
User view
Default level
3: Manage level
Parameters
/all: Displays all files.
file-url: Name of the file or directory to be displayed. Asterisks (*) are acceptable as wildcards. For
example, to display files with the .txt extension in the current directory, you may use the dir *.txt
command.
Examples
# Display information about all files and folders in the storage medium of the master.
<Sysname> dir /all
Directory of flash:/
0
-rwh
snmpboots
-rw-
10187730
startup.bin
-rwh
3144
private-data.txt
-rw-
2161
startup.cfg
-rw-
10058752
startup1.bin
-rw-
10139143
startup2.bin
-rwh
716
hostkey
-rwh
572
serverkey
-rwh
548
dsakey
-rw-
3035
new-config.cfg
10
-rw-
2200
[aa.cfg]
# Display information about all files and folders in the storage medium of a subordinate (with the
member ID 2).
<Sysname> cd slot2#flash:/
<Sysname> dir /all
Directory of slot2#flash:/
0
-rwh
3144
private-data.txt
-rw-
2341
startup.cfg
-rw-
124
patchstate
-rwh
716
hostkey
-rwh
snmpboots
-rw-
10187730
startup.bin
-rwh
572
serverkey
-rwh
548
dsakey
-rw-
3035
new-config.cfg
91
drw-
oldver
Description
Directory of
[]
Syntax
display nandflash file-location filename [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
2: System level
Parameters
filename: File name.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see CLI configuration.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
92
Example
# Display the location of the file test.cfg in the NAND flash memory.
<Sysname> display nandflash file-location test.cfg
Logical Chunk
Physical Page
--------------------------chunk(0)
1234
chunk(1)
1236
chunk(2)
1235
filename: test.cfg
Description
Logic Chunk
Physical Page
chunk(0)
1234
The first logical page of this file corresponds to the 1234th physical
page on the device.
Syntax
display nandflash badblock-location [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
2: System level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see "CLI configuration.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
93
Example
# Display the number and location of bad blocks in the NAND flash memory.
<Sysname> display nandflash badblock-location
No
Physical block
-----------------------------badblock(0)
1234
badblock(1)
1235
badblock(2)
1236
Description
No
Physical block
Total number of blocks and bad blocks in the NAND flash memory
Syntax
display nandflash page-data page-value [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
page-value: Serial number of a physical page.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see "CLI configuration.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
94
Example
#Display the content of the file test.cfg which is saved in the NAND flash memory.
<Sysname> display nandflash file-location test.cfg
Logical Chunk
Physical Page
--------------------------chunk(0)
1234
chunk(1)
1236
chunk(2)
1235
filename: test.cfg
<Sysname> display nandflash page-data 1236
0000:
0D 0A 23 0D 0A 20 76 65 72 73 69 6F 6E 20 35 2E
..#.. version 5.
0010:
32 30 2C 20 41 6C 70 68 61 20 31 30 31 31 0D 0A
0020:
23 0D 0A 20 73 79 73 6E 61 6D 65 20 48 33 43 0D
0030:
0A 23 0D 0A 20 70 61 73 73 77 6F 72 64 2D 63 6F
.#.. password-co
...Omitted...
execute
Description
Use execute to run the batch file.
Batch files are command line files. Executing a batch file is to execute a set of command lines in
the file.
Do not include invisible characters in a batch file. When the system encounters them during
processing, the batch process will abort and the commands that have been executed cannot be
cancelled.
Incorrectly configured batch file commands will not execute. When encountered, the system
omits these commands and proceeds to the next command.
The configuration generated after a batch file executes is not automatically backed up to the
standby main board.
Syntax
execute filename
View
System view
Default level
2: System level
Parameter
filename: Name of a batch file with a .bat extension. You can use the rename command to change
the suffix of the configuration file to .bat to use it as a batch file.
95
Example
# Execute the batch file test.bat in the root directory.
<Sysname> system-view
[Sysname] execute test.bat
file prompt
Description
Use file prompt to set a prompt mode for file operations.
By default, the prompt mode is alert, which HP recommends to avoid abnormal operations.
Syntax
file prompt { alert | quiet }
View
System view
Default level
3: Manage level
Parameters
alert: Enables the system to warn you about operations that may bring undesirable results such as file
corruption or data loss.
quiet: Disables the system from warning you about any operation.
Example
# Set the file operation prompt mode to alert.
<Sysname> system-view
[Sysname] file prompt alert
fixdisk
Description
Use fixdisk to restore the space of a storage medium when it becomes unavailable due to abnormal
operation.
Syntax
fixdisk device
View
User view
Default level
3: Manage level
Parameter
device: Storage medium name.
96
Example
# Restore the space of the Flash.
<Sysname> fixdisk flash:
Fixdisk flash: may take some time to complete...
%Fixdisk flash: completed.
format
Description
CAUTION:
When you format a storage medium, the files are lost and cannot be restored. If a startup configuration
file exists on a storage medium, formatting the storage medium results in loss of the startup
configuration file.
Use format to format a storage medium.
Syntax
format device
View
User view
Default level
3: Manage level
Parameter
device: Name of a storage medium.
Example
#Format the Flash.
<Sysname> format flash:
All data on flash: will be lost, proceed with format? [Y/N]:y
./
%Format flash: completed.
mkdir
Description
Use mkdir to create a folder on the storage medium.
The destination directory must exist. For instance, to create folder flash:/test/mytest, the test
folder must exist. Otherwise, you will fail to create the mytest folder.
The name of the folder to be created must be unique in the specified directory. Otherwise, mkdir
will fail.
Syntax
mkdir directory
97
View
User view
Default level
3: Manage level
Parameter
directory: Name of a folder.
Examples
# Create a folder named test in the current directory.
<Sysname> mkdir test
....
%Created dir flash:/test
more
Description
This command is valid only for text files.
Use more to display the contents of a specific file when there are more lines that the screen can
display.
Syntax
more file-url
View
User view
Default level
3: Manage level
Parameter
file-url: File name.
98
Examples
#Display the contents of file testcfg.cfg.
<Sysname> more testcfg.cfg
#
version 5.20, Beta 1201, Standard
#
sysname Sysname
#
vlan 2
#
return
<Sysname>
#Display the contents of file testcfg.cfg on a subordinate (with the member ID 2).
<Sysname> more slot2#flash:/testcfg.cfg
#
version 5.20, Release 0000
#
sysname Test
#
---- More ----
move
Description
Use move to move a file.
If you specify a target folder, the system will move the source file to the specified folder, with the
file name unchanged.
Syntax
move fileurl-source fileurl-dest
View
User view
Default level
3: Manage level
Parameters
fileurl-source: Name of the source file.
fileurl-dest: Name of the target file or folder.
99
Examples
# Move file flash:/test/sample.txt to flash:/, and save it as 1.txt.
<Sysname> move test/sample.txt 1.txt
Move flash:/test/sample.txt to flash:/1.txt?[Y/N]:y
...
% Moved file flash:/test/sample.txt to flash:/1.txt
pwd
Description
Use pwd to display the current path.
Syntax
pwd
View
User view
Default level
3: Manage level
Parameters
None
Example
# Display the current path.
<Sysname> pwd
flash:
rename
Description
Use rename to rename a file or folder. The target file name must be unique in the path.
Syntax
rename fileurl-source fileurl-dest
View
User view
Default level
3: Manage level
100
Parameters
fileurl-source: Name of the source file or folder.
fileurl-dest: Name of the target file or folder.
Example
# Rename file sample.txt as sample.bat.
<Sysname> rename sample.txt sample.bat
Rename flash:/sample.txt to flash:/sample.bat? [Y/N]:y
reset recycle-bin
Description
Use reset recycle-bin to permanently delete the files in the recycle bin in the directory.
If a file is corrupted, you may not be able to delete the file using the reset recycle-bin command.
To force the corrupted file to delete, use the reset recycle-bin /force command.
The delete file-url command only moves a file to the recycle bin, and the file still occupies the
memory space. To delete the file in the recycle bin, execute the reset recycle-bin command in the
original directory of the file.
If the original path of the file to be deleted is not the current directory, use the cd to enter the
original directory of the file, and then execute the reset recycle-bin command.
Syntax
reset recycle-bin [ /force ]
View
User view
Default level
3: Manage level
Parameter
/force: Deletes all files in the recycle bin, including files that cannot be deleted by the command
without the /force keyword.
101
Examples
# Delete file b.cfg in the current directory and in the recycle bin.
Display all the files in the recycle bin and in the current directory.
<Sysname> dir /all
Directory of flash:/
0
-rwh
3080
private-data.txt
-rw-
2416
config.cfg
-rw-
8036197
main.bin
-rw-
2386
back.cfg
drw-
test
-rwh
716
hostkey
-rwh
572
serverkey
-rw-
2386
[a.cfg]
-rw-
3608
[b.cfg]
//The output shows that the current directory is flash:, and two files a.cfg and b.cfg are in the
recycle bin.
Delete file b.cfg in the current directory and in the recycle bin.
<Sysname> reset recycle-bin
Clear flash:/~/a.cfg ?[Y/N]:n
Clear flash:/~/b.cfg ?[Y/N]:y
Clearing files from flash may take a long time. Please wait...
......
%Cleared file flash:/~/b.cfg...
In directory flash:, check whether the file b.cfg in the recycle bin is deleted.
<Sysname> dir /all
Directory of flash:/
-rwh
3080
private-data.txt
1
2
-rw-
2416
config.cfg
-rw-
8036197
main.bin
-rw-
2386
back.cfg
drw-
test
-rwh
716
hostkey
-rwh
572
serverkey
-rw-
2386
[a.cfg]
102
rmdir
Description
Use rmdir to remove a folder.
The folder must be an empty one. If not, delete all files and subfolders under it with the delete
command.
After you execute the rmdir command successfully, the files in the recycle bin in the folder will be
deleted automatically.
Syntax
rmdir directory
View
User view
Default level
3: Manage level
Parameter
directory: Name of the folder.
Example
# Remove folder mydir.
<Sysname> rmdir mydir
Rmdir flash:/mydir?[Y/N]:y
undelete
Description
Use undelete to restore a file from the recycle bin.
If you create a file with the same name in the same path, the system prompts you whether to overwrite
the original file.
Syntax
undelete file-url
View
User view
Default level
3: Manage level
Parameter
file-url: Name of the file to be restored.
103
Examples
# Restore file a.cfg in directory flash: from the recycle bin.
<Sysname> undelete a.cfg
Undelete flash:/a.cfg?[Y/N]:y
.....
%Undeleted file flash:/a.cfg.
# Or, you can use the following steps to restore file flash:/test/b.cfg.
<Sysname> cd test
<Sysname> undelete b.cfg
Undelete flash:/test/b.cfg?[Y/N]:y
%Undeleted file flash:/test/b.cfg.
104
Before executing archive configuration, you must configure the filename prefix and path for
saving configuration files using the archive configuration location command.
When archive configuration executes, the running configuration file (filename prefix + serial
number) is saved to the master. The subordinate switches do not perform the saving operation.
Syntax
archive configuration
View
User view
Default level
3: Manage level
Parameters
None
Example
# Save the running configuration manually.
<Sysname> archive configuration
Warning: Save the running configuration to an archive file. Continue? [Y/N]: Y
Please wait...
Info: The archive configuration file myarchive_1.cfg is saved.
Before executing the archive configuration interval command, you must configure the filename
prefix and path for saving configuration files by using the archive configuration location
command.
The archive configuration interval command executes on the master and its subordinate switches.
Executing this command on the subordinate switches ensures configuration rollback after the
master is changed.
Configure an automatic saving interval according to the storage media performance and the
frequency of configuration modification.
105
If switch configuration does not change frequently, HP recommends that you save the running
configuration manually.
Use undo archive configuration interval to restore the default (the system does not automatically save
by default).
Syntax
archive configuration interval minutes
undo archive configuration interval
View
System view
Default level
3: Manage level
Parameter
minutes: Specifies the interval for automatically saving the running configuration, in minutes. The
value ranges from 10 to 525,600 (365 days).
Example
# Configure the system to save the running configuration every 60 minutes.
<Sysname> system-view
[Sysname] archive configuration interval 60
Info: Archive files will be saved every 60 minutes.
Before the running configuration is saved either manually or automatically, the file path and
filename prefix must be configured.
When the switch is operating in active/standby mode, the saving and rollback operations are
executed only on the master. After the active/standby switchover, the configuration rollback can
take effect on the new master.
By default, the path and filename prefix for saving configuration files are not configured, and the
system does not save the configuration file periodically.
The configuration done by executing the archive configuration interval and archive configuration
max commands will restore the default, and clear the saved configuration files.
106
Syntax
archive configuration location directory filename-prefix filename-prefix
undo archive configuration location
View
System view
Default level
3: Manage level
Parameters
directory: The path of the folder for saving configuration files, a string of 1 to 63 case-insensitive
characters, in the format of storage media name:/[folder name]/subfolder name. The folder must be
created before the configuration.
filename-prefix: The filename prefix for saving configuration files, a case-insensitive string of 1 to 30
characters (can include letters, numbers, _, and - only).
Example
# Configure the path and the filename prefix for saving configuration files as flash:/archive/ and
my_archive respectively.
Configure the path and the filename prefix for saving configuration files.
<Sysname> system-view
[Sysname] archive configuration location flash:/archive filename-prefix
my_archive
Excessive configuration files occupy large memory space: Use this command to control the
number of files.
After the maximum number of configuration files is saved, the system deletes the oldest files
when the next file is saved (either automatically or manually).
107
When you change the maximum number of configuration files that can be saved, the exceeded
files are not deleted.
If the number of the existing configuration files is larger than or equal to the newly configured
upper limit, the system deletes the oldest n files when the next file is saved, where n = the current
number - the newly configured number + 1, for example: if the number of configuration files that
have been saved is 7, and the newly configured upper limit is 4, when there is a new
configuration file to be saved, the system deletes the 4 oldest files, where 4 = 7-4+1.
Use undo archive configuration max to restore the default (five is the maximum number of
configuration files saved by default).
Syntax
archive configuration max file-number
undo archive configuration max
View
System view
Default level
3: Manage level
Parameter
file-number: The maximum number of configuration files that can be saved, in the range 1 to 10. The
value of the file-number argument is determined by the memory space. If the available memory space
is small, set a comparatively small value for this argument.
Example
# Set the maximum number of configuration files that can be saved to 10.
<Sysname> system-view
[Sysname] archive configuration max 10
backup startup-configuration
Description
For a switch that has main and backup startup configuration files, this command only backs up the
main startup configuration file.
Currently, the switch uses TFTP to back up configuration files.
Use backup startup-configuration to back up the startup configuration file for the next system startup
to a specified TFTP server. If you do not specify this filename, the original filename is used.
Syntax
backup startup-configuration to dest-addr [ dest-filename ]
View
User view
Default level
2: System level
108
Parameters
dest-addr: IP address or name of a TFTP server. The address cannot be an IPv6 address.
dest-filename: Target filename used to save the startup configuration file for the next system startup on
the server.
Example
# Back up the startup configuration file of the device to the TFTP server with IP address 2.2.2.2, using
filename 192-168-1-26.cfg.
<Sysname> display startup
Current startup saved-configuration file:
flash:/config.cfg
flash:/test.cfg
After the operation, the device backs up file test.cfg to TFTP server 2.2.2.2, where the file is saved as
192-168-1-26.cfg.
The configuration file specified with the configuration replace file filename command can only
be a simple-text file. Otherwise, errors can occur during configuration rollback.
When this command is executed, the running configuration rolls back to the configuration state
based on the specified configuration file (filename).
Syntax
configuration replace file filename
View
System view
Default level
3: Manage level
Parameter
filename: Specifies the name of the replacement configuration file for configuration rollback.
Example
# Roll back from the running configuration to a previous configuration state based on a saved
configuration file my_archive_1.cfg.
<Sysname> system-view
[Sysname] configuration replace file my_archive_1.cfg
Info: Now replacing the current configuration. Please wait...
Info: Succeeded in replacing current configuration with the file
my_archive_1.cfg.
109
Syntax
display archive configuration [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see CLI configuration in the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display information about configuration rollback.
<Sysname> display archive configuration
Location: flash:/archive
Filename prefix: my_archive
Archive interval in minutes: 120
Maximum number of archive files: 10
Saved archive files:
No. TimeStamp
FileName
my_archive_1.cfg
my_archive_2.cfg
# 3
my_archive_3.cfg
Description
Location
Filename prefix
110
display current-configuration
Description
Use display current-configuration to view the current validated device configuration.
If a validated parameter is changed when you configure it, it is displayed. For example, IP
address 11.11.11.11 24 has been configured on a Loopback interface. 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.
Syntax
display current-configuration [ [ configuration [ configuration ] | interface [ interface-type ]
[ interface-number ] | exclude modules ] [ by-linenum ] [ | { begin | exclude | include } regularexpression ] ]
View
Any view
Default level
2: System level
Parameters
configuration [ configuration ]: display a 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:
interface [ interface-type ] [ interface-number ]: Displays the interface configuration, where interfacetype represents the interface type and interface-number represents the interface number.
exclude modules: Excludes the configuration of a specific module. The modules argument can be acl,
acl6, or both separated by a space.
Examples
# Display the configuration from the line containing user-interface to the last line in the current
validated configuration.
<Sysname> display current-configuration | begin user-interface
user-interface aux 0
user-interface vty 0 15
authentication-mode none
user privilege level 3
#
return
# Display the current valid SNMP configuration on the device. (The output information depends on
your device model and the current configuration.)
<Sysname> display current-configuration | include snmp
snmp-agent
snmp-agent local-engineid 800063A203000FE240A1A6
snmp-agent community read public
snmp-agent community write private
snmp-agent sys-info version all
undo snmp-agent trap enable ospf 100
display default-configuration
Description
Use display default-configuration to display all commands to be executed when the device boots with
the factory defaults.
Related commands: display current-configuration and display saved-configuration.
Syntax
display default-configuration [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
2: System level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see CLI configuration in the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
112
Example
# Display the factory defaults of the device.
<Sysname> display default-configuration
#
domain default enable system
#
telnet server enable
#
undo ip redirects
undo ip ttl-expires
undo ip unreachables
#
vlan 1
#
radius scheme system
server-type extended
primary authentication 127.0.0.1 1645
primary accounting 127.0.0.1 1646
user-name-format without-domain
#
domain system
access-limit disable
state active
idle-cut disable
self-service-url disable
#
interface NULL0
#
interface GigabitEthernet1/0/1
#
interface GigabitEthernet1/0/2
#
interface GigabitEthernet1/0/3
#
interface GigabitEthernet1/0/4
#
interface GigabitEthernet1/0/5
#
interface GigabitEthernet1/0/6
#
interface GigabitEthernet1/0/7
#
interface GigabitEthernet1/0/8
#
interface GigabitEthernet1/0/9
#
interface GigabitEthernet1/0/10
113
#
interface GigabitEthernet1/0/11
#
interface GigabitEthernet1/0/12
#
interface GigabitEthernet1/0/13
#
interface GigabitEthernet1/0/14
#
interface GigabitEthernet1/0/15
#
interface GigabitEthernet1/0/16
#
interface GigabitEthernet1/0/17
#
interface GigabitEthernet1/0/18
#
interface GigabitEthernet1/0/19
#
interface GigabitEthernet1/0/20
#
interface GigabitEthernet1/0/21
#
interface GigabitEthernet1/0/22
#
interface GigabitEthernet1/0/23
#
interface GigabitEthernet1/0/24
#
interface Ten-GigabitEthernet1/0/25
#
interface Ten-GigabitEthernet1/0/26
#
interface Ten-GigabitEthernet1/0/27
#
interface Ten-GigabitEthernet1/0/28
#
user-interface aux 0
user-interface vty 0 4
#
return
display saved-configuration
Description
Use display saved-configuration to view the contents of the configuration file saved for the next system
startup.
114
During device management and maintenance, you can use this command to check whether
important configurations are saved to the configuration file for the next system startup.
For a switch supporting main and backup configuration files, this command displays the main
configuration file for the next system startup.
If a configuration file is not specified or does not exist for the next startup, the display savedconfiguration command displays the default configuration file of the switch.
If the default configuration file does not exist, the system prompts The config file does not
exist!."
The configurations are displayed in the order of global, port, and user interface.
The More prompt indicates that there are more lines than the screen can display.
Related commands: save, reset saved-configuration, and display current-configuration (in Device
Management in the Fundamentals Command Reference).
Syntax
display saved-configuration [ by-linenum ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
2: System level
Parameters
by-linenum: Identifies each line of displayed information with a line number.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see CLI configuration in the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
115
Examples
# Display the configuration file saved for the next system startup.
<Sysname> display saved-configuration
#
version 5.20, Test 5310
#
sysname Sysname
#
domain default enable system
#
telnet server enable
#
multicast routing-enable
#
vlan 1
#
vlan 999
#
domain system
access-limit disable
state active
idle-cut disable
self-service-url disable
#
interface NULL0
#
---- More ----
# Display the contents of the configuration file saved for the next system startup with a number
identifying each line.
<Sysname> display saved-configuration by-linenum
1:
2:
3:
4:
5:
6:
7:
8:
9:
10:
#
version 5.20, Test 5310
#
sysname Sysname
#
domain default enable system
#
telnet server enable
#
multicast routing-enable
11:
12:
vlan 1
13:
14:
vlan 999
15:
16:
domain system
17:
access-limit disable
116
18:
state active
19:
idle-cut disable
20:
self-service-url disable
21:
22:
interface NULL0
23:
display startup
Description
Use display startup to view the configuration file for the system startup and the configuration files for
the next system startup.
The subordinate switches are started and run based on the current master configuration.
When you execute the display startup command, the startup configuration file for the current
startup of the new master is displayed as NULL. The subordinate switches will also be NULL to
be consistent with the new master.
The current startup configuration files displayed on all member devices of an IRF virtual device
are always the same.
Syntax
display startup [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see CLI configuration in the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
117
Example
# Display the startup configuration file for the current system startup and the startup configuration files
for the next system startup.
<Sysname> display startup
MainBoard:
Current startup saved-configuration file: NULL
Next main startup saved-configuration file: flash:/startup.cfg
Next backup startup saved-configuration file: flash:/startup2.cfg
Slot 2:
Current startup saved-configuration file: NULL
Next main startup saved-configuration file: flash:/startup.cfg
Next backup startup saved-configuration file: flash:/startup2.cfg
Description
MainBoard
Slot 2
display this
Description
Use display this to check whether your configuration takes effect by displaying the validated
configuration information under the current view.
Execution of this command in any user interface view displays the valid configuration in all the
user interfaces.
Execution of this command in any VLAN view displays the configurations of all the created
VLANs.
Syntax
display this [ by-linenum ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
118
Parameters
by-linenum: Displays the number of each line.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see CLI configuration in the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display the valid configuration information on interface GigabitEthernet1/0/1.(The output
information depends on your device model and the current configuration.)
<Sysname> system-view
[Sysname] interface gigabitethernet 1/0/1
[Sysname-GigabitEthernet1/0/1] display this
#
interface GigabitEthernet1/0/1
port link-type hybrid
undo port hybrid vlan 1
port hybrid vlan 2 to 4 untagged
port hybrid pvid vlan 2
#
return
# Display the valid configuration information about all user interfaces. (The output information
depends on your device model and the current configuration.)
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] display this
#
user-interface aux 0
user-interface vty 0
history-command max-size 256
user-interface vty 1 15
#
return
119
reset saved-configuration
Description
Use reset saved-configuration to delete the startup configuration files saved on the storage media of
the device.
This command will permanently delete the startup configuration file from all member devices of
the IRF virtual device. Use it with caution.
You can delete either the main or backup startup configuration file. However, if these files are
the same, the system will only set the corresponding startup configuration file (main or backup,
according to which one you specified in the command) to NULL.
Both the reset saved-configuration command and the reset saved-configuration main command
delete the main startup configuration file.
Syntax
reset saved-configuration [ backup | main ]
View
User view
Default level
3: Manage level
Parameters
backup: Deletes the backup startup configuration file.
main: Deletes the main startup configuration file.
Related commands: save and display saved-configuration.
Example
# Delete the startup configuration file for the next startup from the storage media of the device.
<Sysname> reset saved-configuration backup
The saved configuration file will be erased. Are you sure? [Y/N]:y
Configuration file in flash is being cleared.
Please wait ...
..
MainBoard:
Configuration file is cleared.
Slot 2:
Erase next configuration file successfully
120
restore startup-configuration
Description
Use restore startup-configuration to download a configuration file from the specified TFTP server to
the switch, and specify it as the startup configuration file for the next system startup.
The downloaded file is set as the main startup configuration file for the next system startup.
This command downloads the configuration file to the storage media root directory of all
member devices and specifies the file as the startup configuration file for the next startup of all
member devices.
If the file to be downloaded has the same filename as an existing file on a member device, a
prompt asks if you want to overwrite the existing file.
Both master and subordinate switches are assumed to use the same type of storage media when
the device is checking the filename or backing up the configuration file to the subordinate
switches. If the master and the subordinate switches are of different types, the backup operation
fails.
When backing up the configuration file to the subordinate switches, the device saves the file to
the root directory.
Syntax
restore startup-configuration from src-addr src-filename
View
User view
Default level
3: Manage level
Parameters
src-addr: IP address or name of a TFTP server. The address cannot be an IPv6 address.
src-filename: Filename of the configuration file to be downloaded from the specified server.
Example
# Download file config.cfg from the TFTP server whose IP address is 2.2.2.2, and the file is to be used
as the main startup configuration file for the next system startup.
<Sysname> restore startup-configuration from 2.2.2.2 config.cfg
Restore next startup-configuration file from 2.2.2.2. Please wait...finished!
Now restore next startup-configuration file from main to slave board. Please
wait...finished!
121
save
Description
Use save file-url [ all | slot slot-number ] to save the current configuration to the specified
configuration file, but not the startup configuration file for the next system startup.
If the file specified by file-url does not exist, the system will create the file and then save the
configuration to the file.
If the all or slot parameter is not included, the configuration is saved to the master.
Use save [ safely ] [ backup | main ] [ force ] to save the current configuration to the root
directory of a member devices storage media, and specify the file as the startup configuration
file for the next system startup. If the backup keyword is not included, the main keyword is used
by default.
The configuration file auto-save function determines whether the save [ safely ] [ backup | main ]
[ force ] command or the save file-url all command+Enter takes effect on all member devices or
only on the master.
Related commands: slave auto-update config, reset saved-configuration, display currentconfiguration, and display saved-configuration.
Syntax
save file-url [ all | slot slot-number ]
save [ safely ] [ backup | main ] [ force ]
View
Any view
Default level
2: System level
Parameters
file-url: File path, where the extension of the file name must be .cfg. When used with the keyword all
or slot, this argument cannot include a member ID. If the file path includes a folder name, you must
first create the folder on the member device; otherwise, the operation will fail.
all: Saves the current configuration in the specified filename to all member devices of an IRF virtual
device..
slot slot-number: Saves the current configuration in the specified filename to a subordinate switch. slotnumber represents the member ID of a member device of an IRF virtual device.
safely: Sets the configuration saving mode to safe. If this argument is not specified, the configuration
file is saved in fast mode.
backup: Saves the current configuration to the startup configuration file specified in the interactive
mode, and specifies the file as the backup startup configuration file for the next system startup.
main: Saves the current configuration to the main startup configuration file specified in the interactive
mode, and specifies the file as the main startup configuration file for the next system startup.
force: Saves the current configuration to the configuration file for the next system startup, and the
system does not output any interaction information. By default, when you execute the save command,
the system asks you to input Y or N to confirm your operation. If you do not confirm your operation
122
within 30 seconds, the system automatically quits the operation. If you provide the force keyword
when executing the save command, the system directly saves the current configuration, not requiring
any confirmation.
Examples
# Save the current configuration to the root directory of the storage media on a member device, and
specify the file as the startup configuration file for the next startup.
<Sysname> display startup
MainBoard:
Current startup saved-configuration file: NULL
Next main startup saved-configuration file: flash:/aa.cfg
Next backup startup saved-configuration file: NULL
Slot 2:
Current startup saved-configuration file: NULL
Next main startup saved-configuration file: flash:/aa.cfg
Next backup startup saved-configuration file: NULL
// The output indicates that the main startup configuration file for the next startup of all the member
devices is aa.cfg.
<Sysname> save
The current configuration will be written to the device. Are you sure? [Y/N]:y
Please input the file name(*.cfg)[flash:/aa.cfg]
(To leave the existing filename unchanged, press the enter key):startup.cfg
flash:/startup.cfg exists, overwrite? [Y/N]:y
Validating file. Please wait.................
Saved the current configuration to mainboard device successfully.
Slot 2:
Save next configuration file successfully
Configuration is saved to device successfully.
<Sysname> display startup
MainBoard:
Current startup saved-configuration file: NULL
Next main startup saved-configuration file: flash:/startup.cfg
Next backup startup saved-configuration file: NULL
Slot 2:
Current startup saved-configuration file: NULL
Next main startup saved-configuration file: flash:/startup.cfg
Next backup startup saved-configuration file: NULL
// The output indicates that the main startup configuration file for the next startup of all member
devices of the IRF virtual device is changed to startup.cfg.
123
# Save the current configuration to the main startup configuration file for the next startup of the device,
without any confirmation required.
<Sysname> save force
Validating file. Please wait.................
Saved the current configuration to mainboard device successfully.
Slot 2:
Save next configuration file successfully
Configuration is saved to device successfully.
Syntax
slave auto-update config
undo slave auto-update config
View
System view
Default level
2: System level
Parameters
None
Example
# Enable the configuration file auto-save function.
<Sysname> system-view
[Sysname] slave auto-update config
124
startup saved-configuration
Description
Before using the command, ensure that the configuration file has been saved to the root directories of
the storage media of all the member devices.
Use startup saved-configuration to specify a next system startup configuration file for all member
devices.
The startup configuration file for the next startup of all the member devices must be the same.
The startup saved-configuration and startup saved-configuration main commands have the
same effect: Use both of them to specify the main startup configuration file.
The main and backup startup configuration files can be specified as the same file. However, HP
recommends that you use different files, or, save the same configuration file twice naming one
the main startup configuration file, and the other the backup.
Use undo startup saved-configuration to configure all the member devices to start up with the null
(factory) configuration.
If you execute the undo startup saved-configuration command, the system sets the main and
backup startup configuration file as NULL, but does not delete the two configuration files.
When you execute the undo startup saved-configuration command and reboot the IRF virtual
device or an IRF member device, the IRF virtual device is partitioned.
Syntax
startup saved-configuration cfgfile [ backup | main ]
undo startup saved-configuration
View
User view
Default level
3: Manage level
Parameters
cfgfile: Configuration file name. The file must be a file with an extension .cfg stored in the root
directory of the storage media.
backup: Sets the configuration file as the backup startup configuration file for the next system startup.
main: Sets the configuration file as the main startup configuration file for the next system startup.
125
Example
# Specify a startup configuration file for the next system startup.
<Sysname> startup saved-configuration testcfg.cfg
Please wait ...
Setting the master board ..........
... Done!
Setting the slave board ...
Slot 2:
Set next configuration file successfully
126
To execute the boot-loader command successfully, save the file to be used at the next device
boot in the root directory of the storage media on a member switch.
If the storage media is on the master, specify the storage media by giving its name, such as
flash.
If the storage media is on a subordinate switch, specify the storage media by giving its name
and the member ID of the switch, that is, in the format of slotslot-number# StorageMediumName
(slot-number represents the member ID of the subordinate), such as slot2#flash.
When you specify the masters boot file, the file-url parameter cannot contain the devices
member ID, and slot-number should be specified as the masters member ID.
When you specify the subordinate switchs boot file, the file-url argument must contain the
member ID (such as slot2#flash:/test.bin), and slot-number should be specified as the
subordinate switchs member ID.
If you provide the keyword all, the file-url parameter cannot contain a member ID, otherwise, the
execution of this command will fail. You must save the boot file on the storage media of all
member switches in the same filename, otherwise, member switches without this file will fail to
be reconfigured during the reboot.
The names of the files for the next boot of the master and subordinate switches may be different,
but the file versions must be the same, otherwise, a subordinate switch will reboot using the
master's boot file and rejoin the IRF virtual device.
Syntax
boot-loader file file-url slot { all | slot-number } { main | backup }
View
User view
Default level
3: Manage level
Parameters
file file-url: Specifies a file name, a string of 1 to 63 characters. If you enter a relative path here, the
system automatically converts it to an absolute path. The absolute path should contain no more than
63 characters; otherwise, the command cannot be successfully executed. The file name is in the
format of [drive:/]file-name, where the following conditions apply:
127
drive specifies the storage media of the file. The value is the name of the storage media. If a
device has only one storage media, you can execute this command without providing this
argument.
all: Specifies a file as the boot file at the next boot for all member switches of an IRF virtual
device. Support for this keyword depends on the device model.
slot-number: Specifies a file as the boot file at the next boot for a member switch. The slotnumber argument is the ID of a member switch of the current IRF virtual device.
main: Specifies a file as a main boot file. Use a main boot file to boot a device.
backup: Specifies a file as a backup boot file. Use a backup boot file to boot a device only when a
main boot file is unavailable.
Examples
# Specify the main boot file for the master (the member ID is 1) for the next device boot as test.bin.
(Make sure that the file test.bin is already saved on the storage media of the master; otherwise, the
system prompts an error, and the execution of the command fails.)
<Sysname> boot-loader file test.bin slot 1 main
This command will set the boot file of the specified board. Continue? [Y/N]:y
The specified file will be used as the main boot file at the next reboot on
slot 1!
# Specify the main boot file for the subordinate switch (the member ID is 2) for the next device boot
as test.bin. (Make sure that the file test.bin is already saved on the storage media of the subordinate
switch; otherwise, the system prompts an error, and the execution of the command fails.)
<Sysname> boot-loader file slot2#flash:/test.bin slot 2 main
This command will set the boot file of the specified board. Continue? [Y/N]:y
The specified file will be used as the main boot file at the next reboot on
slot 2!
# Specify the main boot file for all member switches for the next device boot as test.bin. (Make sure
that the file test.bin is already saved on the storage media of all the member switches; otherwise, the
system prompts an error and the execution of the command fails.)
<Sysname> boot-loader file test.bin slot all main
This command will set the boot file of the specified board. Continue? [Y/N]:y
The specified file will be used as the main boot file at the next reboot on
slot 1!
The specified file will be used as the main boot file at the next reboot on
slot 2!
Copying a boot file to an IRF member switch. If the all keyword is specified, the boot file is
copied to all the current IRF virtual devices member switches.
Specifying the file as the boot file to be used at the next boot of the member switch.
128
Syntax
boot-loader update file file-url slot { slot-number | all } { main | backup }
View
User view
Default level
3: Manage level
Parameters
file-url: Specifies a file name, a string of 1 to 63 characters. For more information, see boot-loader.
slot: Specifies the member ID of a device.
slot-number: Specifies to upgrade the boot file of a member switch. slot-number is the ID of a
member switch of the current IRF virtual device.
all: Specifies to upgrade boot files for or all member switches of an IRF virtual device.
main: Specifies a file as the main boot file. Use a main boot file to boot a device.
backup: Specifies a file as the backup boot file. Use a backup boot file to boot a device only when a
main boot file is unavailable.
Example
# Specify a boot file for the whole switch.
<Sysname> boot-loader update file main.bin slot all main
This command will update the specified boot file of all boards. Continue?
[Y/N]:Y
Now is updating, please wait...
<Sysname> reboot
bootrom
Description
Use bootrom to read, restore, back up, or upgrade the BOOT ROM program on specified member
switches. To execute the bootrom command, save the BOOT ROM program under the root directory
of the storage media on a member switch.
If the storage media is on the master, specify the storage media by giving its name, such as
flash.
If a storage media is on a subordinate switch, specify the storage media by giving its name and
the member ID of the device in the format of slotslot-number# StorageMediumName (slot-number
represents the subordinate switchs member ID), such as slot2#flash.
When you upgrade the masters BOOT ROM program, the file-url argument cannot contain the
devices member ID, and slot-number should be specified as the masters member ID.
When you upgrade the BOOT ROM program for a subordinate switch, the file-url argument must
contain the member ID (such as slot2#flash:/test.bin), the slot-number should be specified as the
subordinate switchs member ID, and the subslot-number-list argument should be specified as the
subordinate switchs subslot number.
129
Syntax
bootrom update file file-url slot slot-number-list
View
User view
Default level
3: Manage level
Parameters
update file file-url: Upgrades Boot ROM, where file-url is a string of 1 to 63 characters and represents
name of the file to be upgraded. For more information about the file-url argument, see boot-loader.
slot slot-number-list: Specifies a list of IDs of member switches, in the format of { slot-number [ to slotnumber ] }&<1-7>. The slot-number argument is the ID of a member switch of the current IRF virtual
device.
Examples
# Use a.btm file to upgrade the Boot ROM program on the master with member ID of 1.
<Sysname> bootrom update file a.btm slot 1
This command will update bootrom file on the specified board(s), Continue?
[Y/N]:y
Now updating bootrom, please wait...
Bootrom update succeeded in slot 1.
# Use the a.btm file to upgrade the Boot ROM program on the subordinate switch with member ID of
2. (The output of this command varies with devices.)
<Sysname> bootrom update file slot2#flash:/a.btm slot 2
This command will update bootrom file on the specified board(s), Continue?
[Y/N]:y
Now updating bootrom, please wait...
Bootrom update succeeded in slot 2.
By default, the validity check function is enabled at the time of upgrading BOOT ROM.
After the validity check function is enabled, the device will strictly check whether the BOOT ROM
upgrade files are valid and can match the hardware.
Use undo bootrom-update security-check enable to disable the validity check function.
Syntax
bootrom-update security-check enable
undo bootrom-update security-check enable
View
System view
130
Default level
2: System level
Parameters
None
Example
# Enable the validity check function when upgrading Boot ROM.
<Sysname> system-view
[Sysname] bootrom-update security-check enable
display boot-loader
Description
Use display boot-loader to display boot file information.
Related commands: boot-loader.
Syntax
display boot-loader [ slot slot-number ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
2: System level
Parameters
slot slot-number: Displays boot file information of a member switch. The slot-number argument is the
ID of a member switch of the current IRF virtual device.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see CLI configuration in the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display the file adopted for the current and next boot of the device. (The output of this command
varies with devices.)
<Sysname> display boot-loader
Slot 1
The current boot app is:
flash:/test.bin
flash:/test.bin
flash:/test.bin
131
Description
Slot 1
Boot file used for the device for the current device boot
Main boot file used for the next device boot of the device
Backup boot file used for the next device boot of the device
Syntax
display patch information [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
3: Manage level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see CLI configuration in the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display hotfix information.
<Sysname> display patch information
The location of patches: flash:
Slot Version
Start-Address
---------------------------------------------------------------------1
MPU
0x86262dd8
1.1
LPU
0x809533a4
132
Description
Patch file location. To configure the location, use the patch location
command.
Slot
Member ID.
Version
Patch version. The first three characters represent the suffix of the PATCHFLAG.
Temporary
Common
Current
Running
Active
Start-Address
patch active
Description
The command applies to only patches in the DEACTIVE state.
Use patch active to activate the specified patch.
After you execute the command, all the DEACTIVE patches before the specified patch are
activated.
After a system reboot, the original ACTIVE patches change to DEACTIVE and become invalid. To
make them effective, activate them again.
Syntax
patch active patch-number slot slot-number
View
System view
Default level
3: Manage level
Parameters
patch-number: Sequence number of a patch. The valid values of this argument depend on the patch
file used.
slot slot-number: Specifies the ID of a member switch of the current IRF virtual device.
Example
# Activate patch 3 and all the DEACTIVE patches before patch 3 on the device with member ID of 1.
<Sysname> system-view
[Sysname] patch active 3 slot 1
133
patch deactive
Description
This command is not applicable to the patches in the RUNNING state.
Use patch deactive to stop running the patch and all the ACTIVE patches after the patch.
All the ACTIVE patches (including the specified patch) turn to the DEACTIVE state.
Syntax
patch deactive patch-number slot slot-number
View
System view
Default level
3: Manage level
Parameters
patch-number: Sequence number of a patch. The valid values of this argument depend on the patch
file used.
slot slot-number: Specifies the ID of a member switch of the current IRF virtual device.
Example
# Stop running patch 3 and all the ACTIVE patches after patch 3 on the device with member ID of 1.
<Sysname> system-view
[Sysname] patch deactive 3 slot 1
patch delete
Description
Use patch delete to delete the specified patch and all the patches after the specified patch.
This command only removes the patches from the memory patch area, it does not delete them
from the storage media.
The patches are in the IDLE state after execution of this command.
Syntax
patch delete patch-number slot slot-number
View
System view
Default level
3: Manage level
134
Parameters
patch-number: Sequence number of a patch, with values depending on the patch file used.
slot slot-number: Specifies the ID of a member switch of the current IRF virtual device.
Example
# Delete patch 3 and all the patches after patch 3 on the device with member ID being 1.
<Sysname> system-view
[Sysname] patch delete 3 slot 1
patch install
Description
Before executing the command, save the patch files to root directories in the storage media of the
member switches.
Use patch install to install all the patches in one step. When you execute the patch install command,
the following message appears: Do you want to continue running patches after reboot? [Y/N]:
If you enter Y: All the specified patches are installed, and turn to the RUNNING state from IDLE.
This equals execution of the commands patch location, patch load, patch active, and patch run.
The patches remain RUNNING after system reboot.
If you enter N: All the specified patches are installed and turn to the ACTIVE state from IDLE. This
equals execution of the commands patch location, patch load and patch active. The patches turn
to the DEACTIVE state after system reboot.
Syntax
patch install patch-location
undo patch install
View
System view
Default level
3: Manage level
Parameter
patch-location: A string consisting of 1 to 64 characters. It specifies the directory where the patch file
locates. It can be a root directory of a storage media or be in the format of "root directory + patch
file name". Support for the argument depends on the device model.
135
Example
# Install the patches located on the Flash.
<Sysname> system-view
[Sysname] patch-install flash:
Patches will be installed. Continue? [Y/N]:y
Do you want to run patches after reboot? [Y/N]:y
Installing patches
Installation completed, and patches will continue to run after reboot.
[Sysname]
patch load
Description
Before executing the command, save the patch files to root directories in the storage media of the
member switches.
Use patch load to load the patch file on the storage media to the memory patch area.
Syntax
patch load slot slot-number
View
System view
Default level
3: Manage level
Parameter
slot slot-number: Specifies the ID of a member switch of the current IRF virtual device.
Example
# Load the patch file for the device with member ID of 1.
<Sysname> system-view
[Sysname] patch load slot 1
patch location
Description
Use patch location to configure the patch file location.
By default, the patch file location is flash:.
Syntax
patch location patch-location
View
System view
136
Default level
3: Manage level
Parameter
patch-location: Specifies the patch file location. It is a string of 1 to 64 characters.
Example
# Configure the root directory of the Flash as the patch file location.
<Sysname> system-view
[Sysname] patch location flash:
patch run
Description
This command applies to patches in the ACTIVE state only.
Use patch run to confirm the running of a specific patch and all the ACTIVE patches before the
specified patch.
With the slot parameter specified, the command confirms the running state of all qualified
patches on a member switch, including patches on the OAM CPU.
If the slot parameter is not specified, the command confirms the running state of qualified
patches on all member switches.
If the running of a patch is confirmed, after the system reboots, the patch will still be effective.
Syntax
patch run patch-number [ slot slot-number ]
View
System view
Default level
3: Manage level
Parameters
patch-number: Sequence number of a patch. The valid values of this argument depend on the patch
file used.
slot slot-number: Specifies the ID of a member switch of the current IRF virtual device.
Example
# Confirm the running of patch 3 and all the ACTIVE patches before patch 3 on the device with
member ID being 1.
<Sysname> system-view
[Sysname] patch run 3 slot 1
137
ISSU commands
display issu rollback-timer
Description
Use display issu rollback-timer to display information about the ISSU rollback timer.
A newly configured rollback timer takes effect in the next ISSU upgrade.
The current rollback timer may be greater than the newly configured rollback timer.
Syntax
display issu rollback-timer [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display information about the rollback timer.
<Sysname> display issu rollback-timer
RollBack timer is in process.
Configured Rollback Timer: 45 minutes.
Left: 43 minutes.
138
Description
No ISSU is performed.
The ISSU upgrade has completed.
The rollback timer has been deleted (the issu accept or issu commit
command deletes the rollback timer).
The remaining time in minutes before the rollback timer expires (it is
displayed only when the rollback timer is started).
Left
Syntax
display issu state [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
# Display the ISSU state before an ISSU upgrade.
<Sysname> display issu state
ISSU state: Init
Compatibility: Unknown
Work State: Normal
# After executing the issu load command, display the ISSU state on the master.
139
R1210
R1211
Description
Init: No ISSU upgrade starts or an ISSU process has completed.
Load: The specified subordinate switch has been upgraded. The
rollback timer is running.
Switchover: The master has been rebooted with the issu run
ISSU state
switchover command.
Accept: The ISSU upgrade has been accepted, and the rollback
Commit: Not all the IRF member switches have been upgraded. In
Compatible: The current boot file is compatible with the new boot
file.
Incompatible: The current boot file is incompatible with the new boot
Compatibility
file. The force keyword is required when you execute the issu load
command. The specified subordinate switch enters the Recover state
after rebooted with the new boot file.
Unknown: The specified boot file version does not support ISSU, or
the boot file cannot be upgraded through ISSU. In this mode, you
cannot upgrade the boot file of the IRF virtual switch through ISSU.
Upgrade Method
Original version
Upgrade version
New boot file version. If the new version is not available (N/A), it may
be that an IRF member switch is being upgraded and version
information exchange is not yet complete.
140
If you provide the upgrading-filename parameter, the compatibility information between the
specified boot file and the boot file is displayed.
Syntax
display version comp-matrix [ file upgrading-filename ] [ | { begin | exclude | include } regularexpression ]
View
Any view
Default level
1: Monitor level
Parameters
file upgrading-filename: Displays compatibility information between the specified new boot file and
the current boot file.
The specified upgrading-filename must exist in the Flash. The file name is in the format of [drive:/]filename, where the following conditions apply:
drive specifies the Flash of a member switch, and takes the format [ slotslot-number# ]flash:.
If you enter a relative path in the format of file-name, the system automatically converts it to an
absolute path in the format of [drive:/]file-name. The absolute path can contain no more than 63
characters.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
141
Examples
# Display the version compatibility database information of the current boot file.
<Sysname> display version comp-matrix
Number of Matrices in Table = 1
Matrix for HP A5800-24G-PoE+ Switch
Running Version:R1211
Version Compatibility List:
A1210 (Compatible)
# View the version compatibility information between the current boot file and the new boot file
bootfile.bin after executing the issu load command.
<Sysname> display version comp-matrix file bootfile.bin
Description
Number of Matrices in
Table
Matrix for xx
Running Version
AA (Compatible)
The boot file with version AA is compatible with the current boot file.
BB (Incompatible)
The boot file with version BB is incompatible with the current boot file.
You must provide the force keyword when you execute the issu load
command.
CC (Unknown)
Whether the boot file with version CC is compatible with the current boot
file is unknown.
issu accept
Description
Use issu accept to accept the ISSU upgrade and delete the auto-rollback timer.
With this command executed, the system deletes the rollback timer. IRF member switches cannot
automatically roll back to the previous version.
Syntax
issu accept slot slot-number
View
System view
142
Default level
2: System level
Parameters
slot slot-number: Specifies the ID of an IRF member switch. The ID must be the same as that in the
issu load command.
Related commands: issu load and issu commit.
Example
# Accept the ISSU upgrade for the IRF member switch in slot 1.
<Sysname> system-view
[Sysname] issu accept slot 1
issu commit
Description
Use issu commit to upgrade the specified member switch that is not upgraded.
Executing issu commit completes the ISSU upgrade process. You cannot perform a version rollback
operation with the issu rollback command.
Related commands: issu load and issu accept.
Syntax
issu commit slot slot-number
View
System view
Default level
2: System level
Parameter
slot slot-number: Specifies the ID of a member switch that is not upgraded.
Example
# Upgrade the member switch with ID 2.
<Sysname> system-view
[Sysname] issu commit slot 2
The specified board will reboot and be upgraded. Continue? [Y/N]:y
issu load
Description
Use issu load file upgrading-filename slot slot-number [ force ] to upgrade the specified subordinate
switch. When this command executes, the subordinate switch reboots with the new boot file.
Before executing the issu load command, verify the following conditions:
143
The master and subordinate switch must run the same boot file (same version, name, and
directory).
The new boot file has been saved in the Flash of each IRF member switch.
Syntax
issu load file upgrading-filename slot slot-number [ force ]
View
System view
Default level
2: System level
Parameters
file upgrading-filename: Name of the new boot file, a string of 1 to 63 characters.
The upgrading-filename must exist in the Flash. The file name is in the format of [drive:/]file-name,
where the following conditions apply:
drive specifies the Flash of a member switch, and takes the format [ slot slot-number# ]flash:.
If you enter a relative path in the format of file-name, the system automatically converts it to an
absolute path in the format of [drive:/]file-name. The absolute path can contain no more than 63
characters.
slot slot-number: Specifies the ID of an IRF member switch.
force: Forces the IRF member switch to upgrade its incompatible boot file.
If the boot file specified by upgrading-filename is incompatible with the boot file, you must
provide this key word to ISSU.
If the boot file specified by upgrading-filename is compatible with the boot file, this keyword is
not necessary to upgrade.
Example
# Upgrade the subordinate switch with ID 2 by using upgrade file new.bin.
<Sysname> system-view
[Sysname] issu load file new.bin slot 2
This command will begin ISSU, and the specified board will reboot and be upgrade
d. Please save the current running configuration first; otherwise, the configura
tion may be lost. Continue? [Y/N]: y
issu rollback
Description
Use issu rollback to cancel the ISSU upgrade and revert to the previous version.
If the IRF member switch is rebooting, you cannot perform the manual rollback operation.
144
After you execute the issu commit command for a member switch, the member switch reboots
with the new boot file. During the reboot, you cannot perform any manual rollback operation.
Syntax
issu rollback slot slot-number
View
System view
Default level
2: System level
Parameter
slot slot-number: Specifies the ID of an upgraded member switch. The value must be the same as that
specified in the issu load command.
Example
# Assume that the member ID specified in the issu load command is 1. Cancel the ISSU upgrade on
the member switch with ID 1 and roll back the boot file to the previous version.
<Sysname> system-view
[Sysname] issu rollback slot 1
This command will quit the ISSU process and the specified board
to the previous version. Continue? [Y/N]:y
issu rollback-timer
Description
Use issu rollback-timer to set the rollback timer.
With the issu load command executed, the system automatically creates a version rollback timer.
If you execute the issu rollback-timer command during an ISSU upgrade process, the newly
configured rollback timer takes effect for the next ISSU upgrade.
The system automatically stops the ISSU upgrade and reverts to the previous boot file version if
IRF member switches are not upgraded with the issu accept command
the auto-rollback function is not disabled with issu commit command before the specified
rollback timer expires.
Use undo issu rollback-timer to restore the default (45 minutes is the default value).
145
Syntax
issu rollback-timer minutes
undo issu rollback-timer
View
System view
Default level
2: System level
Parameter
minutes: Rollback timer in minutes, ranging from 0 to 120. The value of 0 indicates that the version
rollback function is disabled and the rollback timer is not created when you execute the issu load
command.
Example
# Set the rollback timer value to 30 minutes.
<Sysname> system-view
[Sysname] issu rollback-timer 30
The un-upgraded IRF member switches are not upgraded with the issu accept command.
The auto-rollback function is not disabled with issu commit command before the specified
rollback timer expires.
During compatible ISSU upgrade, after you execute the issu load command, the system
automatically creates a version rollback timer.
During incompatible ISSU upgrade, the process is completed when the IRF member switches accept
the specified subordinate switch reboot with the new boot file.
If you do not upgrade IRF member switches with the issu accept command or you do not disable
the auto-rollback function with issu commit command before the specified rollback timer expires,
the system automatically stops the ISSU upgrade and reverts to the previous boot file version.
During incompatible ISSU upgrade, when you execute the issu run switchover command, the IRF
member switches (except the specified subordinate switch) reboot with the new boot file, and then the
ISSU upgrade process is completed.
Related commands: issu load.
Syntax
issu run switchover slot slot-number
View
System view
146
Default level
2: System level
Parameter
slot slot-number: Specifies the ID of an upgraded member switch. The value must be the same as that
specified in the issu load command.
Example
# Reboot the master.
<Sysname> system-view
[Sysname] issu run switchover slot 1
Master will reboot, switch the specified board to master and update the line
card. Continue? [Y/N]:y
147
Syntax
clock datetime time date
View
User view
Default level
3: Manage level
Parameters
time: Configured 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: Configured 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.
Examples
# Set the current system time to 14:10:20 08/01/2011.
<Sysname> clock datetime 14:10:20 8/1/2011
By default, daylight saving time is configured on the device, and the universal time coordinated
(UTC) time zone is applied.
If the devices standard time is in the range specified with this command, the system time
automatically adds add-time after the command executes.
148
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.
To view your configuration after it takes effect, use the display clock command. The time
displayed in the log or debug information is the adjusted local time.
Use undo clock summer-time to cancel the configuration of the daylight saving time.
Related commands: display clock, clock datetime, clock summer-time repeating, and clock timezone.
Syntax
clock summer-time zone-name one-off start-time start-date end-time end-date add-time
undo clock summer-time
View
System view
Default level
3: Manage level
Parameters
zone-name: Name of the daylight saving time, a case-sensitive string of 1 to 32 characters.
start-time: Start time, in the hh:mm:ss format. Zeros can be omitted, unless you specify 00:00:00.
start-date: Start date, in the MM/DD/YYYY or YYYY/MM/DD format.
end-time: End time, in the hh:mm:ss format. Zeros can be omitted, unless you specify 00:00:00.
end-date: End date, in the MM/DD/YYYY or YYYY/MM/DD format.
add-time: Time added to the standard time of the device, in the hh:mm:ss format. Zeros can be
omitted, unless you specify 00:00:00.
Example
# For daylight saving time in abc1 between 06:00:00 on 08/01/2011 and 06:00:00 on
09/01/2011, set the system clock ahead one hour.
<Sysname> system-view
[Sysname] clock summer-time abc1 one-off 6 08/01/2011 6 09/01/2011 1
By default, daylight saving time is configured on the device, and the UTC time zone is applied.
To view the result after the configuration takes effect, use the display clock command. The time
displayed in the log or debug information is the adjusted local time.
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. For example, if you specify start-date and start-time as 2007/6/6 and
00:00:00, end-date and end-time as 2007/10/01 and 00:00:00, and add-time to 01:00:00,
149
the daylight saving time range is from 00:00:00 of June 6 to 00:00:00 of October 1 each year
from 20072007 inclusive. The daylight saving time adds one hour to the standard time of the
device.
If the standard time of the device is in the time range specified with this command, the system
time automatically adds add-time after the this command executes.
Use undo clock summer-time to cancel the configuration of the daylight saving time.
Related commands: display clock, clock datetime, clock summer-time one-off, and clock timezone.
Syntax
clock summer-time zone-name repeating start-time start-date end-time end-date add-time
undo clock summer-time
View
System view
Default level
3: Manage level
Parameters
zone-name: Name of the daylight saving time, a string of 1 to 32 characters.
start-time: Start time, in the hh:mm:ss format. Zeros can be omitted, unless you specify 00:00:00.
start-date: 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: End time, in the hh:mm:ss format . Zeros can be omitted, unless you specify 00:00:00.
end-date: 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: Time added to the standard time of the device, in the hh:mm:ss format. Zeros can be
omitted, unless you specify 00:00:00.
150
Example
# For the daylight saving 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> system-view
[Sysname] clock summer-time abc2 repeating 06:00:00 08/01/2007 06:00:00
09/01/2007 01:00:00
clock timezone
Description
Use clock timezone to set the local time zone displayed in the log and debug information.
To view the result after the configuration takes effect, use the display clock command.
The time displayed in the log or debug information is the specified local time zone.
Use undo clock timezone to restore the local time zone as the default UTC time zone.
Related commands: display clock, clock datetime, clock summer-time one-off, and clock summertime repeating.
Syntax
clock timezone zone-name { add | minus } zone-offset
undo clock timezone
View
System view
Default level
3: Manage level
Parameters
zone-name: Time zone name, a case-sensitive string of 1 to 32 characters.
add: Adds a offset to UTC time.
minus: Subtracts a offset to UTC time.
zone-offset: Offset to the UTC time, in the hh:mm:ss format, where the hh value ranges from 0 to 23,
the mm value ranges from 0 to 59, and the ss value ranges from 0 to 59. Zeros can be omitted,
unless you specify 00:00:00.
Example
# Set the name of the local time zone to Z5, five hours ahead of UTC time.
<Sysname> system-view
[Sysname] clock timezone z5 add 5
copyright-info enable
Description
Use copyright-info enable to display copyright information.
151
Syntax
copyright-info enable
undo copyright-info enable
View
System view
Default level
3: Manage level
Parameters
None
Examples
1.
If a user logs in to the device through Telnet, the following information is displayed:
*************************************************************************
***
* Copyright (c) 2010-2011 Hewlett-Packard Development Company, L.P.
*
* Without the owner's prior written consent,
*
* no decompiling or reverse-engineering shall be allowed.
*
*************************************************************************
***
<Sysname>
If a user has already logged in through the console port, and then quits user view, the following
information is displayed:
*************************************************************************
***
* Copyright (c) 2010-2011 Hewlett-Packard Development Company, L.P.
*
* Without the owner's prior written consent,
*
* no decompiling or reverse-engineering shall be allowed.
*
*************************************************************************
***
User interface aux0 is available.
Please press ENTER.
152
2.
If a user logs in to the device through Telnet, the following information is displayed:
<Sysname>
If a user has already logged in through the console port, and then quits user view, the following
information is displayed:
User interface aux0 is available.
display clock
Description
Use display clock to view the current system time and date.
The current system time and date are determined 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 the Fundamentals Configuration Guide.
Related commands: clock datetime, clock summer-time one-off, clock summer-time repeating, and
clock timezone.
Syntax
display clock [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display the current time and date.
<Sysname> display clock
09:41:23 UTC Thu 12/15/2011
153
display cpu-usage
Description
Use display cpu-usage to view the CPU usage statistics.
The system takes CPU usage statistics at intervalsusually every 60 secondsand saves them in
the history record area.
display cpu-usage entry-number indicates the system displays entry-number records from the
latest record.
display cpu-usage entry-number offset indicates the system displays number records from the last
but offset record.
Syntax
display cpu-usage [ slot slot-number [ cpu cpu-number ] ] [ | { begin | exclude | include } regularexpression ]
display cpu-usage entry-number [ offset ] [ verbose ] [ slot slot-number [ cpu cpu-number ] ] [ |
{ begin | exclude | include } regular-expression ]
View
Any view
Default 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 statistics record to be displayed and
that of the last CPU usage 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 makes CPU usage
statistics periodically, and the system records the average CPU usage during this period, and the idx
value is added by 1 automatically.
verbose: Displays detailed information of CPU usage statistics. If this keyword is provided, the system
displays the average CPU usage statistics for each task in the specified period. If this keyword is not
provided, the system displays the brief information of the CPU usage statistics.
slot slot-number: Displays the statistics of the CPU usage of a specific member device. The slot-number
argument is the ID of a member device of the current IRF virtual device. If the slot-number argument is
not provided, the system displays the statistics of the CPU usage of all member devices.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
154
Examples
1.
2.
Display the last fifth and sixth records of the CPU usage statistics history.
<Sysname> display cpu-usage 2 4
===== CPU usage info (no:
: 3%
10:56:55
CPU Usage Stat. Tick : 0x1d9d(CPU Tick High) 0x3a659a70(CPU Tick Low)
Actual Stat. Cycle
: 3%
10:55:55
CPU Usage Stat. Tick : 0x1d9c(CPU Tick High) 0xa50e5351(CPU Tick Low)
Actual Stat. Cycle
155
Description
1% in last 5 seconds
After the device boots, the system calculates and records the average CPU
usage in every five seconds.
This field displays the average CPU usage in the last five seconds.
1% in last 1 minute
After the device boots, the system calculates and records the average CPU
usage in every one minute.
This field displays the average CPU usage in the last minute.
1% in last 5 minutes
After the device boots, the system calculates and records the average CPU
usage in every five minutes.
This field displays the average CPU usage in the last five minutes.
The CPU usage of the device with the member ID of 2). (On a centralized
IRF member device).
CPU Usage
CPU usage statistics time in seconds, that is, the system time when the
command is executed.
The x-axis indicates the CPU usage, rounded up or down in 5% increments. For example, an
actual statistical value of 53% is rounded up and displayed as 55%, and an actual statistical
value of 52% is rounded down and displayed as 50%.
156
Consecutive pound marks (#) indicate CPU usage at a certain moment. The value of the x-axis
corresponding to the # mark on the top of a moment is the CPU usage at that moment.
Syntax
display cpu-usage history [ task task-id ] [ slot slot-number [ cpu cpu-number ] ] [ | { begin | exclude
| include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
task task-id: Displays the history statistics of the CPU usage of a specific task, where task-id represents
the task number. If the task-id argument is not provided, the system displays the history statistics of the
CPU usage of the entire system. The CPU usage of the entire system is the sum of CPU usages of all
tasks.
slot slot-number: Displays the history statistics of the CPU usage of a specific member device. slotnumber is the ID of a member device of the current IRF virtual device. If the slot-number argument is
not provided, the system displays the history statistics of the CPU usage of the master.
cpu cpu-number: Displays the history statistics of the CPU usage of a specific CPU. Support for this
keyword depends on your device model. If the cpu-number argument is not provided, the system
displays the history statistics of the CPU usage of the main CPU.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
157
Example
# Display the CPU usage statistics of the whole system.
<Sysname> display cpu-usage history
100%|
95%|
90%|
85%|
80%|
75%|
70%|
65%|
60%|
55%|
50%|
45%|
40%|
35%|
30%|
25%|
20%|
15%|
10%|
###
5%|
########
-----------------------------------------------------------10
20
30
40
50
60
(minutes)
The output shows the CPU usage of the whole system (with the task name SYSTEM) in the last 60
minutes:
158
-----------------------------------------------------------10
20
30
40
50
60
(minutes)
The output shows the CPU usage of task 6 (with the task name T03M) in the last 60 minutes:
display device
Description
Use display device to view device information.
Syntax
display device [ usb ] [ [ slot slot-number [ subslot subslot-number ] ] | verbose ] [ | { begin | exclude
| include } regular-expression ]
View
Any view
Default level
2: System level
159
Parameters
usb: Displays the information of the device connected with the universal serial bus (USB) interface.
slot slot-number: Displays the information of a specific member device. The slot-number argument is
the ID of a member device of the current IRF virtual device.
subslot subslot-number: Displays the information for a host or subcard (interface card or OAP card).
The subslot-number represents the subslot of the host or subcard. If the switch does not support the
subcard or the subcard is not installed, slot number 0 is displayed.
verbose: Displays detailed information.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display the information of all IRF member devices. (The output of this command varies with devices.)
<Sysname> display device
Slot 1
SubSNo PortNum PCBVer
State
NULL
Normal
18
Ver.B
IVL
MAIN
Slot 2
SubSNo PortNum PCBVer
State
18
Ver.A
NULL
IVL
MAIN
Normal
Ver.A
NULL
001
NULL
IVL
LSW1SP4P0
Normal
Ver.B
NULL
001
NULL
IVL
LSW1XP4P0
Normal
Slot 3
SubSNo PortNum PCBVer
State
NULL
Normal
18
Ver.B
IVL
MAIN
Slot 4
SubSNo PortNum PCBVer
State
NULL
Normal
18
Ver.B
160
IVL
MAIN
Description
Slot 1
SubSNo
0Host slot.
1Subcard slot 1.
2Subcard slot 2.
PortNum
PCBVer
FPGAVer
CPLDVer
BootRomVer
AddrLM
Type
State
Normal.
Absent.
Fault.
Electrical label information also called permanent configuration data or archive information is
written to the devices storage medium during debugging and testing. The information includes
name of the card, device serial number, and vendor name.
Syntax
display device manuinfo [ slot slot-number [ fan fan-id | power power-id | subslot subslot-number ] ]
[ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
3: Manage level
161
Parameters
slot slot-number: Displays electrical label information for a member device. The slot-number argument
is the ID of a member device of the current IRF virtual device. If the slot-number argument is not
provided, the system displays the electrical label information of all member devices.
fan fan-id: Displays the electrical label information for a fan.
power power-id: Displays the electrical label information for a
power-id represents the PSU number.
subslot subslot-number: Displays electrical label information about the interface card or OAP card.
The subslot-number represents the number of the slot where the interface card or OAP card resides.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
1.
: A5800AF-48G JG225A
DEVICE_SERIAL_NUMBER : CN13F5D001
MAC_ADDRESS
: 20FDF1AC81BB
MANUFACTURING_DATE
: 2011-03-10
VENDOR_NAME
: HP
Power 1:
DEVICE_NAME
: NONE
: US0BF64123
MANUFACTURING_DATE
: NONE
VENDOR_NAME
: NONE
Power 2:
DEVICE_NAME
: NONE
: US0BF75832
MANUFACTURING_DATE
: NONE
VENDOR_NAME
: NONE
Fan 1:
DEVICE_NAME
DEVICE_SERIAL_NUMBER : WB12FDD001
MANUFACTURING_DATE
: 2011-03-25
VENDOR_NAME
: HP
162
Fan 2:
DEVICE_NAME
DEVICE_SERIAL_NUMBER : WB12FDD521
2.
MANUFACTURING_DATE
: 2011-03-25
VENDOR_NAME
: HP
Display electrical label information (on a switch except the 5800AF-48G Switch(JG225A) or
5820AF-24XG Switch(JG219A)).
<Sysname> display device manuinfo
Slot 1:
DEVICE_NAME
: A5800-24G-PoE+ JC099A
DEVICE_SERIAL_NUMBER : CN13F5D653
MAC_ADDRESS
: 00238927AFDB
MANUFACTURING_DATE
: 2011-03-24
VENDOR_NAME
: HP
Power 1:
MANU SERIAL NUMBER
: NONE
Fan 1:
DEVICE_NAME
: NONE
DEVICE_SERIAL_NUMBER : NONE
MANUFACTURING_DATE
: NONE
VENDOR_NAME
: NONE
Description
Slot
IRF member ID
Fan
Fan ID
Power
PSU ID
DEVICE_NAME
Device name
DEVICE_SERIAL_NUMBER
MAC_ADDRESS
MANUFACTURING_DATE
VENDOR_NAME
Vendor name
163
display diagnostic-information
Description
Use display diagnostic-information to view or save running status statistics of multiple modules in the
system.
During daily maintenance or when the system is out of order, display the running information of
each functional module to locate the problem.
Execute the display diagnostic-information for multiple modules running in the system; each
module has independent information.
Syntax
display diagnostic-information [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
1.
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.
164
2.
Omitted
display environment
Description
Use display environment to view device temperature information, including the current temperature
and temperature thresholds.
If the slot parameter is not specified, this command displays the temperature information of all sensors
on the IRF member device.
Related commands: temperature-limit.
Syntax
display environment [ slot slot-number] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
slot slot-number: Displays the temperature information of the sensors on the member device. The slotnumber argument is the ID of a member device of the current IRF virtual device.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
165
Example
# Display temperature information (the output varies with devices).
<Sysname> display environment
Slot 1
System temperature information (degree centigrade):
------------------------------------------------------------------------------Sensor
Temperature
LowerLimit
hotspot 1
44
WarningLimit
70
AlarmLimit ShutdownLimit
80
NA
hotspot 2
37
-10
125
135
NA
Description
Slot
Sensor
Temperature sensor.
Temperature
LowerLimit
WarningLimit
AlarmLimit
ShutdownLimit
display fan
Description
Use display fan to view fan operating states.
Related commands: fan prefer-direction.
Syntax
display fan [ slot slot-number [ fan-id ] ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
166
Parameters
slot slot-number: Displays the operating state of fans for a member device. The slot-number argument
is the ID of a member device of the current IRF virtual device. If the slot-number argument is not
provided, the system displays the operating state of fans of all member devices.
fan-id: Displays the operating state of the fan, where fan-id represents the built-in fan number. Support
for this argument and the value range depend on your device model.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Examples
1.
Display the operating states of all fans (on the 5800AF-48G Switch(JG225A) or 5820AF-24XG
Switch(JG219A)).
<Sysname> display fan
Slot 1
FAN
State
: Normal
Wind Direction
:Power-to-Port
State
: Normal
Wind Direction
:Power-to-Port
2.
:Power-to-Port
:Power-to-Port
Display the operating states of all fans (on the switch except the 5800AF-48G Switch(JG225A)
or 5820AF-24XG Switch(JG219A)).
<Sysname> display fan
Slot 1
FAN
State
1
: Normal
167
Description
Slot 1
Member device 1
FAN
Fan ID
State of the fan:
State
Normal
Absent
Fault
Actual ventilation direction:
Wind Direction
Power-to-Port
Port-to-Power
Preferred ventilation direction:
Power-to-Port
Port-to-Power
display job
Description
Use display job to view detailed information about scheduled tasks that are automatically executed.
If no parameters are specified, details about all scheduled tasks are displayed.
Syntax
display job [ job-name ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
job-name: Specifies the task name, a string of 1 to 32 characters.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
168
Example
# Display configurations of all scheduled tasks.
<System> dis job
Job name: phone
Specified view: GigabitEthernet1/0/2
Time 1: Execute command poe enable at 08:00 Mondays Tuesdays Wednesdays
Thursdays Fridays
Description
Job name
Specified view
display memory
Description
Use display memory to display a devices memory usage.
If the slot parameter is not provided, the system displays the masters memory usage.
If the cpu parameter is not provided, the system displays the main CPU memory.
Syntax
display memory [ slot slot-number [ cpu cpu-number ] ] [ | { begin | exclude | include } regularexpression ]
View
Any view
Default level
1: Monitor level
Parameters
slot slot-number: Displays the memory of a CPU for a member device. The slot-number argument is
the ID of a member device of the current IRF virtual device.
cpu cpu-number: Displays the memory of a CPU, where cpu-number represents the ID of the CPU.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
169
Example
# 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%
Description
Used Rate
display power
Description
Use display power to display a devices PSU information.
Syntax
display power [ slot slot-number [ power-id ] ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
slot slot-number: Displays the information of the power supply units (PSUs) of the member device. The
slot-number argument is the ID of a member device of the current IRF virtual device.
power-id: Displays the information for a PSU, where power-id represents the PSU number.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
170
Example
Display the PSU information of the device.
<Sysname> display power
Slot 1
Power
State
: Normal
Type
: AC
Slot 2
Power
State
: Normal
Type
: AC
Power
State
: Normal
Type
: AC
Description
Slot 1
Power
State
Normal.
Absent.
Fault.
PSU type:
Type
DC.
AC.
display reboot-type
Description
Use display reboot-type to view the devices reboot mode. If no parameters are provided, the system
displays the masters reboot mode.
Syntax
display reboot-type [ slot slot-number ] ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
2: System level
171
Parameters
slot slot-number: Displays reboot mode for a member device. The slot-number argument is the ID of a
member device of the current IRF virtual device.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display the reboot mode of the device.
<Sysname> display reboot-type
The rebooting type this time is: Cold
The output shows that the last reboot mode of the device is Cold bootthe 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 rps
Description
This command is available only for the switches that support RPS.
Use display rps to display RPS status.
Syntax
display rps [ slot slot-number [ rps-id ] ] [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
slot slot-number: Displays the RPS status of the member device. The slot-number is the ID of a member
device of the current IRF virtual device. If the slot-number is not provided, the system displays the RPS
status of all IRF members.
rps-id: Displays the status of the RPS, where rps-id represents the RPS number. The value varies with
devices.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
172
Example
# Display RPS status.
<Sysname> display rps
Slot 1
Power
State
: Absent
Slot 2
Power
State
: Absent
Description
Slot 1
Member device 1
Power
RPS ID
RPS state:
State
Normal
Absent
Fault
Syntax
display schedule job [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
173
Example
# Display the configuration of the scheduled task configured by 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
system displays nothing.
Table 30 Command output
Field
Description
Specified command
Command to be executed
Specified view
Executed time
Syntax
display schedule reboot [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
3: Manage level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
174
Example
# Display the reboot time of a device.
<Sysname> display schedule reboot
System will reboot at 16:00:00 03/10/2011 (in 2 hours and 5 minutes).
The output shows that the system will reboot at 16:00:00 on March 10, 2011in two hours and five
minutes.
display system-failure
Description
Use display system-failure to view the exception handling method of all member devices of an IRF
virtual device.
Related commands: system-failure.
Syntax
display system-failure [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
3: Manage level
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display the exception handling method.
<Sysname> display system-failure
System failure handling method: reboot
display transceiver
Description
Use display transceiver to display main parameters of a single or all pluggable transceivers.
Syntax
display transceiver interface [ interface-type interface-number ] [ | { begin | exclude | include }
regular-expression ]
175
View
Any view
Default level
2: System level
Parameters
interface [ interface-type interface-number ]: Displays main parameters of the pluggable transceiver
plugged in the interface. interface-type interface-number represents interface type and interface
number. If it is not , the command displays main parameters of the pluggable transceivers in all the
interfaces.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display main parameters of the pluggable transceiver plugged in interface GigabitEthernet 1/0/3.
(The output of this command varies with devices.)
<Sysname> display transceiver interface gigabitethernet1/0/3
GigabitEthernet1/0/3 transceiver information:
Transceiver Type
: 1000_BASE_SX_SFP
Connector Type
: LC
Wavelength(nm)
: 850
Transfer Distance(m)
: 550(50um),270(62.5um)
: HP
Ordering Name
: JD118B
176
Description
transceiver information
Transceiver Type
Connector Type
Wavelength(nm)
Transfer distance(xx)
Digital Diagnostic
Monitoring
YESSupported.
NONot supported.
Vendor Name
Vendor name.
Ordering Name
Product code.
Table 32 shows the alarm information that might occur to the commonly used transceivers.
177
Remarks
SFP/SFP+
RX loss of signal
RX power high
RX power low
TX fault
TX bias high
TX bias low
TX power high
TX power is high.
TX power low
TX power is low.
Temp high
Temperature is high.
Temp low
Temperature is low.
Voltage high
Voltage is high.
Voltage low
Voltage is low.
Syntax
display transceiver alarm interface [ interface-type interface-number ] [ | { begin | exclude |
include } regular-expression ]
View
Any view
Default level
2: System level
Parameters
interface [ interface-type interface-number ]: Displays the current alarm information of the pluggable
transceiver plugged in the specified interface. interface-type interface-number represents interface
type and interface number. If not specified, displays the current alarm information of the pluggable
transceiver in all the interfaces.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
178
Example
# Display the alarm information of the pluggable transceiver plugged in interface GigabitEthernet
1/0/1. (The output of this command varies with devices.)
<Sysname> display transceiver alarm interface gigabitethernet1/0/1
GigabitEthernet1/0/1 transceiver current alarm information:
RX loss of signal
RX power low
Description
RX loss of signal
RX power low
Syntax
display transceiver diagnosis interface [ interface-type interface-number ] [ | { begin | exclude |
include } regular-expression ]
View
Any view
Default level
2: System level
Parameters
interface [ interface-type interface-number ]: Displays the currently measured value of digital
diagnosis parameters of the transceiver plugged in the interface. interface-type interface-number
represents interface type and interface number. If not specified, displays the currently measured value
of digital diagnosis parameters of transceivers in all the interfaces.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
179
Example
# Display the currently measured values of the digital diagnosis parameters of the optical transceiver
in interface GigabitEthernet 1/0/2. (The output of this command varies with devices.)
<Sysname> display transceiver diagnosis interface gigabitethernet1/0/2
GigabitEthernet1/0/2 transceiver diagnostic information:
Current diagnostic parameters:
Temp(C)
Voltage(V)
Bias(mA)
RX power(dBm)
36
3.31
6.13
-35.64
TX power(dBm)
-5.19
Description
Temp.(C)
Voltage(V)
Bias(mA)
RX power(dBm)
TX power(dBm)
Syntax
display transceiver manuinfo interface [ interface-type interface-number ] [ | { begin | exclude |
include } regular-expression ]
View
Any view
Default level
2: System level
180
Parameters
interface [ interface-type interface-number ]: Displays the electrical label information of the transceiver
plugged in the interface. interface-type interface-number represents interface type and interface
number. If it is not specified, the command displays part of the electrical label information of the
pluggable transceivers in all the interfaces.
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display the electrical label information of the transceiver plugged in interface GigabitEthernet
1/0/4. (The output of this command varies with devices.)
<Sysname> display transceiver manuinfo interface gigabitethernet1/0/4
GigabitEthernet1/0/4 transceiver manufacture information:
Manu. Serial Number
: 213410A0000054000251
Manufacturing Date
: 2011-03-01
Vendor Name
: HP
Description
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.
display version
Description
Use display version to view current system software version information.
Syntax
display version [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
1: Monitor level
181
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display system version information. (The output depends on your device model and the device
version)
<Sysname> display version
HP Comware Platform Software
Comware Software, Version 5.20, Release 1211
Copyright (c) 2010-2011 Hewlett-Packard Development Company, L.P.
HP A5800-24G-PoE+ Switch uptime is 0 week, 0 day, 0 hour, 20 minutes
bytes SDRAM
4M
512M
display version-update-record
Description
Use display version-update-record to view the device softwares update records.
When the device boots, the system records the device software version. If the software is updated
when the device is running, the system records update time and software version. Currently, the
system keeps 10 records.
Related commands: reset version-update-record.
Syntax
display version-update-record [ | { begin | exclude | include } regular-expression ]
View
Any view
Default level
3: Manage level
182
Parameters
|: Filters command output by specifying a regular expression. For more information about regular
expressions, see the Fundamentals Configuration Guide.
begin: Displays the first line that matches the regular expression and all lines that follow.
exclude: Displays all lines that do not match the regular expression.
include: Displays all lines that match the regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Example
# Display the version update records of the device software.
<Sysname> display version-update-record
No. Update time
1
2009-09-28 14:39:11
version
5.20 Release 0000
Description
No.
Serial number
Version
fan prefer-direction
Description
This command is available only for the 5800AF-48G Switch(JG225A) or 5820AF-24XG
Switch(JG219A). If one or both the two fan trays have a different ventilation direction from the switch,
the system outputs traps and logs for you to replace the wrong ones or modify the fan ventilation
direction for the switch.
Use fan prefer-direction to configure the fan ventilation direction.
Use undo fan prefer-direction to restore the default (fan ventilation direction is power-to-port by
default).
Related commands: display fan.
Syntax
fan prefer-direction slot slot-number { power-to-port | port-to-power }
undo fan prefer-direction slot slot-number
View
System view
Default level
2: System level
183
Parameters
slot slot-number: Configures the fan ventilation direction of the member device. The slot-number is the
ID of a member device of the current IRF virtual device.
power-to-port: Specifies the fan ventilation direction from the PSU side to the port side.
port-to-power: Specifies the fan ventilation direction from the port side to the PSU side.
Example
# Configure the fan ventilation direction as port-to-power.
<Sysname> system-view
[Sysname] fan prefer-direction port-to-power
header
Description
Use header to create a banner.
Use undo header to clear a banner.
Syntax
header { incoming | legal | login | motd | shell } text
undo header { incoming | legal | login | motd | shell }
View
System view
Default level
2: System level
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 in to 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. For more information, see the Fundamentals
Configuration Guide.
184
Examples
1.
2.
Test the configuration by using Telnet. The login banner can be displayed only when login
authentication is configured.
*************************************************************************
***
* Copyright (c) 2010-2011 Hewlett-Packard Development Company, L.P.
*
* Without the owner's prior written consent,
*
* no decompiling or reverse-engineering shall be allowed.
*
*************************************************************************
***
Password:
Welcome to shell(header shell)
<Sysname>
185
job
Description
Use job to create a scheduled task or enter scheduled task view. You can create up to 100 scheduled
tasks, each task is uniquely identified by its job-name.
Use undo job to restore the default (no scheduled task is created).
Syntax
job job-name
undo job job-name
View
System view
Default level
3: Manage level
Parameter
job-name: Name of a scheduled task, a string of 1 to 32 characters.
Example
# Create a scheduled task or enter an existing scheduled task view.
<Sysname> system-view
[Sysname] job saveconfig
[Sysname-job-saveconfig]
reboot
Description
CAUTION:
Device reboot might result in the interruption of the ongoing services. Use these commands with
caution.
If a main boot file fails or does not exist, the device cannot be rebooted with the reboot command. In
this case, re-specify a main boot file, or power off the device and then power it on. The system
automatically uses the backup boot file to restart the device.
If you are performing file operations when the device will be rebooted, the system does not execute
the command for the sake of security.
Use reboot to reboot a member device, a subcard, or all member devices.
You can use reboot [ slot slot-number ] on the master to reboot it or a subordinate device. If the slot
parameter is not provided, all member devices reboot.
Syntax
reboot [ slot slot-number ]
View
User view
186
Default level
3: Manage level
Parameter
slot slot-number: Specifies a device by its member ID of the IRF virtual device.
Examples
1.
If the current configuration does not change, reboot the device. (The output of this command
varies with devices.)
<Sysname> reboot
Start to check configuration with next startup configuration file, please
wait.........DONE!
This command will reboot the device. Continue? [Y/N]:y
2.
If the current configuration changes, reboot the device. (The output of this command varies with
devices.)
<Sysname> reboot
Start to check configuration with next startup configuration file, please wait.
........DONE!
This command will reboot the device. Current configuration will be lost, save c
urrent configuration? [Y/N]:y
Please input the file name(*.cfg)[flash:/config.cfg]
(To leave the existing filename unchanged, press the enter key):
flash:/config.cfg exists, overwrite? [Y/N]:y
Validating file. Please wait....
Saved the current configuration to mainboard device successfully.
Configuration is saved to device successfully.
This command will reboot the device. Continue? [Y/N]:y
Syntax
reset unused porttag
View
User view
Default level
1: Monitor level
Parameters
None
187
Example
# 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>
reset version-update-record
Description
Use reset version-update-record to clear the records of updating the device software.
Related commands: display version-update-record.
Syntax
reset version-update-record
View
System view
Default level
3: Manage level
Parameters
None
Example
# Clear the records of updating the device software.
<Sysname> system-view
[Sysname] reset version-update-record
schedule job
Description
Use schedule job to schedule a task.
If you provide both the time1 and date parameters, the execution time must be in the future.
If you provide only a time1 parameter earlier than the current system time, the command
executes at time1 of the next day.
If you provide only a time1 parameter later than the current system time, the command executes
at time1 of the current day.
When using the at or delay parameter, the difference between the execution time of the
command and the current system time cannot exceed 720 hours (30 days).
If you change the system time after the scheduled task is configured, the task becomes invalid.
Only the latest configuration takes effect if you execute the schedule job command repeatedly.
The system does not check the values of the view and command parameters. You must ensure the
commands and their corresponding views are correct for the commands to execute.
The system does not require any interactive information when executing the schedule task. The
system will automatically input confirmation and default or empty character strings as needed.
188
The operation interface, command view and status of the current user are not changed after
execution if a scheduled task contains commands used to switch user interfaces (such as telnet,
ftp, and ssh2), commands used to switch views (such as system-view and quit), or commands
used to modify status of a user executing commands (such as super).
Syntax
schedule job { at time1 [ date ] | delay time2 } view view command
undo schedule job
View
User view
Default level
3: Manage level
Parameters
at time1 [ date ]: Specifies the execution time of a specified command.
time1: Execution time of 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: Execution date of 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: Specifies the execution waiting time of a specified command. time2 represents the
waiting time, which can be in the following format:
hh:mm formatThe 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 formatIt 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 takes either of the following values at present:
Examples
1.
Schedule a task 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).
2.
Schedule a task to execute the batch file 1.bat in system view at 12:00 in the current day
(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).
189
schedule reboot at
Description
CAUTION:
This command reboots the device in a future time and results in service interruption. Use it with caution.
Use schedule reboot at to enable the scheduled reboot function on all member devices and specify a
specific reboot time and date. The difference between the reboot date and the current date cannot
exceed 30 x 24 hours (30 days).
If the date specified for the schedule reboot at command is later than the current date, the device
will reboot at that reboot time.
If no date is specified for a reboot time later than the current time, the device reboots at the
current days reboot time.
If no date is specified for a reboot time earlier than the current time, the device reboots at the
following days reboot time.
If you are performing file operations when the device will be rebooted, the system does not
execute the command for the sake of security.
One minute before the reboot time, the device will prompt REBOOT IN ONE MINUTE.
After you execute the command, the device will prompt you to confirm the configuration. You
must enter Y to make the configuration take effect. The original configuration will be overwritten
at the same time.
If you use the clock command after the schedule reboot at to adjust the system time, the reboot
time set by the schedule reboot at command will become invalid.
Use undo schedule reboot to restore the default condition. By default, the scheduled reboot function
is disabled.
Syntax
schedule reboot at hh:mm [ date ]
undo schedule reboot
View
User view
Default level
3: Manage level
190
Parameters
hh:mm: Reboot time for the device, in the hh:mm format. The hh value ranges from 0 to 23, and the
mm value ranges from 0 to 59.
date: Reboot date for the device, 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.
Examples
1.
Configure the device to reboot at 12:00 AMsupposing 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]:
2.
If you have used the terminal logging 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
The reboot wait time can be in the hh:mm format or mm formatabsolute minutes. The absolute
minutes cannot exceed 30 x 24 x 60 minutes (30 days).
One minute before the reboot time, the device will prompt REBOOT IN ONE MINUTE.
After you execute the command, the device will prompt you to confirm the configuration. You
must enter Y to make the configuration take effect. The original configuration will be overwritten
at the same time.
If you use the clock command after the schedule reboot delay to adjust the system time, the
reboot wait time set by the schedule reboot delay command will become invalid.
If you are performing file operations when the device will be rebooted, the system does not
execute the command for the sake of security.
Use undo schedule reboot to disable the scheduled reboot function (by default, this function is
disabled).
Syntax
schedule reboot delay { hh:mm | mm }
undo schedule reboot
191
View
User view
Default level
3: Manage level
Parameters
hh:mm: Device reboot wait time, 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: Device reboot wait time in minutes, which ranges from 0 to 43,200.
Examples
1.
2.
If you have used the terminal logging 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
shutdown-interval
Description
Use shutdown-interval to set a detection interval.
Use undo shutdown-interval to restore the default detection interval of 30 seconds.
Some protocol modules might shut down ports under specific circumstances. For example, an MSTP
module will automatically shut down a port that receives configuration messages after the BPDU
guard function is enabled on the port. Then, the MSTP module enables a detection timer and detects
the status of the port. If the port is still down when the detection timer times out, the MSTP module will
automatically bring up the port.
If you change the detection interval to T1 during port detection, the interval from when you
change the interval to the time when the protocol module shuts down the port is T. If T<T1, the
port which is down will be brought up after T1-T time. If T>=T1, the port which is down will be
brought up immediately. For example, if the detection interval is set to 30 seconds and you
change it to 10 seconds (T1=10) two seconds after the port is shut down (T=2), this port will be
brought up 8 seconds later. If the detection interval is set to 30 seconds and you change it to 2
seconds ten seconds after the port is shut down, this port will be brought up immediately.
If the detection interval is set to 0, the protocol module will never automatically recover the port.
You need to manually bring up the port by using the undo shutdown command or change the
detection interval to a non-zero value.
192
Syntax
shutdown-interval time
undo shutdown-interval
View
System view
Default level
2: System level
Parameter
time: Detection interval in seconds, which ranges from 0 to 300.
Example
# Set the detection interval to 100 seconds.
<Sysname> system-view
[Sysname] shutdown-interval 100
sysname
Description
Use sysname to set the name of the device.
Changing device name affects the prompt of the CLI configuration. For example, if the device
name is Sysname, the prompt of user view is <Sysname>.
Use undo sysname demand to restore the device name to the default, which is HP.
Syntax
sysname sysname
undo sysname
View
System view
Default level
2: System level
Parameter
sysname: Name of the device, a string of 1 to 30 characters.
Example
# Set the name of the device to S2000.
<Sysname> system-view
[Sysname] sysname S2000
[S2000]
193
system-failure
Description
Use system-failure to configure the exception handling method on all member devices. The exception
handling method is effective to the failed member device only, and does not influence the operations
of other IRF members.
By default, all member devices adopt the reboot method to handle exceptions.
Syntax
system-failure { maintain | reboot }
undo system-failure
View
System view
Default 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.
Example
# Set the exception handling method to reboot.
<Sysname> system-view
[Sysname] system-failure reboot
temperature-limit
Description
Use temperature-limit to set the temperature alarm thresholds for a device.
If the temperature is lower than the lower limit, the device logs the event and outputs the log and
trap information for users.
The warning and alarming thresholds must be higher than the lower temperature limit.
If the temperature reaches the warning threshold, the device logs the event and outputs the log
and trap information for users.
If the temperature reaches the alarming threshold, the device repeatedly outputs the log and trap
information in the terminal display, and alerts users through the LED on the device panel.
Use undo temperature-limit to restore the default temperature alarm threshold (see Table 37).
194
Sensor
Lower
limit
Warning
limit
Alarm
limit
70
80
10
90
100
10
80
87
67
72
61
66
70
80
-10
125
135
10
90
100
10
65
75
-10
125
135
10
70
80
5800-24G-PoE+ Switch(JC099A)/
70
80
5800-24G-PoE+TAA Switch(JG254A)
-10
125
135
70
80
65
75
67
72
64
69
5800-24G Switch(JC100A)/
5800-24G TAA Switch(JG255A)
5800-24G-SFP Switch with 1 Interface Slot(JC103A)/
5800-24G-SFP TAA Switch with 1 Interface Slot(JG256A)
5800AF-48G Switch(JG225A)
Syntax
temperature-limit slot slot-number hotspot sensor-number lowerlimit warninglimit [ alarmlimit ]
undo temperature-limit slot slot-number hotspot sensor-number
View
System view
Default level
2: System level
Parameters
slot slot-number: Specifies device by its slot number, which is the ID of a member device of the current
IRF virtual device.
195
hotspot: Specifies a hotspot sensor, typically placed near the chip that generates a great amount of
heat for temperature monitoring.
sensor-number: Specifies the sensor number. The values are positive integers starting from 1, each
representing a temperature sensor. For the assignment of temperature sensors on different devices,
see Table 37.
lowerlimit: Lower temperature limit in Celsius degrees. The value range from -10 to 70.
warninglimit: Warning temperature threshold in Celsius degrees. The value range from 15 to 125.
alarmlimit: Alarming temperature threshold in Celsius degrees. The value range from 20 to 135.
Example
# Set the lower limit for the sensor 1 on the device of the IRF member 1 to 10 Celsius degrees, the
warning threshold to 70, and the alarming threshold to 100 Celsius degrees.
<Sysname> system-view
[sysname] temperature-limit slot 1 hotspot 1 -10 70 100
time at
Description
Use time at to schedule a task.
Use undo time to remove the time schedule for the task.
Syntax
time time-id { one-off | repeating } at time [ week-day week-daylist | month-date month-day ]
command command
time time-id at time date command command
undo time time-id
View
Scheduled task view
Default level
3: Manage level
Parameters
time time-id: Time setting entry, where time-id is an integer ranging from 1 to 10. A scheduled task
can be specified with up to 10 time setting entries.
one-off: Specifies that the command is executed for once. That is, the command runs when the time is
reached, and will not be executed when the time is reached next time.
repeating: Specifies a recurring time schedule.
at time: Specifies the 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.
196
week-day week-daylist: Executes a command on a specified day or the days of a week. week-daylist
represents a day or multiple days in a week, taking the value of Mon, Tue, Wed, Thu, Fri, Sat, or Sun.
Multiple days must be separated by spaces, and you can set at most seven days.
month-date month-day: Executes a command on a specified day of a month, where month-day
represents the day, an integer in the range 1 to 31.
date: Date when a command is executed, 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 execution date must be ahead of the current date.
command command: Command to be executed at a specified time.
Examples
1.
Schedule a task to enable PoE on the device at eight AM from Monday to Friday.
<Sysname> system-view
[Sysname] job phone
[Sysname-job-phone] time 1 repeating at 8:00 week-day Mon Tue Wed Thu Fri
command poe enable
2.
time delay
Description
Use time delay to configure a scheduled task to be executed after a delay time.
Syntax
time time-id { one-off | repeating } delay time command command
undo time time-id
View
Scheduled task view
Default level
3: Manage level
Parameters
time time-id: Time setting entry, where time-id is an integer ranging from 1 to 10. A scheduled task
can be specified with up to 10 time setting entries.
one-off: Specifies that the specified command is executed for once. That is, the command is executed
when the time is reached, and will not be executed when the time is reached next time.
repeating: Specifies a recurring time schedule.
197
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.
The delay time parameter is unrelated to the system time. Even though the system time changes, the
command is executed after the specified delay time.
command command: Command to run at a specified time.
Example
# Configure a scheduled task so that PoE is disabled on the device five hours after the command is
configured.
<Sysname> system-view
[Sysname] job phone
[Sysname-job-phone] time 3 one-off delay 5:00 command undo poe enable
view
Description
Use view to specify a view where the commands are to be executed.
Use undo view to remove the view existing in a scheduled task and restore the default (no view is
specified by default).
Only one view can be specified for a scheduled task and all the commands are automatically
executed in that view. If the view view-name command is executed repeatedly, only the last
configuration takes effect.
Syntax
view view-name
undo view
View
Scheduled task view
Default level
3: Manage level
Parameter
view-name: View name, which a string of 1 to 90 characters used to specify in which view the
commands in a scheduled task are executed.
Examples
# Specify system view where the specified commands are to be executed.
<Sysname> system-view
[Sysname] job saveconfig
[Sysname-job-saveconfig] view system
198
Error messages
Detailed questions
Subscription service
HP recommends that you register your product at the Subscriber's Choice for Business website:
http://www.hp.com/go/wwalerts
After registering, you will receive email notification of product enhancements, new driver versions,
firmware updates, and other product resources.
Related information
Documents
To find related documents, browse to the Manuals page of the HP Business Support Center website:
http://www.hp.com/support/manuals
For related documentation, navigate to the Networking section, and select a networking
category.
For a complete list of acronyms and their definitions, see HP A-Series Acronyms.
Websites
HP.com http://www.hp.com
HP Networking http://www.hp.com/go/networking
HP manuals http://www.hp.com/support/manuals
199
Conventions
This section describes the conventions used in this documentation set.
Command conventions
Convention
Description
Boldface
Bold text represents commands and keywords that you enter literally as shown.
Italic
Italic text represents arguments that you replace with actual values.
[]
Square brackets enclose syntax choices (keywords or arguments) that are optional.
{ x | y | ... }
Braces enclose a set of required syntax choices separated by vertical bars, from which
you select one.
[ x | y | ... ]
Square brackets enclose a set of optional syntax choices separated by vertical bars,
from which you select one or none.
{ x | y | ... } *
[ x | y | ... ] *
&<1-n>
The argument or keyword and argument combination before the ampersand (&) sign
can be entered 1 to n times.
GUI conventions
Convention
Description
Boldface
Window names, button names, field names, and menu items are in bold text. For
example, the New User window appears; click OK.
>
Multi-level menus are separated by angle brackets. For example, File > Create >
Folder.
Convention
Description
Symbols
WARNING
An alert that calls attention to important information that if not understood or followed
can result in personal injury.
CAUTION
An alert that calls attention to important information that if not understood or followed
can result in data loss, data corruption, or damage to hardware or software.
IMPORTANT
NOTE
TIP
200
201
Index
ABCDEFGHIJLMOPQRSTUV
A
copyright-info enable,151
activation-key,16
databits,21
archive configuration,105
debugging,63
delete,89
delete,64
dir,90
ascii,59
dir,65
authentication-mode,19
disconnect,66
auto-execute command,17
display boot-loader,131
backup startup-configuration,108
display clipboard,3
display clock,153
binary,59
display command-alias,4
boot-loader,127
display cpu-usage,154
bootrom,129
display current-configuration,111
display default-configuration,112
bye,60
display device,159
cd,88
display diagnostic-information,164
cd,61
display environment,165
cdup,61
display fan,166
clock datetime,148
display ftp-server,53
display ftp-user,54
clock timezone,151
display history-command,4
close,62
display hotkey,5
command accounting,20
display ip http,22
command authorization,21
display ip https,23
command-alias enable,1
command-alias mapping,1
command-privilege,2
display job,168
display memory,169
copy,89
ftp timeout,57
ftp update,57
display power,170
get,70
display reboot-type,171
display rps,172
display saved-configuration,114
header,184
history-command max-size,33
hotkey,7
display startup,117
display system-failure,175
idle-timeout,34
ip http acl,34
ip http enable,35
display this,118
ip http port,35
display transceiver,175
ip https acl,36
ip https enable,38
ip https port,38
display user-interface,25
ip https ssl-server-policy,39
display users,27
issu accept,142
display version,181
issu commit,143
issu load,143
display version-update-record,182
issu rollback,144
issu rollback-timer,145
escape-key,29
execute,95
job,186
fan prefer-direction,183
lcd,71
file prompt,96
lock,40
fixdisk,96
ls,72
flow-control,31
format,97
mkdir,73
free user-interface,31
mkdir,97
free web-users,32
more,98
ftp,67
move,99
ftp ipv6,69
open,73
open ipv6,74
send,43
parity,40
passive,75
shutdown-interval,192
patch active,133
patch deactive,134
patch delete,134
startup saved-configuration,125
patch install,135
stopbits,46
patch load,136
super,10
patch location,136
super authentication-mode,11
patch run,137
super password,12
protocol inbound,41
sysname,193
put,76
system-failure,194
pwd,77
pwd,100
system-view,13
quit,9
telnet,47
telnet client source,48
quit,77
telnet ipv6,49
reboot,186
temperature-limit,194
remotehelp,78
terminal type,50
rename,100
tftp,84
reset recycle-bin,101
reset saved-configuration,120
tftp ipv6,87
tftp-server acl,83
reset version-update-record,188
time at,196
restore startup-configuration,121
time delay,197
return,9
rmdir,103
undelete,103
rmdir,80
user,80
save,122
user-interface,52
schedule job,188
verbose,81
view,198
screen-length,42
screen-length disable,10
204