H3C WX Series Installation manual

H3C WX Series Access Controllers
Fundamentals Command Reference
Abstract
This document details the fundamentals commands for the WX series access controllers.
Hangzhou H3C Technologies Co., Ltd.
http://www.h3c.com

2
Copyright © 2009-2010, Hangzhou H3C Technologies Co., Ltd. and its licensors
No part of this manual may be reproduced or transmitted in any form or by any means
without the prior written consent of Hangzhou H3C Technologies Co., Ltd.
The information in this document is subject to change without notice. Every effort has
been made in the preparation of this document to ensure accuracy of the contents.
However, the statements, information, and recommendations in this document do not
constitute a warranty of any kind, express or implied. Hangzhou H3C Technologies Co.,
Ltd. and its licensors shall not be liable for technical or editorial errors or omissions
contained herein.
Acknowledgments
H3C, , Aolynk, , H3Care, , TOP G, , IRF, NetPilot, Neocean,
NeoVTL, SecPro, SecPoint, SecEngine, SecPath, Comware, Secware, Storware, NQA,
VVG, V2G, VnG, PSPT, XGbus, N-Bus, TiGem, InnoVision and HUASAN are trademarks of
Hangzhou H3C Technologies Co., Ltd.
All other trademarks that may be mentioned in this guide are the property of their
respective owners.
Environmental protection
This product has been designed to comply with the environmental protection
requirements. The storage, use, and disposal of this product must meet the applicable
national laws and regulations.

3
Table of Contents
1CLI commands ·················································································································11
command-alias enable·········································································································· 11
command-alias mapping······································································································· 11
command-privilege level ······································································································· 12
display command-alias·········································································································· 14
display history-command ······································································································· 15
display hotkey ······················································································································· 16
hotkey ·································································································································· 17
quit······································································································································· 19
return···································································································································· 19
screen-length disable ············································································································ 20
system-view··························································································································· 21
2Commands for logging in to an access controller·································································22
acl (user interface view)········································································································· 22
authorization-attribute ··········································································································· 24
display telnet client configuration ··························································································· 27
header ································································································································· 27
service-type ·························································································································· 30
service-type lan-access ········································································································· 31
sysname ······························································································································· 31
telnet···································································································································· 32
telnet client source ················································································································ 33
telnet ipv6····························································································································· 34
telnet server enable··············································································································· 35
3FTP configuration commands ·····························································································36
FTP server configuration commands ···························································································· 36

4
display ftp-server ··················································································································· 36
display ftp-user ······················································································································ 37
free ftp user··························································································································· 38
ftp server acl ························································································································· 38
ftp server enable ··················································································································· 39
ftp timeout ···························································································································· 40
ftp update ···························································································································· 41
FTP client configuration commands ····························································································· 41
ascii······································································································································ 42
binary ··································································································································· 42
bye······································································································································· 43
cd ······································································································································· 44
cdup ···································································································································· 45
close ···································································································································· 45
debugging···························································································································· 46
delete··································································································································· 48
dir ······································································································································· 48
disconnect···························································································································· 50
display ftp client configuration································································································ 50
ftp ······································································································································· 51
ftp client source····················································································································· 52
ftp ipv6 ································································································································· 53
get ······································································································································· 54
lcd ······································································································································· 55
ls ······································································································································· 56
mkdir ···································································································································· 57
open ···································································································································· 58
open ipv6 ····························································································································· 59
passive ································································································································· 60

5
put ······································································································································· 60
pwd······································································································································ 61
quit······································································································································· 62
remotehelp··························································································································· 62
rmdir····································································································································· 65
user ······································································································································ 65
verbose ································································································································ 66
4TFTP client configuration commands ···················································································68
display tftp client configuration······························································································· 68
tftp-server acl ························································································································ 68
tftp ······································································································································· 70
tftp client source···················································································································· 71
tftp ipv6 ································································································································ 72
5User interface configuration commands··············································································74
activation-key ······················································································································· 74
auto-execute command ······································································································· 75
authentication-mode ············································································································ 77
command accounting ·········································································································· 78
command authorization ········································································································ 79
databits ································································································································ 79
display history-command ······································································································· 80
display user-interface············································································································· 81
display users ·························································································································· 83
escape-key··························································································································· 84
free user-interface ················································································································· 86
history-command max-size····································································································· 86
idle-timeout··························································································································· 87
lock ······································································································································ 88
parity···································································································································· 89

6
protocol inbound ·················································································································· 90
screen-length························································································································ 91
send ····································································································································· 92
set authentication password ·································································································· 93
shell ······································································································································ 94
speed (in user interface view)································································································· 95
stopbits ································································································································· 96
terminal type························································································································· 97
user privilege level ················································································································· 98
user-interface ························································································································ 99
6File management commands ·························································································· 101
cd ····································································································································· 101
copy··································································································································· 102
delete································································································································· 103
dir ····································································································································· 103
execute ······························································································································ 105
file prompt ·························································································································· 106
fixdisk·································································································································· 106
format ································································································································ 107
mkdir ·································································································································· 108
more ·································································································································· 109
mount································································································································· 110
move·································································································································· 111
pwd···································································································································· 111
rename······························································································································· 112
reset recycle-bin·················································································································· 113
rmdir··································································································································· 114
umount······························································································································· 115
undelete····························································································································· 116

7
7Configuration file management commands ······································································118
archive configuration··········································································································· 118
archive configuration interval ······························································································· 118
archive configuration location······························································································ 120
archive configuration max ··································································································· 121
backup startup-configuration······························································································· 122
configuration encrypt ·········································································································· 123
configuration replace file ····································································································· 124
display archive configuration ······························································································· 124
display saved-configuration ································································································· 125
display startup····················································································································· 127
reset saved-configuration····································································································· 128
restore startup-configuration ································································································ 129
save ··································································································································· 130
startup saved-configuration ································································································· 131
8Device management commands·····················································································133
boot-loader ························································································································ 133
bootrom ····························································································································· 134
display boot-loader ············································································································· 135
display cpu-usage ··············································································································· 136
display cpu-usage history····································································································· 137
display device····················································································································· 139
display device manuinfo······································································································ 140
display device serial-number ································································································ 141
display environment ············································································································ 142
display fan ·························································································································· 142
display job ·························································································································· 143
display license ····················································································································· 144
display memory··················································································································· 145

8
display power······················································································································ 145
display reboot-type ············································································································· 146
display rps··························································································································· 147
display schedule reboot······································································································· 147
display system-failure ··········································································································· 148
job ····································································································································· 148
license append ··················································································································· 149
reboot ································································································································ 150
reset unused porttag ··········································································································· 151
schedule reboot at·············································································································· 152
schedule reboot delay········································································································· 153
system-failure ······················································································································ 155
temperature-limit················································································································· 155
time···································································································································· 156
view ··································································································································· 159
9Basic configuration commands ························································································161
clock datetime···················································································································· 161
clock summer-time one-off··································································································· 162
clock summer-time repeating······························································································· 163
clock timezone···················································································································· 165
configure-user count············································································································ 166
display clipboard················································································································· 167
display clock ······················································································································· 167
display configure-user ·········································································································· 168
display current-configuration································································································ 169
display diagnostic-information······························································································ 170
display this ·························································································································· 171
display version····················································································································· 172
header ······························································································································· 173

9
quick configuration·············································································································· 175
super ·································································································································· 175
super authentication-mode·································································································· 177
super password ··················································································································· 178
sysname ····························································································································· 179
10 HTTP configuration commands ························································································· 181
display ip http······················································································································ 181
ip http acl ··························································································································· 182
ip http enable ····················································································································· 183
ip http port·························································································································· 184
11 HTTPS configuration commands························································································ 185
display ip https ···················································································································· 185
ip https acl ·························································································································· 186
ip https certificate access-control-policy ··············································································· 187
ip https enable ···················································································································· 188
ip https port························································································································· 189
ip https ssl-server-policy ········································································································ 190
12 Hotfix configuration commands························································································ 191
display patch information ···································································································· 191
patch active ······················································································································· 192
patch deactive··················································································································· 192
patch delete······················································································································· 193
patch install ························································································································ 194
patch load·························································································································· 195
patch location ···················································································································· 195
patch run···························································································································· 196
13 Support and other resources ····························································································198
Related documentation ··········································································································· 198
Contacting H3C······················································································································· 198

10
Obtaining documentation ··································································································· 198
Technical support ················································································································ 198
Documentation feedback ··································································································· 199
Document conventions and symbols ························································································· 199
Conventions························································································································ 199
Symbols ······························································································································ 199
NOTE:
The models listed in this manual are not applicable to all regions. Please consult your local
sales office for models applicable to your region.
Support of the H3C WX series access controllers (ACs) for commands may vary by AC model.
For more information, see Feature Matrix and Command Matrix in H3C WX Series Access
Controllers WX Command References Getting Started.
The interface types and the number of interfaces vary by AC model. This document uses GE
interfaces to show how to configure Ethernet interfaces.
The sample output in this document was created on the WX5002. The output on your AC may
vary.

11
1CLI commands
command-alias enable
Syntax
command-alias enable
undo command-alias enable
View
System view
Default level
2: System level
Parameters
None
Description
Use the command-alias enable command to enable the command alias function.
Use the undo command-alias enable command to disable the command alias
function.
By default, the command alias function is disabled, which means command aliases
cannot be configured.
Examples
Example 1:
Enable the command alias function.
<Sysname> system-view
[Sysname] command-alias enable
Example 2:
Disable the command alias function.
<Sysname> system-view
[Sysname] undo command-alias enable
command-alias mapping
Syntax
command-alias mapping cmdkey alias

12
undo command-alias mapping cmdkey
View
System view
Default Level
2: System level
Parameters
cmdkey: The complete form of the first keyword of a command for which an alias will
be configured.
alias: Specifies the command alias, which cannot be the same as the first keyword of
an existing command.
Description
Use the command-alias mapping command to configure command aliases.
Use the undo command-alias mapping command to delete command aliases.
By default, a command does not have an alias.
Examples
Example 1:
Configure command aliases by specifying show as the replacement of the display
keyword.
<Sysname> system-view
[Sysname] command-alias mapping display show
After implementing the above configuration, the display commands have their aliases.
For example, if the original command is display clock, its alias is now show clock and
the alias can be input to view the system time and date.
Example 2:
Delete the command aliases by canceling the replacement of the display keyword.
<Sysname> system-view
[Sysname] undo command-alias mapping display
command-privilege level
Syntax
command-privilege level level view view command
undo command-privilege view view command
View
System view

13
Default Level
3: Manage level
Parameters
level level: Command level, which ranges from 0 to 3.
view view: Specifies a view. The value shell of the argument view represents user view.
The specified view must be the view to which the command provided by the
command argument belongs; for the corresponding view, refer to the “View”section
of the specified command.
command: Command to be set in the specified view.
Description
Use the command-privilege command to assign a level for the specified command in
the specified view.
Use the undo command-privilege view command to restore the default.
By default, each command in a view has its specified level. For more information, see
Basic System Configuration in the Fundamentals Configuration Guide. Command level
falls into four levels: visit, monitor, system, and manage, which are identified by 0
through 3. The administrator can assign a privilege level for a user according to his or
her need. When the user logs on a device, the commands available depend on the
user’s privilege. For example, if a user’s privilege is 3 and the command privilege of VTY
0 user interface is 1, and the user logs on the system from VTY 0, all the commands with
privilege smaller than three (inclusive) can be used.
Use the default command level or modify the command level under the guidance
of professional staff; otherwise, the change of command level may introduce
maintenance, operation, or security problems.
When you configure the command-privilege command, the value of the
command argument must be a complete form of the specified command. You
must enter all keywords and arguments needed for the command. The argument
should be in the value range. For example, the default level of the tftp server-
address { get | put | sget }source-filename [ destination-filename ][ source {
interface interface-type interface-number | ip source-ip-address } ] command is 3.
After the command-privilege level 0 view shell tftp 1.1.1.1 put a.cfg command is
executed, when users with the user privilege level of 0 log in to the device, they
can execute the tftp server-address putsource-filename command (such as the
tftp 192.168.1.26 putsyslog.txt command). Users with the user privilege level of 0
cannot execute the command with the get, sget or source keyword and cannot
specify the destination-filename argument.

14
When you configure the undo command-privilege command, the value of the
command argument can be an abbreviated form of the specified command. You
only need to enter the keywords at the beginning of the command. For example,
after the undo command-privilege view system ftp command is executed, all
commands starting with the keyword ftp (such as ftp server acl, ftp server enable,
and ftp timeout) are restored to the default level. If you have modified the
command level of commands ftp server enable and ftp timeout, and you want to
restore only the ftp server enable command to its default level, use the undo
command-privilege view system ftp server command.
If you modify the command level of a command in a specified view from the
default command level to a lower level, remember to 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 commands interface and
system-view is 2 (system level). If you want to make the interface command
available to users with the user privilege level of 1, you must execute the following
three commands: command-privilege level 1 view shell system-view, command-
privilege level 1 view system interface ethernet 1/1, and command-privilege level
1 view system quit, so that the login users with the user privilege level of 1 can enter
system view, execute the interface ethernet command, and then return to user
view.
Examples
Set the command level of the system-view command in user view to 3.
By default, users with the user privilege level of 2 or 3 can use the system-view
command after logging in. After the below configuration, only users with the user
privilege level of 3 can use this command to enter system view and configure the
device. This improves device security.
<Sysname> system-view
[Sysname] command-privilege level 3 view shell system-view
display command-alias
Syntax
display command-alias
View
Any view
Default Level
1: Monitor level

15
Parameters
None
Description
Use the display command-alias command to display defined command aliases and
the corresponding commands.
Examples
Display the defined command aliases and the corresponding commands.
<Sysname> display command-alias
Command alias is enabled
index alias command key
1 show display
display history-command
Syntax
display history-command
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display history-command command to display commands saved in the history
buffer.
The system saves validated history commands performed last in current user view to the
history buffer, which can save up to 10 commands by default. You can use the history-
command max-size command to set the size of the history buffer.
Related commands: history-command max-size.
Examples
Display validated history commands in current user view (the display information varies
with configuration).
<Sysname> display history-command
display history-command
system-view
vlan 2

16
quit
display hotkey
Syntax
display hotkey
View
Any view
Default Level
1: Monitor level
Parameters
None
Description
Use the display hotkey command to display hotkey information.
Examples
Display hotkey information.
<Sysname> display hotkey
----------------- HOTKEY -----------------
=Defined hotkeys=
Hotkeys Command
CTRL_G display current-configuration
CTRL_L display ip routing-table
CTRL_O undo debug all
=Undefined hotkeys=
Hotkeys Command
CTRL_T NULL
CTRL_U NULL
=System hotkeys=
Hotkeys Function
CTRL_A Move the cursor to the beginning of the current line.
CTRL_B Move the cursor one character left.
CTRL_C Stop current command function.
CTRL_D Erase current character.
CTRL_E Move the cursor to the end of the current line.
CTRL_F Move the cursor one character right.
CTRL_H Erase the character left of the cursor.
CTRL_K Kill outgoing connection.

17
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
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: Assigns the hot key Ctrl+G to a command.
CTRL_L: Assigns the hot key Ctrl+L to a command.
CTRL_O: Assigns the hot key Ctrl+O to a command.
CTRL_T: Assigns the hot key Ctrl+T to a command.
CTRL_U: Assigns the hot key Ctrl+U to a command.
command: The command line associated with the hot key.
Description
Use the hotkey command to assign a hot key to a command line.
Use the undo hotkey command to restore the default.

18
By default, the system specifies corresponding commands for Ctrl+G, Ctrl+L and Ctrl+O,
while the others are null.
Ctrl+G corresponds to display current-configuration
Ctrl+L corresponds to display ip routing-table
Ctrl+O corresponds to undo debugging all
You can customize this scheme as needed however.
Examples
Example 1:
Assign the hot key Ctrl+T to the display tcp status command.
<Sysname> system-view
[Sysname] hotkey ctrl_t display tcp status
Example 2:
Display the configuration of hotkeys.
[Sysname] display hotkey
----------------- HOTKEY -----------------
=Defined hotkeys=
Hotkeys Command
CTRL_G display current-configuration
CTRL_L display ip routing-table
CTRL_O undo debug all
CTRL_T display tcp status
=Undefined hotkeys=
Hotkeys Command
CTRL_U NULL
=System hotkeys=
Hotkeys Function
CTRL_A Move the cursor to the beginning of the current line.
CTRL_B Move the cursor one character left.
CTRL_C Stop current command function.
CTRL_D Erase current character.
CTRL_E Move the cursor to the end of the current line.
CTRL_F Move the cursor one character right.
CTRL_H Erase the character left of the cursor.
CTRL_K Kill outgoing connection.
CTRL_N Display the next command from the history buffer.
CTRL_P Display the previous command from the history buffer.
CTRL_R Redisplay the current line.
CTRL_V Paste text from the clipboard.
CTRL_W Delete the word left of the cursor.

19
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
Syntax
quit
View
Any view
Default Level
0: Visit level (in user view)
2: System level (in other views)
Parameters
None
Description
Use the quit command to exit to a lower-level view. If the current view is user view, the
quit command terminates the current connection and reconnects to the device.
Examples
Switch from GigabitEthernet 1/0/1 interface view to system view, and then to user view.
[Sysname-GigabitEthernet1/0/1] quit
[Sysname] quit
<Sysname>
return
Syntax
return
View
Any view except user view

20
Default Level
2: System level
Parameters
None
Description
Use the return command to return to user view from current view, as you do with the
hot key Ctrl+Z.
Related commands: quit.
Examples
Return to user view from GigabitEthernet 1/0/1 view.
[Sysname-GigabitEthernet1/0/1] return
<Sysname>
screen-length disable
Syntax
screen-length disable
undo screen-length disable
View
User view
Default Level
1: Monitor level
Parameters
None
Description
Use the screen-length disable command to disable the multiple-screen output function
of the current user.
Use the undo screen-length disable command to enable the multiple-screen output
function of the current user.
By default, a login user uses the settings of the screen-length command. The default
settings of the screen-length command are: multiple-screen output is enabled and 24
lines are displayed on the next screen. (For more information about the screen-length
command, see User Interface in the Fundamentals Command Reference.)
This command is applicable to the current user only and when a user re-logs in, the
settings restore to the system default.