TL-SL2210/TL-SL2218/TL-SL2428/TL-SL2452 Smart Switch REV1.2.1 1910011603
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 2016 TP-LINK TECHNOLOGIES CO., LTD. All rights reserved. http://www.tp-link.com I
CONTENTS Preface... 1 Chapter 1 Using the CLI... 3 1.1 Accessing the CLI... 3 1.1.1. Logon by Telnet... 3 1.1.2. Logon by SSH... 4 1.2 CLI s... 9 1.3 Security Levels... 12 1.4 Conventions... 12 1.4.1 Format Conventions... 12 1.4.2 Special Characters... 13 1.4.3 Format... 13 Chapter 2 User Interface... 14 enable... 14 enable password... 14 enable secret... 15 service password-encryption... 16 disable... 17 configure... 17 exit... 17 end... 18 history... 18 history clear... 19 Chapter 3 IEEE 802.1Q VLAN Commands... 20 vlan... 20 interface vlan... 20 name... 21 switchport general allowed vlan... 21 switchport pvid... 22 show vlan summary... 22 show vlan brief... 23 show vlan... 23 show interface switchport... 24 Chapter 4 Voice VLAN Commands... 25 II
voice vlan... 25 voice vlan aging time... 25 voice vlan priority... 26 voice vlan mac-address... 27 switchport voice vlan mode... 27 switchport voice vlan security... 28 show voice vlan... 28 show voice vlan oui... 29 show voice vlan switchport... 29 Chapter 5 Etherchannel Commands... 31 channel-group... 31 port-channel load-balance... 32 lacp system-priority... 32 lacp port-priority... 33 show etherchannel... 33 show etherchannel load-balance... 34 show lacp... 34 show lacp sys-id... 35 Chapter 6 User Management Commands... 36 user name (password)... 36 user name (secret)... 37 user access-control ip-based... 38 user access-control mac-based... 39 user access-control port-based... 40 show user account-list... 40 show user configuration... 41 show telnet-status... 41 Chapter 7 System Log Commands... 42 logging buffer... 42 logging file flash... 42 logging file flash (for TL-SL2452)... 43 logging file flash frequency... 44 logging file flash level... 44 clear logging... 45 logging host index... 46 show logging local-config... 46 III
show logging loghost... 47 show logging buffer... 47 show logging flash... 48 Chapter 8 SSH Commands... 49 ip ssh server... 49 ip ssh version... 49 ip ssh timeout... 50 ip ssh algorithm... 50 ip ssh max-client... 51 ip ssh download... 51 show ip ssh... 52 Chapter 9 HTTP and HTTPS Commands... 53 ip http server... 53 ip http max-users... 53 ip http session... 54 ip http secure-server... 55 ip http secure-protocol... 55 ip http secure-ciphersuite... 56 ip http secure-max-users... 56 ip http secure-session... 57 ip http secure-server download certificate... 58 ip http secure-server download key... 58 show ip http configuration... 59 show ip http secure-server... 60 Chapter 10 MAC Address Commands... 61 mac address-table static... 61 mac address-table aging-time... 62 mac address-table filtering... 62 mac address-table max-mac-count... 63 show mac address-table address... 64 show mac address-table aging-time... 64 show mac address-table max-mac-count interface... 65 show mac address-table interface... 65 show mac address-table mac-num... 66 show mac address-table mac... 66 show mac address-table vlan... 67 IV
Chapter 11 System Commands... 68 system-time manual... 68 system-time ntp... 68 system-time dst predefined... 70 system-time dst date... 71 system-time dst recurring... 72 hostname... 73 location... 73 contact-info... 74 ip management-vlan... 74 ip address... 75 ip address-alloc dhcp... 75 ip address-alloc bootp... 76 reset... 76 reboot... 77 copy running-config startup-config... 77 copy startup-config tftp... 78 copy tftp startup-config... 78 firmware upgrade... 79 ping... 79 tracert... 80 loopback interface... 81 show system-info... 81 show running-config... 82 show system-time... 82 show system-time dst... 82 show system-time ntp... 83 show cable-diagnostics interface... 83 Chapter 12 Ethernet Configuration Commands... 85 interface fastethernet... 85 interface range fastethernet... 85 interface gigabitethernet... 86 interface range gigabitethernet... 86 description... 87 shutdown... 88 flow-control... 88 media-type... 89 V
duplex... 89 speed... 90 storm-control broadcast... 90 storm-control multicast... 91 storm-control unicast... 92 bandwidth... 92 rrcp deny... 93 clear counters... 94 show interface status... 94 show interface counters... 95 show interface description... 95 show interface flowcontrol... 96 show interface configuration... 96 show storm-control... 97 show bandwidth... 97 Chapter 13 QoS Commands... 98 qos... 98 qos cos... 98 qos dscp... 99 qos queue cos-map... 100 qos queue dscp-map... 100 qos queue mode... 101 show qos interface... 102 show qos cos-map... 103 show qos dscp-map... 103 show qos queue mode... 104 show qos status... 104 Chapter 14 Port Mirror Commands... 105 monitor session destination interface... 105 monitor session source interface... 106 show monitor session... 107 Chapter 15 Port Isolation Commands... 108 port isolation... 108 show port isolation interface... 108 Chapter 16 Loopback Detection Commands... 110 VI
loopback-detection(global)... 110 loopback-detection interval... 110 loopback-detection recovery-time... 111 loopback-detection(interface)... 111 loopback-detection config... 112 loopback-detection recover... 112 show loopback-detection global... 113 show loopback-detection interface... 113 Chapter 17 ACL Commands... 115 access-list create... 115 mac access-list... 115 access-list standard... 116 access-list extended... 117 rule... 118 access-list policy name... 118 access-list policy action... 119 access-list bind(interface)... 120 access-list bind(vlan)... 120 show access-list... 121 show access-list policy... 121 show access-list bind... 122 Chapter 18 DHCP Filtering Commands... 123 ip dhcp filtering... 123 ip dhcp filtering trust... 123 show ip dhcp filtering... 124 show ip dhcp filtering interface... 124 Chapter 19 MSTP Commands... 125 spanning-tree(global)... 125 spanning-tree(interface)... 125 spanning-tree common-config... 126 spanning-tree mode... 127 spanning-tree mst configuration... 128 instance... 128 name... 129 revision... 129 spanning-tree mst instance... 130 VII
spanning-tree mst... 130 spanning-tree priority... 131 spanning-tree tc-defend... 132 spanning-tree timer... 132 spanning-tree hold-count... 133 spanning-tree max-hops... 134 spanning-tree bpdufilter... 134 spanning-tree bpduguard... 135 spanning-tree guard loop... 135 spanning-tree guard root... 136 spanning-tree guard tc... 136 spanning-tree mcheck... 137 show spanning-tree active... 138 show spanning-tree bridge... 138 show spanning-tree interface... 138 show spanning-tree interface-security... 139 show spanning-tree mst... 140 Chapter 20 IGMP Commands... 141 ip igmp snooping(global)... 141 ip igmp snooping(interface)... 141 ip igmp snooping immediate-leave... 142 ip igmp snooping drop-unknown... 142 ip igmp snooping vlan-config... 143 ip igmp snooping multi-vlan-config... 144 ip igmp snooping filter add-id... 145 ip igmp snooping filter(global)... 146 ip igmp snooping filter(interface)... 146 ip igmp snooping filter maxgroup... 147 ip igmp snooping filter mode... 147 show ip igmp snooping... 148 show ip igmp snooping interface... 148 show ip igmp snooping vlan... 149 show ip igmp snooping multi-vlan... 150 show ip igmp snooping groups... 150 show ip igmp snooping filter... 151 Chapter 21 SNMP Commands... 152 VIII
snmp-server... 152 snmp-server view... 152 snmp-server group... 153 snmp-server user... 154 snmp-server community... 156 snmp-server host... 156 snmp-server engineid... 158 snmp-server traps snmp... 158 snmp-server traps link-status... 159 snmp-server traps... 160 snmp-server traps mac... 161 snmp-server traps vlan... 161 rmon history... 162 rmon event... 163 rmon alarm... 164 show snmp-server... 165 show snmp-server view... 166 show snmp-server group... 166 show snmp-server user... 167 show snmp-server community... 167 show snmp-server host... 167 show snmp-server engineid... 168 show rmon history... 168 show rmon event... 169 show rmon alarm... 169 IX
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-SL2210/TL-SL2218/TL-SL2428/TL-SL2452 Smart Switch. The four devices of TL-SL2210, TL-SL2218, TL-SL2428 and TL-SL2452 are sharing this User Guide. For simplicity, we will take TL-SL2428 for example throughout the configuration chapters. TL-SL2210, TL-SL2218, TL-SL2428 and TL-SL2452 just differ in the number of LED indicators and ports and all figures in this guide are oftl-sl2428. Overview of this Guide Chapter 1: Using the CLI Provide information about how to use the CLI, CLI s, Security Levels and some Conventions. Chapter 2: User Interface Provide information about the commands used to switch between five CLI s. Chapter 3: IEEE 802.1Q VLAN Commands Provide information about the commands used for configuring IEEE 802.1Q VLAN. Chapter 4: Voice VLAN Commands Provide information about the commands used for configuring Voice VLAN. Chapter 5: EtherChannel Commands Provide information about the commands used for configuring LAG (Link Aggregation Group) and LACP (Link Aggregation Control Protocol).. Chapter 6: User Manage Commands Provide information about the commands used for user management. Chapter 7: System Log Commands Provide information about the commands used for configuring system log. Chapter 8: SSH Commands Provide information about the commands used for configuring and managing SSH (Security Shell). Chapter 9: HTTP and HTTPS Commands Provide information about the commands used for configuring the HTTP and HTTPS logon. Chapter 10: MAC Address Commands Provide information about the commands used for Address configuration. 1
Chapter 11: System 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 other operations. Chapter 12: Ethernet Configuration Commands Provide information about the commands used for configuring the Bandwidth Control, Negotiation Mode, and Storm Control for Ethernet ports. Chapter 13: QoS Commands Provide information about the commands used for configuring the QoS function. Chapter 14: Port Mirror Commands Provide information about the commands used for configuring the Port Mirror function. Chapter 15: Port Isolation Commands Provide information about the commands used for configuring the Port Isolation function. Chapter 16: Loopback Detection Commands Provide information about the commands used for configuring the Loopback Detection function. Chapter 17: ACL Commands Provide information about the commands used for configuring the ACL (Access Control List). Chapter 18: DHCP Filtering Commands Provide information about the commands used for configuring the DHCP Filtering function. Chapter 19: MSTP Commands Provide information about the commands used for configuring the MSTP (Multiple Spanning Tree Protocol). Chapter 20: IGMP Commands Provide information about the commands used for configuring the IGMP Snooping (Internet Group Management Protocol Snooping). Chapter 21: SNMP Commands Provide information about the commands used for configuring the SNMP (Simple Network Management Protocol) functions. 2
Chapter 1 Using the CLI 1.1 Accessing the CLI You can log on to the switch and access the CLI by logging on to the switch remotely by a Telnet or SSH connection through an Ethernet port. 1.1.1. Logon by Telnet To log on to the switch by a Telnet connection, please take the following steps: 1. Click Start and type in cmd in the Search programs and files window and press the Enter button. Figure 1-1 Run Window 2. Type in telnet 192.168.0.1 in the prompt cmd window and press Enter. Figure 1-2 Type in the telnet command 3
3. Type in the User name and Password (the factory default value for both of them are admin) and press the Enter button to enter User EXEC Mode, which is shown as Figure 1-3. Figure 1-3 Log in the Switch 4. Type in enable command to enter Privileged EXEC Mode. Figure 1-4 Enter into Priviledged EXEC Mode 1.1.2. Logon by SSH To log on by SSH, a Putty client software is recommended. There are two authentication modes to set up an SSH connection: Password Authentication Mode: It requires username and password, which are both admin by default. Key Authentication Mode: It requires a public key for the switch and a private key for the SSH client software. You can generate the public key and the private key through Putty Key Generator. Note: Before SSH login, please follow the steps shown in Figure 1-4 to enable the SSH function through Telnet connection. 4
Figure 1-5 Enable SSH function Password Authentication Mode 1. Open the software to log on to the interface of PuTTY. Enter the IP address of the switch into Host Name field; keep the default value 22 in the Port field; select SSH as the Connection type. Figure 1-6 SSH Connection Config 5
2. Click the Open button in the above figure to log on to the switch. Enter the login user name and password to log on the switch, and then enter enable to enter Privileged EXEC Mode, so you can continue to configure the switch. Figure 1-7 Log on the Switch Key Authentication Mode 1. Select the key type and key length, and generate SSH key. Figure 1-8 Generate SSH Key Note: 1. The key length is in the range of 512 to 3072 bits. 2. During the key generation, randomly moving the mouse quickly can accelerate the key generation. 6
2. After the key is successfully generated, please save the public key and private key to a TFTP server. Figure 1-9 Save the Generated Key 3. Log on to the switch by Telnet and download the public key file from the TFTP server to the switch, as the following figure shows: Figure 1-10 Download the Public Key 7
Note: 1. The key type should accord with the type of the key file. 2. The SSH key downloading can not be interrupted. 4. After the public key is downloaded, please log on to the interface of PuTTY and enter the IP address for login. Figure 1-11 SSH Connection Config 8
5. Click Browse to download the private key file to SSH client software and click Open. Figure 1-12 Download the Private Key 6. After successful authentication, please enter the login user name. If you log on to the switch without entering password, it indicates that the key has been successfully downloaded. Figure 1-13 Log on the Switch 1.2 CLI s The CLI is divided into different command modes: User EXEC Mode, Privileged EXEC Mode,, Interface Configuration Mode and VLAN Configuration Mode. Interface Configuration Mode can also be divided into Interface fastethernet, Interface 9
gigabitethernet, Interface link-aggregation and some other modes, which is shown as the following diagram. User EXEC Mode Privileged EXEC Mode Global Configuration Mode Interface Configuration Mode Interface gigabitethernet Interface link-aggregation Interface range gigabitethernet Interface range link-aggregation Interface vlan VLAN Configuration Mode 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 User EXEC Mode Primary mode once it is connected with the switch. TL-SL2428> Use the exit command to disconnect the switch. Use the enable command to access Privileged EXEC mode. Enter the disable or the exit Privileged EXEC Mode Use the enable command to enter this mode from User EXEC mode. TL-SL2428# command to return to User EXEC mode. Enter the configure command to access Global Configuration mode. Use the exit or the end command or press Ctrl+Z to return to Privileged EXEC mode. Global Configuratio n Mode Use the configure command to enter this mode from Privileged EXEC mode. TL-SL2428 (config)# 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. 10
Mode Accessing Path Prompt Logout or Access the next mode Use the interface Use the end command or press Interface Configuratio n Mode fastethernet/gigabitether net port or interface range fastethernet/ gigabitethernet port-list command to enter this mode from Global Configuration mode. TL-SL2428 (config-if)# or TL-SL2428(config-if-ran ge)# Ctrl+Z to return to Privileged EXEC mode. Enter the exit command or the # command to return to Global Configuration mode. A port number must be specified in the interface command. Use the end command or press VLAN Configuratio n Mode Use the vlan vlan-list command to enter this mode from Global Configuration mode. TL-SL2428 (config-vlan)# Ctrl+Z to return to Privileged EXEC mode. Enter the exit command or the # 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 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. : 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 corresponds 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: The commands contained are the same as that of the Interface 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. 11
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: display all information of switch, for example: statistic information, port information, VLAN information. history: Display the commands history. 1.3 Security Levels This switch s security is divided into two levels: User level and Admin level. 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 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, 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: mode {dynamic static permanent} Italic Font indicates a variable (an actual value must be assigned). For example: bridge aging-time aging-time 12
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 Format Some parameters must be entered in special formats which are shown as follows: 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,7. 13
Chapter 2 User Interface enable The enable command is used to access Privileged EXEC Mode from User EXEC Mode. enable User EXEC Mode If you have set the password to access Privileged EXEC Mode from User EXEC Mode: TL-SL2428>enable Enter password: TL-SL2428# enable password The enable password command is used to set or change the password for users to access Privileged EXEC Mode from User EXEC Mode. To remove the password, please use no enable password command. This command uses the symmetric encryption. enable password { [ 0 ] password 7 encrypted-password } no enable password 0 Specify the encryption type. 0 indicates that an unencrypted password will follow. By default, the encryption type is 0. password Super password, a string from 1 to 31 alphanumeric characters or symbols. The password is case sensitive, allows digits, English letters (case sensitive), underlines and sixteen special characters (!$%'()*,-./[]{ } ). By default, it is empty. 14
7 Indicates a symmetric encrypted password with fixed length will follow. encrypted-password A symmetric encrypted password with fixed length, which you can copy from another switch s configuration file. After the encrypted password is configured, you should use the corresponding unencrypted password if you re-enter this mode. User Guidelines If the password you configured here is unencrypted and the global encryption function is enabled in service password-encryption, the password in the configuration file will be displayed in the symmetric encrypted form. Set the super password as admin and unencrypted to access Privileged EXEC Mode from User EXEC Mode: TL-SL2428(config)# enable password 0 admin enable secret The enable secret command is used to set a secret password, which is using an MD5 encryption algorithm, for users to access Privileged EXEC Mode from User EXEC Mode. To return to the default configuration, please use no enable secret command. This command uses the MD5 encryption. enable secret { [ 0 ] password 5 encrypted-password } no enable secret 0 Specify the encryption type. 0 indicates that an unencrypted password will follow. By default, the encryption type is 0. password Super password, a string from 1 to 31 alphanumeric characters or symbols. The password is case sensitive, allows digits, English letters (case sensitive), underlines and sixteen special characters (!$%'()*,-./[]{ } ). By default, it is empty. The password in the configuration file will be displayed in the MD5 encrypted form. 5 Indicates an MD5 encrypted password with fixed length will follow. 15
encrypted-password An MD5 encrypted password with fixed length, which you can copy from another switch s configuration file. After the encrypted password is configured, you should use the corresponding unencrypted password if you re-enter this mode. User Guidelines If both the enable password and enable secret are defined, you must enter the password set in enable secret. Set the secret password as admin and unencrypted to access Privileged EXEC Mode from User EXEC Mode. The password will be displayed in the encrypted form. TL-SL2428(config)#enable secret 0 admin service password-encryption The service password-encryption command is used to encrypt the password when the password is defined or when the configuration is written, using the symmetric encryption algorithm. Encryption prevents the password from being readable in the configuration file. To disable the global encryption function, please use no service password-encryption command. service password-encryption no service password-encryption Enable the global encryption function: TL-SL2428(config)# service password-encryption 16
disable 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-SL2428# disable TL-SL2428> configure The configure command is used to access from Privileged EXEC Mode. configure Privileged EXEC Mode Access from Privileged EXEC Mode: TL-SL2428# configure TL-SL2428(config)# exit The exit command is used to return to the previous Mode from the current Mode. exit 17
Privileged EXEC Mode and Any Configuration Mode Return to from Interface Configuration Mode, and then return to Privileged EXEC Mode: TL-SL2428(config-if)# exit TL-SL2428(config)#exit TL-SL2428# end The end command is used to return to Privileged EXEC Mode. end Privileged EXEC Mode and Any Configuration Mode Return to Privileged EXEC Mode from Interface Configuration Mode: TL-SL2428(config-if)#end TL-SL2428# history The history command is used to show the latest 20 commands you entered in the current mode since the switch is powered. history Privileged EXEC Mode and any Configuration Mode Show the commands you have entered in the current mode: TL-SL2428 (config)# history 1 show history 18
history clear The history clear command is used to clear the commands you have entered in the current mode, therefore these commands will not be shown next time you use the history command. history clear Privileged EXEC Mode and any Configuration Mode Clear the commands you have entered in the current mode: TL-SL2428(config)# history clear 19
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 The vlan command is used to create IEEE 802.1Q VLAN and enter VLAN Configuration Mode. To delete the IEEE 802.1Q VLAN, please use no vlan command. vlan vlan-list no vlan vlan-list vlan-list Specify IEEE 802.1Q VLAN ID list, ranging from 2 to 4094, in the format of 2-3, 5. It is multi-optional. Create VLAN 2-10 and VLAN 100: TL-SL2428(config)# vlan 2-10,100 Delete VLAN 2: TL-SL2428(config)# no vlan 2 interface vlan The interface vlan command is used to create VLAN Interface and enter Interface VLAN Mode. To delete VLAN Interface, please use no interface vlan command. interface vlan vlan-id no interface vlan vlan-id 20
vlan-id Specify IEEE 802.1Q VLAN ID, ranging from 1 to 4094. Create VLAN Interface 2: TL-SL2428(config)# interface vlan 2 name The name command is used to assign a description 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) Specify the name of VLAN 2 as group1 : TL-SL2428(config)# vlan 2 TL-SL2428(config-vlan)# name group1 switchport general allowed vlan The switchport general allowed vlan command is used to add the desired General port to IEEE 802.1Q VLAN and specify the port s type. To delete the corresponding VLAN(s), please use no switchport general allowed vlan command. switchport general allowed vlan vlan-list { tagged untagged } no switchport general allowed vlan vlan-list 21
vlan-list Specify IEEE 802.1Q VLAN ID list, ranging from 2 to 4094, in the format of 2-3, 5. It is multi-optional. tagged untagged Egress rule,untagged or tagged. Tagged: All packets forwarded by the port are tagged. The packets contain VLAN information. Untagged: Packets forwarded by the port are untagged. Interface Configuration Mode (interface fastethernet / interface range fastethernet / interface gigabitethernet / interface range gigabitethernet) Add port 4 it to VLAN 2 and configure the type of port 4 as tagged: TL-SL2428(config)# interface fastethernet 1/0/4 TL-SL2428(config-if)# switchport general allowed vlan 2 tagged switchport pvid The switchport pvid command is used to configure the PVID for the switch ports. switchport pvid vlan-id vlan-id VLAN ID, ranging from 1 to 4094. Interface Configuration Mode (interface fastethernet / interface range fastethernet / interface gigabitethernet / interface range gigabitethernet) Specify the PVID of port 2 as 2: TL-SL2428(config)# interface fastethernet 1/0/2 TL-SL2428(config-if)# switchport pvid 2 show vlan summary The show vlan summary command is used to display the summarized information of IEEE 802.1Q VLAN. 22
show vlan summary Privileged EXEC Mode and Any Configuration Mode Display the summarized information of IEEE 802.1Q VLAN: TL-SL2428(config)# show vlan summary show vlan brief The show vlan brief command is used to display the brief information of IEEE 802.1Q VLAN. show vlan brief Privileged EXEC Mode and Any Configuration Mode Display the brief information of IEEE 802.1Q VLAN: TL-SL2428(config)# show vlan brief show vlan The show vlan command is used to display the information of IEEE 802.1Q VLAN. show vlan [vlan-list] vlan-list VLAN ID, ranging from 1 to 4094. By default, display all the information of IEEE 802.1Q VLAN. Privileged EXEC Mode and Any Configuration Mode 23
Display the information of vlan 5: TL-SL2428(config)# show vlan 5 show interface switchport The show interface switchport command is used to display the IEEE 802.1Q VLAN configuration information of the specified port or all ports. show interface switchport [port] port The port number. By default, display the VLAN configuration information of all ports. Privileged EXEC Mode and Any Configuration Mode Display the VLAN configuration information of all ports: TL-SL2428(config)# show interface switchport 24
Chapter 4 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 The voice vlan command is used to enable Voice VLAN function. To disable Voice VLAN function, please use no voice vlan command. voice vlan vlan-id no voice vlan vlan-id Specify IEEE 802.1Q VLAN ID, ranging from 2 to 4094. Enable the Voice VLAN function for VLAN 10: TL-SL2428(config)#voice vlan 10 voice vlan aging time 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. voice vlan aging time time no voice vlan aging time 25
time Aging time (in minutes) to be set for the Voice VLAN. It ranges from 1 to 43200 and the default value is 1440. Set the aging time for the Voice VLAN as 1 minute: TL-SL2428(config)#voice vlan aging time 1 voice vlan priority The voice vlan priority command is used to configure the priority for the Voice VLAN. To restore to the default priority, please use no voice vlan priority command. voice vlan priority pri no voice vlan priority pri Priority, ranging from 0 to 7, and the default value is 6. Configure the priority of the Voice VLAN as 5: TL-SL2428(config)#voice vlan priority 5 26
voice vlan mac-address 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. voice vlan mac-address mac-addr mask mask [description descript] no voice vlan mac-address mac-addr 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. 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-SL2428(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 The switchport voice vlan mode command is used to configure the Voice VLAN mode for the Ethernet port. switchport voice vlan mode { manual auto } 27
manual auto Port mode. Interface Configuration Mode (interface fastethernet / interface range fastethernet / interface gigabitethernet / interface range gigabitethernet) Configure the Fast Ethernet port 3 to operate in the auto voice VLAN mode: TL-SL2428(config)#interface fastethernet 1/0/3 TL-SL2428(config-if)#switchport voice vlan mode auto switchport voice vlan security The switchport voice vlan security command is used to enable the Voice VLAN security feature. To disable the Voice VLAN security feature, please use no switchport voice vlan security command. switchport voice vlan security no switchport voice vlan security Interface Configuration Mode (interface fastethernet / interface range fastethernet / interface gigabitethernet / interface range gigabitethernet) Enable the Fast Ethernet port 3 for Voice VLAN security feature: TL-SL2428(config)#interface fastethernet 1/0/3 TL-SL2428(config-if)#switchport voice vlan security show voice vlan The show voice vlan command is used to display the global configuration information of Voice VLAN. 28
show voice vlan Privileged EXEC Mode and Any Configuration Mode Display the configuration information of Voice VLAN globally: TL-SL2428(config)#show voice vlan show voice vlan oui The show voice vlan oui command is used to display the configuration information of Voice VLAN OUI. show voice vlan oui Privileged EXEC Mode and Any Configuration Mode Display the configuration information of Voice VLAN OUI: TL-SL2428(config)#show voice vlan oui show voice vlan switchport 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. show voice vlan switchport [fastethernet port gigabitethernet port] port The Fast/Gigabit Ethernet port number selected to display the configuration information. 29
Privileged EXEC Mode and Any Configuration Mode Display the configuration information of Fast Ethernet port 1 in the Voice VLAN: TL-SL2428(config)#show voice vlan switchport fastethernet 1/0/1 Display the configuration information of all the ports in the Voice VLAN: TL-SL2428(config)#show voice vlan switchport 30
Chapter 5 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 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. channel-group num mode { on active passive } no channel-group num The number of the EtherChannel Group, ranging from 1 to 6. on Enable the static LAG. active Enable the active LACP mode. passive Enable the passive LACP mode. Interface Configuration Mode (interface fastethernet / interface range fastethernet / interface gigabitethernet / interface range gigabitethernet) Add ports 2-4 to EtherChannel Group 1 and enable the static LAG: TL-SL2428(config)# interface range fastethernet 1/0/2-4 TL-SL2428(config-if-range)# channel-group 1 mode on 31
port-channel load-balance 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. port-channel load-balance { src-dst-mac src-dst-ip } no port-channel load-balance 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. Configure the Aggregate Arithmetic for LAG as src-dst-mac : TL-SL2428(config)# port-channel load-balance src-dst-mac lacp system-priority The lacp system-priority command is used to configure the LACP system priority globally. To return to the default configurations, please use no lacp system-priority command. lacp system-priority pri no lacp system-priority pri The system priority, ranging from 0 to 65535. It is 32768 by default. 32
Configure the LACP system priority as 1024 globally: TL-SL2428(config)# lacp system-priority 1024 lacp port-priority The lacp port-priority command is used to configure the LACP port priority for specified ports. To return to the default configurations, please use no lacp port-priority command. lacp port-priority pri no lacp port-priority pri The port priority, ranging from 0 to 65535. It is 32768 by default. Interface Configuration Mode (interface fastethernet / interface range fastethernet / interface gigabitethernet / interface range gigabitethernet) Configure the LACP port priority as 1024 for ports 1-3: TL-SL2428(config)# interface range fastethernet 1/0/1-3 TL-SL2428(config-if-range)# lacp port-priority 1024 Configure the LACP port priority as 2048 for port 4: TL-SL2428(config)# interface fastethernet 1/0/4 TL-SL2428(config-if)# lacp port-priority 2048 show etherchannel The show etherchannel command is used to display the EtherChannel information. 33
show etherchannel [ channel-group-num ] { detail summary } channel-group-num The EtherChannel Group number, ranging from 1 to 6. 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. Privileged EXEC Mode and Any Configuration Mode Display the detailed information of EtherChannel Group 1: TL-SL2428(config)# show etherchannel 1 detail show etherchannel load-balance The show etherchannel load-balance command is used to display the Aggregate Arithmetic of LAG. show etherchannel load-balance Privileged EXEC Mode and Any Configuration Mode Display the Aggregate Arithmetic of LAG: TL-SL2428(config)# show etherchannel load-balance show lacp The show lacp command is used to display the LACP information for a specified EtherChannel Group. show lacp [ channel-group-num ] { internal neighbor } 34
channel-group-num The EtherChannel Group number, ranging from 1 to 6. By default, it is empty, and will display the information of all LACP groups. internal The internal LACP information. neighbor The neighbor LACP information. Privileged EXEC Mode and Any Configuration Mode Display the internal LACP information of EtherChannel Group 1: TL-SL2428(config)# show lacp 1 internal show lacp sys-id The show lacp sys-id command is used to display the LACP system priority globally. show lacp sys-id Privileged EXEC Mode and Any Configuration Mode Display the LACP system priority: TL-SL2428(config)# show lacp sys-id 35
Chapter 6 User Management Commands User Management Commands are used to configure the user name and password for users to log on to the Web management page with a certain access level so as to protect the settings of the switch from being randomly changed. user name (password) 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. This command uses the symmetric encryption. user name name [ privilege admin guest ] password { [ 0 ] password 7 encrypted-password } no user name name name Type a name for users' login, which contains 16 characters at most, composed of digits, English letters and under dashes only. admin guest Access level. Admin means that you can edit, modify and view all the settings of different functions. Guest means that you can only view the settings without the right to edit and modify. It is admin by default. 0 Specify the encryption type. 0 indicates that an unencrypted password will follow. By default, the encryption type is 0. password Users login password, a string from 1 to 31 alphanumeric characters or symbols. The password is case sensitive, allows digits, English letters (case sensitive), underlines and sixteen special characters (!$%'()*,-./[]{ } ). 7 Indicates a symmetric encrypted password with fixed length will follow. encrypted-password A symmetric encrypted password with fixed length, which you can copy from another switch s configuration file. After the encrypted password is configured, you should use the corresponding unencrypted password if you re-enter this mode. 36
User Guidelines 1. If the password you configured here is unencrypted and the global encryption function is enabled in service password-encryption, the password in the configuration file will be displayed in the symmetric encrypted form. 2. If you change the password of the current user in a telnet connection, the connection will be cut off and the newly configured password is required for the re-login. Add and enable a new admin user named tplink, of which the password is admin and unencrypted: TL-SL2428(config)#user name tplink privilege admin password 0 admin user name (secret) 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. This command uses the MD5 encryption. user name name [ privilege admin guest ] secret { [ 0 ] password 5 encrypted-password } no user name name name Type a name for users' login, which contains 16 characters at most, composed of digits, English letters and under dashes only. admin guest Access level. Admin means that you can edit, modify and view all the settings of different functions. Guest means that you can only view the settings without the right to edit and modify. It is admin by default. 0 Specify the encryption type. 0 indicates that an unencrypted password will follow. By default, the encryption type is 0. password Users login password, a string from 1 to 31 alphanumeric characters or symbols. The password is case sensitive, allows digits, English 37
letters (case sensitive), underlines and sixteen special characters (!$%'()*,-./[]{ } ). The password will be saved to the configuration file using the MD5 encrypted algorithm. 5 Indicates an MD5 encrypted password with fixed length will follow. encrypted-password An MD5 encrypted password with fixed length, which you can copy from another switch s configuration file. User Guidelines 1. If both the user name (password) and user name (secret) are defined, only the latest configured password will take effect. 2. If you change the password of the current user in a telnet connection, the connection will be cut off and the newly configured password is required for the re-login. Add and enable a new admin user named tplink, of which the password is admin. The password will be displayed in the encrypted form. TL-SL2428(config)#user name tplink privilege admin secret 0 admin user access-control ip-based 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. user access-control ip-based { ip-addr ip-mask } [ snmp ] [ telnet ] [ ssh ] [ http ] [ https ] [ ping ] [ all ] no user access-control ip-addr The source IP address. Only the users within the IP-range you set here are allowed for login. ip-mask The subnet mask of the IP address. 38
[ snmp ] [ telnet ] [ ssh ] [ http ] [ https ] [ ping ] [ all ] Specify the access interface. These interfaces are enabled by default. Enable the access-control of the user whose IP address is 192.168.0.148: TL-SL2428(config)# user access-control ip-based 192.168.0.148 255.255.255.255 user access-control mac-based 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. user access-control mac-based { mac-addr } [ snmp ] [ telnet ] [ ssh ] [ http ] [ https ] [ ping ] [ all ] no user access-control mac-addr The source MAC address. Only the user with this MAC address is allowed to login. [ snmp ] [ telnet ] [ ssh ] [ http ] [ https ] [ ping ] [ all ] Specify the access interface. These interfaces are enabled by default. Configure that only the user whose MAC address is 00:00:13:0A:00:01 is allowed to login: TL-SL2428(config)# user access-control mac-based 00:00:13:0A:00:01 39
user access-control port-based 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 to login. To cancel the user access limit, please use no user access-control command. user access-control port-based interface { gigabitethernet port range gigabitethernet port-list } [ snmp ] [ telnet ] [ ssh ] [ http ] [ https ] [ ping ] [ all ] no user access-control port The Ethernet port number. port-list The list group of Ethernet ports, in the format of 1/0/1-4. You can appoint 5 ports at most. [ snmp ] [ telnet ] [ ssh ] [ http ] [ https ] [ ping ] [ all ] Specify the access interface. These interfaces are enabled by default. Configure that only the users connected to ports 2-6 are allowed to login: TL-SL2428(config)# user access-control port-based interface range gigabitethernet 1/0/2-6 show user account-list The show user account-list command is used to display the information of the current users. show user account-list 40
Privileged EXEC Mode and Any Configuration Mode Display the information of the current users: TL-SL2428(config)# show user account-list show user configuration The show user configuration command is used to display the security configuration information of the users, including access-control, max-number and the idle-timeout, etc. show user configuration Privileged EXEC Mode and Any Configuration Mode Display the security configuration information of the users: TL-SL2428(config)# show user configuration show telnet-status The show telnet-status command is used to display the configuration information of the Telnet function. show telnet-status Privileged EXEC Mode and Any Configuration Mode Display whether the Telnet function is enabled: TL-SL2428(config)# show telnet-status 41
Chapter 7 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 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. Local Log is the log 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 command. It will be lost when the switch is restarted. logging buffer level no logging buffer 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. Set the severity level as 6: TL-SL2428(config)# logging buffer 6 logging file flash 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 42
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 command. This command does not apply to TL-SL2452. logging file flash level no logging file flash 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 2 indicating that the log information marked with 0~2 will be saved in the log buffer. Enable the log file function and set the severity as 7: TL-SL2428(config)# logging file flash 7 logging file flash (for TL-SL2452) The logging file flash command is used to store the log messages in a flie in the flash on the switch. To disable the log file flash function, please use no logging file flash command. The log file flash indicates the flash sector for saving system log. The information in the log file of the flash will not be lost after the switch is restarted and can be got by the show logging flash command. This command only applies to TL-SL2452. logging file flash no logging file flash 43
Enable the log file flash function: TL-SL2452(config)#logging file flash logging file flash frequency The logging file flash frequency command is used to specify the frequency to synchronize the system log file in the log buffer to the flash. To resume the default synchronizing frequency, please use the no logging file flash frequency command. This command only applies to TL-SL2452. logging file flash frequency { periodic periodic immediate } no logging file flash frequency periodic The frequency to synchronize the system log file in the log buffer to the flash, ranging from 1 to 48 hours. By default, the synchronization process takes place every 24 hours. immediate The system log file in the buffer will be synchronized to the flash immediately. This option will reduce the life of the flash and is not recommended. Specify the log file synchronization frequency as 10 hours: TL-SL2452(config)#logging file flash frequency 10 logging file flash level The logging file flash level command is used to specify the system log message severity level. Messages will a severity level equal to or higher than this value will be stored to the flash. To restore to the default level, please use 44