Operation Manual – Command Line Interface
H3C S9500 Series Routing Switches Table of Contents
i
Table of Contents
Chapter 1 Command Line Interface.............................................................................................1-1
1.1 Command Line Interface ................................................................................................... 1-1
1.2 Command Line View.......................................................................................................... 1-1
1.3 Features and Functions of Command Line ..................................................................... 1-10
1.3.1 Online Help of Command Line.............................................................................. 1-10
1.3.2 Displaying Characteristics of Command Line ....................................................... 1-11
1.3.3 History Command of Command Line.................................................................... 1-12
1.3.4 Common Command Line Error Messages............................................................ 1-12
1.3.5 Editing Characteristics of Command Line............................................................. 1-13
Operation Manual – Command Line Interface
H3C S9500 Series Routing Switches Chapter 1 Command Line Interface
1-1
Chapter 1 Command Line Interface
When configuring command line interface, go to these sections for information you are
interested in:
z Command Line Interface
z Command Line View
z Features and Functions of Command Line
1.1 Command Line Interface
H3C series switches provide a series of configuration commands and command line
interfaces for configuring and managing the switch. The command line interface has
the following characteristics:
z Local configuration via the Console port and AUX port.
z Local or remote configuration via Telnet.
z Remote configuration through dialing with modem via the AUX port.
z Hierarchy command protection to avoid the unauthorized users accessing switch.
z Enter a “?” to get immediate online help.
z Provide network testing commands, such as Tracert and Ping, to fast troubleshoot
the network.
z Provide various detailed debugging information to help with network
troubleshooting.
z Log in and manage other switch directly, using the Telnet command.
z Provide FTP service for the users to upload and download files.
z Provide the function similar to Doskey to execute a history command.
z The command line interpreter searches for target not fully matching the keywords.
You can key in either the whole keyword or part of it, as long as it is unique and not
ambiguous.
1.2 Command Line View
H3C series switches provide hierarchy protection for the command lines to avoid
unauthorized user accessing illegally.
Commands are classified into four levels, namely visit level, monitor level, system level
and manage level. They are introduced as follows:
z Visit level: Commands of this level involve command of network diagnosis tool
(such as ping and tracert), command of switch between different language
environments of user interface (language-mode) and the telnet command. The
operation of saving configuration file is not allowed on this level of commands.
Operation Manual – Command Line Interface
H3C S9500 Series Routing Switches Chapter 1 Command Line Interface
1-2
z Monitor level: Commands of this level, including the display command and the
debugging command, are used for system maintenance, service fault diagnosis,
etc. The operation of saving configuration file is not allowed on this level of
commands.
z System level: Service configuration commands, including routing command and
commands on each network layer, are used to provide direct network service to
the user.
z Manage level: They are commands that influence basis operation of the system
and system support module, which plays a support role on service. Commands of
this level involve file system commands, FTP commands, TFTP commands,
XModem downloading commands, user management commands, and level
setting commands.
At the same time, login users are classified into four levels that correspond to the four
command levels respectively. After users of different levels log in, they can only use
commands at the levels that are equal to or lower than their own level.
In order to prevent unauthorized users from illegal intrusion, users will be authenticated
when switching from a lower level to a higher level with super [ level ] command. User
ID authentication is performed when users at lower level switch to users at higher level.
If users pass the authentication, they will switch to a higher level; otherwise, they will
remain at the original user level.
Different command views are implemented according to different requirements. They
are related to one another. For example, after logging into the switch, you will enter user
view, in which you can only use some basic functions such as displaying the running
state and statistics information. In user view, key in system-view to enter system view,
in which you can key in different configuration commands and enter the corresponding
views.
The command line provides the following views:
z User view
z System view
z Port view
z VLAN view
z VLAN interface view
z Local-user view
z User interface view
z FTP Client command view
z SFTP Client view
z MST region view
z PIM view
z MSDP view
z IPv4 multicast sub-address family view
z RIP view
Operation Manual – Command Line Interface
H3C S9500 Series Routing Switches Chapter 1 Command Line Interface
1-3
z OSPF view
z OSPF area view
z BGP view
z IS-IS view
z Route policy view
z Basic ACL view
z Advanced ACL view
z Layer-2 ACL view
z Conform-level view
z WRED index view
z RADIUS server group view
z ISP domain view
z MPLS view
z VPNv4 sub-address family view
z VPN-instance sub-address family view
z BGP-VPNv4 sub-address family view
z MPLS L2VPN view
z L2VPN address family view
z Route-Policy view
z vpn-instance view
z OSPF protocol view
z Remote-peer view
z VSI-LDP view
z VSI view
z HWTACACS view
z Port group view
z Lanswitch view
z HGMP view
z NQA test group view
The following table describes the function features of different views and the ways to
enter or quit. Port numbers are only for examples.
Table 1-1 Function feature of command view
Command
view
Function Prompt
Command to
enter
Command to
exit
User view
Show the basic
information
about operation
and statistics
<H3C>
Enter right
after
connecting the
switch
Use quit to
end the
disconnection
with the switch
System view
Configure
system
parameters
[H3C]
Key in
system-view
in user view
Use quit or
return to
return to user
view
Operation Manual – Command Line Interface
H3C S9500 Series Routing Switches Chapter 1 Command Line Interface
1-4
Command
view
Function Prompt
Command to
enter
Command to
exit
[H3C-Ethernet
2/1/1]
100M
Ethernet port
view
Key in
interface
ethernet 2/1/1
in system view
[H3C-GigabitE
thernet2/1/1]
GigabitEthern
et port view
Key in
interface
gigabitethern
et 2/1/1 in
system view
Ethernet port
view:
Configure
Ethernet port
parameters
[H3C-GigabitE
thernet2/1/1]
10G Ethernet
port view
Key in
interface
gigabitethern
et 2/1/1 in
system view
POS port view:
Configure POS
port parameters
[H3C-Pos2/1/
1]
Key in
interface pos
2/1/1 in
system view
RPR logical port
view: Configure
RPR port
parameters
[H3C- RprPos
3/1/1]
Key in
interface
RprPos 3/1/1
in system view
Port view
RPR POS
physical port
view: Configure
physical
parameters for
RPR ports
[H3C-RprPos
2/1/1.1]
Key in
interface
RprPos2/1/1.
1 in system
view
Use quit to
return to
system view
Use return to
return to user
view
VLAN view
Configure VLAN
parameters
[H3C-Vlan1]
Key in vlan 1
in system view
Use quit to
return to
system view
Use return to
return to user
view
VLAN
interface
view
Configure IP
interface
parameters for a
VLAN or a
VLAN
aggregation
[H3C-Vlan-int
erface1]
Key in
interface
vlan-interfac
e 1 in system
view
Use quit to
return to
system view
Use return to
return to user
view
Operation Manual – Command Line Interface
H3C S9500 Series Routing Switches Chapter 1 Command Line Interface
1-5
Command
view
Function Prompt
Command to
enter
Command to
exit
Local-user
view
Configure local
user parameters
[H3C-luser-us
er1]
Key in
local-user
user1 in
system view
Use quit to
return to
system view
Use return to
return to user
view
User
interface
view
Configure user
interface
parameters
[H3C-ui0]
Key in
user-interfac
e 0 in system
view
Use quit to
return to
system view
Use return to
return to user
view
FTP client
command
view
Configure FTP
Client
parameters
[ftp]
Key in ftp in
user view
Use quit to
return to
system view
SFTP Client
view
Configure SFTP
Client
parameters
<sftp-client>
Key in sftp
ip-address in
system view
Use quit to
return to
system view
Use return to
return to user
view
MST region
view
Configure MST
region
parameters
[H3C-mst-regi
on]
Key in stp
region-config
uration in
system view
Use quit to
return to
system view
Use return to
return to user
view
PIM view
Configure PIM
parameters
[H3C-PIM]
Key in pim in
system view
Use quit to
return to
system view
Use return to
return to user
view
MSDP view
Configure
MSDP
parameters
[H3C-msdp]
Key in msdp
in system view
Use quit to
return to
system view
Use return to
return to user
view
IPv4
multicast
sub-address
family view
Enter the IPv4
multicast
sub-address
family view to
configure MBGP
multicast
extension
parameters
[H3C-bgp-af-
mul]
Key in
ipv4-family
multicast in
BGP view
Use quit to
return to BGP
view
Use return to
return to user
view
Operation Manual – Command Line Interface
H3C S9500 Series Routing Switches Chapter 1 Command Line Interface
1-6
Command
view
Function Prompt
Command to
enter
Command to
exit
RIP view
Configure RIP
parameters
[H3C-rip]
Key in rip in
system view
Use quit to
return to
system view
Use return to
return to user
view
OSPF view
Configure OSPF
parameters
[H3C-ospf-1]
Key in ospf in
system view
Use quit to
return to
system view
Use return to
return to user
view
OSPF area
view
Configure OSPF
area parameters
[H3C-ospf-
1-area-0.0.0.1
]
Key in area 1
in OSPF view
Use quit to
return to
OSPF view
Use return to
return to user
view
BGP view
Configure BGP
parameters
[H3C-bgp]
Key in bgp
100 in system
view
Use quit to
return to
system view
Use return to
return to user
view
IS-IS view
Configure IS-IS
parameters
[H3C-isis]
Key in isis in
system view
Use quit to
return to
system view
Use return to
return to user
view
Route policy
view
Configure route
policy
parameters
[H3C-route-po
licy]
Key in
route-policy
policy1 permit
node 10 in
system view
Use quit to
return to
system view
Use return to
return to user
view
Basic ACL
view
Define the rule
of basic ACL
[H3C-acl-
basic-2000]
Key in acl
number 2000
in system view
Use quit to
return to
system view
Use return to
return to user
view
Operation Manual – Command Line Interface
H3C S9500 Series Routing Switches Chapter 1 Command Line Interface
1-7
Command
view
Function Prompt
Command to
enter
Command to
exit
Advanced
ACL view
Define the rule
of advanced
ACL
[H3C-acl-adv-
3000]
Key in acl
number 3000
in system view
Use quit to
return to
system view
Use return to
return to user
view
Layer-2 ACL
view
Define the rule
of layer-2 ACL
[H3C-acl-link-
4000]
Key in acl
number 4000
in system view
Use quit to
return to
system view
Use return to
return to user
view
Conform-lev
el view
Configure the
"DSCP +
Conform-level
Service group"
mapping table
and ”EXP +
Conform-level-
>service
parameters”
mapping table
and
"Local-preceden
ce +
Conform-level
802.1p priority"
mapping table
[H3C-conform
-level-0]
Key in qos
conform-leve
l 0 in system
view
Use quit to
return to
system view
Use return to
return to user
view
WRED index
view
Configure
WRED
parameters
[H3C-wred-0]
Key in wred 0
in system view
Use quit to
return to
system view
Use return to
return to user
view
RADIUS
server group
view
Configure radius
parameters
[H3C-radius-1
]
Key in radius
scheme 1 in
system view
Use quit to
return to
system view
Use return to
return to user
view
ISP domain
view
Configure ISP
domain
parameters
[H3C-isp-h3c1
63.net]
Key in
domain
h3c163.net in
system view
Use to return
to system view
Use return to
return to user
view
Operation Manual – Command Line Interface
H3C S9500 Series Routing Switches Chapter 1 Command Line Interface
1-8
Command
view
Function Prompt
Command to
enter
Command to
exit
MPLS view
Configure MPLS
parameters
[H3C-mpls]
Key in mpls in
system view
Use quit to
return to
system view
Use return to
return to user
view
VPNv4
sub-address
family view
Configure
VPNv4 address
family
parameters
[H3C-bgp-af-v
pn]
Key in
ipv4-family
vpnv4 in BGP
view
Use quit to
return to
system view
Use return to
return to user
view
VPN-instanc
e
sub-address
family view
Configure VPN
instance
sub-address
family
parameters
[H3C-bgp-af-v
pn-instance]
Key in
ipv4-family
vpn-instance
vpna in
BGP/RIP view
Use quit to
return to
system view
Use return to
return to user
view
BGP-VPNv4
sub-address
family view
Configure
BGP-VPNv4
sub-address
family
parameters
[H3C-bgp-af-v
pn]
Key in
ipv4-family
vpn-instance
in BGP/RIP
view
Use quit to
return to
system view
Use return to
return to user
view
MPLS
L2VPN view
Configure MPLS
L2VPN service
parameters
[H3C-mpls-l2v
pn-vpna]
Key in mpls
l2vpn vpna
encapsulatio
n Ethernet in
system view
Use quit to
return to
system view
Use return to
return to user
view
L2VPN
address
family view
Configure
L2VPN service
parameters
[H3C-bgp-af-l
2vpn]
Key in
l2vpn-family
in BGP view
Use quit to
return to
system view
Use return to
return to user
view
Route-Policy
view
Configure
Route-Policy
service
parameters
[H3C-route-po
licy]
Key in
route-policy
route-policy-n
ame { permit |
deny } node
node-number
in system view
Use quit to
return to
system view
Use return to
return to user
view
Operation Manual – Command Line Interface
H3C S9500 Series Routing Switches Chapter 1 Command Line Interface
1-9
Command
view
Function Prompt
Command to
enter
Command to
exit
vpn-instance
view
Configure
vpn-instance
parameters
[H3C-vpn-vpn
-instance_blu
e]
Key in ip
vpn-instance
vpn-instance
_ vpna in
system view
Use quit to
return to
system view
Use return to
return to user
view
OSPF
protocol
view
Configure OSPF
protocol
parameters
[H3C-ospf-10
0]
Key in ospf
process-id
[ router-id
router-id-num
ber ]
[ vpn-instanc
e
vpn-instance-
name ] in
system view
Use quit to
return to
system view
Use return to
return to user
view
Remote-pee
r view
Configure MPLS
peer group
parameters
[H3C-mpls-re
mote1]
Key in mpls
remote1
Use quit to
return to
system view
Use return to
return to user
view
VSI-LDP
view
Configure some
VPLS features
[9500-vsi-H3C
-ldp]
Key in vsi
H3C in system
view
Key in
pwsignal ldp
in vsi view
Use quit to
return to vsi
view
Use return to
return to user
view
VSI view
Specify VPLS
mode
[9500-vsi-H3C
]
Key in vsi
H3C in system
view
Use quit to
return to
system view
Use return to
return to user
view
HWTACAC
S view
Configure
HWTACACS
protocol
parameters
[9500-hwtaca
cs-H3C]
Key in
hwtacacs
scheme H3C
in system view
Use quit to
return to
system view
Use return to
return to user
view
Port group
view
Combine the
ports with the
same
configuration,
omitting
repeated
configuration
procedure
[9500-port-gro
up X]
Key in
port-group X
in system view
Use quit to
return to
system view
Use return to
return to user
view
Operation Manual – Command Line Interface
H3C S9500 Series Routing Switches Chapter 1 Command Line Interface
1-10
Command
view
Function Prompt
Command to
enter
Command to
exit
HGMP view
Configure some
HGMP features
[H3C-hgmp]
Key in
hgmpserver
enable in
system view
Use quit to
return to
system view
Use return to
return to user
view
Lanswitch
view
Enter lanswitch
view.
After entering
the specified
lanswitch view,
you can use the
specified S9500
series switch.
[H3C-lanswitc
hX/X/X-/]
Key in
lanswitch
X/X/X-/ in
HGMP view
Use quit to
return to
HGMP view
Use return to
return to user
view
NQA test
group view
Create a NQA
test group, and
enter NQA test
group view
[H3C-administ
rator-icmp]
Key in NQA
administrator-
name test-tag
in system view
Use quit to
return to
system view
Use return to
return to user
view
1.3 Features and Functions of Command Line
1.3.1 Online Help of Command Line
The command line interface provides the following online help modes.
z Full help
z Partial help
You can get the help information through these online help commands, which are
described as follows.
1) Input “?” in any view to get all the commands in it and corresponding descriptions.
<H3C> ?
User view commands:
language-mode Specify the language environment
ping Ping function
quit Exit from current command view
super Privilege current user a specified priority level
telnet Establish one TELNET connection
tracert Trace route function
2) Input a command with a “?” separated by a space. If this position is for keywords,
all the keywords and the corresponding brief descriptions will be listed.
<H3C> language-mode ?
Operation Manual – Command Line Interface
H3C S9500 Series Routing Switches Chapter 1 Command Line Interface
1-11
chinese Chinese environment
english English environment
3) Input a command with a “?” separated by a space. If this position is for parameters,
all the parameters and their brief descriptions will be listed.
[H3C] garp timer leaveall ?
INTEGER<65-32765> Value of timer in centiseconds
(LeaveAllTime > (LeaveTime [On all ports]))
Time must be multiple of 5 centiseconds
[H3C] garp timer leaveall 300 ?
<cr>
<cr> indicates no parameter in this position. The next command line repeats the
command, you can press <Enter> to execute it directly.
4) Input a character string followed by a “?”, then all the commands beginning with
this character string will be listed.
<H3C> p?
ping pwd
5) Enter a command followed by a character string and a “?”. All the keywords
starting with this string are listed.
<H3C> display ver?
version
6) Press <Tab> after entering the first several letters of a keyword to display the
complete keyword, provided these letters can uniquely identify the keyword in this
command.
1.3.2 Displaying Characteristics of Command Line
For the information to be displayed exceeding one screen, pausing function is provided.
In this case, users can have three choices, as shown in the table below.
Table 1-2 Functions of displaying
Key or Command Function
Press <Ctrl+C> when the display pauses
Stop displaying and executing
command.
Enter a space when the display pauses
Continue to display the next screen of
information.
Press <Enter> when the display pauses
Continue to display the next line of
information.
Operation Manual – Command Line Interface
H3C S9500 Series Routing Switches Chapter 1 Command Line Interface
1-12
1.3.3 History Command of Command Line
Command line interface provides the function similar to that of DosKey. The commands
entered by users can be automatically saved by the command line interface and you
can invoke and execute them at any time later. History command buffer defaults to 10.
The operations are shown in the table below.
Table 1-3 Retrieve history command
Operation Key Result
Display history command
display
history-command
[ command-number ] [ |
{ begin | include |
exclude } Match-string ]
Display history command
by user inputting
Retrieve the previous
history command
Up cursor key <↑> or
<Ctrl+P>
Retrieve the previous
history command, if there
is any.
Retrieve the next history
command
Down cursor key <↓> or
<Ctrl+N>
Retrieve the next history
command, if there is any.
Note:
Cursor keys can be used to retrieve the history commands in Windows 3.X Terminal
and Telnet. However, in Windows 9X HyperTerminal, the cursor keys ↑ and ↓ do not
work, because Windows 9X HyperTerminal defines the two keys differently. In this case,
use the combination keys <Ctrl+P> and <Ctrl+N> instead for the same purpose.
1.3.4 Common Command Line Error Messages
All the commands input by users can be correctly executed, if they have passed the
grammar check. Otherwise, error messages will appear. The common error messages
are listed in the following table.
Table 1-4 Common command line error messages
Error messages Causes
Cannot find the command.
Cannot find the keyword.
Wrong parameter type.
Unrecognized command
The value of the parameter exceeds the range.
Incomplete command The input command is incomplete.
Operation Manual – Command Line Interface
H3C S9500 Series Routing Switches Chapter 1 Command Line Interface
1-13
Error messages Causes
Too many parameters Enter too many parameters.
Ambiguous command The parameters entered are not specific.
1.3.5 Editing Characteristics of Command Line
Command line interface provides the basic command editing function and supports to
edit multiple lines. A command cannot be longer than 256 characters. See the table
below.
Table 1-5 Editing functions
Key Function
Common keys
Insert from the cursor position and the cursor
moves to the right, if the edition buffer still has
free space.
Backspace
Delete the character preceding the cursor and
the cursor moves backward.
Leftwards cursor key <←> or
<Ctrl+B>
Move the cursor a character backward
Rightwards cursor key <→> or
<Ctrl+F>
Move the cursor a character forward
Up cursor key <↑> or <Ctrl+P>
Down cursor key <↓> or
<Ctrl+N>
Retrieve the history command.
<Tab>
Pressing <Tab> after entering part of a keyword
enables the fuzzy help function. If finding a
unique match, the system substitutes the
complete keyword for the incomplete one and
displays it in the next line. If there are several
matches or no match at all, the system does not
modify the incomplete keyword and displays it
again in the next line.
/