Login
- Table of Contents
-
- 01-Fundamentals Command Reference
- 00-Preface
- 01-Feature Matrix
- 02-CLI Command
- 03-Controlling Login Users Commands
- 04-File Management Commands
- 05-FTP and TFTP Commands
- 06-Device Management Commands
- 07-Basic System Configuration Commands
- 08-HTTP Commands
- 09-Logging In to the AP Commands
- 10-Command Index
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 09-Logging In to the AP Commands | 148.67 KB |
Table of Contents
1 Commands for Logging In to an Access Point
Commands for Logging In to an Access Point
l The models listed in this document are not applicable to all regions. Please consult your local sales office for the models applicable to your region.
l Support of the H3C WA series WLAN access points (APs) for commands may vary by AP model. For more information, see Feature Matrix.
l The interface types and the number of interfaces vary by AP model.
1 Commands for Logging In to an Access Point
Commands for Logging In to an Access Point
activation-key
Syntax
activation-key character
undo activation-key
View
User interface view
Default Level
3: Manage level
Parameters
character: Shortcut key for starting terminal sessions, a single character (or its corresponding ASCII code value in the range 0 to 127) or a string of 1 to 3 characters. But in fact, only the first character functions as the shortcut key. For example, if you input an ASCII code value 97, the system will use its corresponding character a as the shortcut key; if you input the string b@c, the system will use the first letter b as the shortcut key.
Description
Use the activation-key command to define a shortcut key for starting a terminal session.
Use the undo activation-key command to restore the default.
By default, pressing the Enter key starts the terminal sessions. However, if you define a new shortcut key using the activation-key command, the Enter key no longer functions. You can use the display current-configuration command to display the shortcut key you have defined.
The display current-configuration command is not supported on the VTY user interface.
Examples
# Use letter s as the shortcut key for starting terminal sessions on the console port.
<Sysname> system-view
[Sysname] user-interface console 0
[Sysname-ui-console0] activation-key s
To verify the configuration, do the following:
# Exit the terminal session on the console port.
[Sysname-ui-console0] return
<Sysname> quit
******************************************************************************
* Copyright (c) 2004-2009 Hangzhou H3C Tech. Co., Ltd. All rights reserved. *
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
******************************************************************************
User interface con0 is available.
Please press ENTER.
# Enter s at the prompt of “Please press ENTER”. You will see the terminal session being started.
<Sysname>
%Mar 2 18:40:27:981 2005 Sysname SHELL/5/LOGIN: Console login from con0
authentication-mode
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 AAA in the Security Configuration Guide.
Description
Use the authentication-mode command to set the authentication mode when users log onto the device using the current user interface.
Use the undo authentication-mode command to restore the default.
By default, the authentication mode is password for VTY user interface and is none for console interface.
Related commands: set authentication password.
Examples
# Set that no authentication is needed when users use VTY 0 interface to log onto the device. (This mode may be insecure.)
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] authentication-mode none
# Set to use password authentication when users use VTY 0 interface to log onto the device. The authentication password is 321.
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] authentication-mode password
[Sysname-ui-vty0] set authentication password cipher 321
# Set to use username and password authentication when users use VTY 0 interface to log onto the device. The username is 123 and the authentication password is 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
auto-execute command
Syntax
auto-execute command command
undo auto-execute command
View
User interface view
Default Level
3: Manage level
Parameters
command: Command to be automatically executed.
Description
Use the auto-execute command command to specify a command to be executed automatically.
Use the undo auto-execute command command to disable this feature.
By default, command auto-execution is disabled.
The auto-execute command command is supported on all types of user interfaces except the console port.
Once a command is configured using the auto-execute command command, the system automatically executes the command when a user logs on from the interface where the command is configured. After the command is completed, the connection breaks automatically.
A good example is configuring the auto-execute command telnet command to let users telnet to the specified host automatically.
The auto-execute command command may disable you from configuring the system through the terminal line to which the command is applied. Therefore, before configuring the command and saving the configuration (using the save command), make sure that you can access the system by other means to remove the configuration in case a problem occurs.
Examples
# Automatically execute the display brief interface loopback command after a user logs on from the VTY 0 interface.
<Sysname> system-view
[Sysname] user-interface vty 0 4
[Sysname-ui-vty0-4] auto-execute command display brief interface loopback
% This action will lead to configuration failure through ui-vty0-4. Are you sure? [Y/N]:y
[Sysname-ui-vty0-4]
# Telnet to the device again, the display brief interface loopback command will be executed automatically before the telnet connection breaks. And the following information will be displayed:
******************************************************************************
* Copyright (c) 2004-2009 Hangzhou H3C Tech. Co., Ltd. All rights reserved. *
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
******************************************************************************
<Sysname>
The brief information of interface(s) under route mode:
Interface Link Protocol-link Protocol type Main IP
Loop1 UP UP(spoofing) LOOP --
<Sysname>
command accounting
Syntax
command accounting
undo command accounting
View
User interface view
Default Level
3: Manage level
Parameters
None
Description
Use the command accounting command to enable command accounting.
Use the undo command accounting command to restore the default.
By default, command accounting is disabled, that is, the accounting server does not record the commands that the users executed.
If command accounting is enabled, every executed command will be recorded on the HWTACACS server.
If both command accounting and command authorization are enabled, only the authorized and executed commands will be recorded on the HWTACACS server.
Examples
# Enable command accounting for VTY 0. Then the HWTACACS server records the commands executed by the users logging in from VTY 0.
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] command accounting
command authorization
Syntax
command authorization
undo command authorization
View
User interface view
Default Level
3: Manage level
Parameters
None
Description
Use the command authorization command to enable command authorization.
Use the undo command authorization command to restore the default.
By default, command authorization is disabled, that is, logged-in users can execute commands without authorization.
With command authorization enabled, users logging in from the current user interface can perform commands authorized by the server.
Examples
# Enable command accounting for VTY 0. Then users logging in through VTY 0 can perform the commands authorized by the HWTACACS server only.
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] command authorization
copyright-info enable
Syntax
copyright-info enable
undo copyright-info enable
View
System view
Default Level
3: Manage level
Parameters
None
Description
Use the copyright-info enable command to enable the display of copyright information.
Use the undo copyright-info enable command to disable the display of copyright information.
By default, the display of copyright information is enabled.
Examples
# Enable the display of copyright information
<Sysname> system-view
[Sysname] copyright-info enable
l If a user logs in to the device through Telnet, the following information is displayed:
**************************************************************************
* Copyright (c) 2004-2009 Hangzhou H3C Tech. Co., Ltd. All rights reserved.*
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
**************************************************************************
<Sysname>
l If a user has already logged in through the console port, and then quits user view, the following information is displayed:
**************************************************************************
* Copyright (c) 2004-2009 Hangzhou H3C Tech. Co., Ltd. All rights reserved.*
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
**************************************************************************
User interface con0 is available.
Please press ENTER.
databits
Syntax
databits { 5 | 6 | 7 | 8 }
undo databits
View
User interface view
Default Level
2: System level
Parameters
5: Five data bits for each character.
6: Six data bits for each character.
7: Seven data bits for each character.
8: Eight data bits for each character.
Description
Use the databits command to set data bits for each character.
Use the undo databits command to restore the default,.
By default, the data bits is eight.
l The command is only applicable to console ports.
l The data bits setting on the terminal and the device user interface must be the same for communication.
Examples
# Set data bits to 5.
<Sysname> system-view
[Sysname] user-interface console 0
[Sysname-ui-console0] databits 5
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 view the valid history commands that have been executed recently.
Currently, the system can display up to 256 history commands.
Related commands: history-command max-size.
Examples
# Display history commands. (The prompt information depends on the current configuration.)
<Sysname> display history-command
system-view
quit
display current-configuration
display user-interface
Syntax
display user-interface [ num1 | { console | vty } num2 ] [ summary ]
View
Any view
Default Level
1: Monitor level
Parameters
num1: Absolute number of a user interface. The value range from 0 to 5.
num2: Relative number of a user interface, in the following rules:
l For the console port, the value is 0.
l For VTY user interfaces, the value ranges from 0 to 4.
summary: Displays summary about user interfaces.
Description
Use the display user-interface command to view information about the specified or all user interfaces.
l If the summary keyword is absent, the command displays the type of the user interface, the absolute or relative number, the speed, the user privilege level, the authentication mode and the physical location.
l If the summary keyword is present, the command displays all the number and type of user interfaces.
Examples
# Display information about user interface 0.
<Sysname> display user-interface 0
Idx Type Tx/Rx Modem Privi Auth Int
+ 0 CON 0 9600 - 3 N -
+ : Current user-interface is active.
F : 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.
A : Authentication use AAA.
L : Authentication use local database.
N : Current UI need not authentication.
P : Authentication use current UI's password.
Table 1-1 display user-interface command output description
|
Field |
Description |
|
+ |
The current user interface is active. |
|
F |
The current user interface is active and works in asynchronous mode. |
|
Idx |
The absolute number of the user interface. |
|
Type |
The type and relative number of the user interface. |
|
Tx/Rx |
The speed of the user interface |
|
Modem |
Whether the modem is allowed to dial in (in), dial out (out), or both (inout) By default, the character - is displayed to indicate that this function is disabled. |
|
Privi |
Indicates the command level of a user under that user interface |
|
Auth |
The authentication mode for users logging in through the interface using AAA (A), current user interface password (P), local database (L), none authentication (N). |
|
Int |
The physical location of the user interfaces |
|
A |
Uses AAA authentication mode, and the corresponding authentication mode is scheme. |
|
L |
Uses local authentication (not supported at present) |
|
N |
No authentication is needed, the corresponding authentication mode is none. |
|
P |
Authenticates the user using the password of the current user interface, and the corresponding authentication mode is password. |
# Display summary about all user interfaces.
<Sysname> display user-interface summary
User interface type : [CON]
0:U
User interface type : [VTY]
1:XXXX X
1 character mode users. (U)
5 UI never used. (X)
1 total UI in use
Table 1-2 display user-interface summary command output description
|
Field |
Description |
|
User interface type |
Type of user interface (CON/VTY) |
|
0:X |
0 represents the absolute number of the user interface. X means this user interface is not used; U means this user interface is in use; the number of the character X and U indicates the total number of user interfaces. |
|
character mode users. (U) |
Number of mode users, that is, the number of character U. |
|
UI never used. (X) |
Number of user interfaces not used, that is, the number of character X. |
|
total UI in use |
Total number of user interfaces in use |
display users
Syntax
display users [ all ]
View
Any view
Default Level
1: Monitor level
Parameters
all: Displays information about all user interfaces that the device supports.
Description
Use the display users command to display information about the user interfaces being used.
Use the display users all command to display the information about all the user interfaces supported on the device.
Examples
# Display the user information of the user interfaces being used.
<Sysname> display users
The user application information of the user interface(s):
Idx UI Delay Type Userlevel
+ 1 VTY 0 00:00:00 TEL 3
3 VTY 2 00:35:00 TEL 3
Following are more details.
VTY 0 :
User name: admin
Location: 192.168.0.222
VTY 2 :
User name: admin
Location: 192.168.0.254
+ : Current operation user.
F : Current operation user work in async mode.
The above information shows that at present two users have logged in to the device. One is VTY 0 with the IP address of 192.168.0.222 used by the current user and the other is VTY 2 with the IP address of 192.168.0.254 used by another user.
Table 1-3 display users command output description
|
Field |
Description |
|
Idx |
Absolute number of the user interface |
|
UI |
Relative number of the user interface. The first column, VTY for example, represents user interface type, and the second column, 0 for example, represents the relative number of the user interface. |
|
Delay |
Interval since the last input, in the format of hh:mm:ss. |
|
Type |
User type, such as Telnet |
|
Userlevel |
User authority or level: 0 for visit, 1 for monitor, 2 for system, and 3 for manage. |
|
+ |
Current user |
|
Location |
Location of the user logging from the current user interface |
|
F |
The current user works in asynchronous mode |
display web users
Syntax
display web users
View
Any view
Parameter
None
Description
Use the display web users command to display information about web users.
Example
# Display information about the current web users.
<Sysname> display web users
UserID Name Language Level State LinkCount LoginTime LastTime
ab840000 admin Chinese Management Enable 0 20:55:52 20:55:59
ab060100 admin English Management Enable 0 20:57:53 20:57:54
Table 1-4 display web users command output description
|
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
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 corresponding ASCII code value in the range 0 to 127) or a string of 1 to 3 characters. But in fact, only the first character functions as the shortcut key. For example, if you enter an ASCII code value 113, the system will use its corresponding character q as the shortcut key; if you input the string q@c, the system will use the first letter q as the shortcut key.
default: Restores the default escape key combination Ctrl+C.
Description
Use the escape-key command to define a shortcut key for terminating tasks.
Use the undo escape-key command to disable the shortcut key for aborting tasks.
By default, you can use Ctrl+C to terminate a task.
After defining a new shortcut key using the escape-key command, the new shortcut key will function to terminate a task. You can use the display current-configuration command to display the shortcut key you have defined.
Note that if you set the character argument in a user interface of a device, when you use the user interface to log in to the device and then telnet to another device through the device you have logged in, the character argument can be used as a control character to terminate a task only, rather than input as a common character. For example, if you specify character as e in VTY 0 user interface of Device A, when you log in to the Device A using VTY 0 on PC (Hyper Terminal), you can input e as a common character on PC, and you can also use e to terminate the task running on Device A. If you telnet to Device B through Device A, however, you can only use e to terminate the task running on Device B, rather than input e as a common character. Therefore, you are recommended to specify character as a key combination.
Examples
# Define <a> as the escape key.
<Sysname> system-view
[Sysname] user-interface console 0
[Sysname-ui-console0] escape-key a
To verify the configuration, do the following:
# Use the ping command to check the reachability of the device with the IP address of 192.168.1.49 and use the -c argument to specify the number of the 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
# Enter <a>, if the task terminates immediately and the system returns to the current view, the configuration is correct.
--- 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>
free user-interface
Syntax
free user-interface { num1 | { console | vty } num2 }
View
User view
Default Level
3: Manage level
Parameters
num1: Absolute number of a user interface. The value ranges from 0 to 5.
num2: Relative number of a user interface, in the following rules:
l For the console port, the value is 0.
l For VTY user interfaces, the value ranges from 0 to 4.
Description
Use the free user-interface command to disconnect with the specified user interface.
Note that you cannot use this command to terminate your own connection.
Examples
# Terminate the connection with user interface VTY 1.
<Sysname> display users
The user application information of the user interface(s):
Idx UI Delay Type Userlevel
+ 1 VTY 0 00:00:00 TEL 3
3 VTY 2 00:35:00 TEL 3
Following are more details.
VTY 0 :
User name: admin
Location: 192.168.0.222
VTY 2 :
User name: admin
Location: 192.168.0.254
+ : Current operation user.
F : Current operation user work in async mode.
// Using the display users command, you can see which users are using the device.
<Sysname> free user-interface vty 1
Are you sure to free user-interface vty1? [Y/N]:y
<Sysname>
// To make configurations without interruption from the user using VTY 1, you can release the connection established on VTY 1.
free web-users
Syntax
free web-users { all | user-id user-id | user-name user-name }
View
User view
Parameter
all: Specifies all Web users.
user-id: Web user ID, which is a hexadecimal number of 8 bits.
user-name: User name of the Web user, which can contain 1 to 80 characters.
Description
Use the free web-users command to disconnect a specified Web user or all Web users by force.
Related commands: display web users.
Example
# Force all Web users offline.
<Sysname> free web-users all
history-command max-size
Syntax
history-command max-size size-value
undo history-command max-size
View
User interface view
Default Level
2: System level
Parameters
size-value: History buffer size in the range 0 to 256. It defaults to 10, that is, up to ten history commands can be stored.
Description
Use the history-command max-size command to set the size of history command buffer of the current user interface.
Use the undo history-command max-size command to restore the default.
By default, the history buffer can save up to 10 commands.
The history buffer saves validated history commands individually per user interface and buffers for different user interfaces do not affect each other. You can use the display history-command command to display commands saved in the history buffer.
After you terminate the current session, the system automatically removes the commands saved in the corresponding history buffer.
Examples
# Set the size of the history command buffer to 20.
<Sysname> system-view
[Sysname] user-interface console 0
[Sysname-ui-console0] history-command max-size 20
idle-timeout
Syntax
idle-timeout minutes [ seconds ]
undo idle-timeout
View
User interface view
Default Level
2: System level
Parameters
minutes: Specifies timeout time in minutes, in the range 0 to 35791, defaulting to 10 minutes.
seconds: Specifies timeout time in seconds, in the range 0 to 59, defaulting to 0 seconds.
Description
Use the idle-timeout command to set the idle-timeout timer. When it expires, the user connection is terminated.
Use the undo idle-timeout command to restore the default.
The default idle-timeout is 10 minutes.
l The system automatically terminates user’s connection if there is no information interaction between the device and the user in timeout time.
l Setting idle-timeout to zero disables the timer and the connection is maintained whether it is idle or not.
Examples
# Set the idle-timeout timer to 1 minute and 30 seconds.
<Sysname> system-view
[Sysname] user-interface console 0
[Sysname-ui-console0] idle-timeout 1 30
lock
Syntax
lock
View
User view
Default Level
3: Manage level
Parameters
None
Description
Use the lock command to set a password to prevent unauthorized users from operating under the active user interface.
After entering the lock command, you are prompted to input a password (up to 16 characters) and then confirm it by inputting the password again. The password is successfully set only when you input the exact password during the confirmation. After setting the password, you will be required to input the password next time you enter the system.
By default, this function is disabled.
Examples
# Lock the active user interface.
<Sysname> lock
Please input password<1 to 16> to lock current user terminal interface:
Password:
Again:
locked !
Password:
<Sysname>
parity
Syntax
parity { even | mark | none | odd | space }
undo parity
View
User interface view
Default Level
2: System level
Parameters
even: Even parity check.
mark: Mark parity check.
none: No parity check.
odd: Odd parity check.
space: Space parity check.
Description
Use the parity command to set the parity check.
Use the undo parity command to restore the default.
By default, no parity check is performed.
l The command is only applicable to console ports.
l The data bits setting on the terminal and the device user interface must be the same for communication.
Examples
# Perform odd parity check on the console interface.
<Sysname> system-view
[Sysname] user-interface console 0
[Sysname-ui-console0] parity odd
protocol inbound
Syntax
protocol inbound { all | ssh | telnet }
View
VTY interface view
Default Level
3: Manage level
Parameters
all: Supports all the protocols, including Telnet and SSH.
ssh: Supports SSH only.
telnet: Supports Telnet only.
Description
Use the protocol inbound command to enable the current user interface to support one or all protocols.
By default, all the protocols are supported.
The configuration takes effect next time you log in.
l By default, the authentication mode of the Telnet protocol is password.
l Before configuring a user interface to support SSH, set the authentication mode to scheme for the user interface; otherwise, the protocol inbound ssh command fails. For more information, see authentication-mode.
Examples
# Enable the VTYs 0 through 4 to support Telnet only.
<Sysname> system-view
[Sysname] user-interface vty 0 4
[Sysname-ui-vty0-4] authentication-mode scheme
[Sysname-ui-vty0-4] protocol inbound Telnet
screen-length
Syntax
screen-length screen-length
undo screen-length
View
User interface view
Default Level
2: System level
Parameters
screen-length: Number of lines displayed on the next screen, in the range 0 to 512, with zero meaning to display all information at one time, that is, to disable multiple-screen output.
Description
Use the screen-length command to set the number of lines displayed on the next screen.
Use the undo screen-length command to restore the default, or 24 lines.
Multiple-screen output is supported on the device. If you press the Space key when information display pauses, the system continues to display information of the next screen page. This command sets the number of lines displayed on the next screen, the displayed number of lines on the terminal, however, is decided by the specifications of the terminal. For example, you set the value of screen-length to 40, but the terminal can only display 24 lines. In this case, if you press the Space key when the device outputs 1 to 40 lines of information to the terminal, the current screen displays only the information from line 18 to 40. To view the first 17 lines of information, you need to press Page Up or Page Down.
The command sets the number of lines displayed on the next screen, and you can use the screen-length disable command to disable multiple-screen output of the current user interface. For more information about the screen-length disable command, see CLI in the Fundamentals Command Reference.
Examples
# Set the number of lines displayed on the next screen of console user interface to 30.
<Sysname> system-view
[Sysname] user-interface console 0
[Sysname-ui-console0] screen-length 30
send
Syntax
send { all | num1 | { console | 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 ranges from 0 to 5.
num2: Relative number of a user interface, in the following rules:
l For the console port, the value is 0.
l For VTY user interfaces, the value ranges from 0 to 4.
Description
Use the send command to send messages to the specified user interface(s).
Press Ctrl+Z to end message input and press Ctrl+C to remove this operation when inputting messages.
Examples
# Send the message hello abc to the console user interface.
<Sysname> send console 0
Enter message, end with CTRL+Z or Enter; abort with CTRL+C:
hello abc^Z
Send message? [Y/N]:y
<Sysname>
***
***
***Message from con0 to con0
***
hello abc
<Sysname>
# A user logging in through VTY 0 wants to restart the device. To inform the other users to take corresponding actions (for example, save the current configuration), the system sends the message “Note please, I will reboot the system!”.
l Configuration on VTY 0:
<Sysname> display users
The user application information of the user interface(s):
Idx UI Delay Type Userlevel
+ 1 VTY 0 00:00:00 TEL 3
3 VTY 2 00:35:00 TEL 3
Following are more details.
VTY 0 :
User name: admin
Location: 192.168.0.222
VTY 2 :
User name: admin
Location: 192.168.0.254
+ : Current operation user.
F : Current operation user work in async mode.
// Using the display users command, you can see that which users are using the device.
<Sysname> send vty 1
Enter message, end with CTRL+Z or Enter; abort with CTRL+C:
Note please, I will reboot the system in 3 minutes!^Z
Send message? [Y/N]:y
// Use the command to send a message to user interface VTY 1, telling the user using the interface about the reboot.
l If a user logs in from VTY 1, the following message is received on VTY 1 (VTY 1 received a message from VTY 0 when the interface ethernet command is being input in this example.).
[Sysname] interface ethernet
***
***
***Message from vty0 to vty1
***
Note please, I will reboot the system in 3 minutes!
set authentication password
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 set to simple, the password argument must be in plain text. If it is set to cipher, password can be either in cipher text or in plain text depending on what has been input. A plain text password can be a string of no more than 16 consecutive characters, 1234567 for example. A cipher text password, or the encrypted version of the plain text password, comprises 24 characters, such as _(TT8F]Y\5SQ=^Q`MAF4<1!!.
Description
Use the set authentication password command to set a local authentication password.
Use the undo set authentication password command to remove the local authentication password.
No local authentication password is set by default.
l When setting a password, you should specify simple to save it in plain text in the configuration file, or specify cipher to save it in cipher text.
l Whether the password format is plain text or cipher text, you must type in plain text password at authentication.
l Plain text password easily gets cracked. Therefore, you are recommended to use cipher text password.
Related commands: authentication-mode.
Examples
# Set the local authentication password for the user interface console 0 to hello.
<Sysname> system-view
[Sysname] user-interface console 0
[Sysname-ui-console0] authentication-mode password
[Sysname-ui-console0] set authentication password cipher hello
After setting the password, you will be required to input the password next time you enter the system.
shell
Syntax
shell
undo shell
View
User interface view
Default Level
3: Manage level
Parameters
None
Description
Use the shell command to enable terminal services on the user interface.
Use the undo shell command to disable this function.
By default, terminal services are enabled on all user interfaces.
There are a few restrictions on using the undo shell command:
l This command is not supported on the console port.
l This command cannot be used on the user interface from which you log in.
Examples
# 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]
# The following information is displayed when a Telnet terminal logs in:
The connection was closed by the remote host!
speed (user interface view)
Syntax
speed speed-value
undo speed
View
User interface view
Default Level
2: System level
Parameters
speed-value: Transmission rate in bps. The transmission rates available with asynchronous serial interfaces include:
l 300 bps
l 600 bps
l 1200 bps
l 2400 bps
l 4800 bps
l 9600 bps
l 19200 bps
l 38400 bps
l 57600 bps
l 115200 bps
Note that the transmission rate varies with devices and configuration environment.
Description
Use the speed command to set the transmission rate on the user interface.
Use the undo speed command to restore the default transmission rate.
By default, the transmission rate is 9600 bps.
l The command is only applicable to console ports.
l The data bits setting on the terminal and the device user interface must be the same for communication.
Examples
# Set the transmission rate on the user interface console 0 to 19200 bps.
<Sysname> system-view
[Sysname] user-interface console 0
[Sysname-ui-console0] speed 19200
telnet
Syntax
telnet remote-host [ service-port ] [ 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 system, a case insensitive string of 1 to 20 characters.
service-port: TCP port number for the remote system to provide Telnet services. It ranges from 0 to 65535 and defaults to 23.
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 sent is the IPv4 address of the specified interface. interface-type interface-number represents the interface type and number.
ip ip-address: Specifies the source IPv4 address of Telnet packets.
Description
Use the telnet command to telnet a remote host to remotely manage the host. To stop the current Telnet login, press Ctrl+K or use the quit command.
Note that, The source IPv4 address or source interface specified by this command is applicable to the current Telnet connection only.
Examples
# Telnet the remote host with the IP address 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
telnet ipv6
Syntax
telnet ipv6 remote-host [ -i interface-type interface-number ] [ port-number ]
View
User view
Default Level
0: Visit level
Parameters
remote-host: IP address or host name of a remote system, a string of 1 to 46 characters, case insensitive.
-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 system to provide Telnet services. It ranges from 0 to 65535.
Description
Use the telnet ipv6 command to telnet a remote host to remotely manage the host in an IPv6 network. To stop the current Telnet login, press Ctrl+K or use the quit command.
Examples
# Telnet the remote host with the IPv6 address 3001::1.
<Sysname> telnet ipv6 3001::1
Trying 3001::1 ...
Press CTRL+K to abort
Connected to 3001::1 ...
****************************************************************************
* Copyright (c) 2004-2010 Hangzhou H3C Tech. Co., Ltd. All rights reserved.*
* Without the owner's prior written consent, *
* no decompiling or reverse-engineering shall be allowed. *
****************************************************************************
<Sysname>
telnet server enable
Syntax
telnet server enable
undo telnet server enable
View
System view
Default Level
3: Manage level
Parameters
None
Description
Use the telnet server enable command to enable the telnet service.
Use the undo telnet server enable command disable the telnet service.
By default, the telnet service is disabled.
Examples
# Enable the telnet service.
<Sysname> system-view
[Sysname] telnet server enable
% Start Telnet server
# Disable the telnet service.
[Sysname] undo telnet server enable
% Close Telnet server
terminal type
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.
Description
Use the terminal type command to configure the type of terminal display under the current user interface.
Use the undo terminal type command to restore the default.
By default, the terminal display type is ANSI.
Note that the system supports two types of terminal display: ANSI and VT100. If the terminal display of the device and the client (for example, hyper terminal or Telnet terminal) is inconsistent or is set to ANSI, but the total number of the characters of the currently using command line exceeds 80, anomalies such as cursor corruption or abnormal display of the terminal display may occur on the client. Therefore, you are recommended to set the display type of both the device and the client to VT100.
Examples
# Set the terminal display type to VT100.
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] terminal type vt100
user-interface
Syntax
user-interface { first-num1 [ last-num1 ] | { console | vty } first-num2 [ last-num2 ] }
View
System view
Default Level
2: System level
Parameters
first-num1: Absolute number of the first user interface, in the range 0 to 5.
last-num1: Absolute number of the last user interface, in the range (first-num1+1) to 5.
first-num2: Relative number of the first user interface, in the following rules:
l For the console port, the value is 0.
l For VTY user interfaces, the value ranges from 0 to 4.
last-num2: Relative number of the last user interface, in the following rules:
l For VTY user interfaces, the value ranges from ( first-num2+1 ) to 4.
Description
Use the user-interface command to enter a single or multiple user interface views.
l In a single user interface view, the configuration takes effect in the user view only.
l In multiple user interface views, the configuration takes effect in these user views.
Examples
# Enter console user interface view.
<Sysname> system-view
[Sysname] user-interface console 0
[Sysname-ui-console0]
# Enter the user interface view of VTY 0 to 4.
<Sysname> system-view
[Sysname] user-interface vty 0 4
[Sysname-ui-vty0-4]
user privilege level
Syntax
user privilege level level
undo user privilege level
View
User interface view
Default Level
3: Manage level
Parameters
level: Command level in the range 0 to 3.
Command level is divided into four levels of visit, monitor, system, and manage, corresponding to the number 0, 1, 2 and 3 respectively. The administrator can change the command level of a user when necessary.
Description
Use the user privilege level command to configure the command level that the login users on the current user interface can access.
Use the undo user privilege level command to restore the default.
By default, the default command level is 3 for the console user interface and 0 for other user interfaces.
Examples
# Set the privilege level of the user logging in from VTY 0 to 0.
<Sysname> system-view
[Sysname] user-interface vty 0
[Sysname-ui-vty0] user privilege level 0
After you telnet the device from VTY 0, you can see that the terminal only displays commands of privilege 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
rsh Establish one RSH connection
super Set the current user priority level
telnet Establish one TELNET connection
tracert Trace route function
