TP-Link T1700X-16TS CLI Reference Guide

CLI Reference Guide

T1700X-16TS

1910012723 REV3.1.0

October 2020

Specifications are subject to change without notice. is a registered trademark of

TP-Link Corporation Limited. 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

reserved.

https://www.tp-link.com

CONTENTS

Preface ............................................................................................................................ 1

Chapter 1 Using the CLI ................................................................................................... 5

1.1 Accessing the CLI ..................................................................................................................................... 5

1.1.1 Logon by Telnet ...................................................................................................................... 5

1.1.2 Logon by SSH .......................................................................................................................... 6

1.2 CLI Command Modes ............................................................................................................................ 11

1.3 Privilege Restrictions ............................................................................................................................. 14

1.4 Conventions .............................................................................................................................................. 15

1.4.1 Format Conventions ........................................................................................................... 15

1.4.2 Special Characters .............................................................................................................. 15

1.4.3 Parameter Format ................................................................................................................ 15

Chapter 2 User Interface .............................................................................................. 16

2.1 enable ............................................................................................................................................... 16

2.2 service password-encryption .................................................................................................. 16

2.3 enable password ........................................................................................................................... 17

2.4 enable secret ................................................................................................................................. 18

2.5 configure .......................................................................................................................................... 19

2.6 exit...................................................................................................................................................... 20

2.7 end ..................................................................................................................................................... 20

2.8 clipaging ........................................................................................................................................... 21

2.9 history ............................................................................................................................................... 21

2.10 history clear .................................................................................................................................... 22

Chapter 3 User Management Commands ................................................................ 23

3.1 user name (password) ................................................................................................................. 23

3.2 user name (secret) ........................................................................................................................ 24

3.3 show user account-list................................................................................................................ 25

3.4 show user configuration ............................................................................................................. 26

Chapter 4 System Configuration Commands ......................................................... 27

4.1 system-time manual .................................................................................................................... 27

4.2 system-time ntp ............................................................................................................................ 27

4.3 system-time dst predefined ..................................................................................................... 29

4.4 system-time dst date .................................................................................................................. 30

4.5 system-time dst recurring ......................................................................................................... 31

4.6 hostname ......................................................................................................................................... 32

4.7 location ............................................................................................................................................. 33

4.8 contact-info .................................................................................................................................... 33

4.9 ip address ........................................................................................................................................ 34

4.10 ip address-alloc ............................................................................................................................. 35

4.11 reset .................................................................................................................................................. 36

4.12 service reset-disable ................................................................................................................... 36

4.13 reboot ............................................................................................................................................... 37

4.14 reboot-schedule ........................................................................................................................... 37

4.15 copy running-config startup-config ....................................................................................... 38

4.16 copy startup-config tftp ............................................................................................................. 39

4.17 copy tftp startup-config ............................................................................................................. 39

4.18 copy backup-config tftp ............................................................................................................. 40

4.19 copy backup-config startup-config ....................................................................................... 41

4.20 copy running-config backup-config ...................................................................................... 41

4.21 copy tftp backup-config ............................................................................................................. 42

4.22 boot application ............................................................................................................................ 42

4.23 boot config ...................................................................................................................................... 43

4.24 remove backup-image ................................................................................................................ 44

4.25 firmware upgrade .......................................................................................................................... 44

4.26 ping .................................................................................................................................................... 45

4.27 tracert ............................................................................................................................................... 46

4.28 show system-info ......................................................................................................................... 47

4.29 show image-info ............................................................................................................................ 48

4.30 show boot ........................................................................................................................................ 48

4.31 show running-config .................................................................................................................... 49

4.32 show startup-config .................................................................................................................... 49

4.33 show system-time ........................................................................................................................ 50

4.34 show system-time dst ................................................................................................................. 50

4.35 show system-time ntp ................................................................................................................ 51

4.36 show cable-diagnostics interface........................................................................................... 51

4.37 show cpu-utilization ..................................................................................................................... 52

4.38 show memory-utilization ............................................................................................................ 52

Chapter 5 EEE Configuration Commands ................................................................ 54

5.1 eee ..................................................................................................................................................... 54

5.2 show interface eee ....................................................................................................................... 54

III

Chapter 6 SDM Template Commands ....................................................................... 56

6.1 sdm prefer ....................................................................................................................................... 56

6.2 show sdm prefer ........................................................................................................................... 57

Chapter 7 Time Range Commands ............................................................................ 58

7.1 time-range ....................................................................................................................................... 58

7.2 absolute ........................................................................................................................................... 58

7.3 periodic ............................................................................................................................................ 59

7.4 holiday (time-range mode) ......................................................................................................... 60

7.5 holiday .............................................................................................................................................. 61

7.6 show holiday ................................................................................................................................... 61

7.7 show time-range ........................................................................................................................... 62

Chapter 8 Port Configuration Commands ............................................................... 63

8.1 interface ten-gigabitEthernet ................................................................................................... 63

8.2 interface range ten-gigabitEthernet ...................................................................................... 63

8.3 description ...................................................................................................................................... 64

8.4 shutdown ......................................................................................................................................... 65

8.5 flow-control .................................................................................................................................... 66

8.6 duplex ............................................................................................................................................... 66

8.7 jumbo-size ....................................................................................................................................... 67

8.8 speed ................................................................................................................................................ 67

8.9 clear counters ................................................................................................................................ 68

8.10 show interface status .................................................................................................................. 69

8.11 show interface counters ............................................................................................................ 69

8.12 show interface configuration .................................................................................................... 70

Chapter 9 Port Isolation Commands ......................................................................... 71

9.1 port isolation................................................................................................................................... 71

9.2 show port isolation interface .................................................................................................... 72

Chapter 10 Loopback Detection Commands ............................................................ 73

10.1 loopback-detection (global) ...................................................................................................... 73

10.2 loopback-detection interval ...................................................................................................... 73

10.3 loopback-detection recovery-time ........................................................................................ 74

10.4 loopback-detection (interface) ................................................................................................ 75

10.5 loopback-detection config process-mode ......................................................................... 75

10.6 loopback-detection recover ..................................................................................................... 76

10.7 show loopback-detection global............................................................................................. 77

10.8 show loopback-detection interface ....................................................................................... 77

Chapter 11 Etherchannel Commands ......................................................................... 79

11.1 channel-group ............................................................................................................................... 79

11.2 port-channel load-balance ........................................................................................................ 80

11.3 lacp system-priority ..................................................................................................................... 81

11.4 lacp port-priority ........................................................................................................................... 82

11.5 show etherchannel ....................................................................................................................... 82

11.6 show etherchannel load-balance ............................................................................................ 83

11.7 show lacp ......................................................................................................................................... 84

11.8 show lacp sys-id ............................................................................................................................ 84

Chapter 12 MAC Address Commands ......................................................................... 86

12.1 mac address-table static ........................................................................................................... 86

12.2 no mac address-table dynamic ............................................................................................... 87

12.3 mac address-table aging-time ................................................................................................. 87

12.4 mac address-table filtering ....................................................................................................... 88

12.5 mac address-table max-mac-count ...................................................................................... 89

12.6 show mac address-table ............................................................................................................ 90

12.7 clear mac address-table ............................................................................................................ 91

12.8 show mac address-table aging-time ..................................................................................... 91

12.9 show mac address-table max-mac-count ........................................................................... 92

12.10 show mac address-table interface ......................................................................................... 92

12.11 show mac address-table count ............................................................................................... 93

12.12 show mac address-table address .......................................................................................... 93

12.13 show mac address-table vlan ................................................................................................... 94

Chapter 13 IEEE 802.1Q VLAN Commands ................................................................ 95

13.1 vlan ..................................................................................................................................................... 95

13.2 name .................................................................................................................................................. 96

13.3 vlan_trunk (globally) ..................................................................................................................... 96

13.4 vlan_trunk (interface) ................................................................................................................... 97

13.5 switchport general allowed vlan .............................................................................................. 97

13.6 switchport pvid .............................................................................................................................. 98

13.7 switchport check ingress ........................................................................................................... 99

13.8 switchport acceptable frame ................................................................................................ 100

13.9 show vlan summary................................................................................................................... 100

13.10 show vlan brief ............................................................................................................................ 101

13.11 show vlan ...................................................................................................................................... 101

13.12 show interface switchport ...................................................................................................... 102

Chapter 14 MAC-based VLAN Commands ............................................................... 103

14.1 mac-vlan mac-address ............................................................................................................ 103

14.2 mac-vlan ....................................................................................................................................... 104

14.3 show mac-vlan ............................................................................................................................ 104

14.4 show mac-vlan interface ......................................................................................................... 105

Chapter 15 Protocol-based VLAN Commands ....................................................... 106

15.1 protocol-vlan template ............................................................................................................ 106

15.2 protocol-vlan vlan ...................................................................................................................... 107

15.3 protocol-vlan group .................................................................................................................. 108

15.4 show protocol-vlan template ................................................................................................. 108

15.5 show protocol-vlan vlan .......................................................................................................... 109

Chapter 16 GVRP Commands ...................................................................................... 110

16.1 gvrp ................................................................................................................................................. 110

16.2 gvrp (interface)............................................................................................................................ 110

16.3 gvrp registration ......................................................................................................................... 111

16.4 gvrp timer ..................................................................................................................................... 112

16.5 show gvrp interface .................................................................................................................. 113

16.6 show gvrp global ........................................................................................................................ 113

Chapter 17 IGMP Snooping Commands.................................................................... 115

17.1 ip igmp snooping (global) ........................................................................................................ 115

17.2 ip igmp snooping version ........................................................................................................ 115

17.3 ip igmp snooping drop-unknown ......................................................................................... 116

17.4 ip igmp snooping header-validation .................................................................................... 117

17.5 ip igmp snooping vlan-config ................................................................................................ 117

17.6 ip igmp snooping vlan-config (immediate-leave)............................................................ 119

17.7 ip igmp snooping vlan-config (report-suppression) ...................................................... 119

17.8 ip igmp snooping vlan-config (router-ports-forbidden) ............................................... 120

17.9 ip igmp snooping vlan-config (rport interface) ................................................................ 121

17.10 ip igmp snooping vlan-config (static) .................................................................................. 122

17.11 ip igmp snooping vlan-config (querier) ............................................................................... 123

17.12 ip igmp snooping (interface) .................................................................................................. 124

17.13 ip igmp snooping max-groups .............................................................................................. 125

17.14 ip igmp snooping immediate-leave ..................................................................................... 126

17.15 ip igmp profile ............................................................................................................................. 126

17.16 deny ................................................................................................................................................ 127

17.17 permit ............................................................................................................................................. 127

17.18 range .............................................................................................................................................. 128

17.19 ip igmp filter ................................................................................................................................. 129

17.20 clear ip igmp snooping statistics ......................................................................................... 129

17.21 show ip igmp snooping ............................................................................................................ 130

17.22 show ip igmp snooping interface ......................................................................................... 130

17.23 show ip igmp snooping vlan ................................................................................................... 131

17.24 show ip igmp snooping groups ............................................................................................. 132

17.25 show ip igmp profile .................................................................................................................. 133

Chapter 18 MLD Snooping Commands ..................................................................... 134

18.1 ipv6 mld snooping (global) ...................................................................................................... 134

18.2 ipv6 mld snooping drop-unknown ....................................................................................... 134

18.3 ipv6 mld snooping vlan-config .............................................................................................. 135

18.4 ipv6 mld snooping vlan-config (immediate-leave) ......................................................... 136

18.5 ipv6 mld snooping vlan-config (report-suppression) .................................................... 137

18.6 ipv6 mld snooping vlan-config (router-ports-forbidden) ............................................. 138

18.7 ipv6 mld snooping vlan-config (rport interface) .............................................................. 139

18.8 ipv6 mld snooping vlan-config (static) ............................................................................... 139

18.9 ipv6 mld snooping vlan-config (querier) ............................................................................ 140

18.10 ipv6 mld snooping (interface) ................................................................................................ 142

18.11 ipv6 mld snooping max-groups ............................................................................................ 142

18.12 ipv6 mld snooping immediate-leave ................................................................................... 143

18.13 ipv6 mld profile ........................................................................................................................... 144

18.14 deny ................................................................................................................................................ 145

18.15 permit ............................................................................................................................................. 145

18.16 range .............................................................................................................................................. 146

18.17 ipv6 mld filter ............................................................................................................................... 146

18.18 clear ipv6 mld snooping statistics ....................................................................................... 147

18.19 show ipv6 mld snooping .......................................................................................................... 147

18.20 show ipv6 mld snooping interface ....................................................................................... 148

18.21 show ipv6 mld snooping vlan ................................................................................................. 149

18.22 show ipv6 mld snooping groups .......................................................................................... 149

18.23 show ipv6 mld profile ................................................................................................................ 150

Chapter 19 MVR Commands ........................................................................................ 151

19.1 mvr (global) ................................................................................................................................... 151

VII

19.2 mvr group ..................................................................................................................................... 151

19.3 mvr mode ...................................................................................................................................... 152

19.4 mvr querytime ............................................................................................................................. 153

19.5 mvr vlan ......................................................................................................................................... 154

19.6 mvr (interface) ............................................................................................................................. 154

19.7 mvr type ........................................................................................................................................ 155

19.8 mvr immediate ............................................................................................................................ 156

19.9 mvr vlan (group) .......................................................................................................................... 156

19.10 show mvr ...................................................................................................................................... 157

19.11 show mvr interface .................................................................................................................... 158

19.12 show mvr members .................................................................................................................. 158

Chapter 20 MSTP Commands ...................................................................................... 160

20.1 debug spanning-tree ................................................................................................................ 160

20.2 spanning-tree (global) .............................................................................................................. 161

20.3 spanning-tree (interface) ........................................................................................................ 161

20.4 spanning-tree common-config ............................................................................................. 162

20.5 spanning-tree mode ................................................................................................................. 163

20.6 spanning-tree mst configuration ......................................................................................... 164

20.7 instance ......................................................................................................................................... 164

20.8 name ............................................................................................................................................... 165

20.9 revision .......................................................................................................................................... 166

20.10 spanning-tree mst instance ................................................................................................... 167

20.11 spanning-tree mst ..................................................................................................................... 167

20.12 spanning-tree priority .............................................................................................................. 168

20.13 spanning-tree timer .................................................................................................................. 169

20.14 spanning-tree hold-count ....................................................................................................... 170

20.15 spanning-tree max-hops ......................................................................................................... 170

20.16 spanning-tree bpdufilter ......................................................................................................... 171

20.17 spanning-tree bpduflood ........................................................................................................ 172

20.18 spanning-tree bpduguard ....................................................................................................... 172

20.19 spanning-tree guard loop ....................................................................................................... 173

20.20 spanning-tree guard root ........................................................................................................ 174

20.21 spanning-tree guard tc ............................................................................................................ 174

20.22 spanning-tree mcheck ............................................................................................................. 175

20.23 show spanning-tree active ..................................................................................................... 175

20.24 show spanning-tree bridge .................................................................................................... 176

20.25 show spanning-tree interface ............................................................................................... 176

VIII

20.26 show spanning-tree interface-security ............................................................................. 177

20.27 show spanning-tree mst ......................................................................................................... 178

Chapter 21 LLDP Commands ....................................................................................... 180

21.1 lldp................................................................................................................................................... 180

21.2 lldp forward_message .............................................................................................................. 180

21.3 lldp hold-multiplier ..................................................................................................................... 181

21.4 lldp timer ....................................................................................................................................... 182

21.5 lldp receive ................................................................................................................................... 183

21.6 lldp transmit ................................................................................................................................. 183

21.7 lldp snmp-trap ............................................................................................................................. 184

21.8 lldp tlv-select ............................................................................................................................... 185

21.9 lldp management-address ..................................................................................................... 185

21.10 lldp med-fast-count .................................................................................................................. 186

21.11 lldp med-status ........................................................................................................................... 187

21.12 lldp med-tlv-select .................................................................................................................... 187

21.13 lldp med-location ....................................................................................................................... 188

21.14 show lldp ....................................................................................................................................... 189

21.15 show lldp interface .................................................................................................................... 189

21.16 show lldp local-information interface ................................................................................. 190

21.17 show lldp neighbor-information interface ......................................................................... 191

21.18 show lldp traffic interface ....................................................................................................... 191

Chapter 22 Static Routes Commands ....................................................................... 193

22.1 ip routing ....................................................................................................................................... 193

22.2 interface vlan ............................................................................................................................... 193

22.3 interface loopback .................................................................................................................... 194

22.4 switchport .................................................................................................................................... 194

22.5 interface range port-channel ................................................................................................. 195

22.6 description ................................................................................................................................... 196

22.7 shutdown ...................................................................................................................................... 196

22.8 interface port-channel ............................................................................................................. 197

22.9 ip route .......................................................................................................................................... 198

22.10 ipv6 routing .................................................................................................................................. 198

22.11 ipv6 route ...................................................................................................................................... 199

22.12 show interface vlan ................................................................................................................... 200

22.13 show ip interface ........................................................................................................................ 200

22.14 show ip interface brief .............................................................................................................. 201

22.15 show ip route ............................................................................................................................... 201

22.16 show ip route specify ............................................................................................................... 202

22.17 show ip route summary ........................................................................................................... 203

22.18 show ipv6 interface ................................................................................................................... 203

22.19 show ipv6 route .......................................................................................................................... 204

22.20 show ipv6 route summary ...................................................................................................... 204

Chapter 23 IPv6 Address Configuration Commands ............................................ 206

23.1 ipv6 enable ................................................................................................................................... 206

23.2 ipv6 address autoconfig.......................................................................................................... 206

23.3 ipv6 address link-local ............................................................................................................. 207

23.4 ipv6 address dhcp ..................................................................................................................... 208

23.5 ipv6 address ra ........................................................................................................................... 208

23.6 ipv6 address eui-64 .................................................................................................................. 209

23.7 ipv6 address ................................................................................................................................ 210

23.8 ipv6 gateway ............................................................................................................................... 211

23.9 show ipv6 interface ................................................................................................................... 211

Chapter 24 ARP Commands ......................................................................................... 213

24.1 arp ................................................................................................................................................... 213

24.2 clear arp-cache .......................................................................................................................... 214

24.3 arp dynamicrenew ..................................................................................................................... 214

24.4 arp timeout ................................................................................................................................... 215

24.5 gratuitous-arp intf-status-up enable .................................................................................. 215

24.6 gratuitous-arp dup-ip-detected enable ............................................................................. 216

24.7 gratuitous-arp learning enable .............................................................................................. 216

24.8 gratuitous-arp send-interval .................................................................................................. 217

24.9 ip proxy-arp.................................................................................................................................. 218

24.10 ip local-proxy-arp ...................................................................................................................... 218

24.11 show arp ........................................................................................................................................ 219

24.12 show ip arp (interface) .............................................................................................................. 220

24.13 show ip arp summary................................................................................................................ 220

24.14 show gratuitous-arp ................................................................................................................. 221

24.15 show ip proxy-arp ...................................................................................................................... 221

Chapter 25 DHCP Server Commands ........................................................................ 223

25.1 service dhcp server .................................................................................................................. 223

25.2 ip dhcp server extend-option capwap-ac-ip.................................................................... 223

25.3 ip dhcp server extend-option vendor-class-id ............................................................... 224

25.4 ip dhcp server exclude-address ........................................................................................... 225

25.5 ip dhcp server pool ................................................................................................................... 226

25.6 ip dhcp server ping timeout ................................................................................................... 226

25.7 ip dhcp server ping packets ................................................................................................... 227

25.8 network ......................................................................................................................................... 228

25.9 lease ............................................................................................................................................... 228

25.10 address hardware-address .................................................................................................... 229

25.11 address client-identifier .......................................................................................................... 230

25.12 default-gateway ......................................................................................................................... 230

25.13 dns-server .................................................................................................................................... 231

25.14 netbios-name-server ............................................................................................................... 232

25.15 netbios-node-type .................................................................................................................... 232

25.16 next-server ................................................................................................................................... 233

25.17 domain-name .............................................................................................................................. 234

25.18 bootfile .......................................................................................................................................... 234

25.19 show ip dhcp server status .................................................................................................... 235

25.20 show ip dhcp server statistics............................................................................................... 235

25.21 show ip dhcp server extend-option .................................................................................... 236

25.22 show ip dhcp server pool ........................................................................................................ 236

25.23 show ip dhcp server excluded-address ............................................................................ 237

25.24 show ip dhcp server manual-binding .................................................................................. 237

25.25 show ip dhcp server binding .................................................................................................. 238

25.26 clear ip dhcp server statistics ............................................................................................... 238

25.27 clear ip dhcp server binding ................................................................................................... 239

Chapter 26 DHCP Relay Commands .......................................................................... 240

26.1 service dhcp relay ..................................................................................................................... 240

26.2 ip dhcp relay hops ..................................................................................................................... 240

26.3 ip dhcp relay time ....................................................................................................................... 241

26.4 ip helper-address....................................................................................................................... 242

26.5 ip dhcp relay information ........................................................................................................ 242

26.6 ip dhcp relay information strategy ....................................................................................... 243

26.7 ip dhcp relay information format .......................................................................................... 244

26.8 ip dhcp relay information circuit-id ...................................................................................... 245

26.9 ip dhcp relay information remote-id .................................................................................... 245

26.10 ip dhcp relay default-interface .............................................................................................. 246

26.11 ip dhcp relay vlan ....................................................................................................................... 247

26.12 show ip dhcp relay ..................................................................................................................... 247

Chapter 27 DHCP L2 Relay Commands .................................................................... 249

27.1 ip dhcp l2relay ............................................................................................................................. 249

27.2 ip dhcp l2relay vlan .................................................................................................................... 249

27.3 ip dhcp l2relay information ..................................................................................................... 250

27.4 ip dhcp l2relay information strategy ................................................................................... 250

27.5 ip dhcp l2relay information format....................................................................................... 251

27.6 ip dhcp l2relay information circuit-id .................................................................................. 252

27.7 ip dhcp l2relay information remote-id ................................................................................ 253

27.8 show ip dhcp l2relay ................................................................................................................. 253

27.9 show ip dhcp l2relay interface .............................................................................................. 254

Chapter 28 QoS Commands ......................................................................................... 255

28.1 qos trust mode ........................................................................................................................... 255

28.2 qos port-priority ......................................................................................................................... 256

28.3 qos cos-map ............................................................................................................................... 256

28.4 qos dot1p-remap ....................................................................................................................... 257

28.5 qos dscp-map ............................................................................................................................. 258

28.6 qos dscp-remap ......................................................................................................................... 259

28.7 qos queue bandwidth ............................................................................................................... 259

28.8 qos queue mode ........................................................................................................................ 260

28.9 show qos cos-map .................................................................................................................... 261

28.10 show qos dot1p-remap ........................................................................................................... 262

28.11 show qos dscp-map ................................................................................................................. 262

28.12 show qos dscp-remap ............................................................................................................. 263

28.13 show qos port-priority interface........................................................................................... 263

28.14 show qos trust interface ......................................................................................................... 264

28.15 show qos queue interface ...................................................................................................... 264

Chapter 29 Bandwidth Control Commands ............................................................. 266

29.1 storm-control rate-mode ........................................................................................................ 266

29.2 storm-control .............................................................................................................................. 267

29.3 storm-control exceed .............................................................................................................. 268

29.4 storm-control recover ............................................................................................................. 268

29.5 bandwidth ..................................................................................................................................... 269

29.6 show storm-control .................................................................................................................. 270

29.7 show bandwidth ......................................................................................................................... 270

XII

Chapter 30 Voice VLAN Commands .......................................................................... 272

30.1 voice vlan ...................................................................................................................................... 272

30.2 voice vlan (interface) ................................................................................................................. 272

30.3 voice vlan priority ....................................................................................................................... 273

30.4 voice vlan oui ............................................................................................................................... 274

30.5 show voice vlan .......................................................................................................................... 274

30.6 show voice vlan oui-table........................................................................................................ 275

30.7 show voice vlan interface ....................................................................................................... 275

Chapter 31 Auto VoIP Commands .............................................................................. 277

31.1 auto-voip ....................................................................................................................................... 277

31.2 auto-voip (interface) ................................................................................................................. 277

31.3 auto-voip dot1p .......................................................................................................................... 278

31.4 auto-voip untagged .................................................................................................................. 279

31.5 auto-voip none ........................................................................................................................... 279

31.6 no auto-voip (interface) ........................................................................................................... 280

31.7 auto-voip dscp ............................................................................................................................ 280

31.8 auto-voip data priority .............................................................................................................. 281

31.9 show auto-voip ........................................................................................................................... 281

Chapter 32 Access Control Commands ................................................................... 283

32.1 user access-control ip-based enable ................................................................................. 283

32.2 user access-control ip-based ............................................................................................... 283

32.3 user access-control mac-based enable ............................................................................ 284

32.4 user access-control mac-based .......................................................................................... 285

32.5 user access-control port-based enable ............................................................................ 286

32.6 user access-control port-based .......................................................................................... 286

Chapter 33 HTTP and HTTPS Commands ................................................................ 288

33.1 ip http server ............................................................................................................................... 288

33.2 ip http port .................................................................................................................................... 288

33.3 ip http max-users ....................................................................................................................... 289

33.4 ip http session timeout ............................................................................................................ 290

33.5 ip http secure-server ................................................................................................................ 291

33.6 ip http secure-port .................................................................................................................... 291

33.7 ip http secure-protocol............................................................................................................ 292

33.8 ip http secure-ciphersuite ...................................................................................................... 293

33.9 ip http secure-max-users ....................................................................................................... 293

XIII

33.10 ip http secure-session timeout ............................................................................................. 294

33.11 ip http secure-server download certificate ...................................................................... 295

33.12 ip http secure-server download key ................................................................................... 296

33.13 show ip http configuration ...................................................................................................... 297

33.14 show ip http secure-server .................................................................................................... 297

Chapter 34 SSH Commands ......................................................................................... 299

34.1 ip ssh server ................................................................................................................................ 299

34.2 ip ssh port ..................................................................................................................................... 299

34.3 ip ssh version .............................................................................................................................. 300

34.4 ip ssh algorithm .......................................................................................................................... 301

34.5 ip ssh timeout .............................................................................................................................. 301

34.6 ip ssh max-client ........................................................................................................................ 302

34.7 ip ssh download .......................................................................................................................... 303

34.8 remove public-key ..................................................................................................................... 303

34.9 show ip ssh................................................................................................................................... 304

Chapter 35 Telnet Commands ..................................................................................... 305

35.1 telnet .............................................................................................................................................. 305

35.2 telnet enable ................................................................................................................................ 305

35.3 telnet port ..................................................................................................................................... 306

35.4 show telnet-status..................................................................................................................... 306

Chapter 36 AAA Commands ........................................................................................ 308

36.1 tacacas-server host .................................................................................................................. 308

36.2 show tacacs-server .................................................................................................................. 309

36.3 radius-server host ..................................................................................................................... 310

36.4 show radius-server ................................................................................................................... 311

36.5 aaa group ...................................................................................................................................... 312

36.6 server ............................................................................................................................................. 313

36.7 show aaa group .......................................................................................................................... 313

36.8 aaa authentication login .......................................................................................................... 314

36.9 aaa authentication enable....................................................................................................... 315

36.10 aaa authentication dot1x default .......................................................................................... 316

36.11 aaa accounting dot1x default ................................................................................................ 317

36.12 show aaa authentication ......................................................................................................... 317

36.13 show aaa accounting ................................................................................................................ 318

36.14 line telnet ...................................................................................................................................... 318

36.15 login authentication (telnet) .................................................................................................... 319

XIV

36.16 line ssh ........................................................................................................................................... 320

36.17 login authentication (ssh) ........................................................................................................ 320

36.18 enable authentication (telnet) ................................................................................................ 321

36.19 enable authentication (ssh) .................................................................................................... 322

36.20 ip http login authentication ..................................................................................................... 322

36.21 ip http enable authentication ................................................................................................. 323

36.22 show aaa global .......................................................................................................................... 324

36.23 enable admin password ........................................................................................................... 324

36.24 enable admin secret ................................................................................................................. 325

36.25 enable-admin .............................................................................................................................. 326

Chapter 37 IEEE 802.1x Commands ........................................................................... 328

37.1 dot1x system-auth-control .................................................................................................... 328

37.2 dot1x handshake ....................................................................................................................... 329

37.3 dot1x auth-protocol .................................................................................................................. 329

37.4 dot1x vlan-assignment ............................................................................................................ 330

37.5 dot1x accounting ....................................................................................................................... 331

37.6 dot1x mab .................................................................................................................................... 332

37.7 dot1x guest-vlan ........................................................................................................................ 332

37.8 dot1x timeout quiet-period .................................................................................................... 333

37.9 dot1x timeout supp-timeout .................................................................................................. 334

37.10 dot1x max- req ........................................................................................................................... 335

37.11 dot1x .............................................................................................................................................. 335

37.12 dot1x port-control ..................................................................................................................... 336

37.13 dot1x port-method .................................................................................................................... 337

37.14 dot1x auth-init ............................................................................................................................. 338

37.15 dot1x auth-reauth ...................................................................................................................... 338

37.16 show dot1x global ..................................................................................................................... 339

37.17 show dot1x interface ................................................................................................................ 340

37.18 show dot1x auth-state interface .......................................................................................... 340

Chapter 38 Port Security Commands ........................................................................ 342

38.1 mac address-table max-mac count .................................................................................... 342

38.2 show mac address-table max-mac-count ........................................................................ 342

Chapter 39 Port Mirroring Commands ...................................................................... 344

39.1 monitor session destination interface................................................................................ 344

39.2 monitor session source ........................................................................................................... 345

39.3 show monitor session .............................................................................................................. 346

Chapter 40 ACL Commands ......................................................................................... 348

40.1 access-list create ...................................................................................................................... 348

40.2 access-list resequence ........................................................................................................... 348

40.3 access-list mac .......................................................................................................................... 349

40.4 access-list ip ............................................................................................................................... 351

40.5 access-list combined ............................................................................................................... 353

40.6 access-list ipv6 .......................................................................................................................... 355

40.7 access-list action....................................................................................................................... 356

40.8 redirect .......................................................................................................................................... 357

40.9 s-condition ................................................................................................................................... 358

40.10 s-mirror.......................................................................................................................................... 359

40.11 qos-remark .................................................................................................................................. 359

40.12 access bind .................................................................................................................................. 360

40.13 show access-list ........................................................................................................................ 361

40.14 show access-list bind ............................................................................................................... 362

40.15 show access-list status ........................................................................................................... 362

40.16 show access-list counter ........................................................................................................ 362

40.17 clear access-list ......................................................................................................................... 363

Chapter 41 IPv4 IMPB Commands .............................................................................. 364

41.1 ip source binding ....................................................................................................................... 364

41.2 ip dhcp snooping ....................................................................................................................... 365

41.3 ip dhcp snooping vlan .............................................................................................................. 366

41.4 ip dhcp snooping max-entries .............................................................................................. 366

41.5 show ip source binding ............................................................................................................ 367

41.6 show ip dhcp snooping ............................................................................................................ 368

41.7 show ip dhcp snooping interface ......................................................................................... 368

Chapter 42 IPv6 IMPB Commands .............................................................................. 370

42.1 Ipv6 source binding................................................................................................................... 370

42.2 ipv6 dhcp snooping .................................................................................................................. 371

42.3 ipv6 dhcp snooping vlan ......................................................................................................... 372

42.4 ipv6 dhcp snooping max-entries .......................................................................................... 372

42.5 ipv6 nd snooping ....................................................................................................................... 373

42.6 ipv6 nd snooping vlan .............................................................................................................. 374

42.7 ipv6 nd snooping max-entries ............................................................................................... 374

42.8 show ipv6 source binding ....................................................................................................... 375

42.9 show ipv6 dhcp snooping ....................................................................................................... 376

XVI

42.10 show ipv6 dhcp snooping interface .................................................................................... 376

42.11 show ipv6 nd snooping ............................................................................................................ 377

42.12 show ipv6 nd snooping interface ......................................................................................... 377

Chapter 43 IP Verify Source Commands .................................................................. 379

43.1 ip verify source ........................................................................................................................... 379

43.2 ip verify source logging ........................................................................................................... 380

43.3 show ip verify source ................................................................................................................ 380

43.4 show ip verify source interface ............................................................................................. 381

Chapter 44 IPv6 Verify Source Commands ............................................................. 382

44.1 ipv6 verify source ...................................................................................................................... 382

44.2 show ipv6 verify source ........................................................................................................... 383

44.3 show ipv6 verify source interface ........................................................................................ 383

Chapter 45 DHCPv4 Filter Commands ...................................................................... 385

45.1 ip dhcp filter ................................................................................................................................. 385

45.2 ip dhcp filter (interface) ............................................................................................................ 385

45.3 ip dhcp filter mac-verify ........................................................................................................... 386

45.4 ip dhcp filter limit rate ............................................................................................................... 387

45.5 ip dhcp filter decline rate ......................................................................................................... 388

45.6 ip dhcp filter server permit-entry ......................................................................................... 388

45.7 show ip dhcp filter ..................................................................................................................... 389

45.8 show ip dhcp filter interface ................................................................................................... 390

45.9 show ip dhcp filter server permit-entry .............................................................................. 390

Chapter 46 DHCPv6 Filter Commands ...................................................................... 392

46.1 ipv6 dhcp filter ............................................................................................................................ 392

46.2 ipv6 dhcp filter (interface) ....................................................................................................... 392

46.3 ipv6 dhcp filter limit rate .......................................................................................................... 393

46.4 ipv6 dhcp filter decline rate .................................................................................................... 394

46.5 ipv6 dhcp filter server permit-entry .................................................................................... 395

46.6 show ipv6 dhcp filter................................................................................................................. 396

46.7 show ipv6 dhcp filter interface .............................................................................................. 396

46.8 show ip dhcp filter server permit-entry .............................................................................. 397

Chapter 47 DoS Defend Commands .......................................................................... 398

47.1 ip dos-prevent ............................................................................................................................ 398

47.2 ip dos-prevent type................................................................................................................... 398

XVII

47.3 show ip dos-prevent ................................................................................................................. 400

Chapter 48 DLDP Commands ...................................................................................... 402

48.1 dldp (global) ................................................................................................................................. 402

48.2 dldp interval ................................................................................................................................. 402

48.3 dldp shut-mode .......................................................................................................................... 403

48.4 dldp(interface) ............................................................................................................................. 404

48.5 show dldp ..................................................................................................................................... 404

48.6 show dldp interface................................................................................................................... 405

Chapter 49 SNMP Commands ..................................................................................... 406

49.1 snmp-server ................................................................................................................................ 406

49.2 snmp-server view ...................................................................................................................... 406

49.3 snmp-server group ................................................................................................................... 407

49.4 snmp-server user ...................................................................................................................... 409

49.5 snmp-server community ......................................................................................................... 410

49.6 snmp-server host ...................................................................................................................... 411

49.7 snmp-server engineID ............................................................................................................. 413

49.8 snmp-server traps snmp ......................................................................................................... 414

49.9 snmp-server traps ..................................................................................................................... 415

49.10 snmp-server traps ddm ........................................................................................................... 416

49.11 snmp-server traps vlan ............................................................................................................ 417

49.12 snmp-server traps security .................................................................................................... 418

49.13 snmp-server traps acl .............................................................................................................. 419

49.14 snmp-server traps ip ................................................................................................................ 419

49.15 snmp-server traps link-status ............................................................................................... 420

49.16 rmon history ................................................................................................................................ 421

49.17 rmon event ................................................................................................................................... 422

49.18 rmon alarm ................................................................................................................................... 423

49.19 rmon statistics ............................................................................................................................ 424

49.20 show snmp-server..................................................................................................................... 425

49.21 show snmp-server view ........................................................................................................... 425

49.22 show snmp-server group ........................................................................................................ 426

49.23 show snmp-server user ........................................................................................................... 426

49.24 show snmp-server community ............................................................................................. 427

49.25 show snmp-server host ........................................................................................................... 427

49.26 show snmp-server engineID .................................................................................................. 428

49.27 show rmon history ..................................................................................................................... 428

XVIII

49.28 show rmon event ....................................................................................................................... 429

49.29 show rmon alarm ........................................................................................................................ 429

49.30 show rmon statistics ................................................................................................................ 430

Chapter 50 ARP Inspection Commands .................................................................... 431

50.1 ip arp inspection ......................................................................................................................... 431

50.2 ip arp inspection validate ........................................................................................................ 431

50.3 ip arp inspection vlan ................................................................................................................ 432

50.4 ip arp inspection vlan logging ................................................................................................ 433

50.5 ip arp inspection trust .............................................................................................................. 434

50.6 ip arp inspection limit-rate ...................................................................................................... 434

50.7 ip arp inspection burst-interval ............................................................................................. 435

50.8 ip arp inspection recover ........................................................................................................ 436

50.9 show ip arp inspection ............................................................................................................. 436

50.10 show ip arp inspection interface .......................................................................................... 437

50.11 show ip arp inspection vlan .................................................................................................... 438

50.12 show ip arp inspection statistics .......................................................................................... 438

50.13 clear ip arp inspection statistics ........................................................................................... 439

Chapter 51 ND Detection Commands ....................................................................... 440

51.1 ipv6 nd detection ....................................................................................................................... 440

51.2 ipv6 nd detection vlan .............................................................................................................. 440

51.3 ipv6 nd detection vlan logging .............................................................................................. 441

51.4 ipv6 nd detection trust ............................................................................................................. 441

51.5 show ipv6 nd detection ........................................................................................................... 442

51.6 show ipv6 nd detection interface ......................................................................................... 442

51.7 show ipv6 nd detection statistics ........................................................................................ 443

51.8 show ipv6 nd detection vlan .................................................................................................. 444

Chapter 52 System Log Commands .......................................................................... 445

52.1 logging buffer .............................................................................................................................. 445

52.2 logging buffer level .................................................................................................................... 445

52.3 logging file flash ......................................................................................................................... 446

52.4 logging file flash frequency .................................................................................................... 447

52.5 logging file flash level ............................................................................................................... 448

52.6 logging host index ..................................................................................................................... 448

52.7 logging console .......................................................................................................................... 449

52.8 logging console level ................................................................................................................ 450

52.9 logging monitor .......................................................................................................................... 451

XIX

52.10 logging monitor level ................................................................................................................ 451

52.11 clear logging ................................................................................................................................ 452

52.12 show logging local-config....................................................................................................... 453

52.13 show logging loghost ............................................................................................................... 453

52.14 show logging buffer .................................................................................................................. 454

52.15 show logging flash ..................................................................................................................... 454

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 T1700X-16TS without any explanation. The commands in this guide apply to these models if not specially noted. Some models featured in this guide may be unavailable in your country or region. For local sales information, visit https://www.tp-link.com.

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: User Management Commands

Provide information about the commands used for user management.

Chapter 4: 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

cable test.

Chapter 5: EEE Configuration Commands

Provide information about the commands used for configuring EEE.

Chapter 6: SDM Template Commands

Provide information about the commands used for configuring the SDM templates.

Chapter 7: Time Range Commands

Provide information about the commands used for configuring the time range.

Chapter 8: Port Configuration Commands

Provide information about the commands used for configuring the Speed, Negotiation Mode,

and Flow Control for Ethernet ports.

Chapter 9: Port Isolation Commands

Provide information about the commands used for configuring Port Isolation function.

Chapter 10: Loopback Detection Commands

Provide information about the commands used for configuring the Loopback Detection

function.

Chapter 11: Etherchannel Commands

Provide information about the commands used for configuring LAG (Link Aggregation Group)

and LACP (Link Aggregation Control Protocol).

Chapter 12: MAC Address Commands

Provide information about the commands used for Address configuration.

Chapter 13: IEEE 802.1Q VLAN Commands

Provide information about the commands used for configuring IEEE 802.1Q VLAN.

Chapter 14: MAC-based VLAN Commands

Provide information about the commands used for configuring MAC-based VLAN.

Chapter 15: Protocol-based VLAN Commands

Provide information about the commands used for configuring Protocol VLAN.

Chapter 16: GVRP Commands

Provide information about the commands used for configuring GVRP (GARP VLAN registration

protocol).

Chapter 17: IGMP Snooping Commands

Provide information about the commands used for configuring the IGMP Snooping (Internet

Group Management Protocol Snooping).

Chapter 18: MLD Snooping Commands

Provide information about the commands used for configuring the MLD Snooping (Multicast

Listener Discovery Snooping).

Chapter 19: MVR Commands

Provide information about the commands used for configuring the MVR.

Chapter 20: MSTP Commands

Provide information about the commands used for configuring the MSTP (Multiple Spanning

Tree Protocol).

Chapter 21: LLDP Commands

Provide information about the commands used for configuring LLDP function.

Chapter 22: Static Routes Commands

Provide information about the commands used for configuring the Static Route function.

Chapter 23: IPv6 Address Configuration Commands

Provide information about the commands used for configuring the System IPv6 addresses.

Chapter 24: ARP Commands

Provide information about the commands used for configuring the ARP (Address Resolution

Protocol) functions.

Chapter 25: DHCP Server Commands

Provide information about the commands used for configuring the DHCP Server function.

Chapter 26: DHCP Relay Commands

Provide information about the commands used for configuring the DHCP Relay function.

Chapter 27: DHCP L2 Relay Commands

Provide information about the commands used for configuring the DHCP L2 Relay function.

Chapter 28: QoS Commands

Provide information about the commands used for configuring the QoS function.

Chapter 29: Bandwidth Commands

Provide information about the commands used for configuring the Bandwidth Control.

Chapter 30: Voice VLAN Commands

Provide information about the commands used for configuring Voice VLAN.

Chapter 31 Auto VoIP Commands

Provide information about the commands used for configuring Auto VoIP.

Chapter 32: Access Control Commands

Provide information about the commands used for configuring Access Control.

Chapter 33: HTTP and HTTPS Commands

Provide information about the commands used for configuring the HTTP and HTTPS logon.

Chapter 34: SSH Commands

Provide information about the commands used for configuring and managing SSH (Security

Shell).

Chapter 35: Telnet Commands

Provide information about the commands used for configuring and managing SSH (Security

Shell).

Chapter 36: AAA Commands

Provide information about the commands used for configuring AAA (authentication,

authorization and accounting).

Chapter 37: IEEE 802.1X Commands

Provide information about the commands used for configuring IEEE 802.1X function.

Chapter 38 Port Security Commands

Provide information about the commands used for configuring Port Security.

Chapter 39: Port Mirroring Commands

Provide information about the commands used for configuring the Port Mirror function.

Chapter 40: ACL Commands

Provide information about the commands used for configuring the ACL (Access Control List).

Chapter 41: IPv4 IMPB 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 42: IPv6 IMPB Commands

Provide information about the commands used for binding the IPv6 address, MAC address,

VLAN and the connected Port number of the Host together.

Chapter 43: 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 44: IPv6 Verify Source Commands

Provide information about the commands used for guarding the IPv6 Source by filtering the IP

packets based on the IP-MAC Binding entries.

Chapter 45: DHCPv4 Filter Commands

Provide information about the commands used for configuring the DHCPv4 Filter.

Chapter 46: DHCPv6 Filter Commands

Provide information about the commands used for configuring the DHCPv6 Filter.

Chapter 47: DoS Defend Command

Provide information about the commands used for DoS defend and detecting the DoS attack.

Chapter 48: DLDP Commands

Provide information about the commands used for configuring the DLDP (Device Link

Detection Protocol).

Chapter 49: SNMP Commands

Provide information about the commands used for configuring the SNMP (Simple Network

Management Protocol) functions.

Chapter 50: ARP Inspection Commands

Provide information about the commands used for protecting the switch from the ARP

cheating or ARP Attack.

Chapter 51: ND Detection Commands

Provide information about the commands used for configuring ND detection.

Chapter 52: System Log Commands

Provide information about the commands used for configuring system log.

Chapter 1 Using the CLI

1.1 Accessing the CLI

You can log on to the switch and access the CLI by logging on to the switch remotely by a

Telnet or SSH connection through an Ethernet port.

1.1.1 Logon by Telnet

To log on to the switch by a Telnet connection, please take the following steps:

1. Click Start and type in cmd in the Search programs and files window and press the Enter

button.

Figure 1-1 Run Window

2. Type in telnet 192.168.0.1 in the cmd window and press Enter.

Figure 1-2 Type in the telnet command

Note:

3. Type in the login username and password (both admin by default). Press Enter and you will

enter User EXEC Mode.

igure 1-3 Log in the Switch

The first time you log in, change the password to better protect your network and

devices.

4. Type in enable command and you will enter Privileged EXEC Mode. By default no password

is needed. Later you can set a password for users who want to access the Privileged EXEC

Mode.

Figure 1-4 Enter into Priviledged EXEC Mode

1.1.2 Logon by SSH

To log on by SSH, a Putty client software is recommended. There are two authentication modes

to set up an SSH connection:

Password Authentication Mode: It requires username and password, which are both admin by default.

Key Authentication Mode: It requires a public key for the switch and a private key for the SSH client software. You can generate the public key and the private key through Putty Key Generator.

Note:

1. Before SSH login, please follow the steps shown in Figure 1-5 to enable the SSH function

through Telnet connection.

2. The first time you log in, change the password to better protect your network and devices.

Figure 1-5 Enable SSH function

• Password Authentication Mode

1. Open the software to log on to the interface of PuTTY. Enter the IP address of the switch

into Host Name field; keep the default value 22 in the Port field; select SSH as the

Connection type.

Figure 1-6 SSH Connection Config

2. Click the Open button in the above figure to log on to the switch. Enter the login user name

and password to log on the switch, and then enter enable to enter Privileged EXEC Mode,

so you can continue to configure the switch.

Figure 1-7 Log on the Switch

• Key Authentication Mode

1. Select the key type and key length, and generate SSH key.

Figure 1-8 Generate SSH Key

Note:

1. The key length is in the range of 512 to 3072 bits.

2. During the key generation, randomly moving the mouse quickly can accelerate the key

generation.

2. After the key is successfully generated, please save the public key and private key to a

TFTP server.

Figure 1-9 Save the Generated Key

3. Log on to the switch by Telnet and download the public key file from the TFTP server to the

switch, as the following figure shows:

Figure 1-10 Download the Public Key

+ 446 hidden pages