T3700G-28TQ
JetStream 28-Port Gigabit Stackable L3
Managed Switch
REV1.0.0
1910010949
I
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 © 2014 TP-LINK TECHNOLOGIES CO., LTD. All rights
reserved.
http://www.tp-link.com
II
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 Configuring the Privileged EXEC Mode Password............................................. 7
1.1.3 Logon by Telnet..................................................................................................8
1.1.4 Logon by SSH..................................................................................................12
1.2 CLI Command Modes ...................................................................................................17
1.3 Security Levels .............................................................................................................20
1.4 Conventions..................................................................................................................21
1.4.1 Format Conventions.........................................................................................21
1.4.2 Special Characters...........................................................................................21
1.4.3 Parameter Format ............................................................................................ 21
Chapter 2 User Interface...................................................................................... 22
enable....................................................................................................................................22
enable password ...................................................................................................................22
disable...................................................................................................................................23
configure................................................................................................................................23
exit.........................................................................................................................................24
end ........................................................................................................................................24
history....................................................................................................................................25
history clear ...........................................................................................................................25
Chapter 3 Stack.................................................................................................... 26
switch priority.........................................................................................................................26
switch renumber ....................................................................................................................26
switch authentication-mode ...................................................................................................27
switch stack-name.................................................................................................................28
switch stack-port....................................................................................................................28
show switch ...........................................................................................................................29
Chapter 4 IEEE 802.1Q VLAN Commands.......................................................... 30
vlan........................................................................................................................................30
interface vlan .........................................................................................................................31
name .....................................................................................................................................31
III
switchport mode ....................................................................................................................32
switchport access vlan...........................................................................................................32
switchport trunk allowed vlan.................................................................................................33
switchport general allowed vlan.............................................................................................34
switchport pvid.......................................................................................................................35
show interface switchport ......................................................................................................35
show vlan summary...............................................................................................................36
show vlan brief ......................................................................................................................36
show vlan ..............................................................................................................................37
Chapter 5 MAC-based VLAN Commands............................................................ 38
mac-vlan mac-address ..........................................................................................................38
mac-vlan................................................................................................................................39
show mac-vlan ......................................................................................................................39
show mac-vlan interface........................................................................................................ 40
Chapter 6 Protocol-based VLAN Commands....................................................... 41
protocol-vlan template ...........................................................................................................41
protocol-vlan vlan ..................................................................................................................42
protocol-vlan..........................................................................................................................42
show protocol-vlan template..................................................................................................43
show protocol-vlan vlan .........................................................................................................44
Chapter 7 VLAN-VPN Commands ....................................................................... 45
dot1q-tunnel ..........................................................................................................................45
dot1q-tunnel tpid....................................................................................................................45
dot1q-tunnel mapping............................................................................................................46
switchport dot1q-tunnel mapping...........................................................................................46
switchport dot1q-tunnel mode ...............................................................................................47
show dot1q-tunnel .................................................................................................................48
show dot1q-tunnel mapping ..................................................................................................48
show dot1q-tunnel interface ..................................................................................................49
Chapter 8 Voice VLAN Commands...................................................................... 50
voice vlan ..............................................................................................................................50
voice vlan aging.....................................................................................................................50
voice vlan priority...................................................................................................................51
voice vlan mac-address.........................................................................................................52
switchport voice vlan mode ...................................................................................................52
IV
switchport voice vlan security ................................................................................................53
show voice vlan .....................................................................................................................54
show voice vlan oui ...............................................................................................................54
show voice vlan switchport ....................................................................................................55
Chapter 9 Private VLAN Commands.................................................................... 56
private-vlan primary...............................................................................................................56
private-vlan community..........................................................................................................56
private-vlan isolated ..............................................................................................................57
private-vlan association.........................................................................................................57
switchport private-vlan...........................................................................................................58
switchport private-vlan host-association ................................................................................59
switchport private-vlan mapping ............................................................................................ 59
show vlan private-vlan...........................................................................................................60
show vlan private-vlan interface ............................................................................................61
Chapter 10 GVRP Commands............................................................................... 62
gvrp .......................................................................................................................................62
gvrp (interface) ......................................................................................................................62
gvrp registration.....................................................................................................................63
gvrp timer ..............................................................................................................................64
show gvrp global ...................................................................................................................65
show gvrp interface ...............................................................................................................65
Chapter 11 Etherchannel Commands .................................................................... 67
channel-group .......................................................................................................................67
port-channel load-balance .....................................................................................................68
lacp system-priority ...............................................................................................................68
lacp port-priority.....................................................................................................................69
show etherchannel ................................................................................................................70
show etherchannel load-balance...........................................................................................70
show lacp ..............................................................................................................................71
show lacp sys-id ....................................................................................................................71
Chapter 12 User Manage Commands.................................................................... 72
user name .............................................................................................................................72
user access-control ip-based.................................................................................................73
user access-control mac-based.............................................................................................73
user access-control port-based .............................................................................................74
V
user max-number ..................................................................................................................75
user idle-timeout....................................................................................................................75
line.........................................................................................................................................76
password ...............................................................................................................................77
login.......................................................................................................................................77
login local ..............................................................................................................................78
show user account-list...........................................................................................................79
show user configuration.........................................................................................................79
Chapter 13 Binding Table Commands.................................................................... 80
ip source binding ...................................................................................................................80
ip dhcp snooping ...................................................................................................................81
ip dhcp snooping global.........................................................................................................82
ip dhcp snooping information option......................................................................................83
ip dhcp snooping information strategy ...................................................................................83
ip dhcp snooping information user-defined............................................................................84
ip dhcp snooping information remote-id.................................................................................84
ip dhcp snooping information circuit-id ..................................................................................85
ip dhcp snooping trust ...........................................................................................................86
ip dhcp snooping mac-verify..................................................................................................86
ip dhcp snooping limit rate.....................................................................................................87
ip dhcp snooping decline .......................................................................................................88
show ip source binding..........................................................................................................88
show ip dhcp snooping ..........................................................................................................89
show ip dhcp snooping interface ...........................................................................................89
Chapter 14 ARP Inspection Commands................................................................. 91
ip arp inspection(global) ........................................................................................................91
ip arp inspection trust ............................................................................................................91
ip arp inspection(interface) ....................................................................................................92
ip arp inspection limit-rate......................................................................................................93
ip arp inspection recover .......................................................................................................93
show ip arp inspection...........................................................................................................94
show ip arp inspection interface ............................................................................................94
show ip arp inspection statistics ............................................................................................95
clear ip arp inspection statistics............................................................................................. 95
Chapter 15 IP Verify Source Commands................................................................ 97
ip verify source ......................................................................................................................97
VI
show ip verify source.............................................................................................................98
Chapter 16 DoS Defend Command ....................................................................... 99
ip dos-prevent........................................................................................................................99
ip dos-prevent type................................................................................................................99
show ip dos-prevent ............................................................................................................100
Chapter 17 IEEE 802.1X Commands....................................................................101
dot1x system-auth-control ...................................................................................................101
dot1x auth-method ..............................................................................................................101
dot1x guest-vlan(global) ......................................................................................................102
dot1x quiet-period................................................................................................................103
dot1x timeout.......................................................................................................................103
dot1x max-reauth-req ..........................................................................................................104
dot1x....................................................................................................................................105
dot1x guest-vlan(interface) ..................................................................................................105
dot1x port-control ................................................................................................................106
dot1x port-method ...............................................................................................................107
radius...................................................................................................................................107
radius server-account..........................................................................................................108
show dot1x global................................................................................................................109
show dot1x interface ...........................................................................................................109
show radius accounting....................................................................................................... 110
show radius authentication .................................................................................................. 110
Chapter 18 System Log Commands .....................................................................112
logging buffer....................................................................................................................... 112
logging buffer level .............................................................................................................. 112
logging file flash................................................................................................................... 113
logging file flash frequency .................................................................................................. 114
logging file flash level .......................................................................................................... 114
logging host index ............................................................................................................... 115
copy logging flash tftp.......................................................................................................... 116
clear logging ........................................................................................................................ 116
show logging local-config ....................................................................................................117
show logging loghost........................................................................................................... 117
show logging buffer .............................................................................................................118
show logging flash............................................................................................................... 119
VII
Chapter 19 SSH Commands.................................................................................120
ip ssh server ........................................................................................................................120
ip ssh version ......................................................................................................................120
ip ssh timeout ......................................................................................................................121
ip ssh max-client..................................................................................................................121
ip ssh download...................................................................................................................122
remove public-key ...............................................................................................................123
show ip ssh..........................................................................................................................123
Chapter 20 SSL Commands .................................................................................124
ip http secure-server............................................................................................................124
ip http secure-server download certificate ...........................................................................124
ip http secure-server download key.....................................................................................125
show ip http secure-server ..................................................................................................126
Chapter 21 MAC Address Commands ..................................................................127
mac address-table static......................................................................................................127
mac address-table aging-time .............................................................................................128
mac address-table filtering ..................................................................................................128
mac address-table max-mac-count .....................................................................................129
show mac address-table......................................................................................................130
show mac address-table aging-time....................................................................................131
show mac address-table max-mac-count ............................................................................131
show mac address-table interface.......................................................................................132
show mac address-table count............................................................................................132
show mac address-table address........................................................................................133
show mac address-table vlan .............................................................................................. 134
Chapter 22 System Configuration Commands......................................................135
system-time manual ............................................................................................................135
system-time ntp ...................................................................................................................135
system-time dst predefined .................................................................................................137
system-time dst date ...........................................................................................................138
system-time dst recurring ....................................................................................................139
hostname.............................................................................................................................140
location................................................................................................................................140
contact-info..........................................................................................................................141
ip address............................................................................................................................142
VIII
ip address-alloc ...................................................................................................................142
reset ....................................................................................................................................143
reboot ..................................................................................................................................144
copy running-config startup-config ......................................................................................144
copy running-config backup-config......................................................................................145
copy running-config user-config ..........................................................................................145
copy backup-config startup-config.......................................................................................146
copy startup-config backup-config.......................................................................................146
boot application ...................................................................................................................147
boot config...........................................................................................................................148
copy backup-config tftp........................................................................................................148
copy startup-config tftp ........................................................................................................ 149
copy tftp backup-config........................................................................................................150
copy tftp startup-config ........................................................................................................ 151
copy image tftp-source ........................................................................................................152
copy image tftp-target..........................................................................................................152
copy image ..........................................................................................................................153
remove backup-image.........................................................................................................154
remove config......................................................................................................................154
firmware upgrade ................................................................................................................155
ping .....................................................................................................................................156
tracert ..................................................................................................................................156
loopback interface ...............................................................................................................157
show system-time................................................................................................................158
show system-time dst..........................................................................................................158
show system-time ntp
..........................................................................................................159
show system-info.................................................................................................................159
show environment ...............................................................................................................160
show files-in-system ............................................................................................................160
show image-info ..................................................................................................................161
show running-config ............................................................................................................162
show boot ............................................................................................................................162
show cable-diagnostics interface.........................................................................................163
show cpu-utilization .............................................................................................................163
show memory-utilization......................................................................................................164
Chapter 23 Ethernet Configuration Commands ....................................................165
interface fastEthernet ..........................................................................................................165
IX
interface range fastEthernet ................................................................................................165
interface gigabitEthernet......................................................................................................166
interface range gigabitEthernet ...........................................................................................166
interface ten-gigabitEthernet ...............................................................................................167
interface range ten-gigabitEthernet .....................................................................................168
description ...........................................................................................................................169
shutdown .............................................................................................................................169
flow-control ..........................................................................................................................170
duplex..................................................................................................................................171
speed...................................................................................................................................171
storm-control broadcast.......................................................................................................172
storm-control multicast ........................................................................................................173
storm-control unicast ........................................................................................................... 174
bandwidth ............................................................................................................................175
clear counters......................................................................................................................175
show interface status........................................................................................................... 176
show interface counters.......................................................................................................176
show interface configuration................................................................................................177
show storm-control ..............................................................................................................178
show bandwidth...................................................................................................................178
Chapter 24 QoS Commands.................................................................................180
qos ......................................................................................................................................180
qos dscp..............................................................................................................................181
qos queue cos-map.............................................................................................................181
qos queue dscp-map...........................................................................................................182
qos queue mode..................................................................................................................183
show qos interface ..............................................................................................................184
show qos cos-map ..............................................................................................................184
show qos dscp-map ............................................................................................................185
show qos queue mode ........................................................................................................185
show qos status...................................................................................................................186
Chapter 25 Port Mirror Commands .......................................................................187
monitor session destination interface ..................................................................................187
monitor session source interface.........................................................................................188
show monitor session..........................................................................................................189
Chapter 26 Port isolation Commands ...................................................................190
X
port isolation ........................................................................................................................190
show port isolation...............................................................................................................191
Chapter 27 ACL Commands .................................................................................192
time-range ...........................................................................................................................192
absolute............................................................................................................................... 192
periodic................................................................................................................................193
holiday.................................................................................................................................194
holiday(global) .....................................................................................................................194
access-list create.................................................................................................................195
mac access-list....................................................................................................................195
access-list standard.............................................................................................................196
access-list extended............................................................................................................197
rule ......................................................................................................................................198
access-list policy name........................................................................................................199
access-list policy action.......................................................................................................200
redirect interface..................................................................................................................201
s-condition ...........................................................................................................................201
s-mirror ................................................................................................................................202
qos-remark ..........................................................................................................................202
access-list bind(interface).................................................................................................... 203
access-list bind(vlan)...........................................................................................................203
show time-range..................................................................................................................204
show holiday........................................................................................................................204
show access-list ..................................................................................................................205
show access-list policy ........................................................................................................205
show access-list bind ..........................................................................................................206
Chapter 28 MSTP Commands ..............................................................................207
spanning-tree(global)...........................................................................................................207
spanning-tree(interface) ......................................................................................................207
spanning-tree common-config .............................................................................................208
spanning-tree mode.............................................................................................................209
spanning-tree mst configuration ..........................................................................................210
instance...............................................................................................................................210
name ................................................................................................................................... 211
revision................................................................................................................................ 211
spanning-tree mst instance .................................................................................................212
XI
spanning-tree mst................................................................................................................213
spanning-tree priority........................................................................................................... 214
spanning-tree tc-defend.......................................................................................................214
spanning-tree timer..............................................................................................................215
spanning-tree hold-count..................................................................................................... 216
spanning-tree max-hops......................................................................................................216
spanning-tree bpdufilter....................................................................................................... 217
spanning-tree bpduguard ....................................................................................................217
spanning-tree guard loop.....................................................................................................218
spanning-tree guard root .....................................................................................................218
spanning-tree guard tc.........................................................................................................219
spanning-tree mcheck ......................................................................................................... 220
show spanning-tree active................................................................................................... 220
show spanning-tree bridge ..................................................................................................221
show spanning-tree interface ..............................................................................................221
show spanning-tree interface-security.................................................................................222
show spanning-tree mst ......................................................................................................222
Chapter 29 IGMP Snooping Commands...............................................................224
ip igmp snooping(global) .....................................................................................................224
ip igmp snooping(interface) .................................................................................................224
ip igmp snooping immediate-leave ...................................................................................... 225
ip igmp snooping drop-unknown..........................................................................................225
ip igmp snooping vlan-config ...............................................................................................226
ip igmp snooping max-groups .............................................................................................227
ip igmp snooping multi-vlan-config ......................................................................................228
ip igmp snooping querier vlan..............................................................................................229
ip igmp snooping querier vlan (general query) ....................................................................230
ip igmp snooping querier vlan (specific query) ....................................................................231
show ip igmp snooping........................................................................................................232
show ip igmp snooping interface .........................................................................................232
show ip igmp snooping vlan ................................................................................................233
show ip igmp snooping multi-vlan........................................................................................ 233
show ip igmp snooping groups ............................................................................................ 234
show ip igmp snooping querier............................................................................................234
Chapter 30 SNMP Commands..............................................................................236
snmp-server ........................................................................................................................236
XII
snmp-server view ................................................................................................................236
snmp-server group ..............................................................................................................237
snmp-server user ................................................................................................................238
snmp-server community ......................................................................................................240
snmp-server host.................................................................................................................241
snmp-server engineID .........................................................................................................242
snmp-server traps snmp...................................................................................................... 243
snmp-server traps link-status...............................................................................................244
snmp-server traps................................................................................................................244
snmp-server traps mac........................................................................................................ 245
snmp-server traps vlan........................................................................................................246
rmon history.........................................................................................................................247
rmon event ..........................................................................................................................248
rmon alarm ..........................................................................................................................249
rmon statistics .....................................................................................................................250
show snmp-server ...............................................................................................................251
show snmp-server view .......................................................................................................251
show snmp-server group .....................................................................................................252
show snmp-server user .......................................................................................................252
show snmp-server community.............................................................................................253
show snmp-server host .......................................................................................................253
show snmp-server engineID................................................................................................253
show rmon history ...............................................................................................................254
show rmon event ................................................................................................................
.254
show rmon alarm
.................................................................................................................255
show rmon statistics ............................................................................................................255
Chapter 31 LLDP Commands ...............................................................................257
lldp.......................................................................................................................................257
lldp hold-multiplier................................................................................................................257
lldp timer..............................................................................................................................258
lldp receive ..........................................................................................................................259
lldp transmit .........................................................................................................................259
lldp snmp-trap......................................................................................................................260
lldp tlv-select........................................................................................................................260
lldp med-fast-count..............................................................................................................261
lldp med-status ....................................................................................................................262
lldp med-tlv-select................................................................................................................262
XIII
lldp med-location .................................................................................................................263
show lldp .............................................................................................................................264
show lldp interface...............................................................................................................264
show lldp local-information interface....................................................................................265
show lldp neighbor-information interface .............................................................................265
show lldp traffic interface.....................................................................................................266
Chapter 32 Cluster Commands.............................................................................267
cluster ndp...........................................................................................................................267
cluster ntdp.......................................................................................................................... 268
cluster explore .....................................................................................................................269
cluster..................................................................................................................................269
cluster ip pool ......................................................................................................................270
cluster commander ..............................................................................................................270
cluster manage....................................................................................................................271
cluster member....................................................................................................................271
cluster candidate .................................................................................................................272
cluster individual..................................................................................................................272
cluster management-vlan ....................................................................................................273
clear ndp statistics...............................................................................................................273
show cluster ndp..................................................................................................................274
show cluster neighbor..........................................................................................................274
show cluster ntdp.................................................................................................................275
show cluster ........................................................................................................................275
show cluster member ..........................................................................................................276
Chapter 33 Static Routes Commands ...................................................................277
interface vlan .......................................................................................................................277
interface loopback ...............................................................................................................277
switchport ............................................................................................................................278
shutdown .............................................................................................................................278
description ...........................................................................................................................279
ip route ................................................................................................................................279
ip routing..............................................................................................................................280
show interface loopback ......................................................................................................281
show interface vlan..............................................................................................................281
show ip interface .................................................................................................................282
show ip interface brief..........................................................................................................282
XIV
show ip route .......................................................................................................................283
show ip route specify...........................................................................................................283
show ip route summary .......................................................................................................284
Chapter 34 DHCP Server......................................................................................285
service dhcp ........................................................................................................................285
ip dhcp server exclude-address...........................................................................................285
ip dhcp server pool .............................................................................................................. 286
ip dhcp server ping timeout .................................................................................................286
ip dhcp server ping packets................................................................................................. 287
network................................................................................................................................287
lease....................................................................................................................................288
address hardware-address..................................................................................................288
address client-identifier........................................................................................................289
default-gateway ................................................................................................................... 290
dns-server ...........................................................................................................................290
show ip dhcp server status..................................................................................................291
show ip dhcp server statistics.............................................................................................. 291
show ip dhcp server pool.....................................................................................................292
show ip dhcp server excluded-address ...............................................................................292
show ip dhcp server manual-binding ................................................................................... 293
show ip dhcp server binding ................................................................................................293
clear ip dhcp server statistics ..............................................................................................293
clear ip dhcp server binding.................................................................................................294
Chapter 35 DHCP Relay .......................................................................................295
ip helper-address.................................................................................................................295
ip dhcp relay information .....................................................................................................295
ip dhcp relay information policy ...........................................................................................296
ip dhcp relay information custom.........................................................................................296
ip dhcp relay information circuit-id ....................................................................................... 297
ip dhcp relay information remote-id .....................................................................................297
show ip dhcp relay...............................................................................................................298
Chapter 36 Proxy ARP Commands .......................................................................299
ip proxy-arp .........................................................................................................................299
show ip proxy-arp ................................................................................................................299
Chapter 37 IGMP Commands...............................................................................301
XV
ip igmp.................................................................................................................................301
ip igmp version ....................................................................................................................301
ip igmp last-member-query-count........................................................................................302
ip igmp last-member-query-interval ..................................................................................... 302
ip igmp querier-timeout........................................................................................................303
ip igmp query-interval .......................................................................................................... 304
ip igmp query-max-response-time ....................................................................................... 304
ip igmp require-router-alert ..................................................................................................305
ip igmp robustness ..............................................................................................................305
ip igmp send-router-alert .....................................................................................................306
ip igmp startup-query-interval .............................................................................................. 307
ip igmp startup-query-count................................................................................................. 307
ip igmp static-group (interface vlan).....................................................................................308
ip igmp static-group (routed port) ........................................................................................309
ip igmp profile ......................................................................................................................310
deny.....................................................................................................................................310
permit .................................................................................................................................. 311
range ................................................................................................................................... 311
ip igmp filter .........................................................................................................................312
ip igmp max-groups.............................................................................................................312
show ip igmp profile.............................................................................................................314
show ip igmp groups............................................................................................................314
show ip igmp groups interface.............................................................................................315
show ip igmp groups interface vlan .....................................................................................315
show ip igmp group
s static ..................................................................................................316
show ip igmp groups static interface....................................................................................316
show ip igmp groups static interface vlan............................................................................317
show ip igmp groups port-info (dynamic)............................................................................. 317
show ip igmp interface.........................................................................................................318
show ip igmp interface vlan .................................................................................................319
show ip igmp interface loopback .........................................................................................319
Chapter 38 PIM Commands..................................................................................321
ip multicast-routing ..............................................................................................................321
ip pim...................................................................................................................................321
ip pim sg-expiry-timer .......................................................................................................... 322
ip pim spt-threshold infinity..................................................................................................322
ip pim bsr-candidate interface .............................................................................................323
XVI
ip pim rp-candidate interface ...............................................................................................324
ip pim rp-address.................................................................................................................325
ip pim bsr-border .................................................................................................................325
ip pim dr-priority...................................................................................................................326
ip pim join-prune-interval .....................................................................................................326
ip pim query-interval ............................................................................................................327
show ip multicast .................................................................................................................328
show ip mroute ....................................................................................................................328
show ip pim interface...........................................................................................................329
show ip pim neighbor ..........................................................................................................329
show ip pim bsr-router.........................................................................................................330
show ip pim rp .....................................................................................................................330
show ip pim rp-hash ............................................................................................................331
Chapter 39 Static Multicast Routing Commands ...................................................332
ip mroute .............................................................................................................................332
show ip mroute static...........................................................................................................333
Chapter 40 VRRP Commands ..............................................................................334
vrrp vrid ...............................................................................................................................334
vrrp vrid virtual-ip.................................................................................................................335
vrrp vrid description ............................................................................................................. 335
vrrp vrid priority....................................................................................................................336
vrrp vrid timer-advertise.......................................................................................................336
vrrp vrid preempt-mode .......................................................................................................337
vrrp vrid authentication-mode .............................................................................................. 338
vrrp vrid track interface........................................................................................................339
clear vrrp statistics...............................................................................................................339
show vrrp............................................................................................................................. 340
show vrrp statistics ..............................................................................................................341
Chapter 41 RIP Commands ..................................................................................342
router rip ..............................................................................................................................342
network................................................................................................................................342
version.................................................................................................................................343
timer basic ...........................................................................................................................344
distance...............................................................................................................................344
auto-summary .....................................................................................................................345
default-metric.......................................................................................................................345
XVII
redistribute...........................................................................................................................346
passive-interface .................................................................................................................347
ip rip receive version ...........................................................................................................347
ip rip send version ...............................................................................................................348
ip rip v2-broadcast...............................................................................................................349
ip rip authentication-mode ...................................................................................................349
ip rip poison-reverse............................................................................................................350
ip rip split-horizon ................................................................................................................350
show ip rip ...........................................................................................................................351
Chapter 42 OSPF Commands ..............................................................................352
router ospf ...........................................................................................................................352
router-id ...............................................................................................................................352
network................................................................................................................................353
summary-address................................................................................................................354
maximum-paths...................................................................................................................355
redistribute...........................................................................................................................356
default-metric.......................................................................................................................357
default-information originate ................................................................................................357
auto-cost..............................................................................................................................358
distance...............................................................................................................................359
timers throttle spf.................................................................................................................360
timers lsa arrival ..................................................................................................................360
compatible rfc1583 ..............................................................................................................361
passive-interface .................................................................................................................362
passive-interface range ....................................................................................................... 362
passive-interface default......................................................................................................363
no area ................................................................................................................................364
area description...................................................................................................................364
area authentication..............................................................................................................365
area stub .............................................................................................................................366
area nssa.............................................................................................................................366
area default-cost..................................................................................................................367
area range ...........................................................................................................................368
area virtual-link ....................................................................................................................369
area virtual-link authentication.............................................................................................37
0
area vi
rtual-link authentication-key ...................................................................................... 371
area virtual-link message-digest-key ................................................................................... 372
XVIII
ip ospf cost ..........................................................................................................................373
ip ospf retransmit-interval ....................................................................................................373
ip ospf transmit-delay ..........................................................................................................374
ip ospf priority ......................................................................................................................374
ip ospf hello-interval.............................................................................................................375
ip ospf dead-interval ............................................................................................................ 376
ip ospf authentication...........................................................................................................376
ip ospf authentication-key.................................................................................................... 377
ip ospf message-digest-key.................................................................................................377
ip ospf network ....................................................................................................................378
ip ospf database-filter all out................................................................................................379
ip ospf mtu-ignore................................................................................................................379
clear ip ospf .........................................................................................................................380
show ip ospf ........................................................................................................................380
show ip ospf database......................................................................................................... 381
show ip ospf interface..........................................................................................................381
show ip ospf neighbor..........................................................................................................382
show ip ospf request-list......................................................................................................383
show ip ospf retransmission-list...........................................................................................383
show ip ospf summary-address...........................................................................................384
show ip ospf virtual-links......................................................................................................385
show ip ospf border-routers.................................................................................................385
show ip route ospf .............................................................................................................
..386
show ip osp
f area database.................................................................................................386
show ip ospf area interface..................................................................................................387
show ip ospf area neighbor .................................................................................................387
show ip ospf area request-list..............................................................................................388
show ip ospf area retransmission-list...................................................................................389
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
1
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 T3700G-28TQ
JetStream 28-Port Gigabit Stackable L3 Managed Switch.
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: Stack
Provide information about the commands used for configuring stack.
Chapter 4: IEEE 802.1Q VLAN Commands
Provide information about the commands used for configuring IEEE 802.1Q VLAN.
Chapter 5: MAC-based VLAN Commands
Provide information about the commands used for configuring MAC-based VLAN.
Chapter 6: Protocol VLAN Commands
Provide information about the commands used for configuring Protocol VLAN.
Chapter 7: VLAN-VPN Commands
Provide information about the commands used for configuring VLAN-VPN (Virtual Private Network)
function.
Chapter 8: Voice VLAN Commands
Provide information about the commands used for configuring Voice VLAN.
Chapter 9: Private VLAN Commands
Provide information about the commands used for configuring Private VLAN.
Chapter 10: GVRP Commands
Provide information about the commands used for configuring GVRP (GARP VLAN registration
protocol).
Chapter 11: EtherChannel Commands
Provide information about the commands used for configuring LAG (Link Aggregation Group) and
LACP (Link Aggregation Control Protocol).
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
2
Chapter 12: User Manage Commands
Provide information about the commands used for user management.
Chapter 13: 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.
Chapter 14: ARP Inspection Commands
Provide information about the commands used for protecting the switch from the ARP cheating or
ARP Attack.
Chapter 15: 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 16: DoS Defend Command
Provide information about the commands used for DoS defend and detecting the DoS attack.
Chapter 17: IEEE 802.1X Commands
Provide information about the commands used for configuring IEEE 802.1X 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
Provide information about the commands used for 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: Ethernet Configuration Commands
Provide information about the commands used for configuring the Bandwidth Control, Negotiation
Mode, and Storm Control for ethernet ports.
Chapter 24: QoS Commands
Provide information about the commands used for configuring the QoS function.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
3
Chapter 25: Port Mirror Commands
Provide information about the commands used for configuring the Port Mirror function.
Chapter 26: Port Isolation Commands
Provide information about the commands used for configuring Port Isolation function.
Chapter 27: ACL Commands
Provide information about the commands used for configuring the ACL (Access Control List).
Chapter 28: MSTP Commands
Provide information about the commands used for configuring the MSTP (Multiple Spanning Tree
Protocol).
Chapter 29: IGMP Commands
Provide information about the commands used for configuring the IGMP Snooping (Internet Group
Management Protocol Snooping).
Chapter 30: SNMP Commands
Provide information about the commands used for configuring the SNMP (Simple Network
Management Protocol) functions.
Chapter 31: LLDP Commands
Provide information about the commands used for configuring LLDP function.
Chapter 32: Cluster Commands
Provide information about the commands used for configuring the Cluster Management function.
Chapter 33: Static Routes Commands
Provide information about the commands used for configuring the Static Route function.
Chatper 34: DHCP Server Commands
Provide information about the commands used for configuring the DHCP Server function.
Chapter 35: DCHP Relay Commands
Provide information about the commands used for configuring the DHCP Relay function.
Chapter 36: Proxy ARP Commands
Provide information about the commands used for configuring the Proxy ARP function.
Chapter 37: IGMP Commands
Provide information about the commands used for configuring the IGMP function.
Chapter 38: PIM Commands
Provide information about the commands used for configuring the PIM function.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
4
Chapter 39: Static Multicast Routing Commands
Provide information about the commands used for configuring the Static Multicast Routing
function.
Chapter 40: VRRP Commands
Provide information about the commands used for configuring the VRRP function.
Chapter 41: RIP Commands
Provide information about the commands used for configuring the RIP function.
Chapter 42: OSPF Commands
Provide information about the commands used for configuring the OSPF function.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
5
Chapter 1 Using the CLI
1.1 Accessing the CLI
You can log on to the switch and access the CLI by the following two methods:
1. Log on to the switch by the console port on the switch.
2. Log on to the switch remotely by a Telnet or SSH connection through an Ethernet port.
1.1.1 Logon by a console port
To log on to the switch by the console port on the switch, please take the following steps:
1. Connect the PCs or Terminals to the console port on the switch by a provided cable.
2. Click Start →
All Programs → Accessories→ Communications → Hyper Terminal to
open the Hyper Terminal as the Figure 1-1 shown.
Figure 1-1 Open
Hyper Terminal
3. The Connection Description Window will prompt as Figure 1-2 shown. Enter a name into
the Name field and click OK.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
6
Figure 1-2 Connection Description
4. Select the port to connect in Figure 1-3, and click OK.
Figure 1-3 Select the port to connect
5. Configure the port selected in the step above as the following Figure 1-4 shown.
Configure Bits per second as 38400, Data bits as 8, Parity as None, Stop bits as 1,
Flow control as None, and then click OK.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
7
Figure 1-4 Port Settings
6. The DOS prompt ”T3700G-28TQ>” will appear after pressing the Enter button as Figure
1-5 shown. It indicates that you can use the CLI now.
Figure 1-5 Log in the Switch
1.1.2 Configuring the Privileged EXEC Mode Password
To configure the switch remotely by a Telnet or SSH connection, please set a password for
entering the Privileged EXEC Mode through the console connection first. Follow the steps in 1.1.1
Logon by a console port to log on to the switch, and then follow the steps shown in Figure 1-6 to
configure the Privileged EXEC Mode password.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
8
Figure 1-6 Configure the Privileged EXEC Mode Password
1.1.3 Logon by Telnet
For Telnet connection, after configuring the Privileged EXEC Mode Password, 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.
Note:
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” and set the password for entering into the
Privileged EXEC Mode as 123 in the prompted DOS screen shown in Figure 1-7.
Figure 1-7 Configure login local mode
Now, you can logon by Telnet in login local mode.
1. Make sure the switch and the PC are in the same LAN. Click Start → Run to open the Run
window, and type cmd in the prompt Run window as Figure 1-8 and click OK.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
9
Figure 1-8 Run Window
2. Open Telnet, then type telnet 192.168.0.1 in the command prompt shown as Figure 1-8, and
press the En
ter button.
Figure 1-9 Connecting to the Switch
3. Type the default user name and password admin/admin, then press the Enter button so as to
enter User EXEC Mode.
Figure 1-10 Enter into the User EXEC Mode
Now you can manage your switch with CLI commands through Telnet connection.
4. Type enable command to enter Privileged EXEC Mode. A password that you have set
through Console port connection is required. Here the password has been set as 123.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
10
Figure 1-11 Enter into the Privileged EXEC Mode
Login Mode
Firstly configure the Telnet login mode as “login”, and both the connection password and the
Privileged EXEC Mode password as 123 in the prompted DOS screen shown in Figure 1-12.
Figure 1-12 Configure login mode
Now, you can logon by Telnet in login mode:
1. Open Telnet, then type telnet 192.168.0.1 in the command prompt shown as Figure 1-12, and
press the En
ter button.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
11
Figure 1-13 Connecting to the Switch
2. 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-14 Enter into the User EXEC Mode
3. When entering enable command to access Privileged EXEC Mode, you are required to give
the password 123 you have set through Console port connection.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
12
Figure 1-15 Enter into the Privileged EXEC Mode
Now you can manage your switch with CLI commands through Telnet connection.
Note:
You can refer to Chapter 12 User Manage Commands
for detailed commands information of the
Telnet connection configuration.
1.1.4 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-16 to enable the SSH function
through console connection.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
13
Figure 1-16 Enable SSH function
Password Authentication Mode
1. Open the software to log on to the interface of PuTTY. Enter the IP address of the switch into
Host Name field; keep the default value 22 in the Port field; select SSH as the Connection
type.
Figure 1-17 SSH Connection Config
n enter the Privileged EXEC Mode password, so
you can continue to configure the switch.
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 the
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
14
Figure 1-18 Log on the Switch
Key Authentication Mode
1. Select the key type and key length, and generate SSH key.
Figure 1-19 Generate SSH Key
Note:
1. The key length is in the range of 256 to 3072 bits.
2. During the key generation, randomly moving the mouse quickly can accelerate the key
generation.
2. After the key is successfully generated, please save the public key and private key to a TFTP
server.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
15
Figure 1-20 Save the Generated Key
3. Log on to the switch by the console port, and download the public key file from the TFTP
server to the switch, as the following figure shows:
Figure 1-21 Download the Public Key
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.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
16
Figure 1-22 SSH Connection Config
5. Click Browse to download the private key file to SSH client software and click Open.
Figure 1-23 Download the Private Key
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
17
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-24 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, Line Configuration Mode, VLAN Configuration Mode, Interface
Configuration Mode, Router Configuration Mode, DHCP Configuration Mode and MST
Configuration Mode. Interface Configuration Mode can also be divided into Interface
gigabitEthernet, Interface link-aggregation and some other modes, which is shown as the following
diagram.
Global Configuration
Mode
Privileged EXEC
Mode
User EXEC Mode
password
VLAN Configuration Mode
Interface Configuration Mode
Interface gigabitEthernet
Interface link-aggregation
Interface range gigabitEthernet
Interface range link-aggregation
Interface loopback
Interface VLAN
……
The followin
g table gives detailed information about the Accessing path, Prompt of each mode and
how to exit the current mode and access the next mode.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
18
Mode Accessing Path Prompt
Logout or Access the
next mode
User EXEC
Mode
Primary mode once it is
connected with the switch.
T3700G-28TQ>
Use the exit command to
disconnect the switch
(except that the switch is
connected through the
Console port).
Use the enable command
to access Privileged EXEC
mode.
Privileged
EXEC Mode
Use the enable command to
enter this mode from User
EXEC mode.
T3700G-28TQ#
Enter the disable or exit
command to return to User
EXEC mode.
Enter configure command
to access Global
Configuration mode.
Global
Configuration
Mode
Use the configure command to
enter this mode from Privileged
EXEC mode.
T3700G-28TQ(config)#
Use the exit or the end
command or press Ctrl+Z
to return to Privileged
EXEC mode.
Use the interface
gigabitEthernet port or
interface range
gigabitEthernet port-list
command to access
interface Configuration
mode.
Use the vlan vlan-list to
access VLAN
Configuration mode.
Line
Configuration
Mode
Use the line vty command
from Global Configuration
mode to specify a line.
T3700G-28TQ(config- line)
Use the exit command to
exit to the global
configuration mode.
Press Ctrl-Z or enter end
to return to priviledged
EXEC mode.
VLAN
Configuration
Mode
Use the vlan vlan-list
command to enter this mode
from Global Configuration
mode.
T3700G-28TQ(config- vlan)#
Use the end command or
press Ctrl+Z to return to
Privileged EXEC mode.
Enter the exit or the #
command to return to
Global configuration mode.
Router
Configuration
Mode
Use the router ospf process-id
to enter OSPF Router mode
from Global Configuration
mode.
Use the router rip command to
enter RIP Router mode from
Global Configuration mode.
T3700-28TQ(config- router)
Use the end command or
press Ctrl+Z to return to
Privileged EXEC mode.
Enter the exit or the #
command to return to
Global Configuration
mode.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
19
Mode Accessing Path Prompt
Logout or Access the
next mode
Layer 2 Interface:
Use the interface
gigabitEthernet port or
interface range
gigabitEthernet port-list
command to enter this mode
from Global Configuration
mode.
T3700G-28TQ(config-if)#
T3700G-28TQ(config-if- range)#
Use the end command or
press Ctrl+Z to return to
Privileged EXEC mode.
Enter the exit or the #
command to return to
Global Configuration
mode.
A port number must be
specified in the interface
command.
Interface
Configuration
Mode
Layer 3 Interface:
Use the no switchport
command to enter Routed Port
mode from Interface
Configuration mode.
Use the interface vlan vlan-id
command to enter VLAN
Interface mode from Global
Configuration mode.
Use the interface loopback id
command to enter Loopback
Interface mode from Global
Configuration mode.
T3700G-28TQ(config-if)#
T3700G-28TQ(config-ifrange)#
Use the end command or
press Ctrl+Z to return to
Privileged EXEC mode.
Enter the exit or the #
command to return to
Global Configuration
mode.
DHCP
Configuration
Mode
Use the ip dhcp server pool
pool-name command to enter
DHCP Configuration Mode
from Global Configuration
mode.
T3700-28TQ(config-dhcp)
Use the end command or
press Ctrl+Z to return to
Privileged EXEC mode.
Enter the exit or the #
command to return to
Global Configuration
mode.
MST
Configuration
Mode
Use the spanning-tree mst
configuration command to
enter this mode from Global
Configuration mode.
T3700G-28TQ(config- mst)#
Use the end command or
press Ctrl+Z to return to
Privileged EXEC mode.
Enter the exit or the #
command to return to
Global configuration mode.
Note:
1. The user is automatically in User EXEC Mode after the connection between the PC and
the switch is established by a 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.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
20
Interface Configuration Mode: In this mode, users can configure one or several
ports, different ports corresponds to different commands
a). Interface gigabitEthernet/ten-gigabitEthernet: Configure parameters for an
Ethernet port, such as Duplex-mode, flow control status.
b). Interface range gigabitEthernet/ten-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 Loopback: Configure the parameters of the loopback interface.
f). Interface vlan: Configure parameters for the vlan interface.
Vlan Configuration Mode: In this mode, users can create a VLAN and add a
specified port to the VLAN.
Router Configuration Mode: In this mode, commands for configuring the Layer 3
functions are provided.
3. Some commands are global, that means they can be performed in all modes:
show: Displays all information of switch, for example: statistic information, port
information, VLAN information.
history: Displays the commands history.
1.3 Security Levels
This switch’s security is divided into two levels: User level and Admin level.
User level only allows users to do some simple operations in User EXEC Mode; Admin level
allows you to monitor, configure and manage the switch in Privileged EXEC Mode, Global
Configuration Mode, Interface Configuration Mode and VLAN Configuration Mode.
Users get the privilege to the User level once connecting console port with the switch or logging in
by Telnet. However, Guest users are restricted to access the CLI.
Users can enter Privileged EXEC mode from User EXEC mode by using the enable command. In
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.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
21
1.4 Conventions
1.4.1 Format Conventions
The following conventions are used in this Guide:
Items in square brackets [ ] are optional
Items in braces { } are required
Alternative items are grouped in braces and separated by vertical bars. For example: speed
{10 | 100 | 1000 }
Bold indicates an unalterable keyword. For example: show logging
Normal Font indicates a constant (several options are enumerated and only one can be
selected). For example: switchport type { access | trunk | general }
Italic Font indicates a variable (an actual value must be assigned). For example: bridge
aging-time aging-time
1.4.2 Special Characters
You should pay attentions to the description below if the variable is a character string:
These six characters ” < > , \ & can not be input.
If a blank is contained in a character string, single or double quotation marks should be used,
for example ’hello world’, ”hello world”, and the words in the quotation marks will be identified
as a string. Otherwise, the words will be identified as several strings.
1.4.3 Parameter Format
Some parameters must be entered in special formats which are shown as follows:
MAC Address must be entered in the format of xx:xx:xx:xx:xx:xx
One or several values can be typed for a port-list or a vlan-list using comma to separate. Use
a hyphen to designate a range of values, for instance 1, 3-5,7 indicates choosing 1,3,4,5,7.
The port number should format as 1/0/3, meaning unit/slot/port. The unit number represents
the unit ID of the switch in the stack. The slot number is either 0 or 1, with 0 representing ports
on the front panel and 1 representing the two ports on the Interface Card inserted into the
back panel. The port number is a variable (an actual value must be assigned).
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
22
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:
T3700G-28TQ>enable
Enter password：
T3700G-28TQ#
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 “simple”.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
23
Command Mode
Global Configuration Mode
Example
Set the super password as “admin” to access Privileged EXEC Mode from User
EXEC Mode:
T3700G-28TQ(config)#enable password admin
disable
Description
The disable command is used to return to User EXEC Mode from Privileged
EXEC Mode.
Syntax
disable
Command Mode
Privileged EXEC Mode
Example
Return to User EXEC Mode from Privileged EXEC Mode:
T3700G-28TQ#disable
T3700G-28TQ>
configure
Description
The configure command is used to access Global Configuration Mode from
Privileged EXEC Mode.
Syntax
configure
Command Mode
Privileged EXEC Mode
Example
Access Global Configuration Mode from Privileged EXEC Mode:
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
24
T3700G-28TQ#configure
T3700G-28TQ(config)#
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:
T3700G-28TQ(config-if)#exit
T3700G-28TQ(config)#exit
T3700G-28TQ#
end
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:
T3700G-28TQ(config-if)#end
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
25
history
Description
The history command is used to show the latest 20 commands you entered in
the current mode since the switch is powered.
Syntax
history
Command Mode
Privileged EXEC Mode and any Configuration Mode
Example
Show the commands you have entered in the current mode:
T3700G-28TQ(config)# history
1 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:
T3700G-28TQ(config)#history clear
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
26
Chapter 3 Stack
The stack technology is to connect multiple stackable devices through their StackWise ports,
forming a stack which works as a unified system and presents as a single entity to the network in
Layer 2 and Layer 3 protocols. This chapter describes how to manage the T3700G-28TQ switch
stacks.
switch priority
Description
The switch priority command is specify the stack member number and the new
priority for the stack member. To restore the priority of the specified stack
member to the default value as 5, please use no switch priority command.
Syntax
swtich unitid priority priority
no switch unitid priority
Parameter
unitid —— Specify the member number.
priority —— Specify the member’s priority, ranging from 1 to 15.
Command Mode
Global Configuration Mode
Example
Specify the unit 1’s priority as 10 in the stack:
T3700G-28TQ(config)# switch 1 priority 10
switch renumber
Description
The switch renumber command is modify the member number of a specified
stack member.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
27
Syntax
swtich unitid renumber { newid | auto-numbering }
Parameter
unitid —— Specify the member to be renumbered.
newid —— Specify the new stack member number for the stack member.
auto-numbering—— The specified member will obtain its stack number through
auto-numbering.
Command Mode
Global Configuration Mode
Example
Modify the unit 1’s new member number as 2:
T3700G-28TQ(config)# switch 1 renumber 2
switch authentication-mode
Description
The switch authentication-mode command is configure the stack
authentication mode. To turn off the authentication, please use no switch
authentication-mode command.
Syntax
swtich authentication-mode { md5 key | simple key}
no switch authentication-mode
Parameter
key —— Enter the authentication key string. The length of the key string is up to
16 octets.
Command Mode
Global Configuration Mode
Example
Configure the stack’s authentication mode as md5 and the key as hello:
T3700G-28TQ(config)# switch authentication-mode md5 hello
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
28
switch stack-name
Description
The switch stack-name command is customize the stack’s name. To restore to
the default name “Stack”, please use no switch stack-name command.
Syntax
swtich stack-name { name }
no switch stack-name
Parameter
name —— Specify the name of the stack.
Command Mode
Global Configuration Mode
Example
Specify the name of the stack as Stack1:
T3700G-28TQ(config)# switch stack-name Stack1
switch stack-port
Description
The switch stack-port command is used to enable the stack port. To switch the
stack port to Ethernet port, please use no switch stack-port command.
Syntax
swtich stack-port interface ten-gigabitEthernet port
no switch stack-port interface ten-gigabitEthernet port
Parameter
port —— The stack port number.
Command Mode
Global Configuration Mode
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
29
Example
Specify the ten-gigabit port 1/1/2 as stack port when the Interface Card is
installed:
T3700G-28TQ(config)# switch stack-port interface ten-gigabitEthernet
1/1/2
show switch
Description
The show switch command is used to display the current stack’s information.
Syntax
show switch [ unitid | detail | neighbor | stack-ports ]
Parameter
unitid —— Specify the member number.
detail —— Display the detailed information of the stack, including stack member,
stack port and neighboring information.
neighbor —— Display the information of the stack neighbor.
stack-ports —— Display the information of the stack ports.
Command Mode
Privileged EXEC Mode and any Configuration Mode
Example
Display the detailed information of the current stack:
T3700G-28TQ(config)# show switch detail
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
30
Chapter 4 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:
T3700G-28TQ(config)#vlan 2-10,100
Delete VLAN 2:
T3700G-28TQ(config)#no vlan 2
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
31
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
Create VLAN Interface 2:
T3700G-28TQ(config)#interface vlan 2
name
Description
The name command is used to assign a description string to a VLAN. To clear
the description, please use no name command.
Syntax
name descript
no name
Parameter
descript —— String to describe the VLAN, which contains 16 characters at
most.
Command Mode
VLAN Configuration Mode（VLAN）
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
32
Example
Specify the description string of the VLAN 2 as “VLAN002”:
T3700G-28TQ(config)#vlan 2
T3700G-28TQ(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/
interface ten-gigabitEthernet / interface range ten-gigabitEthernet)
Example
Specify the Link Type of Gigabit Ethernet port 1/0/3 as “trunk”:
T3700G-28TQ(config)#interface gigabitEthernet 1/0/3
T3700G-28TQ(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
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
33
no switchport access vlan
Parameter
vlan-id —— Specify IEEE 802.1Q VLAN ID, ranging from 2 to 4094.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet/
interface ten-gigabitEthernet / interface range ten-gigabitEthernet)
Example
Configure Gigabit Ethernet port 1/0/3 whose link type is “access” to VLAN 2:
T3700G-28TQ(config)#interface gigabitEthernet 1/0/3
T3700G-28TQ(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 | all }
no switchport trunk allowed vlan { vlan-list | all }
Parameter
vlan-list —— VLAN ID list, ranging from 2 to 4094, in the format of 2-3, 5. It is
multi-optional.
all —— Add the port to all of the existing VLANs.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet/
interface ten-gigabitEthernet / interface range ten-gigabitEthernet)
Example
Configure the link type of port 2 as trunk and add it to VLAN 2:
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
34
T3700G-28TQ(config)#interface gigabitEthernet 1/0/2
T3700G-28TQ(config-if)#switchport mode trunk
T3700G-28TQ(config-if)#switchport trunk allowed vlan 2
switchport general allowed vlan
Description
The switchport general allowed vlan command is used to add the desired
General port to IEEE 802.1Q VLAN, or to remove a port from the corresponding
VLAN.
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/
interface ten-gigabitEthernet / interface range ten-gigabitEthernet)
Example
Configure Gigabit Ethernet port 1/0/4 whose link type is “general” to VLAN 2 and
its egress-rule as “tagged”:
T3700G-28TQ(config)#interface gigabitEthernet 1/0/4
T3700G-28TQ(config-if)#switchport mode general
T3700G-28TQ(config-if)#switchport general allowed vlan 2 tagged
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
35
switchport pvid
Description
The switchport pvid command is used to configure the PVID for the switch
ports. To restore the PVID of the specified port as 1, please use the no
switchport pvid.
Syntax
switchport pvid vlan-id
Parameter
vlan-id —— Specify IEEE 802.1Q VLAN ID, ranging from 1 to 4094.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet/
interface ten-gigabitEthernet / interface range ten-gigabitEthernet)
Example
Specify the PVID of Gigabit Ethernet port 1/0/3 as 1:
T3700G-28TQ(config)#interface gigabitEthernet 1/0/3
T3700G-28TQ(config-if)#switchport pvid 1
show interface switchport
Description
The show interface switchport command is used to display the information of
one or all Ethernet ports.
Syntax
show interface switchport [ fastEthernet port | gigabitEthernet port |
ten-gigabitEthernet port ]
Parameter
port ——The Fast/Gigabit/Ten-Gigabit Ethernet port number.
Command Mode
Privileged EXEC Mode and Any Configuration Mode
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
36
Example
Display the detailed information of Gigabit Ethernet port 1/0/3:
T3700G-28TQ(config)#show interface switchport gigabitEthernet 1/0/3
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:
T3700G-28TQ(config)#show vlan summary
show vlan brief
Description
The show vlan brief command is used to display the brief information of IEEE
802.1Q VLAN.
Syntax
show vlan brief
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the brief information of IEEE 802.1Q VLAN:
T3700G-28TQ(config)#show vlan brief
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
37
show vlan
Description
The show vlan command is used to display the detailed information of IEEE
802.1Q VLAN.
Syntax
show vlan [id vlan-list]
Parameter
vlan-list —— Specify IEEE 802.1Q VLAN ID, ranging from 1 to 4094. Using the
show vlan command without parameter displays the detailed information of all
the VLANs.
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the detailed information of VLAN 2-10:
T3700G-28TQ(config)#show vlan id 2-10
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
38
Chapter 5 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:
T3700G-28TQ(config)#mac-vlan mac-address 00:11:11:01:01:12 vlan 2
description TP
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
39
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/
interface ten-gigabitEthernet / interface range ten-gigabitEthernet)
Example
Enable the Gigabit Ethernet port 1/0/3 for the MAC-based VLAN feature:
T3700G-28TQ(config)#interface gigabitEthernet 1/0/3
T3700G-28TQ(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.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
40
vlan-id —— Specify IEEE 802.1Q VLAN ID, ranging from 1 to 4094.
Example
Display the information of all the MAC-based VLAN entry:
T3700G-28TQ(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:
T3700G-28TQ(config)#show mac-vlan interface
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
41
Chapter 6 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 frame { ether_2 ether-type type
| snap ether-type type | llc dsap dsap_type ssap ssap_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.
ether_2 ether-type type —— Specify the Ethernet type.
snap ether-type type —— Specify the Ethernet type.
llc dsap dsap_type ssap ssap_type —— Specify the DSAP type and the SSAP
type.
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:
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
42
T3700G-28TQ(config)#protocol-vlan template name TP frame ether_2
ether-type 2024
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:
T3700G-28TQ(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
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
43
port, please use no protocol-vlan command. By default, the Protocol-based
VLAN feature of all ports is disabled.
Syntax
protocol-vlan
no protocol-vlan
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet/
interface ten-gigabitEthernet / interface range ten-gigabitEthernet)
Example
Enable the Protocol-based VLAN feature for the Gigabit Ethernet port 25:
T3700G-28TQ(config)#interface gigabitEthernet 1/0/25
T3700G-28TQ(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:
T3700G-28TQ(config)#show protocol-vlan template
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
44
show protocol-vlan vlan
Description
The show protocol-vlan vlan command is used to display the information
about Protocol-based VLAN entry.
Syntax
show protocol-vlan vlan
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display information of the Protocol-based VLAN entry:
T3700G-28TQ(config)#show protocol-vlan vlan
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
45
Chapter 7 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:
T3700G-28TQ(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 tpid
no dot1q-tunnel tpid
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
46
Parameter
tpid —— 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:
T3700G-28TQ(config)#dot1q-tunnel tpid 9100
dot1q-tunnel mapping
Description
The dot1q-tunnel mapping command is used to enable the VLAN Mapping
feature globally. To disable this function, please use the no dot1q-tunnel
mapping command. By default, the VLAN Mapping feature is disabled.
Syntax
dot1q-tunnel mapping
no dot1q-tunnel mapping
Command Mode
Global Configuration Mode
Example
Enable the VLAN mapping feature globally:
T3700G-28TQ(config)#dot1q-tunnel mapping
switchport dot1q-tunnel mapping
Description
The switchport dot1q-tunnel mapping command is used add the VLAN
Mapping entry on a specified port. To delete the VLAN Mapping entry on this
port, please use the no switchport dot1q-tunnel mapping command.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
47
Syntax
switchport dot1q-tunnel mapping c-vlan sp-vlan [descript]
no switchport 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
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet/
interface ten-gigabitEthernet / interface range ten-gigabitEthernet)
Example
Add a VLAN Mapping entry on the Gigabit Ethernet port 1/0/3 with the Customer
VLAN as VLAN 2 and the Service Provider VLAN as VLAN 3:
T3700G-28TQ(config)#interface gigabitEthernet 1/0/3
T3700G-28TQ(config-if)#switchport dot1q-tunnel mapping 2 3
switchport dot1q-tunnel mode
Description
The switchport dot1q-tunnel mode command is used to configure the VPN
port’s mode. To close this VPN port, please use the no switchport
dot1q-tunnel mode command. By default, no port has been configured as the
VPN port. The VPN port mode uni and nni cannot switch to each other directly,
so please close the VPN port and switch to the other mode if needed.
Syntax
switchport dot1q-tunnel mode { uni/nni }
no switchport dot1q-tunnel mode
Parameter
uni ——The port connected to the clients.
nni ——The port connected to the ISP.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
48
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet/
interface ten-gigabitEthernet / interface range ten-gigabitEthernet)
Example
Configure the Gigabit Ethernet port 1/0/3 as the VPN UNI ports:
T3700G-28TQ(config)#interface gigabitEthernet 1/0/3
T3700G-28TQ(config-if)#switchport dot1q-tunnel mode uni
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:
T3700G-28TQ(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
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
49
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the information of VLAN Mapping entry:
T3700G-28TQ(config)#show dot1q-tunnel mapping
show dot1q-tunnel interface
Description
The show dot1q-tunnel mapping interface command is used to display the
VLAN VPN port type.
Syntax
show dot1q-tunnel interface
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the port type of all VLAN VPN ports:
T3700G-28TQ(config)#show dot1q-tunnel interface
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
50
Chapter 8 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:
T3700G-28TQ(config)#voice vlan 10
voice vlan aging
Description
The voice vlan aging 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 command. By default, the aging time is 1440 minutes.
Syntax
voice vlan aging time
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
51
no voice vlan aging
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:
T3700G-28TQ(config)#voice vlan aging 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:
T3700G-28TQ(config)#voice vlan priority 5
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
52
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:00:00:00 and the mask address FF:FF:FF:00:00:00:
T3700G-28TQ(config)#voice vlan mac-address 00:11:11:00:00:00 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 }
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
53
Parameter
manual | auto —— Port mode.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet/
interface ten-gigabitEthernet / interface range ten-gigabitEthernet)
Example
Configure the Gigabit Ethernet port 1/0/3 to operate in the auto voice VLAN
mode:
T3700G-28TQ(config)#interface gigabitEthernet 1/0/3
T3700G-28TQ(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/
interface ten-gigabitEthernet / interface range ten-gigabitEthernet)
Example
Enable the Gigabit Ethernet port 1/0/3 for Voice VLAN security feature:
T3700G-28TQ(config)#interface gigabitEthernet 1/0/3
T3700G-28TQ(config-if)#switchport voice vlan security
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
54
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:
T3700G-28TQ(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:
T3700G-28TQ(config)#show voice vlan oui
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
55
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 |
ten-gigabitEthernet port ]
Parameter
port ——The Fast/Gigabit/Ten-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 Gigabit Ethernet port 1/0/1 in the Voice
VLAN:
T3700G-28TQ(config)#show voice vlan switchport gigabitEthernet 1/0/1
Display the configuration information of all the ports in the Voice VLAN:
T3700G-28TQ(config)#show voice vlan switchport
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
56
Chapter 9 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:
T3700G-28TQ(config)#vlan 3
T3700G-28TQ(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 abolish the currently
community VLAN, please use no private-vlan community command.
Syntax
private-vlan community
no private-vlan community
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
57
Command Mode
VLAN Configuration Mode (VLAN)
Example
Configure the VLAN 4 as the community VLAN of the private VLAN:
T3700G-28TQ(config)#vlan 4
T3700G-28TQ(config-vlan)#private-vlan community
private-vlan isolated
Description
The private-vlan isolated command is used to configure the designated VLAN
as the isolated VLAN of the Private VLAN. To abolish the currently isolated
VLAN, please use no private-vlan isolated command.
Syntax
private-vlan isolated
no private-vlan isolated
Command Mode
VLAN Configuration Mode (VLAN)
Example
Configure the VLAN 3 as the isolated VLAN of the private VLAN:
T3700G-28TQ(config)#vlan 3
T3700G-28TQ(config-vlan)#private-vlan isolated
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
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
58
no private-vlan association vlan_list
Parameter
vlan_list —— Secondary VLAN ID, ranging from 2 to 4094.
Command Mode
VLAN Configuration Mode (VLAN)
Example
Associate primary VLAN 3 with community VLAN 4 as a private VLAN:
T3700G-28TQ(config)#vlan 3
T3700G-28TQ(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.
Syntax
switchport private-vlan { promiscuous | host }
no switchport private-vlan
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/
interface ten-gigabitEthernet / interface range ten-gigabitEthernet)
Example
Configure Gigabit Ethernet port 3 as “host”:
T3700G-28TQ(config)#interface gigabitEthernet 1/0/3
T3700G-28TQ(config-if)#switchport private-vlan host
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
59
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
vlantype
no switchport private-vlan host-association
Parameter
primary-vlan-id —— Primary VLAN ID, ranging from 2 to 4094.
secondary-vlan-id —— Secondary VLAN ID, ranging from 2 to 4094.
vlantype —— Specify the type of the secondary VLAN, either community or
isolated.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet/
interface ten-gigabitEthernet / interface range ten-gigabitEthernet)
Example
Configure host type Gigabit Ethernet port 1/0/3 as a member of primary VLAN 3
and secondary VLAN 4, with the type of VLAN 4 as community:
T3700G-28TQ(config)#interface gigabitEthernet 1/0/3
T3700G-28TQ(config-if)#switchport private-vlan host-association 3 4
community
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.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
60
Syntax
switchport private-vlan mapping primary_vlan_id secondary_vlan_id
no switchport private-vlan mapping
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/
interface ten-gigabitEthernet / interface range ten-gigabitEthernet)
Example
Configure promiscuous type Gigabit Ethernet port 1/0/3 as a member of primary
VLAN 3 and secondary VLAN 4:
T3700G-28TQ(config)#interface gigabitEthernet 1/0/3
T3700G-28TQ(config-if)#switchport private-vlan mapping 3 4
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:
T3700G-28TQ(config)#show vlan private-vlan
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
61
show vlan private-vlan interface
Description
The show vlan private-vlan interface command is used to display the Private
VLAN configuration information of the specified port(s).
Syntax
show vlan private-vlan interface [ fastEthernet port | gigabitEthernet port |
ten-gigabitEthernet port ]
Parameter
port —— The list of Ethernet ports.
Command Mode
Privileged EXEC Mode and Any Configuration Mode
Example
Display the configuration information of all the Ethernet ports:
T3700G-28TQ(config)#show vlan private-vlan interface
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
62
Chapter 10 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:
T3700G-28TQ(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
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
63
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet /
interface ten-gigabitEthernet / interface range ten-gigabitEthernet)
Example
Enable the GVRP function for Gigabit Ethernet ports 1/0/2-6:
T3700G-28TQ(config)#interface range gigabitEthernet 1/0/2-6
T3700G-28TQ(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 gigabitEthernet /
interface ten-gigabitEthernet / interface range ten-gigabitEthernet)
Example
Configure the GVRP registration mode as “fixed” for Gigabit Ethernet ports
1/0/2-6:
T3700G-28TQ(config)#interface range gigabitEthernet 1/0/2-6
T3700G-28TQ(config-if-range)#gvrp registration fixed
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
64
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 centiseconds. The Join Timer
ranges from 20 to 1000 centiseconds and the default value is 20 centiseconds.
The Leave Timer ranges from 60 to 3000 centiseconds and the default value is
60 centiseconds.
Command Mode
Interface Configuration Mode (interface fastEthernet / interface range
fastEthernet / interface gigabitEthernet / interface range gigabitEthernet /
interface ten-gigabitEthernet / interface range ten-gigabitEthernet)
Example
Set the GARP leaveall timer of Gigabit Ethernet port 1/0/6 as 2000 centiseconds
and restore the join timer of it to the default value:
T3700G-28TQ(config)#interface gigabitEthernet 1/0/6
T3700G-28TQ(config-if)#gvrp timer leaveall 2000
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
65
T3700G-28TQ(config-if)#no gvrp timer join
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:
T3700G-28TQ(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 |
ten-gigabitEthernet port ]
Parameter
port ——The Fast/Gigabit/Ten-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 Gigabit Ethernet port 1:
T3700G-28TQ(config)#show gvrp interface gigabitEthernet 1/0/1
Display the GVRP configuration information of all Ethernet ports:
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
66
T3700G-28TQ(config)#show gvrp interface
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
67
Chapter 11 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 32.
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 gigabitEthernet/
interface ten-gigabitEthernet / interface range ten-gigabitEthernet)
Example
Add the Gigabit Ethernet port 2-4 to EtherChannel Group 1 and enable the
static LAG:
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
68
T3700G-28TQ(config)#interface range gigabitEthernet 1/0/2-4
T3700G-28TQ(config-if-range)#channel-group 1 mode on
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”:
T3700G-28TQ(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.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
69
Syntax
lacp system-priority pri
no lacp system-priority
Parameter
pri —— The system priority, ranging from 0 to 65535. It is 32768 by default.
Command Mode
Global Configuration Mode
Example
Configure the LACP system priority as 1024 globally:
T3700G-28TQ(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 gigabitEthernet/
interface ten-gigabitEthernet / interface range ten-gigabitEthernet)
Example
Configure the LACP port priority as 1024 for Gigabit Ethernet port 1:
T3700G-28TQ(config)#interface gigabitEthernet 1/0/1
T3700G-28TQ(config-if)#lacp port-priority 1024
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
70
show etherchannel
Description
The show etherchannel command is used to display the EtherChannel
information.
Syntax
show etherchannel [channel-group-num ] { detail | summary }
Parameter
channel-group-num —— The EtherChannel Group number, ranging from 1 to
32. 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:
T3700G-28TQ(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:
T3700G-28TQ(config)#show etherchannel load-balance
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
71
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 }
Parameter
channel-group-num —— The EtherChannel Group number, ranging from 1 to
32. 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:
T3700G-28TQ(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:
T3700G-28TQ(config)#show lacp sys-id
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
72
Chapter 12 User Manage Commands
User Manage Commands are used to manage the user’s logging information by Web, CLI or SSH,
so as to protect the settings of the switch from being randomly changed.
user name
Description
The user name command is used to add a new user or modify the existed
users’ information. To delete the existed users, please use no user name
command.
Syntax
user name user-name password password [type {guest | admin}] [status
disable | enable}] [ secret { simple | cipher }]
no user name user-name
Parameter
user-name ——Type a name for users' login, which contains 16 characters at
most, composing digits, English letters and 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 “simple”.
Command Mode
Global Configuration Mode
Example
Add and enable a new admin user named “tplink”, of which the password is
“password”:
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
73
T3700G-28TQ(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:
T3700G-28TQ(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.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
74
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:
T3700G-28TQ(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.
At most 5 ports can be configured.
Syntax
user access-control port-based interface { fastEthernet port | gigabitEthernet
port | ten-gigabitEthernet port | none}
no user access-control
Parameter
port
——
The Fast/Gigabit/ten-Gigabit Ethernet port number.
none
——
Set the access port list to be none.
Command Mode
Global Configuration Mode
Example
Configure that only the users connected to Gigabit Ethernet ports 2 are allowed to
login:
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
75
T3700G-28TQ(config)#user access-control port-based interface
gigabitEthernet 1/0/2
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:
T3700G-28TQ(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
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
76
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:
T3700G-28TQ(config)#user idle-timeout 15
line
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:
T3700G-28TQ(config)#line console 0
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
77
Enter the Virtual Terminal configuration mode so as to prepare further
configurations such as password and login mode for virtual terminal 0 to 5:
T3700G-28TQ(config)#line vty 0 5
password
Description
The password command is used to configure the connection password. To
clear the password, please use no password command.
Syntax
password password
no password
Parameter
password —— Configure the connection password, which contains 16
characters at most, composing digits, English letters and under dashes only.
Command Mode
Line Configuration Mode
Example
Configure the connection password of Console port connection 0 as “tplink”:
T3700G-28TQ(config)#line console 0
T3700G-28TQ(config-line)#password tplink
Configure the connection password of virtual terminal connection 0-5 as “tplink”:
T3700G-28TQ(config)#line vty 0 5
T3700G-28TQ(config-line)#password tplink
login
Description
The login command is used to configure the login mode of a switch which uses
connection password to login. At this situation, a connection password must be
set for virtual terminal connection.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
78
Syntax
login
Command Mode
Line Configuration Mode
Example
Configure the login of Console port connection 0 as login mode:
T3700G-28TQ(config)#line console 0
T3700G-28TQ(config-line)#login
Configure the login of virtual terminal connection 0-5 as login mode:
T3700G-28TQ(config)#line vty 0 5
T3700G-28TQ(config-line)#login
login local
Description
The login local command is used to configure the login mode of the switch
which uses the user name and password to login.
Syntax
login local
Command Mode
Line Configuration Mode
Example
Configure the login of virtual terminal connection 0-5 as login local mode:
T3700G-28TQ(config)#line vty 0 5
T3700G-28TQ(config-line)#login local
Configure the login of Console port connection 0 as login local mode:
T3700G-28TQ(config)#line console 0
T3700G-28TQ(config-line)#login local
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
79
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:
T3700G-28TQ(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:
T3700G-28TQ(config)#show user configuration
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
80
Chapter 13 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.
You can manually bind the IP
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 | ten-gigabitEthernet port } { none |
arp-detection | ip-verify-source | both } [ forced-source {arp-scanning |
dhcp-snooping} ]
no ip source binding unit unit-id 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.
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.
unit-id —— Specify the unit in the stack which the binding table belongs to.
T3700G-28TQ JetStream 28-Port Gigabit Stackable L3 Managed Switch CLI Guide
81
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.
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:
T3700G-28TQ(config)#ip source binding host1 192.168.0.1
00:00:00:00:00:01 vlan 2 interface gigabitEthernet 1/0/5 both
Delete the IP-MAC–VID-PORT entry with the index 5:
T3700G-28TQ(config)#no ip source binding unit 1 index 5
ip dhcp snooping
Description
The ip dhcp snooping command is used to enable DHCP Snooping function
globally. To disable DHCP Snooping function globally, please use no ip dhcp
snooping command. DHCP Snooping functions to monitor the process of the
Host obtaining the IP address from DHCP server, and record the IP address,
MAC address, VLAN and the connected Port number of the Host for automatic
binding. The switch can also propagate the control information and the network
parameters via the Option 82 field to provide more information for the Host.
Syntax
ip dhcp snooping
no ip dhcp snooping
Command Mode
Global Configuration Mode
Example
Enable the DHCP Snooping function globally:
T3700G-28TQ(config)#ip dhcp snooping
Loading...