H3C WX Series Command Reference 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

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,

, H

3

Care,

, TOP G, , IRF, NetPilot, Neocean,

NeoVTL, SecPro, SecPoint, SecEngine, SecPath, Comware, Secware, Storware, NQA,

VVG, V

2

G, V

n

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

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

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

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

4 TFTP client configuration commands ···················································································68

display tftp client configuration······························································································· 68

tftp-server acl ························································································································ 68

tftp ······································································································································· 70

tftp client source···················································································································· 71

tftp ipv6 ································································································································ 72

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

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

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

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

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

1 CLI 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 put source-filename command (such as the

tftp 192.168.1.26 put syslog.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

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

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.

Page is loading ...

H3C WX Series Command Reference Manual

H3C WX Series Command Reference Manual

Related papers

Other documents