CLI Guide
JetStream 24-Port 10/100Mbps + 4-Port Gigabit
L2 Managed Switch
T2500-28TC (TL-SL5428E)
REV2.0.0
1910011988
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 ....................................................................................... 5
1.1 Accessing the CLI............................................................................................................. 5
1.1.1 Logon by a console port ...................................................................................... 5
1.1.2 Logon by Telnet ................................................................................................... 6
1.1.3 Logon by SSH ................................................................................................... 10
1.2 CLI Command Modes .................................................................................................... 15
1.3 Security Levels ............................................................................................................... 18
1.4 Conventions .................................................................................................................... 18
1.4.1 Format Conventions ............................................................................................. 18
1.4.2 Special Characters ............................................................................................... 18
1.4.3 Parameter Format ................................................................................................ 19
Chapter 2 User Interface .................................................................................... 20
enable ...................................................................................................................................... 20
enable password ..................................................................................................................... 20
disable ..................................................................................................................................... 21
configure .................................................................................................................................. 21
exit ........................................................................................................................................... 22
end........................................................................................................................................... 22
history ...................................................................................................................................... 23
history clear ............................................................................................................................. 23
Chapter 3 IEEE 802.1Q VLAN Commands ........................................................ 24
vlan .......................................................................................................................................... 24
interface vlan ........................................................................................................................... 25
name ....................................................................................................................................... 25
switchport mode ...................................................................................................................... 26
switchport access vlan ............................................................................................................ 26
switchport trunk allowed vlan .................................................................................................. 27
switchport general allowed vlan .............................................................................................. 28
switchport pvid ........................................................................................................................ 28
show vlan summary ................................................................................................................ 29
show vlan brief ........................................................................................................................ 29
show vlan ................................................................................................................................ 30
II
Chapter 4 MAC-based VLAN Commands.......................................................... 31
mac-vlan mac-address ............................................................................................................ 31
mac-vlan .................................................................................................................................. 32
show mac-vlan ........................................................................................................................ 32
show mac-vlan interface ......................................................................................................... 33
Chapter 5 Protocol-based VLAN Commands ................................................... 34
protocol-vlan template ............................................................................................................. 34
protocol-vlan vlan .................................................................................................................... 35
protocol-vlan ............................................................................................................................ 35
show protocol-vlan template ................................................................................................... 36
show protocol-vlan vlan........................................................................................................... 36
show protocol-vlan interface ................................................................................................... 37
Chapter 6 VLAN-VPN Commands ...................................................................... 38
dot1q-tunnel ............................................................................................................................ 38
dot1q-tunnel tpid ..................................................................................................................... 38
dot1q-tunnel mapping ............................................................................................................. 39
switchport dot1q-tunnel mapping ............................................................................................ 40
switchport dot1q-tunnel mode uplink ...................................................................................... 40
show dot1q-tunnel ................................................................................................................... 41
show dot1q-tunnel mapping .................................................................................................... 41
show dot1q-tunnel mapping interface ..................................................................................... 42
show dot1q-tunnel uplink ........................................................................................................ 42
Chapter 7 Voice VLAN Commands .................................................................... 43
voice vlan ................................................................................................................................ 43
voice vlan aging time ............................................................................................................... 43
voice vlan priority .................................................................................................................... 44
voice vlan mac-address .......................................................................................................... 45
switchport voice vlan mode ..................................................................................................... 45
switchport voice vlan security ................................................................................................. 46
show voice vlan ....................................................................................................................... 47
show voice vlan oui ................................................................................................................. 47
show voice vlan switchport ..................................................................................................... 48
Chapter 8 Private VLAN Commands ................................................................. 49
private-vlan primary ................................................................................................................. 49
private-vlan community ........................................................................................................... 49
III
private-vlan association........................................................................................................... 50
switchport private-vlan ............................................................................................................ 50
switchport private-vlan host-association ................................................................................. 51
switchport private-vlan mapping ............................................................................................. 52
show vlan private-vlan............................................................................................................. 53
Chapter 9 GVRP Commands .............................................................................. 54
gvrp.......................................................................................................................................... 54
gvrp (interface) ........................................................................................................................ 54
gvrp registration ...................................................................................................................... 55
gvrp timer ................................................................................................................................ 56
show gvrp global ..................................................................................................................... 57
show gvrp interface ................................................................................................................. 57
Chapter 10 Etherchannel Commands ................................................................. 58
channel-group ......................................................................................................................... 58
port-channel load-balance ...................................................................................................... 59
lacp system-priority ................................................................................................................. 59
lacp port-priority ...................................................................................................................... 60
show etherchannel .................................................................................................................. 60
show etherchannel load-balance ............................................................................................ 61
show lacp ................................................................................................................................ 61
show lacp sys-id ...................................................................................................................... 62
Chapter 11 User Manage Commands .................................................................. 63
user name ............................................................................................................................... 63
user access-control ip-based .................................................................................................. 64
user access-control mac-based .............................................................................................. 64
user access-control port-based............................................................................................... 65
user max-number .................................................................................................................... 66
user idle-timeout ...................................................................................................................... 66
line ........................................................................................................................................... 67
password ................................................................................................................................. 68
login ......................................................................................................................................... 69
login local ................................................................................................................................ 69
show user account-list............................................................................................................. 70
show user configuration .......................................................................................................... 70
Chapter 12 Binding Table Commands................................................................. 71
IV
ip source binding ..................................................................................................................... 71
ip source binding index ........................................................................................................... 72
ip dhcp snooping ..................................................................................................................... 73
ip dhcp snooping global .......................................................................................................... 73
ip dhcp snooping information option ....................................................................................... 74
ip dhcp snooping information strategy .................................................................................... 75
ip dhcp snooping information remote-id .................................................................................. 76
ip dhcp snooping information circuit-id ................................................................................... 76
ip dhcp snooping trust ............................................................................................................. 77
ip dhcp snooping mac-verify ................................................................................................... 78
ip dhcp snooping limit rate ...................................................................................................... 78
ip dhcp snooping decline ........................................................................................................ 79
show ip source binding............................................................................................................ 79
show ip dhcp snooping............................................................................................................ 80
show ip dhcp snooping information interface ......................................................................... 80
show ip dhcp snooping interface............................................................................................. 81
Chapter 13 ARP Inspection Commands .............................................................. 82
ip arp inspection(global) .......................................................................................................... 82
ip arp inspection trust .............................................................................................................. 82
ip arp inspection(interface) ...................................................................................................... 83
ip arp inspection limit-rate ....................................................................................................... 84
ip arp inspection recover ......................................................................................................... 84
show ip arp inspection............................................................................................................. 85
show ip arp inspection interface.............................................................................................. 85
show ip arp inspection statistics .............................................................................................. 86
clear ip arp inspection statistics .............................................................................................. 86
Chapter 14 IP Verify Source Commands ............................................................. 87
ip verify source ........................................................................................................................ 87
show ip verify source ............................................................................................................... 88
Chapter 15 DoS Defend Command ...................................................................... 89
ip dos-prevent ......................................................................................................................... 89
ip dos-prevent ping-rate .......................................................................................................... 89
ip dos-prevent syn-rate ........................................................................................................... 90
ip dos-prevent type .................................................................................................................. 91
ip dos-prevent detect ............................................................................................................... 92
clear ip dos-prevent detect statistics ....................................................................................... 92
V
show ip dos-prevent ................................................................................................................ 93
Chapter 16 IEEE 802.1X Commands ................................................................... 94
dot1x system-auth-control ....................................................................................................... 94
dot1x auth-method .................................................................................................................. 95
dot1x guest-vlan(global) .......................................................................................................... 95
dot1x accounting ..................................................................................................................... 96
dot1x quiet-period ................................................................................................................... 97
dot1x timeout ........................................................................................................................... 97
dot1x max-reauth-req .............................................................................................................. 98
dot1x ........................................................................................................................................ 98
dot1x guest-vlan(interface) ..................................................................................................... 99
dot1x port-control .................................................................................................................. 100
dot1x port-method ................................................................................................................. 100
show dot1x global ................................................................................................................. 101
show dot1x interface ............................................................................................................. 102
Chapter 17 PPPoE Circuit-ID Insertion Commands ......................................... 103
pppoe circuit-id(global) .......................................................................................................... 103
pppoe circuit-id(interface) ..................................................................................................... 103
pppoe circuit-id type .............................................................................................................. 104
show pppoe circuit-id global .................................................................................................. 105
show pppoe circuit-id interface ............................................................................................. 105
Chapter 18 System Log Commands .................................................................. 107
logging buffer ......................................................................................................................... 107
logging file flash .................................................................................................................... 108
logging file flash frequency ................................................................................................... 108
logging file flash level ............................................................................................................ 109
clear logging ........................................................................................................................... 110
logging host index .................................................................................................................. 11 0
show logging local-config ....................................................................................................... 111
show logging loghost .............................................................................................................. 111
show logging buffer ................................................................................................................ 112
show logging flash .................................................................................................................. 112
Chapter 19 SSH Commands................................................................................ 114
ip ssh server ........................................................................................................................... 114
ip ssh version ......................................................................................................................... 114
VI
ip ssh timeout ......................................................................................................................... 115
ip ssh max-client .................................................................................................................... 11 5
ip ssh download ..................................................................................................................... 116
show ip ssh ............................................................................................................................. 11 7
Chapter 20 SSL Commands ................................................................................ 118
ip http secure-server .............................................................................................................. 118
ip http secure-server download certificate ............................................................................. 118
ip http secure-server download key ....................................................................................... 119
show ip http secure-server .................................................................................................... 120
Chapter 21 MAC Address Commands ............................................................... 121
mac address-table static ....................................................................................................... 121
mac address-table aging-time ............................................................................................... 122
mac address-table filtering .................................................................................................... 122
mac address-table max-mac-count....................................................................................... 123
show mac address-table ....................................................................................................... 124
show mac address-table aging-time ..................................................................................... 125
show mac address-table max-mac-count interface .............................................................. 125
show mac address-table interface ........................................................................................ 126
show mac address-table count ............................................................................................. 126
show mac address-table address ......................................................................................... 126
show mac address-table vlan ............................................................................................... 127
Chapter 22 System Configuration Commands ................................................. 128
system-time manual .............................................................................................................. 128
system-time ntp ..................................................................................................................... 128
system-time dst predefined ................................................................................................... 130
system-time dst date ............................................................................................................. 131
system-time dst recurring ...................................................................................................... 132
hostname ............................................................................................................................... 133
location .................................................................................................................................. 133
contact-info ............................................................................................................................ 134
ip management-vlan .............................................................................................................. 134
ip address .............................................................................................................................. 135
ip address-alloc dhcp ............................................................................................................ 135
ip address-alloc bootp ........................................................................................................... 136
reset ...................................................................................................................................... 136
reboot .................................................................................................................................... 137
VII
copy running-config startup-config ........................................................................................ 137
copy startup-config tftp .......................................................................................................... 138
copy tftp startup-config .......................................................................................................... 138
firmware upgrade .................................................................................................................. 139
ping ........................................................................................................................................ 140
tracert .................................................................................................................................... 141
loopback interface ................................................................................................................. 142
show system-time ................................................................................................................. 142
show system-time dst ............................................................................................................ 143
show system-time ntp ........................................................................................................... 143
show system-info .................................................................................................................. 143
show running-config .............................................................................................................. 144
show cable-diagnostics interface .......................................................................................... 144
Chapter 23 IPv6 Address Configuration Commands ....................................... 146
ipv6 enable ............................................................................................................................ 146
ipv6 address autoconfig ........................................................................................................ 146
ipv6 address link-local ........................................................................................................... 147
ipv6 address dhcp ................................................................................................................. 148
ipv6 address ra ...................................................................................................................... 148
ipv6 address eui-64 ............................................................................................................... 149
ipv6 address .......................................................................................................................... 149
show ipv6 interface vlan ........................................................................................................ 150
Chapter 24 Ethernet Configuration Commands ............................................... 151
interface fastEthernet ............................................................................................................ 151
interface range fastEthernet .................................................................................................. 151
interface gigabitEthernet ....................................................................................................... 152
interface range gigabitEthernet ............................................................................................. 152
description ............................................................................................................................. 153
shutdown ............................................................................................................................... 154
flow-control ............................................................................................................................ 154
media-type ............................................................................................................................. 155
duplex .................................................................................................................................... 155
speed ..................................................................................................................................... 156
storm-control broadcast ........................................................................................................ 156
storm-control multicast .......................................................................................................... 157
storm-control unicast ............................................................................................................. 158
VIII
bandwidth .............................................................................................................................. 158
clear counters ........................................................................................................................ 159
show interface status ............................................................................................................ 159
show interface counters ........................................................................................................ 160
show interface description .................................................................................................... 161
show interface flowcontrol ..................................................................................................... 161
show interface configuration ................................................................................................. 162
show storm-control ................................................................................................................ 162
show bandwidth..................................................................................................................... 163
Chapter 25 QoS Commands............................................................................... 164
qos ......................................................................................................................................... 164
qos cos .................................................................................................................................. 164
qos dscp ................................................................................................................................ 165
qos queue cos-map ............................................................................................................... 166
qos queue dscp-map ............................................................................................................. 166
qos queue mode ................................................................................................................... 167
show qos interface ................................................................................................................ 168
show qos cos-map ................................................................................................................ 169
show qos dscp-map .............................................................................................................. 169
show qos queue mode .......................................................................................................... 170
show qos status..................................................................................................................... 170
Chapter 26 Port Mirror Commands ................................................................... 171
monitor session destination interface ................................................................................... 171
monitor session source interface .......................................................................................... 172
show monitor session ............................................................................................................ 173
Chapter 27 Port isolation Commands ............................................................... 174
port isolation .......................................................................................................................... 174
show port isolation ................................................................................................................ 175
Chapter 28 Loopback Detection Commands .................................................... 176
loopback-detection(global) .................................................................................................... 176
loopback-detection interval ................................................................................................... 176
loopback-detection recovery-time ......................................................................................... 177
loopback-detection(interface) ................................................................................................ 177
loopback-detection config ..................................................................................................... 178
loopback-detection recover ................................................................................................... 179
IX
show loopback-detection global ............................................................................................ 179
show loopback-detection interface ....................................................................................... 180
Chapter 29 DDM Commands .............................................................................. 181
ddm state enable ................................................................................................................... 181
ddm shutdown ....................................................................................................................... 181
ddm temperature_threshold .................................................................................................. 182
ddm voltage_threshold .......................................................................................................... 183
ddm bias_current_threshold ................................................................................................. 184
ddm tx_power_threshold ....................................................................................................... 185
ddm rx_power_threshold ...................................................................................................... 186
show ddm configuration ........................................................................................................ 187
show ddm status ................................................................................................................... 188
Chapter 30 ACL Commands ............................................................................... 189
time-range ............................................................................................................................. 189
absolute ................................................................................................................................. 189
periodic .................................................................................................................................. 190
holiday ................................................................................................................................... 191
holiday(global) ....................................................................................................................... 191
access-list create .................................................................................................................. 192
mac access-list ...................................................................................................................... 192
access-list standard .............................................................................................................. 193
access-list extended .............................................................................................................. 194
access-list combined ............................................................................................................. 195
rule......................................................................................................................................... 197
access-list policy name ......................................................................................................... 198
access-list policy action......................................................................................................... 199
redirect interface ................................................................................................................... 199
redirect vlan ........................................................................................................................... 200
s-condition ............................................................................................................................. 200
s-mirror .................................................................................................................................. 201
qos-remark ............................................................................................................................ 201
access-list bind(interface) ..................................................................................................... 202
access-list bind(vlan) ............................................................................................................. 203
show time-range .................................................................................................................... 203
show holiday.......................................................................................................................... 203
show access-list .................................................................................................................... 204
X
show access-list policy .......................................................................................................... 204
show access-list bind ............................................................................................................ 205
Chapter 31 MSTP Commands ............................................................................ 206
spanning-tree(global) ............................................................................................................ 206
spanning-tree(interface) ........................................................................................................ 206
spanning-tree common-config .............................................................................................. 207
spanning-tree mode .............................................................................................................. 208
spanning-tree mst configuration ............................................................................................ 209
instance ................................................................................................................................. 209
name ..................................................................................................................................... 210
revision .................................................................................................................................. 210
spanning-tree mst instance .................................................................................................... 211
spanning-tree mst ................................................................................................................. 212
spanning-tree priority ............................................................................................................ 212
spanning-tree tc-defend ........................................................................................................ 213
spanning-tree timer ............................................................................................................... 214
spanning-tree hold-count ...................................................................................................... 214
spanning-tree max-hops ....................................................................................................... 215
spanning-tree bpdufilter ........................................................................................................ 216
spanning-tree bpduguard ...................................................................................................... 216
spanning-tree guard loop ...................................................................................................... 217
spanning-tree guard root ....................................................................................................... 217
spanning-tree guard tc .......................................................................................................... 218
spanning-tree mcheck ........................................................................................................... 218
show spanning-tree active .................................................................................................... 219
show spanning-tree bridge .................................................................................................... 219
show spanning-tree interface ................................................................................................ 220
show spanning-tree interface-security .................................................................................. 220
show spanning-tree mst ........................................................................................................ 221
Chapter 32 Ethernet OAM Commands .............................................................. 223
ethernet-oam ......................................................................................................................... 223
ethernet-oam mode ............................................................................................................... 223
ethernet-oam link-monitor symbol-period ............................................................................. 224
ethernet-oam link-monitor frame ........................................................................................... 225
ethernet-oam link-monitor frame-period ............................................................................... 226
ethernet-
oam link-monitor frame-seconds ............................................................................ 227
XI
ethernet-oam remote-failure ................................................................................................. 228
ethernet-oam remote-loopback received-remote- loopback................................................. 229
ethernet-oam remote-loopback ............................................................................................. 230
clear ethernet-oam statistics ................................................................................................. 230
clear ethernet-oam event-log ................................................................................................ 231
show ethernet-oam configuration ......................................................................................... 232
show ethernet-oam event-log ............................................................................................... 232
show ethernet-oam statistics ................................................................................................ 233
show ethernet-oam status ..................................................................................................... 233
Chapter 33 DLDP Commands ............................................................................ 235
dldp(global) ............................................................................................................................ 235
dldp interval ........................................................................................................................... 235
dldp shut-mode...................................................................................................................... 236
dldp reset(global) .................................................................................................................. 236
dldp(interface) ....................................................................................................................... 237
dldp reset(interface) .............................................................................................................. 237
show dldp .............................................................................................................................. 238
show dldp interface ............................................................................................................... 238
Chapter 34 IGMP Snooping Commands ........................................................... 240
ip igmp snooping(global) ....................................................................................................... 240
ip igmp snooping(interface) ................................................................................................... 240
ip igmp snooping immediate-leave ....................................................................................... 241
ip igmp snooping drop-unknown ........................................................................................... 241
ip igmp snooping vlan-config ................................................................................................ 242
ip igmp snooping multi-vlan-config ....................................................................................... 243
ip igmp snooping filter add-id ................................................................................................ 244
ip igmp snooping filter(global) ............................................................................................... 245
ip igmp snooping filter(interface) ........................................................................................... 245
ip igmp snooping filter maxgroup .......................................................................................... 246
ip igmp snooping filter mode ................................................................................................. 246
ip igmp snooping querier vlan ............................................................................................... 247
ip igmp snooping querier vlan (general query) ..................................................................... 248
ip igmp snooping querier vlan (specific query) ..................................................................... 249
ip igmp snooping authentication ........................................................................................... 250
show ip igmp snooping.......................................................................................................... 250
show ip igmp snooping interface........................................................................................... 251
XII
show ip igmp snooping vlan .................................................................................................. 251
show ip igmp snooping multi-vlan ......................................................................................... 252
show ip igmp snooping groups ............................................................................................. 252
show ip igmp snooping filter .................................................................................................. 253
show ip igmp snooping querier vlan ..................................................................................... 254
show ip igmp snooping querier ............................................................................................. 254
show ip igmp snooping interface authentication ................................................................... 254
Chapter 35 MLD Snooping Commands ............................................................. 256
ipv6 mld snooping ................................................................................................................. 256
ipv6 mld snooping router-aging-time .................................................................................... 256
ipv6 mld snooping member-aging-time ................................................................................. 257
ipv6 mld snooping report-suppression .................................................................................. 257
ipv6 mld snooping unknown-filter.......................................................................................... 258
ipv6 mld snooping last-listener query-inteval ........................................................................ 258
ipv6 mld snooping last-listener query-count ......................................................................... 259
ipv6 mld snooping multicast-vlan .......................................................................................... 259
ipv6 mld snooping multicast-vlan vlan-id .............................................................................. 260
ipv6 mld snooping vlan.......................................................................................................... 260
ipv6 mld snooping vlan router-aging-time ............................................................................. 261
ipv6 mld snooping vlan member-aging-time ......................................................................... 261
ipv6 mld snooping vlan immediate-leave .............................................................................. 262
ipv6 mld snooping vlan mrouter ............................................................................................ 262
ipv6 mld snooping vlan static ................................................................................................ 263
ipv6 mld snooping querier vlan ............................................................................................. 263
ipv6 mld snooping querier vlan max-response-time ............................................................. 264
ipv6 mld snooping querier vlan query-interval ...................................................................... 265
ipv6 mld snooping querier vlan query-source ....................................................................... 265
ipv6 mld snooping filter(global) ............................................................................................. 266
ipv6 mld snooping filter(interface) ......................................................................................... 266
ipv6 mld snooping filter-mode ............................................................................................... 267
ipv6 mld snooping filter-id ..................................................................................................... 267
ipv6 mld snooping max-group ............................................................................................... 268
clear ipv6 mld snooping statistics ......................................................................................... 268
show ipv6 mld snooping ........................................................................................................ 269
show ipv6 mld snooping vlan ................................................................................................ 269
show ipv6 mld snooping static-mcast ................................................................................... 270
show ipv6 mld snooping group ............................................................................................. 270
XIII
show ipv6 mld snooping filter ................................................................................................ 271
show ipv6 mld snooping interface ......................................................................................... 271
show ipv6 mld snooping interface filter ................................................................................. 271
show ipv6 mld snooping querier ........................................................................................... 272
show ipv6 mld snooping statistics ......................................................................................... 272
Chapter 36 SNMP Commands ............................................................................ 274
snmp-server .......................................................................................................................... 274
snmp-server view .................................................................................................................. 274
snmp-server group ................................................................................................................ 275
snmp-server user .................................................................................................................. 276
snmp-server community ........................................................................................................ 278
snmp-server host .................................................................................................................. 279
snmp-server engineID ........................................................................................................... 280
snmp-server traps snmp ....................................................................................................... 281
snmp-server traps security .................................................................................................... 282
snmp-server traps link-status ................................................................................................ 283
snmp-server traps ................................................................................................................. 283
snmp-server traps ddm ......................................................................................................... 284
snmp-server traps mac ......................................................................................................... 285
snmp-server traps vlan .......................................................................................................... 286
rmon history ........................................................................................................................... 287
rmon event ............................................................................................................................ 288
rmon alarm ............................................................................................................................ 289
show snmp-server ................................................................................................................. 291
show snmp-server view......................................................................................................... 291
show snmp-server group ...................................................................................................... 291
show snmp-server user ......................................................................................................... 292
show snmp-server community .............................................................................................. 292
show snmp-server host ......................................................................................................... 293
show snmp-server engineID ................................................................................................. 293
show rmon history ................................................................................................................. 293
show rmon event ................................................................................................................... 294
show rmon alarm ................................................................................................................... 294
Chapter 37 LLDP Commands ............................................................................. 296
lldp ......................................................................................................................................... 296
lldp hold-multiplier ................................................................................................................. 296
XIV
lldp timer ................................................................................................................................ 297
lldp receive ............................................................................................................................ 298
lldp transmit ........................................................................................................................... 298
lldp snmp-trap ........................................................................................................................ 299
lldp tlv-select .......................................................................................................................... 300
lldp med-fast-count ................................................................................................................ 300
lldp med-status ...................................................................................................................... 301
lldp med-tlv-select ................................................................................................................. 301
lldp med-location ................................................................................................................... 302
show lldp ............................................................................................................................... 303
show lldp interface ................................................................................................................ 303
show lldp local-information interface ..................................................................................... 304
show lldp neighbor-information interface .............................................................................. 304
show lldp traffic interface ....................................................................................................... 305
Chapter 38 Cluster Commands .......................................................................... 306
cluster ndp ............................................................................................................................. 306
cluster ntdp ............................................................................................................................ 307
cluster explore ....................................................................................................................... 308
cluster .................................................................................................................................... 308
cluster ip pool ........................................................................................................................ 309
cluster commander ................................................................................................................ 309
cluster manage ...................................................................................................................... 310
cluster member ..................................................................................................................... 310
cluster candidate .................................................................................................................... 311
cluster individual ..................................................................................................................... 311
show cluster ndp ................................................................................................................... 312
show cluster ntdp .................................................................................................................. 312
show cluster .......................................................................................................................... 313
show cluster member ............................................................................................................ 313
show cluster manage role ..................................................................................................... 314
show cluster neighbor ........................................................................................................... 314
Chapter 39 AAA Commands .............................................................................. 315
aaa enable ............................................................................................................................. 315
tacacs-server host ................................................................................................................. 316
show tacacs-server ............................................................................................................... 317
radius-server host ................................................................................................................. 317
XV
show radius-server ................................................................................................................ 318
aaa group .............................................................................................................................. 319
server .................................................................................................................................... 320
show aaa group ..................................................................................................................... 320
aaa authentication login ........................................................................................................ 321
aaa authentication enable ..................................................................................................... 322
aaa authentication dot1x default ........................................................................................... 323
aaa accounting dot1x default ................................................................................................ 323
show aaa authentication ....................................................................................................... 324
show aaa accounting ............................................................................................................ 324
line console ........................................................................................................................... 325
login authentication(console) ................................................................................................ 325
enable authentication(console) ............................................................................................. 326
line telnet ............................................................................................................................... 327
login authentication(telnet) .................................................................................................... 327
enable authentication(telnet) ................................................................................................. 328
line ssh .................................................................................................................................. 328
login authentication(ssh) ....................................................................................................... 329
enable authentication(ssh) .................................................................................................... 329
ip http login authentication .................................................................................................... 330
ip http enable authentication ................................................................................................. 331
show aaa global .................................................................................................................... 331
Chapter 40 DHCP Relay Commands ................................................................. 332
ip dhcp relay .......................................................................................................................... 332
ip dhcp relay helper-address ................................................................................................. 332
ip dhcp relay information option ............................................................................................ 333
ip dhcp relay information strategy ......................................................................................... 333
ip dhcp relay information circuit-id ........................................................................................ 334
ip dhcp relay information remote-id ...................................................................................... 334
show ip dhcp relay ................................................................................................................ 335
show ip dhcp relay helper-address ....................................................................................... 335
XVI
T2500-28TC
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 T2500-28TC 24-Port
10/100Mbps + 4-Port Gigabit JetStream L2 Managed Switch.
When using this guide, please notice that features of the switch may vary slightly depending on the
model and software version you have, and on your location, language, and Internet service
provider. All parameters and descriptions documented in this guide are used for demonstration
only.
The information in this document is subject to change without notice. Every effort has been made
in the preparation of this document to ensure accuracy of the contents, but all statements,
information, and recommendations in this document do not constitute the warranty of any kind,
express or implied. Users must take full responsibility for their application of any products.
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: MAC-based VLAN Commands
Provide information about the commands used for configuring MAC-Based VLAN.
Chapter 5: Protocol-based VLAN Commands
Provide information about the commands used for configuring Protocol-based VLAN.
Chapter 6: VLAN-VPN Commands
Provide information about the commands used for configuring VLAN-VPN (Virtual Private Network)
function.
Chapter 7: Voice VLAN Commands
Provide information about the commands used for configuring Voice VLAN.
Chapter 8: Private VLAN Commands
Provide information about the commands used for configuring Private VLAN.
Chapter 9: GVRP Commands
1
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Provide information about the commands used for configuring GVRP (GARP VLAN registration
protocol).
Chapter 10: EtherChannel Commands
Provide information about the commands used for configuring LAG (Link Aggregation Group) and
LACP (Link Aggregation Control Protocol).
Chapter 11: User Manage Commands
Provide information about the commands used for user management.
Chapter 12: 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
server, and record the IP address, MAC address, VLAN and the connected Port number of the
Host for automatic binding.
Chapter 13: ARP Inspection Commands
Provide information about the commands used for protecting the switch from the ARP cheating or
ARP Attack.
Chapter 14: IP Verify Source Commands
Provide information about the commands used for guarding the IP Source by filtering the IP
packets based on the IP-MAC Binding entries.
Chapter 15: DoS Defend Command
Provide information about the commands used for DoS defend and detecting the DoS attack.
Chapter 16: IEEE 802.1X Commands
Provide information about the commands used for configuring IEEE 802.1X function.
Chapter 17: PPPoE Circuit-ID Insertion Commands
Provide information about the commands used for configuring PPPoE Circuit-ID function.
Chapter 18: System Log Commands
Provide information about the commands used for configuring system log.
Chapter 19: SSH Commands
Provide information about the commands used for configuring and managing SSH (Security
Shell).
Chapter 20: SSL Commands
Provide information about the commands used for configuring and managing SSL (Secure
Sockets Layer).
Chapter 21: MAC Address Commands
2
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Provide information about the commands used for MAC address configuration.
Chapter 22: 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 23: IPv6 Address Configuration Commands
Provide information about the commands used for configuring the System IPv6 addresses.
Chapter 24: Ethernet Configuration Commands
Provide information about the commands used for configuring the Bandwidth Control, Negotiation
Mode, and Storm Control for ethernet ports.
Chapter 25: QoS Commands
Provide information about the commands used for configuring the QoS function.
Chapter 26: Port Mirror Commands
Provide information about the commands used for configuring the Port Mirror function.
Chapter 27: Port isolation Commands
Provide information about the commands used for configuring the Port isolation function.
Chapter 28: Loopback Detection Commands
Provide information about the commands used for loopback detection.
Chapter 29: DDM Commands
Provide information about the commands used for DDM (Digtal Diagnostic Monitoring) function.
Chapter 30: ACL Commands
Provide information about the commands used for configuring the ACL (Access Control List).
Chapter 31: MSTP Commands
Provide information about the commands used for configuring the MSTP (Multiple Spanning Tree
Protocol).
Chapter 32: Ethernet OAM Commands
Provide information about the commands used for configuring the Ethernet OAM (Operation,
Administration, and Maintenance) function.
Chapter 33: DLDP Commands
Provide information about the commands used for configuring the DLDP (Device Link Detection
Protocol).
Chapter 34: IGMP Snooping Commands
Provide information about the commands used for configuring the IGMP Snooping (Internet Group
Management Protocol Snooping).
3
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Chapter 35: MLD Snooping Commands
Provide information about the commands used for configuring the MLD Snooping (Multicast
Listener Discovery Snooping).
Chapter 36: SNMP Commands
Provide information about the commands used for configuring the SNMP (Simple Network
Management Protocol) functions.
Chapter 37: LLDP Commands
Provide information about the commands used for configuring the LLDP functions.
Chapter 38: Cluster Commands
Provide information about the commands used for configuring the Cluster Management function.
Chapter 39: AAA Commands
Provide information about the commands used for configuring the AAA function.
Chapter 40: DHCP Relay Commands
Provide information about the commands used for configuring the DHCP Relay function.
4
T2500-28TC
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 three methods:
1. Log on to the switch by the console port on the switch.
2. Log on to the switch remotely by a Telnet connection through an Ethernet port.
3. Log on to the switch remotely by an SSH connection through an Ethernet port.
1.1.1 Logon by a console port
Take the following steps to log on to the switch by the console port.
1. Connect the PCs or Terminals to the console port on the switch by the provided cable.
2. Start the terminal emulation program (such as the HyperTerminal) on the PC.
3. Configure the terminal emulation program or the terminal to use the following settings:
Baud rate: 38400 bps
Data bits: 8
Parity: none
Stop bits: 1
Flow control: none
4. The DOS prompt “T2500-28TC>” will appear after pressing the Enter button as shown in
Figure 1-1. It indicates that you can use the CLI now.
5
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Figure 1-1 Log in the Switch
1.1.2 Logon by Telnet
For Telnet connection, you should also configure the Telnet login mode and login authentication
information 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 doesn’t require username and password, but a connection password is required.
Before Telnet login, you are required to configure Telnet login mode and login authentication
information through console connection.
Login Local Mode
Firstly, configure the Telnet login mode as “login local” in the prompted DOS screen shown in
Figure 1-2.
Figure 1-2 Configure login local mode
6
T2500-28TC
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 and type in cmd in the
Search programs and files window and press the Enter button.
Figure 1-3 Run Window
2. Type telnet 192.168.0.1 in the command prompt shown as Figure 1-4, and press the Enter
button.
Figure 1-4 Connecting to the Switch
3. Type the default user name and password (both of them are admin), then press the Enter
button so as to enter User EXEC Mode.
Figure 1-5 Enter into the User EXEC Mode
7
T2500-28TC
JetStream L2 Managed Switch CLI Guide
4. Type enable command to enter Privileged EXEC Mode.
Figure 1-6 Enter into the Priviledged EXEC Mode
Now you can manage your switch with CLI commands through Telnet connection.
Login Mode
Firstly configure the Telnet login mode as “login” and the connection password as 456 in the
prompted DOS screen shown in Figure 1-7.
Figure 1-7 Configure login mode
Now, you can logon by Telnet in login mode:
1. Make sure the switch and the PC are in the same LAN. Click Start and type in cmd in the
Search programs and files window and press the Enter button.
8
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Figure 1-8 Run Window
2. Type telnet 192.168.0.1 in the command prompt shown as Figure 1-9, and press the Enter
button.
Figure 1-9 Connecting to the Switch
3. You are prompted to enter the connection password 456 you have set through Console port
connection, and then you are in User EXEC Mode.
Figure 1-10 Enter into the User EXEC Mode
9
T2500-28TC
JetStream L2 Managed Switch CLI Guide
4. Type enable command to enter Privileged EXEC Mode.
Figure 1-11 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 Management Commands for detailed commands information
of the Telnet connection configuration.
1.1.3 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-12 to enable the SSH function
through Telnet connection.
Figure 1-12 Enable SSH function
10
T2500-28TC
JetStream L2 Managed Switch CLI Guide
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-13 SSH Connection Config
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-14 Log on the Switch
11
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Key Authentication Mode
1. Select the key type and key length, and generate SSH key.
Figure 1-15 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.
12
T2500-28TC
JetStream L2 Managed Switch CLI Guide
2. After the key is successfully generated, please save the public key to a TFTP server and save
the private key on the local host.
Figure 1-16 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-17 Download the Public Key
13
T2500-28TC
JetStream L2 Managed Switch CLI Guide
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-18 SSH Connection Config
14
T2500-28TC
JetStream L2 Managed Switch CLI Guide
5. Click Browse to download the private key file to SSH client software and click Open.
Figure 1-19 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-20 Log on the Switch
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 Database (VLAN
15
T2500-28TC
JetStream L2 Managed Switch CLI Guide
command to
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
Privileged
EXEC Mode
Primary mode once it is
connected with the
switch.
Use the enable
command to enter this
mode from User EXEC
mode.
T2500-28TC>
T2500-28TC #
switch (except that the switch is
connected through the Console port).
Use the enable command to access
Privileged EXEC mode.
Enter the disable or the exit
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.
Global
Configuration
Mode
Use the configure
command to enter this
mode from Privileged
EXEC mode.
T2500-28TC(config)#
16
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.
T2500-28TC
JetStream L2 Managed Switch CLI Guide
to
to
Mode Accessing Path Prompt Logout or Access the next mode
Interface
Configuration
Mode
VLAN
Configuration
Mode
Use the interface
fastEthernet/gigabitEth
ernet port or interface
range fastEthernet/
gigabitEthernet port-list
command to enter this
mode from Global
Configuration mode.
Use the vlan vlan-list
command to enter this
mode from Global
Configuration mode.
T2500-28TC(config-if)#
T2500-28TC(config-if-
range)#
T2500-28TC(configvlan)#
Use the end command or press Ctrl+Z
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.
Use the end command or press Ctrl+Z
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.
17
T2500-28TC
JetStream L2 Managed Switch CLI Guide
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/SSH. 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.
18
T2500-28TC
JetStream L2 Managed Switch CLI Guide
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:
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).
19
T2500-28TC
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:
T2500-28TC>enable
Enter password：
T2500-28TC#
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 [secret {simple | cipher} ]
no enable password
Parameter
password —— super password ， which contains 31 characters at most,
composing digits, English letters and underdashes only. By default, it is empty.
simple | cipher —— The way of displaying password in configuration file. By
default, it is “cipher”.
Command Mode
Global Configuration Mode
Example
Set the super password as “admin” to access Privileged EXEC Mode from User
EXEC Mode:
20
T2500-28TC
JetStream L2 Managed Switch CLI Guide
disable
Description
Syntax
Command Mode
Example
T2500-28TC(config)#enable password admin
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:
configure
Description
Syntax
Command Mode
Example
T2500-28TC#disable
T2500-28TC>
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:
T2500-28TC#configure
T2500-28TC(config)#
21
T2500-28TC
JetStream L2 Managed Switch CLI Guide
exit
Description
The exit command is used to return to the previous Mode from the current
Mode.
Syntax
exit
Command Mode
Any Configuration Mode
Example
Return to Global Configuration Mode from Interface Configuration Mode, and
then return to Privileged EXEC Mode:
T2500-28TC(config-if)#exit
T2500-28TC(config)#exit
end
T2500-28TC#
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:
T2500-28TC(config-if)#end
T2500-28TC#
22
T2500-28TC
JetStream L2 Managed Switch CLI Guide
history
Description
Syntax
Command Mode
Example
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:
T2500-28TC (config)# history
history clear
Description
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.
Syntax
history clear
Command Mode
Privileged EXEC Mode and any Configuration Mode
Example
Clear the commands you have entered in the current mode:
1 history
T2500-28TC(config)#history clear
23
T2500-28TC
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:
T2500-28TC(config)#vlan 2-10,100
Delete VLAN 2:
T2500-28TC(config)#no vlan 2
24
T2500-28TC
JetStream L2 Managed Switch CLI Guide
interface vlan
Description
The interface vlan command is used to create VLAN Interface hereafter to
access to Interface VLAN Mode.
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
name
Description
Syntax
Parameter
Create VLAN Interface 2:
T2500-28TC(config)#interface vlan 2
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.
Command Mode
VLAN Configuration Mode（VLAN）
25
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Example
Specify the description string of the VLAN 2 as “VLAN002”:
T2500-28TC(config)#vlan 2
T2500-28TC(config-vlan)#name VLAN002
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”:
T2500-28TC(config)#interface fastEthernet 1/0/3
T2500-28TC(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
26
T2500-28TC
JetStream L2 Managed Switch CLI Guide
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)
Example
Configure Fast Ethernet port 3 whose link type is “access” to VLAN 2:
T2500-28TC(config)#interface fastEthernet 1/0/3
T2500-28TC(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. To remove a Trunk port from the corresponding
VLAN, please use no switchport trunk allowed vlan command.
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 the link type of port 2 as trunk and add it to VLAN 2:
T2500-28TC(config)#interface fastEthernet 1/0/2
T2500-28TC(config-if)#switchport mode trunk
T2500-28TC(config-if)#switchport trunk allowed vlan 2
27
T2500-28TC
JetStream L2 Managed Switch CLI Guide
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.
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”:
T2500-28TC(config)#interface fastEthernet 1/0/4
T2500-28TC(config-if)#switchport mode general
T2500-28TC(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
28
T2500-28TC
JetStream L2 Managed Switch CLI Guide
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)
Example
Specify the PVID of Fast Ethernet port 3 as 1:
T2500-28TC(config)#interface fastEthernet 1/0/3
T2500-28TC(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:
T2500-28TC(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
29
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Command Mode
Example
show vlan
Description
Syntax
Privileged EXEC Mode and Any Configuration Mode
Display the brief information of IEEE 802.1Q VLAN:
T2500-28TC(config)#show vlan brief
The show vlan command is used to display the detailed information of IEEE
802.1Q VLAN. By default, the detailed information of all the ports will be
displayed.
show vlan [id vlan-list]
Parameter
vlan-list —— Specify IEEE 802.1Q VLAN ID, ranging from 1 to 4094.
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the detailed information of VLAN 2-10:
T2500-28TC(config)#show vlan id 2-10
30
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Chapter 4 MAC-based VLAN Commands
MAC VLAN (Virtual Local Area Network) is the way to classify the VLANs based on MAC address.
A MAC address is relative to a single VLAN ID. The untagged packets and the priority-tagged
packets coming from the MAC address will be tagged with this VLAN ID.
mac-vlan mac-address
Description
The mac-vlan mac-address command is used to create a MAC-based VLAN
entry. To delete a MAC-based VLAN entry, please use the no mac-vlan
mac-address command.
Syntax
mac-vlan mac-address mac-addr vlan vlan-id [description descript]
no mac-vlan mac-address mac-addr
Parameter
mac-addr —— MAC address, in the format of XX:XX:XX:XX:XX:XX.
vlan-id —— Specify IEEE 802.1Q VLAN ID, ranging from 1 to 4094.
descript —— Give a description to the MAC address for identification, which
contains 8 characters at most.
Command Mode
Global Configuration Mode
Example
Create VLAN 2, named “TP”, and the MAC address is 00:11:11:01:01:12:
T2500-28TC(config)#mac-vlan mac-address 00:11:11:01:01:12 vlan 2
description TP
31
T2500-28TC
JetStream L2 Managed Switch CLI Guide
mac-vlan
Description
The mac-vlan command is used to enable a port for the MAC-based VLAN
feature. Only the port is enabled can the configured MAC-based VLAN take
effect. To disable the MAC-based VLAN function, please use no mac-vlan
command. All the ports are disabled by default.
Syntax
mac-vlan
no mac-vlan
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
Example
Enable the Fast Ethernet port 3 for the MAC-based VLAN feature:
T2500-28TC(config)#interface fastEthernet 1/0/3
T2500-28TC(config-if)#mac-vlan
show mac-vlan
Description
The show mac-vlan command is used to display the information of the
MAC-based VLAN entry. MAC address and VLAN ID can be used to filter the
displayed information.
Syntax
show mac-vlan { all | mac-address mac-addr | vlan vlan-id }
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Parameter
mac-addr —— MAC address, in the format of XX:XX:XX:XX:XX:XX.
vlan-id —— Specify IEEE 802.1Q VLAN ID, ranging from 1 to 4094.
32
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Example
Display the information of all the MAC-based VLAN entry:
T2500-28TC(config)#show mac-vlan all
show mac-vlan interface
Description
The show mac-vlan interface command is used to display the port state of
MAC-based VLAN.
Syntax
show mac-vlan interface
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the enable state of all the ports:
T2500-28TC(config)#show mac-vlan interface
33
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Chapter 5 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:
T2500-28TC(config)#protocol-vlan template name TP ether-type 2024
34
T2500-28TC
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-id —— 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:
T2500-28TC(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.
35
T2500-28TC
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:
T2500-28TC(config)#interface gigabitEthernet 1/0/25
T2500-28TC(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:
T2500-28TC(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.
36
T2500-28TC
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:
T2500-28TC(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:
T2500-28TC(config)#show protocol-vlan interface
37
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Chapter 6 VLAN-VPN Commands
VLAN-VPN (Virtual Private Network) function, the implement of a simple and flexible Layer 2 VPN
technology, allows the packets with VLAN tags of private networks to be encapsulated with VLAN
tags of public networks at the network access terminal of the Internet Service Provider. And these
packets will be transmitted with double-tag across the public networks.
dot1q-tunnel
Description
The dot1q-tunnel command is used to enable the VLAN-VPN function globally.
To disable the VLAN-VPN function, please use the no dot1q-tunnel command.
Syntax
dot1q-tunnel
no dot1q-tunnel
Command Mode
Global Configuration Mode
Example
Enable the VLAN-VPN function globally:
T2500-28TC(config)#dot1q-tunnel
dot1q-tunnel tpid
Description
The dot1q-tunnel tpid command is used to configure Global TPID of the
VLAN-VPN. To restore to the default value, please use the no dot1q-tunnel
tpid command.
Syntax
dot1q-tunnel tpid num
no dot1q-tunnel tpid
38
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Parameter
num —— The value of Global TPID. It must be 4 Hex integers. By default, it is
8100.
Command Mode
Global Configuration Mode
Example
Configure Global TPID of the VLAN-VPN as 0x9100:
T2500-28TC(config)#dot1q-tunnel tpid 9100
dot1q-tunnel mapping
Description
The dot1q-tunnel mapping command is used to add the VLAN Mapping entry.
To delete the VLAN Mapping entry, please use the no dot1q-tunnel mapping
command.
Syntax
dot1q-tunnel mapping c-vlan sp-vlan [descript]
no dot1q-tunnel mapping c-vlan
Parameter
c-vlan —— Customer VLAN ID, ranging from 1 to 4094.
sp-vlan —— Service Provider VLAN ID, ranging from 1 to 4094.
descript —— Give a description to the VLAN Mapping entry, which contains 15
characters at most.
Command Mode
Global Configuration Mode
Example
Add a VLAN Mapping entry named “TP” with the C-VLAN being 2 and the
SP-VLAN being 10:
T2500-28TC(config)#dot1q-tunnel mapping 2 10 TP
39
T2500-28TC
JetStream L2 Managed Switch CLI Guide
switchport dot1q-tunnel mapping
Description
The switchport dot1q-tunnel mapping command is used to enable the VLAN
Mapping feature for a specified port. To disable the VLAN Mapping feature of
this port, please use the no switchport dot1q-tunnel mapping command. By
default, the VLAN Mapping feature of all ports is disabled.
Syntax
switchport dot1q-tunnel mapping
no switchport dot1q-tunnel mapping
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
Example
Enable the VLAN Mapping feature for the Fast Ethernet port 3:
T2500-28TC(config)#interface fastEthernet 1/0/3
T2500-28TC(config-if)#switchport dot1q-tunnel mapping
switchport dot1q-tunnel mode uplink
Description
The switchport dot1q-tunnel mode uplink command is used to configure a
specified port as the VPN Up-link port. To cancel this VPN Up-link port, please
use the no switchport dot1q-tunnel mode uplink command. By default, no
port has been configured as the VPN Up-link port.
Syntax
switchport dot1q-tunnel mode uplink
no switchport dot1q-tunnel mode uplink
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
40
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Example
Configure the Fast Ethernet port 3 as the VPN Up-link ports:
T2500-28TC(config)#interface fastEthernet 1/0/3
T2500-28TC(config-if)#switchport dot1q-tunnel mode uplink
show dot1q-tunnel
Description
The show dot1q-tunnel command is used to display the global configuration
information of the VLAN VPN.
Syntax
show dot1q-tunnel
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the global configuration information of the VLAN VPN:
T2500-28TC(config)#show dot1q-tunnel
show dot1q-tunnel mapping
Description
The show dot1q-tunnel mapping command is used to display the information
of VLAN Mapping entry.
Syntax
show dot1q-tunnel mapping
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the information of VLAN Mapping entry:
T2500-28TC(config)#show dot1q-tunnel mapping
41
T2500-28TC
JetStream L2 Managed Switch CLI Guide
show dot1q-tunnel mapping interface
Description
The show dot1q-tunnel mapping interface command is used to display the
VLAN Mapping port enable state of VLAN Mapping
Syntax
show dot1q-tunnel mapping interface
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the enable state of all VLAN Mapping ports:
T2500-28TC(config)#show dot1q-tunnel mapping interface
show dot1q-tunnel uplink
Description
The show dot1q-tunnel uplink command is used to display the configuration
information of the VLAN VPN Up-link ports.
Syntax
show dot1q-tunnel uplink
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the configuration information of the VLAN VPN Up-link ports:
T2500-28TC(config)# show dot1q-tunnel uplink
42
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Chapter 7 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:
T2500-28TC(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.
Syntax
voice vlan aging time time
43
T2500-28TC
JetStream L2 Managed Switch CLI Guide
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:
T2500-28TC(config)#voice vlan aging time 1
voice vlan priority
Description
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. By default, the priority value is 6.
Syntax
voice vlan priority pri
no voice vlan priority
Parameter
pri —— Priority, ranging from 0 to 7.
Command Mode
Global Configuration Mode
Example
Configure the priority of the Voice VLAN as 5:
T2500-28TC(config)#voice vlan priority 5
44
T2500-28TC
JetStream L2 Managed Switch CLI Guide
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
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:
T2500-28TC(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 }
45
T2500-28TC
JetStream L2 Managed Switch CLI Guide
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:
T2500-28TC(config)#interface fastEthernet 1/0/3
T2500-28TC(config-if)#switchport voice vlan mode auto
switchport voice vlan security
Description
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.
Syntax
switchport voice vlan security
no switchport voice vlan security
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
Example
Enable the Fast Ethernet port 3 for Voice VLAN security feature:
T2500-28TC(config)#interface fastEthernet 1/0/3
T2500-28TC(config-if)#switchport voice vlan security
46
T2500-28TC
JetStream L2 Managed Switch CLI Guide
show voice vlan
Description
The show voice vlan command is used to display the global configuration
information of Voice VLAN.
Syntax
show voice vlan
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the configuration information of Voice VLAN globally:
T2500-28TC(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:
T2500-28TC(config)#show voice vlan oui
47
T2500-28TC
JetStream L2 Managed Switch CLI Guide
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.
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the configuration information of Fast Ethernet port 1 in the Voice VLAN:
T2500-28TC(config)#show voice vlan switchport fastEthernet 1/0/1
Display the configuration information of all the ports in the Voice VLAN:
T2500-28TC(config)#show voice vlan switchport
48
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Chapter 8 Private VLAN Commands
Private VLANs are configured specially for saving VLAN resource of uplink devices and decreasing
broadcast.
private-vlan primary
Description
The private-vlan primary command is used to configure the designated VLAN
as the primary VLAN of the Private VLAN. To abolish the currently primary
VLAN, please use no private-vlan primary command.
Syntax
private-vlan primary
no private-vlan primary
Command Mode
VLAN Configuration Mode (VLAN)
Example
Configure the VLAN 3 as the primary VLAN of the private VLAN:
T2500-28TC(config)#vlan 3
T2500-28TC(config-vlan)#private-vlan primary
private-vlan community
Description
The private-vlan community command is used to configure the designated
VLAN as the community VLAN of the Private VLAN. To invalid the currently
community VLAN, please use no private-vlan community command.
Syntax
private-vlan community
no private-vlan community
49
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Command Mode
VLAN Configuration Mode (VLAN)
Example
Configure the VLAN 4 as the community VLAN of the private VLAN:
T2500-28TC(config)#vlan 4
T2500-28TC(config-vlan)#private-vlan community
private-vlan association
Description
The private-vlan association command is used to associate primary VLAN
with secondary VLAN. To exterminate the currently association, please use no
private-vlan association command.
Syntax
private-vlan association vlan_list
no private-vlan association vlan_list
Parameter
vlan_list —— Secondary VLAN ID, ranging from 2 to 4049.
Command Mode
VLAN Configuration Mode (VLAN)
Example
Associate primary VLAN 3 with community VLAN 4 as a private VLAN:
T2500-28TC(config)#vlan 3
T2500-28TC(config-vlan)#private-vlan association 4
switchport private-vlan
Description
The switchport private-vlan command is used to configure the private VLAN
mode for the switchport. To invalid the configuration, please use no switchport
private-vlan command.
50
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Syntax
switchport private-vlan { promiscuous | host }
no switchport private-vlan { promiscuous | host }
Parameter
promiscuous | host —— Configure the private VLAN mode for the switchport.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
Example
Configure Fast Ethernet port 3 as “host”:
T2500-28TC(config)#interface fastEthernet 1/0/3
T2500-28TC(config-if)#switchport private-vlan host
switchport private-vlan host-association
Description
The switchport private-vlan host-association command is used to add host
type port to private VLAN. To remove the port from Private VLAN, please use no
switchport private-vlan host-association command.
Syntax
switchport private-vlan host-association primary_vlan_id secondary_vlan_id
no switchport private-vlan host-association primary_vlan_id
secondary_vlan_id
Parameter
primary-vlan-id —— Primary VLAN ID, ranging from 2 to 4094.
secondary-vlan-id —— Secondary VLAN ID, ranging from 2 to 4094.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
51
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Example
Configure host type Fast Ethernet port 3 as a member of primary VLAN 3 and
secondary VLAN 4:
T2500-28TC(config)#interface fastEthernet 1/0/3
T2500-28TC(config-if)#switchport private-vlan host-association 3 4
switchport private-vlan mapping
Description
The switchport private-vlan mapping command is used to add promiscuous
type port to private VLAN. To remove the port from Private VLAN, please use no
switchport private-vlan mapping command.
Syntax
switchport private-vlan mapping primary_vlan_id secondary_vlan_id
no switchport private-vlan mapping primary_vlan_id secondary_vlan_id
Parameter
primary-vlan-id —— Primary VLAN ID, ranging from 2 to 4094.
secondary-vlan-id —— Secondary VLAN ID, ranging from 2 to 4094.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
Example
Configure promiscuous type Fast Ethernet port 3 as a member of primary VLAN
3 and secondary VLAN 4:
T2500-28TC(config)#interface fastEthernet 1/0/3
T2500-28TC(config-if)#switchport private-vlan mapping 3 4
52
T2500-28TC
JetStream L2 Managed Switch CLI Guide
show vlan private-vlan
Description
The show vlan private-vlan command is used to display the Private VLAN
configuration information of the switch.
Syntax
show vlan private-vlan
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the configuration information of all Private VLAN:
T2500-28TC(config)#show vlan private-vlan
53
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Chapter 9 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
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:
T2500-28TC(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
54
T2500-28TC
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:
T2500-28TC(config)#interface range fastEthernet 1/0/2-6
T2500-28TC(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:
T2500-28TC(config)#interface range fastEthernet 1/0/2-6
T2500-28TC(config-if-range)#gvrp registration fixed
55
T2500-28TC
JetStream L2 Managed Switch CLI Guide
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
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:
T2500-28TC(config)#interface fastEthernet 1/0/6
T2500-28TC(config-if)#gvrp timer leaveall 2000
T2500-28TC(config-if)#no gvrp timer join
56
T2500-28TC
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:
T2500-28TC(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:
T2500-28TC(config)#show gvrp interface fastEthernet 1/0/1
Display the GVRP configuration information of all Ethernet ports:
T2500-28TC(config)#show gvrp interface
57
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Chapter 10 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:
T2500-28TC(config)#interface range fastEthernet 1/0/2-4
T2500-28TC(config-if-range)#channel-group 1 mode on
58
T2500-28TC
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”:
T2500-28TC(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
system-priority command.
Syntax
lacp system-priority pri
no lacp system-priority
Parameter
pri —— The system priority, ranging from 0 to 65535. It is 32768 by default.
59
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Command Mode
Global Configuration Mode
Example
Configure the LACP system priority as 1024 globally:
T2500-28TC(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:
T2500-28TC(config)#interface fastEthernet 1/0/1
T2500-28TC(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 }
60
T2500-28TC
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:
T2500-28TC(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:
T2500-28TC(config)#show etherchannel load-balance
show lacp
Description
The show lacp command is used to display the LACP information for a
specified EtherChannel Group.
Syntax
show lacp [ channel-group-num ] { internal | neighbor }
61
T2500-28TC
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:
T2500-28TC(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:
T2500-28TC(config)#show lacp sys-id
62
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Chapter 11 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
Parameter
disable | enable}] [secret {simple | cipher}]
no user name user-name
user-name ——Type a name for users' login, which contains 16 characters at
most, composing digits, English letters and under dashes only.
password ——Type a password for users' login, which contains 31 characters at
most, composing digits, English letters and under dashes 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 in configuration file. By
default, it is “cipher”.
Command Mode
Global Configuration Mode
Example
Add and enable a new admin user named “tplink”, of which the password is
“password”:
63
T2500-28TC
JetStream L2 Managed Switch CLI Guide
T2500-28TC(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:
T2500-28TC(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.
64
T2500-28TC
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:
T2500-28TC(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:
65
T2500-28TC
JetStream L2 Managed Switch CLI Guide
T2500-28TC(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:
T2500-28TC(config)#user max-num 5 3
user idle-timeout
Description
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.
Syntax
user idle-timeout minutes
no user idle-timeout
66
T2500-28TC
JetStream L2 Managed Switch CLI Guide
line
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:
T2500-28TC(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:
T2500-28TC(config)#line console 0
67
T2500-28TC
JetStream L2 Managed Switch CLI Guide
password
Description
Syntax
Parameter
Enter the Virtual Terminal configuration mode so as to prepare further
configurations such as password and login mode for virtual terminal 0 to 5:
T2500-28TC(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 [secret {simple | cipher} ]
no password
password —— Configure the connection password, which contains 16
characters at most, composing digits, English letters and under dashes only.
simple | cipher —— The way of displaying password in configuration file. By
default, it is “cipher”.
Command Mode
Line Configuration Mode
Example
Configure the connection password of Console port connection 0 as “tplink”:
T2500-28TC(config)#line console 0
T2500-28TC(config-line)#password tplink
Configure the connection password of virtual terminal connection 0-5 as “tplink”:
T2500-28TC(config)#line vty 0 5
T2500-28TC(config-line)#password tplink
68
T2500-28TC
JetStream L2 Managed Switch CLI Guide
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.
Syntax
login
Command Mode
Line Configuration Mode
Example
Configure the login of Console port connection 0 as login mode:
T2500-28TC(config)#line console 0
T2500-28TC(config-line)#login
Configure the login of virtual terminal connection 0-5 as login mode:
T2500-28TC(config)#line vty 0 5
T2500-28TC(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:
T2500-28TC(config)#line vty 0 5
T2500-28TC(config-line)#login local
69
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Configure the login of Console port connection 0 as login local mode:
T2500-28TC(config)#line console 0
T2500-28TC(config-line)#login local
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:
T2500-28TC(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:
T2500-28TC(config)#show user configuration
70
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Chapter 12 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 vlan-id interface
{ fastEthernet port | gigabitEthernet port } { none | arp-detection |
ip-verify-source | both } [ 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
vlan-id ——The VLAN ID needed to be bound, ranging from 1 to 4094.
port —— The number of port connected to the Host.
none | arp-detection | ip-verify-source | both ——The protect type for the entry.
“arp-detection” indicates ARP detection; “ip-verify-source” indicates IP source
filter; “none” indicates applying none; “both” indicates applying both.
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.
71
T2500-28TC
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 and IP filter function:
T2500-28TC(config)#ip source binding host1 192.168.0.1 00:00:00:00:00:01
vlan 2 interface fastEthernet 1/0/5 both
Delete the IP-MAC –VID-PORT entry with the index 5:
T2500-28TC(config)#no ip source binding index 5
ip source binding index
Description
The ip source binding index command is used to modify the existing entry of
ip source binding.
Syntax
ip source binding index idx {hostname hostname | mac mac-addr | vlan
vlan-id| interface { fastEthernet port | gigabitEthernet port} | none |
arp-detection | ip-verify-source | both }
Parameter
idx ——The entry number needed to be modified. 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 displayed in an arranged
order.
hostname ——The modified Host Name, which contains 20 characters at most.
mac-addr —— The modified MAC address of the Host.
vlan-id ——The modified VLAN ID, ranging from 1 to 4094.
port —— The modified number of port connected to the Host.
none | arp-detection | ip-verify-source | both ——The modified protect type for
the entry. “arp-detection” indicates ARP detection; “ip-verify-source” indicates IP
source filter; “none” indicates applying none; “both” indicates applying both.
72
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Command Mode
Global Configuration Mode
Example
Modify the hostname as “tp-link” of the entry with the index 1:
T2500-28TC(config)#ip source binding index 1 hostname tp-link
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:
T2500-28TC(config)#ip dhcp snooping
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.
73
T2500-28TC
JetStream L2 Managed Switch CLI Guide
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:
T2500-28TC(config)#ip dhcp snooping global global-rate 30 dec-threshold
20 dec-rate 20
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
74
T2500-28TC
JetStream L2 Managed Switch CLI Guide
no ip dhcp snooping information option
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
Example
Enable the Option 82 function of DHCP Snooping for port 2:
T2500-28TC(config)#interface fastEthernet 1/0/2
T2500-28TC(config-if)#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.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
Example
For port 2, replace the Option 82 field of the packets with the switch defined one
and then send out:
75
T2500-28TC
JetStream L2 Managed Switch CLI Guide
T2500-28TC(config)#interface fastEthernet 1/0/2
T2500-28TC(config-if)#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
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
Example
For port 2, enable and configure the customized sub-option Remote ID for the
Option 82 as tplink:
T2500-28TC(config)#interface fastEthernet 1/0/2
T2500-28TC(config-if)#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
default Circuit ID for the Option 82, please use no ip dhcp snooping
information circuit-id command.
76
T2500-28TC
JetStream L2 Managed Switch CLI Guide
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
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet)
Example
For port 2, enable and configure the customized sub-option Circuit ID for the
Option 82 as “tplink”:
T2500-28TC(config)#interface fastEthernet 1/0/2
T2500-28TC(config-if)#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)
Example
Configure the Fast Ethernet port 2 to be a Trusted Port:
T2500-28TC(config)#interface fastEthernet 1/0/2
T2500-28TC(config-if)#ip dhcp snooping trust
77
T2500-28TC
JetStream L2 Managed Switch CLI Guide
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:
T2500-28TC(config)#interface fastEthernet 1/0/2
T2500-28TC(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.
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”.
78
T2500-28TC
JetStream L2 Managed Switch CLI Guide
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:
T2500-28TC(config)#interface fastEthernet 1/0/2
T2500-28TC(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:
T2500-28TC(config)#interface fastEthernet 1/0/2
T2500-28TC(config-if)#ip dhcp snooping decline
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
79
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the IP-MAC-VID-PORT binding table:
T2500-28TC(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:
T2500-28TC#show ip dhcp snooping
show ip dhcp snooping information interface
Description
The show ip dhcp snooping information interface command is used to
display the Option 82 configuration status of a desired Fast/Gigabit Ethernet
ports or of all Ethernet ports.
Syntax
show ip dhcp snooping information interface [ fastEthernet port |
gigabitEthernet port ]
Parameters
port ——The Fast/Gigabit Ethernet port number.
Command Mode
80
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Privileged EXEC Mode and Any Configuration Mode
Example
Display the Option 82 configuration status of all Ethernet ports:
T2500-28TC#show ip dhcp snooping information interface
Display the Option 82 configuration status of Fast Ethernet port 5:
T2500-28TC#show ip dhcp snooping information interface fastEthernet
1/0/5
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:
T2500-28TC#show ip dhcp snooping interface
Display the DHCP-Snooping configuration of Fast Ethernet port 5:
T2500-28TC#show ip dhcp snooping interface fastEthernet 1/0/5
81
T2500-28TC
JetStream L2 Managed Switch CLI Guide
Chapter 13 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:
T2500-28TC(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
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.
Syntax
ip arp inspection trust
no ip arp inspection trust
82
T2500-28TC
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:
T2500-28TC(config)#interface range fastEthernet 1/0/2-5
T2500-28TC(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:
T2500-28TC(config)#interface range fastEthernet 1/0/2-6
T2500-28TC(config-if-range)#ip arp inspection
83
Loading...