User manual NETGEAR FSM7326P

Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, Software Version 4.0 NETGEAR, Inc. 4500 Great America Parkway Santa Clara, CA 95054 USA Beta Draft 1 March 2006 © 2006 by NETGEAR, Inc. All rights reserved. FullManual. Trademarks NETGEAR and Auto Uplink are trademarks or registered trademarks of NETGEAR, Inc.. Microsoft, Windows, and Windows NT are registered trademarks of Microsoft Corporation. Other brand and product names are registered trademarks or trademarks of their respective holders. Portions of this document are copyright Intoto, Inc. March 2006 Statement of Conditions In the interest of improving internal design, operational function, and/or reliability, NETGEAR reserves the right to make changes to the products described in this document without notice. NETGEAR does not assume any liability that may occur due to the use or application of the product(s) or circuit layout(s) described herein. EN 55 022 Declaration of Conformance This is to certify that the ProSafe 7300S Series Layer-3 Managed Stackable Switch is shielded against the generation of radio interference in accordance with the application of Council Directive 89/336/EEC, Article 4a. Conformity is declared by the application of EN 55 022 Class B (CISPR 22). Certificate of the Manufacturer/Importer It is hereby certified that the ProSafe 7300S Series Layer-3 Managed Stackable Switch has been suppressed in accordance with the conditions set out in the BMPT-AmtsblVfg 243/1991 and Vfg 46/1992. The operation of some equipment (for example, test transmitters) in accordance with the regulations may, however, be subject to certain restrictions. Please refer to the notes in the operating instructions. The Federal Office for Telecommunications Approvals has been notified of the placing of this equipment on the market and has been granted the right to test the series for compliance with the regulations. Bestätigung des Herstellers/Importeurs Es wird hiermit bestätigt, daß dasProSafe 7300S Series Layer-3 Managed Stackable Switch gemäß der im BMPTAmtsblVfg 243/1991 und Vfg 46/1992 aufgeführten Bestimmungen entstört ist. Das vorschriftsmäßige Betreiben einiger Geräte (z.B. Testsender) kann jedoch gewissen Beschränkungen unterliegen. Lesen Sie dazu bitte die Anmerkungen in der Betriebsanleitung. Das Bundesamt für Zulassungen in der Telekommunikation wurde davon unterrichtet, daß dieses Gerät auf den Markt gebracht wurde und es ist berechtigt, die Serie auf die Erfüllung der Vorschriften hin zu überprüfen. Voluntary Control Council for Interference (VCCI) Statement This equipment is in the Class B category (information equipment to be used in a residential area or an adjacent area thereto) and conforms to the standards set by the Voluntary Control Council for Interference by Data Processing Equipment and Electronic Office Machines aimed at preventing radio interference in such residential areas. When used near a radio or TV receiver, it may become the cause of radio interference. Read instructions for correct handling. ii v1.0, March 2006 Product and Publication Details Model Number: Publication Date: Product Family: Product Name: Home or Business Product: Language: Publication Part Number: Publication Version Number FSM73xxS/GSM73xxS March 2006 managed switch ProSafe 7300S Series Layer-3 Managed Stackable Switch Business English Beta Draft 1 1.0 iii v1.0, March 2006 iv v1.0, March 2006 Contents Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, Software Version 4.0 Chapter 1 About This Manual 1.1 1.2 1.3 1.4 1.5 1.6 1.7 Chapter 2 Overview 2.1 2.2 Scope ................................................................................................................2-1 Using the Command-Line Interface ...................................................................2-1 2.2.1 2.2.2 2.2.3 2.2.4 2.2.5 2.2.6 2.2.7 2.2.8 Command Syntax .....................................................................................2-2 Command Conventions ............................................................................2-2 Unit-Slot-Port Naming Convention ...........................................................2-4 Using the "No" Form of a Command ........................................................2-5 Command Modes .....................................................................................2-5 Entering CLI Commands ..........................................................................2-8 Using CLI Help .......................................................................................2-10 Accessing the CLI ................................................................................... 2-11 Audience ............................................................................................................1-1 Scope ................................................................................................................1-1 Typographical Conventions ...............................................................................1-2 Special Message Formats .................................................................................1-2 How to Use This Manual ...................................................................................1-3 How to Print this Manual ....................................................................................1-3 Revision History .................................................................................................1-4 Chapter 3 Administrative Access Commands 3.1 Network Interface Commands ...........................................................................3-1 3.1.1 3.1.2 enable .......................................................................................................3-2 serviceport ip ............................................................................................3-2 v v1.0, March 2006 3.1.3 3.1.4 3.1.5 3.1.6 3.1.7 3.1.8 3.2 3.2.1 3.2.2 3.2.3 3.2.4 3.2.5 3.3 3.3.1 3.3.2 3.3.3 3.3.4 3.3.5 3.3.6 3.3.7 3.3.8 3.3.9 3.4 3.4.1 3.4.2 3.4.3 3.4.4 3.4.5 3.5 3.5.1 3.5.2 3.5.3 3.5.4 3.5.5 3.5.6 vi serviceport protocol ..................................................................................3-2 network parms ..........................................................................................3-2 network mgmt_vlan ..................................................................................3-2 network protocol .......................................................................................3-3 show network ............................................................................................3-3 show serviceport .......................................................................................3-4 configuration .............................................................................................3-5 lineconfig ..................................................................................................3-5 serial baudrate ..........................................................................................3-6 serial timeout ............................................................................................3-6 show serial ................................................................................................3-7 telnet .........................................................................................................3-8 transport input telnet .................................................................................3-8 transport output telnet ...............................................................................3-9 session-limit ..............................................................................................3-9 session-timeout ......................................................................................3-10 telnetcon maxsessions ...........................................................................3-10 telnetcon timeout .................................................................................... 3-11 show telnet ............................................................................................. 3-11 show telnetcon ........................................................................................3-12 ip ssh ......................................................................................................3-13 ip ssh protocol ........................................................................................3-13 sshcon maxsessions ..............................................................................3-14 sshcon timeout .......................................................................................3-14 show ip ssh .............................................................................................3-15 ip http secure-port ...................................................................................3-15 ip http secure-protocol ............................................................................3-16 ip http secure-server ...............................................................................3-16 ip http server ...........................................................................................3-16 network javamode ..................................................................................3-17 show ip http ............................................................................................3-17 Console Port Access Commands ......................................................................3-5 Telnet Commands ..............................................................................................3-8 Secure Shell (SSH) Command ........................................................................3-13 Hypertext Transfer Protocol (HTTP) Commands .............................................3-15 v1.0, March 2006 3.6 User Account Commands ................................................................................3-18 3.6.1 3.6.2 3.6.3 3.6.4 3.6.5 3.6.6 3.6.7 3.6.8 users name .............................................................................................3-18 users passwd ..........................................................................................3-19 users snmpv3 accessmode ....................................................................3-19 users snmpv3 authentication ..................................................................3-20 users snmpv3 encryption ........................................................................3-20 show loginsession ..................................................................................3-21 show users .............................................................................................3-21 disconnect ..............................................................................................3-22 Chapter 4 Port and System Setup Commands 4.1 Port Configuration Commands ..........................................................................4-1 4.1.1 4.1.2 4.1.3 4.1.4 4.1.5 4.1.6 4.1.7 4.1.8 4.1.9 4.1.10 4.1.11 4.1.12 4.1.13 4.1.14 4.2 4.2.1 4.2.2 4.3 4.3.1 4.3.2 4.3.3 4.3.4 4.3.5 interface ....................................................................................................4-1 cablestatus ...............................................................................................4-2 auto-negotiate ...........................................................................................4-2 auto-negotiate all ......................................................................................4-2 mtu ............................................................................................................4-3 shutdown ..................................................................................................4-3 shutdown all ..............................................................................................4-4 speed ........................................................................................................4-5 speed all ...................................................................................................4-5 monitor session ........................................................................................4-5 no monitor .................................................................................................4-6 show monitor session ...............................................................................4-6 show port ..................................................................................................4-7 show port protocol ....................................................................................4-7 copy ..........................................................................................................4-8 set prompt .................................................................................................4-8 sntp broadcast client poll-interval .............................................................4-9 sntp client mode .......................................................................................4-9 sntp client port ........................................................................................4-10 sntp unicast client poll-interval ................................................................4-10 sntp unicast client poll-timeout ...............................................................4-10 vii v1.0, March 2006 Pre-login Banner and System Prompt Commands ............................................4-8 Simple Network Time Protocol (SNTP) Commands ..........................................4-9 4.3.6 4.3.7 4.3.8 4.3.9 4.3.10 4.3.11 4.4 4.4.1 4.4.2 4.4.3 4.4.4 4.4.5 4.4.6 4.4.7 4.4.8 4.4.9 4.4.10 4.4.11 4.4.12 4.4.13 5.1 sntp unicast client poll-retry .................................................................... 4-11 sntp multicast client poll-interval ............................................................. 4-11 sntp server ..............................................................................................4-12 show sntp ...............................................................................................4-12 show sntp client ......................................................................................4-13 show sntp server ....................................................................................4-13 network mac-address .............................................................................4-14 network mac-type ...................................................................................4-15 macfilter ..................................................................................................4-15 macfilter adddest ....................................................................................4-16 macfilter adddest all ................................................................................4-16 macfilter addsrc ......................................................................................4-17 macfilter addsrc all ..................................................................................4-17 bridge aging-time ....................................................................................4-18 show forwardingdb agetime ....................................................................4-18 show mac-address-table multicast .........................................................4-19 show mac-address-table static ...............................................................4-20 show mac-address-table staticfiltering ...................................................4-20 show mac-address-table stats ................................................................4-21 MAC Address and MAC Database Commands ...............................................4-14 Chapter 5 Spanning Tree Protocol Commands STP Configuration Commands ..........................................................................5-1 5.1.1 5.1.2 5.1.3 5.1.4 5.1.5 5.1.6 5.1.7 5.1.8 5.1.9 5.1.10 5.1.11 5.1.12 5.1.13 viii v1.0, March 2006 spanning-tree ............................................................................................5-1 spanning-tree bpdumigrationcheck ..........................................................5-2 spanning-tree configuration name ............................................................5-2 spanning-tree configuration revision .........................................................5-3 spanning-tree edgeport ............................................................................5-3 spanning-tree forceversion .......................................................................5-4 spanning-tree forward-time .......................................................................5-4 spanning-tree hello-time ...........................................................................5-5 spanning-tree max-age .............................................................................5-5 spanning-tree max-hops ...........................................................................5-6 spanning-tree mst .....................................................................................5-6 spanning-tree mst instance ......................................................................5-7 spanning-tree mst priority .........................................................................5-8 5.1.14 5.1.15 5.1.16 5.2 5.2.1 5.2.2 5.2.3 5.2.4 5.2.5 5.2.6 5.2.7 spanning-tree mst vlan .............................................................................5-9 spanning-tree port mode ..........................................................................5-9 spanning-tree port mode all ......................................................................5-9 show spanning-tree ................................................................................5-10 show spanning-tree summary ................................................................5-12 show spanning-tree interface .................................................................5-12 show spanning-tree mst port detailed .....................................................5-13 show spanning-tree mst port summary ..................................................5-15 show spanning-tree mst summary ..........................................................5-16 show spanning-tree vlan .........................................................................5-16 STP Show Commands ....................................................................................5-10 Chapter 6 VLAN Commands 6.1 VLAN Configuration Commands .......................................................................6-1 6.1.1 6.1.2 6.1.3 6.1.4 6.1.5 6.1.6 6.1.7 6.1.8 6.1.9 6.1.10 6.1.11 6.1.12 6.1.13 6.1.14 6.1.15 6.1.16 6.1.17 6.1.18 6.1.19 6.1.20 6.1.21 vlan database ...........................................................................................6-1 network mgmt_vlan ..................................................................................6-2 vlan ...........................................................................................................6-2 vlan acceptframe ......................................................................................6-2 vlan ingressfilter ........................................................................................6-3 vlan makestatic .........................................................................................6-3 vlan name .................................................................................................6-4 vlan participation .......................................................................................6-4 vlan participation all ..................................................................................6-5 vlan port acceptframe all ..........................................................................6-5 vlan port pvid all ........................................................................................6-6 vlan port tagging all ..................................................................................6-6 vlan port ingressfilter all ............................................................................6-7 Global Config ............................................................................................6-7 vlan protocol group ...................................................................................6-7 vlan protocol group add protocol ..............................................................6-7 vlan protocol group remove ......................................................................6-8 protocol group ...........................................................................................6-8 protocol vlan group ...................................................................................6-9 protocol vlan group all ..............................................................................6-9 vlan pvid .................................................................................................6-10 ix v1.0, March 2006 6.1.22 6.2 6.2.1 6.2.2 6.2.3 6.3 6.3.1 6.3.2 vlan tagging ............................................................................................6-10 show vlan ................................................................................................ 6-11 show vlan brief ........................................................................................6-12 show vlan port ........................................................................................6-13 vlan port priority all .................................................................................6-14 vlan priority .............................................................................................6-14 VLAN Show Commands .................................................................................. 6-11 Provisioning (IEEE 802.1p) Commands ..........................................................6-14 Chapter 7 DHCP Commands 7.1 DHCP Server Commands (DHCP Config Pool Mode) ......................................7-2 7.1.1 7.1.2 7.1.3 7.1.4 7.1.5 7.1.6 7.1.7 7.1.8 7.1.9 7.1.10 7.1.11 7.1.12 7.1.13 7.1.14 7.1.15 7.2 7.2.1 7.2.2 7.2.3 7.2.4 7.2.5 7.3 7.3.1 7.3.2 x v1.0, March 2006 ip dhcp pool ..............................................................................................7-2 client-identifier ..........................................................................................7-2 client-name ...............................................................................................7-3 default-router ............................................................................................7-3 dns-server .................................................................................................7-4 hardware-address .....................................................................................7-4 host ...........................................................................................................7-5 lease .........................................................................................................7-5 network .....................................................................................................7-5 bootfile ......................................................................................................7-6 domain-name ............................................................................................7-6 netbios-name-server .................................................................................7-7 netbios-node-type .....................................................................................7-7 next-server ................................................................................................7-8 option ........................................................................................................7-8 ip dhcp excluded-address .........................................................................7-9 ip dhcp ping packets .................................................................................7-9 service dhcp ...........................................................................................7-10 ip dhcp bootp automatic .........................................................................7-10 ip dhcp conflict logging ........................................................................... 7-11 clear ip dhcp binding ............................................................................... 7-11 clear ip dhcp server statistics ................................................................. 7-11 DHCP Server Commands (Global Config Mode) ..............................................7-9 DHCP Server Clear and Show Commands ..................................................... 7-11 7.3.3 7.3.4 7.3.5 7.3.6 7.3.7 7.3.8 7.4 7.4.1 7.4.2 7.4.3 7.4.4 7.4.5 7.4.6 clear ip dhcp conflict ...............................................................................7-12 show ip dhcp binding ..............................................................................7-12 show ip dhcp global configuration ..........................................................7-12 show ip dhcp pool configuration .............................................................7-13 show ip dhcp server statistics .................................................................7-13 show ip dhcp conflict ..............................................................................7-14 bootpdhcprelay cidoptmode ...................................................................7-15 bootpdhcprelay enable ...........................................................................7-15 bootpdhcprelay maxhopcount ................................................................7-16 bootpdhcprelay minwaittime ...................................................................7-16 bootpdhcprelay serverip .........................................................................7-17 show bootpdhcprelay ..............................................................................7-17 DHCP and BOOTP Relay Commands ............................................................7-15 Chapter 8 GARP, GVRP, and GMRP Commands 8.1 GARP Commands .............................................................................................8-2 8.1.1 8.1.2 8.1.3 8.1.4 8.2 8.2.1 8.2.2 8.2.3 8.3 8.3.1 8.3.2 8.3.3 8.3.4 set garp timer join .....................................................................................8-2 set garp timer leave ..................................................................................8-3 set garp timer leaveall ..............................................................................8-4 show garp .................................................................................................8-4 set gvrp adminmode .................................................................................8-5 set gvrp interfacemode .............................................................................8-5 show gvrp configuration ............................................................................8-6 set gmrp adminmode ................................................................................8-7 set gmrp interfacemode ............................................................................8-8 show gmrp configuration ..........................................................................8-8 show mac-address-table gmrp .................................................................8-9 GVRP Commands .............................................................................................8-5 GMRP Commands ............................................................................................8-7 Chapter 9 Port-Based Traffic Control Commands 9.1 Port Security Commands ...................................................................................9-1 9.1.1 9.1.2 9.1.3 port-security ..............................................................................................9-2 port-security max-dynamic .......................................................................9-2 port-security max-static ............................................................................9-3 xi v1.0, March 2006 9.1.4 9.1.5 9.1.6 9.1.7 9.1.8 9.1.9 9.1.10 9.2 9.2.1 9.2.2 9.2.3 port-security mac-address ........................................................................9-3 port-security mac-address move ..............................................................9-3 show port-security ....................................................................................9-4 show port-security ....................................................................................9-4 show port-security dynamic ......................................................................9-4 show port-security static ...........................................................................9-4 show port-security violation ......................................................................9-5 storm-control broadcast ............................................................................9-5 storm-control flowcontrol ..........................................................................9-6 show storm-control ...................................................................................9-7 Storm Control Commands .................................................................................9-5 Chapter 10 SNMP Commands 10.1 SNMP Configuration Commands ....................................................................10-1 snmp-server ............................................................................................10-1 snmp-server community .........................................................................10-2 snmp-server community ipaddr ..............................................................10-2 snmp-server community ipmask .............................................................10-3 snmp-server community mode ...............................................................10-3 snmp-server community ro .....................................................................10-4 snmp-server community rw ....................................................................10-4 snmp-server enable traps violation .........................................................10-4 snmp-server enable traps .......................................................................10-5 snmp-server enable traps linkmode .......................................................10-6 10.1.1 10.1.2 10.1.3 10.1.4 10.1.5 10.1.6 10.1.7 10.1.8 10.1.9 10.1.11 10.1.10 snmp-server enable traps bcaststorm ....................................................10-5 10.1.12 snmp-server enable traps multiusers .....................................................10-6 10.1.13 snmp-server enable traps stpmode ........................................................10-6 10.1.14 snmptrap .................................................................................................10-7 10.1.15 snmptrap snmpversion ...........................................................................10-8 10.1.16 snmptrap ipaddr ......................................................................................10-8 10.1.17 snmptrap mode .......................................................................................10-8 10.1.18 snmp trap link-status ..............................................................................10-9 10.1.19 snmp trap link-status all ..........................................................................10-9 10.2 SNMP Show Commands ...............................................................................10-10 show snmpcommunity ..........................................................................10-10 10.2.1 xii v1.0, March 2006 10.2.2 10.2.3 show snmptrap ..................................................................................... 10-11 show trapflags ...................................................................................... 10-11 Chapter 11 Port-Based Access and Authentication Commands 11.1 Port-Based Network Access Control Commands ............................................ 11-1 authentication login ................................................................................. 11-1 clear dot1x statistics ............................................................................... 11-3 clear radius statistics .............................................................................. 11-3 dot1x defaultlogin ................................................................................... 11-3 dot1x initialize ......................................................................................... 11-3 dot1x login .............................................................................................. 11-3 dot1x max-req ......................................................................................... 11-4 dot1x port-control .................................................................................... 11-4 dot1x port-control all ............................................................................... 11-5 dot1x re-authenticate .............................................................................. 11-5 dot1x re-authentication ........................................................................... 11-6 dot1x system-auth-control ...................................................................... 11-6 dot1x timeout .......................................................................................... 11-6 dot1x user ............................................................................................... 11-7 users defaultlogin ................................................................................... 11-8 users login .............................................................................................. 11-8 show authentication ................................................................................ 11-8 show authentication users ...................................................................... 11-9 show dot1x ............................................................................................. 11-9 show dot1x users .................................................................................. 11-12 show users authentication .................................................................... 11-13 radius accounting mode ....................................................................... 11-13 radius server host ................................................................................. 11-14 radius server key .................................................................................. 11-15 radius server msgauth .......................................................................... 11-15 radius server primary ............................................................................ 11-16 radius server retransmit ........................................................................ 11-16 radius server timeout ............................................................................ 11-16 show radius .......................................................................................... 11-17 xiii v1.0, March 2006 11.1.1 11.1.2 11.1.3 11.1.4 11.1.5 11.1.6 11.1.7 11.1.8 11.1.9 11.1.10 11.1.11 11.1.12 11.1.13 11.1.14 11.1.15 11.1.16 11.1.17 11.1.18 11.1.19 11.1.20 11.1.21 11.2 11.2.1 11.2.2 11.2.3 11.2.4 11.2.5 11.2.6 11.2.7 11.2.8 RADIUS Commands ...................................................................................... 11-13 11.2.9 11.2.10 show radius accounting ........................................................................ 11-18 show radius statistics ............................................................................ 11-19 Chapter 12 Port-Channel/LAG (802.3ad) Commands 12.1 Port-Channel Configuration Commands ..........................................................12-1 addport ...................................................................................................12-2 deleteport (Interface Config) ...................................................................12-2 deleteport (Global Config) ......................................................................12-2 port-channel ............................................................................................12-3 clear port-channel ...................................................................................12-3 port-channel staticcapability ...................................................................12-3 port lacpmode .........................................................................................12-4 port lacpmode all ....................................................................................12-4 port-channel adminmode ........................................................................12-4 port-channel linktrap ...............................................................................12-5 show port-channel brief ..........................................................................12-6 show port-channel ..................................................................................12-6 12.1.1 12.1.2 12.1.3 12.1.4 12.1.5 12.1.6 12.1.7 12.1.8 12.1.9 12.1.11 12.2 12.2.1 12.2.2 12.1.10 port-channel name ..................................................................................12-5 Port-Channel Show Commands ......................................................................12-6 Chapter 13 Quality of Service (QoS) Commands 13.1 Class of Service (CoS) Commands .................................................................13-1 classofservice dot1p-mapping ................................................................13-2 classofservice ip-precedence-mapping ..................................................13-2 classofservice ip-dscp-mapping .............................................................13-3 classofservice trust .................................................................................13-3 cos-queue min-bandwidth ......................................................................13-4 cos-queue strict ......................................................................................13-4 traffic-shape ............................................................................................13-4 show classofservice dot1p-mapping .......................................................13-5 show classofservice ip-precedence-mapping .........................................13-5 show classofservice trust ........................................................................13-6 13.1.1 13.1.2 13.1.3 13.1.4 13.1.5 13.1.6 13.1.7 13.1.8 13.1.9 13.1.11 13.2 xiv v1.0, March 2006 13.1.10 show classofservice ip-dscp-mapping ....................................................13-6 13.1.12 show interfaces cos-queue .....................................................................13-7 Differentiated Services (DiffServ) Commands .................................................13-8 13.2.1 13.3 13.3.1 13.3.2 13.3.3 13.3.4 13.3.5 13.3.6 13.3.7 13.3.8 13.3.9 13.3.11 13.4 diffserv ....................................................................................................13-9 class-map .............................................................................................13-10 class-map rename ................................................................................ 13-11 match any ............................................................................................. 13-11 match class-map .................................................................................. 13-11 match dstip ...........................................................................................13-12 match dstl4port .....................................................................................13-13 match ip dscp .......................................................................................13-13 match ip precedence ............................................................................13-14 match ip tos ..........................................................................................13-14 match srcip ...........................................................................................13-15 DiffServ Class Commands .............................................................................13-10 13.3.10 match protocol ......................................................................................13-15 13.3.12 match srcl4port .....................................................................................13-15 DiffServ Policy Commands ............................................................................13-16 assign-queue ........................................................................................13-16 drop ......................................................................................................13-17 conform-color ........................................................................................13-17 class .....................................................................................................13-17 mark cos ...............................................................................................13-18 mark ip-dscp .........................................................................................13-18 mark ip-precedence ..............................................................................13-19 police-simple .........................................................................................13-19 policy-map ............................................................................................13-20 13.4.1 13.4.2 13.4.3 13.4.4 13.4.5 13.4.6 13.4.7 13.4.8 13.4.9 13.5 13.6 13.4.10 policy-map rename ...............................................................................13-20 DiffServ Service Commands ..........................................................................13-21 service-policy ........................................................................................13-21 show class-map ....................................................................................13-22 show diffserv .........................................................................................13-23 show policy-map ...................................................................................13-24 show diffserv service ............................................................................13-26 show diffserv service brief ....................................................................13-27 show policy-map interface ....................................................................13-27 show service-policy (GSM7248 only) ...................................................13-28 xv v1.0, March 2006 DiffServ Show Commands .............................................................................13-22 13.5.1 13.6.1 13.6.2 13.6.3 13.6.4 13.6.5 13.6.6 13.6.7 13.7 MAC Access Control List (ACL) Commands ................................................13-29 mac access-list extended .....................................................................13-29 mac access-list extended rename ........................................................13-30 {deny|permit} ........................................................................................13-30 mac access-group ................................................................................13-32 show mac access-lists ..........................................................................13-32 access-list .............................................................................................13-34 ip access-group ....................................................................................13-35 show ip access-lists ..............................................................................13-36 show access-lists ..................................................................................13-37 13.7.1 13.7.2 13.7.3 13.7.4 13.7.5 13.8 13.8.1 13.8.2 13.8.3 13.8.4 IP Access Control List (ACL) Commands .....................................................13-33 Chapter 14 Routing Commands 14.1 Address Resolution Protocol (ARP) Commands .............................................14-1 arp ..........................................................................................................14-1 ip proxy-arp .............................................................................................14-2 arp cachesize .........................................................................................14-2 arp dynamicrenew ..................................................................................14-3 arp purge ................................................................................................14-3 arp resptime ............................................................................................14-4 arp retries ...............................................................................................14-4 arp timeout ..............................................................................................14-4 clear arp-cache .......................................................................................14-5 show arp brief .........................................................................................14-6 routing .....................................................................................................14-7 ip routing .................................................................................................14-7 ip address ...............................................................................................14-8 ip route ....................................................................................................14-8 ip route default ........................................................................................14-9 ip route distance ...................................................................................14-10 ip forwarding .........................................................................................14-10 ip netdirbcast ........................................................................................ 14-11 ip mtu .................................................................................................... 14-11 14.1.1 14.1.2 14.1.3 14.1.4 14.1.5 14.1.6 14.1.7 14.1.8 14.1.9 14.1.11 14.2 14.2.1 14.2.2 14.2.3 14.2.4 14.2.5 14.2.6 14.2.7 14.2.8 14.2.9 xvi v1.0, March 2006 14.1.10 show arp .................................................................................................14-5 IP Routing Commands ....................................................................................14-7 14.2.10 encapsulation .......................................................................................14-12 14.2.11 clear ip route all ....................................................................................14-12 14.2.12 clear ip route bgp ..................................................................................14-12 14.2.13 clear ip route bgp ............................................................14-12 14.2.14 clear ip route mpls ................................................................................14-13 14.2.15 clear ip route mpls ..........................................................14-13 14.2.16 clear ip route ospf .................................................................................14-13 14.2.17 clear ip route ospf ...........................................................14-13 14.2.18 clear ip route rip ....................................................................................14-13 14.2.19 clear ip route rip ..............................................................14-14 14.2.20 show ip brief .........................................................................................14-14 14.2.21 show ip interface ...................................................................................14-14 14.2.22 show ip interface brief ...........................................................................14-15 14.2.23 show ip route ........................................................................................14-17 14.2.24 show ip route bestroutes ......................................................................14-17 14.2.25 show ip route entry ...............................................................................14-18 14.2.26 show ip route preferences ....................................................................14-19 14.2.27 show ip stats .........................................................................................14-19 14.3 Router Discovery Protocol Commands .........................................................14-20 ip irdp ....................................................................................................14-20 ip irdp address ......................................................................................14-20 ip irdp holdtime .....................................................................................14-21 ip irdp maxadvertinterval ......................................................................14-21 ip irdp minadvertinterval .......................................................................14-21 ip irdp preference ..................................................................................14-22 show ip irdp ..........................................................................................14-22 vlan routing ...........................................................................................14-24 show ip vlan ..........................................................................................14-24 ip vrrp ....................................................................................................14-25 ip vrrp ....................................................................................................14-25 ip vrrp mode ..........................................................................................14-26 ip vrrp ip ................................................................................................14-26 ip vrrp authentication ............................................................................14-26 xvii v1.0, March 2006 14.3.1 14.3.2 14.3.3 14.3.4 14.3.5 14.3.6 14.3.7 14.4 14.4.1 14.4.2 14.5 14.5.1 14.5.2 14.5.3 14.5.4 14.5.5 Virtual LAN Routing Commands ....................................................................14-24 Virtual Router Redundancy Protocol (VRRP) Commands .............................14-25 14.5.6 14.5.7 14.5.8 14.5.9 14.5.11 14.6 ip vrrp preempt .....................................................................................14-27 ip vrrp priority ........................................................................................14-27 ip vrrp timers advertise .........................................................................14-28 show ip vrrp interface stats ...................................................................14-28 show ip vrrp interface ...........................................................................14-30 14.5.10 show ip vrrp ..........................................................................................14-29 14.5.12 show ip vrrp interface brief ...................................................................14-31 Open Shortest Path First (OSPF) Commands ..............................................14-31 router ospf ............................................................................................14-31 enable (OSPF) ......................................................................................14-31 ip ospf ...................................................................................................14-32 1583compatibility ..................................................................................14-32 area default-cost ...................................................................................14-33 area nssa ..............................................................................................14-33 area nssa default-info-originate ............................................................14-33 area nssa no-redistribute (OSPF) .........................................................14-33 area nssa no-summary (OSPF) ............................................................14-34 area nssa translator-stab-intv ...............................................................14-34 14.6.1 14.6.2 14.6.3 14.6.4 14.6.5 14.6.6 14.6.7 14.6.8 14.6.9 14.6.11 14.6.10 area nssa translator-role (OSPF) .........................................................14-34 14.6.12 area range ............................................................................................14-34 14.6.13 area stub ...............................................................................................14-35 14.6.14 area stub summarylsa ..........................................................................14-35 14.6.15 area virtual-link .....................................................................................14-36 14.6.16 area virtual-link authentication ..............................................................14-36 14.6.17 area virtual-link dead-interval ...............................................................14-37 14.6.18 area virtual-link hello-interval ................................................................14-37 14.6.19 area virtual-link retransmit-interval .......................................................14-38 14.6.20 area virtual-link transmit-delay ..............................................................14-38 14.6.21 default-information originate (OSPF) ....................................................14-39 14.6.22 default-metric (OSPF) ...........................................................................14-39 14.6.23 distance ospf ........................................................................................14-40 14.6.24 distribute-list out ...................................................................................14-40 14.6.25 exit-overflow-interval .............................................................................14-41 14.6.26 external-lsdb-limit .................................................................................14-41 14.6.27 ip ospf areaid ........................................................................................14-42 xviii v1.0, March 2006 14.6.28 ip ospf authentication ............................................................................14-42 14.6.29 ip ospf cost ...........................................................................................14-42 14.6.30 ip ospf dead-interval .............................................................................14-43 14.6.31 ip ospf hello-interval ..............................................................................14-43 14.6.32 ip ospf priority .......................................................................................14-44 14.6.33 ip ospf retransmit-interval .....................................................................14-44 14.6.34 ip ospf transmit-delay ...........................................................................14-44 14.6.35 ip ospf mtu-ignore .................................................................................14-45 14.6.36 router-id ................................................................................................14-45 14.6.37 redistribute ............................................................................................14-46 14.6.38 maximum-paths ....................................................................................14-46 14.6.39 trapflags ................................................................................................14-47 14.6.40 show ip ospf ..........................................................................................14-47 14.6.41 show ip ospf area .................................................................................14-49 14.6.42 show ip ospf database ..........................................................................14-50 14.6.43 show ip ospf interface ...........................................................................14-51 14.6.44 show ip ospf interface brief ...................................................................14-52 14.6.45 show ip ospf interface stats ..................................................................14-53 14.6.46 show ip ospf neighbor ...........................................................................14-54 14.6.47 show ip ospf neighbor brief ...................................................................14-55 14.6.48 show ip ospf range ...............................................................................14-57 14.6.49 show ip ospf stub table .........................................................................14-57 14.6.50 show ip ospf virtual-link ........................................................................14-58 14.6.51 show ip ospf virtual-link brief ................................................................14-58 14.7 Routing Information Protocol (RIP) Commands ............................................14-59 router rip ...............................................................................................14-59 enable (RIP) .........................................................................................14-59 ip rip ......................................................................................................14-59 auto-summary .......................................................................................14-60 default-information originate (RIP) ........................................................14-60 default-metric (RIP) ..............................................................................14-60 distance rip ...........................................................................................14-61 distribute-list out ...................................................................................14-61 ip rip authentication ..............................................................................14-62 14.7.1 14.7.2 14.7.3 14.7.4 14.7.5 14.7.6 14.7.7 14.7.8 14.7.9 14.7.10 ip rip receive version .............................................................................14-62 xix v1.0, March 2006 14.7.11 ip rip send version ................................................................................14-63 14.7.12 hostroutesaccept ..................................................................................14-63 14.7.13 split-horizon ..........................................................................................14-64 14.7.14 redistribute ............................................................................................14-64 14.7.15 show ip rip ............................................................................................14-65 14.7.16 show ip rip interface brief ......................................................................14-66 14.7.17 show ip rip interface ..............................................................................14-66 Chapter 15 IGMP Snooping Commands 15.1 IGMP Snooping Configuration Commands .....................................................15-1 set igmp ..................................................................................................15-1 set igmp interfacemode ..........................................................................15-2 set igmp fast-leave .................................................................................15-3 set igmp groupmembership-interval .......................................................15-4 set igmp maxresponse ...........................................................................15-4 set igmp mcrtexpiretime .........................................................................15-5 set igmp mrouter .....................................................................................15-5 set igmp mrouter interface ......................................................................15-6 show igmpsnooping ................................................................................15-6 show igmpsnooping mrouter interface ....................................................15-8 show igmpsnooping mrouter vlan ...........................................................15-8 show mac-address-table igmpsnooping .................................................15-8 15.1.1 15.1.2 15.1.3 15.1.4 15.1.5 15.1.6 15.1.7 15.1.8 15.2 15.2.1 15.2.2 15.2.3 15.2.4 IGMP Snooping Show Commands ..................................................................15-6 Chapter 16 Power Over Ethernet Commands 16.1 Power Over Ethernet (POE) Commands .........................................................16-2 poe ..........................................................................................................16-3 poe priority ..............................................................................................16-3 poe limit ..................................................................................................16-3 poe usagethreshold ................................................................................16-3 show poe port info ..................................................................................16-4 show poe ................................................................................................16-5 16.1.1 16.1.2 16.1.3 16.1.4 16.1.5 16.1.6 Chapter 17 Stacking Commands 17.1 xx v1.0, March 2006 Dedicated Port Stacking ..................................................................................17-1 17.1.1 17.1.2 17.1.3 17.1.4 17.1.5 17.1.6 17.1.7 17.1.8 17.1.9 17.1.11 stack .......................................................................................................17-1 member ..................................................................................................17-2 switch priority ..........................................................................................17-2 switch renumber .....................................................................................17-3 movemanagement ..................................................................................17-3 archive copy-sw ......................................................................................17-3 archive download-sw ..............................................................................17-4 slot ..........................................................................................................17-4 set slot disable ........................................................................................17-5 reload ......................................................................................................17-6 17.1.10 set slot power .........................................................................................17-5 17.1.12 show slot .................................................................................................17-6 17.1.13 show supported cardtype .......................................................................17-7 17.1.14 show switch ............................................................................................17-8 17.1.15 show supported switchtype ....................................................................17-9 17.2 Front Panel Stacking Commands ..................................................................17-10 stack-port ..............................................................................................17-10 qos-mode .............................................................................................. 17-11 show stack-port .................................................................................... 17-11 show stack-port counters ......................................................................17-12 show stack-port diag .............................................................................17-12 17.2.1 17.2.2 17.2.3 17.2.4 17.2.5 Chapter 18 System Maintenance Commands 18.1 System Information and Statistics Commands ................................................18-2 show arp switch ......................................................................................18-2 show eventlog .........................................................................................18-2 show hardware .......................................................................................18-3 show interface ........................................................................................18-4 show interface ethernet ..........................................................................18-6 show logging .........................................................................................18-14 show mac-addr-table ............................................................................18-15 clear mac-addr-table .............................................................................18-16 show running-config .............................................................................18-16 show sysinfo .........................................................................................18-17 xxi v1.0, March 2006 18.1.1 18.1.2 18.1.3 18.1.4 18.1.5 18.1.6 18.1.7 18.1.8 18.1.9 18.1.11 18.1.10 terminal length ......................................................................................18-16 18.2 System Utility Commands .............................................................................18-17 traceroute .............................................................................................18-17 clear config ...........................................................................................18-18 clear counters .......................................................................................18-18 clear igmpsnooping ..............................................................................18-18 clear pass .............................................................................................18-18 enable passwd ......................................................................................18-18 clear port-channel .................................................................................18-18 clear traplog ..........................................................................................18-19 clear vlan ..............................................................................................18-19 logout ....................................................................................................18-21 18.2.1 18.2.2 18.2.3 18.2.4 18.2.5 18.2.6 18.2.7 18.2.8 18.2.9 18.2.11 18.2.10 copy ......................................................................................................18-19 18.2.12 ping .......................................................................................................18-21 18.2.13 reload ....................................................................................................18-21 18.3 Logging Commands ......................................................................................18-21 logging buffered ....................................................................................18-22 logging buffered wrap ...........................................................................18-22 logging console .....................................................................................18-22 logging host ..........................................................................................18-23 logging host remove .............................................................................18-24 logging port ...........................................................................................18-24 logging syslog .......................................................................................18-24 show logging .........................................................................................18-25 show logging buffered ..........................................................................18-26 show logging hosts ...............................................................................18-26 18.3.1 18.3.2 18.3.3 18.3.4 18.3.5 18.3.6 18.3.7 18.3.8 18.3.9 18.3.11 18.4 18.5 18.3.10 clear logging buffered ...........................................................................18-26 18.3.12 show logging traplogs ...........................................................................18-26 CLI Command Logging Command ................................................................18-27 logging cli-command .............................................................................18-27 script apply ...........................................................................................18-29 script delete ..........................................................................................18-29 script list ................................................................................................18-29 script show ............................................................................................18-29 script validate ........................................................................................18-30 Configuration Scripting Commands ...............................................................18-28 18.4.1 18.5.1 18.5.2 18.5.3 18.5.4 18.5.5 xxii v1.0, March 2006 Chapter 1 About This Manual This chapter introduces the Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, Software Version 4.0. It describes the command-line interface (CLI) commands used to view and configure the 7300S Series Stackable Switch software. You can access the CLI by using a direct connection to the serial port or by using telnet or SSH over a remote network connection. 1.1 Audience This document is for system administrators who configure and operate systems using 7300S Series Stackable Switch software. Software engineers who integrate 7300S Series Stackable Switch software into their hardware platform can also benefit from a description of the configuration options. This document assumes that the reader has an understanding of the 7300S Series Stackable Switch software base and has read the appropriate specification for the relevant networking device platform. It also assumes that the reader has a basic knowledge of Ethernet and networking concepts. 1.2 Scope This manual is written for the 7300S Series Stackable Switch according to these specifications: Table 1-1. Manual Specifications Product Product Final Assembly Number Firmware Version Number Manual Part Number Manual Publication Date Beta Draft 1 March 2006 ProSafe 7300S Series Layer-3 Managed Stackable Switch About This Manual Publication Version 1.0, March 2006 1-1 Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, Note: Product updates are available on the NETGEAR Web site at http://kbserver.netgear.com/products/. 1.3 Typographical Conventions This guide uses the following typographical conventions: Table 1-2. Typographical conventions italics bold Small Caps Emphasis. User input. DOS file and directory names. 1.4 Special Message Formats This guide uses the following formats to highlight special messages: Note: This format is used to highlight of importance or special interest. Tip: A time-saving or resource-saving procedural step. Warning: Ignoring a warning could result in damage to the equipment or software malfunction. Danger: Ignoring this type of warning could result in personal injury or death. 1-2 Publication Version 1.0, March 2006 About This Manual Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, 1.5 How to Use This Manual The HTML version of this manual includes the following: · · Buttons, and one page at a time , for browsing forwards or backwards through the manual A button that displays the table of contents and possibly an button. Double-click on a link in the table of contents or index to navigate directly to where the topic is described in the manual. A button to access the full NETGEAR, Inc. online knowledge base for the product model. Links to PDF versions of the full manual and individual chapters. · · 1.6 How to Print this Manual To print this manual you can choose one of the following several options, according to your needs. · Printing a Page in the HTML View. Each page in the HTML version of the manual is dedicated to a major topic. Use the Print button on the browser toolbar to print the page contents. · Printing a Chapter. Use the PDF of This Chapter link at the top left of any page. -- Click the PDF of This Chapter link at the top right of any page in the chapter you want to print. The PDF version of the chapter you were viewing opens in a browser window. Your computer must have the free Adobe Acrobat reader installed in order to view and print PDF files. The Acrobat reader is available on the Adobe Web site at http://www.adobe.com. -- Click the print icon in the window toolbar. Tip: If your printer supports printing of two or more pages on a single sheet of paper, you can save paper and printer ink by clicking the printer Properties button and increasing the number of pages per sheet. About This Manual Publication Version 1.0, March 2006 1-3 Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, · Printing the Full Manual. Use the Complete PDF Manual link at the top left of any page. -- Click the Complete PDF Manual link at the top left of any page in the manual. The PDF version of the complete manual opens in a browser window. -- Click the print icon in the window toolbar. Tip: If your printer supports printing of two or more pages on a single sheet of paper, you can save paper and printer ink by clicking the printer Properties button and increasing the number of pages per sheet. 1.7 Revision History Table 1-3 lists the revision history of this manual. Table 1-3. Revision History of This Manual Revision Change Description 1-4 Publication Version 1.0, March 2006 About This Manual Chapter 2 Overview The 7300S Series Stackable Switch software has two purposes: · · Assist attached hardware in switching frames, based on Layer 2, 3, or 4 information contained in the frames. Provide a complete device management portfolio to the network administrator. 2.1 Scope 7300S Series Stackable Switch software encompasses both hardware and software support. It software is partitioned to run in the following processors: · CPU--This code runs the networking device management portfolio and controls the overall networking device hardware. It also assists in frame forwarding, as needed and specified. This code is designed to run on multiple platforms with minimal changes from platform to platform. Networking Device Processor--This code does the majority of the packet switching, usually at wire speed. This code is platform dependent, and substantial changes might exist across products. · 2.2 Using the Command-Line Interface The command-line interface (CLI) is a text-based way to manage and monitor the system. You can access the CLI by using a direct serial connection or by using a remote logical connection with telnet or SSH. This section describes the CLI syntax, conventions, and modes. It contains the following topics: · · · · Overview v1.0, March 2006 Section 2.2.1 "Command Syntax" on page 2-2 Section 2.2.2 "Command Conventions" on page 2-2 Section 2.2.3 "Unit-Slot-Port Naming Convention" on page 2-4 Section 2.2.4 "Using the "No" Form of a Command" on page 2-5 2-1 Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, · · · · Section 2.2.5 "Command Modes" on page 2-5 Section 2.2.6 "Entering CLI Commands" on page 2-8 Section 2.2.7 "Using CLI Help" on page 2-10 Section 2.2.8 "Accessing the CLI" on page 2-11 2.2.1 Command Syntax A command is one or more words that might be followed by one or more parameters. Parameters can be required or optional values. Some commands, such as show network or clear vlan, do not require parameters. Other commands, such as network parms, require that you supply a value after the command. You must type the parameter values in a specific order, and optional parameters follow required parameters. The following example describes the network parms command syntax: Format · · · network parms [gateway] network parms is the command name. and are parameters and represent required values that you must enter after you type the command keywords. [gateway] is an optional parameter, so you are not required to enter a value in place of the parameter. The CLI Command Reference lists each command by the command name and provides a brief description of the command. Each command reference also contains the following information: · · · Format shows the command keywords and the required and optional parameters. Mode identifies the command mode you must be in to access the command. Default shows the default value, if any, of a configurable setting on the device. The show commands also contain a description of the information that the command displays. 2.2.2 Command Conventions In this document, the command name is in bold font. Parameters are in italic font. You must replace the parameter name with an appropriate value, which might be a name or number. Parameters are order dependent. 2-2 v1.0, March 2006 Overview Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, The parameters for a command might include mandatory values, optional values, or keyword choices. Table 2-1 describes the conventions this document uses to distinguish between value types. Table 2-1. Parameter Conventions Symbol <> angle brackets [] square brackets Example [value] Description Indicates that you must enter a value in place of the brackets and text inside them. Indicates an optional parameter that you can enter in place of the brackets and text inside them. Indicates that you must select a parameter from the list of choices. Separates the mutually exclusive choices. Indicate a choice within an optional element. {} curly braces | Vertical bars [{}] Braces within square brackets {choice1 | choice2} choice1 | choice2 [{choice1} choice2}] 2.2.2.1 Common Parameter Values Parameter values might be names (strings) or numbers. To use spaces as part of a name parameter, enclose the name value in double quotes. For example, the expression "System Name with Spaces" forces the system to accept the spaces. Empty strings (" ") are not valid user-defined strings. Table 2-2 describes common parameter values and value formatting. Table 2-2. Parameter Descriptions Parameter ipaddr Description This parameter is a valid IP address. You can enter the IP address in the following formats: a (32 bits) a.b (8.24 bits) a.b.c (8.8.16 bits) a.b.c.d (8.8.8.8) In addition to these formats, the CLI accepts decimal, hexidecimal and octal formats through the following input formats (where n is any valid hexidecimal, octal or decimal number): 0xn (CLI assumes hexidecimal format) 0n (CLI assumes octal format with leading zeros) n (CLI assumes decimal format) The MAC address format is six hexadecimal numbers separated by colons, for example 00:06:29:32:81:40. macaddr Overview v1.0, March 2006 2-3 Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, Table 2-2. Parameter Descriptions Parameter areaid Description Enter area IDs in dotted-decimal notation (for example, 0.0.0.1). An area ID of 0.0.0.0 is reserved for the backbone. Area IDs have the same format as IP addresses but are distinct from IP addresses. You can use the IP network number of the sub-netted network for the area ID. Enter the value of in dotted-decimal notation, such as 0.0.0.1. A router ID of 0.0.0.0 is invalid. Valid slot and port number separated by forward slashes. For example, 0/1 represents slot number 0 and port number 1. Logical slot and port number. This is applicable in the case of a port-channel (LAG). You can use the logical unit/slot/port to configure the port-channel. Use double quotation marks to identify character strings, for example, "System Name with Spaces". An empty string ("") is not valid. routerid Interface or unit/slot/port Logical Interface Character strings 2.2.3 Unit-Slot-Port Naming Convention 7300S Series Stackable Switch software references physical entities such as cards and ports by using a Unit-Slot-Port (USP) naming convention. The software also uses this convention to identify certain logical entities, such as port-channel interfaces. The slot number has two uses. In the case of physical ports, it identifies the card containing the ports. In the case of logical and CPU ports it also identifies the type of interface or port. Table 2-3. Type of Slots Slot Type Physical slot numbers Logical slot numbers CPU slot numbers Description Physical slot numbers begin with zero, and are allocated up to the maximum number of physical slots. Logical slots immediately follow physical slots and identify portchannel (LAG) or router interfaces. The CPU slots immediately follow the logical slots. 2-4 v1.0, March 2006 Overview Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, The port identifies the specific physical port or logical interface being managed on a given slot. Table 2-4. Type of Ports Port Type Physical Ports Logical Interfaces Description The physical ports for each slot are numbered sequentially starting from zero. Port-channel or Link Aggregation Group (LAG) interfaces are logical interfaces that are only used for bridging functions. VLAN routing interfaces are only used for routing functions. CPU ports are handled by the driver as one or more physical entities located on physical slots. CPU ports 2.2.4 Using the "No" Form of a Command The no keyword is a specific form of an existing command and does not represent a new or distinct command. Almost every configuration command has a no form. In general, use the no form to reverse the action of a command or reset a value back to the default. For example, the no shutdown configuration command reverses the shutdown of an interface. Use the command without the keyword no to re-enable a disabled feature or to enable a feature that is disabled by default. Only the configuration commands are available in the no form. 2.2.5 Command Modes The CLI groups commands into modes according to the command function. Each of the command modes supports specific 7300S Series Stackable Switch software commands. The commands in one mode are not available until you switch to that particular mode, with the exception of the User EXEC mode commands. You can execute the User EXEC mode commands in the Privileged EXEC mode. Overview v1.0, March 2006 2-5 Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, The command prompt changes in each command mode to help you identify the current mode. Table 2-5 describes the command modes and the prompts visible in that mode. Table 2-5. CLI Command Modes Command Mode User EXEC Prompt Switch> Mode Description Contains a limited set of commands to view basic system information. Allows you to issue any EXEC command, enter the VLAN mode, or enter the Global Configuration mode. Groups general setup commands and permits you to make modifications to the running configuration. Groups all the VLAN commands. Allows you to enable or modify the operation of an interface and provides access to the router interface configuration commands. Use this mode to set up a physical port for a specific logical connection operation. Allows you to configure various telnet settings and the console interface. Allows you to access the QoS Policy-Map configuration mode to configure the QoS Policy-Map. Consists of class creation, deletion, and matching commands. The class match commands specify Layer 2, Layer 3, and general match criteria. Allows you to access the QoS Class-Map configuration mode to configure QoS class maps. Allows you to access the router OSPF configuration commands. Privileged EXEC Switch# Global Config Switch (Config)# VLAN Config Interface Config Switch (Vlan)# Switch (Interface )# Line Config Switch (line)# Policy Map Config Switch (Config policy-map)# Policy Class Config Switch (Config policy-class-map)# Class Map Config Switch (Config class-map)# Router OSPF Config Switch (Config router)# 2-6 v1.0, March 2006 Overview Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, Table 2-5. CLI Command Modes (continued) Command Mode Router RIP Config Router BGP Config MAC Access-list Config Prompt Switch (Config router)# Switch (Config router)# Switch (Config mac-access-list)# Mode Description Allows you to access the router RIP configuration commands. Allows you to access the router BGP4 configuration commands. Allows you to create a MAC Access-List and to enter the mode containing Mac AccessList configuration commands. Allows you to access the DHCP Pool configuration. Allows you to access the Stack Global Config Mode. DHCP Pool Config Stack Global Config Mode Switch (Config dhcp-pool)# Switch (Config stack)# Table 2-6 explains how to enter or exit each command mode. Table 2-6. CLI Mode Access and Exit Command Mode User EXEC Privileged EXEC Global Config VLAN Config Interface Config Access Method This is the first level of access. From the User EXEC mode, enter enable. From the Privileged EXEC mode, enter configure. From the Privileged EXEC mode, enter vlan database. From the Global Config mode, enter interface . From the Global Config mode, enter lineconfig. From the Global Config mode, enter policy-map. From the Policy Map mode enter class. Exit or Access Previous Mode To exit, enter logout. To exit to the User EXEC mode, enter exit or press Ctrl-Z. To exit to the Privileged EXEC mode, enter exit, or press Ctrl-Z. To exit to the Privileged EXEC mode, enter exit, or press Ctrl-Z. To exit to the Global Config mode, enter exit. To return to the Privileged EXEC mode, enter Ctrl-Z. To exit to the Global Config mode, enter exit. To return to the Privileged EXEC mode, enter Ctrl-Z. To exit to the Global Config mode, enter exit. To return to the Privileged EXEC mode, enter Ctrl-Z. To exit to the Policy Map mode, enter exit. To return to the Privileged EXEC mode, enter Ctrl-Z. Line Config Policy-Map Config Policy-Class-Map Config Overview v1.0, March 2006 2-7 Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, Table 2-6. CLI Mode Access and Exit (continued) Command Mode Class-Map Config Router OSPF Config Router RIP Config Router BGP Config MAC Access-list Config DHCP Pool Config Stack Global Config Mode Access Method From the Global Config mode, enter class-map. From the Global Config mode, enter router ospf. From the Global Config mode, enter router rip. From the Global Config mode, enter router bgp . From the Global Config mode enter mac access-list extended . From the Global Config mode, enter ip dhcp pool . From the Global Config mode, enter the stack command. Exit or Access Previous Mode To exit to the Global Config mode, enter exit. To return to the Privileged EXEC mode, enter Ctrl-Z. To exit to the Global Config mode, enter exit. To return to the Privileged EXEC mode, enter Ctrl-Z. To exit to the Global Config mode, enter exit. To return to the Privileged EXEC mode, enter Ctrl-Z. To exit to the Global Config mode, enter exit. To return to the Privileged EXEC mode, enter Ctrl-Z. To exit to the Global Config mode, enter exit. To return to the Privileged EXEC mode, enter Ctrl-Z. To exit to the Global Config mode, enter exit. To return to the Privileged EXEC mode, enter Ctrl-Z. To exit to the Global Config mode, enter the exit command. To return to the Privileged EXEC mode, enter Ctrl-Z. 2.2.6 Entering CLI Commands The 7300S Series Stackable Switch supports several features to help you enter commands. 2.2.6.1 Command Completion and Abbreviation Command completion finishes spelling the command when you type enough letters of a command to uniquely identify the command keyword. Once you have entered enough letters, press the SPACEBAR or TAB key to complete the word. Command abbreviation allows you to execute a command when you type enough letters of a command to uniquely identify the command. You must enter all of the required keywords and parameters before you enter the command. 2-8 v1.0, March 2006 Overview Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, 2.2.6.2 CLI Error Messages If you enter a command and the system is unable to execute it, an error message appears. Table 2-7 describes the most common CLI error messages. Table 2-7. CLI Error Messages Message Text % Invalid input detected at '^' marker. Description Indicates that you entered an incorrect or unavailable command. The carat (^) shows where the invalid text is detected. This message also appears if any of the parameters or values are not recognized. Indicates that you did not enter the required keywords or values. Indicates that you did not enter enough letters to uniquely identify the command. Command not found / Incomplete command. Use ? to list commands. Ambiguous command 2.2.6.3 CLI Line-Editing Conventions Table 2-8 describes the key combinations you can use to edit commands or increase the speed of command entry. You can access this list from the CLI by entering help from the User or Privileged EXEC modes. Table 2-8. CLI Editing Conventions Key Sequence DEL or Backspace Ctrl-A Ctrl-E Ctrl-F Ctrl-B Ctrl-D Ctrl-U, X Ctrl-K Ctrl-W Ctrl-T Ctrl-P Ctrl-R Ctrl-N Ctrl-Y Ctrl-Q Description Delete previous character Go to beginning of line Go to end of line Go forward one character Go backward one character Delete current character Delete to beginning of line Delete to end of line Delete previous word Transpose previous character Go to previous line in history buffer Rewrites or pastes the line Go to next line in history buffer Prints last deleted character Enables serial flow Overview v1.0, March 2006 2-9 Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, Table 2-8. CLI Editing Conventions Key Sequence Ctrl-S Ctrl-Z Tab, Exit ? Description Disables serial flow Return to root command prompt Command-line completion Go to next lower command prompt List available commands, keywords, or parameters 2.2.7 Using CLI Help Enter a question mark (?) at the command prompt to display the commands available in the current mode. (switch) >? enable help logout ping show Enter into user privilege mode. Display help for various special keys. Exit this session. Any unsaved changes are lost. Send ICMP echo packets to a specified IP address. Display switch options and settings. Enter a question mark (?) after each word you enter to display available command keywords or parameters. (switch) #network ? javamode parms protocol mgmt_vlan Enable/Disable. Configure Network Parameters of the router. Select DHCP, BootP, or None as the network config protocol. Configure the Management VLAN ID of the switch. If the help output shows a parameter in angle brackets, you must replace the parameter with a value. (switch) #network parms ? Enter the IP Address. If there are no additional command keywords or parameters, or if additional parameters are optional, the following message appears in the output: Press Enter to execute the command 2-10 v1.0, March 2006 Overview Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, You can also enter a question mark (?) after typing one or more characters of a word to list the available command or parameters that begin with the letters, as shown in the following example: (switch) #show m? mac-addr-table mac-address-table monitor 2.2.8 Accessing the CLI You can access the CLI by using a direct console connection or by using a telnet or SSH connection from a remote management host. For the initial connection, you must use a direct connection to the console port. You cannot access the system remotely until the system has an IP address and subnet mask. You can set the network configuration information manually, or you can configure the system to accept these settings from a BOOTP or DHCP server on your network. For more information, see Section 3.1 "Network Interface Commands" on page 3-1. Overview v1.0, March 2006 2-11 Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, 2-12 v1.0, March 2006 Overview Chapter 3 Administrative Access Commands This section describes the management access and basic port configuration commands available in the 7300S Series Stackable Switch CLI. This section contains the following topics: · · · · · · Section 3.1 "Network Interface Commands" on page 3-1 Section 3.2 "Console Port Access Commands" on page 3-5 Section 3.3 "Telnet Commands" on page 3-8 Section 3.4 "Secure Shell (SSH) Command" on page 3-13 Section 3.5 "Hypertext Transfer Protocol (HTTP) Commands" on page 3-15 Section 3.6 "User Account Commands" on page 3-18 The commands in this section are divided into two functional groups: · · Show commands display switch settings, statistics, and other information. Configuration commands configure features and options of the switch. For every configuration command, there is a show command that displays the configuration setting. To manage the device by using SNMP, see "SNMP Commands" in Chapter 10. 3.1 Network Interface Commands This section describes the commands you use to configure a logical interface for management access. Note: The service port commands are for out-of-band network management using the dedicated service port on the platform. The network commands are used for in-band management using the data ports. Administrative Access Commands v1.0, March 2006 3-1 Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, 3.1.1 enable This command gives you access to the Privileged EXEC mode. From the Privileged EXEC mode, you can configure the network interface. Format Mode enable User EXEC 3.1.2 serviceport ip This command sets the IP address, the netmask and the gateway of the network management port. Format Mode serviceport ip [gateway] Privileged EXEC 3.1.3 serviceport protocol This command specifies the network management port configuration protocol. If you modify this value, the change is effective immediately. If you use the bootp parameter, the switch periodically sends requests to a BootP server until a response is received. If you use the dhcp parameter, the switch periodically sends requests to a DHCP server until a response is received. If you use the none parameter, you must configure the network information for the switch manually. Format Mode serviceport protocol {none | bootp | dhcp} Privileged EXEC 3.1.4 network parms This command sets the IP Address, subnet mask and gateway of the device. The IP Address and the gateway must be on the same subnet. Format Mode network parms [] Privileged EXEC 3.1.5 network mgmt_vlan This command configures the Management VLAN ID. Default Format Mode 3-2 v1.0, March 2006 1 network mgmt_vlan <1-4069> Privileged EXEC Administrative Access Commands Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, 3.1.5.1 no network mgmt_vlan This command sets the Management VLAN ID to the default. Format Mode no network mgmt_vlan Privileged EXEC 3.1.6 network protocol This command specifies the network configuration protocol to be used. If you modify this value, change is effective immediately. If you modify this value, the change is effective immediately. If you use the bootp parameter, the switch periodically sends requests to a BootP server until a response is received. If you use the dhcp parameter, the switch periodically sends requests to a DHCP server until a response is received. If you use the none parameter, you must configure the network information for the switch manually. Default Format Mode none network protocol {none | bootp | dhcp} Privileged EXEC 3.1.7 show network This command displays configuration settings associated with the switch's network interface. The network interface is the logical interface used for in-band connectivity with the switch via any of the switch's front panel ports. The configuration parameters associated with the switch's network interface do not affect the configuration of the front panel ports through which traffic is switched or routed. Format Modes IP Address Subnet Mask Default Gateway Burned In MAC Address show network Privileged EXEC User EXEC The IP address of the interface. The factory default value is 0.0.0.0 The IP subnet mask for this interface. The factory default value is 0.0.0.0 The default gateway for this IP interface. The factory default value is 0.0.0.0 The burned in MAC address used for in-band connectivity. Administrative Access Commands v1.0, March 2006 3-3 Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, Locally Administered MAC Address If desired, a locally administered MAC address can be configured for in-band connectivity. To take effect, 'MAC Address Type' must be set to 'Locally Administered'. Enter the address as twelve hexadecimal digits (6 bytes) with a colon between each byte. Bit 1 of byte 0 must be set to a 1 and bit 0 to a 0, i.e. byte 0 should have the following mask 'xxxx xx10'. The MAC address used by this bridge when it must be referred to in a unique fashion. It is recommended that this be the numerically smallest MAC address of all ports that belong to this bridge. However it is only required to be unique. When concatenated with dot1dStpPriority a unique BridgeIdentifier is formed which is used in the Spanning Tree Protocol. Specifies which MAC address should be used for in-band connectivity. The choices are the burned in or the Locally Administered address. The factory default is to use the burned in MAC address. MAC Address Type Network Configuration Protocol Current Java Mode Indicates which network protocol is being used. The options are bootp | dhcp | none. Specifies if the switch should allow access to the Java applet in the header frame. Enabled means the applet can be viewed. The factory default is disabled. Specifies if the switch should allow access to the Web Interface. Web Mode 3.1.8 show serviceport This command displays service port configuration information. Format Mode IP Address show serviceport Privileged EXEC The IP address of the interface. The factory default value is 0.0.0.0 3-4 v1.0, March 2006 Administrative Access Commands Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, Subnet Mask Default Gateway ServPort Configuration Protocol Current Burned in MAC Address The IP subnet mask for this interface. The factory default value is 0.0.0.0 The default gateway for this IP interface. The factory default value is 0.0.0.0 Indicates what network protocol was used on the last, or current power-up cycle, if any. The burned in MAC address used for in-band connectivity. 3.2 Console Port Access Commands This section describes the commands you use to configure the console port. You can use a serial cable to connect a management host directly to the console port of the switch. 3.2.1 configuration This command gives you access to the Global Config mode. From the Global Config mode, you can configure a variety of system settings, including user accounts. From the Global Config mode, you can enter other command modes, including Line Config mode. Format Mode configuration Privileged EXEC 3.2.2 lineconfig This command gives you access to the Line Config mode, which allows you to configure various telnet settings and the console port. Format Mode lineconfig Global Config Administrative Access Commands v1.0, March 2006 3-5 Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, 3.2.3 serial baudrate This command specifies the communication rate of the terminal interface. The supported rates are 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200. Default Format Mode 3.2.3.1 no serial baudrate This command sets the communication rate of the terminal interface. Format Mode no serial baudrate 9600 serial baudrate {1200 | 2400 | 4800 | 9600 | 19200 | 38400 | 57600 | 115200} Line Config Line Config 3.2.4 serial timeout This command specifies the maximum connect time (in minutes) without console activity. A value of 0 indicates that a console can be connected indefinitely. The time range is 0 to 160. Default Format Mode 3.2.4.1 no serial timeout This command sets the maximum connect time (in minutes) without console activity. Format Mode no serial timeout 5 serial timeout <0-160> Line Config Line Config 3-6 v1.0, March 2006 Administrative Access Commands Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, 3.2.5 show serial This command displays serial communication settings for the switch. Format Modes Serial Port Login Timeout (minutes) show serial Privileged EXEC User EXEC Specifies the time, in minutes, of inactivity on a Serial port connection, after which the Switch will close the connection. Any numeric value between 0 and 160 is allowed, the factory default is 5. A value of 0 disables the timeout. The default baud rate at which the serial port will try to connect. The available values are 1200, 2400, 4800, 9600, 19200, 38400,57600, and 115200 baud. The factory default is 9600 baud. The number of bits in a character. The number of bits is always 8. Whether Hardware Flow-Control is enabled or disabled. Hardware Flow Control is always disabled. The number of Stop bits per character. The number of Stop bits is always 1. The Parity Method used on the Serial Port. The Parity Method is always None. Baud Rate (bps) Character Size (bits) Flow Control Stop Bits Parity Type Administrative Access Commands v1.0, March 2006 3-7 Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, 3.3 Telnet Commands This section describes the commands you use to configure and view telnet settings. You can use telnet to manage the device from a remote management host. 3.3.1 telnet This command establishes a new outbound telnet connection to a remote host. The host value must be a valid IP address. Valid values for port should be a valid decimal integer in the range of 0 to 65535, where the default value is 23. If [debug] is used, the current telnet options enabled is displayed. The optional line parameter sets the outbound telnet operational mode as `linemode', where by default, the operational mode is `character mode'. The noecho option disables local echo. Format Modes telnet [debug] [line] [noecho] Privileged EXEC User EXEC 3.3.2 transport input telnet This command regulates new telnet sessions. If sessions are enabled, new telnet sessions can be established until there are no more sessions available. If sessions are disabled, no new telnet sessions are established. An established session remains active until the session is ended or an abnormal network error ends the session. Default Format Mode enabled transport input telnet Line Config 3.3.2.1 no transport input telnet This command disables telnet sessions. If sessions are disabled, no new telnet sessions are established. Format Mode no transport input telnet Line Config 3-8 v1.0, March 2006 Administrative Access Commands Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, 3.3.3 transport output telnet This command regulates new outbound telnet connections. If enabled, new outbound telnet sessions can be established until it reaches the maximum number of simultaneous outbound telnet sessions allowed. If disabled, no new outbound telnet session can be established. An established session remains active until the session is ended or an abnormal network error ends it. Default Format Mode enabled transport output telnet Line Config 3.3.3.1 no transport output telnet This command disables new outbound telnet connections. If disabled, no new outbound telnet connection can be established. Format Mode no transport output telnet Line Config 3.3.4 session-limit This command specifies the maximum number of simultaneous outbound telnet sessions. A value of 0 indicates that no outbound telnet session can be established. Default Format Mode 3.3.4.1 no session-limit This command sets the maximum number of simultaneous outbound telnet sessions to the default value. Format Mode no session-limit 5 session-limit <0-5> Line Config Line Config Administrative Access Commands v1.0, March 2006 3-9 Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, 3.3.5 session-timeout This command sets the telnet session timeout value.The timeout value unit of time is minutes. A value of 0 indicates that a session remains active indefinitely. Default Format Mode 3.3.5.1 no session-timeout This command sets the telnet session timeout value to the default. The timeout value unit of time is minutes. Format Mode no session-timeout 0 session-timeout <0-160> Line Config Line Config 3.3.6 telnetcon maxsessions This command specifies the maximum number of telnet connection sessions that can be established. A value of 0 indicates that no telnet connection can be established. The range is 0 to 5. Default Format Mode 5 telnetcon maxsessions <0-5> Privileged EXEC 3.3.6.1 no telnetcon maxsessions This command sets the maximum number of telnet connection sessions that can be established to the default value. Format Mode no telnetcon maxsessions Privileged EXEC 3-10 v1.0, March 2006 Administrative Access Commands Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, 3.3.7 telnetcon timeout This command sets the telnet connection session timeout value, in minutes. A session is active as long as the session has not been idle for the value you set, which ranges from 1160 minutes. Note: Changing the timeout value for active sessions does not become effective until the session is reaccessed. Also, any keystroke activates the new timeout duration. Default Format Mode 3.3.7.1 no telnetcon timeout This command sets the telnet connection session timeout value to the default. Note: Changing the timeout value for active sessions does not become effective until the session is reaccessed. Also, any keystroke activates the new timeout duration. Format Mode no telnetcon timeout 5 telnetcon timeout <1-160> Privileged EXEC Privileged EXEC 3.3.8 show telnet This command displays the current outbound telnet settings. Format Modes Outbound Telnet Login Timeout Maximum Number of Outbound Telnet Sessions show telnet Privileged EXEC User EXEC Indicates the number of minutes an outbound telnet session is allowed to remain inactive before being logged off. Indicates the number of simultaneous outbound telnet connections allowed. 3-11 v1.0, March 2006 Administrative Access Commands Command Line Interface Reference for the ProSafe 7300S Series Layer-3 Stackable Switches, Allow New Outbound Telnet Sessions Indicates whether outbound telnet sessions are allowed. 3.3.9 show telnetcon This command displays telnet settings. Format Modes Remote Connection Login Timeout (minutes) show telnetcon Privileged EXEC User EXEC This object indicates the number of minutes a remote connection session is allowed to remain inactive before being logged off. May be specified as a number from 1 to 160. The factory default is 5.