Вы находитесь на странице: 1из 211

HP 5820X & 5800 Switch Series

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.

Part number: 5998-1619


Software version: Release 1211
Document version: 6W102-20130520

Legal and notice information


Copyright 2013 Hewlett-Packard Development Company, L.P.
No part of this documentation may be reproduced or transmitted in any form or by any means without
prior written consent of Hewlett-Packard Development Company, L.P.
The information contained herein is subject to change without notice.
HEWLETT-PACKARD COMPANY MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS
MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS FOR A PARTICULAR PURPOSE. Hewlett-Packard shall not be liable for errors contained
herein or for incidental or consequential damages in connection with the furnishing, performance, or use
of this material.
The only warranties for HP products and services are set forth in the express warranty statements
accompanying such products and services. Nothing herein should be construed as constituting an
additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

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

Logging in to the switch commands 15


acl (user interface view) 15
activation-key 16
auto-execute command 17
authentication-mode 19
command accounting 20
command authorization 21
databits 21
display ip http 22
display ip https 23
display telnet client configuration 24
display user-interface 25
display users 27
display web users 28
escape-key 29
flow-control 31
free user-interface 31
free web-users 32
history-command max-size 33
idle-timeout 34
ip http acl 34
ip http enable 35
ip http port 35
ip https acl 36
ip https certificate access-control-policy 37
ip https enable 38
ip https port 38
ip https ssl-server-policy 39
lock 40
parity 40
protocol inbound 41
screen-length 42
send 43
set authentication password 44
iii

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

FTP configuration commands 53


FTP server configuration commands 53
display ftp-server 53
display ftp-user 54
free ftp user 55
ftp server acl 56
ftp server enable 56
ftp timeout 57
ftp update 57
FTP client configuration commands 59
ascii 59
binary 59
bye 60
cd 61
cdup 61
close 62
debugging 63
delete 64
dir 65
disconnect 66
display ftp client configuration 66
ftp 67
ftp client source 68
ftp ipv6 69
get 70
lcd 71
ls 72
mkdir 73
open 73
open ipv6 74
passive 75
put 76
pwd 77
quit 77
remotehelp 78
rmdir 80
user 80
verbose 81
TFTP client configuration commands 83
display tftp client configuration 83
tftp-server acl 83
tftp 84
tftp client source 86
tftp ipv6 87

iv

File management commands 88


cd 88
copy 89
delete 89
dir 90
display nandflash file-location 92
display nandflash badblock-location 93
display nandflash page-data 94
execute 95
file prompt 96
fixdisk 96
format 97
mkdir 97
more 98
move 99
pwd 100
rename 100
reset recycle-bin 101
rmdir 103
undelete 103

Configuration file management commands 105


archive configuration 105
archive configuration interval 105
archive configuration location 106
archive configuration max 107
backup startup-configuration 108
configuration replace file 109
display archive configuration 110
display current-configuration 111
display default-configuration 112
display saved-configuration 114
display startup 117
display this 118
reset saved-configuration 120
restore startup-configuration 121
save 122
slave auto-update config 124
startup saved-configuration 125

Software upgrade commands 127


boot-loader 127
boot-loader update file 128
bootrom 129
bootrom-update security-check enable 130
display boot-loader 131
display patch information 132
patch active 133
patch deactive 134
patch delete 134
patch install 135
patch load 136
patch location 136
patch run 137

ISSU commands 138


display issu rollback-timer 138
v

display issu state 139


display version comp-matrix 141
issu accept 142
issu commit 143
issu load 143
issu rollback 144
issu rollback-timer 145
issu run switchover 146

Device management commands 148


clock datetime 148
clock summer-time one-off 148
clock summer-time repeating 149
clock timezone 151
copyright-info enable 151
display clock 153
display cpu-usage 154
display cpu-usage history 156
display device 159
display device manuinfo 161
display diagnostic-information 164
display environment 165
display fan 166
display job 168
display memory 169
display power 170
display reboot-type 171
display rps 172
display schedule job 173
display schedule reboot 174
display system-failure 175
display transceiver 175
display transceiver alarm 177
display transceiver diagnosis 179
display transceiver manuinfo 180
display version 181
display version-update-record 182
fan prefer-direction 183
header 184
job 186
reboot 186
reset unused porttag 187
reset version-update-record 188
schedule job 188
schedule reboot at 190
schedule reboot delay 191
shutdown-interval 192
sysname 193
system-failure 194
temperature-limit 194
time at 196
time delay 197
view 198

Support and other resources 199


Contacting HP 199
Subscription service 199
vi

Related information 199


Documents 199
Websites 199
Conventions 200

Index 202

vii

CLI configuration commands


command-alias enable
Description
Use command-alias enable to enable the command alias function.
Use undo command-alias enable to disable the command alias function (disabled is the default
condition).

Syntax
command-alias enable
undo command-alias enable

View
System view

Default level
2: System level

Parameters
None

Examples
1.

Enable the command alias function.


<Sysname> system-view
[Sysname] command-alias enable

2.

Disable the command alias function.


<Sysname> system-view
[Sysname] undo command-alias enable

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.

Use undo command-privilege view to disable the change.

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

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 hotkey information.
<Sysname> display hotkey
----------------- HOTKEY -----------------

=Defined hotkeys=
Hotkeys Command
CTRL_G

display current-configuration

CTRL_L

display ip routing-table

CTRL_O

undo debug all

=Undefined hotkeys=
Hotkeys Command
CTRL_T

NULL

CTRL_U

NULL
=System hotkeys=

Hotkeys Function
CTRL_A

Move the cursor to the beginning of the current line.

CTRL_B

Move the cursor one character left.

CTRL_C

Stop current command function.

CTRL_D

Erase current character.

CTRL_E

Move the cursor to the end of the current line.

CTRL_F

Move the cursor one character right.

CTRL_H

Erase the character left of the cursor.

CTRL_K

Kill outgoing connection.

CTRL_N

Display the next command from the history buffer.

CTRL_P

Display the previous command from the history buffer.

CTRL_R

Redisplay the current line.

CTRL_V

Paste text from the clipboard.

CTRL_W

Delete the word left of the cursor.

CTRL_X

Delete all characters up to the cursor.

CTRL_Y

Delete all characters after the cursor.

CTRL_Z

Return to the User View.

CTRL_]

Kill incoming connection or redirect connection.

ESC_B

Move the cursor one word back.

ESC_D

Delete remainder of word.

ESC_F

Move the cursor forward one word.

ESC_N

Move the cursor down a line.

ESC_P

Move the cursor up a line.

ESC_<

Specify the beginning of clipboard.

ESC_>

Specify the end of clipboard.

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:

Ctrl+G corresponds to display current-configuration.

Ctrl+L corresponds to display ip routing-table.

Ctrl+O corresponds to undo debugging all.

You can modify the associations as needed.

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

undo debug all

CTRL_T

display tcp status


=Undefined hotkeys=

Hotkeys Command
CTRL_U

NULL

=System hotkeys=
Hotkeys Function
CTRL_A

Move the cursor to the beginning of the current line.

CTRL_B

Move the cursor one character left.

CTRL_C

Stop current command function.

CTRL_D

Erase current character.

CTRL_E

Move the cursor to the end of the current line.

CTRL_F

Move the cursor one character right.

CTRL_H

Erase the character left of the cursor.

CTRL_K

Kill outgoing connection.

CTRL_N

Display the next command from the history buffer.

CTRL_P

Display the previous command from the history buffer.

CTRL_R

Redisplay the current line.

CTRL_V

Paste text from the clipboard.

CTRL_W

Delete the word left of the cursor.

CTRL_X

Delete all characters up to the cursor.

CTRL_Y

Delete all characters after the cursor.

CTRL_Z

Return to the user view.

CTRL_]

Kill incoming connection or redirect connection.

ESC_B

Move the cursor one word back.

ESC_D

Delete remainder of word.

ESC_F

Move the cursor forward one word.

ESC_N

Move the cursor down a line.

ESC_P

Move the cursor up a line.

ESC_<

Specify the beginning of clipboard.

ESC_>

Specify the end of clipboard.

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.

Related commands: super password.

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.

Switch to user privilege level 2 from privilege level 3.


<Sysname> super 2
User privilege level is 2, and only those commands can be used
whose level is equal or less than this.
Privilege note: 0-VISIT, 1-MONITOR, 2-SYSTEM, 3-MANAGE

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 simple parameter to set a simple-text password.

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.

simple: Plain-text password, a string of 1 to 16 characters.


12

cipher: Cipher-text password. A cipher password is a string of 1 to 16 characters in plain text or 24


characters in cipher text. For example, the simple text 1234567 corresponds to the cipher text
(TT8F]Y\5SQ=^Q`MAF4<1!!.

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

Examples
1.

Set simple-text password abc for switching to user privilege level 3.


<Sysname> system-view
[Sysname] super password level 3 simple abc

2.

Display the configured password for level switching.


[Sysname] display current-configuration
#
super password level 3 simple abc

Set cipher-text password abc for switching to user privilege level 3.


<Sysname> system-view
[Sysname] super password level 3 cipher abc

3.

Display the configured password for level switching.


[Sysname] display current-configuration | include super
#
super password level 3 cipher ;)<01%^&;YGQ=^Q`MAF4<1!!

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

Logging in to the switch commands


acl (user interface view)
Description
Use acl to reference ACLs to control access to the VTY user interface.

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

To use a basic or advanced ACL:

acl [ ipv6 ] acl-number { inbound | outbound }


undo acl [ ipv6 ] acl-number { inbound | outbound }

To use an Ethernet frame header ACL:

acl acl-number inbound


undo acl acl-number inbound

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:

Basic ACL: 2000 to 2999

Advanced ACL: 3000 to 3999

Ethernet frame header ACL: 4000 to 4999

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.

The activation-key command is not supported by the VTY user interface.

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

To verify the configuration, perform the following operations:


2.

Exit the terminal session on the console port.


[Sysname-ui-aux0] return
<Sysname> quit

3.

Log in to the console port again. The following message appears:


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

4.

At this moment, pressing Enter does not start a session. To start the terminal session, enter s.
<Sysname>
%Mar

2 18:40:27:981 2005 Sysname SHELL/5/LOGIN: Console logged in from aux0.

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.

To verify the configuration, perform the following operations:


Telnet to 192.168.1.40. The device automatically Telnets to 192.168.1.41. The following output is
displayed:
C:\> telnet 192.168.1.40
****************************************************************************
* 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.

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

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.

* Without the owner's prior written consent,

* no decompiling or reverse-engineering shall be allowed.

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

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

VTY user interfaces authentication mode default (password)

AUX user interface authentication mode default (none)

Related commands: set authentication password.

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

Operation status: Running

Table 1 Command output


Field

Description

HTTP port

Port number used by the HTTP service.

Basic ACL

Basic ACL number associated with the HTTP service.

Current connection

Number of current connections.


Operation status:

Operation status

RunningHTTP service is enabled.

StoppedHTTP service is disabled.

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

Table 2 Command output


Field

Description

HTTPS port

Port number used by the HTTPS service.

SSL server policy

SSL server policy associated with the HTTPS service.

Certificate access-control-policy

Certificate attribute access control policy associated with the


HTTPS service.

Basic ACL

Basic ACL number associated with the HTTPS service.

Current connection

Number of current connections.


Operation status:

Operation status

RunningHTTPS service is enabled.


StoppedHTTPS service is disabled.

display telnet client configuration


Description
Use display telnet client configuration to display device configuration when it serves as a Telnet client.

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

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

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.

Display information about user interface 29.


<Sysname> display user-interface 29
Idx

Type

+ 29

Tx/Rx

VTY 0

Modem Privi Auth

Int

: Current user-interface is active.

: Current user-interface is active and work in async mode.

Idx

: Absolute index of user-interface.

Type : Type and relative index of user-interface.


Privi: The privilege of user-interface.
Auth : The authentication mode of user-interface.
Int

: The physical location of UIs.

: Authentication use AAA.

: Authentication use local database.

: Current UI need not authentication.

: Authentication use current UI's password.

Table 3 Command output


Field

Description

The current user interface is active.

The current user interface is active and works in asynchronous mode.

Idx

Absolute number of the user interface.

Type

Type and relative number of the user interface.

Tx/Rx

Transmission/Receive rate of the user interface.

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

The physical port that corresponds to the user interface.

AAA authentication with the authentication mode of scheme.

Local authentication (not supported).

No authentication with the authentication mode of none.

Password authentication with the authentication mode of password.

26

2.

Display summary about all user interfaces.


<Sysname> display user-interface summary
User interface type : [TTY]
0:XXX
User interface type : [AUX]
3:XXXX XXXX XX
User interface type : [VTY]
29:UXXX XXXX XXXX XXXX
1 character mode users.
28 UI never used.

(U)
(X)

1 total UI in use

Table 4 Command output


Field

Description

User interface type

Type of user interface (AUX or VTY).

0:X

0Represents the absolute number of the user interface.


XThis user interface is not used.
UThis user interface is in use.

Character mode users.


UI never used.
Total UI in use

(U)
(X)

Number of users or the total number of character U.


Number of user interfaces not used or the total number of
character X.
Total number of user interfaces in use.

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

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

Following are more details.


VTY 0

:
Location: 192.168.0.5

: Current operation user.

: Current operation user work in async mode.

Table 5 Command output


Field

Description

Idx

Absolute number of the user interface.

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

User type, such as Telnet, SSH.

Userlevel

User level: 0 for visit, 1 for monitor, 2 for system, and 3 for manage.

Current user.

Location

IP address of the user.

The current user works in asynchronous mode.

display web users


Description
Use display web users to display information about web users.

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

LinkCount LoginTime LastTime


0

14:13:46

14:14:18

Table 6 Command output


Field

Description

UserID

ID of a web user.

Name

Name of the web user.

Language

Login language used by the web user.

Level

Level of the web user.

State

State of the web user.

LinkCount

Number of tasks that the web user runs.

LoginTime

Time when the web user logged in.

LastTime

Last time when the web user accessed the switch.

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.

Use undo escape-key to restore the default key combination (Ctrl+C).


29

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

# To verify the configuration, perform the following operations:


1.

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

data bytes, press a to break

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


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

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.

The switch supports the none flow control mode only.

The command only applies to the console port.

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.

Display the connection established on user interface VTY 1.


<Sysname> display users
The user application information of the user interface(s):
Idx UI
+ 29

VTY 0

Delay

Type Userlevel

00:00:00 TEL

Following are more details.


VTY 0

:
Location: 192.168.0.5

2.

: Current operation user.

: Current operation user work in async mode.

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.

Use undo idle-timeout to restore the default timeout (10 minutes).

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

[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 https acl 2001

ip https certificate access-control-policy


Description
Use ip https certificate access-control-policy to associate the HTTPS service with a certificate attribute
access control policy. Association of the HTTPS service with a certificate attribute access control policy
controls client access rights.
Use undo ip https certificate access-control-policy to remove the association and restore the default
condition (no association by default).
Related commands: display ip https; pki certificate access-control-policy (see Security Command
Reference).

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:

Modify the associated SSL server-end policy.

Remove the association between the HTTPS service and the SSL server-end policy.

Related commands: display ip https; ssl server-policy (Security Command Reference).

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.

When entering the lock command:


1. Enter a password (up to 16 characters).
2. Confirm it by entering the password again.
3. To set the password, enter the same password.

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:

All protocols are supported.

The authentication mode of the Telnet protocol is password.

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

set authentication password


Description
Use set authentication password to set a local authentication password. You must enter the password in
plain-text during authentication. A plain-text password can be easily compromised. It is safer to use a
cipher-text password.
Use undo set authentication password to restore the default (no local authentication password).
Related commands: authentication-mode.

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

Next time you enter the system, the password is required.

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.

Disable terminal services on the VTYs 0 through 4.


<Sysname> system-view
[Sysname] user-interface vty 0 4
[Sysname-ui-vty0-4] undo shell
% Disable ui-vty0-4 , are you sure? [Y/N]:y
[Sysname-ui-vty0-4]

2.

The following message appears when a terminal tries to Telnet to the device:
The connection was closed by the remote host!

speed (user interface view)


Description
This command only applies to the console port.
Use speed to set the transmission rate on the user interface. This setting must be identical for the user
interface of the connecting port on the device and the target terminal device for communication
Use undo speed to restore the default transmission rate (9600 bps is the default rate).

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

The transmission rate varies with devices and configuration environment.

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

telnet client source


Description
If you use both this command and the telnet command to specify the source IPv4 address or source
interface, the source IPv4 address or interface specified by the telnet command takes effect.
Use telnet client source to specify the source IPv4 address or source interface for sending Telnet packets
when the device serves as a Telnet client. The source IPv4 address or source interface specified by this
command applies to all Telnet connections.
Use undo telnet client source to remove the source IPv4 address or source interface for sending Telnet
packets. By default, no source IPv4 address or source interface for sending Telnet packets is specified. The
source IPv4 address is selected by routing.
Related commands: display telnet client configuration.

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

telnet server enable


Description
Use telnet server enable to enable the Telnet server.
Use undo telnet server enable to disable the Telnet server (disabled is the default condition).

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

user privilege level


Description
Use user privilege level to assign users logging into the interface a privilege level.
Use undo user privilege level to restore:

AUX user interfaces default to command level 3.

Other user interfaces default to command level 0.

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

Run cluster command

display

Display current system information

ping

Ping function

quit

Exit from current command view

ssh2

Establish a secure shell client connection

super

Set the current user priority level

telnet

Establish one TELNET connection

tracert

Trace route function

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.

aux: Specifies the AUX user interface.

vty: Specifies the VTY user interface.

first-num2: Relative number of the first user interface:

AUX user interfaces: from 0 to 9

VTY user interfaces: from 0 to 15

last-num2: Relative number of the last user interface:

AUX user interfaces: from 0 to 9 for an AUX user interface

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]

#Enter the user interface views of VTYs 0 to 4.


<Sysname> system-view
[Sysname] user-interface vty 0 4
[Sysname-ui-vty0-4]

52

FTP configuration commands


FTP server configuration commands
display ftp-server
Description
Use display ftp-server to view the FTP server configuration. Verify configured FTP server parameter
with this command.
Related commands: ftp server enable, ftp timeout, and ftp update.

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:

Timeout value(in minute):

30

Put Method:

fast

Table 7 Table 1 Command output


Field

Description

Max user number

Maximum number of login users at a time.

53

Field

Description

User count

Number of the current login users.

Timeout value (in minute)

Allowed idle time of an FTP connection. If there is no packet


exchange between the FTP server and client during the whole
period, the FTP connection will be disconnected.
File update method of the FTP server, including:

Put Method

fast: Fast update.

normal: Normal update.

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

Table 8 Command output


Field

Description

UserName

Name of the logged-in user.

HostIP

IP address of the logged-in user.

Port

Port that the logged-in user is using.

Idle

Duration time of the current FTP connection, in minutes.

HomeDir

Authorized path of the present logged-in user.

free ftp user


Description
Use free ftp user to manually release the FTP connection established with the specified username
immediately.

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

ftp server acl


Description
Use ftp server acl to control FTP clients access to the device using an ACL.

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

ftp server enable


Description
Use ftp server enable to enable the FTP server and allow FTP user login.
Use undo ftp server to disable the FTP server (disabled is the default condition).

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

FTP client configuration commands


Before executing the FTP client configuration commands in this section, make sure you have
configured the proper authority for users on the FTP server, including viewing the files under the
current directory, reading/downloading the specified file, creating directory/uploading files, and
renaming/removing files.
You must use ftp to enter FTP client view for configurations under this view. For more information, see
display ftp client configuration
.
The prompt information in the following examples varies with FTP server types.

ascii
Description
FTP transfers files in two modes:

Binary mode: for program file or picture transmission.

ASCII mode: for text file transmission.

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

By default, the transfer mode is ASCII mode.


Related commands: ascii.

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] get sample.file


---> PORT 192,168,1,44,4,21
200 Port command okay.
The parsed reply is 200
---> RETR sample.file
150 Opening ASCII mode data connection for /sample.file.
The parsed reply is 150
FTPC: File transfer started with the signal light turned on.
FTPC: File transfer completed with the signal light turned off.
.226 Transfer complete.
FTP: 3304 byte(s) received in 4.889 second(s), 675.00 byte(s)/sec.

[ftp]

Table 9 Command output


Field

Description

---> PORT

Give an FTP order, with data port numbers


being

The parsed reply is

The received reply code, defined in RFC 959.

---> RETR

Download the file.

FTPC: File transfer started with the signal light


turned on.

File transfer starts, and the signal light is


turned on.

FTPC: File transfer completed with the signal


light turned off.

File transfer is completed, and the signal light


is turned off.

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

20471748 May 11 10:21 test.bin

2007 test
2007 key.pub

226 Transfer complete.


FTP: 394 byte(s) received in 0.189 second(s), 2.00K byte(s)/sec.

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.

# View the content of aa.txt.


[ftp] quit
<Sysname> more aa.txt
-rwxrwxrwx

1 noone

nogroup

3077 Jun 20 15:34 ar-router.cfg

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.

display ftp client configuration


Description
Use display ftp client configuration to view the configured source IP address or source interface of the
FTP client.
Related commands: ftp client source.

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

source { interface interface-type interface-number | ip source-ip-address } ]: source address used to


establish an FTP connection.

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.

ftp client source


Description
Use ftp client source to configure the source address of packets transmitted by the FTP client.

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

# Specify the source interface of the FTP client as Vlan-interface1.


<Sysname> system-view
[Sysname] ftp client source interface vlan-interface1

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

227 Entering Passive Mode (192,168,1,50,17,163).


125 ASCII mode data connection already open, transfer starting for /testcfg.cfg.
.....226 Transfer complete.
FTP: 5190 byte(s) received in 7.754 second(s), 669.00 byte(s)/sec.

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

227 Entering Passive Mode (192,168,1,46,4,47).


125 ASCII mode data connection already open, transfer starting for /testcfg.cfg.
..226 Transfer complete.
FTP: 3608 byte(s) received in 2.050 second(s), 1.00K byte(s)/sec.

# 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

227 Entering Passive Mode (192,168,1,46,4,48).


125 ASCII mode data connection already open, transfer starting for /testcfg.cfg.
226 Transfer complete.
FTP: 3608 byte(s) received in 2.322 second(s), 1.00K byte(s)/sec.

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 to view the information of a file or subdirectory.

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.

#View the content of file aa.txt.


[ftp] quit
<Sysname> more aa.txt
.
..
logfile.log

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

214 Direct comments to HP company.

# Display the help information for the user command.


[ftp] remotehelp user
214 Syntax: USER <sp> <username>.

[ftp]

Table 10 Command output


Field

Description

USER

Username

PASS

Password

CWD

Change the current working directory

CDUP

Change to parent directory

SMNT*

File structure setting

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*

Rename the source

RNTO*

Rename the destination

ABOR*

Abort the transmission

DELE

Delete a file

RMD

Delete a folder

MKD

Create a folder

PWD

Print working directory

LIST

List files

NLST

List file description

SITE*

Locate a parameter

SYST

Display system parameters

STAT*

State

HELP

Help

NOOP*

No operation

XCUP

Extension command, the same meaning as CUP

XCWD

Extension command, the same meaning as CWD

XMKD

Extension command, the same meaning as MKD

XPWD

Extension command, the same meaning as PWD

XRMD

Extension command, the same meaning as RMD

Syntax: USER <sp> <username>.

Syntax of the user command: user (keyword) +

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: 3608 byte(s) received in 0.052 second(s), 69.00K byte(s)/sec.

[ftp]

# Enable the protocol information function and perform the Get operation.
[ftp] verbose
FTP: verbose is on

[ftp] get startup.cfg aa.cfg

227 Entering Passive Mode (192,168,1,46,5,85).


125 ASCII mode data connection already open, transfer starting for /startup.cfg.
226 Transfer complete.
FTP: 3608 byte(s) received in 0.193 second(s), 18.00K byte(s)/sec.

82

TFTP client configuration commands


display tftp client configuration
Description
Use display tftp client configuration to view the configuration information of the TFTP client.
Related commands: tftp client source.

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:

372800 bytes received in 1 second(s)

File downloaded successfully.

# 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

File will be transferred in binary mode


Sending file to remote TFTP server. Please wait...
TFTP:

345600 bytes sent in 1 second(s).

File uploaded successfully.

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

2737556 bytes received in 13 second(s)

File downloaded successfully.

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

File will be transferred in binary mode


Downloading file from remote TFTP server, please wait...|
TFTP:

2737556 bytes received in 14 second(s)

File downloaded successfully.

// Download the file from the TFTP server to the root directory on the flash of the subordinate switch.

tftp client source


Description
Use tftp client source to configure the source address of the TFTP packets from the TFTP client.

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

# Specify the source interface of the TFTP client as Vlan-interface1.


<Sysname> system-view
[Sysname] tftp client source interface vlan-interface 1

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:

411100 bytes received in 2 second(s)

File downloaded successfully.

87

File management commands


In the following examples, the working directory is the root directory of the storage medium on the
device. For the qualified filename formats, see the Fundamentals Configuration Guide.

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

# Return to the root directory.


<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

Use undelete to restore a deleted file from the recycle bin.


dir /all displays the files deleted from the directory and moved to the recycle bin. These files are
enclosed in pairs of brackets [ ]. To remove the files from the recycle bin, use the reset recycle-bin
command.

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

The dir file-url command displays information about a file or folder.

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

Apr 26 2008 12:02:05

snmpboots

-rw-

10187730

Apr 26 2008 16:47:07

startup.bin

-rwh

3144

Apr 26 2008 13:45:35

private-data.txt

-rw-

2161

Apr 26 2008 13:53:25

startup.cfg

-rw-

10058752

Sep 19 2008 17:41:46

startup1.bin

-rw-

10139143

Apr 26 2008 13:08:20

startup2.bin

-rwh

716

Apr 26 2008 12:01:58

hostkey

-rwh

572

Apr 26 2008 12:02:11

serverkey

-rwh

548

Apr 26 2008 12:02:17

dsakey

-rw-

3035

Apr 26 2008 13:45:42

new-config.cfg

10

-rw-

2200

Apr 26 2008 14:58:35

[aa.cfg]

515712 KB total (1801 KB free)

# 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

Apr 26 2008 13:45:28

private-data.txt

-rw-

2341

Apr 26 2008 16:36:18

startup.cfg

-rw-

124

Apr 26 2008 12:00:22

patchstate

-rwh

716

Apr 26 2008 14:31:36

hostkey

-rwh

Apr 26 2008 14:31:41

snmpboots

-rw-

10187730

Apr 26 2008 12:01:10

startup.bin

-rwh

572

Apr 26 2008 14:31:47

serverkey

-rwh

548

Apr 26 2008 14:31:52

dsakey

-rw-

3035

Apr 26 2008 13:45:36

new-config.cfg

91

drw-

Apr 26 2008 12:11:53

oldver

515712 KB total (1839 KB free)

Table 11 Command output


Field

Description

Directory of

The current working directory.

Indicates a directory. If this field does not exist, it indicates a file.

Indicates that the file or directory is readable.

Indicates that the file or directory is writable.

Indicates that the file or directory is hidden.

[]

Indicates that the file is in the recycle bin.

display nandflash file-location


Description
Use display nandflash file-location for the location of a specific file in the NAND flash memory,
including information about all the physical pages corresponding to the logical pages of the file.

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

Table 12 Command output


Field

Description

Logic Chunk

Serial number of the logical pages.

Physical Page

Serial number of the physical pages.

chunk(0)

1234

The first logical page of this file corresponds to the 1234th physical
page on the device.

display nandflash badblock-location


Description
Use display nandflash badblock-location to view the number and location of bad blocks in the
NAND flash memory.

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

3200 block(s) total, 3 block(s) bad.

Table 13 Command output


Field

Description

No

Serial number of the bad blocks

Physical block

Serial number of the physical pages with bad blocks

3200 block(s) total, 3 block(s)


bad.

Total number of blocks and bad blocks in the NAND flash memory

display nandflash page-data


Description
Use display nandflash page-data to view the data on the specified physical page in the NAND flash
memory.
This command is always used in combination with the display nandflash file-location to check the
correctness of the data 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

20, Alpha 1011..

0020:

23 0D 0A 20 73 79 73 6E 61 6D 65 20 48 33 43 0D

#.. sysname HP.

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.

Each configuration command in a batch file must be a standard configuration command,


meaning that the valid configuration information can be displayed with the display currentconfiguration 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

# Create folder test/subtest in the current directory.


<Sysname> mkdir test/subtest
....
%Created dir flash:/test/subtest

# Create folder test on a subordinate (with the member ID 2).


<Sysname> mkdir slot2#flash:/test
....
%Created dir slot2#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.

You cannot move files between storage media of different types.

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

# Move file b.cfg to the subfolder test2.


<Sysname> move b.cfg test2
Move flash:/b.cfg to flash:/test2/b.cfg?[Y/N]:y
.
%Moved file flash:/b.cfg to flash:/test2/b.cfg.

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

% Renamed file flash:/sample.txt to flash:/sample.bat

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

Apr 26 2008 16:41:43

private-data.txt

-rw-

2416

Apr 26 2008 13:45:36

config.cfg

-rw-

8036197

May 14 2008 10:13:18

main.bin

-rw-

2386

Apr 26 2008 13:30:30

back.cfg

drw-

May 08 2008 09:49:25

test

-rwh

716

Apr 24 2007 16:17:30

hostkey

-rwh

572

Apr 24 2007 16:17:44

serverkey

-rw-

2386

May 08 2008 11:14:20

[a.cfg]

-rw-

3608

Dec 03 2007 17:29:30

[b.cfg]

515712 KB total (6730 KB free)

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

Apr 26 2008 16:41:43

private-data.txt

1
2

-rw-

2416

Apr 26 2008 13:45:36

config.cfg

-rw-

8036197

May 14 2008 10:13:18

main.bin

-rw-

2386

Apr 26 2008 13:30:30

back.cfg

drw-

May 08 2008 09:49:25

test

-rwh

716

Apr 24 2007 16:17:30

hostkey

-rwh

572

Apr 24 2007 16:17:44

serverkey

-rw-

2386

May 08 2008 11:14:20

[a.cfg]

515712 KB total (6734 KB free)

// The output shows that file flash:/b.cfg is deleted permanently.

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

%Removed directory flash:/mydir.

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.

# Restore file b.cfg in directory flash:/test from the recycle bin.


<Sysname> undelete flash:/test/b.cfg
Undelete flash:/test/b.cfg?[Y/N]:y
.......
%Undeleted file flash:/test/b.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

Configuration file management commands


archive configuration
Description
Use archive configuration to manually save the running configuration.

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.

archive configuration interval


Description
Use archive configuration interval to enable the automatic saving of the running configuration and set
the interval.

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.

archive configuration location


Description
Before executing this command, verify that the path is available on both the master and the
subordinate switches. The path cannot include any member ID.
Use archive configuration location to configure the path and filename prefix for saving configuration
files on both master and subordinate switches.

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.

Use undo archive configuration location to restore the default.

By default, the path and filename prefix for saving configuration files are not configured, and the
system does not save the configuration file periodically.

If this command is executed, the running configuration cannot be saved manually or


automatically.

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.

Create folder flash:/archive on the master.


<Sysname> mkdir archive
.
%Created dir flash:/archive.

Create folder flash:/archive on a subordinate switch with the member ID 2.


<Sysname> mkdir slot2#flash:/archive

%Created dir slot2#flash:/archive.

Configure the path and the filename prefix for saving configuration files.
<Sysname> system-view
[Sysname] archive configuration location flash:/archive filename-prefix
my_archive

archive configuration max


Description
Before executing this command, configure the path and filename prefix for saving configuration files
by using the archive configuration location command; otherwise, the execution of this command fails.
If the undo archive configuration location command is executed, the maximum number of
configuration files that can be saved also restores to the default.
Use archive configuration max to set the maximum number of configuration files that can be saved.

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

Next startup saved-configuration file:

flash:/test.cfg

<Sysname> backup startup-configuration to 2.2.2.2 192-168-1-26.cfg


Backup next startup-configuration file to 2.2.2.2, please waitfinished!
<Sysname>

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.

configuration replace file


Description
Use configuration replace file to set configuration rollback.

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

display archive configuration


Description
Use display archive configuration to display information about configuration rollback.

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

Aug 05 2007 20:24:54

my_archive_1.cfg

Aug 05 2007 20:34:54

my_archive_2.cfg

# 3

Aug 05 2007 20:44:54

my_archive_3.cfg

# indicates the most recent archive file.


Next archive file to be saved: my_archive_4.cfg

Table 14 Command output


Field

Description

Location

Absolute path of the saved configuration files.

Filename prefix

Filename prefix of the saved configuration files.

Archive interval in minutes


Filename

Configuration file saving interval, in minutes.


If the automatic saving is disabled, this field is not displayed.
Filename of the saved configuration files, with path excluded.

110

display current-configuration
Description
Use display current-configuration to view the current validated device configuration.

Parameter retaining their default configurations are not displayed.

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.

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

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:

isis: Displays the isis configuration.

isp: Displays the ISP configuration.

post-system: Displays the post-system configuration.

radius-template: Displays the Radius template configuration.

system: Displays the system configuration.

user-interface: Displays the user interface configuration.

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.

acl: Excludes the IPv4 ACL configuration.

acl6: Excludes the IPv6 ACL configuration.

by-linenum: Specifies to display 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.
111

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

Pressing Enter displays the next line.

Pressing Space displays the next screen.

Pressing Ctrl+C or any other key exist the 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:

---- More ----

display startup
Description
Use display startup to view the configuration file for the system startup and the configuration files for
the next system startup.

After the master is changed, it runs with the current configuration.

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.

Related commands: startup saved-configuration.

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

Table 15 Command output


Field

Description

MainBoard

The configuration files for the current and the next


startup of the master

Current Startup saved-configuration file

The configuration file for the current startup

Next main startup saved-configuration file

The main configuration file for the next startup

Next backup startup saved-configuration file

The backup configuration file for the next startup

Slot 2

The configuration files for the current and the next


startup of the subordinate switch (with the member ID 2)

display this
Description
Use display this to check whether your configuration takes effect by displaying the validated
configuration information under the current view.

The validated default configuration is not displayed.

The invalidated configuration is not displayed.

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 in the name of test.cfg to a subordinate switch.

Approach 1: With the member ID of 2:


<Sysname> save test.cfg slot 2
The current configuration will be saved to slot2#flash:/test.cfg.
Continue? [Y/N]:y
Now saving current configuration to the device.
Saving configuration slot2#flash:/test.cfg. Please wait...
.........
Configuration is saved to slot2#flash successfully.

Approach 2: Use the following command:


<Sysname> save slot2#flash:/test.cfg

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

slave auto-update config


Description
Use slave auto-update config to enable the configuration file auto-save function. By default, the
configuration file auto-save function is enabled.
Use undo slave auto-update config to disable the function.

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.

Related commands: display startup.

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

Software upgrade commands


boot-loader
Description
Use boot-loader to specify a boot file for the next device boot of a member switch.

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.

Related commands: display boot-loader.

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:

The items in square brackets [ ] are optional.

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.

file-name specifies the filename, usually suffixed by .bin.

slot slot-number: Specifies the member ID of a device.

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!

boot-loader update file


Description
Use boot-loader update file to specify a boot file to be used at the next boot of a member switch or
all the member switches. Execution of this command equals the following steps:

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.

bootrom-update security-check enable


Description
Use bootrom-update security-check enable to enable the validity check function.

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

The main boot app is:

flash:/test.bin

The backup boot app is:

flash:/test.bin

131

Table 16 Command output


Field

Description

Slot 1

The member ID of the device is 1

The current boot app is

Boot file used for the device for the current device boot

The main boot app is

Main boot file used for the next device boot of the device

The backup boot app is

Backup boot file used for the next device boot of the device

display patch information


Description
Use display patch information to view hotfix information.

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

Temporary Common Current Active Running

Start-Address

---------------------------------------------------------------------1

MPU

0x86262dd8

1.1

LPU

0x809533a4

132

Table 17 Command output


Field

Description

The location of patches

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

Number of temporary patches.

Common

Number of common patches.

Current

Total number of patches.

Running

Number of patches in the RUNNING state.

Active

Number of patches in the ACTIVE state.

Start-Address

Starting address of the memory patch area in the memory.

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.

The system will run at the original software version.

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.

Use undo patch install to remove the patches.

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.

Related commands: issu 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

Table 18 Command output


Field

Description

RollBack timer is in process

An ISSU upgrade is being performed and the rollback timer runs


normally.
The rollback timer is not working.

RollBack timer is not in process

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

display issu state


Description
This command helps you determine the next step during an ISSU upgrade that must follow a strict
procedure.
Use display issu state to view the ISSU state, including whether the new boot file is compatible with
the current one and the adopted ISSU upgrade method.

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

<Sysname> display issu state


ISSU state: Load
Compatibility: Compatible
Work State: Normal
Upgrade Method: Board by board
Original version:

R1210

Original boot file is flash:/A5800_r1210.bin


Upgrade version:

R1211

Upgrade boot file is flash:/A5800_r1211.bin

Table 19 Command output


Field

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

timer has been deleted. No auto-rollback will be performed during


this ISSU process.

Commit: Not all the IRF member switches have been upgraded. In

this state, neither manual nor automatic rollback can be performed.

Version compatibility check results:

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.

The working mode of the IRF virtual switch:


Work State

Normal: Normal working mode.


Independent active: Incompatible ISSU is adopted. The specified
IRF member switch enters the Recover state after it is rebooted
with the new boot file.

Upgrade Method

ISSU upgrade method, which takes the value of Board by board.

Original version

Original boot file version.

Original boot file

Directory of the original boot file of each IRF member switch.

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.

Upgrade boot file

Directory of the new boot file.

140

display version comp-matrix


Description
Use display version comp-matrix to display version compatibility information.

If you provide the upgrading-filename parameter, the compatibility information between the
specified boot file and the boot file is displayed.

If you do not provide the upgrading-filename parameter, information recorded in the


compatibility database reflects version compatibility of the current boot file and the history boot
file.

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:

The items in square brackets [ ] are optional.

drive specifies the Flash of a member switch, and takes the format [ slotslot-number# ]flash:.

file-name specifies the name of the new boot file.

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

Number of Matrices in Table = 1


Matrix for HP A5800-24G-PoE+ Switch
Running Version:R1210
Version Compatibility List:
R1211 (Compatible)

Table 20 Command output


Field

Description

Number of Matrices in
Table

Number of product versions contained in the current IRF virtual switch.

Matrix for xx

Product version of the xx switch series.

Running Version

Current boot file version of the IRF virtual switch.

Version Compatibility List

List of software version compatibility information.

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.

All IRF member switches run the same boot file.

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:

The items in square brackets [ ] are optional.

drive specifies the Flash of a member switch, and takes the format [ slot slot-number# ]flash:.

file-name specifies the name of the new boot file.

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.

Related commands: issu load.

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

will roll back

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

issu run switchover


Description
Use issu run switchover to reboot the master.
During compatible ISSU upgrade, the system automatically stops the ISSU upgrade process and
reverts to the previous boot file version if

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

Device management commands


clock datetime
Description
Use clock datetime to set the devices current time and date. You can leave the SS field when you
specify the time parameters.
Related commands: display clock, clock summer-time one-off, clock summer-time repeating, and
clock timezone.

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

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


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

clock summer-time one-off


Description
Use clock summer-time one-off to adopt daylight saving time from the start-time of the start-date to the
end-time of the end-date. clock summer-time one-off adds the add-time to the standard time of the
device.

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

clock summer-time repeating


Description
Use clock summer-time repeating to adopt daylight saving time repeatedly. Daylight saving time adds
one hour to the devices standard time.

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

Use undo copyright-info enable to disable display of copyright information.


By default, the display of copyright information is enabled.

Syntax
copyright-info enable
undo copyright-info enable

View
System view

Default level
3: Manage level

Parameters
None

Examples
1.

Enable the display of copyright information.


<Sysname> system-view
[Sysname] copyright-info enable

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.

Disable the display of copyright information.


<Sysname> system-view
[Sysname] undo copyright-info enable

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.

Please press ENTER.

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.

The maximum number of records saved depends on device model.

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

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.


cpu cpu-number: Displays the CPU usage statistics of a specific CPU. If the cpu-number argument is
not provided, the system displays the CPU usage statistics of all CPUs of the member device.

Examples
1.

Display information of the current CPU usage statistics.


<Sysname> display cpu-usage
Slot 1 CPU usage:
6% in last 5 seconds
10% in last 1 minute
5% in last 5 minutes
Slot 2 CPU usage:
5% in last 5 seconds
8% in last 1 minute
5% in last 5 minutes

2.

Display the last fifth and sixth records of the CPU usage statistics history.
<Sysname> display cpu-usage 2 4
===== CPU usage info (no:

idx: 58) =====

CPU Usage Stat. Cycle: 60 (Second)


CPU Usage

: 3%

CPU Usage Stat. Time : 2006-07-10

10:56:55

CPU Usage Stat. Tick : 0x1d9d(CPU Tick High) 0x3a659a70(CPU Tick Low)
Actual Stat. Cycle

: 0x0(CPU Tick High) 0x95030517(CPU Tick Low)

===== CPU usage info (no:

idx: 57) =====

CPU Usage Stat. Cycle: 60 (Second)


CPU Usage

: 3%

CPU Usage Stat. Time : 2006-07-10

10:55:55

CPU Usage Stat. Tick : 0x1d9c(CPU Tick High) 0xa50e5351(CPU Tick Low)
Actual Stat. Cycle

: 0x0(CPU Tick High) 0x950906af(CPU Tick Low)

155

Table 21 Command output


Field

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.

Slot 2 CPU usage

The CPU usage of the device with the member ID of 2). (On a centralized
IRF member device).

CPU usage info (no: idx:)

Information of CPU usage records (no: The (no+1)th record is currently


displayed. no numbers from 0, a smaller number equals a newer record.
idx: index of the current record in the history record table). If only the
information of the current record is displayed, no and idx are not displayed.

CPU Usage Stat. Cycle

CPU usage measurement interval, in seconds. For example, if the value is


41, it indicates that the average CPU usage during the last 41 seconds is
calculated. The value range of this field is 1 to 60.

CPU Usage

Average CPU usage in a measurement interval, in percentage.

CPU Usage Stat. Time

CPU usage statistics time in seconds, that is, the system time when the
command is executed.

CPU Usage Stat. Tick

System runtime in ticks, represented by a 64-bit hexadecimal. CPU Tick


High represents the most significant 32 bits and the CPU Tick Low the least
significant 32 bits.

Actual Stat. Cycle

Actual CPU usage measurement interval in ticks, represented by a 64-bit


hexadecimal. CPU Tick High represents the most significant 32 bits and the
CPU Tick Low the least significant 32 bits. Owing to the precision of less
than one second, the actual measurement periods of different CPU usage
records might differ slightly.

display cpu-usage history


Description
Use display cpu-usage history to view CPU usage history statistics over the last 60 minutes plotted in
a chart.
The system takes CPU usage statistics at intervals and saves the results in the history record area. The
statistical results are displayed through x and y coordinates. In the output information:

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

The y-axis indicates the time.

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)

cpu-usage last 60 minutes(SYSTEM)

The output shows the CPU usage of the whole system (with the task name SYSTEM) in the last 60
minutes:

5%: 12 minutes ago

10%: 13 minutes ago

15%: 14 minutes ago

10%: 15 minutes ago

5%: 16 and 17 minutes ago

10%: 18 minutes ago

5%: 19 minutes ago

2% or lower than 2%: other time

158

# Display the CPU usage statistics of task 6.


<Sysname> display cpu-usage history task 6
100%|
95%|
90%|
85%|
80%|
75%|
70%|
65%|
60%|
55%|
50%|
45%|
40%|
35%|
30%|
25%|
20%|
15%|
10%|
5%|

-----------------------------------------------------------10

20

30

40

50

60

(minutes)

cpu-usage last 60 minutes(T03M)

The output shows the CPU usage of task 6 (with the task name T03M) in the last 60 minutes:

5%: 20 minutes ago

2% or lower than 2%: other time

display device
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

FPGAVer CPLDVer BootRomVer AddrLM Type

State

NULL

Normal

18

Ver.B

002 002 013

IVL

MAIN

Slot 2
SubSNo PortNum PCBVer

FPGAVer CPLDVer BootRomVer AddrLM Type

State

18

Ver.A

NULL

002 002 013

IVL

MAIN

Normal

Ver.A

NULL

001

NULL

IVL

LSW1SP4P0

Normal

Ver.B

NULL

001

NULL

IVL

LSW1XP4P0

Normal

Slot 3
SubSNo PortNum PCBVer

FPGAVer CPLDVer BootRomVer AddrLM Type

State

NULL

Normal

18

Ver.B

002 002 013

IVL

MAIN

Slot 4
SubSNo PortNum PCBVer

FPGAVer CPLDVer BootRomVer AddrLM Type

State

NULL

Normal

18

Ver.B

002 002 013

160

IVL

MAIN

Table 22 Command output


Field

Description

Slot 1

Information of member device 1.


Number of the slot in which the host or subcard resides:

SubSNo

0Host slot.
1Subcard slot 1.
2Subcard slot 2.

PortNum

Maximum number of ports that the host or subcard supports.

PCBVer

PCB version of the host or subcard.

FPGAVer

FPGA version of the host or subcard.

CPLDVer

CPLD version of the host or subcard.

BootRomVer

Boot ROM version of the host or subcard.


Address learning mode:

AddrLM

IVLIndependent VLAN learning.


SVLShared VLAN learning.
Type of the host or subcard:

Type

HostMAIN is displayed for this type.


SubcardThe specific model is displayed for this type.
State of the host or subcard:

State

Normal.
Absent.
Fault.

display device manuinfo


Description
Use display device manuinfo to display electrical label information about the device.

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.

The output by this command depends on the device model.

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.

power supply unit (PSU), where

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.

Display electrical label information (on the 5800AF-48G Switch(JG225A) or 5820AF-24XG


Switch(JG219A)).
<Sysname> display device manuinfo
Slot 1:
DEVICE_NAME

: A5800AF-48G JG225A

DEVICE_SERIAL_NUMBER : CN13F5D001
MAC_ADDRESS

: 20FDF1AC81BB

MANUFACTURING_DATE

: 2011-03-10

VENDOR_NAME

: HP

Power 1:
DEVICE_NAME

: NONE

MANU SERIAL NUMBER

: US0BF64123

MANUFACTURING_DATE

: NONE

VENDOR_NAME

: NONE

Power 2:
DEVICE_NAME

: NONE

MANU SERIAL NUMBER

: US0BF75832

MANUFACTURING_DATE

: NONE

VENDOR_NAME

: NONE

Fan 1:
DEVICE_NAME

: HP A58x0AF bck(pwr)-frt(ports)Fan Tray JC682A

DEVICE_SERIAL_NUMBER : WB12FDD001
MANUFACTURING_DATE

: 2011-03-25

VENDOR_NAME

: HP

162

Fan 2:
DEVICE_NAME

: HP A58x0AF bck(pwr)-frt(ports)Fan Tray JC682A

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

Table 23 Command output


Field

Description

Slot

IRF member ID

Fan

Fan ID

Power

PSU ID

DEVICE_NAME

Device name

DEVICE_SERIAL_NUMBER

Device serial number

MAC_ADDRESS

MAC address of the device

MANUFACTURING_DATE

Manufacturing date of the device

VENDOR_NAME

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.

Execution of the display diagnostic-information command equals execution of the commands


display clock, display version, display device, and display current-configuration one by one.

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.

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


<Sysname> display diagnostic-information
Save or display diagnostic information (Y=save, N=display)?[Y/N]y
Please input the file name(*.diag)[flash:/default.diag]:aa.diag
Diagnostic information is outputting to flash:/aa.diag.
Please wait...
Save succeeded.

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.

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


<Sysname> display diagnostic-information
Save or display diagnostic information (Y=save, N=display)? [Y/N]:n
=================================================
===============display clock===============
=================================================
08:54:16 UTC Fri 11/15/2011
===================================================
===============display version===============
===================================================

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

Table 24 Command output


Field

Description

Slot

Member ID of the device.

Sensor

Temperature sensor.

hotspotA hotspot sensor.

Temperature

Current temperature of the temperature sensor.

LowerLimit

Temperature lower limit of the temperature sensor.

WarningLimit

Warning temperature threshold of the temperature sensor.

AlarmLimit

Alarming temperature threshold of the temperature sensor.

ShutdownLimit

Shut-down temperature threshold of the temperature sensor. When


the sensor temperature reaches this limit, the device shuts down
automatically.

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

Prefer Wind Direction


FAN

State

: Normal

Wind Direction

:Power-to-Port

Prefer Wind Direction

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

Table 25 Command output


Field

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:

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

Related commands: job, time, and view.

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

Table 26 Command output


Field

Description

Job name

Name of a scheduled task

Specified view

View where the specified command or commands are to be


executed

Time 1: Execute command

Execute the task at the specified time

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%

Table 27 Command output


Field

Description

System Total Memory(bytes)

Total size of the system memory in bytes

Total Used Memory(bytes)

Size of the memory used in bytes

Used Rate

Percentage of the memory used to the total memory

display 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

Table 28 Command output


Field

Description

Slot 1

PSU information of the member device. The member ID is 1 in this output.


PSU number:

Power

If only one PSU is displayed, the system uses a fixed PSU.


If two PSUs are displayed, the system uses swappable PSUs.
PSU state:

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

regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.

Example
# Display RPS status.
<Sysname> display rps
Slot 1
Power

State

: Absent

Slot 2
Power

State

: Absent

Table 29 Command output


Field

Description

Slot 1

Member device 1

Power

RPS ID
RPS state:

State

Normal
Absent
Fault

display schedule job


Description
Use display schedule job to view the configuration set by the schedule job command.
Related commands: schedule job.

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

View for the command to be executed

Executed time

Execution time of the command and the difference between


the current time and scheduled time

display schedule reboot


Description
Use display schedule reboot to view the device reboot time set by the user.
Related commands: schedule reboot at and schedule reboot delay.

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)

Digital Diagnostic Monitoring : YES


Vendor Name

: HP

Ordering Name

: JD118B

176

Table 31 Command output


Field

Description

transceiver information

Pluggable transceiver information.

Transceiver Type

Pluggable transceiver type.


Type of the connectors of the transceiver:

Connector Type

Optical connectors, including SC (SC connector, developed by NTT) and LC


(LC connector, 1.25 mm/RJ-45 optical connector developed by Lucent).

Other connectors, including RJ-45 and CX 4.


Optical transceiver: central wavelength of the laser sent, in nm. If the

transceiver supports multiple wavelengths, every two wavelength values are


separated by a comma.

Wavelength(nm)

Electrical transceiver: displayed as N/A.

Transfer distance(xx)

Digital Diagnostic
Monitoring

Transfer distance, with xx representing km for single-mode transceivers and


m for other transceivers. If the transceiver supports multiple transfer medium,
every two values of the transfer distance are separated by a comma. The
corresponding transfer medium is included in the bracket following the
transfer distance value. The following are the transfer media:

9 um9/125 um single-mode fiber.


50 um50/125 um multi-mode fiber.
62.5 um62.5/125 um multi-mode fiber.
TPTwisted pair.
CX4CX4 cable.

Whether the digital diagnosis function is supported, where:

YESSupported.
NONot supported.

Vendor Name

Vendor name.

Ordering Name

Product code.

display transceiver alarm


Description
Use display transceiver alarm to view the current alarm information of transceivers.

If no error occurs, None is displayed.

Support for transceivers depends on the device module.

Table 32 shows the alarm information that might occur to the commonly used transceivers.

177

Table 32 Alarms for commonly used transceivers


Field

Remarks

SFP/SFP+
RX loss of signal

Incoming (RX) signal is lost.

RX power high

Incoming (RX) power level is high.

RX power low

Incoming (RX) power level is low.

TX fault

Transmit (TX) fault.

TX bias high

TX bias current is high.

TX bias low

TX bias current is low.

TX power high

TX power is high.

TX power low

TX power is low.

Temp high

Temperature is high.

Temp low

Temperature is low.

Voltage high

Voltage is high.

Voltage low

Voltage is low.

Transceiver info I/O error

Transceiver information read and write error.

Transceiver info checksum error

Transceiver information checksum error.

Transceiver type and port configuration


mismatch

Transceiver type does not match port configuration.

Transceiver type not supported by port


hardware

Transceiver type is not supported on the port.

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

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

Table 33 Command output


Field

Description

Transceiver current alarm information

Current alarm information of the transceiver.

RX loss of signal

Incoming (RX) signal is lost.

RX power low

Incoming (RX) power level is low.

display transceiver diagnosis


Description
Use display transceiver diagnosis to view the currently measured value of digital diagnosis
parameters of pluggable transceivers.

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

Table 34 Command output


Field

Description

Transceiver diagnostic information

Digital diagnosis information of the transceiver plugged in


the interface.

Current diagnostic parameters

Current diagnostic parameters.

Temp.(C)

Digital diagnosis parameter-temperature, in C, with the


precision to 1C.

Voltage(V)

Digital diagnosis parameter-voltage, in V, with the


precision to 0.01 V.

Bias(mA)

Digital diagnosis parameter-bias current, in mA, with


the precision to 0.01 mA.

RX power(dBm)

Digital diagnosis parameter-RX power, in dBm, with the


precision to 0.01 dBm.

TX power(dBm)

Digital diagnosis parameter-TX power, in dBm, with the


precision to 0.01 dBm.

display transceiver manuinfo


Description
Use display transceiver manuinfo to view the electrical label information of a single or all pluggable
transceivers.

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

Table 35 Command output


Field

Description

Manu. Serial Number

Serial number generated during debugging and testing of the


customized transceivers.

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

HP A5800-24G-PoE+ Switch with 2 Processors


512M

bytes SDRAM

4M

bytes Nor Flash Memory

512M

bytes Nand Flash Memory

Config Register points to Nand Flash

Hardware Version is Ver.B


CPLD Version is 003
BootRom Version is 212
[SubSlot 0] 24GE+4SFP Plus+POE Hardware Version is Ver.B
[SubSlot 1] No Module

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

Table 36 Command output


Field

Description

No.

Serial number

Version

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

Configure banners. Character % is the starting/ending character of text in this example.


Entering % after the displayed text quits the header command. As the starting and ending
character, % is not a part of a banner.
<Sysname> system-view
[Sysname] header incoming %
Please input banner content, and quit with the character '%'.
Welcome to incoming(header incoming)%
[Sysname] header legal %
Please input banner content, and quit with the character '%'.
Welcome to incoming(header incoming)%
[Sysname] header legal %
Please input banner content, and quit with the character '%'.
Welcome to legal (header legal)%
[Sysname] header login %
Please input banner content, and quit with the character '%'.
Welcome to login(header login)%
[Sysname] header motd %
Please input banner content, and quit with the character '%'.
Welcome to motd(header motd)%
[Sysname] header shell %
Please input banner content, and quit with the character '%'.
Welcome to shell(header shell)%

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

Welcome to legal(header legal)


Press Y or ENTER to continue, N to exit.
Welcome to motd(header motd)
Welcome to login(header login)
Login authentication

Password:
Welcome to shell(header shell)

<Sysname>

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

reset unused porttag


Description
Use reset unused porttag to clear the 16-bit index saved but not used in the current systems of all
member devices.
A confirmation within 30 seconds is required. The command will not execute if you fail to make a
confirmation within 30 seconds or enter N to cancel the operation.

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

Use undo schedule job to remove the scheduled task.

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:

shellRepresents user view.

systemRepresents system view.

command: Command to be executed.

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

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

vty0(192.168.1.54): Set schedule reboot parameters at 11:43:11 06/06/2006, and


system will reboot at 12:00 06/06/2006.

schedule reboot delay


Description
CAUTION:
This command reboots the device after the specified delay time, which results in service interruption.
Use it with caution.
Use schedule reboot delay to enable the scheduled reboot function of all member devices and set a
reboot wait time.

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.

Configure the device to reboot in 88 minutessupposing the current time is 11:48.


<Sysname> schedule reboot delay 88
Reboot system at 13:16 06/06/2006(in 1 hour(s) and 28 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 on the terminal.
<Sysname>
%Jun

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

vty0(192.168.1.54): Set schedule reboot parameters at 11:48:44 06/06/2006, and


system will reboot at 13:16 06/06/2006.

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.

The alarming threshold must be higher than the warning threshold.

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

Table 37 Temperature alarm thresholds for a device


Device

Sensor

Lower
limit

Warning
limit

Alarm
limit

5820X-14XG-SFP+ Switch with 2 Interface Slots(JC106A)/

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

5820X-14XG-SFP+ TAA Switch with 2 Interface Slots(JG259A)


5820X-24XG-SFP+ Switch(JC102A)/
5820X-24XG-SFP+ TAA-compliant Switch (JG243A)
5820AF-24XG Switch(JG219A)

5800-48G-PoE+ Switch with 2 Interface Slots(JC101A)/


5800-48G-PoE+ TAA Switch with 2 Interface Slots(JG242A)

5800-48G-PoE+ Switch with 1 Interface Slot(JC104A)/


5800-48G-PoE+ TAA Switch with 1 Interface Slot(JG257A)
5800-48G Switch with 1 Interface Slot(JC105A)/
5800-48G TAA Switch with 1 Interface Slot(JG258A)

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)

Related commands: display environment.

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.

The commands in a scheduled task must be in the same view.

A scheduled task can contain up to 10 commands.

To execute more than 10 commands, configure multiple scheduled tasks.

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.

Schedule a task to disable PoE on the device on sixth April 2008.


<Sysname> system-view
[Sysname] job phone
[Sysname-job-phone] time 2 at 8:00 2008/04/06 command undo poe enable

time delay
Description
Use time delay to configure a scheduled task to be executed after a delay time.

The commands in a scheduled task must be in the same view.

A scheduled task can contain up to 10 commands.

To execute more than 10 commands, configure them in different tasks.

Use undo time to remove it (by default no time delay is configured).

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

Support and other resources


Contacting HP
For worldwide technical support information, see the HP support website:
http://www.hp.com/support
Before contacting HP, collect the following information:

Product model names and numbers

Technical support registration number (if applicable)

Product serial numbers

Error messages

Operating system type and revision level

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

HP download drivers and software http://www.hp.com/support/downloads

HP software depot http://www.software.hp.com

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

Asterisk-marked braces enclose a set of required syntax choices separated by vertical


bars, from which you select at least one.

[ x | y | ... ] *

Asterisk-marked square brackets enclose optional syntax choices separated by vertical


bars, from which you select one choice, multiple choices, or none.

&<1-n>

The argument or keyword and argument combination before the ampersand (&) sign
can be entered 1 to n times.

A line that starts with a pound (#) sign is comments.

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

An alert that calls attention to essential information.

NOTE
TIP

An alert that contains additional or supplementary information.


An alert that provides helpful information.

200

Network topology icons


Represents a generic network device, such as a router, switch, or firewall.
Represents a routing-capable device, such as a router or Layer 3 switch.
Represents a generic switch, such as a Layer 2 or Layer 3 switch, or a router that
supports Layer 2 forwarding and other Layer 2 features.

Port numbering in examples


The port numbers in this document are for illustration only and might be unavailable on your device.

201

Index
ABCDEFGHIJLMOPQRSTUV
A

copyright-info enable,151

acl (user interface view),15

activation-key,16

databits,21

archive configuration,105

debugging,63

archive configuration interval,105

delete,89

archive configuration location,106

delete,64

archive configuration max,107

dir,90

ascii,59

dir,65

authentication-mode,19

disconnect,66

auto-execute command,17

display archive configuration,110

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

boot-loader update file,128

display cpu-usage history,156

bootrom,129

display current-configuration,111

bootrom-update security-check enable,130

display default-configuration,112

bye,60

display device,159

display device manuinfo,161

cd,88

display diagnostic-information,164

cd,61

display environment,165

cdup,61

display fan,166

clock datetime,148

display ftp client configuration,66

clock summer-time one-off,148

display ftp-server,53

clock summer-time repeating,149

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

display issu rollback-timer,138

command-alias mapping,1

display issu state,139

command-privilege,2

display job,168

configuration replace file,109

display memory,169

copy,89

display nandflash badblock-location,93


202

display nandflash file-location,92

ftp timeout,57

display nandflash page-data,94

ftp update,57

display patch information,132

display power,170

get,70

display reboot-type,171
display rps,172

display saved-configuration,114

header,184

display schedule job,173

history-command max-size,33

display schedule reboot,174

hotkey,7

display startup,117

display system-failure,175

idle-timeout,34

display telnet client configuration,24

ip http acl,34

display tftp client configuration,83

ip http enable,35

display this,118

ip http port,35

display transceiver,175

ip https acl,36

display transceiver alarm,177

ip https certificate access-control-policy,37

display transceiver diagnosis,179

ip https enable,38

display transceiver manuinfo,180

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

display version comp-matrix,141

issu load,143

display version-update-record,182

issu rollback,144

display web users,28

issu rollback-timer,145

issu run switchover,146

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

free ftp user,55

mkdir,73

free user-interface,31

mkdir,97

free web-users,32

more,98

ftp,67

move,99

ftp client source, 68

ftp ipv6,69

open,73

ftp server acl,56

open ipv6,74

ftp server enable,56


203

send,43

parity,40

set authentication password,44


shell,45

passive,75

shutdown-interval,192

patch active,133

slave auto-update config,124

patch deactive,134

speed (user interface view),45

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

telnet server enable,49

reboot,186

temperature-limit,194

remotehelp,78

terminal type,50

rename,100

tftp,84

reset recycle-bin,101

tftp client source,86

reset saved-configuration,120

tftp ipv6,87

reset unused porttag,187

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

user privilege level,51

save,122

user-interface,52

schedule job,188

schedule reboot at,190

verbose,81

schedule reboot delay,191

view,198

screen-length,42
screen-length disable,10

204

Вам также может понравиться