S2720, S5700, and S6720 Series Ethernet Switches

Configuration Guide - Basic Configuration 1 CLI Overview

1 CLI Overview

About This Chapter

1.1 Entering Command Views

1.2 Editing Command Lines
1.3 Using Command Line Online Help
1.4 Enabling Forward Commands to Be Run in the Upper-level View
1.5 Using the undo Command Line
1.6 Executing Commands in a Batch
1.7 Executing User View Commands in the System View
1.8 Using Command Line Shortcut Keys
1.9 Verifying the Configuration
1.10 Controlling the Display Mode of Commands
1.11 Filtering Output Information Based on the Regular Expression
1.12 Setting Command Levels
1.13 Displaying History Commands

1.1 Entering Command Views

The device has many functions; therefore various configuration commands and
query commands are provided to facilitate device management and maintenance.
Huawei switch registers commands to different command views based on the
functions of the commands so that users can easily use them. To configure a
function, enter the corresponding command view and then run corresponding
commands.
The device provides various command views. Those listed in the following figure
are common command views. For the methods of entering the command views

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 1

S2720, S5700, and S6720 Series Ethernet Switches
Configuration Guide - Basic Configuration 1 CLI Overview

except the following views, see the S2720, S5700, and S6720 V200R013C00
Command Reference.

Common Command Views

Name How To Enter Function

User view When a user logs in to In the user view, you can
the device, the user view the running status
enters the user view and and statistics of the
the following prompt is device.
displayed:
<HUAWEI>

System view Run the system-view In the system view, you

command and press can set the system
Enter in the user view. parameters of the device,
The system view is and enter other function
displayed. views from this view.
<HUAWEI> system-view
Enter system view, return user
view with Ctrl+Z.
[HUAWEI]

Interface view Run the interface In the interface view, you

command and specify an can configure interface
interface type and parameters including
number to enter the physical attributes, link
interface view. layer protocols, and IP
[HUAWEI] interface addresses.
gigabitethernet X/Y/Z
[HUAWEI-GigabitEthernetX/Y/Z]

X/Y/Z indicates the

number of an interface
that needs to be
specified. It is in the
format of stack ID/card
number/interface
sequence number.
The interface
GigabitEthernet is used
as an example.

The command line prompt HUAWEI is the default host name (sysname). The
prompt indicates the current view. For example, <> indicates the user view and []
indicates all other views except the user view.
You can enter ! or # followed by a character string in any view. All entered content
(including ! and #) is displayed as comments. That is, the corresponding
configuration is not generated.

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 2

S2720, S5700, and S6720 Series Ethernet Switches
Configuration Guide - Basic Configuration 1 CLI Overview

● Some commands can be executed in multiple views, but they have different functions
after being executed in different views. For example, you can run the lldp enable
command in the system view to enable LLDP globally and in the interface view to
enable LLDP on an interface.
● In the system view, you can run the diagnose command to enter the diagnostic view.
Diagnostic commands are used for device fault diagnosis. If you run some commands in
the diagnostic view, the device may fail to run properly or services may be interrupted.
Contact technical support personnel and use these diagnostic commands with caution.
● You can enter ! or # followed by a character string in any view. All the entered content
(including ! and #) is displayed as comments and can be properly. That is, no error
message is displayed and no the corresponding configuration is not generated.

Exiting Command Views

You can run the quit command to return from the current view to an upper-level
view.
For example, you can run the quit command to return from the AAA view to the
system view. You can then run the quit command again to return from the system
view to the user view.
[HUAWEI-aaa] quit
[HUAWEI] quit
<HUAWEI>

To return from the AAA view directly to the user view, press Ctrl+Z or run the
return command.
# Press Ctrl+Z to return directly to the user view.
[HUAWEI-aaa] // Enter Ctrl+Z
<HUAWEI>

# Run the return command to return directly to the user view.

[HUAWEI-aaa] return
<HUAWEI>

Intelligent Rollback
Intelligent rollback enables the system to automatically return to the previous
view if a command fails to be executed in the current view. The system performs
view return attempts until the applicable view of the command is displayed. The
system can return to the system view at the maximum extent.

Intelligent rollback cannot be performed in the port group view and VLAN-Range view.
If command matching fails because an ambiguous command is entered in the current view,
no intelligent rollback can be performed.
If the intelligent rollback function is enabled, commands may be executed in unexpected
views, and services may be interrupted. Before configuring a command, check whether the
command to be configured exists in the view. If the command does not exist, run the
command in the correct view.

The following provides two application examples for intelligent rollback. The
system enters the applicable view of a command after performing one view return
attempt in the first example, and performs multiple attempts in the second
example.

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 3

S2720, S5700, and S6720 Series Ethernet Switches
Configuration Guide - Basic Configuration 1 CLI Overview

1. After entering an OSPF area view, the system allows a user to directly enter
another OSPF area view, without the need to manually return to the OSPF
view.
<HUAWEI> system-view
[HUAWEI] ospf 100
[HUAWEI-ospf-100] area 1
[HUAWEI-ospf-100-area-0.0.0.1] area 2
[HUAWEI-ospf-100-area-0.0.0.2]
2. After entering an OSPF area view, the system allows a user to directly enter
an interface view, without the need to manually return to the system view.
<HUAWEI> system-view
[HUAWEI] ospf 100
[HUAWEI-ospf-100] area 1
[HUAWEI-ospf-100-area-0.0.0.1] interface gigabitEthernet 0/0/3
[HUAWEI-GigabitEthernet0/0/3]

1.2 Editing Command Lines

Editing Feature
You can edit commands in a CLI that supports multi-line edition. Each command
can contain a maximum of 510 characters. The keywords in the commands are
case insensitive. Whether a command parameter is case sensitive or not depends
on what the parameter is.
Table 1-1 lists keys that are frequently used for command editing.

Table 1-1 Keys for command editing

Key Function

Common key Inserts a character at the current location of the cursor

if the editing buffer is not full, and the cursor moves to
the right. Otherwise, an alarm is generated.

Backspace Deletes the character on the left of the cursor and the
cursor moves to the left. When the cursor reaches the
head of the command, an alarm is generated.

Left cursor key ← or Moves the cursor to the left by the space of a
Ctrl+B character. When the cursor reaches the head of the
command, an alarm is generated.

Right cursor key → or Moves the cursor to the right by the space of a
Ctrl+F character. When the cursor reaches the end of the
command, an alarm is generated.

Operating Techniques
Incomplete Keyword
You can enter incomplete keywords on the device. In the current view, you do not
need to enter complete keywords if the entered characters can match a unique
keyword. This function improves operating efficiency.

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 4

S2720, S5700, and S6720 Series Ethernet Switches
Configuration Guide - Basic Configuration 1 CLI Overview

For example, to execute the display current-configuration command, you can

enter d cu, di cu, or dis cu. However, you cannot enter d c or dis c because they
do not match unique keywords.

NOTICE

The maximum length of a command (including the incomplete command) to be

entered is 510 characters. If a command in incomplete for m is configured, the
system saves it to the configuration file in its complete form, which may exceed
the 510-character limit. In this case, the command in incomplete form cannot be
restored after the system restarts. Therefore, when you configure a command in
incomplete form, pay attention to the length of the command.

Tab
Enter an incomplete keyword and press Tab to complete the keyword.
● When a unique keyword matches the input, the system replaces the
incomplete input with the unique keyword and displays it in a new line
followed by a space. For example:
a. Enter an incomplete keyword.
[HUAWEI] info-

b. Press Tab.
The system replaces the entered keyword and displays it in a new line
with the complete keyword followed by a space.
[HUAWEI] info-center

● When the input has multiple matches, press Tab repeatedly to display the
keywords beginning with the incomplete input in a circle until the desired
keyword is displayed. In this case, the cursor closely follows the end of the
keyword. For example:
a. Enter an incomplete keyword.
[HUAWEI] info-center log

b. Press Tab.
The system displays the prefixes of all the matched keywords. In this
example, the prefix is log.
[HUAWEI] info-center loghost
Press Tab to switch from one matched keyword to another. In this case,
the cursor closely follows the end of a word.
[HUAWEI] info-center logbuffer

Stop pressing Tab when the desired keyword is displayed.

● When an incorrect keyword is entered, press Tab and it is displayed in a new
line without being changed. For example:
a. Enter an incorrect keyword.
[HUAWEI] info-center loglog

b. Press Tab.
[HUAWEI] info-center loglog

The system displays information in a new line, but the keyword loglog
remains unchanged and there is no space between the cursor and the
keyword. This indicates that this keyword does not exist.

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 5

S2720, S5700, and S6720 Series Ethernet Switches
Configuration Guide - Basic Configuration 1 CLI Overview

1.3 Using Command Line Online Help

When entering command lines, you can enter a question mark (?) at any time to
obtain online help. You can choose to obtain full help or partial help.

Full Help
When entering a command, you can use the full help function to obtain keywords
and parameters for the command. Use any of the following methods to obtain full
help from a command line.
● Enter a question mark (?) in any command view to obtain all the commands
and their simple descriptions. For example:
<HUAWEI> ?
User view commands:
backup Backup electronic elabel
cd Change current directory
check Check information
clear Clear information
clock Specify the system clock
compare Compare function
...

● Enter some keywords of a command and a question mark (?) separated by a

space. All keywords associated with this command, as well as simple
descriptions, are displayed. For example:
<HUAWEI> system-view
[HUAWEI] user-interface vty 0 4
[HUAWEI-ui-vty0-4] authentication-mode ?
aaa AAA authentication, and this authentication mode is recommended
none Login without checking
password Authentication through the password of a user terminal interface

[HUAWEI-ui-vty0-4] authentication-mode aaa ?

<cr>

[HUAWEI-ui-vty0-4] authentication-mode aaa

– "aaa" and "password" are keywords. "AAA authentication" and

"Authentication through the password of a user terminal interface"
describe the keywords respectively.
– <cr> indicates that there is no keyword or parameter in this position. You
can press Enter to run this command.
● Enter some keywords of a command and a question mark (?) separated by a
space. All parameters associated with this keyword, as well as simple
descriptions, are listed. For example:
<HUAWEI> system-view
[HUAWEI] ftp timeout ?
INTEGER<1-35791> The value of FTP timeout, the default value is 30 minutes
[HUAWEI] ftp timeout 35 ?
<cr>

[HUAWEI] ftp timeout 35

"INTEGER<1-35791>" describes the value range of the parameter. "The value

of FTP timeout, the default value is 30 minutes" briefly describes the function
of this parameter.

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 6

S2720, S5700, and S6720 Series Ethernet Switches
Configuration Guide - Basic Configuration 1 CLI Overview

Partial Help
If you enter only the first or first several characters of a command keyword, partial
help provides keywords that begin with this character or character string. Use any
of the following methods to obtain partial help from a command line.
● Enter a character string followed directly by a question mark (?) to display all
keywords that begin with this character string. For example:
<HUAWEI> d?
debugging delete
dir display
<HUAWEI> d
● Enter a command and a string followed directly by a question mark (?) to
display all the keywords that begin with this string. For example:
<HUAWEI> display b?
bpdu bridge
buffer
● Enter the first several letters of a keyword in a command and press Tab to
display a complete keyword. The first several letters, however, must uniquely
identify the keyword. If they do not identify a specific keyword, press Tab
continuously to display different keywords and you can select one as required.

The command output obtained through the online help function is used for reference only.

1.4 Enabling Forward Commands to Be Run in the

Upper-level View
Context
When you run a forward command not registered in the current view, the system
automatically switches to the upper-level view to search for the command. If the
command is found in that view, the system runs the command. If the command is
not found in that view, the system continues the search in the next upper-level
view until the system view.

Procedure
Step 1 In the user view, run terminal command forward matched upper-view.
Forward commands are enabled to be run in the upper-level view.

The terminal command forward matched upper-view command is valid for current login
users who run this command.

----End

1.5 Using the undo Command Line

If a command line begins with the keyword undo, it is an undo command line.
The undo command lines restore default settings of parameters, disable functions,

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 7

S2720, S5700, and S6720 Series Ethernet Switches
Configuration Guide - Basic Configuration 1 CLI Overview

or delete configurations. Almost each configuration command line has a

corresponding undo command.
Some examples of using the undo command are listed as follows:
● The undo command restores the default setting.
The sysname command sets a device host name. For example:
<HUAWEI> system-view
[HUAWEI] sysname Server
[Server] undo sysname
[HUAWEI]

● The undo command disables a specified function.

The ftp server enable command enables the FTP server function on the
device. For example:
<HUAWEI> system-view
[HUAWEI] ftp server enable
Warning: FTP is not a secure protocol, and it is recommended to use SFTP.
Info: Succeeded in starting the FTP server.
[HUAWEI] undo ftp server
Info: Succeeded in closing the FTP server.

● The undo command deletes a specified configuration.

The header command configures the header information displayed on
terminals when users log in. For example:
<HUAWEI> system-view
[HUAWEI] header login information "Hello,Welcome to Huawei!"

Log out of the terminal and re-log in. A message "Hello, Welcome to
Huawei!" is displayed before authentication. Run the undo header login
command.
Hello,Welcome to Huawei!

Login authentication

Password:
Info: The max number of VTY users is 20, and the number
of current VTY users on line is 5.
The current login time is 2012-06-09 04:46:00.
<HUAWEI> system-view
[HUAWEI] undo header login

Log out of the terminal and re-log in. No message is displayed before
authentication.
Login authentication

Password:
Info: The max number of VTY users is 20, and the number
of current VTY users on line is 5.
The current login time is 2012-06-09 04:52:10.
<HUAWEI>

The command output provided here is used for reference only. The actual output
information may differ from the preceding information.

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 8

S2720, S5700, and S6720 Series Ethernet Switches
Configuration Guide - Basic Configuration 1 CLI Overview

1.6 Executing Commands in a Batch

Procedure
● Automatic batch command execution
Assistant tasks help implement automatic batch command execution. You can
create a maximum of five assistant tasks on the device and each assistant
task is bound with a batch file. After an execution time is configured, the
device automatically executes commands in the batch file one by one.
Automatic batch command execution is frequently used for periodic system
upgrade or configuration.
A batch file is a collection of executable commands and the file is in the
format of *.bat. When the batch file is processed, commands in the file are
executed one by one. Before configuring automatic batch command
execution, edit the batch file on the PC and upload the batch file to the
device. If the file name extension is not .bat, change it to .bat before you
upload the batch file to the device. Alternatively, upload the batch file to the
device and then run the rename command to change the file name
extension.
a. Run the system-view command to enter the system view.
b. Run the assistant task task-name command to create an assistant task.
You can create a maximum of five assistant tasks.
c. Run the if-match timer cron seconds minutes hours days-of-month
months days-of-week [ years ] command to specify the time for
performing assistant tasks.
d. Run the perform priority batch-file filename command to bind the batch
file with the assistant task.
e. Run the display assistant task history [ task-name ] command to check
the operation records of assistant tasks.
----End

1.7 Executing User View Commands in the System

View
Context
Some commands need to be executed in the user view. To execute these
commands, you need to exit from the system view to the user view and then
execute the commands. In order to ease command execution, you can use the run
command to execute user view commands directly in the system view.

Procedure
Step 1 Run system-view
The system view is displayed.

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 9

S2720, S5700, and S6720 Series Ethernet Switches
Configuration Guide - Basic Configuration 1 CLI Overview

Step 2 Run run command-line

The user view command is executed.
The parameter command-line is a user view command. You must enter the
complete command manually because automatic command line completion is not
supported.

----End

1.8 Using Command Line Shortcut Keys

You can use shortcut keys provided by the device to quickly enter commands.
System-defined shortcut keys cannot be defined by users and have fixed functions.
Table 1-2 lists the system-defined shortcut keys.

The terminal in use may affect the functions of the shortcut keys because the shortcut keys
entered by the user are captured by the terminal program. For example, if the shortcut keys
defined by the terminal conflict with those defined in the system, the commands
corresponding to the shortcut keys are not executed.

System-defined Shortcut Keys

Table 1-2 System-defined shortcut keys

Key Function

Ctrl+A Moves the cursor to the beginning of the

current line.

Ctrl+B Moves the cursor back one character.

Ctrl+C Stops performing current functions.

Ctrl+D Deletes the character where the cursor is

located at.

Ctrl+E Moves the cursor to the end of the

current line.

Ctrl+F Moves the cursor forward one character.

Ctrl+H Deletes the character on the left side of

the cursor.

Ctrl+J Line feed.

Ctrl+K Stops outgoing connections in the call

establishment stage.

Ctrl+M Line feed.

Ctrl+N Displays the next command in the history

command buffer.

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 10

S2720, S5700, and S6720 Series Ethernet Switches
Configuration Guide - Basic Configuration 1 CLI Overview

Key Function

Ctrl+P Displays the previous command in the

history command buffer.

Ctrl+R Redisplays information about the current

line.

Ctrl+T Stops outgoing connections.

Ctrl+V Pastes the text of the clipboard.

Ctrl+W Deletes a character string on the left side

of the cursor.

Ctrl+X Deletes all the characters on the left side

of the cursor.

Ctrl+Y Deletes all the characters on the right

side of the cursor and the character
where the cursor is located at.

Ctrl+Z Returns to the user view.

Ctrl+] Stops incoming connections or redirects

the connections.

Esc+B Moves the cursor back one word.

Esc+D Deletes one word on the right side of the

cursor.

Esc+F Moves the cursor forward one word.

Esc+N Moves the cursor downward a line.

Esc+P Moves the cursor upward a line.

1.9 Verifying the Configuration

After the configurations are complete, you can run the display command to check
the configuration and running information on the device.
For example, after all configurations of the FTP service are complete, you can run
the display ftp-server command to check parameters of the FTP server. For
details on the usage and functions of the display command, see Verifying the
Configuration in each feature of the Configuration Guide.
You can also check the current running configurations and configurations in the
current view.
● Check the current running configurations:
display current-configuration
This command does not display parameters that use default settings.
● Check configurations in the current view:

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 11

S2720, S5700, and S6720 Series Ethernet Switches
Configuration Guide - Basic Configuration 1 CLI Overview

display this
This command does not display parameters that use default settings.
To view the default configurations that have not been modified in the current
view, run the display this include-default command.

1.10 Controlling the Display Mode of Commands

Info and warning messages and command execution results are displayed after
you run commands on the device. You can control on the display mode of the
command outputs.
● When the display output is more than one page, you can use <PageUp> and
<PageDown> to display information on the previous page and the next page.
● When the information cannot be completely displayed on one screen, the
system will pause and you can view the information. You can use the function
keys listed in Table 1-3 to control the display mode of command lines.

Table 1-3 Display mode of commands

Key Function

Ctrl+C or Ctrl+Z Stops displaying information and

running commands.
NOTE
You can also press any key (the number key,
letter key, and so on) except space and
Enter.

Space Continues to display the next screen of

information.

Enter Continues to display the next line of

information.

The screen-length screen-length temporary command sets the lines to be

displayed temporarily on the terminal screen. If screen-length is 0, the split
screen function is disabled. Therefore, the system will not pause when the
information cannot be completely displayed on one screen.
● You can not only control the display mode of output information but also
control the mode in which a command is displayed on the screen.
The system supports two command output modes: character mode and line
mode, which can be configured using the terminal echo-mode { character |
line } command. By default, the character mode is used.
– character: The command output mode is the character mode. When you
enter a character in the command line, the system displays this character.
– line: The command output mode is the line mode. When you enter a
character in the command line, the system displays this character only
after you press Enter, Tab or ?.
When you operate a device using the NMS, you can change the command
output mode to line to improve operation efficiency. Common users have a

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 12

S2720, S5700, and S6720 Series Ethernet Switches
Configuration Guide - Basic Configuration 1 CLI Overview

habit of using the character mode. Therefore, use the character mode for
common users to improve operation efficiency.

1.11 Filtering Output Information Based on the

Regular Expression
Regular Expressions
When you run the display command to check the device configuration and
running status information, you can filter out unnecessary information based on
the regular expression.
A regular expression is a mode matching tool. You can create a matching mode
based on specified rules and then match target objects based on the matching
mode. A regular expression consists of 1 to 256 common characters and special
characters.
● Common characters
Common characters are used to match themselves in a string, including all
upper-case and lower-case letters, digits, punctuations, underline, and special
symbols. For example, a matches the letter "a" in "abc", 20 matches the digit
"20" in "20.1.1.1", and @ matches the symbol "@" in "[email protected]".
● Special characters
Special characters are a set of symbols with special meanings which are
provided to flexibly create matching modes. The special characters are also
called metacharacters. Table 1-4 describes special characters and their syntax.

Table 1-4 Description of special characters

Special Function Example
Charact
ers

\ Defines an escape character, \* matches "*".

which is used to mark the next
character (common or special)
as the common character.

^ Matches the starting position ^10 matches "10.10.10.1"

of the string. instead of "20.10.10.1".

$ Matches the ending position of 1$ matches "10.10.10.1"

the string. instead of "10.10.10.2".

* Matches the preceding 10* matches "1", "10", "100",

element zero or more times. "1000", and so on.
(10)* matches "null", "10",
"1010", "101010", and so on.

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 13

S2720, S5700, and S6720 Series Ethernet Switches
Configuration Guide - Basic Configuration 1 CLI Overview

Special Function Example

Charact
ers

+ Matches the preceding 10+ matches "10", "100",

element one or more times. "1000", and so on.
(10)+ matches "10", "1010",
"101010", and so on.

? Matches the preceding 10? matches "1" or "10".

element zero or one time. (10)? matches "null" or "10".
NOTE
Huawei data communication
devices do not support regular
expressions with ?. When regular
expressions with ? are entered on
Huawei data communication
devices, helpful information is
provided.

. Matches any single character. 0.0 matches "0x0", "020", and

so on.
.oo. matches "book", "look",
"tool", and so on.

() Defines a subexpression, which 100(200)+ matches "100200",

can be null. Both the "100200200", and so on.
expression and the
subexpression should be
matched.

x|y Matches x or y. 100|200 matches "100" or

"200".
1(2|3)4 matches "124" or
"134", instead of "1234", "14",
"1224", and "1334".

[xyz] Matches any single character [123] matches the character 2

in the regular expression. in "255".

[^xyz] Matches any character that is [^123] matches any character

not in the regular expression. except for "1", "2", and "3".

[a-z] Matches any character within [0-9] matches any character

the specified range. ranging from 0 to 9.

[^a-z] Matches any character beyond [^0-9] matches all non-

the specified range. numeric characters.

A simple regular expression does not contain any special character. For
example, you can create a simple regular expression "hello" to match the
character string "hello" only. In practice, multiple common and special
characters are used together to match a character string with special features.

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 14

S2720, S5700, and S6720 Series Ethernet Switches
Configuration Guide - Basic Configuration 1 CLI Overview

● Degeneration of special characters

Certain special characters, when placed at certain positions in a regular
expression, degenerate to common characters.
– The special characters following "\" match special characters themselves.
– The special characters "*", "+", and "?" are placed at the starting position
of the regular expression. For example, +45 matches "+45" and abc(*def)
matches "abc*def".
– The special character "^" is placed at any position except for the start of
the regular expression. For example, abc^ matches "abc^".
– The special character "$" is placed at any position except for the end of
the regular expression. For example, 12$2 matches "12$2".
– A right parenthesis ")" or right bracket "]" is not paired with a
corresponding left parenthesis "(" or bracket "[". For example, abc)
matches "abc)" and 0-9] matches "0-9]".

Unless otherwise specified, degeneration rules also apply when the preceding regular
expressions are subexpressions within parentheses.

Usage of Regular Expressions

NOTICE

The switch uses a regular expression to implement the pipe character filtering
function. A display command supports the pipe character only when there is
excessive output information.

There are two modes to filter output information based on the regular expression.
● Specifying a filtering mode in a command: enter the keyword begin, exclude,
or include, and a regular expression in the command line to filter command
outputs.
● Specifying a filtering mode on a split screen: enter a slash (/), minus (-), or
plus (+) symbol, and a regular expression to filter command outputs to be
displayed on a split screen. The slash (/), minus (-), and plus (+) symbols have
the same functions as the keywords begin, exclude, and include.
Specifying a Filtering Mode in a Command
Some commands can carry the parameter | count to display the number of
matching entries. The parameter | count can be used together with other
parameters.
Three filtering modes are provided for commands that support regular
expressions.
● | begin regular-expression: displays all the lines beginning with the line that
matches the regular expression.
Filter the character strings to be entered until the specified case-sensitive
character string is displayed. All the character strings following this specified
character string are displayed on the screen.

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 15

S2720, S5700, and S6720 Series Ethernet Switches
Configuration Guide - Basic Configuration 1 CLI Overview

● | exclude regular-expression: displays all the lines that do not match the
regular expression.
If the character strings to be entered do not contain the specified case-
sensitive character string, they are displayed on the screen. Otherwise, they
are filtered.
● | include regular-expression: displays all the lines that match the regular
expression.
If the character strings to be entered contain the specified case-sensitive
character string, they are displayed on the screen. Otherwise, they are filtered.

You can specify the filtering mode of output information for some display commands that
have large amount of output information.

After the command output is filtered, the displayed information is displayed with
its context. Context rules are as follows:
● before before-line-number: displays lines that match filtering rules and the
preceding before-line-number lines.
● after after-line-number: displays lines that match filtering rules and the
subsequent after-line-number lines.
● before before-line-number + after after-line-number or after after-line-
number + before before-line-number: displays lines that match filtering rules,
the preceding before-line-number lines, and the subsequent after-line-number
lines.
Values of before-line-number and after-line-number are a string of 1 to 999
characters.

The following examples describe how to specify a filtering mode in a command.

Example 1: Run the display interface brief command to display all the lines that
do not match Ethernet, NULL, or Tunnel.
<HUAWEI> display interface brief | exclude Ethernet|NULL|Tunnel
PHY: Physical
*down: administratively down
^down: standby
(l): loopback
(s): spoofing
(b): BFD down
(e): ETHOAM down
(dl): DLDP down
(d): Dampening Suppressed
InUti/OutUti: input utility/output utility
Interface PHY Protocol InUti OutUti inErrors outErrors
Eth-Trunk1 down down 0% 0% 0 0
Eth-Trunk17 down down 0% 0% 0 0
LoopBack1 up up(s) 0% 0% 0 0
Vlanif1 up down -- -- 0 0
MEth0/0/1 down down 0% 0% 0 0
Vlanif2 down down -- -- 0 0
Vlanif10 down down -- -- 0 0
Vlanif12 down down -- -- 0 0
Vlanif13 down down -- -- 0 0
Vlanif20 up up -- -- 0 0
Vlanif22 down down -- -- 0 0
Vlanif222 down down -- -- 0 0
Vlanif4094 down down -- -- 0 0

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 16

S2720, S5700, and S6720 Series Ethernet Switches
Configuration Guide - Basic Configuration 1 CLI Overview

Example 2: Run the display current-configuration command to display all the

lines that match the regular expression vlan.
<HUAWEI> display current-configuration | include vlan
vlan batch 2 10 101 to 102 800 1000
vlan 2
vlan 10
port trunk pvid vlan 800
undo port trunk allow-pass vlan 1
port trunk allow-pass vlan 10 101 800
undo port hybrid vlan 1
undo port hybrid vlan 1
port hybrid untagged vlan 10
undo port hybrid vlan 1
undo port hybrid vlan 1

The command output provided here is used for reference only. The actual output
information may differ from the preceding information.

Specifying a Filtering Mode on a Split Screen

When the output of the following commands is displayed screen by screen, you
can specify a filtering mode:
● display current-configuration
● display interface
● display arp
When a lot of information is displayed on a split screen, you can specify a filtering
mode in the prompt "---- More ----".
● /regular-expression: displays all the lines beginning with the line that matches
the regular expression.
● -regular-expression: displays all the lines that do not match the regular
expression.
● +regular-expression: displays all the lines that match the regular expression.
For example, run the display current-configuration command to display only
VLANIF-related information when the command output is displayed on a split
screen.
<HUAWEI> display current-configuration
!Software Version V200R013C00
#
sysname HUAWEI
#
vlan batch 10 to 11 100
#
hotkey CTRL_G "display tcp status"
#
lldp enable
#
undo http server enable
undo http secure-server enable
#
dhcp enable
#
dhcp snooping enable
+Vlanif //Enter the filtering mode.

Filtering...
interface Vlanif10
interface Vlanif100

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 17

S2720, S5700, and S6720 Series Ethernet Switches
Configuration Guide - Basic Configuration 1 CLI Overview

1.12 Setting Command Levels

Context
Each command on the device has a default level. The device administrator can
change the command level as required so that users of different levels can execute
commands correspondingly.
The system grants users different access permissions based on their roles. User
levels are classified into sixteen levels, which correspond to the command levels.
Users can use only the commands at the same or lower level than their own
levels. By default, there are four command levels 0 to 3 and sixteen user levels 0
to 15. Table 1-5 describes the relationship between command levels and user
levels.

Table 1-5 Relations between command levels and user levels

Comma Description Example User
nd Level Level

Visit Diagnostic commands ● tracert All levels

level ● ping (level-0 to
(level-0) level-15)
External device access ● telnet
commands ● stelnet

Monitori System maintenance display commands Not lower

ng level commands NOTE than the
(level-1) Some display commands monitorin
are not at this level. For g level
example, the display (level-1 to
current-configuration and
level-15)
display saved-
configuration commands
are level-3 commands.

Configur Service configuration Route configuration Not lower

ation commands commands than the
level configurati
(level-2) on level
(level-2 to
level-15)

Manage Basic system operation ● User management Managem

ment commands ● Setting command ent level
level levels (level-3 to
(level-3) level-15)
● Setting system
parameters
● debugging
commands

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 18

S2720, S5700, and S6720 Series Ethernet Switches
Configuration Guide - Basic Configuration 1 CLI Overview

Comma Description Example User

nd Level Level

Support module commands ● File system

● FTP/TFTP
downloading
● Configuration file
switching

For details about command levels, see S2720, S5700, and S6720 V200R013C00
Command Reference.

The default command level setting is appropriate for user operation rights control;
therefore, you are advised not to change command levels. If there are special
requirements on user operation rights of a specific-level user, you can change the
command level of specified commands. For example, if only level-4 and a higher
level users are allowed to execute the stelnet command, you can upgrade the
command level of the stelnet command to level-4.

In addition to upgrade a command level, you can also lower a command level.

Do not change the default level of a command. Otherwise, some users may be unable to
use the command. If command levels are changed separately before you upgrade command
levels in a batch, the levels of these commands remain unchanged. Therefore, you are
advised to upgrade command levels in a batch before you upgrade the level of each
command separately.
The execution of some commands depends on some conditions. For example, a command
can be configured only when other commands are configured or the command is an
upgrade-compatible command. When levels of these commands are adjusted using the
command-privilege level command, the adjusted commands may not be executed. Level
adjustment of a command is irrelevant to execution of the command.

Procedure
Step 1 Run system-view

The system view is displayed.

Step 2 Set the command level.

● Run command-privilege level level view view-name command-key
The command level is set in the specified view.
● Run command-privilege level rearrange
The command levels are upgraded in batches.
– If command levels are not changed separately, the levels change
according to the following rules after a batch command level upgrade
command is executed:

▪ The visit level and monitoring level remain unchanged.

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 19

S2720, S5700, and S6720 Series Ethernet Switches
Configuration Guide - Basic Configuration 1 CLI Overview

▪ The configuration level is upgraded to level 10, and the management

level is upgraded to level 15.

▪ There are no commands at levels 2 to 9 and levels 11 to 14. You can

set commands to any of these levels separately to implement refined
user rights management.
– If you have run the command-privilege level level view view-name
command-key command to change a command level before you execute
the batch command level upgrade command, the level of this command
remains unchanged.
Before you run the batch command level upgrade command, ensure that your
user level is 15. Otherwise, you cannot run the command.

----End

1.13 Displaying History Commands

The device automatically stores history commands entered by a user. To enter a
command that has been executed, you can use this function to call up the history
command.

By default, the system saves 10 history commands for each user. Run the history-
command max-size size-value command to reset the number of history
commands that can be saved in a specified user interface view. The maximum
number is 256.

If the value specified in the history-command max-size size-value command is large, it

may take a long time to obtain a required history command. Therefore, a large value is not
recommended.

Table 1-6 shows operations on history commands.

Table 1-6 Accessing history commands

Action Command or Key Result

Display history display history-command ● The history

commands. [ all-users ] commands entered by
the current users are
displayed when all-
users is not selected.
● The history
commands entered by
all users are displayed
when all-users is
selected. (all-users
can be selected only
by users of level 3 or
higher.)

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 20

S2720, S5700, and S6720 Series Ethernet Switches
Configuration Guide - Basic Configuration 1 CLI Overview

Action Command or Key Result

Display the earlier Up arrow key ↑ or Ctrl+P An earlier history

history command. command is displayed. If
the current command is
the first command, an
alarm is generated when
you attempt to display
the earlier history
command.

Display the later Down arrow key ↓ or Ctrl+N A later history command
history command. is displayed. If the
current command is the
latest command, no
output is displayed and
an alarm is generated
when you attempt to
display the later history
command.

You cannot access history commands using the Up arrow key ↑ in HyperTerminal Windows
9X. The Up arrow key ↑ has a different function in HyperTerminal Windows 9X and needs to
be replaced by the shortcut key Ctrl+P.

When using history commands, note the following:

● The saved history commands are the same as those entered by users. For
example, if the user enters an incomplete command, the saved command also
is incomplete.
● If the user runs the same command several times, only the latest command is
saved. If the command is entered in different forms, they are considered as
different commands.
For example, if the display current-configuration command is run several
times, only one history command is saved. If the display current-
configuration command and the dis curr command are used, both of them
are saved.
● History commands entered by the current user can be deleted using the reset
history-command command in all view. The deleted history commands
cannot be displayed or accessed. To delete history commands entered by all
users, run the reset history-command [ all-users ] command as a user of
level 3 or higher.

Issue 05 (2020-03-20) Copyright © Huawei Technologies Co., Ltd. 21