PLANET XGS3-24040 User Manual

Command G uide
XGS3-24040
24-Port Gigabit with 4 Optional 10G slots
XGS3 Command Guide
Layer 3 IPv6/IPv4 Managed Stackable Switch
XGS3-42000R
1-1
XGS3 Command Guide
Content
CHAPTER 1 COMMANDS FOR BASIC SWITCH CONFIGURATION ..........................1-42
1.1 COMMANDS FOR BASIC CONFIGURATION ............................................................................................ 1-42
1.1.1 Authe nti cat ion lin e ................................................................................................................................. 1-42
1.1.2 boot img ................................................................................................................................................ 1-42
1.1.3 boot startup-config ................................................................................................................................ 1-43
1.1.4 clock set ................................................................................................................................................ 1-44
1.1.5 config .................................................................................................................................................... 1-45
1.1.6 debug ssh-server .................................................................................................................................. 1-45
1.1.7 enable ................................................................................................................................................... 1-45
1.1.8 enable password ................................................................................................................................... 1-46
1.1.9 end ........................................................................................................................................................ 1-46
1.1.10 exec-timeout ....................................................................................................................................... 1-46
1.1.11 exit ....................................................................................................................................................... 1-47
1.1.12 help ..................................................................................................................................................... 1-47
1.1.13 hostname ............................................................................................................................................ 1-48
1.1.14 ip host ................................................................................................................................................. 1-48
1.1.15 ipv6 host .............................................................................................................................................. 1-49
1.1.16 ip http server ....................................................................................................................................... 1-49
1.1.17 language ............................................................................................................................................. 1-50
1.1.18 login .................................................................................................................................................... 1-50
1.1.19 password ............................................................................................................................................. 1-50
1.1.20 reload .................................................................................................................................................. 1-51
1.1.21 service passw ord-encryption ............................................................................................................... 1-51
1.1.22 service terminal-length ........................................................................................................................ 1-52
1.1.23 sysContact .......................................................................................................................................... 1-52
1.1.24 sysLocation ......................................................................................................................................... 1-52
1.1.25 set default ........................................................................................................................................... 1-53
1.1.26 setup ................................................................................................................................................... 1-53
1.1.27 show clock .......................................................................................................................................... 1-54
1.1.28 show temperature ............................................................................................................................... 1-54
1.1.29 show tech-support ............................................................................................................................... 1-54
1.1.30 show version ....................................................................................................................................... 1-55
1.1.31 username ............................................................................................................................................ 1-55
1.1.32 web language ...................................................................................................................................... 1-56
1.1.33 write .................................................................................................................................................... 1-56
1.2 COMMANDS FOR TELNET ................................................................................................................... 1-56
1-2
XGS3 Command Guide
1.2.1 authentication ip access-class .............................................................................................................. 1-56
1.2.2 authentication ipv6 access-class ........................................................................................................... 1-57
1.2.3 authentication line login ........................................................................................................................ 1-57
1.2.4 authentication security ip ........................................................................................................................ 1-58
1.2.5 authentication security ip v 6 .................................................................................................................... 1-59
1.2.6 terminal length ...................................................................................................................................... 1-59
1.2.7 terminal monitor .................................................................................................................................... 1-60
1.2.8 telnet ..................................................................................................................................................... 1-60
1.2.9 telnet server enable .............................................................................................................................. 1-61
1.2.10 telnet-server max-connection .............................................................................................................. 1-61
1.2.11 ssh-server authenticat io n-retries ......................................................................................................... 1-61
1.2.12 ssh-server enable ............................................................................................................................... 1-62
1.2.13 ssh-server host-key create rsa ............................................................................................................ 1-62
1.2.14 ssh-server max-connection ................................................................................................................. 1-63
1.2.15 ssh-server timeout .............................................................................................................................. 1-63
1.2.16 ssh-user .............................................................................................................................................. 1-64
1.2.17 show ssh-server .................................................................................................................................. 1-64
1.2.18 show ssh-user ..................................................................................................................................... 1-64
1.2.19 show telnet login ................................................................................................................................. 1-65
1.3 COMMANDS FOR CONFIGURING SWITCH IP ......................................................................................... 1-65
1.3.1 interface vlan ......................................................................................................................................... 1-65
1.3.2 interface ethernet 0 ............................................................................................................................... 1-66
1.3.3 ip address ............................................................................................................................................. 1-66
1.3.4 ipv6 address .......................................................................................................................................... 1-66
1.3.5 ip bootp-client enable ............................................................................................................................ 1-67
1.3.6 ip dhcp-client enable ............................................................................................................................. 1-67
1.4 COMMANDS FOR SNMP ..................................................................................................................... 1-68
1.4.1 debug snmp mib ................................................................................................................................... 1-68
1.4.2 debug snmp kernel ............................................................................................................................... 1-68
1.4.3 rmon enable .......................................................................................................................................... 1-69
1.4.4 show snmp ............................................................................................................................................ 1-69
1.4.5 show snmp engineid ............................................................................................................................. 1-71
1.4.6 show snmp group .................................................................................................................................. 1-72
1.4.7 show snmp mib ..................................................................................................................................... 1-72
1.4.8 show snmp status ................................................................................................................................. 1-73
1.4.9 show snmp user .................................................................................................................................... 1-74
1.4.10 show snmp view .................................................................................................................................. 1-74
1.4.11 snmp-server community ...................................................................................................................... 1-75
1.4.12 snmp-server enable ............................................................................................................................ 1-76
1-3
XGS3 Command Guide
1.4.13 snmp-server enable traps ................................................................................................................... 1-77
1.4.14 snmp-server engineid ......................................................................................................................... 1-77
1.4.15 snmp-server group .............................................................................................................................. 1-78
1.4.16 snmp-server host ................................................................................................................................ 1-78
1.4.17 snmp-server secur ity ip ........................................................................................................................ 1-79
1.4.18 snmp-server secur ity ip ........................................................................................................................ 1-80
1.4.19 snmp-server view ................................................................................................................................ 1-80
1.4.20 snmp-server user ................................................................................................................................ 1-81
1.5 COMMANDS FOR SWITCH UPGRADE ................................................................................................... 1-81
1.5.1 copyFTP ........................................................................................................................................ 1-81
1.5.2 copyTFTP ...................................................................................................................................... 1-83
1.5.3 ftp-dir
1.5.4 ftp-server enable ................................................................................................................................... 1-85
1.5.5 ftp-server timeout .................................................................................................................................. 1-85
1.5.6 ip ftp ...................................................................................................................................................... 1-85
1.5.7 show ftp ................................................................................................................................................. 1-86
1.5.8 show tftp ................................................................................................................................................ 1-86
1.5.9 tftp-server enable .................................................................................................................................. 1-87
1.5.10 tftp-server retransmission-number ...................................................................................................... 1-88
1.5.11 tftp-server transmission-timeout .......................................................................................................... 1-88
CHAPTER 2 FILE SYSTEM COMMANDS .....................................................................2-89
2.1 CD .................................................................................................................................................... 2-89
2.2
COPY ................................................................................................................................................ 2-89
2.3
DELETE ............................................................................................................................................. 2-90
2.4
DIR .................................................................................................................................................... 2-90
2.5
FORM AT ............................................................................................................................................ 2-91
2.6
MKDIR ............................................................................................................................................... 2-91
..................................................................................................................................................... 1-84
2.7
MOUNT .............................................................................................................................................. 2-92
2.8
PWD .................................................................................................................................................. 2-92
2.9
RENAME ............................................................................................................................................ 2-93
2.10
RMDIR ............................................................................................................................................. 2-93
2.11
UNMOUNT ........................................................................................................................................ 2-93
CHAPTER 3 COMMANDS FOR CLUSTER ...................................................................3-95
3.1 CLEAR CLUSTER NODES ..................................................................................................................... 3-95
3.2
CLUSTER AUTO-ADD ........................................................................................................................... 3-95
3.3
CLUSTER COMMANDER ....................................................................................................................... 3-95
3.4
CLUSTER IP-POOL .............................................................................................................................. 3-96
3.5
CLUSTER KEEPALIVE INTERVAL ........................................................................................................... 3-97
1-4
XGS3 Command Guide
3.6 CLUSTER KEEPALIVE LOSS-COUNT ...................................................................................................... 3-97
3.7
CLUSTER MEMBER ............................................................................................................................. 3-98
3.8
CLUSTER MEMBER AUTO-TO-USER ...................................................................................................... 3-99
3.9
CLUSTER RESET MEMBER ................................................................................................................... 3-99
3.10
CLUSTER RUN ................................................................................................................................ 3-100
3.11
CLUSTER UPDATE MEMBER ............................................................................................................. 3-100
3.12
DEBUG CLUSTER ............................................................................................................................ 3-101
3.13
DEBUG CLUSTER PACKETS ............................................................................................................. 3-101
3.14
SHOW CLUSTER ............................................................................................................................. 3-102
3.15
SHOW CLUSTER MEMBERS ............................................................................................................. 3-103
3.16
SHOW CLUSTER CANDIDATES .......................................................................................................... 3-104
3.17
SHOW CLUSTER TOPOLOGY ............................................................................................................ 3-104
3.18
RCOMMAND COMMANDER ............................................................................................................... 3-106
3.19
RCOMMAND MEMBER ..................................................................................................................... 3-106
CHAPTER 4 COMMANDS FOR NETWORK PORT CONFIGURATION .....................4-108
4.1 COMMANDS FOR ETHERNET PORT CONFIGURATION .......................................................................... 4-108
4.1.1 bandwidth ............................................................................................................................................ 4-108
4.1.2 combo-forced-mode ............................................................................................................................ 4-109
4.1.3 clear counters interface ........................................................................................................................ 4-111
4.1.4 flow control ........................................................................................................................................... 4-111
4.1.5 interface ethernet ................................................................................................................................ 4-112
4.1.6 loopback .............................................................................................................................................. 4-112
4.1.7 mdi ...................................................................................................................................................... 4-113
4.1.8 name ................................................................................................................................................... 4-113
4.1.9 negotiation .......................................................................................................................................... 4-114
4.1.10 rate-suppression ............................................................................................................................... 4-114
4.1.11 rate-violation ...................................................................................................................................... 4-115
4.1.12 show interface ................................................................................................................................... 4-116
4.1.13 shutdown ........................................................................................................................................... 4-119
4.1.14 speed-duplex .................................................................................................................................... 4-120
CHAPTER 5 COMMANDS FOR PORT ISOLATION FUNCTION ................................5-122
5.1 ISOLATE-PORT GROUP ...................................................................................................................... 5-122
5.2
ISOLATE-PORT GROUP SWITCHPORT INTERFACE ................................................................................ 5-122
5.3
ISOLATE-PORT APPLY ....................................................................................................................... 5-123
5.4
SHOW ISOLATE-PORT GROUP ............................................................................................................ 5-123
CHAPTER 6 COMMANDS FOR PORT LOOPBACK DETE CTION FUNCTION .........6-125
6.1 LOOPBACK-DETECTION CONTROL ..................................................................................................... 6-125
1-5
XGS3 Command Guide
6.2 LOOPBACK-DETECTION SPECIFIED-VLAN ........................................................................................... 6-125
6.3
LOOPBACK-DETECTION INTERVAL-TIME ............................................................................................. 6-126
6.4
LOOPBACK-DETECTION CONTROL-RECOVERY TIMEOUT ...................................................................... 6-127
6.5
SHOW L OOPBACK-DETECTION .......................................................................................................... 6-127
6.6
DEBUG LOOPBACK-DETECTION ......................................................................................................... 6-128
CHAPTER 7 COMMANDS FOR ULDP ........................................................................7-128
7.1 ULDP ENABLE .................................................................................................................................. 7-128
7.2
ULDP DISABLE ................................................................................................................................. 7-129
7.3
ULDP HELLO-INTERVAL ..................................................................................................................... 7-129
7.4
ULDP A G G R ESSIVE-MODE ................................................................................................................. 7-129
7.5
ULDP MANUAL-SHUTDOWN ............................................................................................................... 7-130
7.6
ULDP RESET .................................................................................................................................... 7-130
7.7
ULDP RECOVERY-TIME ...................................................................................................................... 7-131
7.8
SHOW ULDP ..................................................................................................................................... 7-131
7.9
DEBUG ULDP FSM INTERFACE ETHERNET ........................................................................................... 7-132
7.10
DEBUG ULDP ERROR ...................................................................................................................... 7-132
7.11
DEBUG ULDP EVENT ....................................................................................................................... 7-133
7.12
DEBUG ULDP PACKET ..................................................................................................................... 7-133
7.13
DEBUG ULDP INTERFACE ETHERNET ................................................................................................ 7-133
CHAPTER 8 COMMANDS FOR LLDP FUNCTION ........................................................ 8-1
8.1 LLDP ENABLE ...................................................................................................................................... 8-1
8.2
LLDP ENABLE (PORT) ........................................................................................................................... 8-1
8.3
LLDP MODE .......................................................................................................................................... 8-2
8.4
LLDP TX-INTERVAL ............................................................................................................................... 8-2
8.5
LLDP MSGTXHOLD ............................................................................................................................... 8-3
8.6
LLDP TRANSMIT DELAY ......................................................................................................................... 8-3
8.7
LLDP NOTIFICATION INTERVAL ............................................................................................................... 8-4
8.8
LLDP TRAP .......................................................................................................................................... 8-4
8.9
LLDP TRANSMIT OPTIONAL TLV .............................................................................................................. 8-5
8.10
LLDP NEIGHBORS MAX-NUM ................................................................................................................ 8-5
8.11
LLDP TOOMANYNEIGHBORS ............................................................................................................... 8-6
8.12
SHOW LLDP ....................................................................................................................................... 8-6
8.13
SHOW LLDP TRAFFIC .......................................................................................................................... 8-7
8.14
SHOW LLDP INTERFACE ETHERNET ...................................................................................................... 8-8
8.15
SHOW LLDP NEIGHBORS INTERFACE ETHERNET ................................................................................... 8-8
8.16
SHOW DEBUGGING LLDP ..................................................................................................................... 8-9
8.17
DEBUG LLDP ...................................................................................................................................... 8-9
8.18
DEBUG LLDP PACKETS ..................................................................................................................... 8-10
1-6
XGS3 Command Guide
8.19 CLEAR LLDP REMOTE-TABLE ............................................................................................................ 8-11
CHAPTER 9 COMMANDS FOR PORT CHANNEL .......................................................9-12
9.1 DEBUG PORT-CHANNEL ...................................................................................................................... 9-12
9.2
INTERFACE PORT-CHANNEL ................................................................................................................ 9-12
9.3
LACP PORT-PRIORITY ......................................................................................................................... 9-13
9.4
LACP SYSTEM-PRIORITY ..................................................................................................................... 9-13
9.5
LOAD-BALANCE ................................................................................................................................. 9-14
9.6
PORT-GROUP ..................................................................................................................................... 9-15
9.7
PORT-GROUP MODE ........................................................................................................................... 9-15
9.8
SHOW PORT-GROUP ........................................................................................................................... 9-16
CHAPTER 10 COMMANDS FOR JUMBO ...................................................................10-18
10.1 JUMBO ENABLE ............................................................................................................................. 10-18
CHAPTER 11 VLAN CONFIGURATION ...................................................................... 11-19
11.1 COMMANDS FOR VLAN CONFIGURATION ........................................................................................ 11-19
11.1.1 debug gvrp ........................................................................................................................................ 11-19
11.1.2 dot1q-tunnel enable ........................................................................................................................... 11-19
11.1.3 dot1q-tunnel tpid ............................................................................................................................... 11-20
11.1.4 gvrp ................................................................................................................................................... 11-21
11.1.5 garp timer hold .................................................................................................................................. 11-21
11.1.6 garp timer join ................................................................................................................................... 11-22
11.1.7 garp timer leave ................................................................................................................................ 11-22
11.1.8 garp timer leaveall ............................................................................................................................. 11-23
11.1.9 name ................................................................................................................................................. 11-23
11.1.10 private-vlan ...................................................................................................................................... 11-24
11.1.11 private-vlan association ................................................................................................................... 11-25
11.1.12 show dot1q-tunnel ........................................................................................................................... 11-26
11.1.13 show garp ........................................................................................................................................ 11-26
11.1.14 show gvrp ........................................................................................................................................ 11-26
11.1.15 show vlan ........................................................................................................................................ 11-27
11.1.16 show vlan-translation ....................................................................................................................... 11-28
11.1.17 switchport access vlan .................................................................................................................... 11-29
11.1.18 switchport hybrid allowed vlan ......................................................................................................... 11-30
11.1.19 switchport hybrid native vlan ........................................................................................................... 11-31
11.1.20 switchport interface ......................................................................................................................... 11-31
11.1.21 switchport mode .............................................................................................................................. 11-32
11.1.22 switchport trunk allowed vlan .......................................................................................................... 11-33
11.1.23 switchport trunk native vlan ............................................................................................................. 11-34
1-7
XGS3 Command Guide
11.1.24 vlan .................................................................................................................................................. 11-34
11.1.25 vlan-translation ................................................................................................................................ 11-35
11.1.26 vlan-translation enable .................................................................................................................... 11-36
11.1.27 vlan-translation miss drop ............................................................................................................... 11-37
11.1.28 vlan ingress enable ......................................................................................................................... 11-38
11.2 COMMANDS FOR DYNAMIC VLAN CONFIGURATION ......................................................................... 11-39
11.2.1 dynamic-vlan mac-vlan prefer ........................................................................................................... 11-39
11.2.2 dynamic-vlan subnet-vlan prefer ....................................................................................................... 11-39
11.2.3 mac-vlan ............................................................................................................................................ 11-40
11.2.4 mac-vlan vlan .................................................................................................................................... 11-40
11.2.5 protocol-vlan ...................................................................................................................................... 11-41
11.2.6 show dynamic-vlan prefer ................................................................................................................. 11-42
11.2.7 show mac-vlan .................................................................................................................................. 11-42
11.2.8 show mac-vlan interface .................................................................................................................... 11-43
11.2.9 show protocol-vlan ............................................................................................................................ 11-43
11.2.10 show subnet-vlan ............................................................................................................................ 11-44
11.2.11 show subnet-vlan interface .............................................................................................................. 11-44
11.2.12 subnet-vlan ...................................................................................................................................... 11-45
11.2.13 switchport mac-vlan enable ............................................................................................................. 11-45
11.2.14 switchport subnet-vlan enable ......................................................................................................... 11-46
11.3 COMMANDS FOR VOICE VLAN CONFIGURATION ............................................................................. 11-47
11.3.1 show voice-vlan ................................................................................................................................. 11-47
11.3.2 switchport voice-vlan enable ............................................................................................................. 11-48
11.3.3 voice-vlan .......................................................................................................................................... 11-48
11.3.4 voice-vlan vlan .................................................................................................................................. 11-49
CHAPTER 12 COMMANDS FO R M AC ADDRESS TABLE CONFIGURATION .........12-50
12.1 COMMANDS FOR MAC ADDRESS TABLE CONFIGURATION ............................................................... 12-50
12.1.1 mac-address-table aging-time ........................................................................................................... 12-50
12.1.2 mac-address-table static|blackhole ................................................................................................... 12-50
12.1.3 show mac-address-table ................................................................................................................... 12-51
12.2 COMMANDS FOR MAC ADDRESS BINDING CONFIGURATION .............................................................. 12-52
12.2.1 clear port-security dynamic ............................................................................................................... 12-52
12.2.2 show port-security ............................................................................................................................. 12-52
12.2.3 show port-security address ............................................................................................................... 12-53
12.2.4 show port-security interface .............................................................................................................. 12-54
12.2.5 switchport port-security ..................................................................................................................... 12-56
12.2.6 switchport port-security convert ........................................................................................................ 12-56
12.2.7 switchport port-security lock .............................................................................................................. 12-56
12.2.8 switchport port-security mac-address ............................................................................................... 12-57
1-8
XGS3 Command Guide
12.2.9 switchport port-s ecu rity maximum ..................................................................................................... 12-57
12.2.10 switchport port-security timeout ...................................................................................................... 12-58
12.2.11 switchport port-security violation ..................................................................................................... 12-59
CHAPTER 13 OMMANDS FOR MSTP ........................................................................13-60
13.1 COMMANDS FOR MSTP ................................................................................................................. 13-60
13.1.1 abort .................................................................................................................................................. 13-60
13.1.2 exit .................................................................................................................................................... 13-60
13.1.3 instance vlan ..................................................................................................................................... 13-60
13.1.4 name ................................................................................................................................................. 13-61
13.1.5 revision-level ..................................................................................................................................... 13-62
13.1.6 spanning-tree .................................................................................................................................... 13-62
13.1.7 spanning-tree forward-time ............................................................................................................... 13-63
13.1.8 spanning-tree hello-time .................................................................................................................... 13-64
13.1.9 spanning-tree lin k-ty pe p2p ............................................................................................................... 13-64
13.1.10 spanning-tree maxage .................................................................................................................... 13-65
13.1.11 spanning-tree max-hop ................................................................................................................... 13-65
13.1.12 spanning-tree mcheck ..................................................................................................................... 13-66
13.1.13 spanning-tree mode ........................................................................................................................ 13-66
13.1.14 spanning-tree mst configuration ...................................................................................................... 13-67
13.1.15 spanning-tree mst cost .................................................................................................................... 13-68
13.1.16 spanning-tree mst port-priority ........................................................................................................ 13-69
13.1.17 spanning-tree mst priority ................................................................................................................ 13-70
13.1.18 spanning-tree mst rootguard ........................................................................................................... 13-71
13.1.19 spanning-tree portfast ..................................................................................................................... 13-71
13.1.20 spanning-tree priority ...................................................................................................................... 13-72
13.1.21 spanning-tree format ....................................................................................................................... 13-73
13.1.22 spanning-tree digest-snooping ........................................................................................................ 13-74
13.1.23 spanning-tree tcflush (Global mode) ............................................................................................... 13-74
13.1.24 spanning-tree tcflush (Port mode) ................................................................................................... 13-75
13.2 COMMANDS FOR MONITOR AND DEBUG .......................................................................................... 13-76
13.2.1 show spanning-tree ........................................................................................................................... 13-76
13.2.2 show spanning-tr ee mst config ......................................................................................................... 13-79
13.2.3 show mst-pending ............................................................................................................................. 13-79
13.2.4 debug spanning-tree ......................................................................................................................... 13-80
CHAPTER 14 COMMANDS FOR QOS AND PBR ......................................................14-82
14.1 CLASS ........................................................................................................................................... 14-82
14.2
CLASS-MAP ................................................................................................................................... 14-82
14.3
MATCH .......................................................................................................................................... 14-83
1-9
XGS3 Command Guide
14.4 MLS Q OS ....................................................................................................................................... 14-84
14.5
MLS QOS COS ................................................................................................................................ 14-84
14.6
MLS QOS AGGREGATE-POLICY ........................................................................................................ 14-85
14.7
MLS QOS TR U ST ............................................................................................................................. 14-86
14.7.1 mls qos dscp-mutation ...................................................................................................................... 14-87
14.7.2 mls qos map ...................................................................................................................................... 14-88
14.7.3 policy ................................................................................................................................................. 14-89
14.7.4 policy aggregate ................................................................................................................................ 14-91
14.7.5 policy-map ......................................................................................................................................... 14-91
14.8 PRIORITY-QUEUE OUT ..................................................................................................................... 14-92
14.9
QUEUE BANDWIDTH ........................................................................................................................ 14-93
14.10
SET ............................................................................................................................................. 14-94
14.11
SERVICE-POLICY .......................................................................................................................... 14-94
14.12
SHOW CLASS-MAP ....................................................................................................................... 14-95
14.13
SHOW POLICY-MAP ....................................................................................................................... 14-96
14.14
SHOW MLS QOS AGGREGATE-POLICY ............................................................................................ 14-97
14.15
SHOW MLS QOS INTERFACE .......................................................................................................... 14-97
14.16
SHOW MLS QOS MAPS ................................................................................................................ 14-101
14.17
SHOW MLS-QOS ......................................................................................................................... 14-101
14.18
WRR-QUEUE BANDWIDTH ........................................................................................................... 14-102
14.19
WRR-QUEUE COS-MAP ............................................................................................................... 14-103
CHAPTER 15 COMMANDS FOR IPV6 PBR ............................................................. 15-104
15.1 CLASS ......................................................................................................................................... 15-104
15.2
CLASS-MAP ................................................................................................................................. 15-104
15.3
MLS QOS ..................................................................................................................................... 15-105
15.4
MATCH IPV6 ACCESS-GROUP ........................................................................................................ 15-105
15.5
POLICY-MAP ................................................................................................................................ 15-106
15.6
SET ............................................................................................................................................. 15-106
15.7
SERVICE-POLICY .......................................................................................................................... 15-107
CHAPTER 16 COMMANDS FOR FLOW-BASED REDIRECTI ON ................................16-1
16.1 ACCESS-GROUP REDIRECT TO INTERFACE ETHERNET ......................................................................... 16-1
16.2
SHOW FLOW-BASED-REDIRECT ......................................................................................................... 16-1
CHAPTER 17 COMMANDS FOR LAYER 3 FORWARDING .........................................17-3
17.1 COMMANDS FOR LAYE R 3 INTERFACE ............................................................................................... 17-3
17.1.1 bandwidth ............................................................................................................................................ 17-3
17.1.2 shutdown ............................................................................................................................................. 17-3
17.1.3 interface vlan ....................................................................................................................................... 17-4
1-10
XGS3 Command Guide
17.1.4 interface loopback ............................................................................................................................... 17-4
17.2 COMMANDS FOR IPV4/V6 CONFIGURATION ........................................................................................ 17-5
17.2.1 clear ipv6 neighbor .............................................................................................................................. 17-5
17.2.2 debug ip packet ................................................................................................................................... 17-5
17.2.3 debug ipv6 packet ............................................................................................................................... 17-6
17.2.4 debug ipv6 icmp .................................................................................................................................. 17-7
17.2.5 debug ipv6 nd ..................................................................................................................................... 17-8
17.2.6 debug ipv6 tunnel packet .................................................................................................................... 17-9
17.2.7 ipv6 enable .......................................................................................................................................... 17-9
17.2.8 ipv6 proxy enable .............................................................................................................................. 17-10
17.2.9 ip address ......................................................................................................................................... 17-11
17.2.10 ipv6 address .................................................................................................................................... 17-11
17.2.11 ipv6 route ........................................................................................................................................ 17-12
17.2.12 ipv6 redirect .................................................................................................................................... 17-13
17.2.13 ipv6 nd dad attempts ....................................................................................................................... 17-14
17.2.14 ipv6 nd ns-interval ........................................................................................................................... 17-14
17.2.15 ipv6 nd suppress-ra ........................................................................................................................ 17-15
17.2.16 ipv6 nd ra-lifetime ............................................................................................................................ 17-15
17.2.17 ipv6 nd min-ra-interval ..................................................................................................................... 17-16
17.2.18 ipv6 nd max-ra-interval .................................................................................................................... 17-16
17.2.19 ipv6 nd prefix ................................................................................................................................... 17-17
17.2.20 ipv6 nd ra-hoplimit ........................................................................................................................... 17-18
17.2.21 ipv6 nd ra-mtu ................................................................................................................................. 17-18
17.2.22 ipv6 nd reachable-time .................................................................................................................... 17-19
17.2.23 ipv6 nd retrans-timer ....................................................................................................................... 17-19
17.2.24 ipv6 nd other-config-flag .................................................................................................................. 17-19
17.2.25 ipv6 nd managed-config-flag ........................................................................................................... 17-20
17.2.26 ipv6 neighbor .................................................................................................................................. 17-20
17.2.27 ipv6 rthdr-type0 enable ................................................................................................................... 17-21
17.2.28 interface tunnel ............................................................................................................................... 17-21
17.2.29 show ip traffic .................................................................................................................................. 17-22
17.2.30 show ipv6 interface ......................................................................................................................... 17-24
17.2.31 show ipv6 route ............................................................................................................................... 17-26
17.2.32 show ipv6 neighbors ....................................................................................................................... 17-27
17.2.33 show ipv6 traffic .............................................................................................................................. 17-29
17.2.34 show ipv6 enable ............................................................................................................................ 17-30
17.2.35 show ipv6 redirect ........................................................................................................................... 17-31
17.2.36 show ipv6 tunnel ............................................................................................................................. 17-31
17.2.37 description ....................................................................................................................................... 17-32
1-11
XGS3 Command Guide
17.2.38 tunnel sourc e .................................................................................................................................. 17-32
17.2.39 tunnel destination ............................................................................................................................ 17-33
17.2.40 tunnel nexthop ................................................................................................................................ 17-34
17.2.41 tunnel 6to4-relay ............................................................................................................................. 17-34
17.2.42 tunnel mode .................................................................................................................................... 17-35
17.3 COMMANDS FOR IP ROUTE AGGREGATION ..................................................................................... 17-36
17.3.1 ip fib optimize .................................................................................................................................... 17-36
17.4 COMMANDS FOR URPF ................................................................................................................. 17-36
17.4.1 debug l4driver urpf ............................................................................................................................ 17-36
17.4.2 ip urpf enable .................................................................................................................................... 17-37
17.4.3 show urpf rule ipv4 num .................................................................................................................... 17-38
17.4.4 show urpf rule ipv6 num .................................................................................................................... 17-38
17.4.5 show urpf rule ipv4 ............................................................................................................................ 17-38
17.4.6 show urpf rule ipv6 ............................................................................................................................ 17-39
17.4.7 show urpf .......................................................................................................................................... 17-39
17.4.8 urpf enable ........................................................................................................................................ 17-39
17.5 COMMANDS FOR ARP CONFIGURATION .......................................................................................... 17-40
17.5.1 arp ..................................................................................................................................................... 17-40
17.5.2 clear arp-cache ................................................................................................................................. 17-41
17.5.3 clear arp traffic .................................................................................................................................. 17-41
17.5.4 debug arp .......................................................................................................................................... 17-41
17.5.5 ip proxy-arp ....................................................................................................................................... 17-42
17.5.6 l3 hashselect ..................................................................................................................................... 17-43
17.5.7 show arp ........................................................................................................................................... 17-43
17.5.8 show arp traffic .................................................................................................................................. 17-45
CHAPTER 18 COMMANDS FOR ARP SCANNING PREVENTION ..............................18-1
18.1 ANTI-AR PSCAN ENABLE .................................................................................................................... 18-1
18.2
ANTI-ARPSCAN PORT-BASED THRESHOLD .......................................................................................... 18-1
18.3
ANTI-ARPSCAN IP-B ASED THRES HO L D ............................................................................................... 18-2
18.4
ANTI-ARPSCAN TRUST ...................................................................................................................... 18-2
18.5
ANTI-ARPSCAN TRUST IP .................................................................................................................. 18-3
18.6
ANTI-ARPSCAN RECOVERY ENABLE ................................................................................................... 18-4
18.7
ANTI-ARPSCAN RECOVERY TIME ........................................................................................................ 18-4
18.8
ANTI-ARPSCAN LOG ENA BLE ............................................................................................................. 18-5
18.9
ANTI-ARPSCAN TRAP ENABLE ........................................................................................................... 18-5
18.10
SHOW ANTI-ARPSCAN ..................................................................................................................... 18-6
18.11
DEBUG ANTI-ARPSCAN ................................................................................................................... 18-7
CHAPTER 19 COMMANDS FOR PREVENTING ARP, ND SPOOFING .......................19-8
1-12
XGS3 Command Guide
19.1 IP ARP-SECURITY UPDATEPROTECT ................................................................................................... 19-8
19.2
IPV6 ND-SECURITY UPDATEPROTECT ................................................................................................. 19-9
19.3
IP ARP-SECURITY LEARNPROTECT ..................................................................................................... 19-9
19.4
IPV6 ND-SECURITY LEARNPROTECT ................................................................................................ 19-10
19.5
IP ARP-SECURITY CONVERT ............................................................................................................ 19-10
19.6
IPV6 ND-SECURITY CONVERT .......................................................................................................... 19-11
19.7
CLEAR IP ARP DYNAMIC .................................................................................................................. 19-11
19.8
CLEAR IPV6 ND DYNAMIC ................................................................................................................ 19-11
CHAPTER 20 COMMAND FOR ARP GUARD ............................................................20-13
20.1 ARP-GUARD IP ............................................................................................................................... 20-13
CHAPTER 21 COMMAND FOR ARP LOCAL PROXY ................................................21-14
21.1 IP LOCAL PROXY-ARP ..................................................................................................................... 21-14
CHAPTER 22 COMMANDS FOR GRATUITOUS ARP CONFIGURA TION .................22-15
22.1 IP GRATUITOUS-ARP ....................................................................................................................... 22-15
22.2
SHOW IP GRATUITOUS-ARP ............................................................................................................. 22-15
CHAPTER 23 COMMANDS FOR ND SNOOPING ......................................................23-17
23.1 CLEAR IPV6 ND SNOOPING BINDING ................................................................................................. 23-17
23.2
DEBUG IPV6 ND SNOOPING ............................................................................................................. 23-17
23.3
IPV6 ND SNOOPING ENABLE (GLOBAL MODE) .................................................................................. 23-18
23.4
IPV6 ND SNOOPING MAC-BINDING-LIMIT ........................................................................................... 23-18
23.5
IPV6 ND SNOOPING MAX-DAD-DE LAY ............................................................................................... 23-19
23.6
IPV6 ND SNOOPING MAX-DAD-PREPARE-DELAY ................................................................................ 23-19
23.7
IPV6 ND SNOOPING MAX-SAC-LIFETIME ............................................................................................ 23-20
23.8
IPV6 ND SNOOPING POLICY ............................................................................................................. 23-21
23.9
IPV6 ND SNOOPING PORT-BINDING-LIMIT .......................................................................................... 23-21
23.10
IPV6 ND SNOOPING STATIC-BINDING .............................................................................................. 23-22
23.11
IPV6 ND SNOOPING TRUST ............................................................................................................ 23-23
23.12
IPV6 ND SNOOPING USER-CONTROL .............................................................................................. 23-23
23.13
SHOW IPV6 ND SNOOPING ............................................................................................................. 23-24
23.14
SHOW IPV6 ND SNOOPING MAC-BINDING ........................................................................................ 23-24
CHAPTER 24 COMMANDS FOR DHCP .....................................................................24-26
24.1 COMMANDS FOR DHCP SERVER CONFIGURATION .......................................................................... 24-26
24.1.1 bootfile .............................................................................................................................................. 24-26
24.1.2 clear ip dhcp binding ......................................................................................................................... 24-26
24.1.3 clear ip dhcp conflict ......................................................................................................................... 24-27
24.1.4 clear ip dhcp server statisti cs ............................................................................................................ 24-27
1-13
XGS3 Command Guide
24.1.5 client-identifier ................................................................................................................................... 24-28
24.1.6 client-name ....................................................................................................................................... 24-28
24.1.7 debug ip dhcp server ........................................................................................................................ 24-29
24.1.8 default-router ..................................................................................................................................... 24-29
24.1.9 dns-server ......................................................................................................................................... 24-30
24.1.10 domain-name .................................................................................................................................. 24-30
24.1.11 hardware-address ........................................................................................................................... 24-31
24.1.12 host ................................................................................................................................................. 24-31
24.1.13 ip dhcp conflict logging .................................................................................................................... 24-32
24.1.14 ip dhcp excluded-address ............................................................................................................... 24-33
24.1.15 ip dhcp pool ..................................................................................................................................... 24-33
24.1.16 ip dhcp conflict ping-detection enable ............................................................................................. 24-34
24.1.17 ip dhcp ping packets ....................................................................................................................... 24-34
24.1.18 ip dhcp ping timeout ........................................................................................................................ 24-35
24.1.19 lease ............................................................................................................................................... 24-35
24.1.20 netbios-name-server ....................................................................................................................... 24-36
24.1.21 netbios-node-type ........................................................................................................................... 24-37
24.1.22 network-address ............................................................................................................................. 24-38
24.1.23 next-server ...................................................................................................................................... 24-38
24.1.24 option .............................................................................................................................................. 24-39
24.1.25 service dhcp .................................................................................................................................... 24-39
24.1.26 show ip dhcp binding ...................................................................................................................... 24-40
24.1.27 show ip dhcp conflict ....................................................................................................................... 24-41
24.1.28 show ip dhcp server statist ic s ......................................................................................................... 24-41
24.2 COMMANDS FOR DHCP REL AY CONFIGURATION ............................................................................ 24-44
24.2.1 ip forward-protocol udp bootps .......................................................................................................... 24-44
24.2.2 ip helper-address .............................................................................................................................. 24-44
CHAPTER 25 COMMANDS FOR DHCPV6 .................................................................25-45
25.1 CLEAR IPV6 DHCP BINDING ............................................................................................................. 25-45
25.2
CLEAR IPV6 DHCP SERVER STATISTICS ............................................................................................ 25-45
25.3
DEBUG IPV6 DHCP CLIENT PACKET .................................................................................................. 25-46
25.4
DEBUG IPV6 DHCP DETAIL ............................................................................................................... 25-46
25.5
DEBUG IPV6 DHCP RELAY PACKET ................................................................................................... 25-46
25.6
DEBUG IPV6 DHCP SERVER ............................................................................................................. 25-47
25.7
DNS-SERVER ................................................................................................................................. 25-47
25.8
DOMAIN-NAME ............................................................................................................................... 25-48
25.9
EXCLUDED-ADDRESS ..................................................................................................................... 25-48
25.10
IPV6 ADDRESS ............................................................................................................................. 25-49
25.11 IPV6 DHCP CLIENT PD ................................................................................................................... 25-49
1-14
XGS3 Command Guide
25.12 IPV6 DHCP CLIENT PD HINT ........................................................................................................... 25-50
25.13
IPV6 DHCP POOL .......................................................................................................................... 25-51
25.14
IPV6 DHCP RELAY DESTINATION .................................................................................................... 25-51
25.15
IPV6 DHCP SERVER ...................................................................................................................... 25-52
25.16
IPV6 GENERAL-PREFIX ................................................................................................................. 25-52
25.17
IPV6 LOCAL POOL ........................................................................................................................ 25-53
25.18
LIFETIME ..................................................................................................................................... 25-54
25.19
NETWORK-ADDRESS .................................................................................................................... 25-54
25.20
PREFIX-DELEGATION .................................................................................................................... 25-55
25.21
PREFIX-DELEGATION POOL ........................................................................................................... 25-56
25.22
SERVICE DHCPV6 ......................................................................................................................... 25-56
25.23
SHOW IPV6 DHCP ......................................................................................................................... 25-57
25.24
SHOW IPV6 DHCP BINDING ............................................................................................................ 25-57
25.25
SHOW IPV6 DHCP INTERFACE ........................................................................................................ 25-58
25.26
SHOW IPV6 DHCP LOCAL POOL ..................................................................................................... 25-58
25.27
SHOW IPV6 DHCP POOL ................................................................................................................ 25-59
25.28
SHOW IPV6 DHCP STATISTICS ........................................................................................................ 25-59
25.29
SHOW IPV6 GENERAL-PREFIX ....................................................................................................... 25-62
CHAPTER 26 COMMANDS FOR DHCP OPTION 82 ..................................................26-64
26.1 IP DHCP RELAY INFORMATION OPTION .............................................................................................. 26-64
26.2
IP DHCP RELAY INFORMATION POLICY .............................................................................................. 26-64
26.3
IP DHCP RELAY INFORMATION OPTION SUBSCRIBER-ID ...................................................................... 26-65
26.4
IP DHCP SERVER RELAY INFORMATION ENABLE ................................................................................ 26-66
26.5
SHOW IP DHCP RELAY INFORMATION OPTION .................................................................................... 26-66
26.6
DEBUG IP DHCP RELAY PACKET ....................................................................................................... 26-67
CHAPTER 27 COMMANDS FOR DHCP SNOOPING .................................................27-68
27.1 DEBUG IP DHCP SNOOPING PACKET INTERFACE ................................................................................ 27-68
27.2
DEBUG IP DHCP SNOOPING PACKET ................................................................................................. 27-68
27.3
DEBUG IP DHCP SNOOPING UPDATE ................................................................................................. 27-68
27.4
DEBUG IP DHCP SNOOPING EVENT ................................................................................................... 27-69
27.5
DEBUG IP DHCP SNOOPING BINDING ................................................................................................ 27-69
27.6
IP DHCP SNOOPING ......................................................................................................................... 27-69
27.7
IP DHCP SNOOPING BINDING ........................................................................................................... 27-70
27.8
IP DHCP SNOOPING BINDING USER ................................................................................................... 27-70
27.9
IP DHCP SNOOPING BINDING ARP ..................................................................................................... 27-71
27.10
IP DHCP SNOOPING BINDING DOT1X ............................................................................................... 27-72
27.11
IP DHCP SNOOPING BINDING USER-CONTROL ................................................................................. 27-72
27.12
IP DHCP SNOOPING BINDING USER-CONTROL MAX-USER ................................................................. 27-73
1-15
XGS3 Command Guide
27.13 IP DHCP SNOOPING TRUST ............................................................................................................ 27-74
27.14
IP DHCP SNOOPING ACTION ........................................................................................................... 27-74
27.15
IP DHCP SNOOPING ACTION MAXNUM ............................................................................................ 27-75
27.16
IP DHCP SNOOPING LIMIT-RATE ..................................................................................................... 27-75
27.17
IP DHCP SNOOPING INFORMATION ENABLE ..................................................................................... 27-76
27.18
IP DHCP SNOOPING OPTION82 ENABLE .......................................................................................... 27-77
27.19
ENABLE TRUSTVIEW KEY .............................................................................................................. 27-77
27.20
IP USER HELPER-ADDRESS ........................................................................................................... 27-78
27.21
SHOW TRUSTVIEW STATUS ............................................................................................................ 27-79
27.22
SHOW IP DHCP SNOOPING ............................................................................................................. 27-80
CHAPTER 28 COMMANDS FOR DHCPV6 SNOOPING .............................................28-84
28.1 CLEAR IPV6 DHCP SNOOPING BINDING ............................................................................................. 28-84
28.2
DEBUG IPV6 DHCP SNOOPING BINDING ............................................................................................ 28-84
28.3
DEBUG IPV6 DHCP SNOOPING EVENT ............................................................................................... 28-85
28.4
DEBUG IPV6 DHCP SNOOPING PACKET ............................................................................................. 28-85
28.5
IPV6 DHCP SNOOPING ACTION ......................................................................................................... 28-87
28.6
IPV6 DHCP SNOOPING ACTION MAXNUM .......................................................................................... 28-87
28.7
IPV6 DHCP SNOOPING BINDING ENABLE ........................................................................................... 28-88
28.8
IPV6 DHCP SNOOPING BINDING ND .................................................................................................. 28-89
28.9
IPV6 DHCP SNOOPING BINDING USER ............................................................................................... 28-89
28.10
IPV6 DHCP SNOOPING BINDING USER-CONTROL ............................................................................. 28-90
28.11
IPV6 DHCP SNOOPING BINDING-LIMIT ............................................................................................. 28-90
28.12
IPV6 DHCP SNOOPING ENABLE ...................................................................................................... 28-91
28.13
IP DHCP SNOOPING TRUST ............................................................................................................ 28-92
28.14
SHOW IPV6 DHCP SNOOPING ......................................................................................................... 28-92
28.15
SHOW IPV6 DHCP SNOOPING BINDING ............................................................................................ 28-94
28.16
SHOW IPV6 DHCP SNOOPING INTERFACE ....................................................................................... 28-94
CHAPTER 29 COMMANDS FOR ROUTING POLICY .................................................29-96
29.1 IP PREFIX-LIST DESCRIPTION ........................................................................................................... 29-96
29.2
IP PREFIX-LIST SEQ ........................................................................................................................ 29-96
29.3
IP PREFIX-LIST SEQUENCE-NUMBER ................................................................................................ 29-97
29.4
MATCH AS-PATH ............................................................................................................................. 29-98
29.5
MATCH COMMUNITY ........................................................................................................................ 29-98
29.6
MATCH INTERFACE ......................................................................................................................... 29-99
29.7
MATCH IP ....................................................................................................................................... 29-99
29.8
MATCH IPV6 ADDRESS .................................................................................................................. 29-100
29.9
MATCH IPV6 NEXT-HOP ................................................................................................................. 29-100
29.10
MATCH METRIC .......................................................................................................................... 29-101
1-16
XGS3 Command Guide
29.11 MATCH ORIGIN ........................................................................................................................... 29-102
29.12
MATCH ROUTE-TYPE ................................................................................................................... 29-102
29.13
MATCH TAG ................................................................................................................................ 29-103
29.14
ROUTE-MAP ............................................................................................................................... 29-103
29.15
SET AGGREGATOR ..................................................................................................................... 29-104
29.16
SET AS-PATH .............................................................................................................................. 29-105
29.17
SET ATOMIC -AGGREGATE ........................................................................................................... 29-105
29.18
SET COMM-LIST ......................................................................................................................... 29-106
29.19
SET COMMUNITY ........................................................................................................................ 29-106
29.20
SET EXTCOMMUNITY ................................................................................................................... 29-107
29.21
SET IP NEXT-HOP ........................................................................................................................ 29-107
29.22
SET LOCAL-PREFERENCE ........................................................................................................... 29-108
29.23
SET METRIC ............................................................................................................................... 29-108
29.24
SET METRIC-TYPE ...................................................................................................................... 29-109
29.25
SET ORIGIN ................................................................................................................................ 29-109
29.26
SET ORIGINATOR-ID .................................................................................................................... 29-110
29.27
SET TAG .................................................................................................................................... 29-110
29.28
SET VPNV4 NEXT-HOP ................................................................................................................ 29-111
29.29
SET WEIGHT ............................................................................................................................... 29-111
29.30
SHOW IP PREFIX-LIST <LIST-NAME> ............................................................................................ 29-112
29.31
SHOW IP PREFIX-LIST<DETAIL|SUMMARY> ................................................................................... 29-113
29.32
SHOW ROUTE-MAP ..................................................................................................................... 29-114
29.33
SHOW ROUTER-ID ...................................................................................................................... 29-115
CHAPTER 30 COMMANDS FOR STATIC ROUTE .................................................... 30-116
30.1 IP ROUTE ..................................................................................................................................... 30-116
30.2
SHOW IP ROUTE ........................................................................................................................... 30-117
30.3
SHOW IP ROUTE VRF ..................................................................................................................... 30-119
30.4
IP ROUTE VRF .............................................................................................................................. 30-119
CHAPTER 31 COMMANDS FOR RIP ........................................................................ 31-120
31.1 ACCEPT-LIFETIME ......................................................................................................................... 31-120
31.2
ADDRESS-FAMILY IPV4 .................................................................................................................. 31-121
31.3
CLEAR IP RIP ROUTE ..................................................................................................................... 31-121
31.4
DEBUG RIP ................................................................................................................................... 31-122
31.5
DEBUG RIP REDISTRIBUTE MESSAGE SEND .................................................................................... 31-123
31.6
DEBUG RIP REDISTRIBUTE ROUTE RECEIVE .................................................................................... 31-123
31.7
DEFAULT-INFORMATION ORIGINATE ................................................................................................ 31-124
31.8
DEFAULT-METRIC ......................................................................................................................... 31-124
31.9
DISTANCE .................................................................................................................................... 31-125
1-17
XGS3 Command Guide
31.10 DISTRIBUTE-LIST ........................................................................................................................ 31-125
31.11
EXIT-ADDRESS-FAMILY ................................................................................................................ 31-126
31.12
IP RIP AGGREGATE-ADDRESS ...................................................................................................... 31-126
31.13
IP RIP AUTHENTICA T ION KEY-CHAIN ............................................................................................. 31-127
31.14
IP RIP AUTHENTICA T ION MODE ..................................................................................................... 31-128
31.15
IP RIP AUTHENTICA T ION STRING .................................................................................................. 31-128
31.16
IP RIP AUTHENTICA T ION CISCO-COMPATIBLE ................................................................................ 31-129
31.17
IP RIP RECEIVE-PACKET .............................................................................................................. 31-130
31.18
IP RIP RECEIVE VERSION ............................................................................................................. 31-130
31.19
IP RIP SEND-PACKET ................................................................................................................... 31-131
31.20
IP RIP SEND VERSION .................................................................................................................. 31-131
31.21
IP RIP SPLIT-HORIZON ................................................................................................................. 31-132
31.22
KEY ........................................................................................................................................... 31-132
31.23
KEY CHAIN ................................................................................................................................. 31-133
31.24
KEY-STRING ............................................................................................................................... 31-134
31.25
MAXIMUM-PREFIX ....................................................................................................................... 31-134
31.26
NEIGHBOR ................................................................................................................................. 31-135
31.27
NETWORK .................................................................................................................................. 31-135
31.28
OFFSET-LIST .............................................................................................................................. 31-136
31.29 PASSIVE-INTERFACE ................................................................................................................... 31-137
31.30
RECV-BUFFER-SIZE .................................................................................................................... 31-137
31.31
REDISTRIBUTE ........................................................................................................................... 31-138
31.32
ROUTE ...................................................................................................................................... 31-139
31.33
ROUTER RIP ............................................................................................................................... 31-139
31.34
SEND-LIFETIME .......................................................................................................................... 31-140
31.35
SHOW DEBUGGING RIP ............................................................................................................... 31-141
31.36
SHOW IP PROTOCOLS RIP ........................................................................................................... 31-141
31.37
SHOW IP RIP .............................................................................................................................. 31-143
31.38
SHOW I P RIP DATABASE .............................................................................................................. 31-143
31.39
SHOW IP RIP INTERFACE ............................................................................................................. 31-143
31.40
SHOW IP RIP AGGREGATE ........................................................................................................... 31-144
31.41
TIMERS BASIC ............................................................................................................................ 31-145
31.42
VERSION .................................................................................................................................... 31-146
CHAPTER 32 COMMANDS FOR RIPNG .................................................................. 32-147
32.1 CLEAR IPV6 ROUTE ...................................................................................................................... 32-147
32.2
DEFAULT-INFORMATION ORIGINATE ................................................................................................ 32-147
32.3
DEFAULT-METRIC ......................................................................................................................... 32-148
32.4
DISTANCE .................................................................................................................................... 32-148
32.5
DISTRIBUTE-LIST .......................................................................................................................... 32-149
1-18
XGS3 Command Guide
32.6 DEBUG IPV6 RIP ........................................................................................................................... 32-150
32.7
DEBUG IPV6 RIP REDISTRIBUTE MESSAGE SEND ............................................................................. 32-150
32.8
DEBUG IPV6 RIP REDISTRIBUTE ROUTE REC EIVE ............................................................................ 32-151
32.9
IPV6 RIP AGGREGATE-ADDRESS .................................................................................................... 32-151
32.10
IPV6 RIP SPLIT-HORIZON ............................................................................................................. 32-152
32.11
IPV6 ROUTER RIP ....................................................................................................................... 32-153
32.12
NEIGHBOR ................................................................................................................................. 32-153
32.13
OFFSET-LIST .............................................................................................................................. 32-154
32.14
PASSIVE-INTERFACE ................................................................................................................... 32-154
32.15
REDISTRIBUTE ........................................................................................................................... 32-155
32.16
REDISTRIBUTE OSPF .................................................................................................................. 32-156
32.17
ROUTE ...................................................................................................................................... 32-156
32.18
ROUTER IPV6 RIP ....................................................................................................................... 32-157
32.19
SHOW DEBUGGING IPV6 RIP ........................................................................................................ 32-157
32.20
SHOW IPV6 RIP INTERFACE ......................................................................................................... 32-158
32.21
SHOW IPV6 RIP REDISTRIBUTE .................................................................................................... 32-159
32.22
SHOW IPV6 PROTOCOLS RIP ....................................................................................................... 32-159
32.23
SHOW IPV6 RIP .......................................................................................................................... 32-160
32.24 SHOW I P V6 RIP DATABASE .......................................................................................................... 32-161
32.25
SHOW IPV6 RIP AGGREGATE ....................................................................................................... 32-161
32.26
SHOW IPV6 RIP REDISTRIBUTE .................................................................................................... 32-162
32.27
TIMERS BASIC ............................................................................................................................ 32-163
CHAPTER 33 COMMANDS FOR OSPF .................................................................... 33-164
33.1 AREA AUTHENTICATION ................................................................................................................ 33-164
33.2
AREA DEFAULT-COST .................................................................................................................... 33-164
33.3
AREA FILTER-LIST ........................................................................................................................ 33-165
33.4
AREA NSSA .................................................................................................................................. 33-165
33.5
AREA RANGE ............................................................................................................................... 33-166
33.6
AREA ST UB .................................................................................................................................. 33-167
33.7
AREA VIRTUAL-LINK ..................................................................................................................... 33-168
33.8
AUTO-COST REFERENCE-BANDWIDTH ............................................................................................ 33-169
33.9
COMPATIBLE RFC1583 ................................................................................................................. 33-169
33.10
CLEAR IP OSPF PROCESS ........................................................................................................... 33-170
33.11
DEBUG OSPF EVENTS ................................................................................................................. 33-170
33.12
DEBUG OSPF IFSM ...................................................................................................................... 33-171
33.13
DEBUG OSPF LSA ....................................................................................................................... 33-171
33.14
DEBUG OSPF NFSM .................................................................................................................... 33-171
33.15
DEBUG OSPF NSM ...................................................................................................................... 33-172
33.16 DEBUG OSPF PACKET ................................................................................................................. 33-172
1-19
XGS3 Command Guide
33.17 DEBUG OSPF ROUTE .................................................................................................................. 33-172
33.18
DEBUG OSPF REDISTRIBUTE MESSAGE SEND ............................................................................... 33-173
33.19
DEBUG OSPF REDISTRIBUTE ROUTE RECEIVE ............................................................................... 33-173
33.20
DEFAULT-INFORMATION ORIGINATE ............................................................................................. 33-174
33.21
DEFAULT-METRIC ....................................................................................................................... 33-174
33.22
DISTANCE .................................................................................................................................. 33-175
33.23
DISTRIBUTE-LIST ........................................................................................................................ 33-176
33.24
HOST AREA ................................................................................................................................ 33-177
33.25
IP OSPF AUTHENTICATION ........................................................................................................... 33-177
33.26
IP OSPF AUTHENTICATION-KEY .................................................................................................... 33-178
33.27
IP OSPF COST ............................................................................................................................ 33-178
33.28
IP OSPF DATABASE-FILTER .......................................................................................................... 33-179
33.29
IP OS PF DEAD-INTERVAL ............................................................................................................. 33-179
33.30
IP OS PF DISABL E AL L ................................................................................................................. 33-180
33.31
IP OSPF HELLO-INTERVAL ........................................................................................................... 33-180
33.32
IP OSPF MESSAGE-DIGEST-KEY ................................................................................................... 33-181
33.33
IP OSPF MTU .............................................................................................................................. 33-182
33.34
IP OSPF MTU-IGNORE ................................................................................................................. 33-182
33.35
IP OSPF NETWORK ..................................................................................................................... 33-183
33.36
IP OSPF PRIORITY ....................................................................................................................... 33-183
33.37
IP OSPF RETRANSMIT-INTERVAL .................................................................................................. 33-184
33.38
IP OSPF TRANSMIT-DELAY ........................................................................................................... 33-185
33.39
KEY ........................................................................................................................................... 33-185
33.40
KEY CHAIN ................................................................................................................................. 33-186
33.41
LOG-ADJACENCY-CHANGES DETAIL ............................................................................................ 33-186
33.42
MAX-CONCURRENT-DD ............................................................................................................... 33-187
33.43
NEIGHBOR ................................................................................................................................. 33-188
33.44
NETWORK AREA ......................................................................................................................... 33-188
33.45
OSPF AB R -TYPE ......................................................................................................................... 33-189
33.46
OSPF ROUTER-ID ........................................................................................................................ 33-190
33.47
OVERFLOW DATABASE ............................................................................................................... 33-190
33.48
OVERFLOW DATABASE EXTERNAL ............................................................................................... 33-191
33.49
PASSIVE-INTERFACE ................................................................................................................... 33-191
33.50
REDISTRIBUTE ........................................................................................................................... 33-192
33.51
REDISTRIBUTE OSPF .................................................................................................................. 33-193
33.52
ROUTER OSPF ............................................................................................................................ 33-193
33.53
SHOW IP OSPF ........................................................................................................................... 33-194
33.54
SHOW IP OSPF BORDER-ROUTERS ............................................................................................... 33-195
33.55
SHOW IP OSPF DATABASE ........................................................................................................... 33-195
1-20
XGS3 Command Guide
33.56 SHOW IP OSPF INTERFACE .......................................................................................................... 33-197
33.57
SHOW IP OSPF NEIGHBOR ........................................................................................................... 33-197
33.58
SHOW IP OSPF REDISTRIBUTE ..................................................................................................... 33-198
33.59
SHOW IP OSPF ROUTE ................................................................................................................ 33-199
33.60
SHOW IP OSP F VIRTUAL-LINKS .................................................................................................... 33-200
33.61
SHOW IP ROUTE PROCESS-DETAIL ............................................................................................... 33-200
33.62
SHOW IP PROTOCOLS ................................................................................................................. 33-201
33.63
SUMMARY-ADDRESS ................................................................................................................... 33-202
33.64
TIMERS SPF ............................................................................................................................... 33-203
CHAPTER 34 COMMANDS FOR OSPFV3 ............................................................... 34-204
34.1 AREA DEFAULT COST .................................................................................................................... 34-204
34.2
AREA RANGE ............................................................................................................................... 34-204
34.3
AREA STUB .................................................................................................................................. 34-205
34.4
AREA VIRTUAL-LINK ..................................................................................................................... 34-205
34.5
ABR-TYPE .................................................................................................................................... 34-206
34.6
DEFAULT-METRIC ......................................................................................................................... 34-207
34.7
DEBUG IPV6 OSPF EVENTS ............................................................................................................ 34-208
34.8
DEBUG IPV6 OSPF IFSM ................................................................................................................ 34-208
34.9
DEBUG IPV6 OSPF LSA ................................................................................................................. 34-208
34.10
DEBUG IPV6 OSPF NFSM ............................................................................................................. 34-209
34.11
DEBUG IPV6 OSPF NSM ............................................................................................................... 34-209
34.12
DEBUG IPV6 OSPF PACKET ......................................................................................................... 34-209
34.13
DEBUG IPV6 OSPF REDISTRIBUTE MESSAGE SEND ........................................................................ 34-209
34.14
DEBUG IPV6 OSPF REDISTRIBUTE ROUTE RECE IVE ....................................................................... 34-210
34.15
DEBUG IPV6 OSP F ROUTE ........................................................................................................... 34-210
34.16
IPV6 OSPF COST ........................................................................................................................ 34-210
34.17
IPV6 OSPF DEAD-INTERVAL ......................................................................................................... 34-211
34.18
IPV6 OSPF DISPLAY ROUTE SINGLE-LINE ...................................................................................... 34-211
34.19
IPV6 OSPF HELLO-INTERVAL ....................................................................................................... 34-212
34.20
IPV6 OSPF PRIORITY ................................................................................................................... 34-212
34.21
IPV6 OSPF RETRANSMIT-INTERVAL .............................................................................................. 34-213
34.22
IPV6 OSPF TRANSMIT-DELAY ....................................................................................................... 34-213
34.23
IPV6 ROUTER OSPF .................................................................................................................... 34-214
34.24
MAX-CONCURRENT-DD ............................................................................................................... 34-215
34.25
PASSIVE-INTERFACE ................................................................................................................... 34-215
34.26
REDISTRIBUTE ........................................................................................................................... 34-215
34.27
REDISTRIBUTE OSPF .................................................................................................................. 34-216
34.28
ROUTER-ID ................................................................................................................................ 34-217
34.29
ROUTER IPV6 OSPF .................................................................................................................... 34-217
1-21
XGS3 Command Guide
34.30 SHOW I P V6 OSPF ....................................................................................................................... 34-217
34.31
SHOW IPV6 OSPF DATABASE ....................................................................................................... 34-218
34.32
SHOW IPV6 OSPF INTERFACE ...................................................................................................... 34-219
34.33
SHOW IPV6 OSPF NEIGHBOR ....................................................................................................... 34-222
34.34
SHOW IPV6 OSPF ROU TE ............................................................................................................ 34-222
34.35
SHOW IPV6 OSPF REDISTRIBUTE ................................................................................................. 34-223
34.36
SHOW IPV6 OSPF TOPOLOGY ...................................................................................................... 34-224
34.37
SHOW IPV6 OSPF VIR TUAL-LINKS ................................................................................................ 34-224
34.38
SHOW IPV6 ROUTE PROCESS-DETAIL ........................................................................................... 34-225
34.39
TIMERS SPF ............................................................................................................................... 34-225
CHAPTER 35 COMMANDS FOR BGP AND MBGP4+ ............................................. 35-226
35.1 ADDRESS-FAMILY ......................................................................................................................... 35-226
35.2
ADDRESS-FA MILY IPV4 .................................................................................................................. 35-226
35.3
ADDRESS-FA MILY VPNV4 .............................................................................................................. 35-227
35.4
AGGREGATE-ADDRESS ................................................................................................................. 35-227
35.5
BGP AGGREGATE-NEXTHOP-CHECK .............................................................................................. 35-228
35.6
BGP ALWAYS-COMPARE-MED ........................................................................................................ 35-228
35.7
BGP BESTPATH AS-PATH IGNORE ................................................................................................... 35-229
35.8 BGP BESTPATH COMPARE-CONFED-ASPATH ................................................................................... 35-229
35.9
BGP BESTPATH COMPARE-ROUTERID ............................................................................................. 35-230
35.10
BGP BESTPATH MED ................................................................................................................... 35-230
35.11
BGP CLIENT-TO-CLIENT REFLECTION ........................................................................................... 35-231
35.12
BGP CLUSTER-ID ........................................................................................................................ 35-231
35.13
BGP CONFEDERATION IDENTIFIER ................................................................................................ 35-232
35.14
BGP CONFEDERATION PEERS ...................................................................................................... 35-232
35.15
BGP DAMPENING ........................................................................................................................ 35-232
35.16
BGP DEFAULT ............................................................................................................................ 35-233
35.17
BGP DETERMINISTIC-MED ........................................................................................................... 35-233
35.18
BGP ENFORCE-FIRST-AS ............................................................................................................. 35-234
35.19
BGP FAST-EXTERNAL-FAILOVER .................................................................................................. 35-234
35.20
BGP INBOUND-ROUTE-FILTER ...................................................................................................... 35-235
35.21
BGP INBOUND-MAX-ROUTE-NUM ................................................................................................. 35-235
35.22
BGP LOG-NEIGHBOR-CHANGES ................................................................................................... 35-236
35.23
BGP NETWORK IMPORT-CHECK ................................................................................................... 35-236
35.24
BGP RFC1771-PATH-SELECT ...................................................................................................... 35-236
35.25
BGP RFC1771-STRICT ................................................................................................................ 35-237
35.26
BGP ROUTER-ID ......................................................................................................................... 35-237
35.27 BGP SCAN-TIME ......................................................................................................................... 35-238
35.28
CLEAR IP BGP ............................................................................................................................ 35-238
1-22
XGS3 Command Guide
35.29 CLEAR IP BGP DAMPENING .......................................................................................................... 35-239
35.30
CLEAR IP BGP FLAP-STATISTICS .................................................................................................. 35-239
35.31
DEBUG BGP ............................................................................................................................... 35-239
35.32
DEBUG BGP REDISTRIBUTE MESSAGE SEND ................................................................................. 35-240
35.33
DEBUG BGP REDISTRIBUTE ROUTE RECEIVE ................................................................................ 35-240
35.34
DEBUG IPV6 BGP REDISTRIBUTE MESSAGE SEND ......................................................................... 35-241
35.35
DEBUG IPV6 BGP REDISTRIBUTE ROUTE RECEIVE ......................................................................... 35-241
35.36
DISTANCE .................................................................................................................................. 35-241
35.37
DISTANCE BGP ........................................................................................................................... 35-242
35.38
EXIT-ADDRESS-FAMILY ............................................................................................................... 35-242
35.39
IMPORT MAP .............................................................................................................................. 35-243
35.40
IP AS-PATH ACCESS-LIST ............................................................................................................ 35-244
35.41
IP COMMUNITY-LIST .................................................................................................................... 35-244
35.42
IP EXTCOMMUNITY-LIST .............................................................................................................. 35-245
35.43
NEIGHBOR ACTIVATE .................................................................................................................. 35-245
35.44
NEIGHBOR ADVERTISEMENT-INTERVAL ........................................................................................ 35-246
35.45
NEIGHBOR ALLOWAS-IN .............................................................................................................. 35-246
35.46
NEIGHBOR A TTRIBUTE-UNCHANGED ............................................................................................ 35-247
35.47
NEIGHBOR CAPABILITY ............................................................................................................... 35-247
35.48 NEIGHBOR CAPABILITY ORF PREFIX-LIST ..................................................................................... 35-248
35.49
NEIGHBOR COLLIDE-ESTABLISHED .............................................................................................. 35-249
35.50
NEIGHBOR DEFAULT-ORIGINATE .................................................................................................. 35-249
35.51
NEIGHBOR DESCRIPTION ............................................................................................................ 35-250
35.52
NEIGHBOR DISTRIBUTE-LIST ....................................................................................................... 35-250
35.53
NEIGHBOR DONT-CAPABILITY-NEGOTIATE .................................................................................... 35-251
35.54
NEIGHBOR EBGP-MULTIHOP ........................................................................................................ 35-251
35.55
NEIGHBOR ENFORCE-MULTIHOP .................................................................................................. 35-252
35.56
NEIGHBOR FILTER-LIST ............................................................................................................... 35-252
35.57
NEIGHBOR INTERFACE ................................................................................................................ 35-253
35.58
NEIGHBOR MAXIMUM-PREFIX ...................................................................................................... 35-253
35.59
NEIGHBOR NEXT-HOP-SELF ......................................................................................................... 35-254
35.60
NEIGHBOR OVERRIDE-CAPABILITY ............................................................................................... 35-255
35.61
NEIGHBOR PASSIVE .................................................................................................................... 35-255
35.62
NEIGHBOR PEER-GROUP (CREATING) .......................................................................................... 35-256
35.63
NEIGHBOR PEER-GROUP (CONFIGURING GROUP MEMBERS) ......................................................... 35-256
35.64
NEIGHBOR PORT ........................................................................................................................ 35-256
35.65
NEIGHBOR PREFIX-LIST .............................................................................................................. 35-257
35.66
NEIGHBOR REMOTE-AS ............................................................................................................... 35-257
35.67
NEIGHBOR REMOVE-PRIVATE-AS ................................................................................................ 35-258
1-23
XGS3 Command Guide
35.68 NEIGHBOR ROUTE-MAP .............................................................................................................. 35-258
35.69
NEIGHBOR ROUTE-REFLECTOR-CLIENT ........................................................................................ 35-259
35.70
NEIGHBOR ROUTE-SERVER-CLIENT ............................................................................................. 35-260
35.71
NEIGHBOR SEND-COMMUNITY ..................................................................................................... 35-260
35.72
NEIGHBOR SHUTDOWN ............................................................................................................... 35-261
35.73
NEIGHBOR SOFT-RECONFIGURATION INBOUND ............................................................................. 35-261
35.74
NEIGHBOR SOO .......................................................................................................................... 35-262
35.75
NEIGHBOR STRICT-CAPABILITY-MATCH ........................................................................................ 35-262
35.76
NEIGHBOR TIMERS ..................................................................................................................... 35-263
35.77
NEIGHBOR TIMERS CONNECT ...................................................................................................... 35-263
35.78
NEIGHBOR UNSUPPRESS-MAP ..................................................................................................... 35-264
35.79
NEIGHBOR UPDATE-SOURCE ....................................................................................................... 35-264
35.80
NEIGHBOR VERSION 4 ................................................................................................................ 35-265
35.81
NEIGHBOR WEIGHT ..................................................................................................................... 35-265
35.82
NETWORK (BGP) ....................................................................................................................... 35-266
35.83
REDISTRIBUTE (BGP) ................................................................................................................ 35-266
35.84
REDISTRIBUTE OSPF .................................................................................................................. 35-267
35.85
REDISTRIBUTE OSPF (MBGP4+) ................................................................................................ 35-267
35.86
RD ............................................................................................................................................ 35-268
35.87
ROUTER BGP ............................................................................................................................. 35-268
35.88
ROUTE-TARGET .......................................................................................................................... 35-269
35.89
SET VPNV4 NEXT-HOP ................................................................................................................ 35-269
35.90
SHOW IP BGP ............................................................................................................................. 35-270
35.91
SHOW IP BGP ATTRIBUTE-INFO .................................................................................................... 35-271
35.92
SHOW IP BGP COMMUNITY .......................................................................................................... 35-271
35.93
SHOW IP BGP COMMUNITY-INFO .................................................................................................. 35-272
35.94
SHOW IP BGP COMMUNITY-LIST ................................................................................................... 35-272
35.95
SHOW IP BGP DAMPENING ........................................................................................................... 35-273
35.96
SHOW IP BGP FILTER-LIST ........................................................................................................... 35-274
35.97
SHOW IP BGP INCONSISTENT-AS .................................................................................................. 35-274
35.98
SHOW IP BGP NEIGHBORS ........................................................................................................... 35-275
35.99
SHOW IP BGP PATHS ................................................................................................................... 35-276
35.100
35.101
35.102
35.103
35.104
35.105
35.106
SHOW IP BGP PREFIX-LIST ........................................................................................................ 35-276
SHOW IP BGP QUOTE-REGEXP ................................................................................................... 35-277
SHOW IP BGP REGEXP .............................................................................................................. 35-277
SHOW IP BGP ROUTE-MAP ........................................................................................................ 35-278
SHOW IP BGP SCAN .................................................................................................................. 35-278
SHOW I P BGP SUM MARY ........................................................................................................... 35-279
SHOW IP BGP VIEW ................................................................................................................... 35-280
1-24
XGS3 Command Guide
35.107 SHOW IP BGP VIEW NEIGHBORS ................................................................................................ 35-281
35.108
35.109
35.110
SHOW IP BGP VPNV4 ................................................................................................................ 35-281
SHOW IPV6 BGP REDISTRIBUTE ................................................................................................. 35-281
TIMERS BGP ............................................................................................................................. 35-282
CHAPTER 36 COMMANDS FOR BLACK HOLE ROUTING .........................................36-1
36.1 IP ROUTE NULL0 .............................................................................................................................. 36-1
36.2
IPV6 ROUTE NULL0 .......................................................................................................................... 36-1
CHAPTER 37 COMMANDS FOR ECMP .......................................................................37-1
37.1 MAXIMUM-PATHS .............................................................................................................................. 37-1
CHAPTER 38 IPV4 MULTICAST PROTOCOL ..............................................................38-1
38.1 PUBLIC COMMANDS FOR MULTICAST ................................................................................................ 38-1
38.1.1 show ip mroute .................................................................................................................................... 38-1
38.2 COMMANDS FOR PIM-DM ................................................................................................................ 38-2
38.2.1 debug pim timer sat ............................................................................................................................ 38-2
38.2.2 debug pim timer srt ............................................................................................................................. 38-2
38.2.3 ip mroute ............................................................................................................................................. 38-3
38.2.4 ip pim bsr-border ................................................................................................................................. 38-3
38.2.5 ip pim dense-mode ............................................................................................................................. 38-4
38.2.6 ip pim dr-priority .................................................................................................................................. 38-4
38.2.7 ip pim exclude-genid ........................................................................................................................... 38-4
38.2.8 ip pim hello-holdtime ........................................................................................................................... 38-5
38.2.9 ip pim hello-interval ............................................................................................................................. 38-5
38.2.10 ip pim multica st -routing ..................................................................................................................... 38-6
38.2.11 ip pim neighbor-filter .......................................................................................................................... 38-6
38.2.12 ip pim scope-border .......................................................................................................................... 38-7
38.2.13 ip pim state-refresh origination-interval ............................................................................................. 38-7
38.2.14 show ip pim interface ........................................................................................................................ 38-7
38.2.15 show ip pim mroute dense-mode ...................................................................................................... 38-8
38.2.16 show ip pim neighbor ...................................................................................................................... 38-10
38.2.17 show ip pim nexthop ....................................................................................................................... 38-11
38.3 COMMANDS FOR PIM-SM .............................................................................................................. 38-12
38.3.1 clear ip pim bsr rp-set ........................................................................................................................ 38-12
38.3.2 debug pim event ............................................................................................................................... 38-13
38.3.3 debug pim mfc .................................................................................................................................. 38-13
38.3.4 debug pim mib .................................................................................................................................. 38-13
38.3.5 debug pim nexthop ........................................................................................................................... 38-14
38.3.6 debug pim nsm ................................................................................................................................. 38-14
1-25
XGS3 Command Guide
38.3.7 debug pim packet .............................................................................................................................. 38-14
38.3.8 debug pim state ................................................................................................................................ 38-15
38.3.9 debug pim timer ................................................................................................................................ 38-15
38.3.10 ip mroute ......................................................................................................................................... 38-16
38.3.11 ip pim accept-register ...................................................................................................................... 38-16
38.3.12 ip pim bsr-border ............................................................................................................................. 38-17
38.3.13 ip pim bsr-candidate ........................................................................................................................ 38-17
38.3.14 ip pim cisco -register-checksum ....................................................................................................... 38-18
38.3.15 ip pim dr-priority .............................................................................................................................. 38-18
38.3.16 ip pim exclude-genid ....................................................................................................................... 38-18
38.3.17 ip pim hello-holdtime ....................................................................................................................... 38-19
38.3.18 ip pim hello-interval ......................................................................................................................... 38-19
38.3.19 ip pim ignore-rp-set-priority ............................................................................................................. 38-20
38.3.20 ip pim jp-timer ................................................................................................................................. 38-20
38.3.21 ip pim multica st -routing ................................................................................................................... 38-21
38.3.22 ip pim neighbor-filter ....................................................................................................................... 38-21
38.3.23 ip pim register-rate-limit ................................................................................................................... 38-22
38.3.24 ip pim register-rp-reachability .......................................................................................................... 38-22
38.3.25 ip pim register-source ...................................................................................................................... 38-22
38.3.26 ip pim register-suppression ............................................................................................................. 38-23
38.3.27 ip pim rp-address ............................................................................................................................ 38-23
38.3.28 ip pim rp-candidate ......................................................................................................................... 38-23
38.3.29 ip pim rp-register-kat ....................................................................................................................... 38-24
38.3.30 ip pim scope-border ........................................................................................................................ 38-24
38.3.31 ip pim sparse-mode ......................................................................................................................... 38-25
38.3.32 show ip pim bsr-router ..................................................................................................................... 38-25
38.3.33 show ip pim interface ...................................................................................................................... 38-26
38.3.34 show ip pim mroute sparse-mode ................................................................................................... 38-27
38.3.35 show ip pim neighbor ...................................................................................................................... 38-28
38.3.36 show ip pim nexthop ....................................................................................................................... 38-29
38.3.37 show ip pim rp-hash ........................................................................................................................ 38-31
38.3.38 show ip pim rp mapping .................................................................................................................. 38-31
38.4 COMMANDS FOR MSDP CONFIGURATION ....................................................................................... 38-32
38.4.1 cache-sa-holdtime ............................................................................................................................. 38-32
38.4.2 cache-sa-maximum ........................................................................................................................... 38-32
38.4.3 cache-sa-state .................................................................................................................................. 38-33
38.4.4 clear msdp peer ................................................................................................................................ 38-33
38.4.5 clear msdp sa-cache ......................................................................................................................... 38-34
38.4.6 clear msdp stat ist ic s .......................................................................................................................... 38-34
1-26
XGS3 Command Guide
38.4.7 connect-source ................................................................................................................................. 38-34
38.4.8 debug msdp all .................................................................................................................................. 38-35
38.4.9 debug msdp event s ........................................................................................................................... 38-35
38.4.10 debug msdp filter ............................................................................................................................. 38-35
38.4.11 debug msdp fsm .............................................................................................................................. 38-36
38.4.12 debug msdp keepal iv e .................................................................................................................... 38-36
38.4.13 debug msdp nsm ............................................................................................................................. 38-36
38.4.14 debug msdp packet ......................................................................................................................... 38-37
38.4.15 debug msdp peer ............................................................................................................................ 38-37
38.4.16 debug msdp timer ........................................................................................................................... 38-37
38.4.17 default-rpf-peer ............................................................................................................................... 38-37
38.4.18 description ....................................................................................................................................... 38-38
38.4.19 exit-peer-mode ................................................................................................................................ 38-38
38.4.20 mesh-group ..................................................................................................................................... 38-39
38.4.21 originating-rp ................................................................................................................................... 38-39
38.4.22 peer ................................................................................................................................................. 38-40
38.4.23 redistribute ...................................................................................................................................... 38-40
38.4.24 remote-as ........................................................................................................................................ 38-40
38.4.25 router msdp ..................................................................................................................................... 38-41
38.4.26 sa-filter ............................................................................................................................................ 38-41
38.4.27 sa-request ....................................................................................................................................... 38-42
38.4.28 sa-request-filter ............................................................................................................................... 38-42
38.4.29 show msdp global ........................................................................................................................... 38-43
38.4.30 show msdp local-sa-cache .............................................................................................................. 38-44
38.4.31 show msdp peer .............................................................................................................................. 38-45
38.4.32 show msdp sa-cache ...................................................................................................................... 38-46
38.4.33 show msdp sa-cache summary ....................................................................................................... 38-47
38.4.34 show msdp statistics ....................................................................................................................... 38-49
38.4.35 show msdp summary ...................................................................................................................... 38-50
38.4.36 shutdown ......................................................................................................................................... 38-51
38.4.37 ttl-threshold ..................................................................................................................................... 38-51
38.5 COMMANDS FOR ANYCAST RP V4 ............................................................................................... 38-52
38.5.1 debug pim anycast-rp ....................................................................................................................... 38-52
38.5.2 ip pim anycast-rp ............................................................................................................................... 38-52
38.5.3 ip pim anycast-rp ............................................................................................................................... 38-52
38.5.4 ip pim anycast-rp self-rp-address ...................................................................................................... 38-53
38.5.5 ip pim rp-candidate ........................................................................................................................... 38-54
38.5.6 show debugging pim ......................................................................................................................... 38-54
38.5.7 show ip pim anycast-rp first-hop ....................................................................................................... 38-54
1-27
XGS3 Command Guide
38.5.8 show ip pim anycast-rp non-first-hop ................................................................................................ 38-55
38.5.9 show ip pim anycast-rp status ........................................................................................................... 38-56
38.6 COMMANDS FOR PIM-SSM ........................................................................................................... 38-57
38.6.1 ip multicast ssm ................................................................................................................................ 38-57
38.7 COMMANDS FOR DVMRP .............................................................................................................. 38-58
38.7.1 debug dvmrp ..................................................................................................................................... 38-58
38.7.2 ip dvmrp enable ................................................................................................................................ 38-58
38.7.3 ip dvmrp metric ................................................................................................................................. 38-59
38.7.4 ip dvmrp multicast-routing ................................................................................................................. 38-59
38.7.5 ip dvmrp output-report-delay ............................................................................................................. 38-59
38.7.6 ip dvmrp reject-non-pruners .............................................................................................................. 38-60
38.7.7 ip dvmrp tunnel ................................................................................................................................. 38-60
38.7.8 show ip dvmrp ................................................................................................................................... 38-61
38.7.9 show ip dvmrp interface .................................................................................................................... 38-61
38.7.10 show ip dvmrp neighbor .................................................................................................................. 38-62
38.7.11 show ip dvmrp prune ....................................................................................................................... 38-63
38.7.12 show ip dvmrp route ........................................................................................................................ 38-64
38.8 COMMANDS FOR DCSCM .............................................................................................................. 38-65
38.8.1 access-list (Multicast Destination Control) ........................................................................................ 38-65
38.8.2 access-list (Multicast Source Control) ............................................................................................... 38-66
38.8.3 ip multicast destination-control access-group ................................................................................... 38-66
38.8.4 ip multicast destination-control access-group (sip) ........................................................................... 38-67
38.8.5 ip multicast destination-control access-group (vmac) ....................................................................... 38-67
38.8.6 ip multicast policy .............................................................................................................................. 38-68
38.8.7 ip multicast sou rc e -control ................................................................................................................ 38-68
38.8.8 ip multicast source-control access-group .......................................................................................... 38-69
38.8.9 multicast destination-control .............................................................................................................. 38-69
38.8.10 show ip multicast destination-control ............................................................................................... 38-70
38.8.11 show ip multicast destination-control access-list ............................................................................. 38-70
38.8.12 show ip multicast policy ................................................................................................................... 38-71
38.8.13 show ip multicast source-control ..................................................................................................... 38-71
38.8.14 show ip multicast source-control acc ess-list ................................................................................... 38-71
38.9 COMMANDS FOR IGMP .................................................................................................................. 38-72
38.9.1 clear ip igmp group ........................................................................................................................... 38-72
38.9.2 debug igmp event ............................................................................................................................. 38-72
38.9.3 debug igmp packet ............................................................................................................................ 38-72
38.9.4 ip igmp access-group ........................................................................................................................ 38-73
38.9.5 ip igmp immediate-leave ................................................................................................................... 38-73
38.9.6 ip igmp join-group ............................................................................................................................. 38-74
1-28
XGS3 Command Guide
38.9.7 ip igmp last-member-query-interval ................................................................................................... 38-74
38.9.8 ip igmp limit ....................................................................................................................................... 38-74
38.9.9 ip igmp query-interval ........................................................................................................................ 38-75
38.9.10 ip igmp query-max-response-time ................................................................................................... 38-75
38.9.11 ip igmp query-timeout ...................................................................................................................... 38-76
38.9.12 ip igmp robust-variable .................................................................................................................... 38-76
38.9.13 ip igmp static-group ......................................................................................................................... 38-77
38.9.14 ip igmp version ................................................................................................................................ 38-77
38.9.15 show ip igmp groups ....................................................................................................................... 38-77
38.9.16 show ip igmp interface .................................................................................................................... 38-80
38.10 COMMANDS FOR IGMP SNOOPING ............................................................................................... 38-80
38.10.1 clear ip igmp snooping vlan ............................................................................................................. 38-80
38.10.2 clear ip igmp snooping vlan <1-4094> mrouter-port ........................................................................ 38-80
38.10.3 debug igmp snooping all/p ac ket/ ev ent /t imer / mf c ............................................................................ 38-81
38.10.4 ip igmp snooping ............................................................................................................................. 38-81
38.10.5 ip igmp snooping vlan ..................................................................................................................... 38-81
38.10.6 ip igmp snooping vlan immedi ate-leave .......................................................................................... 38-82
38.10.7 ip igmp snooping vlan l2-general-querier ........................................................................................ 38-82
38.10.8 ip igmp snooping vlan l2-general-querier-source ............................................................................ 38-82
38.10.9 ip igmp snooping vlan l2-general-querier-version ........................................................................... 38-83
38.10.10 ip igmp snooping vlan limit ............................................................................................................ 38-83
38.10.11 ip igmp snooping vlan mrouter-port interface ................................................................................ 38-84
38.10.12 ip igmp snooping vlan mrpt ........................................................................................................... 38-84
38.10.13 ip igmp snooping vlan query-interval ............................................................................................. 38-84
38.10.14 ip igmp snooping vlan query-mrsp ................................................................................................ 38-85
38.10.15 ip igmp snooping vlan query-robustness ....................................................................................... 38-85
38.10.16 ip igmp snooping vlan report source-address ............................................................................... 38-85
38.10.17 ip igmp snooping vlan static-group ................................................................................................ 38-86
38.10.18 ip igmp snooping vlan suppression-query-time ............................................................................. 38-86
38.10.19 show ip igmp snooping .................................................................................................................. 38-87
38.11 COMMANDS FOR IGMP PROXY ..................................................................................................... 38-89
38.11.1 clear ip igmp proxy group ................................................................................................................ 38-89
38.11.2 debug igmp proxy all ....................................................................................................................... 38-89
38.11.3 debug igmp proxy event .................................................................................................................. 38-89
38.11.4 debug igmp proxy mfc ..................................................................................................................... 38-90
38.11.5 debug igmp proxy packet ................................................................................................................ 38-90
38.11.6 debug igmp proxy timer ................................................................................................................... 38-90
38.11.7 ip igmp proxy ................................................................................................................................... 38-91
38.11.8 ip igmp proxy aggregate .................................................................................................................. 38-91
1-29
XGS3 Command Guide
38.11.9 ip igmp proxy downstream .............................................................................................................. 38-91
38.11.10 ip igmp proxy limit .......................................................................................................................... 38-92
38.11.11 ip igmp proxy multicast-source ...................................................................................................... 38-92
38.11.12 ip igmp proxy unsolicited-report interval ........................................................................................ 38-92
38.11.13 ip igmp proxy unsolicited-report robustness .................................................................................. 38-93
38.11.14 ip igmp proxy upstream ................................................................................................................. 38-93
38.11.15 ip multicas t ssm ............................................................................................................................. 38-93
38.11.16 ip pim bsr-border ........................................................................................................................... 38-94
38.11.17 show debugging igmp proxy .......................................................................................................... 38-94
38.11.18 show ip igmp proxy ........................................................................................................................ 38-95
38.11.19 show ip igmp proxy mroute ........................................................................................................... 38-96
38.11.20 show ip igmp proxy upstream groups ............................................................................................ 38-97
CHAPTER 39 IPV6 MULTICAST PROTOCOL ..............................................................39-1
39.1 PUBLIC COMMANDS FOR MULTICAST ................................................................................................ 39-1
39.1.1 show ipv6 mroute ................................................................................................................................ 39-1
39.2 COMMANDS FOR PIM-DM6 .............................................................................................................. 39-2
39.2.1 debug ipv6 pim timer sat ..................................................................................................................... 39-2
39.2.2 debug ipv6 pim timer srt ...................................................................................................................... 39-2
39.2.3 ipv6 mroute ......................................................................................................................................... 39-3
39.2.4 ipv6 pim bsr-border ............................................................................................................................. 39-3
39.2.5 ipv6 pim dense-mode .......................................................................................................................... 39-4
39.2.6 ipv6 pim dr-priority .............................................................................................................................. 39-4
39.2.7 ipv6 pim exclude-genid ....................................................................................................................... 39-4
39.2.8 ipv6 pim hello-holdtime ....................................................................................................................... 39-5
39.2.9 ipv6 pim hello-interval ......................................................................................................................... 39-5
39.2.10 ipv6 pim multicast-routing ................................................................................................................. 39-6
39.2.11 ipv6 pim neighbor-filter ...................................................................................................................... 39-6
39.2.12 ipv6 pim scope-border ....................................................................................................................... 39-7
39.2.13 ipv6 pim state-refresh origination-interval ......................................................................................... 39-7
39.2.14 show ipv6 pim interface ..................................................................................................................... 39-7
39.2.15 show ipv6 pim mroute dense-mode .................................................................................................. 39-8
39.2.16 show ipv6 pim neighbor .................................................................................................................. 39-10
39.2.17 show ipv6 pim nexthop .................................................................................................................... 39-11
39.3 COMMANDS FOR PIM-SM6 ............................................................................................................ 39-12
39.3.1 clear ipv6 pim bsr rp-set .................................................................................................................... 39-12
39.3.2 debug ipv6 pim events ...................................................................................................................... 39-13
39.3.3 debug ipv6 pim mfc ........................................................................................................................... 39-13
39.3.4 debug ipv6 pim mib ........................................................................................................................... 39-13
39.3.5 debug ipv6 pim nexthop .................................................................................................................... 39-13
1-30
XGS3 Command Guide
39.3.6 debug ipv6 pim nsm .......................................................................................................................... 39-14
39.3.7 debug ipv6 pim packet ...................................................................................................................... 39-14
39.3.8 debug ipv6 pim state ......................................................................................................................... 39-14
39.3.9 debug ipv6 pim timer ......................................................................................................................... 39-15
39.3.10 ipv6 mroute ..................................................................................................................................... 39-16
39.3.11 ipv6 pim accept-register .................................................................................................................. 39-16
39.3.12 ipv6 pim bsr-border ......................................................................................................................... 39-17
39.3.13 ipv6 pim bsr-candidate .................................................................................................................... 39-17
39.3.14 ipv6 pim cisco-register-checksum ................................................................................................... 39-18
39.3.15 ipv6 pim dr-priority .......................................................................................................................... 39-18
39.3.16 ipv6 pim exclude-genid ................................................................................................................... 39-19
39.3.17 ipv6 pim hello-holdtime ................................................................................................................... 39-19
39.3.18 ipv6 pim hello-interval ..................................................................................................................... 39-19
39.3.19 ipv6 pim ignore-rp-set-priority ......................................................................................................... 39-20
39.3.20 ipv6 pim jp-timer .............................................................................................................................. 39-20
39.3.21 Command: ipv6 pim multicas t-routing ............................................................................................. 39-21
39.3.22 ipv6 pim neighbor-filter .................................................................................................................... 39-21
39.3.23 ipv6 pim register-rate-limit ............................................................................................................... 39-21
39.3.24 ipv6 pim register-rp-reachability ...................................................................................................... 39-22
39.3.25 ipv6 pim register-source .................................................................................................................. 39-22
39.3.26 ipv6 pim register-suppression ......................................................................................................... 39-23
39.3.27 ipv6 pim rp-address ........................................................................................................................ 39-23
39.3.28 ipv6 pim rp-candidate ...................................................................................................................... 39-23
39.3.29 ipv6 pim rp-register-kat ................................................................................................................... 39-24
39.3.30 ipv6 pim scope-border ..................................................................................................................... 39-24
39.3.31 ipv6 pim sparse-mode ..................................................................................................................... 39-24
39.3.32 show ipv6 pim bsr-router ................................................................................................................. 39-25
39.3.33 show ipv6 pim interface ................................................................................................................... 39-26
39.3.34 show ipv6 pim mroute sparse-mode ............................................................................................... 39-27
39.3.35 show ipv6 pim neighbor .................................................................................................................. 39-28
39.3.36 show ipv6 pim nexthop .................................................................................................................... 39-29
39.3.37 show ipv6 pim rp-hash .................................................................................................................... 39-31
39.3.38 show ipv6 pim rp mapping .............................................................................................................. 39-31
39.4 COMMANDS FOR ANYCAST RP V6 ............................................................................................... 39-32
39.4.1 debug ipv6 pim anycast-rp ................................................................................................................ 39-32
39.4.2 ipv6 pim anycast-rp ........................................................................................................................... 39-32
39.4.3 ipv6 pim anycast-rp ........................................................................................................................... 39-33
39.4.4 ipv6 pim anycast-rp self-rp-address .................................................................................................. 39-33
39.4.5 ipv6 pim rp-candidate ........................................................................................................................ 39-34
1-31
XGS3 Command Guide
39.4.6 show debugging ipv6 pim .................................................................................................................. 39-34
39.4.7 show ipv6 pim anycast-rp first-hop .................................................................................................... 39-35
39.4.8 show ipv6 pim anycast-rp non-first-hop ............................................................................................ 39-35
39.4.9 show ipv6 pim anycast-rp status ....................................................................................................... 39-36
39.5 COMMANDS FOR PIM-SSM6 ......................................................................................................... 39-37
39.5.1 ipv6 pim ssm ..................................................................................................................................... 39-37
39.6 COMMANDS FOR IPV6 DCSCM ...................................................................................................... 39-38
39.6.1 ipv6 access-list(ipv6 multicast source control) .................................................................................. 39-38
39.6.2 ipv6 access-list(multicast destination control) ................................................................................... 39-38
39.6.3 ipv6 multicast destinati on-control access-group ................................................................................ 39-39
39.6.4 ipv6 multicast destinati on-control access-group (sip) ........................................................................ 39-40
39.6.5 ipv6 multicast destinati on-control access-group (vmac) .................................................................... 39-40
39.6.6 ipv6 multicast policy .......................................................................................................................... 39-41
39.6.7 ipv6 multicast source-control ............................................................................................................. 39-41
39.6.8 ipv6 multicast source-control access-group ...................................................................................... 39-41
39.6.9 multicast destination-control .............................................................................................................. 39-42
39.6.10 show ipv6 multicast destination-control ........................................................................................... 39-42
39.6.11 show ipv6 multicast destination-control access-list ......................................................................... 39-43
39.6.12 show ipv6 multicast policy ............................................................................................................... 39-43
39.6.13 show ipv6 multicast source-control ................................................................................................. 39-44
39.6.14 show ipv6 multicast source-control access-list ................................................................................ 39-44
39.7 COMMANDS FOR MLD ................................................................................................................... 39-44
39.7.1 clear ipv6 mld group .......................................................................................................................... 39-44
39.7.2 debug ipv6 mld events ...................................................................................................................... 39-45
39.7.3 debug ipv6 mld packet ...................................................................................................................... 39-45
39.7.4 ipv6 mld access-group ...................................................................................................................... 39-46
39.7.5 ipv6 mld immediate-leave ................................................................................................................. 39-46
39.7.6 ipv6 mld join-group ............................................................................................................................ 39-47
39.7.7 ipv6 mld join-group mode source ...................................................................................................... 39-47
39.7.8 ipv6 mld last-member-query-interval ................................................................................................. 39-47
39.7.9 ipv6 mld limit ..................................................................................................................................... 39-48
39.7.10 ipv6 mld query-interval .................................................................................................................... 39-48
39.7.11 ipv6 mld query-max-response-time ................................................................................................. 39-49
39.7.12 ipv6 mld query-timeout .................................................................................................................... 39-49
39.7.13 ipv6 mld static-group ....................................................................................................................... 39-50
39.7.14 ipv6 mld version .............................................................................................................................. 39-50
39.7.15 show ipv6 mld groups ..................................................................................................................... 39-51
39.7.16 show ipv6 mld interface ................................................................................................................... 39-51
39.7.17 show ipv6 mld join-group ................................................................................................................ 39-52
1-32
XGS3 Command Guide
39.8 COMMANDS FOR MLD SNOOPING CONFIGURATION ......................................................................... 39-52
39.8.1 clear ipv6 mld snooping vlan ............................................................................................................. 39-52
39.8.2 clear ipv6 mld snooping vlan <1-4094> mrouter-port ........................................................................ 39-53
39.8.3 debug mld snooping all/pac ket/event/timer/mfc ................................................................................ 39-53
39.8.4 ipv6 mld snooping ............................................................................................................................. 39-53
39.8.5 ipv6 mld snooping vlan ...................................................................................................................... 39-54
39.8.6 ipv6 mld snooping vlan immediat e-leave .......................................................................................... 39-54
39.8.7 ipv6 mld snooping vlan l2-general-querier ........................................................................................ 39-54
39.8.8 ipv6 mld snooping vlan limit .............................................................................................................. 39-55
39.8.9 ipv6 mld snooping vlan mrouter -port interface .................................................................................. 39-55
39.8.10 ipv6 mld snooping vlan mrpt ........................................................................................................... 39-56
39.8.11 ipv6 mld snooping vlan query-interval ............................................................................................. 39-56
39.8.12 ipv6 mld snooping vlan query-mrsp ................................................................................................ 39-56
39.8.13 ipv6 mld snooping vlan query-robustness ....................................................................................... 39-57
39.8.14 ipv6 mld snooping vlan static-group ................................................................................................ 39-57
39.8.15 ipv6 mld snooping vlan suppression-query-time ............................................................................. 39-57
39.8.16 show ipv6 mld snooping .................................................................................................................. 39-58
CHAPTER 40 COMMANDS FOR MULTICAST VLAN ..................................................40-1
40.1 MULTICAST-VLAN ............................................................................................................................. 40-1
40.2
MULTICAST-VL AN ASSOCIATION ......................................................................................................... 40-1
CHAPTER 41 COMMANDS FOR ACL ..........................................................................41-2
41.1 ABSOLUTE-PERIODIC/PERIODIC ......................................................................................................... 41-2
41.2
ABSOLUTE START ............................................................................................................................. 41-3
41.3
ACCESS-LIST (IP EXTEN DED) ............................................................................................................. 41-3
41.4
ACCESS-LIST (IP STANDARD) ............................................................................................................ 41-4
41.5
ACCESS-LIST(MAC EXTENDED) .......................................................................................................... 41-5
41.6
ACCESS-LIST(MAC-IP EXTENDED) ...................................................................................................... 41-6
41.7
ACCESS-LIST(MAC STANDARD) ......................................................................................................... 41-7
41.8
CLEAR ACCESS-GROUP STATISTIC INTERFACE ................................................................................... 41-8
41.9
FIREWALL ........................................................................................................................................ 41-8
41.10
FIREWALL DEFAULT ........................................................................................................................ 41-8
41.11
IP ACC ESS EXTENDED ..................................................................................................................... 41-9
41.12
IP ACCESS STA NDARD .................................................................................................................... 41-9
41.13
IPV6 ACCESS-LIST ........................................................................................................................ 41-10
41.14
IPV6 ACCESS STANDARD .............................................................................................................. 41-11
41.15
IPV6 ACCESS EXTENDED ............................................................................................................... 41-11
41.16
{IP|IPV6|MAC|MAC-IP} ACCESS-GROUP .......................................................................................... 41-11
41.17
MAC ACCESS EXTENDED ............................................................................................................... 41-12
1-33
XGS3 Command Guide
41.18 MAC-IP ACCESS EXTENDED ........................................................................................................... 41-12
41.19
PERMIT | DENY (IP EXTENDED) ....................................................................................................... 41-13
41.20
PERMIT | DENY(IP STANDARD) ....................................................................................................... 41-14
41.21
PERMIT | DENY(IPV6 EXTENDED) ................................................................................................... 41-14
41.22
PERMIT | DENY(IPV6 STANDARD) ................................................................................................... 41-15
41.23
PERMIT | DENY(MAC EXTENDED) ................................................................................................... 41-15
41.24
PERMIT | DENY(MAC-IP EXTENDED) ............................................................................................... 41-17
41.25
SHOW ACCESS-LISTS ................................................................................................................... 41-19
41.26
SHOW ACCESS-GROUP ................................................................................................................. 41-20
41.27
SHOW FIREWALL .......................................................................................................................... 41-21
41.28
SHOW IPV6 ACCESS-LISTS ............................................................................................................ 41-21
41.29
SHOW TIME-RANGE ...................................................................................................................... 41-22
41.30
TIME-RANGE ................................................................................................................................ 41-22
CHAPTER 42 COMMANDS FOR 802.1X ....................................................................42-23
42.1 DEBUG DOT1X DETAIL .................................................................................................................... 42-23
42.2
DEBUG DOT1X ERROR .................................................................................................................... 42-23
42.3
DEBUG DOT1X FSM ........................................................................................................................ 42-23
42.4 DEBUG DOT1X PACKET ................................................................................................................... 42-24
42.5
DOT1X ACCEPT-MAC ...................................................................................................................... 42-24
42.6
DOT1X EAPOR ENABLE ................................................................................................................... 42-25
42.7
DOT1X ENABLE .............................................................................................................................. 42-25
42.8
DOT1X IPV6 PASSTHROUGH ............................................................................................................ 42-26
42.9
DOT1X GUEST-VLAN ....................................................................................................................... 42-26
42.10
DOT1X MACFILTER ENABLE .......................................................................................................... 42-27
42.11
DOT1X MAX-REQ .......................................................................................................................... 42-27
42.12
DOT1X USER FREE-RESOURCE ...................................................................................................... 42-27
42.13
DOT1X MAX-USER MACBASED ...................................................................................................... 42-28
42.14
DOT1X MAX-USER USERBASED ..................................................................................................... 42-28
42.15
DOT1X PORT-CONTROL ................................................................................................................ 42-29
42.16
DOT1X PORT-METHOD .................................................................................................................. 42-29
42.17
DOT1X PRIVATECLIENT ENABLE .................................................................................................... 42-30
42.18
DOT1X RE-AUTHENTICATE ............................................................................................................ 42-30
42.19
DOT1X RE-AUTHENTICATION ......................................................................................................... 42-30
42.20
DOT1X TIMEOUT QUIET-PERIOD ..................................................................................................... 42-31
42.21
DOT1X TIMEO U T RE-AUTHPERIOD .................................................................................................. 42-31
42.22 DOT1X TIMEOUT TX-PERIOD .......................................................................................................... 42-31
42.23
DOT1X UNICAST ENABLE .............................................................................................................. 42-32
42.24
DOT1X WEB AUTH EN TICATION ENABLE .......................................................................................... 42-32
42.25
DOT1X WEB REDIRECT ................................................................................................................. 42-33
1-34
XGS3 Command Guide
42.26 DOT1X WEB REDIRECT ENABLE ..................................................................................................... 42-33
42.27
SHOW DOT1X ............................................................................................................................... 42-33
CHAPTER 43 COMMANDS FOR THE NUMBER LIMITATION FUNCTION OF PORT,
MAC IN VLAN AND IP ...................................................................................................43-1
43.1 SWITCHPORT MAC-ADDRESS DYNAMIC MAXIMUM ............................................................................... 43-1
43.2
VLAN MAC-ADDRES S DYNAMIC MAXIMUM ........................................................................................... 43-1
43.3
SWITCHPORT ARP DYNAMIC MAXIMUM ............................................................................................... 43-2
43.4
SWITCHPORT ND DYNAMIC MAXIMUM ................................................................................................. 43-2
43.5
IP ARP DYNAMIC MAXIMUM ................................................................................................................ 43-3
43.6
IPV6 ND DYNAMIC MAXIMUM .............................................................................................................. 43-4
43.7
MAC-ADDRESS QUERY TIMEOUT ........................................................................................................ 43-4
43.8
SHOW MAC-ADDRESS DYNAMIC COUNT ............................................................................................. 43-4
43.9
SHOW ARP-DYNAMIC COUNT ............................................................................................................. 43-5
43.10
SHOW ND-DYNAMIC COUNT ............................................................................................................. 43-5
43.11
DEBUG SWITCHPORT MAC COUNT .................................................................................................... 43-6
43.12
DEBUG SWITCHPORT ARP COUNT .................................................................................................... 43-6
43.13
DEBUG SWITCHPORT ND COUNT ...................................................................................................... 43-7
43.14
DEBUG VLAN MAC COUNT ............................................................................................................... 43-7
43.15
DEBUG IP ARP COUNT ..................................................................................................................... 43-8
43.16
DEBUG IPV6 ND COUNT ................................................................................................................... 43-8
CHAPTER 44 COMMANDS FOR AM CONFIGURATION .............................................44-1
44.1 AM ENABLE ..................................................................................................................................... 44-1
44.2
AM PORT ......................................................................................................................................... 44-1
44.3
AM IP-POOL ..................................................................................................................................... 44-1
44.4
AM MAC-IP-POOL ............................................................................................................................. 44-2
44.5
NO AM ALL ....................................................................................................................................... 44-2
44.6
SHOW AM ........................................................................................................................................ 44-2
CHAPTER 45 COMMANDS FOR SECURITY FEATURE ..............................................45-1
45.1 DOSATTACK-CHECK SRCIP-EQUAL-DSTIP ENABLE .............................................................................. 45-1
45.2
DOSATTACK-CHECK IPV4-FIRST-FRAGMENT ENABLE .......................................................................... 45-1
45.3
DOSATTACK-CHECK TCP-FLAGS ENABLE ........................................................................................... 45-1
45.4
DOSATTACK-CHECK SRCPORT-EQUAL-DSTPORT ENABLE ................................................................... 45-2
45.5
DOSATTACK-CHECK TCP-FRAGMENT EN ABLE .................................................................................... 45-2
45.6
DOSATTACK-CHECK TCP-SEGMENT ................................................................................................... 45-2
45.7
DOSATTACK-CHECK ICMP-ATTACKING ENABLE ................................................................................... 45-3
45.8
DOSATTACK-CHECK ICMPV4-SIZE ...................................................................................................... 45-3
45.9
DOSATTACK-CHECK ICMPV6-SIZE ...................................................................................................... 45-3
1-35
XGS3 Command Guide
CHAPTER 46 COMMANDS FOR TACACS+ .................................................................46-1
46.1 TACACS-SERVER AUTHENTICATION HOST ........................................................................................... 46-1
46.2
TACACS-SERVER KEY ....................................................................................................................... 46-1
46.3
TACACS-SERVER NAS-IPV4 ............................................................................................................... 46-2
46.4
TACACS-SERVER TIMEOUT ................................................................................................................ 46-2
46.5
DEBUG TACACS-SERVER .................................................................................................................. 46-2
CHAPTER 47 COMMANDS FOR RADIUS ....................................................................47-1
47.1 AAA ENABLE .................................................................................................................................... 47-1
47.2
AAA-ACCOUNTING ENABLE ............................................................................................................... 47-1
47.3
AAA-ACCOUNTING UPDATE ............................................................................................................... 47-1
47.4
DEBUG AAA PACKET ......................................................................................................................... 47-2
47.5
DEBUG AAA DETAIL ATTRIBUTE ......................................................................................................... 47-2
47.6
DEBUG AAA DETAIL CONNECTION ...................................................................................................... 47-2
47.7
DEBUG AAA DETAIL EVENT ................................................................................................................ 47-3
47.8
DEBUG AAA ERROR .......................................................................................................................... 47-3
47.9
RADIUS NAS-IPV4 ............................................................................................................................. 47-3
47.10
RADIUS NAS-IPV6 ........................................................................................................................... 47-4
47.11
RADIUS-SERVER ACCOUNTING HOST ............................................................................................... 47-4
47.12
RADIUS-SERVER A U T HEN TICATION HOST ......................................................................................... 47-5
47.13 RADIUS-SERVER DEAD-TIME ........................................................................................................... 47-6
47.14
RADIUS-SERVER KEY ...................................................................................................................... 47-6
47.15
RADIUS-SERVER RETRANSMIT ......................................................................................................... 47-6
47.16
RADIUS-SERVER TIMEOUT ............................................................................................................... 47-7
47.17
RADIUS-SERVER ACCOUNTING-INTERIM-UPDATE TIMEOUT ................................................................ 47-7
47.18
SHOW AAA AUTHENTICATED-USER .................................................................................................. 47-8
47.19
SHOW AAA AUTHENTICATING-USER ................................................................................................. 47-9
47.20
SHOW AAA CONFIG ......................................................................................................................... 47-9
47.21
SHOW RADIUS COUNT ................................................................................................................... 47-10
CHAPTER 48 COMMANDS FOR SSL CONFIGURATION ............................................48-1
48.1 IP HTTP SECURE-SERVER .................................................................................................................. 48-1
48.2
IP HTTP SECURE-PORT ..................................................................................................................... 48-1
48.3
IP HTTP SECURE- CIPHERSUITE ......................................................................................................... 48-1
48.4
SHOW IP HTTP SECURE-SERVER STATUS ............................................................................................ 48-2
48.5
DEBUG SSL ...................................................................................................................................... 48-2
CHAPTER 49 COMMANDS FOR IPV6 SECURITY RA .................................................49-1
49.1 IPV6 SECURITY-RA ENABLE ............................................................................................................... 49-1
49.2
IPV6 SECURITY-RA ENABLE ............................................................................................................... 49-1
1-36
XGS3 Command Guide
49.3 SHOW IPV6 SECURITY-RA ................................................................................................................. 49-1
49.4
DEBUG IPV6 SECURITY-RA ................................................................................................................ 49-2
CHAPTER 50 COMMANDS FOR VLAN-ACL ...............................................................50-1
50.1 CLEAR VACL STATISTIC VLAN ............................................................................................................ 50-1
50.2
SHOW VACL VLAN ............................................................................................................................ 50-1
50.3
VACL IP ACCESS-GROUP ................................................................................................................... 50-2
50.4
VACL IPV6 ACCESS-GROUP ............................................................................................................... 50-3
50.5
VACL MAC ACCESS-GROUP ............................................................................................................... 50-3
50.6
VACL MAC -IP ACCESS-GROUP ........................................................................................................... 50-4
CHAPTER 51 COMMANDS FOR MIRRORING CONFIGURATION ..............................51-1
51.1 MONITOR SESSION SOURCE INTE RFACE ............................................................................................. 51-1
51.2
MONITOR SESSION SOURCE INTERFACE ACCESS-LIST ......................................................................... 51-1
51.3
MONITOR SESSIO N D ESTINATION INTERFACE ...................................................................................... 51-2
51.4
SHOW MONITOR ............................................................................................................................... 51-2
CHAPTER 52 COMMANDS FOR RSPAN CONFIGURATION ......................................52-1
52.1 REMOTE-SPAN ................................................................................................................................. 52-1
52.2
MONITOR SESSION REMOTE VLAN ..................................................................................................... 52-1
52.3
MONITOR SESSION REFLECTOR-PORT ................................................................................................ 52-1
CHAPTER 53 COMMANDS FOR SFLOW .....................................................................53-1
53.1 SFLOW D E STINATION ........................................................................................................................ 53-1
53.2
SFLOW AGENT-ADDRESS .................................................................................................................. 53-1
53.3
SFLOW PRIORITY .............................................................................................................................. 53-1
53.4
SFLOW HEADER-LEN ........................................................................................................................ 53-2
53.5
SFLOW DATA-LEN ............................................................................................................................. 53-2
53.6
SFLOW COUNTER-INTERVAL .............................................................................................................. 53-2
53.7
SFLOW RATE .................................................................................................................................... 53-3
53.8
SHOW SFLOW .................................................................................................................................. 53-3
CHAPTER 54 COMMANDS FOR VRRP ........................................................................54-1
54.1 ADVERTISEMENT-INTERVAL ............................................................................................................... 54-1
54.2
CIRCUIT-FAILOVER ........................................................................................................................... 54-1
54.3
DEBUG VRRP ................................................................................................................................... 54-1
54.4
DISABLE .......................................................................................................................................... 54-2
54.5
ENABLE ........................................................................................................................................... 54-2
54.6
INTERFACE ...................................................................................................................................... 54-3
54.7
PREEMPT-MODE ............................................................................................................................... 54-3
54.8
PRIORITY ......................................................................................................................................... 54-3
1-37
XGS3 Command Guide
54.9 ROUTER VRRP .................................................................................................................................. 54-4
54.10
SHOW VRRP ................................................................................................................................... 54-4
54.11
VIRTUAL-IP .................................................................................................................................... 54-5
CHAPTER 55 COMMANDS FOR IPV6 VRRPV3 CONFIGURATION ............................55-1
55.1 ADVERTISEMENT-INTERVAL ............................................................................................................... 55-1
55.2
CIRCUIT-FAILOVER ........................................................................................................................... 55-1
55.3
DEBUG IPV6 VRRP ............................................................................................................................ 55-2
55.4
DISABLE .......................................................................................................................................... 55-2
55.5
ENABLE ........................................................................................................................................... 55-2
55.6
PREEMPT-MODE ............................................................................................................................... 55-3
55.7
PRIORITY ......................................................................................................................................... 55-3
55.8
ROUTER IPV6 VRRP .......................................................................................................................... 55-3
55.9
SHOW IPV6 VRRP ............................................................................................................................. 55-4
55.10
VIRTUAL-IPV6 INTERFACE ............................................................................................................... 55-5
CHAPTER 56 COMMANDS FOR MRPP .......................................................................56-1
56.1 CONTROL-VLAN ............................................................................................................................... 56-1
56.2
CLEAR MRPP STATISTICS .................................................................................................................. 56-1
56.3
DEBUG MRPP ................................................................................................................................... 56-1
56.4
ENABLE ........................................................................................................................................... 56-2
56.5 FAIL-TIMER ...................................................................................................................................... 56-3
56.6
HELLO-TIMER ................................................................................................................................... 56-3
56.7
MRPP ENABLE .................................................................................................................................. 56-3
56.8
MRPP PORT-SCAN-MODE .................................................................................................................. 56-4
56.9
MRPP RING ...................................................................................................................................... 56-4
56.10
MRPP RING PRIMARY-PORT ............................................................................................................. 56-4
56.11
MRPP RING SECONDARY-PORT ........................................................................................................ 56-5
56.12
NODE-MODE .................................................................................................................................. 56-5
56.13
SHOW MRPP .................................................................................................................................. 56-6
56.14
SHOW MRPP STATISTICS ................................................................................................................. 56-6
CHAPTER 57 COMMANDS FOR ULPP ........................................................................57-1
57.1 CLEAR ULPP FLUSH COUNTER INTERFACE ......................................................................................... 57-1
57.2
CONTROL V LAN ................................................................................................................................ 57-1
57.3
DEBUG ULPP ERROR ........................................................................................................................ 57-1
57.4
DEBUG ULPP EVENT ......................................................................................................................... 57-2
57.5
DEBUG ULPP FLUSH CONTENT INTERFACE ......................................................................................... 57-2
57.6
DEBUG ULPP FLUSH {SEND | RECEIVE} INTERFACE ............................................................................. 57-2
57.7
DESCRIPTION ................................................................................................................................... 57-3
1-38
XGS3 Command Guide
57.8 FLUSH DISABLE ARP ......................................................................................................................... 57-3
57.9
FLUSH DISABLE MAC ........................................................................................................................ 57-4
57.10
FLUSH ENABLE ARP ....................................................................................................................... 57-4
57.11
FLUSH ENABLE MAC ....................................................................................................................... 57-4
57.12
PREEMPTION DELAY ....................................................................................................................... 57-5
57.13
PREEMPTION MODE ........................................................................................................................ 57-5
57.14
PROTECT VLAN-REFERENCE-INSTANCE ........................................................................................... 57-5
57.15
SHOW ULPP FLUSH COUNTER INTERFACE ........................................................................................ 57-6
57.16
SHOW ULPP FLUSH-RECEIVE-PORT ................................................................................................. 57-6
57.17
SHOW ULPP GROUP ........................................................................................................................ 57-6
57.18
ULPP CONTROL VLAN ..................................................................................................................... 57-7
57.19
ULPP FLUSH DISABLE ARP .............................................................................................................. 57-7
57.20
ULPP FLUSH DISABLE MAC .............................................................................................................. 57-8
57.21
ULPP FLUSH ENABLE ARP ............................................................................................................... 57-8
57.22
ULPP FLUSH ENABLE MAC .............................................................................................................. 57-8
57.23
ULPP GROUP ................................................................................................................................. 57-9
57.24
ULPP GROUP MASTER .................................................................................................................... 57-9
57.25
ULPP GROUP SLAVE ....................................................................................................................... 57-9
CHAPTER 58 COMMANDS FOR ULSM .......................................................................58-1
58.1 DEBUG ULSM EVENT ......................................................................................................................... 58-1
58.2 SHOW ULSM GROUP ......................................................................................................................... 58-1
58.3
ULSM GROUP ................................................................................................................................... 58-1
58.4
ULSM GROUP {UPLINK | DOWNLINK} .................................................................................................. 58-2
CHAPTER 59 COMMANDS FOR SNTP ........................................................................59-1
59.1 DEBUG SNTP .................................................................................................................................... 59-1
59.2
SNTP SERVER .................................................................................................................................. 59-1
59.3
SNTP POL LTIME ................................................................................................................................ 59-1
59.4
SNTP TIMEZONE ............................................................................................................................... 59-2
59.5
SHOW SNTP ..................................................................................................................................... 59-2
CHAPTER 60 COMMANDS FOR NTP ..........................................................................60-1
60.1 NTP ENABLE .................................................................................................................................... 60-1
60.2
NTP SERVER .................................................................................................................................... 60-1
60.3
NTP BROADCAST SERVER COUNT ...................................................................................................... 60-1
60.4
NTP TIMEZONE ................................................................................................................................. 60-2
60.5
NTP ACCESS-GROUP ........................................................................................................................ 60-2
60.6
NTP AUTHENTICATE .......................................................................................................................... 60-2
60.7
NTP AUTHENTICATION-KEY ............................................................................................................... 60-3
1-39
XGS3 Command Guide
60.8 NTP TRUSTED-KEY ........................................................................................................................... 60-3
60.9
NTP DISABLE ................................................................................................................................... 60-3
60.10
NTP BROADCAST CLIENT ................................................................................................................ 60-4
60.11
NTP MULTICAST CLIENT .................................................................................................................. 60-4
60.12
NTP IPV6 MULTICAST CLI ENT ........................................................................................................... 60-4
60.13
DEBUG NTP AUTHENTICATION ......................................................................................................... 60-5
60.14
DEBUG NTP PACKET ....................................................................................................................... 60-5
60.15
DEBUG NTP ADJUST ....................................................................................................................... 60-5
60.16
DEBUG NTP SYNC ........................................................................................................................... 60-6
60.17
DEBUG NTP EVENTS ....................................................................................................................... 60-6
60.18
SHOW NTP STATUS ......................................................................................................................... 60-6
60.19
SHOW NTP SESSION ....................................................................................................................... 60-7
CHAPTER 61 COMMANDS FOR DNSV4/V6 ................................................................61-1
61.1 CLEAR DYNAMIC-HOST ..................................................................................................................... 61-1
61.2
DEBUG DNS ..................................................................................................................................... 61-1
61.3
DNS-SERVER ................................................................................................................................... 61-1
61.4
DNS LOOKUP ................................................................................................................................... 61-2
61.5
SHOW DNS NAME-SERVER ................................................................................................................ 61-2
61.6
SHOW DNS DOMAIN-LIST ................................................................................................................... 61-3
61.7
SHOW DNS HOSTS ............................................................................................................................ 61-3
61.8 SHOW DNS CONFIG ........................................................................................................................... 61-3
61.9
SHOW DNS CLIENT ........................................................................................................................... 61-4
61.10
IP DOMAIN-LOOKUP ........................................................................................................................ 61-4
61.11
IP DOMAIN-LIST .............................................................................................................................. 61-4
61.12
IP DNS SERVER .............................................................................................................................. 61-5
61.13
IP DNS SERVER QUEUE MAXIMUM .................................................................................................... 61-5
61.14
IP DNS SERVER QUEUE TIMEOUT ..................................................................................................... 61-5
CHAPTER 62 COMMANDS FOR SHOW ......................................................................62-1
62.1 CLEAR LOGGING .............................................................................................................................. 62-1
62.2
LOGGING ......................................................................................................................................... 62-1
62.3
PING ................................................................................................................................................ 62-1
62.4
PING6 .............................................................................................................................................. 62-4
62.5
SHOW DEBUGGING ........................................................................................................................... 62-6
62.6
SHOW FLASH ................................................................................................................................... 62-7
62.7
SHOW HISTORY ................................................................................................................................ 62-7
62.8
SHOW LOGGING BUFFERED ............................................................................................................... 62-7
62.9
SHOW MEMORY ................................................................................................................................ 62-8
62.10
SHOW RUNNING-CONFIG ................................................................................................................. 62-8
1-40
XGS3 Command Guide
62.11 SHOW STARTUP-CONFIG ................................................................................................................. 62-9
62.12
SHOW SWITCHPORT INTERFACE ...................................................................................................... 62-9
62.13
SHOW TCP ................................................................................................................................... 62-10
62.14
SHOW TELNET LOGIN .................................................................................................................... 62-11
62.15
SHOW TEMPERATURE ................................................................................................................... 62-11
62.16
SHOW TECH-SUPPORT .................................................................................................................. 62-11
62.17
SHOW UDP ................................................................................................................................... 62-11
62.18
SHOW VERSION ............................................................................................................................ 62-12
62.19
TRACEROUTE .............................................................................................................................. 62-12
62.20
TRACEROUTE6 ............................................................................................................................ 62-13
CHAPTER 63 COMMANDS FOR RELO AD SWITCH AFTER SPECIFIED TIME .........63-1
63.1 RELOAD AFTER ................................................................................................................................ 63-1
63.2
RELOAD CANCEL ............................................................................................................................. 63-1
63.3
SHOW RELOAD ................................................................................................................................. 63-1
CHAPTER 64 COMMANDS FOR DEBUGGING AND DIAGNOSIS FOR PACKETS
RECEIVED AND SENT BY CPU ....................................................................................64-1
64.1 CPU-RX-RATELIMIT TOTAL ................................................................................................................. 64-1
64.2
CPU-RX-RATELIMIT QUEU E-LENGTH ................................................................................................... 64-1
64.3
CPU-RX-RATELIMIT PROTOCOL .......................................................................................................... 64-1
64.4
CLEAR CPU-RX-STAT PROTOCOL ....................................................................................................... 64-2
64.5 CPU-RX-RATELIMIT CHANNEL ............................................................................................................ 64-2
64.6
SHOW CPU-RX PROTOCOL ................................................................................................................ 64-2
64.7
DEBUG DRIVER ................................................................................................................................ 64-2
1-41
XGS3 Command Guide
Chapter 1 Commands for Basic Switch
Configuration

1.1 Commands for Basic Conf igur a tion

1.1.1 Authentication line

Command:
authentication line {console | sty | web} login {local | radius | tacos} No authentication line {console | sty | web} login
Function:
Configure VTY (login with Telnet and SSH), Web and Console, so as to select the priority of the authentication mode for the login user. The no form command restores the default authenticati on mode .
Default:
No configuration is enabled for the console login method by default. Local authentication is enabled for the VTY and Web login method by default.
Command Mode:
Global Mode.
Usage Guide:
The authentication method for Console, VTY and Web login can be configured respectively. And authentication method can be any one or combination of Local, RADIUS or TACCACS. When login method is configuration in combination, the preference goes from left to right. If the users have passed the authentication method, authentication method of lower preferences will be ignored. To be mentioned, if the user receives correspond protocol’s answer whether refuse or incept, it will not attempt the next authentication method (Exception: if the local authentication method failed, it will attempt the next authentication method); it will attempt the next authentication method if it receives nothing. And AAA function RADIUS server should be configured before the RADIUS configuration method can be used. And TACACS server should be configured before the TACACS configuration method can be used.
The authentication line console login command is exclusive with the login command. The authentication line console login command configures the switch to use the Console login method. And the login command makes the Console login to use the passwords configured by the password command for authentication. If local authentication is configured while no local users are configured, users will be able to login the switch via the Console method.
Example:
To configure the Telnet and ssh login method to use RADIUS authentication method.
Switch(config)# authenticat ion line vty login lo cal radi us
Relative Command:
aaa enable, radius-server authentication host, tacacs-server authentication host, tacacs-server key

1.1.2 boot img

Command:
boot img <img-file-url>primary | backup
1-42
XGS3 Command Guide
Function:
Configure the first and second img files used in the next boot of the main control boardcard.
Parameters: .
primary means to configure the first IMG file, backup means to configure the second IMG file, <img-file-url> is the full path of the booting IMG file, the format of which is as follows:
1. The file path comprises of two parts: device prefix used as the root directory (flash:/) and the file name. No space is allowed in each part or between two parts.
2. The suffix of all file names should be .img.
3. The length of the full file path should be no longer than 128 characters, while the file name no longer than 80 characters.
Command Mode:
Admin Mode.
Default:
The factory original configuration only specifies the first booting IMG file, the nos.img file in the FLASH, without the second one.
Example:
1. Set flash:/nos.img as the second booting IMG file used in the next booting of the syste m.
Switch#boot img fla sh:/nos. img backup
2. Set flash:/5.4.128.0_nos.img as the first booting IMG file used in the next booting of the system.
Switch#boot img flash:/5.4.128.0_nos.img primary

1.1.3 boot startup-config

Command:
boot startup-config { NULL | <file-url> }
1-43
XGS3 Command Guide
Function:
Configure the CGF file used in the next booting of the main control boardcard.
Parameters:
The NULL keyword means to use the factory original configuration as the next booting configuration. Setting the he CGF file used in the next booting as NULL equals to implementing “set default” and “write”. <file-url> is the ful l path of CGF file used in the next booting.
1. The file path compri se s of two parts: device prefix used as th e root dir e ctory ( fl ash :/) an d th e fil e name. No space
is allowed in each part or between two parts.
2. The suffix of all file names should be .cfg.
3. The length of the full file path should be no longer than 128 characters, while the file name no longer than 80
characters.
Command Mode:
Admin Mode.
Default Settings:
None.
Example:
1. Set flash:/ startup.cfg as the booting CFG file used in the next booting of the system.
Switch# boot startup-configflash:/ startup.cfg
2. Set flash:/ test-trunk.cfg as the booting CFG file used in the next booting of the system.
Switch#boot startup-config flash:/ test-trunk.cfg

1.1.4 clock set

Command:
clock set <HH:MM:SS> <YYYY.MM.DD>
Function:
Set system date and time.
Parameter:
<HH:MM:SS>is the current time, and the valid scope for HH is 0 to 23, MM and SS 0 to 59; <YYYY.MM.DD> is the current year, month and date, and the valid scope for YYYY is 1970~2038, MON meaning month, and DD between 1 to 31.
Command mode:
Admin Mode.
Default:
upon first time start-up, it is defaulted to 2001.1.1 0: 0: 0.
Usage guide:
The switch can not continue timing with power off, hence the current date and time must be first set at environments where exact time is required.
Example:
To set the switch current date and time to 2002.8.1 23: 0: 0:
Switch#clock set 23:0:0 2002.8.1
1-44
XGS3 Command Guide

1.1.5 config

Command:
config [terminal]
Function:
Enter Global Mode from Admin Mode.
Parameter:
[terminal] indicates terminal configuration.
Command mode:
Admin Mode
Example:
Switch#config

1.1.6 debug ssh-server

Command:
debug ssh-server no debug ssh-server
Function:
Display SSH server debugging information; the “no debug ssh-server” command stops displaying SSH server debugging information.
Default:
This function is disabled by default.
Command mode:
Admin Mode.
Example:
Switch#debug ssh-server

1.1.7 enable

Command:
enable disable
Function:
Enter Admin Mode from User Mode.
Command mode:
User Mode/ Admin Mode.
Usage Guide:
To prevent unauthorized access of non-admin user, user authentication is required (i.e. Admin user password is required) when entering Admin Mode from User Mode. If the correct Admin user password is entered, Admin Mode access is granted; if 3 consecutive entry of Admin user password are all wrong, it remains in the User Mode. Set the Admin user password under Global Mode with “enable password” command.
Example:
Switch>enable
1-45
XGS3 Command Guide
Switch#

1.1.8 enable password

Command:
enable passw ord [8] <password> no enable password
Function:
Configure the password used for enter Admin Mode from the User Mode, The “no enable password” command deletes this password.
Parameter:
password is the configured code. Encryption will be performed by entering 8.
Command mode:
Global Mode
Default:
This password is empty by system default
Usage Guide:
Configure this password to prevent unauthorized entering Admin Mode. It is recommended to set the password at the initial switch configuration. Also, it is recommended to exit Admin Mode with “exit” command when the administrator needs to leave the terminal for a long time.
Example:
Set the Admin user password to “admin”.
Switch(config)#enable p as sw or d 8 admin

1.1.9 end

Command:
end
Function:
Quit current mode and return to Admin mode when not at User Mode/ Admin Mode.
Command mode:
Except User Mode/ Admin Mode
Example:
Quit VLAN mode and return to Admin mode.
Switch(config-vlan1)#end Switch#

1.1.10 exec-timeout

Command:
exec-timeout <minutes> [<seconds>] no exec-timeout
Function:
1-46
XGS3 Command Guide
Configure the timeout of exiting admin mode. The “no exec-timeout” command restores the default value.
Parameters:
<minute> is the time value shown in minute and ranges between 0~35791.<seconds> is the time value shown in seconds and ranges between 0~2147483.
Command mode:
Global mode
Default:
Default timeout is 10 minutes.
Usage guide:
To secure the sw itch , as well to prevent malic iou s a ctio ns f ro m un authorized user , the time will be count from the last configuration the admin had m ade, an d the sy st em w ill exit the admin mode at due time. It is required to enter admin code and password to enter the admin mode again. The timeout timer will be disabled when the timeout is set to 0.
Example:
Set the admin mode timeout value to 6 minutes
Switch(config)#exec-timeout 6
Set the admin mode timeout value to 5 minutes, 30 seconds
Switch(config)#exec-timeout 5 30

1.1.11 exit

Command:
exit
Function:
Quit current mode and return to it’s previous mode.
Command mode:
All Modes
Usage Guide:
This command is to quit current mode and return to it’s previous mode.
Example:
Quit global mode to it’s previous mode
Switch#exit
Switch#

1.1.12 help

Command:
help
Function:
Output brief description of the command interpreter help system.
Command mode:
All configuration modes.
Usage Guide:
An instant online help provided by the switch. Help command displays information about the whole help system,
1-47
including complete help and partial help. The user can type in ? any time to get online help.
Example:
switch(config)#help
PLANETOS CLI provides advanced help feature. When you need help, anytime at the command line please press '?'. If nothing matches, the help list will be empty and you must backup until entering a '?' shows the available options. Two styles of help are provided:
1. Full help is available when you are ready to enter acommand argument (e.g. 'show ?') and describes each possible argument.
2. Partial help is provided when an abbreviated argument is entered and you want to know what arguments match the input (e.g. 'show ve?'.)
XGS3 Command Guide

1.1.13 hostname

Command:
hostname <hostname> no hostname
Function:
Set the prompt in the switch command line interface. The no operation cancels the configuration.
Parameter:
<hostname> is the string for the prompt, up to 30 characters are allowed.
Command mode:
Global Mode
Default:
The default prompt is relatived with the switch.
Usage Guide:
With this command, the user can set the CLI prompt of the switch according to their own requirements.
Example:
Set the prompt to “Test”.
Switch(config)#hostname Test
Test(config)#

1.1.14 ip host

Command:
ip host <hostname> <ip_addr> no ip host {<hostname>|all}
Function:
Set the mapping relationship between the host and IP address; the “no ip host” parameter of this command will
1-48
XGS3 Command Guide
delete the mapping.
Parameter:
<hostname> is the host name, up to 15 characters are allowed; <ip_addr> is the corresponding IP address for the host name, takes a dot decimal format; all is all of the host name.
Command mode:
Global Mode
Usage Guide:
Set the association between host and IP address, which can be used in commands like “ping <host>“.
Example:
Set IP address of a host with the hostname of “beijing” to 200.121.1.1.
Switch(config)#ip host beijing 200.121.1.1
Command related:
telnet, ping, traceroute

1.1.15 ipv6 host

Command:
ipv6 host <hostname> <ipv6_addr> no ipv6 host {<hostname>|all}
Function:
Configure the mapping relationship between the IPv6 address and the host; the “no ipv6 host <hostname>” command deletes this mapping relationship.
Parameter:
<hostname> is the name of the host, containing max 15 ch aracters;<ipv6_addr> is the IPv6 address corr e spo ndi ng to the host name.<all> is all the h ost addres s.
Command Mode:
Global Mode
Usage Guide:
Configure a fixed corresponding relationship between the host and the IPv6 address, applicable in commands such as “traceroute6 <host>”, etc.
Example:
Set the IPv6 address of the host named beijing to 2001:1:2:3::1
Switch(config)#ipv6 host beijing 2001:1:2:3::1
Command related:
ping6,traceroute6

1.1.16 ip http server

Command:
ip http server no ip http server
Function:
Enable Web configuration; the “no ip http server” command disables Web configuration
Command mode:
Global mode
1-49
XGS3 Command Guide
Usage guide:
Web configuation is for supplying a interface configured with HTTP for the user, which is straight and visual, esay to understand.
Example:
Enable Web Server function and enable Web configurations.
Switch(config)#ip http server

1.1.17 language

Command:
language {chinese | english}
Function:
Set the language for displaying the help information.
Parameter:
chinese for Chinese display; english for English display.
Command mode:
Admin and Config Mode.
Default:
The default setting is English display.
Usage Guide:
Switch provides help information in two languages, the user can select the language according to their preference. After the system restart, the help information display will revert to English.

1.1.18 login

Command:
login no login
Function:
login enable password authentication, no login command cancels the login configuration.
Command mode:
Global mode
Default:
No login by default
Usage guide:
By using this command, users have to enter the password set by password command to enter normal user mode with console; no login cancels this restriction.
Example:
Enable password
Switch(config)#login

1.1.19 password

Command:
password [8] <password>
1-50
XGS3 Command Guide
no password
Function:
Configure the pas sw or d us ed f or ent er n or ma l u ser mo de on the console. The “no password” command delete s this password.
Parameter:
password is the configured code. Encryption will be performed by entering 8.
Command mode:
Global mode
Default:
This password is empty by system default
Usage guide:
When both this password and login command are configured, users have to enter the password set by password command to enter normal user mode on console.
Example:
Switch(config)#password 8 test Switch(config)#login

1.1.20 reload

Command:
reload
Function:
Warm reset the switch.
Command mode:
Admin Mode.
Usage Guide:
The user can use this command to restart the switch without power off.

1.1.21 service password-encryption

Command:
service password-encryption no service password-encryption
Function:
Encrypt system password. T he “no serv ice password-encryption” command cancels the encryption.
Command mode:
Global Mode
Default:
No service password-encryption by system default
Usage guide:
The current unencrypted passwords as well as the coming passwords configured by password, enable password and username command will be encrypted by executed this command. no service password-encryption cancels this function however encrypted passwords remain unchanged.
Example:
Encrypt system passwords
Switch(config)#service password-encryption
1-51
XGS3 Command Guide

1.1.22 service terminal-length

Command:
service terminal-length <0-512> no service terminal-length
Function:
Configure the columns of characters displayed in each screen on terminal (vty). The “no service terminal-length” command cancels the screen shifting operation.
Parameter:
Columns of characters displayed on each screen of vty, ranging between 0-512.
Command mode:
Global Mode
Usage guide:
Configure the columns of characters displayed on each screen of the terminal. The columns of characters displayed on each screen on the telent.ssh client and the Console will be following this configuration.
Example:
Set the number of vty threads to 20.
Switch(config)#service terminal-length 20

1.1.23 sysContact

Command:
sysContact <LINE> no sysContact
Function:
Set the factory contact mode, the “no sysContact” command reset the switch to factory settings.
Parameter:
<LINE> is the prompt character string, range from 0 to 255 characters.
Command mode:
Global Mode
Default:
The factory settings.
Usage guide:
The user can set the factory contact mode bases the fact instance.
Example:
Set the factory contact mode to test.
Switch(config)#sysContact test

1.1.24 sysLocation

Command:
sysLocation <LINE> no sysLocation
Function:
1-52
XGS3 Command Guide
Set the factory address, the “no sysLocation” command reset the switch to factory settings.
Parameter:
<LINE> is the prompt character string, range from 0 to 255 characters.
Command mode:
Global Mode
Default:
The factory settings.
Usage guide:
The user can set the factory address bases the fact instance.
Example:
Set the factory address to test.
Switch(config)#sysLocation test

1.1.25 set default

Command:
set default
Function:
Reset the switch to factory settings.
Command mode:
Admin Mode.
Usage Guide:
Reset the switch to factory settings. That is to say, all configurations made by the user to the switch will disappear.
When the switch is restarted, the prompt will be the same as when the switch was powered on for the first time.
Note:
After the command, “write” command must be executed to save the operation. The switch will reset to factory settings after restart.
Example:
Switch#set default
Are you sure? [Y/N] = y
Switch#write Switch#reload

1.1.26 setup

Command:
setup
Function:
Enter the Setup Mode of the switch.
Command mode:
Admin Mode.
Usage Guide:
Switch provides a Setup Mode, in which the user can configure IP addresses, etc.
1-53

1.1.27 show clock

Command:
show clock
Function:
Display the curre nt syst e m cl o ck.
Command mode:
Admin and Configuration Mode.
Usage Guide:
If the system clock is inaccurate, user can adjust the time by examining the system date and clock.
Example:
Switch#show clock Current time is TUE AUG 22 110001 2002
Command related:
clock set
XGS3 Command Guide

1.1.28 show temperature

Command:
show temperature
Function:
Display the current temputerature of the switch CPU.
Command mode:
All mode.
Usage Guide:
This command is used to monitor the temperature of the switch CPU.
Example:
Display the current temperature of the switch CPU.
Switch(Config)#show temperature
Temperature: 47.0625

1.1.29 show tech-support

Command:
show tech-support
Function:
Display the operational information and the task status of the switch. The technique specialist use this command to diagnose whether the switch operate normally.
Command mode:
Admin and Configuration Mode.
Usage Guide:
This command is used to collect the relative information when the switch operation is malfunctioned.
Example:
1-54
XGS3 Command Guide
Switch#show tech-support

1.1.30 show version

Command:
show version
Function:
Display the version information of the switch.
Command mode:
Admin and Configuration Mode.
Usage Guide:
this command is used to show the v er si on in form ation of the switch, including the hardware version an d the sof t w ar e version information.
Example:
Switch#show version.

1.1.31 username

Command:
username <username> [privilege <privilege>] [password <0|7> <password>] no username <username>
Function:
Configure local login username and password along with its privilege level.
Parameter:
<username> is the name of the user. <privilege> is t he maximum privilege level of the commands that the user is
able to execute, its value is limited between 1 and 15, and 1 by default. <password> is the pass wor d for the us e r. If input option 7 on password setting, the p as sw ord is encry pte d; if input option 0, the password is not processed.
Command Mode:
Global Mode.
Usage Guide:
There are two available choices for the preferences of the registered commands in the switch. They are 1 and 15. Preference of 1 is for the commands of the normal user configuration mode. Preference of 15 is for the commands registered in modes other than the normal user configuration modes. 16 local users at most can be configured through this command, and the maximum length of the password should be no less than 32.
Notice:
The user can log in user and priority after the command configures, before issuing the command authentication line console login local, it should be made sure that at one user has be configured as preference level of 15, in order to login the switch and make configuration change s in pr ivileg ed mod e and gl obal m ode. If ther e are no conf igure d loca l users with preference level of 15, while only Local authentication is configured for the Console login method, the switch can be login without any authentication. When using the HTTP method to login the switch, only users with preference level of 15 can login the switch, users with preference level other than 15 will be denied.
Example:
Configure an administrator account named admin, with the preference level as 15. And configure two normal accounts with its preference level as 1. Then enable local authentication method. Above all the configurations, only the admin user is able to login the switch in privileged mode through Telnet or
1-55
XGS3 Command Guide
Console login method, user1 a nd user 2 ca n only log in the switch in normal user mode through the telnet and console login method. For HTTP login method, only the admin user can pass the authentication configuration, user1 and user2 will be denied.
Switch(config)#username admin privilege 15 password 0 admin
Switch(config)# username user1 privilege 1 password 7 user1
Switch(config)# username user2 password 0 user2
Switch(config)# authenticat ion line con so le logi n local

1.1.32 web language

Command:
web language {chinese | english}
Function:
Set the language for displaying the HTTP Server information.
Parameter:
chinese for Chinese display; english for English display.
Command mode:
Admin Mode
Default:
The default setting is English display.
Usage Guide:
The user can select the language according to their preference.

1.1.33 write

Command:
write
Function:
Save the currently configured p aram eters to the Flash memory.
Command mode:
Admin Mode.
Usage Guide:
After a set of configuration with desired functions, the setting should be saved to the Flash memory, so that the system can revert to the saved configuration automatically in the case of accidentally powered off or power failure. This is the equivalent to the copy running-config startup-config command.

1.2 Commands for Telnet

1.2.1 authentication ip access-class

Command:
authentication ip access-class {<num-std>|<name>} no authentication ip access-class Function:
1-56
XGS3 Command Guide
Binding standard IP ACL protocol to login with Telnet/SSH/Web; the no form command w ill can cel the binding ACL.
Parameters:
<num-std> is the access-clas s numb er for st andar d numer ic ACL, ranging between 1-99; <name> is the access-class name for standard ACL, the character string length is ranging between 1-32.
Default:
The binding ACL to Telnet/SSH/Web function is closed by default.
Command Mode:
Global Mode.
Example:
Binding standard IP ACL protocol to access-class 1.
Switch(config)#authenti cat ion i p acce ss-class 1

1.2.2 authentication ipv6 access-class

Command:
authentication ipv6 access-class {<num-std>|<name>} no authentication ipv6 access-class
Function:
Binding standard IPv6 ACL protocol to login with Telnet/SSH/Web; the no form command will cancel the binding ACL.
Parameters:
<num-std> is the access-class number for standard numeric ACL, ranging between 500-599; <name> is the access-class name for standard ACL, the character string length is ranging between 1-32.
Default:
The binding ACL to Telnet/SSH/Web function is closed by default.
Command Mode:
Global Mode.
Example:
Binding standard IP ACL protocol to access-class 500.
Switch(config)#authenti cat ion i pv 6 acces s-class 500

1.2.3 authentication line login

Command:
authentication line {console | vty | web} login {local | radius | tacacs} no authentication line {console | vty | web} login
Function:
Configure VTY (login with Telnet and SSH), Web and Console, so as to select the priority of the authentication mode for the login user. The no form command restores the default authentication mode.
Default:
No configuration is enabled for the console login method by default. Local authentication is enabled for the VTY and Web login method by default.
Command Mode:
Global Mode.
1-57
XGS3 Command Guide
Usage Guide:
The authentication method for Console, VTY and Web login can be configured respectively. And authentication method can be any one or combination of Local, RADIUS or TACACS. When login method is configuration in combination, the preference goes from left to right. If the users have passed the authentication method, authentication method of lower preferences will be ignored. To be mentioned, if the user receives correspond protocol’s answer whether refuse or incept, it will not attempt the next authentication method (Excepti on: if th e loc al authentication method failed, it will attempt the next authentication method); it will attempt the next authentication method if it receives nothing. And AAA function RADIUS server should be configured before the RADIUS configuration method can be used. And TACACS server should be configured before the TACACS configuration method can be used. The authentication line console login command is exclusive with the “login” command. The authentication line console login command c onfigures the sw itch to us e the Console login method. And the login command makes the Console login to use the passwords configured by the password command for authentication. If local authentication is configured while no local users are configured, users will be able to login the switch via the Console method.
Example:
Configure the remote login authentication mode to radius.
Switch(config)#authentication login radius
Relative Command:
aaa enable, radius-server authentication host, tacacs-server authentication host, tacacs-server key

1.2.4 authentication securityip

Command:
authentication securityip <ip no authentication securityip <ip-addr>
Function:
To configure the trusted IP address for Telnet and HTTP login method. The no form of this command will remove the trusted IP address configuration.
Parameters:
<ip-addr> is the trusted IP address of the client in dotted decimal format which can login the switch.
Default:
No trusted IP address is configured by default.
Command Mode:
Global Mode.
Usage Guide:
IP address of the client which can login the switch is not restricted before the trusted IP address is not configured. After the trusted IP addr es s is configured, only client s with trusted IP addr e ss es are able to login the switch. U p to 32 trusted IP addresses can be configured in the switch.
Example:
To configure 192.168.1.21 as the trusted IP address.
Switch(config)# authenticat ion sec urity ip 192.168.1.21
1-58
XGS3 Command Guide

1.2.5 authentication securityipv6

Command:
authentication securityipv6 <ipv6-addr> no authentication securityipv6 <ipv6-addr>
Function:
To configure the trusted IPv6 address for Telnet and HTTP login method. The no form of this command will remove the specified configuration.
Parameters:
<ipv6-addr> is the trusted IPv6 address which can login the switch.
Default:
No trusted IPv6 addresses are configured by default.
Command Mode:
Global Mode.
Usage Guide:
IPv6 address of the client which can login the switch is not restricted before the trusted IPv6 address is not configured. After the trusted IPv6 address is configu red, only clients w ith tr us ted IP v 6 addr e sse s ar e ab le to login the switch. Up to 32 trusted IPv6 addresses can be configured in the switch.
Example:
Configure the secure IPv6 address is 2001:da8:123:1::1.
Switch(config)# authenticat ion sec urity ipv 6 2001:da8:123:1::1

1.2.6 terminal length

Command:
terminal length <0-512> terminal no length
Function:
Set columns of characters displayed in each screen on terminal; the “terminal no length” cancels the screen switching operation and display content once in all.
Parameter:
Columns of characters displayed in each screen, ranging between 0-512 (0 refers to non-stop display).
Command mode:
Admin Mode.
Default:
Default columns is 25.
Usage guide:
Set columns of characters displayed in each screen on terminal, so that the-More-message will be shown when displayed information exceeds the screen. Press any key to show information in next screen. 25 columns by default.
Example:
Configure treads in each display to 20.
Switch#terminal length 20
1-59
XGS3 Command Guide

1.2.7 terminal monitor

Command:
terminal monitor terminal no monitor
Function:
Copy debugging messages to current display terminal; the “terminal no monitor” command restores to the default value.
Command mode:
Admin Mode.
Usage guide:
Configures whether the current debugging messages is displayed on this terminal. If this command is configured on telnet or SSH clients, debug messages will be sent to that client. The debug message is displayed on console by default.
Example:
Switch#terminal monitor

1.2.8 telnet

Command:
telnet {<ip-addr> | <ipv6-addr> | host <hostname>} [<port>]
Function:
Log on the remote host by Telnet
Parameter:
<ip-addr> is the IP address of the remote host, shown in dotted decimal notation; <ipv6-addr> is the IPv6 address
of the remo te host ; <hostname> is the name of the remote host, containing max 30 characters; <port> is the port number, ranging between 0~65535.
Command Mode:
Admin Mode.
Usage Guide:
This command is used when the switch is applied as Telnet client, for logging on remote host to configure. When a switch is applied as a Telnet client, it can only establish one TCP connection with the remote host. To connect to another remote host, the current TCP connection must be disconnected with a hotkey “CTRL+ \”. To telnet a host name, mapping relationship between the host name and the IP/IPv6 address should be previously configured. For required commands please refer to ip host and ipv6 host. In case a host corresponds to both an IPv4 and an IPv6 addresses, the IPv6 should be preferred when telneting this host name.
Example:
The switch Telnets to a remote host whose IP address is 20.1.1.1.
Switch#telnet 20.1.1.1 23
Connecting Host 20.1.1.1 Port 23 Service port is 23 Connected to 20.1.1.1 login:123 password:*** XGS3>
1-60
XGS3 Command Guide

1.2.9 telnet server enable

Command:
telnet server enable no telnet server enable
Function:
Enable the Telnet server function in the sw itch: the “ no tel net serv er enable” command disa bles the Telnet function in the switch.
Default:
Telnet server function is enab l ed by default .
Command mode:
Global Mode
Usage Guide:
This command is available in Console only. The administrator can use this command to enable or disable the Telnet client to login to the switch.
Example:
Disable the Telnet server function in the switch.
Switch(config)#no telnet serv er enable

1.2.10 telnet-server max-connection

Command:
telnet-server max-connection {<max-connection-number> | default}
Function:
Configure the max connection number supported by the Telnet service of the switch.
Parameters:
<max-connection-number>: the max connection number supported by the Telnet service, ranging from 5 to 16. The default option will restore the default configuration.
Default:
The system default value of the max connection number is 5.
Command Mode:
Global Mode
Usage Guide:
None.
Example:
Set the max connection number supported by the Telnet service as 10.
Switch(config)#telnet-server max-connection 10

1.2.11 ssh-server authentication-retries

Command:
ssh-server authentication-retries <authentication-retries>
1-61
XGS3 Command Guide
no ssh-server authentication-retries
Function:
Configure the number of times for retrying SSH authentication; the “no ssh-server authentication-retries” command restores the default number of times for retrying SSH authentication.
Parameter:
authentication-retries > is the number of times for retrying authentication; valid range is 1 to 10.
Command mode:
Global Mode
Default:
The number of times for retrying SSH authentication is 3 by default.
Example:
Set the number of times for retrying SSH authentication to 5.
Switch(config)#ssh-server authentication-retries 5

1.2.12 ssh-server enable

Command:
ssh-server enable no ssh-server enable
Function:
Enable SSH function on the switch; the “no ssh-server enable” command disables SSH function.
Command mode:
Global Mode
Default:
SSH function is disabled by default.
Usage Guide:
In order that the SSH client can log on the switch, the users need to configure the SSH user and enable SSH function on the switch.
Example:
Enable SSH function on the switch.
Switch(config)#ssh-server enable

1.2.13 ssh-server host-key create rsa

Command:
ssh-server host-key create rsa [modulus < modulus >]
Function:
Generate new RSA host key .
Parameter:
modulus is the modulus which is used to compute the host key; valid range is 768 to 2048. The default value is
1024.
Command mode:
Global Mode
Default:
The system uses the key generated when the ssh-server is started at the first time.
1-62
XGS3 Command Guide
Usage Guide:
This command is used to generate the new host key. When SSH client logs on the server, the new host key is used for authentication. After the new host key is generated and “write” command is used to save the configuration, the system uses this key for authentication all the time. Because it takes quite a long time to compute the new key and some clients are not compatible with the key generated by the modulus 2048, it is recommended to use the key which is generated by the default modulus 1024.
Example:
Generate new host key.
Switch(config)#ssh-server host-key create rsa

1.2.14 ssh-server max-connection

Command:
ssh-server max-connection { <max-connection-number>|default}
Function:
Configure the max connection number supported by the SSH service of the switch.
Parameters:
<max-connection-number>: the max connection number supported by the SSH service, ranging from 5 to 16. The default option will restore the defaul t configuration.
Default:
The system default value of the max connection number is 5.
Command Mode:
Global Mode
Usage Guide:
None.
Example:
Set the max connection number supported by the SSH service as 10.
Switch(config)#ssh-server max-connection 10

1.2.15 ssh-server timeout

Command:
ssh-server timeout <timeout> no ssh-server timeout
Function:
Configure timeout value for SSH authentication; the “no ssh-server timeout” command restores the default timeout value for SSH authentication.
Parameter:
<timeout> is timeout value; valid range is 10 to 600 seconds.
Command mode:
Global Mode
Default:
SSH authentication timeout is 180 seconds by default.
Example:
Set SSH authentication timeout to 240 seconds.
1-63
XGS3 Command Guide
Switch(config)#ssh-server timeout 240

1.2.16 ssh-user

Command:
ssh-user <username> password {0 | 7} <password> no ssh-user <username>
Function:
Configure the username and password of SSH client software for logging on the switch; the “no ssh-user <user-name>“ command deletes the username.
Parameter:
<username> is SSH client username. It can’t exceed 16 characters; <password> is SSH client password. It can’t exceed 32 characters; 0 | 7 stand for unencrypted password and encrypted password.
Command mode:
Global Mode
Default:
There are no SSH username and password by default.
Usage Guide:
This command is used to configure the authorized SSH client. Any unauthorized SSH clients can’t log on and configure the switch.
Example:
Set a SSH client which has “switch” as username and “switch” as password.
Switch(config)#ssh-user switch password 0 switch

1.2.17 show ssh-server

Command:
show ssh-server
Function:
Display SSH state and users which log on currently.
Command mode:
Admin Mode.
Example:
Switch#show ssh-server
ssh server is enabled ssh-server timeout 180s ssh-server authentication-retries 3 ssh-server max-connection number 6 ssh-server login user number 2

1.2.18 show ssh-user

Command:
show ssh-user
1-64
XGS3 Command Guide
Function:
Display the configured SSH usernames.
Command Mode:
Admin Mode.
Example:
Switch#show ssh-user test
Relative Command:
ssh-user, ssh-server enable, no ssh-server enable

1.2.19 show telnet login

Command:
show telnet login
Function:
Display the information of th e Telnet client which currently establish es a Telnet connection with the switch.
Command Mode:
Admin and Configuration Mode.
Usage Guide:
Check the Telnet client messages connected through Telnet with the switch.
Example:
Switch#show telnet login
Authenticate login by local Login user: aa

1.3 Commands for Configuring Switch IP

1.3.1 interface vlan

Command:
interface vlan <vlan-id> no interface vlan <vlan-id>
Function:
Enter the VLAN interface configuration mode; the no operation of this command will delete the existing VLAN interface.
Parameters:
<vlan-id> is the VLAN ID of an existing VLAN, ranging from 1 to 4094.
Command Mode:
Global Configuration Mode.
Usage Guide:
Users should first make sure the existence of a VLAN before configuring it. User “exit” command to quit the VLAN interface configuration mode back to the globa l confi guration mode.
Example:
Enter the VLAN interface configuration mode of VLAN1.
1-65
XGS3 Command Guide
Switch(config)#interfac e vlan 1 Switch(Config-if-Vlan1)#

1.3.2 interface ethernet 0

This command is not supported by the switch.

1.3.3 ip address

Command:
ip address <ip-address> <mask> [secondary] no ip address [<ip-address> <mask>] [secondary]
Function:
Set the IP address and mask for the specified VLAN interface; the “no ip address <ip address> <mask> [secondary]” command deletes the specified IP address setting.
Parameter:
<ip-address> is the IP address in dot decimal format; <mask> is the subnet mask in dot decimal format;
[secondary] indicates the IP configured is a secondary IP address.
Default:
No IP address is configured upon switch shipment.
Command mode:
VLAN Interface Mode
Usage Guide:
A VLAN interface must be created first before the user can assign an IP address to the switch.
Example:
Set 10.1.128.1/24 as the IP address of VLAN1 interface.
Switch(config)#interface vlan 1 Switch(Config-if-Vlan1)#ip address 10.1.128.1 255.255.255.0 Switch(Config-if-Vlan1)#exit Switch(config)#
Relative Command:
ip bootp-client enable, ip dhcp-client enable

1.3.4 ipv6 address

Command:
ipv6 address <ipv6address | prefix-length> [eui-64] no ipv6 address <ipv6address | prefix-length> [eui-64]
Function:
Configure aggregatable global unicast address, site-local address and link-local address for the interface.
Parameters:
<ipv6address> is the prefix of an IPV6 address; <prefix-length>is the length of the prefix of an IPV6 address, ranging from 3 to 128; eui-64 means that the eui64 interface id of the interface will automatically create an IPV6 address.
1-66
XGS3 Command Guide
Command Mode:
Interface Configuration Mode.
Default
None.
Usage Guide:
The prefix of an IPV6 address should not be a multicast address, or other kinds of IPV6 addresses with specific usage. Different layer-three VLAN interfaces are forbidden to share a same address prefix. As for any global unicast address, the prefix should be limited in the range from 2001:: to 3fff ::,with a length no shorter than 3. And the prefix length of a site-local address or a link-local address should not be shorter than 10.
Examples:
Configure an IPV6 address at the layer-three interface of VLAN1: set the prefix as 2001:3f:ed8::99, the length of which is 64.
Switch(Config-if-Vlan1)#ipv6 address 2001:3f:ed8::99/64

1.3.5 ip bootp-client enable

Command:
ip bootp-client enable no ip bootp-client enable
Function:
Enable the switch to be a BootP Client and obtain IP address and gateway address through BootP negotiation; the “no ip bootp-client enable” command disables the BootP Client function and releases the IP address obtained in BootP.
Default:
BootP client function is disabled by default.
Command mode:
VLAN Interface Mode
Usage Guide:
Obtaining IP address through BootP, Manual configuration and DHCP are mutually exclusive, enabling any two methods for obtaining IP address is not allowed. Note: To obtain IP address via BootP, a DHCP server or a BootP server is required in the network.
Example:
Get IP address through BootP.
Switch(config)#interface vlan 1 Switch(Config-if-Vlan1)#ip bootp-client enable Switch (Config-if-Vlan1)#exit Switch(config)#
Relative command:
ip address, ip dhcp-client enable

1.3.6 ip dhcp-client enable

Command:
ip dhcp-client enable
1-67
XGS3 Command Guide
no ip dhcp-client enable
Function:
Enables the switch to be a DHCP client and obtain IP address and gateway address through DHCP negotiation; the “no ip dhcp-client enable” command disables the DHCP client function and releases the IP address obtained in DHCP. Note: To obtain IP address via DHCP, a DHCP server is required in the network.
Default:
the DHCP client function is disabled by default.
Command mode:
VLAN Interface Mode
Usage Guide:
Obtaining IP address by DHCP, Manual configuration and BootP are mutually exclusive, enabling any 2 methods for obtaining an IP address is not allowed.
Example:
Getting an IP address through DHCP.
Switch(config)#interfac e vlan 1 Switch(Config-if-Vlan1)#ip dhcp-client enable Switch(Config-if-Vlan1)#exit Switch(config)#

1.4 Commands for SNMP

1.4.1 debug snmp mib

Command:
debug snmp mib no debug snmp mib
Function:
Enable the SNMP mib debugging; the "no debug snmp mib” command disables the debugging.
Command Mode:
Admin Mode.
Usage Guide:
When user encounters problems in applying SNMP, the SNMP debugging is available to locate the problem causes.
Example:
Switch#debug snmp mib

1.4.2 debug snmp kernel

Command:
debug snmp kernel no debug snmp kernel
Function:
Enable the SNMP kernel debugging; the “no debug snmp kernel” command disables the debug gin g fu nct ion.
Command Mode:
Admin Mode.
1-68
XGS3 Command Guide
Usage Guide:
When user encounters problems in applying SNMP, the SNMP debugging is available to locate the problem causes.
Example:
Switch#debug snmp kernel

1.4.3 rmon enable

Command:
rmon enable no rmon enable
Function:
Enable RMON; the “no rmon enable” command disables RMON.
Command mode:
Global Mode
Default:
RMON is disabled by default.
Example:
Enable RMON.
Switch(config)#rmon enable
Disable RMON.
Switch(config)#no rmon enabl e

1.4.4 show snmp

Command:
show snmp
Function:
Display all SNMP counter information.
Command mode:
Admin and Configuration Mode.
Example:
Switch#show snmp
0 SNMP packets input 0 Bad SNMP version errors 0 Unknown community name
0 Illegal operation for community name supplied 0 Encoding errors 0 Number of requested variables 0 Number of altered variables 0 Get-request PDUs 0 Get-next PDUs 0 Set-request PDUs 0 SNMP packets output
1-69
0 Too big errors (Max packet size 1500) 0 No such name error s 0 Bad values errors 0 General errors 0 Get-response PDUs 0 SNMP trap PDUs
Displayed information Explanation
snmp packets input Total number of SNMP packet inputs.
bad snmp version errors Number of version information error packets.
unknown community name Number of community name error packets.
illegal operation for community name supplied Number of permission for community name error packets.
encoding errors Number of encoding error packets.
number of requested variable Number of variables requested by NMS.
number of altered variables Number of variables set by NMS.
get-request PDUs Number of packets received by “get” requests.
get-next PDUs Number of packets received by “getnext” requests.
set-request PDUs Number of packets received by “set” requests.
snmp packets output Total number of SNMP packet outputs.
XGS3 Command Guide
1-70
too big errors Number of “Too_ big” error SNMP packets.
maximum packet siz e Maximum length of SNMP packets.
no such name errors Number of packets requesting for non-existent MIB objects.
bad values errors Number of “Bad_values” error SNMP packets.
general errors Number of “General_errors” error SNMP packets.
response PDUs Number of response packets sent.
trap PDUs Number of Trap p ac kets sent.
XGS3 Command Guide

1.4.5 show snmp engineid

Command:
show snmp engineid
Function:
Display the engine ID commands.
Command Mode:
Admin and Configuration Mode.
Example:
Switch#show snmp engineid
SNMP engineID:3138633303f1276c Engine Boots is:1
Displayed Information Explanation
SNMP engineID Engine number
Engine Boots Engine boot counts
1-71

1.4.6 show snmp group

Command:
show snmp group
Function:
Display the group information comman ds.
Command Mode:
Admin and Configuration Mode.
Example:
Switch#show snmp group
Group Name:initial Security Level:noAuthnoPriv Read View:one Write View:<no writeview specified> Notify View:one
XGS3 Command Guide
Displayed Information Explanation
Group Name Group name
Security level Security level
Read View Read view name
Write View Write view name
Notify View Notify view name
<no writeview specified> No view name specified by the user

1.4.7 show snmp mib

Command:
show snmp mib
Function:
1-72
Display all MIB supported by the switch.
Command Mode:
Admin and Configuration Mode.

1.4.8 show snmp status

Command:
show snmp status
Function:
Display SNMP configuration information.
Command mode:
Admin and Configuration Mode.
Example:
Switch#show snmp status
Trap enable RMON enable Community Information: V1/V2c Trap Host Information: V3 Trap Host Information: Security IP Information:
XGS3 Command Guide
Displayed information Description
Community string Community string
Community access Community access permission
Trap-rec-address IP address which is used to receive T rap.
Trap enable Enable or disable to send Trap.
SecurityIP IP address of the NMS which is allowed to access Agent
1-73

1.4.9 show snmp user

Command:
show snmp user
Function:
Display the user information command s.
Command Mode:
Admin and Configuration Mode.
Example:
Switch#show snmp user
User name: initialsha Engine ID: 1234567890 Auth Protocol:MD5 Priv Protocol:DES-CBC Row status:active
Displayed Information Explanation
User name User name
Engine ID Engine ID
Priv Protocol Employed encryption algorithm
Auth Protocol Employed identification algorithm
Row status User state
XGS3 Command Guide

1.4.10 show snmp view

Command:
show snmp view
Function:
Display the view information commands.
Command Mode:
Admin and Configuration Mode.
Example:
Switch#show snmp view
1-74
View Name:readview 1. -Included active
1.3. Excluded active
Displayed Information Explanation
View Name View name
1.and1.3. OID number
Included The view includes sub trees rooted by this OID
Excluded The view does not include sub trees rooted by this OID
active State
XGS3 Command Guide

1.4.11 snmp-server community

Command:
snmp-server community {ro | rw} <string> [access {<num-std>|<name>}] [ipv6-access
{<ipv6-num-std>|<ipv6-name>}] [read <read-view-name>] [write <write-view-name>]
no snmp-server community <string> [access {<num-std>|<name>}] [ipv6-access {<ipv6-num-std>|<ipv6-name>}]
Function:
Configure the community string for the switch; the “no snmp-server community <string> [access {<num-std>|<name>}] [ipv6-access {<ipv6-num-std> |<ipv6-name>}] “command deletes the configured
community string.
Parameter:
<string> is the community string set;
ro | rw is the specified access mode to MIB, ro for read-only and rw for read-write.
<num-std> is the access-class number for standard numeric ACL, ranging between 1-99; <name> is the access-class name for standard ACL, the character string length is ranging between 1-32; <ipv6-num-std> is the access-class number for stan dard numer ic IPv6 ACL, ranging between 500-599; <name> is the access-class name for standard IPv6 ACL, the character string length is ranging between 1-32. <read-view-name> is the name of readable view which includes 1-32 charact ers . <write-view-name> is the name of writable view which includes 1-32 characters.
Command mode:
1-75
XGS3 Command Guide
Global Mode
Usage Guide:
The switch supports up to 4 community strings. It can realize the access-control for specifically community view by binding the community name to specifically readable view or writable view.
Example:
Add a community string named “private” with read-write permission.
Switch(config)#snmp-server community private rw
Add a community string named “public” with read-only permission.
Switch(config)#snmp-server community public ro
Modify the read-write community string named “private” to read-only.
Switch(config)#snmp-server community private ro
Delete community string “private”.
Switch(config)#no snmp-server community private
Bind the read-only community str in g “public” to readable view “pviewr”.
Switch(config)#snmp-server community ro public read pviewr
Bind the read-write community string “private” to readable view “pviewr” and writable view “pvieww”.
Switch(config)#snmp-server community rw private read pviewr write pvieww

1.4.12 snmp-server enable

Command:
snmp-server enable no snmp-server enable
Function:
Enable the SNMP proxy server function on the switch. The “no snmp-server enable” command disables the SNMP proxy server function
Command mode:
Global mode
Default:
SNMP proxy server function is disabled by system default.
Usage guide:
To perform conf igur a tion m ana geme nt on the switch with ne t work manage software, t he S NMP proxy serv er funct ion
has to be enabled with this command.
Example:
Enable the SNMP proxy server function on the switch.
Switch(config)#snmp-server enable
1-76
XGS3 Command Guide

1.4.13 snmp-server enable traps

Command:
snmp-server enable traps no snmp-server enable traps
Function:
Enable the switch to sen d Trap message; the “no snmp-server enable t raps” command di s able s th e sw it c h to se nd Trap message.
Command mode:
Global Mode
Default:
Trap message is disabled by default.
Usage Guide:
When Trap me ss age i s e nab led, if Down/Up in d ev ice ports or of syste m oc curs , t he device will send Trap messages to NMS that receives Trap messages.
Example:
Enable to send T r ap message s.
Switch(config)#snmp-server enable traps
Disable to send Trap me ssa ge s.
Switch(config)#no snmp-server enable traps

1.4.14 snmp-server engineid

Command:
snmp-server engineid <engine-string> no snmp-server engineid
Function:
Configure the engine ID; the “no" form of this command restores to the default engine ID.
Command Mode:
Global mode
Parameter:
<engine-string> is the engine ID shown in 1-32 digit hex characters.
Default:
Default value is the company ID plus local MAC address.
Usage Guide:
None
Example:
Set current engine ID to A6 66 88999 F
Switch(config)#snmp-ser ver engineid A66688999F
Restore the default engine ID
Switch(config)#no snmp-server engineid
1-77
XGS3 Command Guide

1.4.15 snmp-server group

Command:
snmp-server group <group-string> {NoauthNopriv | AuthNopriv | AuthPriv} [[read <read-string>] [write <write-string>] [notify <notify-string>]] [access {<num-std>|<name>}] [ipv6-access {<ipv6-num-std>|<ipv6-name>}] no snmp-server group <group-string> {NoauthNopriv | AuthNopriv | AuthPriv} [access {<num-std>|<name>}] [ipv6-access {<ipv6-num-std>|<ipv6-name>}]
Function:
This command is used to configure a new group; the “no” form of this command deletes this group.
Command Mode:
Global Mode
Parameter:
<group-string> group name which includes 1-32 characters NoauthNopriv Applies the non recognizing and non encrypting safety level AuthNopriv Applies the recognizing but non encrypting safety level AuthPriv Applies the recognizing and encrypting safety level read-string Name of readable view which includes 1-32 characters write-string Name of writable view which includes 1-32 characters notify-string Name of trappable view which includes 1-32 ch aract ers
<num-std> is the access-class number for standard numeric ACL, ranging between 1-99; <name> is the access-class name for standard ACL, the character string length is ranging between 1-32; <ipv6-num-std> is the access-class number for standard numeric IPv6 ACL, ranging between 500-599; <name> is the access-class name for standard IPv6 ACL, the character string length is ranging between 1-32.
Usage Guide:
There is a default view “v1defaultviewname” in the system. It is recommended to use this view as the view name of
the notification. If the read or write view name is empty, corresponding operation will be disabled.
Example:
Create a group CompanyGroup, with the safety level of recognizing andencrypting, the read viewname isreadview,
and the writing is disabled.
Switch (config)#snmp-server group CompanyGroup AuthPriv read readview
deletet group
Switch (config)#no snmp-server group CompanyGroup AuthPriv

1.4.16 snmp-server host

Command:
snmp-server host { <host-ipv4-address> | <host-ipv6-address> } {v1 | v2c | {v3 {NoauthNopriv | AuthNopriv |
AuthPriv}}} <user-string>
no snmp-server host { <host-ipv4-address> | <host-ipv6-address> } {v1 | v2c | {v3 {NoauthNopriv |
AuthNopriv | AuthPriv}}} <user-string>
Function:
As for the v1/v2c versi ons th is com mand conf igure s the IPv4 or IPv6 address and Trap community character string of
the network manage station receiving the SNMP Trap message. And for v3 version, this command is used for
1-78
XGS3 Command Guide
receiving the network manage st ation IPv4 or IPv6 address and the T r ap user name and saf ety lev el; the “no” form o f
this command cancels this IPv4 or IPv6 address.
Command Mode:
Global Mode.
Parameter:
<host-ipv4-addr> | <host-ipv6-addr> is the IP address of the NMS managing station which receives Trap message.
v1 | v2c | v3 i s the version number when sending the trap. NoauthNopriv | AuthNopriv | AuthPriv is the safety level v3 trap is applied, which may be non encrypted and non
authentication, non encrypted and authentication, encrypted and authentication. <user-string> i s the community character string applied when sending the Trap message at v1/v2, and will be the user name at v3.
Usage Guide:
The Community character string configured in this command is the default community string of the RMON event
group. If the RMON event group has no community character string configured, the community character string
configured in this command will be applied when se nding the Trap of RMON, and if the com munity character string i s
configured, its configuration will be applied when sending the RMON trap. This command allows configuration the
IPv4 or IPv6 address of the network manage station receiving the SNMP Trap message, but configure the version
number as v1 and v2c of the IPv4 and IPv6 address are less than 8 in all.
Example:
Configure an IP address to receive Trap
Switch(config)#snmp-server host 1.1.1.5 v1 usertrap
Delete a Trap receiv in g IPv6 address
Switch(config)#no snmp-server host 2001:1:2:3::1 v1 usertrap

1.4.17 snmp-server securityip

Command:
snmp-server securityip {<ipv4-address> | <ipv6-address>} no snmp-server securityip {<ipv4-address> | <ipv6-address>}
Function:
Configure to permit to access security IPv4 or IPv6 address of the switch NMS administration station; the no
command deletes configured security IPv4 or IPv6 address.
Command Mode:
Global Mode.
Parameter:
<ipv4-address> is NMS security IPv4 address, point separated decimal format. <ipv6-address> is NMS security IPv6 address, colon separated hex format.
Usage Guide:
It is only the consistency between NMS administration station IPv4 or IPv6 address and security IPv4 or IPv6
address configured by the command, so it send SNMP packet could be processed by switch, the com mand only
applies to SNMP. Allows configuration the IPv4 or IPv6 address of the network manage station receiving the SNMP
Trap message, but the IP addresses are less than 6 in all.
Example:
1-79
Configure security IP address of NMS administration station
Switch(config)#snmp-server securityip 1.1.1.5
Delete security IPv6 address
Switch(config)#no snmp-server securityip 2001::1

1.4.18 snmp-server securityip

Command:
snmp-server securityip {enable | disable}
Function:
Enable/disable the safety IP address authentication on NMS manage station.
Command Mode:
Global Mode
Default:
Enable the safety IP address authentication function.
Example:
Disable the safety IP address authentication function.
XGS3 Command Guide
Switch(config)#snmp-server securityip disable

1.4.19 snmp-server view

Command:
snmp-server view <view-string> <oid-string> {include | exclude}
no snmp-server view <view-string> [ <oid-string> ]
Function:
This command is used to create or renew the view information; the “no" form of this command deletes the view
information.
Command Mode:
Global Mode.
Parameter:
<view-string> view name, contain ing 1-32 characters.
<oid-string>is OID number or corresponding node name, containing 1-255 characters.
include | exclude, include/exclude this OID.
Usage Guide:
The command supports not only the input using the character string of the variable OID as parameter. But also
supports the input using the node name of the parameter.
Example:
Create a view, the name is readview, including iso node but not including the iso.3 node
Switch (config)#snmp-server view readview iso include
Switch (config)#snmp-server view readview iso.3 exclude
Delete the view
1-80
XGS3 Command Guide
Switch (config)#no snmp-server view readview

1.4.20 snmp-server user

Command:
snmp-server user <use-string> <group-string> [{authPriv | authNoPriv} auth {md5 | sha} <word>] [access
{<num-std>|<name>}] [ipv6-access {<ipv6-num-std>|<ipv6-name>}]
no snmp-server user <user-string> [access {<num-std>|<name>}] [ipv6-access
{<ipv6-num-std>|<ipv6-name>}]
Function:
Add a new user to an SNMP group; the "no” form of this command deletes this user.
Command Mode:
Global Mode.
Parameter:
<user-string> is the user name containing 1-32 characters.
<group-string> is the name of the group the user belongs to, containing 1-32 characters.
authPriv use DES for the packet encryption. authNoPriv not use DES for the packet encryption. auth perform packet authentication. md5 packet authentication using HMAC MD5 algorithm. sha packet authentication using HMAC SHA algorithm.
<word > user password, containing 8-32 character. <num-std> is the access-class number for standard numeric ACL, ranging between 1-99; <name> is the access-class name for standard ACL, the character string length is ranging between 1-32; <ipv6-num-std> is the access-class number for standard numeric IPv6 ACL, ranging between 500-599; <name> is the access-class name for standard IPv6 ACL, the character string length is ranging between 1-32.
Usage Guide:
If the encryption and a ut he nti c ation is not selected, the defau lt s et tin gs will be no encryption and no authentication. If
the encryption is selected, the authentication must be done. When deleting a user, if correct username and incorrect
group name is inputted, the user can still be deleted.
Example:
Add a new user tester in the UserGroup with an encryption safety level and HMAC md5 for authentication, the
password is hellohello
Switch (config)#snmp-server user tester UserGroup authPriv auth md5 hellohello
deletes an User
Switch (config)#no snmp-server user tester

1.5 Commands for Sw itch Upgrad e

1.5.1 copyFTP

Command:
copy <source-url> <destination-url> [ascii | binary]
Function:
1-81
XGS3 Command Guide
Download files to the FTP client.
Parameter:
<source-url> is the location of the source files or directories to be copied; <destination-url> is the destination
address to which the files or directories to be copied; forms of <source-url> and <destination-url> vary depending
on different locations of the files or directories. ascii indicates the ASCII standard will be adopted; binary indicates
that the binary system will b e adopt ed in th e file t ransm ission defau lt transm issio n method . When URL repr esent s
an FTP address, its form should be:
ftp://<username>:<password>@{<ipaddress>|<ipv6address>|<hostname> }/<filename>,amongst <username> is the
FTP user name,<password> is t he FTP user password,<ipaddress>|<ipv6address> is the IPv4 or IPv6 address of
the FTP server/client,<hostname> is the name of the host mapping with the IPv6 address,it does not support the file
download and upload with hosts mapping with IPv4 addresses,<filename> is the name of the FTP upload/download
file.
Special keywords of the filename
Keywords Source or destination addresses
running-config
Running configuration fil es
startup-config
Startup configuration files
nos.img
System files
nos.rom
System startup files
Command Mode:
Admin Mode.
Usage Guide:
This command supports command line hints, namely if the user can enter commands in following forms: copy <filename> ftp:// or copy ftp:// <filename> and press Enter, following hints will be provided by the system ftp server ip/ipv6 address [x.x.x.x]/[x:x::x:x] > ftp username> ftp password> ftp filename> Requesting for FTP server address, user name, password and file name
Examples:
(1) Save images in the FLA SH to the FTP server of 10.1.1.1, FTP server userna me is Switch, password is s uperuser
Switch#copy nos.img ftp://Switch:superuser@10.1.1.1/nos.img
(2) Obtain system file nos.img from the FTP server 10.1.1.1, the username is Switch, password is superuser
Switch#copy ftp://Switch:superuser@10.1.1.1/nos.img nos.img
1-82
XGS3 Command Guide
Running configuration
Startup configuration
(3) Save images in the FLASH to the FTP server of 2004:1:2:3::6
Switch#copy nos.img ftp://username:password@2004:1:2:3::6/ nos.img
(4) Obtain system file nos.img from the FTP server 2004:1:2:3::6
Switch#copy ftp:// userna me:password@2004:1:2:3:: 6/nos.img nos.img
(5) Save the running configuration files
Switch#copy running-config startup-config
Relevant Command:
Write

1.5.2 copyTFTP

Command:
copy <source-url> <destination-url> [ascii | binary]
Function:
Download files to the TFTP client.
Parameter:
<source-url> is the location of the source files or directories to be copied; <destination-url> i s the destinat ion
address to which the files or directories to be copied; forms of <source-url> and <destination-url> vary depending
on different locations of the files or directories. ascii indicates the ASCII standard will be adopted; binary indicates
that the binary system will b e adopt ed in th e file t ransm ission defau lt transm issio n method . When URL repr esent s
an TFTP address, its form should be: tftp://{<ipaddress>|<ipv6address>|<hostname>}/<filename>, amongst
<ipaddress>| <ipv6address> is the IPv4 or IPv6 address of the TFTP server/client, <hostname> is the name of the
host mapping with the IPv6 address, it does not support the file download and upload with hosts mapping with IPv4
addresses,<filename> is the name of the TFTP upload/download file.
Special keyword of the filename
Keywords Source or destination addresses
running-config
files
startup-config
files
nos.img
System files
nos.rom
System startup files
1-83
XGS3 Command Guide
Command Mode:
Admin Mode.
Usage Guide:
This command supports command line hints, namely if the user can enter commands in following forms: copy <filename> tftp:// or copy tftp:// <filename> and press Enter, following hints will be provided by the system: tftp server ip/ipv6 address[x.x.x.x]/[x:x::x:x]> tftp filename> Requesting for TFTP server address, file name
Example:
(1) Save images in the FLASH to the TFTP server of 10.1.1.1
Switch#copy nos.img tftp://10.1.1.1/nos.img
(2) Obtain system file nos.img from the TFTP server 10.1.1.1
Switch#copy tftp:// 10.1 . 1.1 /no s . img nos.i mg
(3) Save images in the FLASH to the TFTP server of 2004:1:2:3::6
Switch#copy nos.img tftp:// 2004:1:2:3::6/ nos.img
(4) Obtain system file nos.img from the TFTP server 2004:1:2:3::6
Switch#copy tftp:// 2004:1:2:3::6/nos.img nos.img
(5) Save the running configuration files
Switch#copy running-config startup-config
Relevant Command:
Write

1.5.3 ftp-dir

Command:
ftp-dir <ftp-server-url>
Function:
Browse the file list on the FTP server.
Parameter:
The form of <ftp-server-url> isftp://<username>:<password>@{ <ipv4address> | <ipv6address> }, amongst
<username> is the FTP user name, <password> is the FTP user password, { <ipv4address> | <ipv6address> } is the
IPv4 or IPv6 address of the FTP server.
Command Mode:
Admin Mode
Example:
Browse the list of the files on the server with the FTP client, the username is “Switch”, the password is “superuser”
Switch#ftp-dir ftp://Switch:superuser @10.1.1.1.
1-84
XGS3 Command Guide

1.5.4 ftp-ser ver enable

Command:
ftp-server enable
no ftp-server enable
Function:
Start FTP server, the “no ftp-server enable” command shuts down FTP server and prevents FTP user from logging
in.
Default:
FTP server is not started by default.
Command mode:
Global Mode
Usage Guide:
When FTP server function is enabled, the switch can still perform ftp client functions. FTP server is not started by
default.
Example:
enable FTP server service.
Switch#config Switch(config)# ftp-server enable
Relative command:
ip ftp

1.5.5 ftp-ser ver timeout

Command:
ftp-server timeout <seconds>
Function:
Set data connection idle time.
Parameter:
<seconds> is the idle time threshold (in seconds) for FTP connection, the valid range is 5 to 3600.
Default:
The system default is 600 seconds.
Command mode:
Global Mode
Usage Guide:
When FTP data connection idle time exceeds this limit, the FTP management connection will be disconnected.
Example:
Modify the idle threshold to 100 seconds.
Switch#config Switch(config)#ftp-server timeout 100

1.5.6 ip ftp

Command:
1-85
XGS3 Command Guide
ip ftp username <username> password [type {0 | 7}] <password>
no ip ftp username <username>
Function:
Configure the username and password for logging in to the FTP; the no operation of this command will delete the
configured username and password simultaneously.
Parameters:
<username> is the username of the FTP link, no longer than 16 characters; 0 | 7 represent displaying the password
in ciphertext or plaintext; <password> is the password of the FTP link, no longer than 16 characters.
Default Settings:
the system uses anonymous FTP links by default.
Command Mode:
Global Configuration Mode.
Examples:
Configure the username as Switch and the password as superuser.
Switch#
Switch#config
Switch(config)#ip ftp username Switch password 0 superuser
Switch(config)#

1.5.7 show ftp

Command:
show ftp
Function:
Display the parameter settings for the FTP server.
Command mode:
Admin and Configuration Mode.
Default:
No display by default.
Example:
Switch#show ftp
Timeout : 600 Displayed information Description
Timeout Timeout time.

1.5.8 show tftp

1-86
Command:
show tftp
Function:
Display the parameter settings for the TFTP server.
Default:
No display by default.
Command mode:
Admin and Configuration Mode.
Example:
Switch#show tftp
timeout : 60
Retry T imes : 10
Displayed information Explanation
Timeout Timeout time.
Retry T imes Retransmission times.
XGS3 Command Guide

1.5.9 tftp-server enable

Command:
tftp-server enable
no tftp-server enable
Function:
Start TFTP server, the “no ftp-server enable” command shuts down TFTP server and prevents TFTP user from
logging in.
Default:
TFTP server is not started by default.
Command mode:
Global Mode
Usage Guide:
When TFTP server fun ctio n is enabl ed, the switch can still perform t f t p cli ent fun cti ons . T FTP server is not starte d by
default.
Example:
Enable TFTP server service.
Switch#config
Switch(config)#tftp-server enable
Relative Command:
1-87
tftp-server timeout

1.5.10 tftp-server retransmission-number

Command:
tftp-server retransmission-number <number>
Function:
Set the retransmission time for TFTP server.
Parameter:
<number> is the time to re-transfer, the valid range is 1 to 20.
Default:
The default value is 5 retransmission.
Command mode:
Global Mode
Example:
Modify the retransmission to 10 times.
Switch#config
XGS3 Command Guide
Switch(config)#tftp-server retransmission-number 10

1.5.11 tftp-server transmission-timeout

Command:
tftp-server transmission-timeout <seconds>
Function:
Set the transmission timeout value for TFTP server.
Parameter:
<seconds> is the timeout value, the valid range is 5 to 3600s.
Default:
The system default timeout setting is 600 second s.
Command mode:
Global Mode
Example:
Modify the timeout value to 60 seconds.
Switch#config
Switch(config)#tftp-server transmission-timeout 60
1-88
XGS3 Command Guide

Chapter 2 File System Commands

2.1 cd

Command:
cd <directory>
Function:
Change the working directory for the storage device.
Parameters:
<directory> is the sub-directory name, a sequence of consecutive characters whose length ranges from 1 to 80.
Command Mode:
Admin Mode.
Default Settings:
The default working directory is Flash.
Usage Guide:
After this command implemented, the current storage device will switch to the new working directory, which can be
viewed by the “pwd” command.
Example:
Change the working directory of the current storage device to flash.
Switch#cd flash
Switch#pwd
flash:/
Switch#

2.2 copy

Command:
copy <source-file-url > <dest-file-url>
Function:
Copy a designated file on the switch and store it as a new file.
Parameters:
<source-file-url> is the source file; <dest-file-url> is the destination file. When users operate on files stored in backup main-control boardcards and line cards under IMG mode, URLs of the source file and the destination file should take such a form as described in the following requirements.
1. The prefix of the source file URL should be in one of the following forms:
starting with “flash:/” “ftp://username:pass@server-ip/file-name” “tftp://server-ip/file-name”
2. The prefix of the destination file URL should be in one of the following forms:
starting with “flash:/” “ftp://username:pass@server-ip/file-name” “tftp://server-ip/file-name”
Command Mode:
2-89
XGS3 Command Guide
Admin Mode.
Default Settings:
None.
Usage Guide:
1. In this command, when the prefix of the source file URL is ftp:// or tftp://, that of the destination file URL should not be either of them.
2. To use this command, the designated source file should exist, and the destination file should not be named the same as any existing directory or file, otherwise, there might be a prompt warning about a failed copy operation or an attempt to overwrite an existing file.
3. If the source and destination files are in different directories, with this command implemented, users can copy files from other directories into the current one. URL Example: The URL of files in root directory of Flash devices on it should be flash:/nos.img
Example:
Copy the file “flash:/nos.img” and store it as “flash/ 5.2.1.0.img”.
Switch#copy flash:/nos.img flash:/nos-5.2.1.0.img
Copy flash:/nos.img to flash:/nos-5.2.1.0.img? [Y:N] y
Copyed file flash:/nos.img to flash:/nos-5.2.1.0.img.

2.3 delete

Command:
delete <file-url>
Function:
Delete the designate file on the storage device.
Parameters:
<file-url> is the full path of the file to be deleted.
Command Mode:
Admin Mode.
Default Settings:
None.
Usage Guide:
The designated file will be deleted after implementing this command.
Example:
Delete file flash:/nos.img.
Switch#delete flash:/nos5.img
Delete file flash:/nos5.img?[Y:N]y
Deleted file flash:/nos.img.

2.4 dir

Command:
dir [WORD]
Function:
2-90
XGS3 Command Guide
Display the information of the designated directory on the storage device.
Parameters:
<WORD> is the name of the shown directory. There may be the following formats: directory name, slot-xx#directory
name, flash:/directory name, cf:/directory name.
Command Mode:
Admin Configuration Mode.
Default Settings:
No <WORD> means to display information of the current working directory.
Usage Guide:
Implementing this command will display information of files and sub-directories in the designated directory.
Note:
This command does not support a recursive display of all sub-directories.
Example:
Display information of the directory “flash:/”.
Switch#dir flash:/
nos.img 2,449,496 1980-01-01 00:01:06 ----
startup-config 2,064 1980-01-01 00:30:12 ----
Total 7, 932, 928 byte(s) in 4 file(s) free 4, 966, 400 byte(s)
Switch#

2.5 format

Command:
format <device>
Function:
Format the storage device.
Parameters:
<device> is the name of the device to be formatted.
Command Mode:
Admin Mode.
Default Settings:
None.
Usage Guide:
1. After formatting, all files on the storage device will be irrecoverably lost.
2. The only acceptable file system type of Format is FAT 32, without exception.
3. This command cannot be used to format flash.

2.6 mkdir

Command:
mkdir <directory>
Function:
2-91
XGS3 Command Guide
Create a sub-directory in the designated directory on a certain storage device .
Parameters:
<directory> is the sub-directory name, a sequence of consecutive characters, whose length ranges from 1 to 80.
Command Mode:
Admin Mode.
Default Settings:
None.
Usage Guide:
The new created dire ctory should not be named th e sam e a s any other directory or fi le in t he de sign ated d ir ec tory, or
located on a flash device. If any error occurs, a prompt will be displayed.

2.7 mount

Command:
mount <device>
Function:
Mount the designated device onto the file system.
Parameters:
<device > is the name of the device to be mounted onto the file system.
Command Mode:
Admin Mode.
Default Settings:
None.
Usage Guide:
The flash's status will automatically be mount ed, on whi ch fil e operation s can be impl em ent ed.
Example:
Mount the flash card onto the file system.
Switch#mount flash

2.8 pwd

Command:
pwd
Function:
Display the current working directory.
Parameters:
None.
Command Mode:
Admin Mode.
Default Settings:
The default directory is flash.
Example:
Display the current working directory.
Switch#pwd
2-92
XGS3 Command Guide
flash:/
Switch#

2.9 rename

Command:
ename <source-file-url> <new-filename >
Function:
Rename a designated file on the switch.
Parameters:
<source-file-url>is the source file, in which whether specifying or not its path are both acceptable;
<new-filename>is a filename without speci fy ing its path.
Command Mode:
Admin Mode.
Default Settings:
None.
Usage Guide:
When using this command, if the new file name is not used as that of any existing directory or file, the rename
operation can be done, or a prompt will indicate its failure.
Example:
Change the name of file “nos.img” in the current working directory to “nos-5.2.1.0.img”.
Switch# rename nos5.img nos-5.2.1.0.img
Rename flash:/nos5.img to flash:/nos-5 .2.1.0.i mg ok

2.10 rmdir

Command:
rmdir <directory>
Function:
Delete a sub-directory in the designated directory on a certain device .
Parameters:
<directory> is the sub-directory name, a sequence of consecutive characters whose length ranges from 1 to 80.
Command Mode:
Admin Mode.
Default Settings:
None.
Usage Guide:
The directory to be deleted should exist and be empty, that is, all files in the directory should be deleted before
deleting it, or an error prompt will be displayed.

2.11 unmount

Command:
2-93
unmount <device>
Function:
Unmount the designated device from the file system.
Parameters:
<device> is the device to be unmounted from the file system.
Command Mode:
Admin Mode.
Default Settings:
Unmount the FLASH from the file system is nonsupport.
XGS3 Command Guide
2-94
XGS3 Command Guide

Chapter 3 Commands for Cluster

3.1 clear cluster nodes

Command:
clear cluster nodes [nodes-sn <candidate-sn-list> | mac-address <mac-addr>]
Function:
Clear the nodes in the candidate list found by the commander switch.
Parameters: c
andidate-sn-list: sn of candidate switches, ranging from 1 to 256. More than one candidate can be specified.
mac-address: mac address of the switches (including all candidates, members and other switches).
Default:
No parameter means to clear information of all switches.
Command Mode:
Admin Mode.
Usage Guide:
After executing this command, the information of this node will be deleted from the chain list saved on commander
switch. In 30 seconds, the commander w ill recreate a cluster topology and re-add this node. But after being readd ed,
the candidate id of the switch might change. The command can only be executed on commander switch es
Example:
Clear all candidate switch lists found by the comma nder sw it c h.
Switch#clear cluster nodes

3.2 cluster auto-add

Command:
cluster auto-add no cluster auto-add
Function:
When this command is ex ecuted in t he com mander sw itch, the new ly discovered candida te switches w ill be a dded to
the cluster as a member switch automatically; the “no cluster auto-add” command disables this function.
Command mode:
Global Mode
Default:
This function is disabled by default. That means that the candidate switches are not automatically added to the
cluster.
Usage Guide
After enabling this command on a commander switch, candidate switches will be automatically added as members.
Example:
Enable the auto adding function in the commander switch.
Switch(config)#cluster auto-add

3.3 cluster commander

Command:
3-95
XGS3 Command Guide
cluster commander [<cluster-name>]
no cluster commander
Function:
Set the switch as a commander switch, and create a cluster.
Parameter:
<cluster-name> is the cluster’s name, no longer than 32 characters.
Command mode:
Global Mode
Default:
Default setting is no comm and er sw itch. cl uster _na me is nul l by default.
Usage Guide:
This command sets the role of a switch as commander switch and creates a cluster, which can only be executed on
non commander switches. The cluster_name cannot be changed after the switch becoming a commander, and “no
cluster commander” should be executed first to do that. The no operation of this command will cancel the
commander configuration of the switch.
Example:
Set the current switch as the commander switch and name the cluster as switch.
Switch(config)#cluster commander switch

3.4 cluster ip-pool

Command:
cluster ip-pool <commander-ip> no cluster ip-pool
Function:
Configure private IP address pool for member switches of the cluster.
Parameters
commander-ip: cluster IP address pool for allocating internal IP addresses of the cluster commander-ip is the head address of the address pool, of which the valid format is 10.x.x.x, in dotted-decima l not at i on; the address pool should be big enough to hold 128 members, which requires the last byte of addresses to be less than 126254 – 128 = 126. IP address pool should never be changed with commander configured. The change can only be done after the “no cluster commander” command being executed.
Command mode:
Global Mode
Default:
The default address pool is 10.254.254.1.
Usage Guide:
When candidate switches becomes cluster members, the commander switch allocates a private IP address to each
member for the communication within the cluster, and thus to realized its management and maintenance of cluster
members. This command can only be used on non-commander switches. Once the cluster established, users can
not modify its IP address pool. The NO command of th is c om mand w ill r est ore t he a ddre ss pool back to default value,
which is 10.254.254.1.
Example:
Set the private IP address pool used by cluster member dev ices as 10.254.254.10
3-96
XGS3 Command Guide
Switch(config)#cluster ip-pool 10.254.254.10

3.5 cluster keepalive interval

Command:
cluster keepalive interval <second> no cluster keepalive interval
Function:
Configure the time interval of keepalive messages within the cluster.
Parameters:
<second>: keepalive time interval, in seconds, ranging from 3 to 30.
Default:
The default value is 30 seconds.
Command Mode:
Global Configuration Mode.
Usage Guide:
After executing this command on a commander switch, the value of the parameter will be distributed to all member switches via the TCP connections between the commander and members. After executing it on a non commander switch, the configuration value will be saved but not used until the switch becomes a commander. Before that, its keepalive interval is the one distributed by its commander. Commander will send DP messages within the cluster once in every keepalive interval. Members will respond to the received DP messages with DR messages. The no operation of this command will restore the keepalive interval in the cluster back to its default value.
Example:
Set the keepalive interval in the cluster to 10 seconds.
Switch(config)#cluster keepalive interval 10

3.6 cluster keepalive loss-count

Command:
cluster keepalive loss-count<loss-count> no cluster keepalive loss-count
Function:
Configure the max number of lost keepalive messages in a cluster that can be tolerated.
Parameters:
loss-count: the tolerable max number of lost messages, ranging from 1 to 10.
Default:
The default value is 3.
Command Mode:
Global Configuration Mode
Usage Guide:
After executing this command on a commander switch, the value of the parameter will be distributed to all member switches via the TCP connections between the commander and members. After executing it on a non commander switch, the configuration value will be saved but not used until the switch becomes a commander. Before that, its loss-count value is the one distributed by its commander.
3-97
XGS3 Command Guide
commander calculates the loss-count after sending each DP message by adding 1 to the loss-count of each swit ch and clearing that of a switch after receiving a DR message from the latter. When a loss-count reaches the configured value (3 by defaul t) w ithout receiving any DR message, the c ommander will delete th e switch from its can did ate chain list. If the time that a member fails to receive DP messages from the commander reaches loss-count, it will change its status to candidate. The no operation of this command will restore the tolerable max number of lost keepalive messages in the cluster back to its default value: 3.
Example:
Set the tolerable max number of lost keepalive messages in the cluster to 5.
Switch(config)#cluster keepalive loss-count 5

3.7 cluster member

Command:
cluster member {nodes-sn <candidate-sn-list> | mac-address <mac-addr> [id <member-id>]} no cluster member {id <member-id> | mac-address <mac-addr>}
Function:
On a commander switch, manually add candidate switches into the cluster created by it.
Parameters:
nodes-sn:all cluster member switches as rec orded i n a chai n list, each w ith a node sn w hich can be v iewed by “show cluster candidates” command. One or more candidates can be added as member at one time. The valid range of candidate-sn-list is 1~256. mac-addressthe CPU Mac of candidate switches member-idA memb er i d c an be s pec ified to a candidate as it be co mes a mem ber, ranging f rom 1 to 128, increasing from 1 by default. nodes-sn is the automatically generated sn, which may change after the candidate becomes a member. Members added this way will be actually treated as those added in mac-addr mode with all config files in mac-addr mode. If more than one switch is added as member simultaneously, no member-id is allowed; neither when using nodes-sn mode.
Default:
None.
Command Mode:
Global Mode
Usage Guide:
After executing this command, the switch will add those identified in <nodes-sn> or <mac-address>into the cluster
it belongs to. One or more candidates are allowed at one time, linked with ‘-‘ or ‘;’. A switch can only be member or
commander of one cluster, exclusively. Attempts to execute the command on a non commander switch will return
error. The no operat ion of t his comman d w ill delete the specified member switch, and turn it back to a candidate.
Example:
In the commander switc h, ad d the candidate switch which has the sequence nu mber as 1. In the commander switch,
add the switch whose the mac address is 11-22-33-44-55-66 to member, and the member-id is 5.
Switch(config)#cluster member nodes-sn 1
3-98
XGS3 Command Guide
Switch(config)#cluster member mac-address 11-22-33-44-55-66 id 5

3.8 cluster member auto-to-user

Command:
cluster member auto-to-user
Function:
All members will be deleted when configuring no cluster auto-add. Users need to change automatically added
members to manually added ones to keep them.
Parameter:
None.
Default:
None.
Command Mode:
Global Mode.
Usage Guide:
Execute this command on a switch to change automatically added members to manually added ones.
Example:
change automatically added members to manually added ones.
Switch(config)#cluster member auto-to-user

3.9 cluster reset member

Command:
cluster reset member [id <member-id> | mac-address <mac-addr>]
Function:
In the commander switch, this command can be used to reset the member switch.
Parameter:
member-id: ranging from 1 to 128. Use hyphen “-” or s emic olo n “;” to specify more than one member; if no value is
provided, it means to reboot all member switches.
Default:
Boot all member switches.
Command mode:
Admin Mode.
Instructions:
In the commander switch, users can use this command to reset a member switch. If this command is executed in a
non-commander switch, an error will be displayed.
Example:
In the commander switch, reset the member switch 1.
Switch#cluster reset member 1
3-99
XGS3 Command Guide

3.10 cluster run

Command:
cluster run [key <WORD>][ vid <VID>] no cluster run
Function:
Enable cluster function; the “no cluster run” command disables cluster function.
Parameter:
keyall keys in one cluster should be the same, no longer than 16 characters. vidvlan id of the cluster, whose range is 1-4094.
Command mode:
Global Mode
Default:
Cluster function is disabled by default, key: NULL(\0) vid1.
Instructions:
This command enables cluster function. Cluster function has to be enabled before implementing any other cluster commands. The “no cluster run” disables cluster function. It is recommended that users allocate an exclusive vlan for clustersuch as vlan100 NoteRouting protocols should be disabled on the layer-3 interface where cluster vlan locates to avoid broadcasting private route of the cluster.
Example:
Disable cluster function in the local switch.
Switch (config)#no cluster run

3.11 cluster update member

Command:
cluster update member <member-id> <src-url> <dst-filename> [ascii | binary]
Function:
Remotely upgrade member switches from the co mma nder switch.
Parameters:
member-idranging from 1 to 128. Use hyphen “-” or semicolon “” to specify more than one member; src-urlthe location of source files to be copied; dst-filenamethe specified filename for saving the file in the sw itch flash; ascii means t hat the f ile tran smission follows ASCII standard; binary means that the file transmission follows binary standard, which is de default mode. when src-url is a FTP address, its form will be: ftp://<username>:<password>@<ipadress>/<filename>in which <username> is the FTP username <password> is the FTP password <ipadress> is the IP address of the FTP server,<filename> is the name of the file to be downloaded via FTP. when src-url is a TFTP address, its f orm will be: tftp://<ipadress>/<filename>,in which <ipadress>is the IP address of the TFTP server <filename> is the name of the file to be downloaded via. Special keywords used in filename:
Keywords
source or destination address
3-100
Loading...