H3C S6812 Series Installation manual

About the H3C S5150-EI command
references
The H3C S5150-EI command references describe the commands and command syntax options
available for the H3C S5150-EI Switch Series.
Command reference
Content
Fundamentals Command
Reference
Covers the commands for logging in to and setting up an S5150-EI switch.
This command reference includes:
•CLI (command privilege settings and CLI management commands).
•RBAC.
•Logging in to the switch.
•FTP and TFTP.
•File system management.
•Configuration file management.
•Software upgrade.
•Emergency shell.
•Device management.
•Tcl.
•Python.
IRF Command Reference
Covers the commands for configuring the H3C proprietary Intelligent
Resilient Framework (IRF) technology features. It covers planning the
switch roles in the IRF fabric, connecting the IRF links, and detecting and
maintaining the IRF fabric.
Layer 2—LAN Switching
Command Reference
Covers the commands for configuring Layer 2 technologies and features
in a LAN switched network.
This command reference includes:
•Ethernet interface.
•Loopback, null, and inloopback interfaces.
•Bulk interface configuration.
•MAC address table and MAC Information.
•Ethernet link aggregation.
•Port isolation.
•Spanning tree.
•Loop detection.
•VLAN (including VLAN, super VLAN, private VLAN, and voice
VLAN).
•MVRP.
•QinQ.
•VLAN mapping.
•LLDP.
Layer 3—IP Services
Command Reference
Covers the commands for configuring and managing IP addressing
(including static and dynamic IPv4 and IPv6 address assignment),
network performance optimization, and ARP.
This command reference includes:
•ARP (including gratuitous ARP, proxy ARP, and ARP snooping).
•IP addressing.
•DHCP.
•DNS.

Command reference
Content
•Basic IP forwarding.
•IDRP.
•IP performance optimization.
•UDP helper.
•IPv6 basics.
•DHCPv6.
Layer 3—IP Routing Command
Reference
Covers the commands for configuring routes for IPv4 and IPv6 networks
of different sizes, route filtering, route control, and policy-based routing.
This command reference includes:
•Basic IP routing.
•Static routing.
•RIP.
•OSPF.
•Policy-based routing.
•IPv6 static routing.
•RIPng.
•OSPFv3.
•IPv6 policy-based routing.
•Routing policy.
IP Multicast Command
Reference
Covers the commands for Layer 2 IPv4 multicast protocols (including
IGMP snooping, PIM snooping, and multicast VLAN) and Layer 2 IPv6
multicast protocols (including MLD snooping, IPv6 PIM snooping, and
IPv6 multicast VLAN).
This command reference includes:
•IGMP snooping.
•PIM snooping.
•Multicast VLAN.
•MLD snooping.
•IPv6 PIM snooping.
•IPv6 multicast VLAN.
ACL and QoS Command
Reference
Covers the commands for classifying traffic with ACLs, and allocating
network resources and managing congestions with QoS technologies to
improve network performance and network use efficiency.
This command reference includes:
•ACL.
•QoS (including QoS policy, priority mapping, GTS and rate limit,
congestion management, congestion avoidance, and aggregate
CAR).
•Time range.
•Data buffer.
Security Command Reference
Covers security feature commands. Available security features include
identity authentication (AAA), access security (802.1X, MAC
authentication, and portal), secure management (SSH), SSL, and attack
protection (IP source guard, ARP attack protection, and MFF).
This command reference includes:
•AAA.
•802.1X.
•MAC authentication.
•Portal.
•Port security.
•User profile.

Command reference
Content
•Password control.
•Keychain.
•Public key management.
•PKI.
•IPsec and IKE.
•SSH.
•SSL.
•Attack detection and prevention.
•TCP attack prevention.
•IP source guard.
•ARP attack protection.
•ND attack defense.
•MFF.
•Crypto engine.
•FIPS.
High Availability Command
Reference
Covers high availability commands for managing failure detection and
failover. Failure detection technologies focus on fault detection and
isolation. Failover technologies focus on network recovery.
This command reference includes:
•Ethernet OAM.
•CFD.
•DLDP.
•Smart Link.
•Monitor Link.
•BFD.
•Track.
Network Management and
Monitoring Command
Reference
Covers the commands that help you manage and monitor your network,
for example, manage system events, collect traffic statistics, sample
packets, assess network performance, and test network connectivity.
This command reference includes:
•System maintenance and debugging (ping, tracert, and system
debugging).
•NQA.
•NTP and SNTP.
•PoE.
•SNMP.
•RMON.
•NETCONF.
•CWMP.
•EAA.
•Process monitoring and maintenance.
•Mirroring (including both port and traffic mirroring).
•sFlow.
•Information center.
•Packet capture.
OpenFlow Command
Reference Covers the commands for configuring OpenFlow.

H3C S6812 & S6813 Switch Series
Fundamentals Command Reference
New H3C Technologies Co., Ltd.
http://www.h3c.com
Software version: Release 510x
Document version: 6W102-20230313

Copyright ©2016-2023, New H3C Technologies Co., Ltd. and its licensors
All rights reserved
No part of this manual may be reproduced or transmitted in any form or by any means without prior written
consent of New H3C Technologies Co., Ltd.
Trademarks
Except for the trademarks of New H3C Technologies Co., Ltd., any trademarks that may be mentioned in this
document are the property of their respective owners.
Notice
The information in this document is subject to change without notice. All contents in this document, including
statements, information, and recommendations, are believed to be accurate, but they are presented without
warranty of any kind, express or implied. H3C shall not be liable for technical or editorial errors or omissions
contained herein.

Preface
This command reference describes commands that help you get started with the switch, including
This preface includes the following topics about the documentation:
•
Audience.
•
Conventions.
•
Documentation feedback.
Audience
This documentation is intended for:
•
Network planners.
•
Field technical support and servicing engineers.
•
Network administrators.
Conventions
The following information describes the conventions used in the documentation.
Command conventions
Convention
Description
Boldface Bold text represents commands and keywords that you enter literally as shown.
Italic Italic text represents arguments that you replace with actual values.
[ ] Square brackets enclose syntax choices (keywords or arguments) that are optional.
{ x | y | ... }
Braces enclose a set of required syntax choices separated by vertical bars, from which
you select one.
[ x | y | ... ]
Square brackets enclose a set of optional syntax choices separated by vertical bars,
from which you select one or none.
{ x | y | ... } *
Asterisk marked braces enclose a set of required syntax choices separated by vertical
bars, from which you select a minimum of one.
[ x | y | ... ] *
Asterisk marked square brackets enclose optional syntax choices separated by vertical
bars, from which you select one choice, multiple choices, or none.
&<1-n> The argument or keyword and argument combination before the ampersand (&) sign
can be entered 1 to n times.
# A line that starts with a pound (#) sign is comments.
GUI conventions
Convention
Description
Boldface Window names, button names, field names, and menu items are in Boldface. For
example, the New User window opens; click OK.
> Multi-level menus are separated by angle brackets. For example, File > Create >
Folder.

Symbols
Convention
Description
WARNING! An alert that calls attention to important information that if not understood or followed
can result in personal injury.
CAUTION:
An alert that calls attention to important information that if not understood or followed
can result in data loss, data corruption, or damage to hardware or software.
IMPORTANT:
An alert that calls attention to essential information.
NOTE:
An alert that contains additional or supplementary information.
TIP:
An alert that provides helpful information.
Network topology icons
Convention
Description
Represents a generic network device, such as a router, switch, or firewall.
Represents a routing-capable device, such as a router or Layer 3 switch.
Represents a generic switch, such as a Layer 2 or Layer 3 switch, or a router that
supports Layer 2 forwarding and other Layer 2 features.
Represents an access controller, a unified wired-WLAN module, or the access
controller engine on a unified wired-WLAN switch.
Represents an access point.
Represents a wireless terminator unit.
Represents a wireless terminator.
Represents a mesh access point.
Represents omnidirectional signals.
Represents directional signals.
Represents a security product, such as a firewall, UTM, multiservice security
gateway, or load balancing device.
Represents a security module, such as a firewall, load balancing, NetStream, SSL
VPN, IPS, or ACG module.
Examples provided in this document
Examples in this document might use devices that differ from your device in hardware model,
configuration, or software version. It is normal that the port numbers, sample output, screenshots,
and other information in the examples differ from what you have on your device.
T
T
T
T

Documentation feedback
You can e-mail your comments about product documentation to [e-mail].
We appreciate your comments.

i
Contents
Basic CLI commands·····················································································1
alias····························································································································································1
display | { begin | exclude | include }··········································································································2
display | by-linenum ···································································································································3
display >·····················································································································································4
display >>···················································································································································5
display alias················································································································································6
display history-command ···························································································································6
display history-command all·······················································································································7
display hotkey ············································································································································8
hotkey·························································································································································9
quit ···························································································································································10
repeat·······················································································································································10
return························································································································································12
screen-length disable·······························································································································12
system-view ·············································································································································13

1
Basic CLI commands
alias
Use alias to configure a command alias.
Use undo alias to delete a command alias.
Syntax
alias alias command
undo alias alias
Default
The device has a set of system-defined command aliases, as listed in Table 1.
Table 1 System-defined command aliases
Command alias
Command or command keyword
access-list acl
end return
erase delete
exit quit
hostname sysname
logging info-center
no undo
show display
write save
Views
System view
Predefined user roles
network-admin
Parameters
alias: Specifies an alias, a case-sensitive string of 1 to 20 characters. An alias cannot be alias or
contain spaces.
command: Specifies a command string. Make sure the command string meets the syntax
requirements.
Usage guidelines
System-defined command aliases cannot be deleted.
You can configure one or more aliases for a command or the starting keywords of commands. Then,
you can use the aliases to execute the command or commands. If the command or commands have
undo forms, you can also use the aliases to execute the undo command or commands.
For example, if you configure the alias shiprt for display ip routing-table, you can enter shiprt to
execute the display ip routing-table command. If you configure the alias ship for display ip, you
can use ship to execute all commands that start with display ip:

2
•
Enter ship routing-table to execute the display ip routing-table command.
•
Enter ship interface to execute the display ip interface command.
The command string can include up to nine parameters. Each parameter starts with the dollar sign ($)
and a sequence number in the range of 1 to 9. For example, you can configure the alias shinc for the
display ip $1 | include $2 command. Then, to execute the display ip routing-table | include
Static command, you only need to enter shinc routing-table Static. To execute the display ip
interface | include Ten-GigabitEthernet1/0/1 command, you only need to enter shinc interface
Ten-GigabitEthernet1/0/1.
Examples
# Configure shiprt as the alias for the display ip routing-table command and verify the
configuration.
<Sysname> system-view
[Sysname] alias shiprt display ip routing-table
[Sysname] shiprt
Destinations : 12 Routes : 12
Destination/Mask Proto Pre Cost NextHop Interface
0.0.0.0/32 Direct 0 0 127.0.0.1 InLoop0
3.3.3.3/32 Static 60 0 192.168.1.62 Vlan1
127.0.0.0/8 Direct 0 0 127.0.0.1 InLoop0
127.0.0.0/32 Direct 0 0 127.0.0.1 InLoop0
127.0.0.1/32 Direct 0 0 127.0.0.1 InLoop0
127.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0
169.254.0.0/24 Direct 0 0 169.254.0.188 Vlan1
169.254.0.0/32 Direct 0 0 169.254.0.188 Vlan1
169.254.0.188/32 Direct 0 0 127.0.0.1 InLoop0
169.254.0.255/32 Direct 0 0 169.254.0.188 Vlan1
224.0.0.0/4 Direct 0 0 0.0.0.0 NULL0
224.0.0.0/24 Direct 0 0 0.0.0.0 NULL0
255.255.255.255/32 Direct 0 0 127.0.0.1 InLoop0
# Configure shinc as the alias for display ip $1 | include $2.
[Sysname] alias shinc display ip $1 | include $2
# Use alias shinc to display all static routes.
[Sysname] shinc routing-table Static
3.3.3.3/32 Static 60 0 192.168.1.62 Vlan1
Related commands
display alias
display | { begin | exclude | include }
Use display |{ begin | exclude | include } to filter the output from a display command with a regular
expression.
Syntax
display command |{ begin | exclude | include } regular-expression
Views
Any view

3
Predefined user roles
network-admin
network-operator
Parameters
command: Specifies the keywords and arguments of a display command. To display available
keywords and arguments, enter display ?.
begin: Displays the first line matching the specified regular expression and all subsequent lines.
exclude: Displays all lines not matching the specified regular expression.
include: Displays all lines matching the specified regular expression.
regular-expression: Specifies a regular expression, a case-sensitive string of 1 to 256 characters.
Usage guidelines
Use the |{ begin | exclude | include } regular-expression option with a display command to filter
the command output. For more information about regular expressions, see Fundamentals
Configuration Guide.
Examples
# Display the lines that contain vlan in the running configuration.
<Sysname> display current-configuration | include vlan
vlan 1
vlan 999
port access vlan 999
display | by-linenum
Use display | by-linenum to number each output line for a display command.
Syntax
display command |by-linenum
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
command: Specifies the keywords and arguments of a display command. To display available
keywords and arguments, enter display ?.
Usage guidelines
By numbering each output line from a display command, you can easily identify the lines of interest.
Each line number is displayed as a 5-character string and might be followed by a colon (:) or hyphen
(-). If you specify both | by-linenum and | begin regular-expression for a display command, a
hyphen is displayed for all lines that do not match the regular expression.
Examples
# Display VLAN 999 settings, with each output line identified by a number.
<Sysname> display vlan 999 | by-linenum
1: VLAN ID: 999

4
2: VLAN type: Static
3: Route interface: Configured
4: IP address: 192.168.2.1
5: Subnet mask: 255.255.255.0
6: Description: For LAN Access
7: Name: VLAN 0999
8: Tagged ports: None
9: Untagged ports:
10: Ten-GigabitEthernet1/0/1
# Display the first line that begins with user-group in the running configuration and all of the
following lines.
<Sysname> display current-configuration | by-linenum begin user-group
114: user-group system
115-#
116-return
display >
Use display >to save the output from a display command to a separate file.
Syntax
display command > filename
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
command: Specifies the keywords and arguments of a display command. To display available
keywords and arguments, enter display ?.
filename: Specifies the name of the file that is used to save the output, a string of 1 to 63 characters.
Usage guidelines
The display commands show the configuration, statistics, and states of the device. You can use the
display >command to save the output to a file.
If the specified file does not exist, the system creates the file and saves the output to the file. If the file
already exists, the system overwrites the file.
Examples
# Save VLAN 1 settings to a separate file named vlan.txt.
<Sysname> display vlan 1 > vlan.txt
# Check the content of the vlan.txt file.
<Sysname> more vlan.txt
VLAN ID: 1
VLAN type: Static
Route interface: Not configured
Description: VLAN 0001
Name: VLAN 0001

5
Tagged ports: None
Untagged ports:
Ten-GigabitEthernet1/0/2
display >>
Use display >> to append the output from a display command to the end of a file.
Syntax
display command >> filename
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
command: Specifies the keywords and arguments of a display command. To display available
keywords and arguments, enter display ?.
filename: Specifies the name of the file that is used to save the output, a string of 1 to 63 characters.
Usage guidelines
The display commands show the configuration, statistics, and states of the device. You can use
display >> to save the output to a file.
If the specified file does not exist, the system creates the file and saves the output to the file. If the file
already exists, the system appends the output to the end of the file.
Examples
# Append the VLAN 999 settings to the end of the vlan.txt file.
<Sysname> display vlan 999 >> vlan.txt
<Sysname>
# Check the content of the vlan.txt file.
<Sysname> more vlan.txt
VLAN ID: 1
VLAN type: Static
Route interface: Not configured
Description: VLAN 0001
Name: VLAN 0001
Tagged ports: None
Untagged ports:
Ten-GigabitEthernet1/0/2
VLAN ID: 999
VLAN type: Static
Route interface: Configured
IP address: 192.168.2.1
Subnet mask: 255.255.255.0
Description: For LAN Access
Name: VLAN 0999

6
Tagged ports: None
Untagged ports:
Ten-GigabitEthernet1/0/2
display alias
Use display alias to display command aliases.
Syntax
display alias [alias ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
alias: Specifies a command alias. If you do not specify this argument, the command displays all
command aliases.
Examples
# Display all command aliases.
<Sysname> display alias
Index Alias Command key
1 access-list acl
2 end return
3 erase delete
4 exit quit
5 hostname sysname
6 logging info-center
7 no undo
8 shinc display $1 | include $2
9 show display
10 sirt display ip routing-table
11 write save
# Display the command alias shinc.
<Sysname> display alias shinc
Alias Command key
shinc display ip $1 | include $2
Related commands
alias
display history-command
Use display history-command to display all commands that are saved in the command history
buffer for the current CLI session.
Syntax
display history-command

7
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
The system automatically saves commands you have successfully executed to the command history
buffer for the current CLI session. You can view them and execute them again.
By default, the system can save up to 10 commands in the buffer. You can use the
history-command max-size command to change the buffer size. To buffer a new command when
the buffer is full, the system deletes the oldest command entry in the buffer.
All commands in the command history buffer for the current CLI session will be cleared when you log
out.
Examples
# Display all commands saved in the command history buffer for the current CLI session.
<Sysname> display history-command
system-view
vlan 2
quit
Related commands
history-command max-size
display history-command all
Use display history-command all to display all commands that are saved in the command history
buffer for all CLI sessions.
Syntax
display history-command all
Views
Any view
Predefined user roles
network-admin
Usage guidelines
The system automatically saves commands successfully executed by users to the command history
buffer for all CLI sessions. Users can view them but cannot recall them from the buffer.
Up to 1024 commands can be saved in the command history buffer. To buffer a new command when
the buffer is full, the system deletes the oldest command entry in the buffer.
A user logout does not cause the system to delete commands from the history buffer for all CLI
sessions.
Examples
# Display all commands saved in the command history buffer for all CLI sessions.
<Sysname> display history-command all
Date Time Terminal Ip User
03/16/2012 20:03:33 vty0 192.168.1.26 **

8
Cmd:dis his all
03/16/2012 20:03:29 vty0 192.168.1.26 **
Cmd:sys
Table 2 Command output
Field
Description
Date Date when the command was executed.
Time Time when the command was executed.
Terminal User line used by the user.
Ip IP address of the terminal used by the user.
User Username used by the user if the user login authentication mode is
scheme. If the login authentication mode is none or password, this field
displays **.
Cmd Command string entered by the user.
Related commands
display history-command
display hotkey
Use display hotkey to display hotkey information.
Syntax
display hotkey
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display hotkey information.
<Sysname> display hotkey
----------------- Hotkeys -----------------
-Defined command hotkeys-
CTRL_G display current-configuration
CTRL_L display ip routing-table
CTRL_O undo debugging all
-Undefined command hotkeys-
CTRL_T NULL
CTRL_U NULL
-System-reserved hotkeys-
CTRL_A Move the cursor to the beginning of the line.
CTRL_B Move the cursor one character to the left.

9
CTRL_C Stop the current command.
CTRL_D Erase the character at the cursor.
CTRL_E Move the cursor to the end of the line.
CTRL_F Move the cursor one character to the right.
CTRL_H Erase the character to the left of the cursor.
CTRL_K Abort the connection request.
CTRL_N Display the next command in the history buffer.
CTRL_P Display the previous command in the history buffer.
CTRL_R Redisplay the current line.
CTRL_V Paste text from the clipboard.
CTRL_W Delete the word to the left of the cursor.
CTRL_X Delete all characters from the beginning of the line to the cursor.
CTRL_Y Delete all characters from the cursor to the end of the line.
CTRL_Z Return to the User View.
CTRL_] Kill incoming connection or redirect connection.
ESC_B Move the cursor back one word.
ESC_D Delete all characters from the cursor to the end of the 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_< Move the cursor to the beginning of the clipboard.
ESC_> Move the cursor to the end of the clipboard.
Related commands
hotkey
hotkey
Use hotkey to assign a command to a configurable command hotkey.
Use undo hotkey to restore the default.
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 }
Default
•
Ctrl+G: display current-configuration (display the running configuration).
•
Ctrl+L: display ip routing-table (display the IPv4 routing table information).
•
Ctrl+O: undo debugging all (disable all debugging functions).
•
Ctrl+T: No command is assigned to this hotkey.
•
Ctrl+U: No command is assigned to this hotkey.
Views
System view
Predefined user roles
network-admin
Parameters
ctrl_g: Assigns a command to Ctrl+G.

10
ctrl_l: Assigns a command to Ctrl+L.
ctrl_o: Assigns a command to Ctrl+O.
ctrl_t: Assigns a command to Ctrl+T.
ctrl_u: Assigns a command to Ctrl+U.
command: Specifies the command to be assigned to the hotkey.
Usage guidelines
The system defines some command hotkeys and provides five configurable command hotkeys.
Pressing a command hotkey executes the command assigned to the hotkey.
To display system-defined and configurable command hotkeys, use the display hotkey command.
Examples
# Assign the display tcp statistics command to hotkey Ctrl+T.
<Sysname> system-view
[Sysname] hotkey ctrl_t display tcp statistics
Related commands
display hotkey
quit
Use quit to return to the upper-level view.
Syntax
quit
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
Executing this command in user view disconnects you from the device.
Examples
# Return from Ten-GigabitEthernet 1/0/1 interface view to system view and then to user view.
[Sysname-Ten-GigabitEthernet1/0/1] quit
[Sysname] quit
<Sysname>
repeat
Use repeat to repeat commands in the command history buffer for the current CLI session.
Syntax
repeat [number ] [ count times ][delay seconds ]
Views
Any view

11
Predefined user roles
network-admin
Parameters
number: Specifies the number of the most recently executed commands in the command history
buffer for the current CLI session that you want to execute. The value range is 1 to 10. The default is
1.
count times: Specifies the number of times that you want to execute the commands. The value
range is 0 to 4294967295. The default is 0. If you do not specify this option, the system keeps
executing the commands until you press the escape key to terminate the execution. To display the
current escape key, use the display current-configuration | include escape-key command.
delay seconds: Specifies the time (in seconds) for the system to wait before executing the
commands again. The value range is 0 to 4294967295. The default is 1.
Usage guidelines
To repeat a command, first enter the view for the command. To repeat multiple commands, first enter
the view for the first command.
The repeat command executes commands in the order they were executed.
The system waits for your interaction when it repeats an interactive command.
Examples
# Configure the system to execute the two most recently executed commands (display cpu and
display clock) three times at an interval of 10 seconds.
<Sysname> repeat 2 count 3 delay 10
<Sysname> display cpu
Slot 1 CPU 0 CPU usage:
33% in last 5 seconds
32% in last 1 minute
33% in last 5 minutes
<Sysname> display clock
12:20:08 UTC Thu 06/19/2014
<Sysname> display cpu
Slot 1 CPU 0 CPU usage:
33% in last 5 seconds
32% in last 1 minute
33% in last 5 minutes
<Sysname> display clock
12:20:18 UTC Thu 06/19/2014
<Sysname> display cpu
Slot 1 CPU 0 CPU usage:
33% in last 5 seconds
32% in last 1 minute
33% in last 5 minutes
<Sysname> display clock
12:20:28 UTC Thu 06/19/2014
Related commands
display history-command
escape-key
history-command max-size