TL-SL3428/TL-SL3452
JetStream L2 Managed Switch
REV1.2.2
1910010930
COPYRIGHT & TRADEMARKS
Specifications are subject to change without notice. is a registered trademark of
TP-LINK TECHNOLOGIES CO., LTD. Other brands and product names are trademarks or
registered trademarks of their respective holders.
No part of the specifications may be reproduced in any form or by any means or used to make any
derivative such as translation, transformation, or adaptation without permission from TP-LINK
TECHNOLOGIES CO., LTD. Copyright © 2013 TP-LINK TECHNOLOGIES CO., LTD. All rights
reserved.
http://www.tp-link.com
I
CONTENTS
Preface ………………………………………………………………………………….1
Chapter 1 Using the CLI ....................................................................................... 4
1.1 Accessing the CLI ...........................................................................................................4
1.1.1 Logon by a console port .......................................................................................4
1.1.2 Logon by Telnet ....................................................................................................6
1.2 CLI Command Modes ...................................................................................................10
1.3 Security Levels ............................................................................................................. 11
1.4 Conventions..................................................................................................................12
1.4.1 Format Conventions ........................................................................................... 12
1.4.2 Special Characters..............................................................................................12
1.4.3 Parameter Format...............................................................................................12
Chapter 2 User Interface .................................................................................... 14
enable....................................................................................................................................
enable password ...................................................................................................................14
disable ...................................................................................................................................
configure................................................................................................................................1
exit.........................................................................................................................................
end ........................................................................................................................................
14
15
5
15
16
Chapter 3 IEEE 802.1Q VLAN Commands ........................................................ 17
vlan........................................................................................................................................
interface vlan .........................................................................................................................17
name .....................................................................................................................................
switchport mode ....................................................................................................................19
switchport access vlan...........................................................................................................19
switchport trunk allowed vlan.................................................................................................20
switchport general allowed vlan.............................................................................................20
17
18
switchport pvid.......................................................................................................................21
show vlan summary............................................................................................................... 22
show vlan brief ......................................................................................................................22
show vlan ..............................................................................................................................23
Chapter 4 Protocol-based VLAN Commands ................................................... 24
protocol-vlan template ........................................................................................................... 24
protocol-vlan vlan ..................................................................................................................25
II
protocol-vlan..........................................................................................................................25
show protocol-vlan template..................................................................................................26
show protocol-vlan vlan .........................................................................................................26
show protocol-vlan interface..................................................................................................27
Chapter 5 Voice VLAN Commands.................................................................... 28
voice vlan ..............................................................................................................................28
voice vlan aging time.............................................................................................................28
voice vlan mac-address.........................................................................................................29
switchport voice vlan mode ...................................................................................................30
show voice vlan .....................................................................................................................30
show voice vlan oui ...............................................................................................................31
show voice vlan switchport ....................................................................................................31
Chapter 6 GVRP Commands.............................................................................. 33
gvrp (global) ..........................................................................................................................33
gvrp (interface) ......................................................................................................................33
gvrp registration.....................................................................................................................34
gvrp timer ..............................................................................................................................35
show gvrp global ...................................................................................................................36
show gvrp interface ...............................................................................................................36
Chapter 7 Etherchannel Commands ................................................................. 37
channel-group .......................................................................................................................37
port-channel load-balance .....................................................................................................38
lacp system-priority ...............................................................................................................38
lacp port-priority.....................................................................................................................39
show etherchannel ................................................................................................................39
show etherchannel load-balance...........................................................................................40
show lacp ..............................................................................................................................40
show lacp sys-id ....................................................................................................................41
Chapter 8 User Manage Commands.................................................................. 42
user name .............................................................................................................................42
user access-control ip-based.................................................................................................43
user access-control mac-based.............................................................................................43
user access-control port-based .............................................................................................44
user max-number ..................................................................................................................45
user idle-timeout....................................................................................................................45
III
line.........................................................................................................................................46
password ...............................................................................................................................47
login.......................................................................................................................................
login local ..............................................................................................................................48
show user account-list...........................................................................................................49
show user configuration.........................................................................................................49
47
Chapter 9 Binding Table Commands................................................................. 50
ip source binding ...................................................................................................................50
ip dhcp snooping ...................................................................................................................51
ip dhcp snooping global.........................................................................................................52
ip dhcp snooping information option......................................................................................53
ip dhcp snooping information strategy ...................................................................................53
ip dhcp snooping information remote-id.................................................................................54
ip dhcp snooping information circuit-id ..................................................................................54
ip dhcp snooping trust ...........................................................................................................55
ip dhcp snooping mac-verify..................................................................................................56
ip dhcp snooping limit rate.....................................................................................................56
ip dhcp snooping decline .......................................................................................................57
show ip source binding..........................................................................................................58
show ip dhcp snooping ..........................................................................................................58
show ip dhcp snooping information .......................................................................................58
show ip dhcp snooping interface ...........................................................................................59
Chapter 10 ARP Inspection Commands.............................................................. 60
ip arp inspection(global) ........................................................................................................60
ip arp inspection trust ............................................................................................................60
ip arp inspection(interface) .................................................................................................... 61
ip arp inspection limit-rate......................................................................................................62
ip arp inspection recover .......................................................................................................62
show ip arp inspection...........................................................................................................63
show ip arp inspection interface ............................................................................................63
show ip arp inspection statistics ............................................................................................64
clear ip arp inspection statistics.............................................................................................64
Chapter 11 DoS Defend Command...................................................................... 65
ip dos-prevent........................................................................................................................ 65
ip dos-prevent type................................................................................................................65
show ip dos-prevent ..............................................................................................................66
IV
Chapter 12 IEEE 802.1X Commands ................................................................... 67
dot1x system-auth-control ..................................................................................................... 67
dot1x auth-method ................................................................................................................67
dot1x guest-vlan(global) ........................................................................................................68
dot1x quiet-period.................................................................................................................. 69
dot1x timeout.........................................................................................................................69
dot1x max-reauth-req ............................................................................................................ 70
dot1x......................................................................................................................................
dot1x guest-vlan(interface) ....................................................................................................71
dot1x port-control ..................................................................................................................72
dot1x port-method .................................................................................................................73
radius.....................................................................................................................................
radius server-account ............................................................................................................74
show dot1x global.................................................................................................................. 75
show dot1x interface .............................................................................................................75
show radius accounting.........................................................................................................76
show radius authentication ....................................................................................................76
71
73
Chapter 13 System Log Commands.................................................................... 77
logging buffer.........................................................................................................................77
logging file flash.....................................................................................................................78
clear logging ..........................................................................................................................78
logging host index .................................................................................................................79
show logging local-config ......................................................................................................80
show logging loghost.............................................................................................................80
show logging buffer ...............................................................................................................81
show logging flash.................................................................................................................81
Chapter 14 SSH Commands................................................................................. 83
ip ssh server ..........................................................................................................................83
ip ssh version ........................................................................................................................83
ip ssh timeout ........................................................................................................................84
ip ssh max-client....................................................................................................................84
ip ssh download.....................................................................................................................85
show ip ssh............................................................................................................................85
Chapter 15 SSL Commands ................................................................................. 87
ip http secure-server..............................................................................................................87
V
ip http secure-server download certificate ............................................................................. 87
ip http secure-server download key.......................................................................................88
show ip http secure-server ....................................................................................................89
Chapter 16 MAC Address Commands................................................................. 90
mac address-table static........................................................................................................90
mac address-table aging-time ...............................................................................................91
mac address-table filtering ....................................................................................................91
mac address-table max-mac-count .......................................................................................92
show mac address-table address..........................................................................................93
show mac address-table aging-time......................................................................................94
show mac address-table max-mac-count interface ...............................................................94
show mac address-table interface.........................................................................................95
show mac address-table mac-num........................................................................................ 95
show mac address-table mac................................................................................................95
show mac address-table vlan ................................................................................................96
Chapter 17 System Configuration Commands................................................... 97
system-time manual ..............................................................................................................97
system-time ntp .....................................................................................................................97
system-time dst predefined ...................................................................................................99
system-time dst date .............................................................................................................99
system-time dst recurring .................................................................................................... 101
hostname.............................................................................................................................102
location ................................................................................................................................
contact-info..........................................................................................................................103
ip management-vlan ............................................................................................................103
ip address............................................................................................................................104
ip address-alloc dhcp ..........................................................................................................104
ip address-alloc bootp .........................................................................................................105
reset ....................................................................................................................................
102
105
reboot ..................................................................................................................................
copy running-config startup-config ......................................................................................106
copy startup-config tftp ........................................................................................................ 107
copy tftp startup-config ........................................................................................................ 107
firmware upgrade ................................................................................................................108
ping .....................................................................................................................................
tracert ..................................................................................................................................
VI
106
108
109
loopback interface ............................................................................................................... 110
show system-time................................................................................................................ 110
show system-time dst.......................................................................................................... 111
show system-time ntp.......................................................................................................... 111
show system-info................................................................................................................. 112
show running-config ............................................................................................................112
show cable-diagnostics interface......................................................................................... 112
Chapter 18 Ethernet Configuration Commands ................................................114
interface fastEthernet ..........................................................................................................114
interface range fastEthernet ................................................................................................ 114
interface gigabitEthernet...................................................................................................... 115
interface range gigabitEthernet ........................................................................................... 115
description ........................................................................................................................... 116
shutdown ............................................................................................................................. 117
flow-control .......................................................................................................................... 117
media-type........................................................................................................................... 118
duplex..................................................................................................................................
speed...................................................................................................................................
storm-control broadcast.......................................................................................................119
storm-control multicast ........................................................................................................120
storm-control unicast ...........................................................................................................120
storm-control rate ................................................................................................................121
bandwidth ............................................................................................................................122
clear counters......................................................................................................................123
show interface status........................................................................................................... 123
show interface counters.......................................................................................................124
show interface description ...................................................................................................124
show interface flowcontrol ................................................................................................... 125
show interface configuration................................................................................................125
show storm-control ..............................................................................................................126
118
119
show bandwidth................................................................................................................... 126
Chapter 19 QoS Commands................................................................................128
qos ......................................................................................................................................
qos cos................................................................................................................................
qos dscp..............................................................................................................................129
qos queue cos-map.............................................................................................................130
VII
128
128
qos queue dscp-map...........................................................................................................130
qos queue mode.................................................................................................................. 131
show qos interface ..............................................................................................................132
show qos cos-map ..............................................................................................................133
show qos dscp-map ............................................................................................................133
show qos queue mode ........................................................................................................134
show qos status...................................................................................................................134
Chapter 20 Port Mirror Commands ....................................................................135
monitor session destination interface ..................................................................................135
monitor session source interface.........................................................................................136
show monitor session..........................................................................................................137
Chapter 21 Port isolation Commands ................................................................138
port isolation ........................................................................................................................138
show port isolation............................................................................................................... 139
Chapter 22 Loopback Detection Commands.....................................................140
loopback-detection(global) ..................................................................................................140
loopback-detection interval..................................................................................................140
loopback-detection recovery-time........................................................................................ 141
loopback-detection(interface) ..............................................................................................141
loopback-detection config....................................................................................................142
loopback-detection recover .................................................................................................143
show loopback-detection global ..........................................................................................143
show loopback-detection interface ......................................................................................144
Chapter 23 ACL Commands................................................................................145
time-range ...........................................................................................................................145
absolute...............................................................................................................................145
periodic................................................................................................................................
146
holiday.................................................................................................................................
holiday(global) .....................................................................................................................147
access-list create.................................................................................................................148
mac access-list....................................................................................................................148
access-list standard............................................................................................................. 149
access-list extended............................................................................................................150
rule ......................................................................................................................................
access-list policy name........................................................................................................153
VIII
147
152
access-list policy action.......................................................................................................153
redirect interface..................................................................................................................154
s-condition ...........................................................................................................................154
s-mirror ................................................................................................................................
access-list bind(interface)....................................................................................................156
access-list bind(vlan) ...........................................................................................................156
show time-range..................................................................................................................157
show holiday........................................................................................................................157
show access-list ..................................................................................................................157
show access-list policy ........................................................................................................158
show access-list bind ..........................................................................................................158
155
Chapter 24 MSTP Commands.............................................................................160
spanning-tree(global)...........................................................................................................160
spanning-tree(interface) ......................................................................................................160
spanning-tree common-config .............................................................................................161
spanning-tree mode.............................................................................................................162
spanning-tree mst configuration ..........................................................................................163
instance ...............................................................................................................................163
name ...................................................................................................................................
revision ................................................................................................................................
spanning-tree mst instance .................................................................................................165
spanning-tree mst................................................................................................................ 166
spanning-tree priority........................................................................................................... 166
spanning-tree tc-defend.......................................................................................................167
spanning-tree timer..............................................................................................................168
spanning-tree hold-count.....................................................................................................168
spanning-tree max-hops......................................................................................................169
spanning-tree bpdufilter.......................................................................................................170
spanning-tree bpduguard ....................................................................................................170
spanning-tree guard loop.....................................................................................................171
spanning-tree guard root .....................................................................................................171
spanning-tree guard tc.........................................................................................................173
spanning-tree mcheck ......................................................................................................... 173
show spanning-tree active...................................................................................................174
164
164
show spanning-tree bridge ..................................................................................................174
show spanning-tree interface ..............................................................................................175
show spanning-tree interface-security.................................................................................175
IX
show spanning-tree mst ......................................................................................................176
Chapter 25 IGMP Commands..............................................................................177
ip igmp snooping(global) .....................................................................................................177
ip igmp snooping(interface) ................................................................................................. 177
ip igmp snooping immediate-leave ......................................................................................178
ip igmp snooping drop-unknown.......................................................................................... 178
ip igmp snooping vlan-config ...............................................................................................179
ip igmp snooping multi-vlan-config ......................................................................................180
ip igmp snooping filter add-id...............................................................................................181
ip igmp snooping filter(global)..............................................................................................182
ip igmp snooping filter(interface) .........................................................................................182
ip igmp snooping filter maxgroup......................................................................................... 183
ip igmp snooping filter mode................................................................................................183
show ip igmp snooping........................................................................................................184
show ip igmp snooping interface .........................................................................................184
show ip igmp snooping vlan ................................................................................................185
show ip igmp snooping multi-vlan........................................................................................ 186
show ip igmp snooping groups ............................................................................................186
show ip igmp snooping filter ................................................................................................ 187
Chapter 26 SNMP Commands.............................................................................188
snmp-server ........................................................................................................................188
snmp-server view ................................................................................................................188
snmp-server group ..............................................................................................................189
snmp-server user ................................................................................................................190
snmp-server community ...................................................................................................... 192
snmp-server host................................................................................................................. 193
snmp-server engineID ......................................................................................................... 194
snmp-server traps snmp...................................................................................................... 195
snmp-server traps link-status...............................................................................................196
snmp-server traps................................................................................................................196
snmp-server traps mac........................................................................................................ 197
snmp-server traps vlan........................................................................................................198
rmon history.........................................................................................................................199
rmon event ..........................................................................................................................199
rmon alarm ..........................................................................................................................200
show snmp-server ...............................................................................................................202
X
show snmp-server view .......................................................................................................202
show snmp-server group .....................................................................................................203
show snmp-server user ....................................................................................................... 203
show snmp-server community.............................................................................................204
show snmp-server host .......................................................................................................204
show snmp-server engineID................................................................................................204
show rmon history ...............................................................................................................205
show rmon event .................................................................................................................205
show rmon alarm.................................................................................................................206
Chapter 27 LLDP Commands..............................................................................207
lldp.......................................................................................................................................
lldp hold-multiplier................................................................................................................207
lldp timer..............................................................................................................................208
lldp receive ..........................................................................................................................209
lldp transmit .........................................................................................................................209
lldp snmp-trap......................................................................................................................210
lldp tlv-select........................................................................................................................ 211
show lldp .............................................................................................................................211
show lldp interface............................................................................................................... 213
show lldp local-information interface....................................................................................213
show lldp neighbor-information interface .............................................................................214
show lldp traffic interface .....................................................................................................214
207
Chapter 28 Cluster Commands...........................................................................216
cluster ndp...........................................................................................................................216
cluster ntdp..........................................................................................................................217
cluster explore .....................................................................................................................218
cluster..................................................................................................................................
cluster candidate .................................................................................................................219
cluster individual..................................................................................................................219
show cluster ndp..................................................................................................................220
show cluster neighbour........................................................................................................220
show cluster ntdp.................................................................................................................221
show cluster ........................................................................................................................221
show cluster manage role....................................................................................................222
XI
218
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Preface
This Guide is intended for network administrator to provide referenced information about CLI
(Command Line Interface). The device mentioned in this Guide stands for TL-SL3428/TL-SL3452
JetStream L2 Managed Switch.
The two devices of TL-SL3428 and TL-SL3452 are sharing this User Guide. For simplicity, we will
take TL-SL3428 for example throughout the configuration chapters. TL-SL3428 and TL-SL3452
just differ in the number of LED indicators and ports and all figures in this guide are of TL-SL3428.
Overview of this Guide
Chapter 1: Using the CLI
Provide information about how to use the CLI, CLI Command Modes, Security Levels and some
Conventions.
Chapter 2: User Interface
Provide information about the commands used to switch between five CLI Command Modes.
Chapter 3: IEEE 802.1Q VLAN Commands
Provide information about the commands used for configuring IEEE 802.1Q VLAN.
Chapter 4: Protocol-based VLAN Commands
Provide information about the commands used for configuring Protocol-based VLAN.
Chapter 5: Voice VLAN Commands
Provide information about the commands used for configuring Voice VLAN.
Chapter 6: GVRP Commands
Provide information about the commands used for configuring GVRP (GARP VLAN registration
protocol).
Chapter 7: EtherChannel Commands
Provide information about the commands used for configuring LAG (Link Aggregation Group) and
LACP (Link Aggregation Control Protocol).
Chapter 8: User Manage Commands
Provide information about the commands used for user management.
Chapter 9: Binding Table Commands
Provide information about the commands used for binding the IP address, MAC address, VLAN
and the connected Port number of the Host together. Besides it also provide information about the
commands used for monitoring the process of the Host obtaining the IP address from DHCP
1
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
server, and record the IP address, MAC address, VLAN and the connected Port number of the
Host for automatic binding.
Chapter 10: ARP Inspection Commands
Provide information about the commands used for protecting the switch from the ARP cheating or
ARP Attack.
Chapter 11: DoS Defend Command
Provide information about the commands used for DoS defend and detecting the DoS attack.
Chapter 12: IEEE 802.1X Commands
Provide information about the commands used for configuring IEEE 802.1X function.
Chapter 13: System Log Commands
Provide information about the commands used for configuring system log.
Chapter 14: SSH Commands
Provide information about the commands used for configuring and managing SSH (Security
Shell).
Chapter 15: SSL Commands
Provide information about the commands used for configuring and managing SSL (Secure
Sockets Layer).
Chapter 16: MAC Address Commands
Provide information about the commands used for MAC Address configuration.
Chapter 17: System Configuration Commands
Provide information about the commands used for configuring the System information and System
IP, reboot and reset the switch, upgrade the switch system and commands used for device
diagnose, including loopback test and cable test.
Chapter 18: Ethernet Configuration Commands
Provide information about the commands used for configuring the Bandwidth Control, Negotiation
Mode, and Storm Control for ethernet ports.
Chapter 19: QoS Commands
Provide information about the commands used for configuring the QoS function.
Chapter 20: Port Mirror Commands
Provide information about the commands used for configuring the Port Mirror function.
Chapter 21: Port Isolation Commands
Provide information about the commands used for configuring the Port isolation function.
Chapter 22: Loopback Detection Commands
Provide information about the commands used for loopback detection.
2
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Chapter 23: ACL Commands
Provide information about the commands used for configuring the ACL (Access Control List).
Chapter 24: MSTP Commands
Provide information about the commands used for configuring the MSTP (Multiple Spanning Tree
Protocol).
Chapter 25: IGMP Commands
Provide information about the commands used for configuring the IGMP Snooping (Internet Group
Management Protocol Snooping).
Chapter 26: SNMP Commands
Provide information about the commands used for configuring the SNMP (Simple Network
Management Protocol) functions.
Chapter 27: LLDP Commands
Provide information about the commands used for configuring the LLDP functions.
Chapter 28: Cluster Commands
Provide information about the commands used for configuring the Cluster Management function.
3
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Chapter 1 Using the CLI
1.1 Accessing the CLI
You can log on to the switch and access the CLI by the following two methods:
1. Log on to the switch by the console port on the switch.
2. Log on to the switch remotely by a Telnet or SSH connection through an Ethernet port.
1.1.1 Logon by a console port
To log on to the switch by the console port on the switch, please take the following steps:
1. Connect the PCs or Terminals to the console port on the switch by a provided cable.
2. Click Start →
open the Hyper Terminal as the Figure 1-1 shown.
All Programs → Accessories→ Communications → Hyper Terminal to
Figure 1-1 Open
3. The Connection Description Window will prompt as Figure 1-2. Enter a name into the
Name field and click OK.
Hyper Terminal
4
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Figure 1-2 Connection Description
4. Select the port to connect in Figure 1-3, and click OK.
Figure 1-3 Select the port to connect
5. Configure the port selected in the step above as the following Figure 1-4 shown. Configure
Bit
s per second as 38400, Data bits as 8, Parity as None, Stop bits as 1, Flow control as
None, and then click OK.
Figure 1-4 Port Settings
5
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
6. The DOS prompt” TL-SL3428>” will appear after pressing the Enter button as Figure 1-5
shown. It indicates
that you can use the CLI now.
Figure 1-5 Log in the Switch
1.1.2 Logon by Telnet
To successfully create Telnet connection, firstly CLI commands about configuring Telnet login
mode, login authentication information and Privileged EXEC Mode password should be configured
through Console connection.
Telnet login has the following two modes, you can choose one according to your needs:
Login Local Mode: It requires username and password, which are both admin by default.
Login Mode: It requires no username and password, but a connection password is required.
Note:
1. Before Telnet login, you are required to configure Telnet login mode and login
authentication information through Console connection. The relevant CLI commands
should be entered in the prompted DOS screen shown in Figure 1-5 Log in the Switch.
You will enter to User EXEC Mode after Telnet connection is successfully created, but for
2.
switch security concerns, you are required to set a password which functions to further
access to Privileged EXEC Mode when you configure the login mode.
Login Local Mode:
Firstly, configure the Telnet login mode as “login local” and set the password for entering into the
Privileged EXEC Mode as 123 in the prompted DOS screen shown in Figure 1-5.
Figure 1-6 Configure login local mode
6
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Now, you can logon by Telnet in login local mode.
1. Make sure the switch and the PC are in the same LAN. Click Start → Run to open the Run
window and type cmd in the prompt Run window as Figure 1-7 and click OK.
Figure 1-7 Run Window
2. Open Telnet, then type telnet 192.168.0.1 in the command prompt shown as Figure 1-8, and
press the En
ter button.
Figure 1-8 Connecting to the Switch
3. Type the default user name and password admin/admin, then press the Enter button so as
to enter User EXEC Mode.
Figure 1-9 Enter into the User EXEC Mode
Now you can manage your switch with CLI commands through Telnet connection.
7
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
4. Type enable command to enter Privileged EXEC Mode. A password that you have set
through Console port connection is required. Here the password is set as 123.
Figure 1-10 Enter to the Privileged EXEC Mode
Login Mode:
Firstly configure the Telnet login mode as “login”, and both the connection password and the
Privileged EXEC Mode password as 123 in the prompted DOS screen shown in Figure 1-11.
Figure 1-11 Configure login mode
Now, you can logon by Telnet in login mode:
1. Open Telnet, then type telnet 192.168.0.1 in the command prompt shown as Figure 1-12, and
press the En
ter button.
8
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Figure 1-12 Connecting to the Switch
2. You are prompted to enter the connection password 123 you have set through Console port
connection, and then you are in User EXEC Mode.
Figure 1-13 Enter into the User EXEC Mode
3. When entering enable command to access Privileged EXEC Mode, you are required to give
the password 123 you have set through Console port connection.
Figure 1-14 Enter into the Privileged EXEC Mode
Now you can manage your switch with CLI commands through Telnet connection.
Note:
You can refer to Chapter 11 User Manage Commands
Telnet connection configuration.
9
for detailed commands information of the
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
1.2 CLI Command Modes
The CLI is divided into different command modes: User EXEC Mode, Privileged EXEC Mode,
Global Configuration Mode, Interface Configuration Mode and VLAN Configuration Mode.
Interface Configuration Mode can also be divided into Interface fastEthernet, Interface
gigabitEthernet, Interface link-aggregation and some other modes, which is shown as the following
diagram.
The following table gives detailed information about the Accessing path, Prompt of each mode and
how to exit the current mode and access the next mode.
Mode Accessing Path Prompt Logout or Access the next mode
Use the exit command to disconnect the
User EXEC
Mode
Primary mode once it is
connected with the
switch.
TL-SL3428>
switch (except that the switch is
connected through the Console port).
Use the enable command to access
Privileged EXEC mode.
Privileged
EXEC Mode
Global
Configuration
Mode
Interface
Configuration
Mode
Use the enable
command to enter this
mode from User EXEC
mode.
Use the configure
command to enter this
mode from Privileged
EXEC mode.
Use the interface
fastEthernet/gigabitEth
ernet port or interface
range fastEthernet/
gigabitEthernet port-list
command to enter this
mode from Global
Configuration mode.
TL-SL3428 #
TL-SL3428(config)#
TL-SL3428(config-if)#
TL-SL3428(config-if-
range)#
Enter the disable or the exit command to
return to User EXEC mode.
Enter configure command to access
Global Configuration mode.
Use the exit or the end command or
press Ctrl+Z to return to Privileged
EXEC mode.
Use the interface fastEthernet/
gigabitEthernet port or interface range
fastEthernet/gigabitEthernet port-list
command to access interface
Configuration mode.
Use the vlan vlan-list to access VLAN
Configuration mode.
Use the end command or press Ctrl+Z to
return to Privileged EXEC mode.
Enter exit or # command to return to
Global Configuration mode.
A port number must be specified in the
interface command.
10
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Mode Accessing Path Prompt Logout or Access the next mode
VLAN
Configuration
Mode
Use the vlan vlan-list
command to enter this
mode from Global
Configuration mode.
TL-SL3428(config-
vlan)#
Use the end command or press Ctrl+Z to
return to Privileged EXEC mode.
Enter the exit or # command to return to
Global configuration mode.
Note:
1. The user is automatically in User EXEC Mode after the connection between the PC and the
switch is established by a console port or by a telnet connection.
2. Each command mode has its own set of specific commands. To configure some commands,
you should access the corresponding command mode firstly.
Global Configuration Mode: In this mode, global commands are provided, such as the
Spanning Tree, Schedule Mode and so on.
Interface Configuration Mode: In this mode, users can configure one or several ports.
Different ports correspond to different commands
a). Interface fastEthernet/gigabitEthernet: Configure parameters for a Fast/Gigabit
Ethernet port, such as Duplex-mode, flow control status.
b). Interface range fastEthernet/gigabitEthernet: Configure parameters for several
Ethernet ports.
c). Interface link-aggregation: Configure parameters for a link-aggregation, such as
broadcast storm.
d). Interface range link-aggregation: Configure parameters for multi-trunks.
e). Interface vlan: Configure parameters for the vlan-port.
Vlan Configuration Mode: In this mode, users can create a VLAN and add a specified
port to the VLAN.
3. Some commands are global, that means they can be performed in all modes:
show: Displays all information of switch, for example: statistic information, port
information, VLAN information.
history: Displays the commands history.
1.3 Security Levels
This switch’s security is divided into two levels: User level and Admin level.
11
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
User level only allows users to do some simple operations in User EXEC Mode; Admin level
allows you to monitor, configure and manage the switch in Privileged EXEC Mode, Global
Configuration Mode, Interface Configuration Mode and VLAN Configuration Mode.
Users get the privilege to the User level once connecting console port with the switch or logging in
by Telnet. However, Guest users are restricted to access the CLI.
Users can enter Privileged EXEC mode from User EXEC mode by using the enable command. In
default case, no password is needed. In Global Configuration Mode, you can configure password
for Admin level by enable password command. Once password is configured, you are required to
enter it to access Privileged EXEC mode.
1.4 Conventions
1.4.1 Format Conventions
The following conventions are used in this Guide:
Items in square brackets [ ] are optional
Items in braces { } are required
Alternative items are grouped in braces and separated by vertical bars. For example: speed
{10 | 100 | 1000 }
Bold indicates an unalterable keyword. For example: show logging
Normal Font indicates a constant (several options are enumerated and only one can be
selected). For example: switchport type { access | trunk | general }
Italic Font indicates a variable (an actual value must be assigned). For example: bridge
aging-time aging-time
1.4.2 Special Characters
You should pay attentions to the description below if the variable is a character string:
These six characters ” < > , \ & can not be input.
If a blank is contained in a character string, single or double quotation marks should be used,
for example ’hello world’, ”hello world”, and the words in the quotation marks will be identified
as a string. Otherwise, the words will be identified as several strings.
1.4.3 Parameter Format
Some parameters must be entered in special formats which are shown as follows:
12
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
MAC Address must be enter in the format of xx:xx:xx:xx:xx:xx
One or several values can be typed for a port-list or a vlan-list using comma to separate. Use
a hyphen to designate a range of values, for instance, 1,3-5,7 indicates choosing 1,3,4,5,and
7.
The port number must enter in the format of 1/0/3, meaning unit/slot/port. The unit number is
always 1, and slot number is always 0 and the port number is a variable (an actual value must
be assigned).
13
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Chapter 2 User Interface
enable
Description
The enable command is used to access Privileged EXEC Mode from User
EXEC Mode.
Syntax
enable
Command Mode
User EXEC Mode
Example
If you have set the password to access Privileged EXEC Mode from User EXEC
Mode:
TL-SL3428>enable
Enter password：
TL-SL3428#
enable password
Description
The enable password command is used to set the password for users to
access Privileged EXEC Mode from User EXEC Mode. To return to the default
configuration, please use no enable password command.
Syntax
enable password password
no enable password
Parameter
password —— super password ， which contains 16 characters at most,
composing digits, English letters and underlines only. By default, it is empty.
Command Mode
Global Configuration Mode
Example
Set the super password as “admin” to access Privileged EXEC Mode from User
EXEC Mode:
TL-SL3428(config)#enable password admin
14
disable
Description
Syntax
Command Mode
Example
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
The disable command is used to return to User EXEC Mode from Privileged
EXEC Mode.
disable
Privileged EXEC Mode
Return to User EXEC Mode from Privileged EXEC Mode:
TL-SL3428#disable
TL-SL3428>
configure
Description
Syntax
Command Mode
Example
The configure command is used to access Global Configuration Mode from
Privileged EXEC Mode.
configure
Privileged EXEC Mode
Access Global Configuration Mode from Privileged EXEC Mode:
TL-SL3428#configure
TL-SL3428(config)#
exit
Description
The exit command is used to return to the previous Mode from the current
Mode.
15
end
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Syntax
exit
Command Mode
Any Configuration Mode
Example
Return to Global Configuration Mode from Interface Configuration Mode, and
then return to Privileged EXEC Mode:
TL-SL3428(config-if)#exit
TL-SL3428(config)#exit
TL-SL3428#
Description
The end command is used to return to Privileged EXEC Mode.
Syntax
end
Command Mode
Any Configuration Mode
Example
Return to Privileged EXEC Mode from Interface Configuration Mode:
TL-SL3428(config-if)#end
TL-SL3428#
16
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Chapter 3 IEEE 802.1Q VLAN Commands
VLAN (Virtual Local Area Network) technology is developed for the switch to divide the LAN into
multiple logical LANs flexibly. Hosts in the same VLAN can communicate with each other,
regardless of their physical locations. VLAN can enhance performance by conserving bandwidth,
and improve security by limiting traffic to specific domains.
vlan
Description
The vlan command is used to create IEEE 802.1Q VLAN hereafter to access to
VLAN Configuration Mode. To delete the IEEE 802.1Q VLAN, please use no
vlan command.
Syntax
vlan vlan-list
no vlan vlan-list
Parameter
vlan-list —— VLAN ID list, ranging from 2 to 4094, in the format of 2-3, 5. It is
multi-optional.
Command Mode
Global Configuration Mode
Example
Create VLAN 2-10 and VLAN 100:
TL-SL3428(config)#vlan 2-10,100
Delete VLAN 2:
TL-SL3428(config)#no vlan 2
interface vlan
Description
The interface vlan command is used to create VLAN Interface hereafter to
access to Interface VLAN Mode.
17
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Syntax
interface vlan vlan-id
no interface vlan vlan-id
Parameter
vlan-id —— Specify IEEE 802.1Q VLAN ID, ranging from 1 to 4094.
Command Mode
Global Configuration Mode
Example
Create VLAN Interface 2:
TL-SL3428(config)#interface vlan 2
name
Description
Syntax
Parameter
Command Mode
The name command is used to assign a description string to a VLAN. To clear
the description, please use no name command.
name descript
no name
descript —— String to describe the VLAN, which contains 16 characters at
most.
VLAN Configuration Mode（VLAN）
Example
Specify the description string of the VLAN 2 as “VLAN002”:
TL-SL3428(config)#vlan 2
TL-SL3428(config-vlan)#name VLAN002
18
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
switchport mode
Description
The switchport mode command is used to configure the Link Types for the
ports.
Syntax
switchport mode { access | trunk | general }
Parameter
access | trunk | general —— Link Types. There are three Link Types for the
ports.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
Example
Specify the Link Type of Fast Ethernet port 3 as “trunk”:
TL-SL3428(config)#interface fastEthernet 1/0/3
TL-SL3428(config-if)#switchport mode trunk
switchport access vlan
Description
The switchport access vlan command is used to add the desired Access port
to IEEE 802.1Q VLAN, or to remove a port from the corresponding VLAN.
Syntax
switchport access vlan vlan-id
no switchport access vlan
Parameter
vlan-id —— Specify IEEE 802.1Q VLAN ID, ranging from 2 to 4094.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
19
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Example
Configure Fast Ethernet port 3 whose link type is “access” to VLAN 2:
TL-SL3428(config)#interface fastEthernet 1/0/3
TL-SL3428(config-if)#switchport access vlan 2
switchport trunk allowed vlan
Description
The switchport trunk allowed vlan command is used to add the desired Trunk
port to IEEE 802.1Q VLAN, or to remove a port from the corresponding VLAN.
Syntax
switchport trunk allowed vlan vlan-list
no switchport trunk allowed vlan vlan-list
Parameter
vlan-list —— VLAN ID list, ranging from 2 to 4094, in the format of 2-3, 5. It is
multi-optional.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
Example
Configure Fast Ethernet port 2 whose link type is “trunk” to VLAN 2:
TL-SL3428(config)#interface fastEthernet 1/0/2
TL-SL3428(config-if)#switchport mode trunk
TL-SL3428(config-if)#switchport trunk allowed vlan 2
switchport general allowed vlan
Description
The switchport general allowed vlan command is used to add the desired
General port to IEEE 802.1Q VLAN, or to remove a port from the corresponding
VLAN.
20
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Syntax
switchport general allowed vlan vlan-list { tagged | untagged }
no switchport general allowed vlan vlan-list
Parameter
vlan-list —— VLAN ID list, ranging from 2 to 4094, in the format of 2-3, 5. It is
multi-optional.
tagged | untagged —— egress-rule.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
Example
Configure Fast Ethernet port 4 whose link type is “general” to VLAN 2 and its
egress-rule as “tagged”:
TL-SL3428(config)#interface fastEthernet 1/0/4
TL-SL3428(config-if)#switchport mode general
TL-SL3428(config-if)#switchport general allowed vlan 2 tagged
switchport pvid
Description
The switchport pvid command is used to configure the PVID for the switch
ports.
Syntax
switchport pvid vlan-id
Parameter
vlan-id —— Specify IEEE 802.1Q VLAN ID, ranging from 1 to 4094.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
21
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Example
Specify the PVID of Fast Ethernet port 3 as 1:
TL-SL3428(config)#interface fastEthernet 1/0/3
TL-SL3428(config-if)#switchport pvid 1
show vlan summary
Description
The show vlan summary command is used to display the summarized
information of IEEE 802.1Q VLAN.
Syntax
show vlan summary
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the summarized information of IEEE 802.1Q VLAN:
TL-SL3428(config)#show vlan summary
show vlan brief
Description
The show vlan brief command is used to display the brief information of IEEE
802.1Q VLAN.
Syntax
show vlan brief
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the brief information of IEEE 802.1Q VLAN:
TL-SL3428(config)#show vlan brief
22
show vlan
Description
Syntax
Parameter
Command Mode
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
The show vlan command is used to display the detailed information of IEEE
802.1Q VLAN.
show vlan [id vlan-list]
vlan-list —— Specify IEEE 802.1Q VLAN ID, ranging from 1 to 4094. Using the
show vlan command without parameter displays the detailed information of all
VLANs.
Privileged EXEC Mode and Any Configuration Mode
Example
Display the detailed information of VLAN 2-10:
TL-SL3428(config)#show vlan id 2-10
23
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Chapter 4 Protocol-based VLAN Commands
Protocol VLAN (Virtual Local Area Network) is the way to classify VLANs based on Protocols. A
Protocol is relative to a single VLAN ID. The untagged packets and the priority-tagged packets
matching the protocol template will be tagged with this VLAN ID.
protocol-vlan template
Description
The protocol-vlan template command is used to create Protocol-based VLAN
template. To delete Protocol-based VLAN template, please use no
protocol-vlan template command.
Syntax
protocol-vlan template name protocol-name ether-type type
no protocol-vlan template template-idx
Parameter
protocol-name —— Give a name for the Protocol-based VLAN Template ,
which contains 8 characters at most.
type —— Enter the Ethernet protocol type field in the protocol template,
composing of 4 Hex integers.
template-idx —— The number of the Protocol-based VLAN Template. You can
get the template corresponding to the number by the show protocol-vlan
template command.
Command Mode
Global Configuration Mode
Example
Create a Protocol-based VLAN template named “TP” whose Ethernet protocol
type is 0x2024:
TL-SL3428(config)#protocol-vlan template name TP ether-type 2024
24
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
protocol-vlan vlan
Description
The protocol-vlan vlan command is used to create a Protocol-based VLAN
entry. To delete a Protocol-based VLAN entry, please use no protocol-vlan
vlan command.
Syntax
protocol-vlan vlan vlan-id template template-idx
no protocol-vlan vlan group-idx
Parameter
vlan-vid —— Specify IEEE 802.1Q VLAN ID, ranging from 1-4094.
template-idx ——The number of the Protocol-based VLAN Template. You can
get the template corresponding to the number by the show protocol-vlan
template command.
group-idx ——The number of the Protocol-based VLAN entry. You can get the
Protocol-based VLAN entry corresponding to the number by the show
protocol-vlan vlan command.
Command Mode
Global Configuration Mode
Example
Create Protocol-based VLAN 2 and bind it with Protocol-based VLAN Template 3:
TL-SL3428(config)#protocol-vlan vlan 2 template 3
protocol-vlan
Description
The protocol-vlan command is used to enable the Protocol-based VLAN
feature for a specified port. To disable the Protocol-based VLAN feature of this
port, please use no protocol-vlan command. By default, the Protocol-based
VLAN feature of all ports is disabled.
25
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Syntax
protocol-vlan
no protocol-vlan
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
Example
Enable the Protocol-based VLAN feature for the Gigabit Ethernet port 25:
TL-SL3428(config)#interface gigabitEthernet 1/0/25
TL-SL3428(config-if)#protocol-vlan
show protocol-vlan template
Description
The show protocol-vlan template command is used to display the information
of the Protocol-based VLAN templates.
Syntax
show protocol-vlan template
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the information of the Protocol-based VLAN templates:
TL-SL3428(config)#show protocol-vlan template
show protocol-vlan vlan
Description
The show protocol-vlan vlan command is used to display the information
about Protocol-based VLAN entry.
26
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Syntax
show protocol-vlan vlan
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display information of the Protocol-based VLAN entry:
TL-SL3428(config)#show protocol-vlan vlan
show protocol-vlan interface
Description
The show protocol-vlan interface command is used to display port state and
of Protocol-based VLAN interface.
Syntax
show protocol-vlan interface
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the port state and of Protocol-based VLAN interface:
TL-SL3428(config)#show protocol-vlan interface
27
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Chapter 5 Voice VLAN Commands
Voice VLANs are configured specially for voice data stream. By configuring Voice VLANs and
adding the ports with voice devices attached to voice VLANs, you can perform QoS-related
configuration for voice data, ensuring the transmission priority of voice data stream and voice
quality.
voice vlan
Description
The voice vlan command is used to enable Voice VLAN function. To disable
Voice VLAN function, please use no voice vlan command.
Syntax
voice vlan vlan-id
no voice vlan
Parameter
vlan-id —— Specify IEEE 802.1Q VLAN ID, ranging from 2 to 4094.
Command Mode
Global Configuration Mode
Example
Enable the Voice VLAN function for VLAN 10:
TL-SL3428(config)#voice vlan 10
voice vlan aging time
Description
The voice vlan aging time command is used to set the aging time for a voice
VLAN. To restore to the default aging time for the Voice VLAN, please use no
voice vlan aging time command. By default, the aging time is 1440 minutes.
28
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Syntax
voice vlan aging time time
no voice vlan aging time
Parameter
time —— Aging time (in minutes) to be set for the Voice VLAN. It ranges from 1
to 43200.
Command Mode
Global Configuration Mode
Example
Set the aging time for the Voice VLAN as 1 minute:
TL-SL3428(config)#voice vlan aging time 1
voice vlan mac-address
Description
The voice vlan mac-address command is used to create Voice VLAN OUI. To
delete the specified Voice VLAN OUI, please use no voice vlan mac-address
command.
Syntax
voice vlan mac-address mac-addr mask mask [description descript]
no voice vlan mac-address mac-addr
Parameter
mac-addr —— The OUI address of the voice device, in the format of
XX:XX:XX:XX:XX:XX.
mask —— The OUI address mask of the voice device, in the format of
XX:XX:XX:XX:XX:XX.
descript —— Give a description to the OUI for identification which contains 16
characters at most.
Command Mode
Global Configuration Mode
29
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Example
Create a Voice VLAN OUI described as “TP-Phone” with the OUI address
00:11:11:11:11:11 and the mask address FF:FF:FF:00:00:00:
TL-SL3428(config)#voice vlan mac-address 00:11:11:11:11:11 mask
FF:FF:FF:00:00:00 description TP- Phone
switchport voice vlan mode
Description
The switchport voice vlan mode command is used to configure the Voice
VLAN mode for the Ethernet port.
Syntax
switchport voice vlan mode { manual | auto }
Parameter
manual | auto —— Port mode.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
Example
Configure the Fast Ethernet port 3 to operate in the auto voice VLAN mode:
TL-SL3428(config)#interface fastEthernet 1/0/3
TL-SL3428(config-if)#switchport voice vlan mode auto
show voice vlan
Description
The show voice vlan command is used to display the global configuration
information of Voice VLAN.
Syntax
show voice vlan
30
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the configuration information of Voice VLAN globally:
TL-SL3428(config)#show voice vlan
show voice vlan oui
Description
The show voice vlan oui command is used to display the configuration
information of Voice VLAN OUI.
Syntax
show voice vlan oui
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the configuration information of Voice VLAN OUI:
TL-SL3428(config)#show voice vlan oui
show voice vlan switchport
Description
The show voice vlan switchport command is used to display the configuration
information of all the ports or one specified port in the Voice VLAN.
Syntax
show voice vlan switchport [fastEthernet port | gigabitEthernet port]
Parameter
port ——The Fast/Gigabit Ethernet port number selected to display the
configuration information. Using the show voice vlan switchport command
without parameter displays the detailed information of all ports in the Voice
VLAN.
31
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the configuration information of Fast Ethernet port 1 in the Voice VLAN:
TL-SL3428(config)#show voice vlan switchport fastEthernet 1/0/1
Display the configuration information of all the ports in the Voice VLAN:
TL-SL3428(config)#show voice vlan switchport
32
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Chapter 6 GVRP Commands
GVRP (GARP VLAN registration protocol) is an implementation of GARP (generic attribute
registration protocol). GVRP allows the switch to automatically add or remove the VLANs via the
dynamic VLAN registration information and propagate the local VLAN registration information to
other switches, without having to individually configure each VLAN.
gvrp (global)
Description
The gvrp command is used to enable the GVRP function globally. To disable the
GVRP function, please use no gvrp command.
Syntax
gvrp
no gvrp
Command Mode
Global Configuration Mode
Example
Enable the GVRP function globally:
TL-SL3428(config)#gvrp
gvrp (interface)
Description
The gvrp command is used to enable the GVRP function for the desired port. To
disable it, please use no gvrp command. The GVRP feature can only be
enabled for the trunk-type ports.
Syntax
gvrp
no gvrp
33
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEhternet)
Example
Enable the GVRP function for Fast Ethernet ports 2-6:
TL-SL3428(config)#interface range fastEthernet 1/0/2-6
TL-SL3428(config-if-range)#gvrp
gvrp registration
Description
The gvrp registration command is used to configure the GVRP registration
type for the desired port. To restore to the default value, please use no gvrp
registration command.
Syntax
gvrp registration { normal | fixed | forbidden }
no gvrp registration
Parameter
normal | fixed | forbidden —— Registration mode. By default, the registration
mode is “normal”.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEhternet)
Example
Configure the GVRP registration mode as “fixed” for Fast Ethernet ports 2-6:
TL-SL3428(config)#interface range fastEthernet 1/0/2-6
TL-SL3428(config-if-range)#gvrp registration fixed
34
gvrp timer
Description
The gvrp timer command is used to set a GVRP timer for the desired port. To
restore to the default setting of a GARP timer, please use no gvrp timer
command.
Syntax
gvrp timer { leaveall | join | leave } value
no gvrp timer { leaveall | join | leave }
Parameter
leaveall | join | leave —— They are the three timers: leave All、join and leave.
Once the LeaveAll Timer is set, the port with GVRP enabled can send a
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
LeaveAll message after the timer times out, so that other GARP ports can
re-register all the attribute information. After that, the LeaveAll timer will start to
begin a new cycle. To guarantee the transmission of the Join messages, a
GARP port sends each Join message two times. The Join Timer is used to
define the interval between the two sending operations of each Join message.
Once the Leave Timer is set, the GARP port receiving a Leave message will
start its Leave timer, and deregister the attribute information if it does not receive
a Join message again before the timer times out.
value ——The value of the timer. The LeaveAll Timer ranges from 1000 to
30000 centiseconds and the default value is 1000. The Join Timer ranges from
20 to 1000 centiseconds and the default value is 20. The Leave Timer ranges
from 60 to 3000 centiseconds and the default value is 60.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEhternet)
Example
Set the GARP leaveall timer of Fast Ethernet port 6 as 2000 centiseconds and
restore the join timer of it to the default value:
TL-SL3428(config)#interface fastEthernet 1/0/6
TL-SL3428(config-if)#gvrp timer leaveall 2000
TL-SL3428(config-if)#no gvrp timer join
35
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
show gvrp global
Description
The show gvrp global command is used to display the global GVRP status.
Syntax
show gvrp global
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the global GVRP status:
TL-SL3428(config)#show gvrp global
show gvrp interface
Description
The show gvrp interface command is used to display the GVRP configuration
information of a specified Ethernet port or of all Ethernet ports.
Syntax
show gvrp interface [fastEthernet port | gigabitEthernet port]
Parameter
port ——The Fast/Gigabit Ethernet port number. By default, the GVRP
configuration information of all the Ethernet ports is displayed.
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the GVRP configuration information of Fast Ethernet port 1:
TL-SL3428(config)#show gvrp interface fastEthernet 1/0/1
Display the GVRP configuration information of all Ethernet ports:
TL-SL3428(config)#show gvrp interface
36
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Chapter 7 Etherchannel Commands
Etherchannel Commands are used to configure LAG and LACP function.
LAG (Link Aggregation Group) is to combine a number of ports together to make a single
high-bandwidth data path, which can highly extend the bandwidth. The bandwidth of the LAG is
the sum of bandwidth of its member port.
LACP (Link Aggregation Control Protocol) is defined in IEEE802.3ad and enables the dynamic link
aggregation and disaggregation by exchanging LACP packets with its partner. The switch can
dynamically group similarly configured ports into a single logical link, which will highly extend the
bandwidth and flexibly balance the load.
channel-group
Description
The channel-group command is used to add a port to the EtherChannel Group
and configure its mode. To delete the port from the EtherChannel Group, please
use no channel-group command.
Syntax
channel-group num mode { on | active | passive }
no channel-group
Parameter
num —— The number of the EtherChannel Group, ranging from 1 to 14.
on —— Enable the static LAG.
active —— Enable the active LACP mode.
passive —— Enable the passive LACP mode.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEhternet)
Example
Add the Fast Ethernet port 2-4 to EtherChannel Group 1 and enable the static
LAG:
TL-SL3428(config)#interface range fastEthernet 1/0/2-4
TL-SL3428(config-if-range)#channel-group 1 mode on
37
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
port-channel load-balance
Description
The port-channel load-balance command is used to configure the Aggregate
Arithmetic for LAG. To return to the default configurations, please use no
port-channel load-balance command.
Syntax
port-channel load-balance {src-dst-mac | src-dst-ip}
no port-channel load-balance
Parameter
src-dst-mac —— The source and destination MAC address. When this option is
selected, the Aggregate Arithmetic will be based on the source and destination
MAC addresses of the packets. The Aggregate Arithmetic for LAG is
“src-dst-mac” by default.
src-dst-ip —— The source and destination IP address. When this option is
selected, the Aggregate Arithmetic will be based on the source and destination
IP addresses of the packets.
Command Mode
Global Configuration Mode
Example
Configure the Aggregate Arithmetic for LAG as “src-dst-mac”:
TL-SL3428(config)#port-channel load-balance src-dst-mac
lacp system-priority
Description
The lacp system-priority command is used to configure the LACP system
priority globally. To return to the default configurations, please use no lacp
Syntax
system-priority command.
lacp system-priority pri
no lacp system-priority
38
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Parameter
pri —— The system priority, ranging from 0 to 65535. It is 32768 by default.
Command Mode
Global Configuration Mode
Example
Configure the LACP system priority as 1024 globally:
TL-SL3428(config)#lacp system-priority 1024
lacp port-priority
Description
The lacp port-priority command is used to configure the LACP system priority
globally. To return to the default configurations, please use no lacp
port-priority command.
Syntax
lacp port-priority pri
no lacp port-priority
Parameter
pri —— The port priority, ranging from 0 to 65535. It is 32768 by default.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEhternet)
Example
Configure the LACP port priority as 1024 for Fast Ethernet port 1:
TL-SL3428(config)#interface fastEthernet 1/0/1
TL-SL3428(config-if)#lacp port-priority 1024
show etherchannel
Description
The show etherchannel command is used to display the EtherChannel
information.
Syntax
show etherchannel [channel-group-num ] { detail | summary }
39
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Parameter
channel-group-num —— The EtherChannel Group number, ranging from 1 to
14. By default, it is empty, and will display the information of all EtherChannel
Groups.
detail —— The detailed information of EtherChannel.
summary —— The EtherChannel information in summary.
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the detailed information of EtherChannel Group 1:
TL-SL3428(config)#show etherchannel 1 detail
show etherchannel load-balance
Description
The show etherchannel load-balance command is used to display the
Aggregate Arithmetic of LAG.
Syntax
show etherchannel load-balance
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the Aggregate Arithmetic of LAG:
TL-SL3428(config)#show etherchannel load-balance
show lacp
Description
Syntax
The show lacp command is used to display the LACP information for a
specified EtherChannel Group.
show lacp [ channel-group-num ] { internal | neighbor }
40
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Parameter
channel-group-num —— The EtherChannel Group number, ranging from 1 to
14. By default, it is empty, and will display the information of all LACP groups.
internal —— The internal LACP information.
neighbor —— The neighbor LACP information.
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the internal LACP information of EtherChannel Group 1:
TL-SL3428(config)#show lacp 1 internal
show lacp sys-id
Description
The show lacp sys-id command is used to display the LACP system priority
globally.
Syntax
show lacp sys-id
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the LACP system priority:
TL-SL3428(config)#show lacp sys-id
41
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Chapter 8 User Manage Commands
User Manage Commands are used to manage the user’s logging information by Web, CLI or SSH,
so as to protect the settings of the switch from being randomly changed.
user name
Description
The user name command is used to add a new user or modify the existed
users’ information. To delete the existed users, please use no user name
command.
Syntax
user name user-name password password [type {guest | admin}] [status
disable | enable}] [secret {simple | cipher}]
no user name user-name
Parameter
user-name ——Type a name for users' login, which contains 16 characters at
most, composing digits, English letters and underlines only.
password ——Type a password for users' login, which contains 16 characters at
most, composing digits, English letters and underlines only.
guest | admin —— Access level. “Guest” means that you can only view the
settings without the right to edit and modify. “Admin” means that you can edit,
modify and view all the settings of different functions. It is “admin” by default.
disable | enable —— Enable/disable the user. The new added user is “enable”
by default.
simple | cipher —— The way of displaying password. By default, it is “simple”.
Command Mode
Global Configuration Mode
Example
Add and enable a new admin user named “tplink”, of which the password is
“password”:
42
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
TL-SL3428(config)#user name tplink password password type admin status
enable
user access-control ip-based
Description
The user access-control ip-based command is used to limit the IP-range of
the users for login. Only the users within the IP-range you set here are allowed
to login. To cancel the user access limit, please use no user access-control
command.
Syntax
user access-control ip-based ip-addr ip-mask
no user access-control
Parameter
ip-addr —— The source IP address. Only the users within the IP-range you set
here are allowed to login.
ip-mask ——The subnet mask of the IP address.
Command Mode
Global Configuration Mode
Example
Configure that only the user with the IP address 192.168.0.148 is allowed to
login:
TL-SL3428(config)#user access-control ip-based 192.168.0.148 255.255.255.255
user access-control mac-based
Description
The user access-control mac-based command is used to limit the MAC
address of the users for login. Only the user with this MAC address you set here
is allowed to login. To cancel the user access limit, please use no user
access-control command.
43
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Syntax
user access-control mac-based mac-addr
no user access-control
Parameter
mac-addr —— The source MAC address. Only the user with this MAC address
is allowed to login.
Command Mode
Global Configuration Mode
Example
Configure that only the user with the MAC address 00:00:13:0A:00:01 is allowed
to login:
TL-SL3428(config)#user access-control mac-based 00:00:13:0A:00:01
user access-control port-based
Description
The user access-control port-based command is used to limit the ports for
login.
Only the users connected to these ports you set here are allowed for login.
To cancel the user access limit, please use no user access-control command.
Syntax
user access-control port-based interface { fastEthernet port | gigabitEthernet
port | range fastEthernet port-list | range gigabitEthernet port-list }
no user access-control
Parameter
port —— The Fast/Gigabit Ethernet port number.
port-list ——The list group of Ethernet ports. You can appoint 5 ports at most.
Command Mode
Global Configuration Mode
Example
Configure that only the users connected to Fast Ethernet ports 2-6 are allowed to
login:
44
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
TL-SL3428(config)#user access-control port-based interface range
fastEthernet 1/0/2-6
user max-number
Description
The user max-number command is used to configure the maximum login user
number at the same time. To cancel the limit on login number, please use no
user max-number command.
Syntax
user max-number admin-num guest-num
no user max-number
Parameter
admin-num —— The maximum number of the users allowed to log on as Admin,
ranging from 1 to 16. The total number of Admin and Guest should be less than 16.
guest-num —— The maximum number of the users allowed to log on as Guest,
ranging from 0 to 15. The total number of Admin and Guest should be less than 16.
Command Mode
Global Configuration Mode
Example
Configure the maximum number of users’ login as Admin and Guest as 5 and 3:
TL-SL3428(config)#user max-num 5 3
user idle-timeout
Description
Syntax
The user idle-timeout command is used to configure the timeout time of the
switch. To restore to the default timeout time, please use no user idle-timeout
command.
user idle-timeout minutes
no user idle-timeout
45
line
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Parameter
minutes ——The timeout time, ranging from 5 to 30 in minutes. The value is 10
by default.
Command Mode
Global Configuration Mode
Example
Configure the timeout time of the switch as 15 minutes:
TL-SL3428(config)#user idle-timeout 15
Description
The line command is used to enter the Line Configuration Mode and make
related configurations for the desired user(s), including the login mode and
password configurations.
Syntax
line [console linenum | vty startlinenum endlinenum ]
Parameter
linenum —— The number of users allowed to login through console port. Its
value is 0 in general as there is only one console port on a switch.
startlinenum ——The start serial number of the login user selected to configure
the login mode and password, ranging from 0 to 15. 0 means the first login user
number, 1 means the second, and the rest can be done on the same manner.
endlinenum —— The end serial number of the login user selected to configure
the login mode and password, ranging from 0 to 15. 0 means the first login user
number, 1 means the second, and the rest can be done on the same manner.
Command Mode
Global Configuration Mode
Example
Enter the Console port configuration mode and configure the console port 0:
TL-SL3428(config)#line console 0
46
password
Description
Syntax
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Enter the Virtual Terminal configuration mode so as to prepare further
configurations such as password and login mode for virtual terminal 0 to 5:
TL-SL3428(config)#line vty 0 5
The password command is used to configure the connection password. To
clear the password, please use no password command.
password password
no password
Parameter
password —— Configure the connection password, which contains 16
characters at most, composing digits, English letters and underlines only.
Command Mode
Line Configuration Mode
Example
Configure the connection password of Console port connection 0 as “tplink”:
TL-SL3428(config)#line console 0
TL-SL3428(config-line)#password tplink
Configure the connection password of virtual terminal connection 0-5 as “tplink”:
TL-SL3428(config)#line vty 0 5
TL-SL3428(config-line)#password tplink
login
Description
The login command is used to configure the login of a switch not to use the user
name and password. At this situation, a connection password must be set for
virtual terminal connection.
47
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Syntax
login
Command Mode
Line Configuration Mode
Example
Configure the login of Console port connection 0 as login mode:
TL-SL3428(config)#line console 0
TL-SL3428(config-line)#login
Configure the login of virtual terminal connection 0-5 as login mode:
TL-SL3428(config)#line vty 0 5
TL-SL3428(config-line)#login
login local
Description
The login local command is used to configure the login of a switch with the user
name and password.
Syntax
login local
Command Mode
Line Configuration Mode
Example
Configure the login of virtual terminal connection 0-5 as login local mode:
TL-SL3428(config)#line vty 0 5
TL-SL3428(config-line)#login local
Configure the login of Console port connection 0 as login local mode:
TL-SL3428(config)#line console 0
TL-SL3428(config-line)#login local
48
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
show user account-list
Description
The show user account-list command is used to display the information of the
current users.
Syntax
show user account-list
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the information of the current users:
TL-SL3428(config)#show user account-list
show user configuration
Description
The user configuration command is used to display the security configuration
information of the users, including access-control, max-number and the
idle-timeout, etc.
Syntax
show user configuration
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the security configuration information of the users:
TL-SL3428(config)#show user configuration
49
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Chapter 9 Binding Table Commands
You can bind the IP address, MAC address, VLAN and the connected Port number of the Host
together, which can be the condition for the ARP Inspection and IP verify source to filter the
packets.
ip source binding
Description
The ip source binding command is used to bind the IP address, MAC address,
VLAN ID and the Port number together manually.
address, MAC address, VLAN ID and the Port number together in the condition
that you have got the related information of the Hosts in the LAN. To delete the
IP-MAC –VID-PORT entry from the binding table, please use no ip source
binding index command.
Syntax
ip source binding hostname ip-addr mac-addr vlan vid interface
{ fastEthernet port | gigabitEthernet port } { none | arp-detection }
[ forced-source {arp-scanning | dhcp-snooping} ]
no ip source binding index idx
Parameter
hostname ——The Host Name, which contains 20 characters at most.
ip-addr —— The IP address of the Host.
mac-addr —— The MAC address of the Host.
You can manually bind the IP
vid ——The VLAN ID needed to be bound, ranging from 1 to 4094.
port —— The number of port connected to the Host.
none | arp-detection ——The protect type for the entry. “arp-detection” indicates
ARP detection.
forced-source —— The source of the binding entry can be specified as
“arp-scanning” or “dhcp-snooping”. It is multi-optional.
idx —— The entry number needed to be deleted. You can use the show ip
source binding command to get the idx. Pay attention that the entry number is
the actual number in the binding table which is not display in an arranged order.
50
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Command Mode
Global Configuration Mode
Example
Bind an ACL entry with the IP 192.168.0.1, MAC 00:00:00:00:00:01, VLAN ID 2
and the Port number 5 manually. And then enable the entry for the ARP
detection:
TL-SL3428(config)#ip source binding host1 192.168.0.1 00:00:00:00:00:01
vlan 2 interface fastEthernet 1/0/5 arp-detection
Delete the IP-MAC–VID-PORT entry with the index 5:
TL-SL3428(config)#no ip source binding index 5
ip dhcp snooping
Description
The ip dhcp snooping command is used to enable DHCP-Snooping function
globally. To disable DHCP-Snooping function globally, please use no ip dhcp
snooping command. DHCP Snooping functions to monitor the process of the
Host obtaining the IP address from DHCP server, and record the IP address,
MAC address, VLAN and the connected Port number of the Host for automatic
binding. The switch can also propagate the control information and the network
parameters via the Option 82 field to provide more information for the Host.
Syntax
ip dhcp snooping
no ip dhcp snooping
Command Mode
Global Configuration Mode
Example
Enable the DHCP-Snooping function globally:
TL-SL3428(config)#ip dhcp snooping
51
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
ip dhcp snooping global
Description
The ip dhcp snooping global command is configure DHCP-Snooping globally.
To restore to the default value, please use no dhcp-snooping global
command.
Syntax
ip dhcp snooping global { [global-rate global-rate] [dec-threshold
dec-threshold] [dec-rate dec-rate] }
no ip dhcp snooping global
Parameter
global-rate —— The value to specify the maximum amount of DHCP messages
that can be forwarded by the switch per second. The excessive messages will
be discarded. The options are 0/10/20/30/40/50 (packet/second).By default, it is
0 standing for “disable”.
dec-threshold ——The value to specify the minimum transmission rate of the
Decline packets to trigger the Decline protection for the specific port. The
options are 0/5/10/15/20/25/30 (packet/second).By default, it is 0 standing for
“disable”.
dec-rate ——The value to specify the Decline Flow Control. The traffic flow of
the corresponding port will be limited to be this value if the transmission rate of
the Decline packets exceeds the Decline Threshold. The options are
5/10/15/20/25/30 (packet/second). By default, it is 5.
Command Mode
Global Configuration Mode
Example
Configure the Global Flow Control as 30pps, the Decline Threshold as 20 pps,
and decline Flow Control as 20 pps for DHCP Snooping:
TL-SL3428(config)#ip dhcp snooping global global-rate 30 dec-threshold
20 dec-rate 20
52
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
ip dhcp snooping information option
Description
The ip dhcp snooping information option command is used to enable the
Option 82 function of DHCP Snooping. To disable the Option 82 function, please
use no ip dhcp snooping information option command.
Syntax
ip dhcp snooping information option
no ip dhcp snooping information option
Command Mode
Global Configuration Mode
Example
Enable the Option 82 function of DHCP Snooping:
TL-SL3428(config)#ip dhcp snooping information option
ip dhcp snooping information strategy
Description
The ip dhcp snooping information strategy command is used to select the
operation for the Option 82 field of the DHCP request packets from the Host. To
restore to the default option, please use no ip dhcp snooping information
strategy command.
Syntax
ip dhcp snooping information strategy strategy
no ip dhcp snooping information strategy
Parameter
strategy —— The operations for Option 82 field of the DHCP request packets
from the Host, including three types:
keep: Indicates to keep the Option 82 field of the packets. It is the default option;
replace: Indicates to replace the Option 82 field of the packets with the switch
defined one;
drop: Indicates to discard the packets including the Option 82 field.
53
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Command Mode
Global Configuration Mode
Example
Replace the Option 82 field of the packets with the switch defined one and then
send out:
TL-SL3428(config)#ip dhcp snooping information strategy replace
ip dhcp snooping information remote-id
Description
The ip dhcp snooping information remote-id command is used to enable and
configure the customized sub-option Remote ID for the Option 82. To return to
default Remote ID for the Option 82, please use no ip dhcp snooping
information remote-id command.
Syntax
ip dhcp snooping information remote-id string
no ip dhcp snooping information remote-id
Parameter
string —— Enter the sub-option Remote ID, which contains 32 characters at
most.
Command Mode
Global Configuration Mode
Example
Enable and configure the customized sub-option Remote ID for the Option 82 as
tplink:
TL-SL3428(config)#ip dhcp snooping information remote-id tplink
ip dhcp snooping information circuit-id
Description
The ip dhcp snooping information circuit-id command is used to enable and
configure the customized sub-option Circuit ID for the Option 82. To return to the
54
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
default Circuit ID for the Option 82, please use no ip dhcp snooping
information circuit-id command.
Syntax
ip dhcp snooping information circuit-id string
no ip dhcp snooping information circuit-id
Parameter
string —— Enter the sub-option Circuit ID, which contains 32 characters at
most.
Command Mode
Global Configuration Mode
Example
Enable and configure the customized sub-option Circuit ID for the Option 82 as
“tplink”:
TL-SL3428(config)#ip dhcp snooping information circuit-id tplink
ip dhcp snooping trust
Description
The ip dhcp snooping trust command is used to configure a port to be a
Trusted Port. Only the Trusted Port can receive the DHCP packets from DHCP
servers. To turn the port back to a distrusted port, please use no ip dhcp
snooping trust command.
Syntax
ip dhcp snooping trust
no ip dhcp snooping trust
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
55
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Example
Configure the Fast Ethernet port 2 to be a Trusted Port:
TL-SL3428(config)#interface fastEthernet 1/0/2
TL-SL3428(config-if)#ip dhcp snooping trust
ip dhcp snooping mac-verify
Description
The ip dhcp snooping mac-verify command is used to enable the MAC Verify
feature. To disable the MAC Verify feature, please use no ip dhcp snooping
mac-verify command. There are two fields of the DHCP packet containing the
MAC address of the Host. The MAC Verify feature is to compare the two fields
and discard the packet if the two fields are different.
Syntax
ip dhcp snooping mac-verify
no ip dhcp snooping mac-verify
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
Example
Enable the MAC Verify feature for the Fast Ethernet port 2:
TL-SL3428(config)#interface fastEthernet 1/0/2
TL-SL3428(config-if)#ip dhcp snooping mac-verify
ip dhcp snooping limit rate
Description
The ip dhcp snooping limit rate command is used to enable the Flow Control
feature for the DHCP packets. The excessive DHCP packets will be discarded.
To restore to the default configuration, please use no ip dhcp snooping limit
rate command.
56
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Syntax
ip dhcp snooping limit rate value
no ip dhcp snooping limit rate
Parameter
value —— The value of Flow Control. The options are 0/5/10/15/20/25/30
(packet/second). The default value is 0, which stands for “disable”.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
Example
Set the Flow Control of Fast Ethernet port 2 as 20 pps:
TL-SL3428(config)#interface fastEthernet 1/0/2
TL-SL3428(config-if)#ip dhcp snooping limit rate 20
ip dhcp snooping decline
Description
The ip dhcp snooping decline command is used to enable the Decline Protect
feature. To disable the Decline Protect feature, please use no ip dhcp
snooping decline command.
Syntax
ip dhcp snooping decline
no ip dhcp snooping decline
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
Example
Enable the Decline Protect feature of Fast Ethernet port 2:
TL-SL3428(config)#interface fastEthernet 1/0/2
TL-SL3428(config-if)#ip dhcp snooping decline
57
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
show ip source binding
Description
The show ip source binding command is used to display the IP-MAC-VID-
PORT binding table.
Syntax
show ip source binding
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the IP-MAC-VID-PORT binding table:
TL-SL3428(config)#show ip source binding
show ip dhcp snooping
Description
The show ip dhcp snooping command is used to display the running status of
DHCP-Snooping.
Syntax
show ip dhcp snooping
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the running status of DHCP-Snooping:
TL-SL3428#show ip dhcp snooping
show ip dhcp snooping information
Description
The show ip dhcp snooping information command is used to display the
Option 82 configuration status of DHCP-Snooping.
58
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Syntax
show ip dhcp snooping information
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the Option 82 configuration status of DHCP-Snooping:
TL-SL3428#show ip dhcp snooping information
show ip dhcp snooping interface
Description
The show ip dhcp snooping interface command is used to display the
DHCP-Snooping configuration of a desired Fast/Gigabit Ethernet ports or of all
Ethernet ports.
Syntax
show ip dhcp snooping interface [ fastEthernet port | gigabitEthernet port ]
Parameters
port ——The Fast/Gigabit Ethernet port number.
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the DHCP-Snooping configuration of all Ethernet ports:
TL-SL3428#show ip dhcp snooping interface
Display the DHCP-Snooping configuration of Fast Ethernet port 5:
TL-SL3428#show ip dhcp snooping interface fastEthernet 1/0/5
59
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Chapter 10 ARP Inspection Commands
ARP (Address Resolution Protocol) Detect function is to protect the switch from the ARP cheating,
such as the Network Gateway Spoofing and Man-In-The-Middle Attack, etc.
ip arp inspection(global)
Description
The ip arp inspection command is used to enable the ARP Detection function
globally. To disable the ARP Detection function, please use no ip arp detection
command.
Syntax
ip arp inspection
no ip arp inspection
Command Mode
Global Configuration Mode
Example
Enable the ARP Detection function globally:
TL-SL3428(config)#ip arp inspection
ip arp inspection trust
Description
The ip arp inspection trust command is used to configure the port for which
the ARP Detect function is unnecessary as the Trusted Port. To clear the
Trusted Port list, please use no ip arp detection trust command .The specific
Syntax
ports, such as up-linked port, routing port and LAG port, should be set as
Trusted Port. To ensure the normal communication of the switch, please
configure the ARP Trusted Port before enabling the ARP Detect function.
ip arp inspection trust
no ip arp inspection trust
60
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEhternet)
Example
Configure the Fast Ethernet ports 2-5 as the Trusted Port:
TL-SL3428(config)#interface range fastEthernet 1/0/2-5
TL-SL3428(config-if-range)#ip arp inspection trust
ip arp inspection(interface)
Description
The ip arp inspection command is used to enable the ARP Defend function. To
disable the ARP detection function, please use no ip arp inspection command.
ARP Attack flood produces lots of ARP Packets, which will occupy the
bandwidth and slow the network speed extremely. With the ARP Defend
enabled, the switch can terminate receiving the ARP packets for 300 seconds
when the transmission speed of the legal ARP packet on the port exceeds the
defined value so as to avoid ARP Attack flood.
Syntax
ip arp inspection
no ip arp inspection
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEhternet)
Example
Enable the arp defend function for the Fast Ethernet ports 2-6:
TL-SL3428(config)#interface range fastEthernet 1/0/2-6
TL-SL3428(config-if-range)#ip arp inspection
61
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
ip arp inspection limit-rate
Description
The ip arp inspection limit-rate command is used to configure the ARP speed
of a specified port. To restore to the default speed, please use no ip arp
inspection limit-rate command.
Syntax
ip arp inspection limit-rate value
no ip arp inspection limit-rate
Parameter
value ——The value to specify the maximum amount of the received ARP
packets per second, ranging from 10 to 100 in pps(packet/second). By default,
the value is 15.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEhternet)
Example
Configure the maximum amount of the received ARP packets per second as 50
pps for Fast Ethernet port 5:
TL-SL3428(config)#interface fastEthernet 1/0/5
TL-SL3428(config-if)#ip arp inspection limit-rate 50
ip arp inspection recover
Description
The ip arp inspection recover command is used to restore a port to the ARP
transmit status from the ARP filter status.
Syntax
ip arp inspection recover
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEhternet)
62
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Example
Restore Fast Ethernet port 5 to the ARP transmit status:
TL-SL3428(config)#interface fastEthernet 1/0/5
TL-SL3428(config-if)#ip arp inspection recover
show ip arp inspection
Description
The show ip arp inspection command is used to display the ARP detection
global configuration including the enable/disable status and the Trusted Port list.
Syntax
show ip arp inspection
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the ARP detection configuration globally:
TL-SL3428(config)#show ip arp inspection
show ip arp inspection interface
Description
The show ip arp inspection interface command is used to display the
interface configuration of ARP detection.
Syntax
show ip arp inspection interface [ fastEthernet port | gigabitEthernet port]
Parameter
port ——The Fast/Gigabit Ethernet port number.
Command Mode
Privileged EXEC Mode and Any Configuration Mode
63
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Example
Display the configuration of Fast Ethernet port 1:
TL-SL3428(config)#show ip arp inspection interface fastEthernet 1/0/1
Display the configuration of all Ethernet ports:
TL-SL3428(config)#show ip arp inspection interface
show ip arp inspection statistics
Description
The show ip arp inspection statistics command is used to display the number
of the illegal ARP packets received.
Syntax
show ip arp inspection statistics
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the number of the illegal ARP packets received:
TL-SL3428(config)#show ip arp inspection statistics
clear ip arp inspection statistics
Description
The clear ip arp inspection statistics command is used to clear the statistic of
the illegal ARP packets received.
Syntax
clear ip arp inspection statistics
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Clear the statistic of the illegal ARP packets received:
TL-SL3428(config)#clear ip arp inspection statistics
64
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Chapter 11 DoS Defend Command
DoS (Denial of Service) Attack is to occupy the network bandwidth maliciously by the network
attackers or the evil programs sending a lot of service requests to the Host. With the DoS Defend
enabled, the switch can analyze the specific field of the received packets and provide the defend
measures to ensure the normal working of the local network.
ip dos-prevent
Description
The ip dos-prevent command is used to enable the DoS defend function
globally. To disable the DoS defend function, please use no ip dos-prevent
command.
Syntax
ip dos-prevent
no ip dos-prevent
Command Mode
Global Configuration Mode
Example
Enable the DoS defend function globally:
TL-SL3428(config)#ip dos-prevent
ip dos-prevent type
Description
The ip dos-prevent type command is used to select the DoS Defend Type. To
Syntax
disable the corresponding Defend Type, please use no ip dos-prevent type
command.
ip dos-prevent type { scan-synfin | xma-scan | null-scan | port-less-1024 |
ping-flood | syn-flood }
no ip dos-prevent type { scan-synfin | xma-scan | null-scan | port-less-1024 |
ping-flood | syn-flood }
65
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Parameter
scan-synfin —— Scan SYNFIN attack.
xma-scan —— Xma Scan attack.
null-scan —— NULL Scan attack.
port-less-1024 ——The SYN packets whose Source Port less than 1024.
ping-flood —— Ping flooding attack. With the ping flood attack enabled, the
switch will limit automatically the forwarding speed of ping packets to 512 Kbps
when attacked by ping flood.
syn-flood —— SYN/SYN-ACK flooding attack. With the syn-flood attack enabled,
the switch will limit automatically the forwarding speed of ping packets to 512
Kbps when attacked by syn-flood.
Command Mode
Global Configuration Mode
Example
Enable the DoS Defend Type named ping flooding attack:
TL-SL3428(config)#ip dos-prevent type ping-flood
show ip dos-prevent
Description
The show ip dos-prevent command is used to display the DoS information of
the detected DoS attack, including enable/disable status, the DoS Defend Type,
the count of the attack, etc.
Syntax
show ip dos-prevent
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the DoS information of the detected DoS attack globally:
TL-SL3428(config)#show ip dos-prevent
66
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Chapter 12 IEEE 802.1X Commands
IEEE 802.1X function is to provide an access control for LAN ports via the authentication. Only the
supplicant passing the authentication can access the LAN.
dot1x system-auth-control
Description
The dot1x system-auth-control command is used to enable the IEEE 802.1X
function globally. To disable the IEEE 802.1X function, please use no dot1x
system-auth-control command.
Syntax
dot1x system-auth-control
no dot1x system-auth-control
Command Mode
Global Configuration Mode
Example
Enable the IEEE 802.1X function:
TL-SL3428(config)#dot1x system-auth-control
dot1x auth-method
Description
The dot1x auth-method command is used to configure the Authentication
Method of IEEE 802.1X and the default 802.1x authentication method is
“eap-md5”. To restore to the default 802.1x authentication method, please use
no dot1x auth-method command.
Syntax
dot1x auth-method { pap | eap-md5 }
no dot1x auth-method
Parameter
pap | eap-md5 ——Authentication Methods.
67
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
pap: IEEE 802.1X authentication system uses extensible authentication protocol
(EAP) to exchange information between the switch and the client. The
transmission of EAP packets is terminated at the switch and the EAP packets
are converted to the other protocol (such as RADIUS) packets for transmission
eap-md5: IEEE 802.1X authentication system uses extensible authentication
protocol (EAP) to exchange information between the switch and the client. The
EAP protocol packets with authentication data can be encapsulated in the
advanced protocol (such as RADIUS) packets to be transmitted to the
authentication server.
Command Mode
Global Configuration Mode
Example
Configure the Authentication Method of IEEE 802.1X as “pap”:
TL-SL3428(config)#dot1x auth-method pap
dot1x guest-vlan(global)
Description
The dot1x guest-vlan command is used to enable the Guest VLAN function
globally. To disable the Guest VLAN function, please use no dot1x guest-vlan
command.
Syntax
dot1x guest-vlan vid
no dot1x guest-vlan
Parameter
vid —— The VLAN ID needed to enable the Guest VLAN function, ranging from
2 to 4094.
The supplicants in the Guest VLAN can access the specified network
source.
Command Mode
Global Configuration Mode
68
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Example
Enable the Guest VLAN function for VLAN 5:
TL-SL3428(config)#dot1x guest-vlan 5
dot1x quiet-period
Description
The dot1x quiet-period command is used to enable the quiet-period function.
To disable the function, please use no dot1x quiet-period command.
Syntax
dot1x quiet-period
no dot1x quiet-period
Command Mode
Global Configuration Mode
Example
Enable the quiet-period function:
TL-SL3428(config)#dot1x quiet-period
dot1x timeout
Description
The dot1x timeout command is used to configure the quiet period and the
supplicant timeout. To restore to the default, please use no dot1x timeout
command.
Syntax
dot1x timeout {quiet-period time | reauth-period time}
no dot1x timeout {quiet-period | reauth-period}
Parameter
quiet-period time ——The value for Quiet Period, ranging from 1 to 999 in
seconds. By default, it is 10. Once the supplicant failed to the 802.1X
Authentication, then the switch will not respond to the authentication request
from the same supplicant during the Quiet Period.
69
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
reauth-period time ——The maximum time for the switch to wait for the
response from supplicant before resending a request to the supplicant., ranging
from 1 to 9 in second. By default, it is 3.
Command Mode
Global Configuration Mode
Example
Configure the quiet period as 100 seconds:
TL-SL3428(config)#dot1x timeout quiet-period 100
dot1x max-reauth-req
Description
The dot1x max-reauth-req command is used to configure the maximum
transfer times of the repeated authentication request when the server cannot be
connected. To restore to the default value, please use no dot1x
max-reauth-req command.
Syntax
dot1x max-reauth-req times
no dot1x max-reauth-req
Parameter
times —— The maximum transfer times of the repeated authentication request,
ranging from 1 to 9 in times. By default, the value is 3.
Command Mode
Global Configuration Mode
Example
Configure the maximum transfer times of the repeated authentication request as
5:
TL-SL3428(config)#dot1x max-reauth-req 5
70
dot1x
Description
Syntax
Command Mode
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
The dot1x command is used to enable the IEEE 802.1X function for a specified
port. To disable the IEEE 802.1X function for a specified port, please use no
dot1x command.
dot1x
no dot1x
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
Example
Enable the IEEE 802.1X function for the Fast Ethernet port 1:
TL-SL3428(config)#interface fastEthernet 1/0/1
TL-SL3428(config-if)#dot1x
dot1x guest-vlan(interface)
Description
The dot1x guest-vlan command is used to enable the guest VLAN function for
a specified port. To disable the Guest VLAN function for a specified port, please
use no dot1x guest-vlan command. Please ensure that the Control Type of the
corresponding port is port-based before enabling the guest VLAN function for it.
Syntax
dot1x guest-vlan
no dot1x guest-vlan
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
71
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Example
Enable the Guest VLAN function for Fast Ethernet port 2:
TL-SL3428(config)#interface fastEthernet 1/0/2
TL-SL3428(config-if)#dot1x guest-vlan
dot1x port-control
Description
The dot1x port-control command is used to configure the Control Mode of
IEEE 802.1X for the specified port. By default, the control mode is “auto”. To
restore to the default configuration, please use no dot1x port-control
command.
Syntax
dot1x port-control {auto | authorized-force | unauthorized-force}
no dot1x port-control
Parameter
auto | authorized-force | unauthorized-force —— The Control Mode for the port.
auto:
In this mode, the port will normally work only after passing the 802.1X
Authentication.
authorized-force: In this mode, the port can work normally without passing the
802.1X Authentication.
unauthorized-force: In this mode, the port is forbidden working for its fixed
unauthorized status.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
Example
Configure the Control Mode for Gigabit Ethernet port 25 as “authorized-force”:
TL-SL3428(config)#interface gigabitEthernet 1/0/25
TL-SL3428(config-if)#dot1x port-control authorized-force
72
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
dot1x port-method
Description
The dot1x port-method command is used to configure the control type of IEEE
802.1X for the specified port. By default, the control type is “mac-based”. To
restore to the default configuration, please use no dot1x port-method
command.
Syntax
dot1x port-method { mac-based | port-based }
no dot1x port-method
Parameter
mac-based | port-based ——The control type for the port.
Command Mode
Example
radius
mac-based: Any client connected to the port should pass the 802.1X
authentication for access.
port-based: All the clients connected to the port can access the network on the
condition that any one of the clients has passed the 802.1X Authentication.
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
Configure the Control Type for Gigabit Ethernet port 25 as “port-based”:
TL-SL3428(config)#interface gigabitEthernet 1/0/25
TL-SL3428(config-if)#dot1x port-method port-based
Description
The radius command is used to configure the parameters of radius.
Syntax
radius { [auth-pri ip] [auth-sec ip] [auth-port port] [auth-key keyvalue]
[acct-pri ip] [acct-sec ip] [acct-port port] [acct-key keyvalue] [timeout value] }
no radius { auth-port | auth-key | acct-port | acct-key | timeout }
73
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Parameter
auth-pri ip —— The IP address of the authentication server.
auth-sec ip —— The IP address of the alternative authentication server.
auth-port port ——The UDP port of authentication server(s) ranging from 1 to
65535. The default value is 1812.
auth-key keyvalue ——The shared password for the switch and the
authentication servers to exchange messages which contains 15 characters at
most.
acct-pri ip —— The IP address of the accounting server.
acct-sec ip —— The IP address of the alternative accounting server.
acct-port port —— The UDP port of accounting server(s) ranging from 1 to
65535. The default value is 1813.
acct-key keyvalue —— The shared password for the switch and the accounting
servers to exchange messages which contains 15 characters at most.
timeout value —— The maximum time for the switch to wait for the response
before resending a request to the supplicant., ranging from 1 to 9 in second. By
default, it is 3.
Command Mode
Global Configuration Mode
Example
Configure the IP address of the accounting server as 10.20.1.100 and password
as tplink:
TL-SL3428(config)#radius auth-pri 10.20.1.100 auth-key tplink
radius server-account
Description
Syntax
The radius server-account command is used to enable the accounting feature.
To disable the accounting feature, please use no radius server-account
command.
radius server-account
no radius server-account
74
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Command Mode
Global Configuration Mode
Example
Enable the accounting feature:
TL-SL3428(config)#radius server-account
show dot1x global
Description
The show dot1x global command is used to display the global configuration of
801.X.
Syntax
show dot1x global
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the configuration of 801.X globally:
TL-SL3428(config)#show dot1x global
show dot1x interface
Description
The show dot1x interface command is used to display all ports or the specified
port’s configuration information of 801.X.
Syntax
show dot1x interface [ fastEthernet port | gigabitEthernet port ]
Parameter
port —— The Fast/Gigabit Ethernet port number. Display the configuration of all
the ports by default.
Command Mode
Privileged EXEC Mode and Any Configuration Mode
75
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Example
Display the configuration information of 801.X for Gigabit Ethernet port 25:
TL-SL3428(config)#show dot1x interface gigabitEthernet 1/0/25
Display the configuration information of 801.X for all Ethernet ports:
TL-SL3428(config)#show dot1x interface
show radius accounting
Description
The show radius accounting command is used to display the configuration of
the accounting server.
Syntax
show radius accounting
Command Mode
Privileged EXEC Mode and Any Configuration Modes
Example
Display the configuration of the accounting server:
TL-SL3428(config)#show radius accounting
show radius authentication
Description
The show radius authentication command is used to display the configuration
of the RADIUS authentication server.
Syntax
show radius authentication
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the configuration of the RADIUS authentication server:
TL-SL3428(config)#show radius authentication
76
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Chapter 13 System Log Commands
The log information will record the settings and operation of the switch respectively for you to
monitor operation status and diagnose malfunction.
logging buffer
Description
The logging buffer command is used to configure the severity level and the
status of the configuration input to the log buffer. To disable the logging buffer
function, please use no logging buffer command.
information saved in the switch. It has two output channels, that is, it can be
saved to two different positions, log buffer and log file. The log buffer indicates
the RAM for saving system log and the information in the log buffer can be got
by show logging buffer
Syntax
logging buffer level
no logging buffer
Parameter
level —— Severity level of the log information output to each channel. There
are 8 severity levels marked with values 0-7. The smaller value has the higher
priority. Only the log with the same or smaller severity level value will be output.
By default, it is 7 indicating that all the log information will be saved in the log
buffer.
Local Log is the log
command. It will be lost when the switch is restarted.
Command Mode
Global Configuration Mode
Example
Set the severity level as 6:
TL-SL3428(config)#logging buffer 6
77
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
logging file flash
Description
The logging file flash command is used to configure the level and the status of
the log file input. To disable the logging file flash funtion, please use no logging
file flash command. The log file indicates the flash sector for saving system log.
The information in the log file will not be lost after the switch is restarted and can
be got by the show logging flash
Syntax
logging file flash level
no logging file flash
Parameter
level —— Severity level of the log information output to each channel. There
are 8 severity levels marked with values 0-7. The smaller value has the higher
priority. Only the log with the same or smaller severity level value will be output.
By default, it is 4 indicating that the log information marked with 0~4 will be
saved in the log buffer.
Command Mode
Global Configuration Mode
Example
command.
Enable the log file function and set the severity as 7:
TL-SL3428(config)#logging file flash 7
clear logging
Description
The clear logging command is used to clear the information in the log buffer
and log file.
Syntax
clear logging [ buffer | flash ]
78
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Parameter
buffer | flash —The output channels: buffer and flash. Clear the information of
the two channels, by default.
Command Mode
Global Configuration Mode
Example
Clear the information in the log file:
TL-SL3428(config)#clear logging buffer
logging host index
Description
The logging host index command is used to configure the Log Host. To clear
the configuration of the specified Log Host, please use no logging host index
command. Log Host is to receive the system log from other devices. You can
remotely monitor the settings and operation status of other devices through the
log host.
Syntax
logging host index idx host-ip level
no logging host index idx
Parameter
idx ——The index of the log host. The switch supports 4 log hosts.
host-ip —— The IP for the log host.
level ——The severity level of the log information sent to each log host. There
are 8 severity levels marked with values 0-7. The smaller value has the higher
priority. Only the log with the same or smaller severity level value will be sent to
the corresponding log host. By default, it is 6 indicating that the log information
marked with 0~6 will be sent to the log host.
Command Mode
Global Configuration Mode
79
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Example
Set the IP address as 192.168.0.148, the level 5:
TL-SL3428(config)#logging host index 2 192.168.0.148 5
show logging local-config
Description
The show logging local-config command is used to display the configuration
of the Local Log including the log buffer and the log file.
Syntax
show logging local-config
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the configuration of the Local Log:
TL-SL3428(config)#show logging local-config
show logging loghost
Description
The show logging loghost command is used to display the configuration of the
log host.
Syntax
show logging loghost [index]
Parameter
index ——The index of the log host whose configuration will be displayed.
Display the configuration of all the log hosts by default.
Command Mode
Privileged EXEC Mode and Any Configuration Mode
80
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Example
Display the configuration of the log host 2:
TL-SL3428(config)#show logging loghost 2
show logging buffer
Description
The show logging buffer command is used to display the log information in the
log buffer according to the severity level.
Syntax
show logging buffer [level level]
Parameter
level —— Severity level. There are 8 severity levels marked with values 0-7.
The information of levels with priority not lower than the select level will display.
Display all the log information in the log buffer by default.
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the log information from level 0 to level 5 in the log buffer:
TL-SL3428(config)#show logging buffer level 5
show logging flash
Description
The show logging flash command is used to display the log information in the
log file according to the severity level.
Syntax
show logging flash [level level]
Parameter
level ——Severity level. There are 8 severity levels marked with values 0-7. The
information of levels with priority not lower than the select level will display.
Display all the log information in the log file by default.
81
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the log information with the level marked 0~3 in the log file:
TL-SL3428(config)#show logging flash level 3
82
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Chapter 14 SSH Commands
SSH (Security Shell) can provide the unsecured remote management with security and powerful
authentication to ensure the security of the management information.
ip ssh server
Description
The ip ssh server command is used to enable SSH function. To disable the
SSH function, please use no ip ssh server command.
Syntax
ip ssh server
no ip ssh server
Command Mode
Global Configuration Mode
Example
Enable the SSH function:
TL-SL3428(config)#ip ssh server
ip ssh version
Description
The ip ssh version command is used to enable the SSH protocol version. To
disable the protocol version, please use no ip ssh version command.
Syntax
ip ssh version {v1 | v2 }
no ip ssh version {v1 | v2}
Parameter
v1 | v2 —— The SSH protocol version to be enabled. They represent SSH v1
and SSH v2 respectively.
Command Mode
Global Configuration Mode
83
Example
Enable SSH v2:
TL-SL3428(config)#ip ssh version v2
ip ssh timeout
Description
The ip ssh timeout command is used to specify the idle-timeout time of SSH.
To restore to the factory defaults, please use ip ssh timeout command.
Syntax
ip ssh timeout value
no ip ssh timeout
Parameter
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
value —— The Idle-timeout time. During this period, the system will
automatically release the connection if there is no operation from the client. It
ranges from 1 to 120 in seconds. By default, this value is 120 seconds.
Command Mode
Global Configuration Mode
Example
Specify the idle-timeout time of SSH as 30 seconds:
TL-SL3428(config)#ip ssh timeout 30
ip ssh max-client
Description
The ip ssh max-client command is used to specify the maximum number of the
connections to the SSH server. To return to the default configuration, please use
no ip ssh max-client command.
Syntax
ip ssh max-client num
no ip ssh max-client
Parameter
num —— The maximum number of the connections to the SSH server. It ranges
from 1 to 5. By default, this value is 5.
84
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Command Mode
Global Configuration Mode
Example
Specify the maximum number of the connections to the SSH server as 3:
TL-SL3428(config)#ip ssh max-client 3
ip ssh download
Description
The ip ssh download command is used to download the SSH key file from
TFTP server.
Syntax
ip ssh download {v1 | v2 } key-file ip-address ip-addr
Parameter
v1 | v2 —— Select the type of SSH key to download, v1 represents SSH-1, v2
represents SSH-2.
key-file —— The name of the key-file which is selected to download. The length
of the name ranges from 1 to 25 characters. The key length of the downloaded
file must be in the range of 256 to 3072 bits.
ip-addr —— The IP address of the TFTP server.
Command Mode
Global Configuration Mode
Example
Download an SSH-1 type key file named ssh-key from TFTP server with the IP
address 192.168.0.148:
TL-SL3428(config)#ip ssh download v1 ssh-key ip-address 192.168.0.148
show ip ssh
Description
The show ip ssh command is used to display the global configuration of SSH.
Syntax
show ip ssh
85
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the global configuration of SSH:
TL-SL3428(config)#show ip ssh
86
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Chapter 15 SSL Commands
SSL（Secure Sockets Layer）, a security protocol, is to provide a secure connection for the
application layer protocol(e.g. HTTP) based on TCP. Adopting asymmetrical encryption technology,
SSL uses key pair to encrypt/decrypt information. A key pair refers to a public key (contained in the
certificate) and its corresponding private key. By default the switch has a certificate (self-signed
certificate) and a corresponding private key. The Certificate/Key Download function enables the
user to replace the default key pair.
ip http secure-server
Description
The ip http secure-server command is used to enable the SSL function
globally on the switch. To disable the SSL function, please use no ip http
secure-server command. Only the SSL function is enabled, a secure HTTPS
connection can be established.
Syntax
ip http secure-server
no ip http secure-server
Command Mode
Global Configuration Mode
Example
Enable the SSL function:
TL-SL3428(config)#ip http secure-server
ip http secure-server download certificate
Description
The ip http secure-server download certificate command is used to
download a certificate to the switch from TFTP server.
Syntax
ip http secure-server download certificate ssl-cert ip-address ip-addr
87
TL-SL3428/TL-SL3452 JetStream L2 Managed Switch CLI Guide
Parameter
ssl-cert —— The name of the SSL certificate which is selected to download to
the switch. The length of the name ranges from 1 to 25 characters. The
Certificate must be BASE64 encoded.
ip-addr —— The IP address of the TFTP server.
Command Mode
Global Configuration Mode
Example
Download an SSL Certificate named ssl-cert from TFTP server with the IP
address of 192.168.0.146:
TL-SL3428(config)#ip http secure-server download certificate ssl-cert
ip-address 192.168.0.146
ip http secure-server download key
Description
The ip http secure-server download key command is used to download an
SSL key to the switch from TFTP server.
Syntax
ip http secure-server download key ssl-key ip-address ip-addr
Parameter
ssl-key —— The name of the SSL key which is selected to download to the
switch. The length of the name ranges from 1 to 25 characters. The key must be
BASE64 encoded.
ip-addr —— The IP address of the TFTP server.
Command Mode
Global Configuration Mode
Example
Download an SSL sey named ssl-key from TFTP server with the IP address of
192.168.0.146:
TL-SL3428(config)#ip http secure-server download key ssl-key ip-address
192.168.0.146
88
Loading...