Command Line Interface (CLI)
User Manual
9.0.2
GSM5212P GSM7212F GSM7212P GSM7224P XSM7224S
350 East Plumeria Drive
San Jose, CA 95134
USA
November 2011 202-10936-01 1.0
ProSafe Managed Switch
© 2011 NETGEAR, Inc. All rights reserved.
No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language in any form or by any means without the written permission of NETGEAR, Inc.
Technical Support
Thank you for choosing NETGEAR. To register your product, get the latest product updates, or get support online, visit us at http://support.netgear.com.
Phone (US & Canada only): 1-888-NETGEAR
Phone (Other Countries): See Support information card.
Trademarks
NETGEAR, the NETGEAR logo, ReadyNAS, ProSafe, Smart Wizard, Auto Uplink, X-RAID2, and NeoTV are trademarks or registered trademarks of NETGEAR, Inc. Microsoft, Windows, Windows NT, and Vista are registered trademarks of Microsoft Corporation. Other brand and product names are registered trademarks or trademarks of their respective holders.
Statement of Conditions
To improve 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.
Revision History
Publication Part |
Version |
Publish Date |
Comments |
Number |
|
|
|
|
|
|
|
202-10936-01 |
1.0 |
November 2011 |
Add PoE and MVR mode features. |
|
|
|
|
202-10515-05 |
1.1 |
June 2011 |
Add DHCPv6 and DHCPv6 mode features. |
|
|
|
|
202-10515-04 |
1.0 |
November 2010 |
New document template. |
|
|
|
|
202-10515-03 |
v 1.0 |
June 2010 |
Move some content to the Software Setup |
|
|
|
Guide. |
|
|
|
|
202-10515-02 |
|
|
Software release 8.0.2: new firmware with |
|
|
|
DHCP L3 Relay, color conform policy, DHCP |
|
|
|
server in dynamic mode, and configuring a |
|
|
|
stacking port as an Ethernet port. |
|
|
|
|
202-10515-01 |
|
|
Original publication. |
|
|
|
|
2
Chapter 1 Using the Command-Line Interface
Licensing and Command Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Command Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Common Parameter Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Unit/Slot/Port Naming Convention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Using a Command’s “No” Form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Managed Switch Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Command Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Command Completion and Abbreviation . . . . . . . . . . . . . . . . . . . . . . . . . . 17
CLI Error Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
CLI Line-Editing Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Using CLI Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Accessing the CLI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Chapter 2 Stacking Commands
Dedicated Port Stacking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Front Panel Stacking Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Non-Stop Forwarding Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Stack Firmware Synchronization Commands. . . . . . . . . . . . . . . . . . . . . . . 34
Chapter 3 Switching Commands
Port Configuration Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Loopback Interface Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Spanning Tree Protocol (STP) Commands . . . . . . . . . . . . . . . . . . . . . . . . 46
VLAN Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Double VLAN Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Voice VLAN Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Provisioning (IEEE 802.1p) Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Protected Ports Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Private Group Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
GARP Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
GVRP Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
GMRP Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Port-Based Network Access Control Commands. . . . . . . . . . . . . . . . . . . . 91
802.1X Supplicant Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Storm-Control Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Port-Channel/LAG (802.3ad) Commands . . . . . . . . . . . . . . . . . . . . . . . . 118
Port Mirroring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
3
ProSafe Managed Switch
Static MAC Filtering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
DHCP L2 Relay Agent Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
DHCP Client Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
DHCP Snooping Configuration Commands . . . . . . . . . . . . . . . . . . . . . . . 145
Dynamic ARP Inspection Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
IGMP Snooping Configuration Commands . . . . . . . . . . . . . . . . . . . . . . . 161
IGMP Snooping Querier Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
MLD Snooping Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
MLD Snooping Querier Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
set mld querier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
set mld querier query_interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
set mld querier timer expiry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
set mld querier election participate. . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
show mldsnooping querier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
Port Security Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
LLDP (802.1AB) Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
LLDP-MED Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
Denial of Service Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
MAC Database Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
ISDP Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
Priority-Based Flow Control Commands . . . . . . . . . . . . . . . . . . . . . . . . . 220
Chapter 4 Multicast VLAN Registration (MVR)
About MVR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
MVR Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Chapter 5 Routing Commands
Address Resolution Protocol (ARP) Commands . . . . . . . . . . . . . . . . . . . 232
IP Routing Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Router Discovery Protocol Commands . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Virtual LAN Routing Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Virtual Router Redundancy Protocol Commands. . . . . . . . . . . . . . . . . . . 254
DHCP and BOOTP Relay Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
IP Helper Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Open Shortest Path First (OSPF) Commands . . . . . . . . . . . . . . . . . . . . . 268
OSPF Graceful Restart Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305
nsf. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
nsf restart-interval. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
nsf helper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
nsf helper disable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
nsf [ietf] helper strict-lsa-checking . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
Routing Information Protocol (RIP) Commands . . . . . . . . . . . . . . . . . . . . 308
ICMP Throttling Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
Chapter 6 IP Multicast Commands
Multicast Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
4
ProSafe Managed Switch
DVMRP Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324
PIM Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .329
Internet Group Message Protocol (IGMP) Commands. . . . . . . . . . . . . . .340
IGMP Proxy Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347
Chapter 7 IPv6 Commands
Tunnel Interface Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .354
IPv6 Routing Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .355
OSPFv3 Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .376
OSPFv3 Graceful Restart Commands . . . . . . . . . . . . . . . . . . . . . . . . . . .407
DHCPv6 Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .409
Chapter 8 IPv6 Multicast Commands
IPv6 Multicast Forwarder Commands . . . . . . . . . . . . . . . . . . . . . . . . . . .418
IPv6 PIM Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .420
IPv6 MLD Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .428
IPv6 MLD-Proxy Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .434
Chapter 9 Quality of Service (QoS) Commands
Class of Service (CoS) Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . .440 Differentiated Services (DiffServ) Commands . . . . . . . . . . . . . . . . . . . . .448 DiffServ Class Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .449 DiffServ Policy Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .457 DiffServ Service Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .463 DiffServ Show Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .464 MAC Access Control List (ACL) Commands . . . . . . . . . . . . . . . . . . . . . .470 IP Access Control List (ACL) Commands. . . . . . . . . . . . . . . . . . . . . . . . .474 IPv6 Access Control List (ACL) Commands. . . . . . . . . . . . . . . . . . . . . . .481 Time Range Commands for Time-Based ACLs . . . . . . . . . . . . . . . . . . . .485 Auto-Voice over IP Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .488
Chapter 10 Power over Ethernet (PoE) Commands
About PoE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .490
PoE Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .491
Chapter 11 Utility Commands
Auto Install Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .502
Dual Image Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .504
System Information and Statistics Commands. . . . . . . . . . . . . . . . . . . . .506
Logging Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .516
Email Alerting and Mail Server Commands . . . . . . . . . . . . . . . . . . . . . . .520
System Utility and Clear Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . .527
Simple Network Time Protocol (SNTP) Commands. . . . . . . . . . . . . . . . .536
DHCP Server Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .543
DNS Client Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .555
5
ProSafe Managed Switch
Packet Capture Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560
Serviceability Packet Tracing Commands . . . . . . . . . . . . . . . . . . . . . . . . 561
Cable Test Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579
sFlow Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579
Software License Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584
IP Address Conflict Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585
Link Local Protocol Filtering Commands . . . . . . . . . . . . . . . . . . . . . . . . . 586
Chapter 12 Management Commands
Configuring the Switch Management CPU. . . . . . . . . . . . . . . . . . . . . . . . 589
Network Interface Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591
Console Port Access Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594
Telnet Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
Secure Shell (SSH) Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601
Management Security Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604
Hypertext Transfer Protocol (HTTP) Commands . . . . . . . . . . . . . . . . . . . 605
Access Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612
User Account Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612
SNMP Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628
RADIUS Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639
TACACS+ Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 651
Configuration Scripting Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 655
Pre-login Banner and System Prompt Commands . . . . . . . . . . . . . . . . . 657
Switch Database Management (SDM) Templates . . . . . . . . . . . . . . . . . . 658
IPv6 Management Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 659
Chapter 13 Log Messages
Core . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 665
Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 667
Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 669
Switching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 673
QoS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 679
Routing/IPv6 Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 680
Multicast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 683
Stacking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 685
Technologies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686
O/S Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688
Chapter 14 Captive Portal Commands
Captive Portal Global Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 690
Captive Portal Configuration Commands . . . . . . . . . . . . . . . . . . . . . . . . . 694
Captive Portal Status Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 700
Captive Portal Client Connection Commands . . . . . . . . . . . . . . . . . . . . . 704
Captive Portal Interface Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708
Captive Portal Local User Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 709
Captive Portal User Group Commands . . . . . . . . . . . . . . . . . . . . . . . . . . 715
6
ProSafe Managed Switch
Chapter 15 Command List
Index
7
1. Using the Command-Line Interface |
1 |
|
|
||
|
|
|
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 chapter describes the CLI syntax, conventions, and modes. It contains the following sections:
•Licensing and Command Support
•Command Syntax
•Command Conventions
•Common Parameter Values
•Unit/Slot/Port Naming Convention
•Using a Command’s “No” Form
•Managed Switch Modules
•Command Modes
•Command Completion and Abbreviation
•CLI Error Messages
•CLI Line-Editing Conventions
•Using CLI Help
•Accessing the CLI
As shown in the following table, some command groups or commands require a license and some are supported on particular switch models. For those requiring a license, license keys
8
ProSafe Managed Switch
are available from your VAR or NETGEAR authorized e-commerce portal. License activation is described in the Software Setup Manual.
Command Group or Command |
XSM7224S |
GSM7212F/GSM7212P/ |
|
|
GSM7224P/GSM5212P |
|
|
|
Front Panel Stacking Commands |
Supported |
Not supported |
|
|
|
Non-Stop Forwarding Commands |
Supported |
Not supported |
|
|
|
Stack Firmware Synchronization Commands |
Supported |
Not supported |
|
|
|
Router Discovery Protocol Commands |
Require license |
Not supported |
|
|
|
Virtual Router Redundancy Protocol Commands |
Require license |
Not supported |
|
|
|
Open Shortest Path First (OSPF) Commands |
Require license |
Not supported |
|
|
|
OSPF Graceful Restart Commands |
Require license |
Not supported |
|
|
|
Routing Information Protocol (RIP) Commands |
Require license |
Not supported |
|
|
|
Tunnel Interface Commands |
Require license |
Not supported |
|
|
|
IPv6 Routing Commands |
Require license |
Not supported |
|
|
|
OSPFv3 Commands |
Require license |
Not supported |
|
|
|
OSPFv3 Graceful Restart Commands |
Require license |
Not supported |
|
|
|
DHCPv6 Commands |
Require license |
Not supported |
|
|
|
Multicast Commands |
Require license |
Not supported |
|
|
|
DVMRP Commands |
Require license |
Not supported |
|
|
|
PIM Commands |
Require license |
Not supported |
|
|
|
Internet Group Message Protocol (IGMP) |
Require license |
Not supported |
Commands |
|
|
|
|
|
IGMP Proxy Commands |
Require license |
Not supported |
|
|
|
IPv6 Multicast Forwarder Commands |
Require license |
Not supported |
|
|
|
IPv6 PIM Commands |
Require license |
Not supported |
|
|
|
IPv6 MLD Commands |
Require license |
Not supported |
|
|
|
IPv6 MLD-Proxy Commands |
Require license |
Not supported |
|
|
|
PoE Commands |
Not supported |
Supported |
|
|
|
MVR Commands |
Not supported |
Supported |
|
|
|
Link Local Protocol Filtering Commands |
Supported |
Not supported |
|
|
|
Priority-Based Flow Control Commands |
Supported |
Not supported |
|
|
|
Captive Portal Commands |
Supported |
Not supported |
|
|
|
Using the Command-Line Interface
9
ProSafe Managed Switch
Command Group or Command |
XSM7224S |
GSM7212F/GSM7212P/ |
|
|
GSM7224P/GSM5212P |
|
|
|
cos-queue random-detect |
Supported |
Not supported |
|
|
|
no cos-queue random-detect |
Supported |
Not supported |
|
|
|
random-detect exponential weighting-constant |
Supported |
Not supported |
|
|
|
no random-detect exponential weighting-constant |
Supported |
Not supported |
|
|
|
random-detect queue-parms |
Supported |
Not supported |
|
|
|
no random-detect queue-parms |
Supported |
Not supported |
|
|
|
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 <ipaddr> <netmask> [gateway]
•network parms is the command name.
•<ipaddr> and <netmask> 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 New Template User Manual 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 shows.
Using the Command-Line Interface
10
ProSafe Managed Switch
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.
The parameters for a command might include mandatory values, optional values, or keyword choices. Table 1 describes the conventions this document uses to distinguish between value types.
Table 1. Parameter Conventions
Symbol |
Example |
Description |
|
|
|
<> angle brackets |
<value> |
Indicates that you must enter a value in place of the |
|
|
brackets and text inside them. |
[] square brackets |
[value] |
Indicates an optional parameter that you can enter in |
|
|
place of the brackets and text inside them. |
|
|
|
{} curly braces |
{choice1 | |
Indicates that you must select a parameter from the list of |
|
choice2} |
choices. |
| Vertical bars |
choice1 | choice2 |
Separates the mutually exclusive choices. |
|
|
|
[{}] Braces within |
[{choice1 | |
Indicates a choice within an optional element. |
square brackets |
choice2}] |
|
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
Using the Command-Line Interface
11
ProSafe Managed Switch
Name with Spaces” forces the system to accept the spaces. Empty strings (““) are not valid user-defined strings. Table 2 describes common parameter values and value formatting.
Table 2. Parameter Descriptions
Parameter |
Description |
|
|
ipaddr |
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, hexadecimal and octal formats |
|
through the following input formats (where n is any valid hexadecimal, octal or decimal |
|
number): |
|
0xn (CLI assumes hexadecimal format) |
|
0n (CLI assumes octal format with leading zeros) |
|
n (CLI assumes decimal format) |
ipv6-address |
FE80:0000:0000:0000:020F:24FF:FEBF:DBCB, or |
|
FE80:0:0:0:20F:24FF:FEBF:DBCB, or |
|
FE80::20F24FF:FEBF:DBCB, or |
|
FE80:0:0:0:20F:24FF:128:141:49:32 |
|
For additional information, refer to RFC 3513. |
|
|
Interface or |
Valid slot and port number separated by forward slashes. For example, 0/1 represents slot |
unit/slot/port |
number 0 and port number 1. |
|
|
Logical Interface |
Represents a 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. |
|
|
Character strings |
Use double quotation marks to identify character strings, for example, “System Name with |
|
Spaces”. An empty string (“”) is not valid. |
|
|
Managed switch software references physical entities such as cards and ports by using a unit/slot/port 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 3. Type of Slots
Slot Type |
Description |
|
|
Physical slot numbers |
Physical slot numbers begin with zero, and are allocated up to the maximum |
|
number of physical slots. |
|
|
Logical slot numbers |
Logical slots immediately follow physical slots and identify port-channel (LAG) or |
|
router interfaces. |
|
|
CPU slot numbers |
The CPU slots immediately follow the logical slots. |
|
|
Using the Command-Line Interface
12
ProSafe Managed Switch
The port identifies the specific physical port or logical interface being managed on a given slot.
Table 4. Type of Ports
Port Type |
Description |
|
|
Physical Ports |
The physical ports for each slot are numbered sequentially starting from zero. |
|
|
Logical Interfaces |
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. |
|
Loopback interfaces are logical interfaces that are always up. |
|
Tunnel interfaces are logical point-to-point links that carry encapsulated packets. |
|
|
CPU ports |
CPU ports are handled by the driver as one or more physical entities located on |
|
physical slots. |
|
|
Note: In the CLI, loopback and tunnel interfaces do not use the unit/slot/port format. To specify a loopback interface, you use the loopback ID. To specify a tunnel interface, you use the tunnel ID.
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.
Managed switch software consists of flexible modules that can be applied in various combinations to develop advanced Layer 2/3/4+ products. The commands and command modes available on your switch depend on the installed modules. Additionally, for some show commands, the output fields might change based on the modules included in the software.
The software suite includes the following modules:
•Switching (Layer 2)
•Routing (Layer 3)
•IPv6—IPv6 routing
•Multicast
Using the Command-Line Interface
13
ProSafe Managed Switch
•Quality of Service
•Management (CLI, Web UI, and SNMP)
•IPv6 Management—Allows management of the device through an IPv6 through an IPv6 address without requiring the IPv6 Routing package in the system. The management address can be associated with the network port (front-panel switch ports) and a routine interface (port or VLAN).
•Stacking
Not all modules are available for all platforms or software releases.
The CLI groups commands into modes according to the command function. Each of the command modes supports specific 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.
The command prompt changes in each command mode to help you identify the current mode. Table 5 describes the command modes and the prompts visible in that mode.
Note: The command modes available on your switch depend on the software modules that are installed. For example, a switch that does not support BGPv4 does not have the Router BGPv4 Command Mode.
Table 5. CLI Command Modes
Command Mode |
Prompt |
Mode Description |
|
|
|
User EXEC |
Switch> |
Contains a limited set of commands to view |
|
|
basic system information. |
|
|
|
Privileged EXEC |
Switch# |
Allows you to issue any EXEC command, enter |
|
|
the VLAN mode, or enter the Global |
|
|
Configuration mode. |
|
|
|
Global Config |
Switch (Config)# |
Groups general setup commands and permits |
|
|
you to make modifications to the running |
|
|
configuration. |
|
|
|
VLAN Config |
Switch (Vlan)# |
Groups all the VLAN commands. |
|
|
|
Using the Command-Line Interface
14
ProSafe Managed Switch
Table 5. CLI Command Modes (Continued)
Command Mode |
Prompt |
Mode Description |
|
|
|
Interface Config |
Switch (Interface <unit/slot/port>)# |
Manages the operation of an interface and |
|
|
provides access to the router interface |
|
Switch (Interface Loopback <id>)# |
configuration commands. |
|
Use this mode to set up a physical port for a |
|
|
|
|
|
Switch (Interface Tunnel <id>)# |
specific logical connection operation. |
|
|
|
|
|
|
Line Config |
Switch (line)# |
Contains commands to configure outbound |
|
|
telnet settings and console interface settings. |
Policy Map |
Switch (Config-policy-map)# |
Contains the QoS Policy-Map configuration |
Config |
|
commands. |
|
|
|
Policy Class |
Switch (Config-policy-class-map)# |
Consists of class creation, deletion, and |
Config |
|
matching commands. The class match |
|
|
commands specify Layer 2, Layer 3, and |
|
|
general match criteria. |
Class Map Config |
Switch (Config-class-map)# |
Contains the QoS class map configuration |
|
|
commands for IPv4. |
|
|
|
Ipv6_Class-Map |
Switch (Config-class-map)# |
Contains the QoS class map configuration |
Config |
|
commands for IPv6. |
|
|
|
Router OSPF |
Switch (Config-router)# |
Contains the OSPF configuration commands. |
Config |
|
|
Router OSPFv3 |
Switch (Config rtr)# |
Contains the OSPFv3 configuration commands. |
Config |
|
|
|
|
|
Router RIP Config |
Switch (Config-router)# |
Contains the RIP configuration commands. |
|
|
|
MAC Access-list |
Switch (Config-mac-access-list)# |
Allows you to create a MAC Access-List and to |
Config |
|
enter the mode containing MAC Access-List |
|
|
configuration commands. |
TACACS Config |
Switch (Tacacs)# |
Contains commands to configure properties for |
|
|
the TACACS servers. |
|
|
|
DHCP Pool |
Switch (Config dhcp-pool)# |
Contains the DHCP server IP address pool |
Config |
|
configuration commands. |
|
|
|
DHCPv6 Pool |
Switch (Config dhcp6-pool)# |
Contains the DHCPv6 server IPv6 address pool |
Config |
|
configuration commands. |
Stack Global |
Switch (Config stack)# |
Allows you to access the Stack Global Config |
Config Mode |
|
Mode. |
|
|
|
ARP Access-List |
Switch (Config-arp-access-list)# |
Contains commands to add ARP ACL rules in |
Config Mode |
|
an ARP Access List. |
|
|
|
Using the Command-Line Interface
15
ProSafe Managed Switch
Table 6 explains how to enter or exit each mode.
Table 6. CLI Mode Access and Exit
Command Mode |
Access Method |
Exit or Access Previous Mode |
User EXEC |
This is the first level of access. |
To exit, enter logout. |
Privileged EXEC |
From the User EXEC mode, enter |
To exit to the User EXEC mode, enter exit or |
|
enable. |
press Ctrl-Z. |
Global Config |
From the Privileged EXEC mode, |
To exit to the Privileged EXEC mode, enter exit, |
|
enter configure. |
or press Ctrl-Z. |
VLAN Config |
From the Privileged EXEC mode, |
To exit to the Privileged EXEC mode, enter exit, |
|
enter vlan database. |
or press Ctrl-Z. |
Interface Config |
From the Global Config mode, |
To exit to the Global Config mode, enter exit. To |
|
enter |
return to the Privileged EXEC mode, enter |
|
interface <unit/slot/port> |
Ctrl-Z. |
|
or interface loopback <id> |
|
|
or interface tunnel <id> |
|
Line Config |
From the Global Config mode, |
To exit to the Global Config mode, enter exit. To |
|
enter |
return to the Privileged EXEC mode, enter |
|
lineconfig. |
Ctrl-Z. |
Policy-Map |
From the Global Config mode, |
To exit to the Global Config mode, enter exit. To |
Config |
enter |
return to the Privileged EXEC mode, enter |
|
policy-map <name> in. |
Ctrl-Z. |
Policy-Class-Map |
From the Policy Map mode enter |
To exit to the Policy Map mode, enter exit. To |
Config |
class. |
return to the Privileged EXEC mode, enter |
|
|
Ctrl-Z. |
Class-Map |
From the Global Config mode, |
To exit to the Global Config mode, enter exit. To |
Config |
enter |
return to the Privileged EXEC mode, enter |
|
class-map, and specify the |
Ctrl-Z. |
|
optional keyword ipv4 to specify |
|
|
the Layer 3 protocol for this class. |
|
|
See class-map on page 449 for |
|
|
more information. |
|
|
|
|
Ipv6-Class-Map |
From the Global Config mode, |
To exit to the Global Config mode, enter exit. To |
Config |
enter |
return to the Privileged EXEC mode, enter |
|
class-map and specify the |
Ctrl-Z. |
|
optional keyword ipv6 to specify |
|
|
the Layer 3 protocol for this class. |
|
|
See class-map on page 449 for |
|
|
more information. |
|
|
|
|
Router OSPF |
From the Global Config mode, |
To exit to the Global Config mode, enter exit. To |
Config |
enter |
return to the Privileged EXEC mode, enter |
|
router ospf. |
Ctrl-Z. |
Router OSPFv3 |
From the Global Config mode, |
To exit to the Global Config mode, enter exit. To |
Config |
enter |
return to the Privileged EXEC mode, enter |
|
ipv6 router ospf. |
Ctrl-Z. |
Using the Command-Line Interface
16
ProSafe Managed Switch
Table 6. CLI Mode Access and Exit (Continued)
Command Mode |
Access Method |
Exit or Access Previous Mode |
Router RIP |
From the Global Config mode, |
To exit to the Global Config mode, enter exit. To |
Config |
enter |
return to the Privileged EXEC mode, enter |
|
router rip. |
Ctrl-Z. |
MAC Access-list |
From the Global Config mode, |
To exit to the Global Config mode, enter exit. To |
Config |
enter |
return to the Privileged EXEC mode, enter |
|
mac access-list extended |
Ctrl-Z. |
|
<name>. |
|
TACACS Config |
From the Global Config mode, |
To exit to the Global Config mode, enter exit. To |
|
enter tacacs-server host |
return to the Privileged EXEC mode, enter |
|
<ip-addr>, where <ip-addr> is |
Ctrl-Z. |
|
the IP address of the TACACS |
|
|
server on your network. |
|
|
|
|
DHCP Pool |
From the Global Config mode, |
To exit to the Global Config mode, enter exit. To |
Config |
enter |
return to the Privileged EXEC mode, enter |
|
ip dhcp pool <pool-name>. |
Ctrl-Z. |
DHCPv6 Pool |
From the Global Config mode, |
To exit to the Global Config mode, enter exit. To |
Config |
enter |
return to the Privileged EXEC mode, enter |
|
ip dhcpv6 pool <pool-name>. |
Ctrl-Z. |
Stack Global |
From the Global Config mode, |
To exit to the Global Config mode, enter the exit |
Config Mode |
enter the stack command. |
command. To return to the Privileged EXEC |
|
|
mode, enter Ctrl-Z. |
ARP Access-List |
From the Global Config mode, |
To exit to the Global Config mode, enter the |
Config Mode |
enter the arp access-list |
exit command. To return to the Privileged |
|
command. |
EXEC mode, enter Ctrl-Z. |
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 have entered there are enough letters to uniquely identify the command. You must enter all of the required keywords and parameters before you enter the command.
Using the Command-Line Interface
17
ProSafe Managed Switch
If you enter a command and the system is unable to execute it, an error message appears. Table 7 describes the most common CLI error messages.
Table 7. CLI Error Messages
Message Text |
Description |
|
|
% Invalid input detected at '^' marker. |
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. |
|
|
Command not found / Incomplete |
Indicates that you did not enter the required keywords or values. |
command. Use ? to list commands. |
|
|
|
Ambiguous command |
Indicates that you did not enter enough letters to uniquely identify |
|
the command. |
|
|
Table 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 8. CLI Editing Conventions
Key Sequence |
Description |
|
|
DEL or Backspace |
Delete previous character |
|
|
Ctrl-A |
Go to beginning of line |
|
|
Ctrl-E |
Go to end of line |
|
|
Ctrl-F |
Go forward one character |
|
|
Ctrl-B |
Go backward one character |
|
|
Ctrl-D |
Delete current character |
|
|
Ctrl-U, X |
Delete to beginning of line |
|
|
Ctrl-K |
Delete to end of line |
|
|
Ctrl-W |
Delete previous word |
|
|
Ctrl-T |
Transpose previous character |
|
|
Ctrl-P |
Go to previous line in history buffer |
|
|
Ctrl-R |
Rewrites or pastes the line |
|
|
Ctrl-N |
Go to next line in history buffer |
|
|
Using the Command-Line Interface
18
ProSafe Managed Switch
Table 8. CLI Editing Conventions (Continued)
Key Sequence |
Description |
|
|
Ctrl-Y |
Prints last deleted character |
|
|
Ctrl-Q |
Enables serial flow |
|
|
Ctrl-S |
Disables serial flow |
|
|
Ctrl-Z |
Return to root command prompt |
|
|
Tab, <SPACE> |
Command-line completion |
|
|
Exit |
Go to next lower command prompt |
|
|
? |
List available commands, keywords, or parameters |
|
|
Enter a question mark (?) at the command prompt to display the commands available in the current mode.
(switch) >? |
|
enable |
Enter into user privilege mode. |
help |
Display help for various special keys. |
logout |
Exit this session. Any unsaved changes are lost. |
ping |
Send ICMP echo packets to a specified IP address. |
quit |
Exit this session. Any unsaved changes are lost. |
show |
Display Switch Options and Settings. |
telnet |
Telnet to a remote host. |
Enter a question mark (?) after each word you enter to display available command keywords or parameters.
(switch) #network ? |
|
javamode |
Enable/Disable. |
mgmt_vlan |
Configure the Management VLAN ID of the switch. |
parms |
Configure Network Parameters of the router. |
protocol |
Select DHCP, BootP, or None as the network config |
|
protocol. |
If the help output shows a parameter in angle brackets, you must replace the parameter with a value.
(switch) #network parms ?
<ipaddr> |
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:
<cr> |
Press Enter to execute the command |
Using the Command-Line Interface
19
ProSafe Managed Switch
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 |
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, subnet mask, and default gateway. 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 Network Interface Commands on page 591.
Using the Command-Line Interface
20
2. Stacking Commands |
2 |
|
|
||
|
|
|
This chapter contains the following sections:
•Dedicated Port Stacking
•Front Panel Stacking Commands
•Non-Stop Forwarding Commands
•Stack Firmware Synchronization Commands
The commands in this chapter are in 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.
The Primary Management Unit is the unit that controls the stack.
This section describes the commands you use to configure dedicated port stacking.
stack
This command sets the mode to Stack Global Config.
Format |
stack |
Mode |
Global Config |
|
member
This command configures a switch. The <unit> is the switch identifier of the switch to be added/removed from the stack. The <switchindex> is the index into the database of the supported switch types, indicating the type of the switch being preconfigured. The switch index is a 32-bit integer. This command is executed on the Primary Management Unit.
Format |
member <unit> <switchindex> |
Mode |
Stack Global Config |
|
21
ProSafe Managed Switch
Note: Switch index can be obtained by executing the show supported switchtype command in User EXEC mode.
no member
This command removes a switch from the stack. The <unit> is the switch identifier of the switch to be removed from the stack. This command is executed on the Primary Management Unit.
Format |
no member <unit> |
Mode |
Stack Global Config |
|
switch priority
This command configures the ability of a switch to become the Primary Management Unit. The <unit> is the switch identifier. The <value> is the preference parameter that allows the user to specify, priority of one backup switch over another. The range for priority is 1 to 15. The switch with the highest priority value will be chosen to become the Primary Management Unit if the active Primary Management Unit fails. The switch priority defaults to the hardware management preference value 1. Switches that do not have the hardware capability to become the Primary Management Unit are not eligible for management.
Default |
enabled |
|
|
Format |
switch <unit> priority <value> |
|
|
Mode |
Global Config |
|
switch renumber
This command changes the switch identifier for a switch in the stack. The <oldunit> is the current switch identifier on the switch whose identifier is to be changed. The <newunit> is the updated value of the switch identifier. Upon execution, the switch will be configured with the configuration information for the new switch, if any. The old switch configuration information will be retained, however the old switch will be operationally unplugged. This command is executed on the Primary Management Unit.
Note: If the management unit is renumbered, then the running configuration is no longer applied (i.e. the stack acts as if the configuration had been cleared)
Stacking Commands
22
ProSafe Managed Switch
Format |
switch <oldunit> renumber <newunit> |
Mode |
Global Config |
|
movemanagement
This command moves the Primary Management Unit functionality from one switch to another. The <fromunit> is the switch identifier on the current Primary Management Unit. The <tounit> is the switch identifier on the new Primary Management Unit. Upon execution, the entire stack (including all interfaces in the stack) is unconfigured and reconfigured with the configuration on the new Primary Management Unit. After the reload is complete, all stack management capability must be performed on the new Primary Management Unit. To preserve the current configuration across a stack move, execute the copy system:running-config nvram:startup-config (in Privileged EXEC) command before performing the stack move. A stack move causes all routes and layer 2 addresses to be lost. This command is executed on the Primary Management Unit. The system prompts you to confirm the management move.
Note: The movemanagement command does not NSF (non-stop forwarding). To move the management unit to the backup unit, use initiate failover instead. For more information, see initiate failover on page 32.
Format |
movemanagement <fromunit> <tounit> |
Mode |
Stack Global Config |
|
standby
Use this command to configure a unit as a Standby Management Unit (STBY).
Format |
standby <unit number> |
Mode |
Stack Global Config |
|
Note: The Standby Management Unit cannot be the current Management Unit. The Standby unit should be a management-capable unit.
slot
This command configures a slot in the system. The <unit/slot> is the slot identifier of the slot. The <cardindex> is the index into the database of the supported card types,
Stacking Commands
23
ProSafe Managed Switch
indicating the type of the card being preconfigured in the specified slot. The card index is a 32-bit integer. If a card is currently present in the slot that is unconfigured, the configured information will be deleted and the slot will be re-configured with default information for the card.
Format |
slot <unit/slot> <cardindex> |
Mode |
Global Config |
|
Note: Card index can be obtained by executing show supported cardtype command in User EXEC mode.
no slot
This command removes configured information from an existing slot in the system.
Format |
no slot <unit/slot> <cardindex> |
Mode |
Global Config |
|
Note: Card index can be obtained by executing show supported cardtype command in User EXEC mode.
set slot disable
This command configures the administrative mode of the slot(s). If you specify [all], the command is applied to all slots, otherwise the command is applied to the slot identified by
<unit/slot>.
If a card or other module is present in the slot, this administrative mode will effectively be applied to the contents of the slot. If the slot is empty, this administrative mode will be applied to any module that is inserted into the slot. If a card is disabled, all the ports on the device are operationally disabled and shown as “unplugged” on management screens.
Format |
set slot disable [<unit/slot> | all] |
Mode |
Global Config |
|
no set slot disable
This command unconfigures the administrative mode of the slot(s). If you specify [all], the command removes the configuration from all slots, otherwise the configuration is removed from the slot identified by <unit/slot>.
If a card or other module is present in the slot, this administrative mode removes the configuration from the contents of the slot. If the slot is empty, this administrative mode
Stacking Commands
24
ProSafe Managed Switch
removes the configuration from any module inserted into the slot. If a card is disabled, all the ports on the device are operationally disabled and shown as “unplugged” on management screens.
Format |
no set slot disable [<unit/slot> | all] |
Mode |
Global Config |
|
set slot power
This command configures the power mode of the slot(s) and allows power to be supplied to a card located in the slot. If you specify [all], the command is applied to all slots, otherwise the command is applied to the slot identified by <unit/slot>.
Use this command when installing or removing cards. If a card or other module is present in this slot, the power mode is applied to the contents of the slot. If the slot is empty, the power mode is applied to any card inserted into the slot.
Format |
set slot power [<unit/slot> | all] |
Mode |
Global Config |
|
no set slot power
This command unconfigures the power mode of the slot(s) and prohibits power from being supplied to a card located in the slot. If you specify [all], the command prohibits power to all slots, otherwise the command prohibits power to the slot identified by <unit/slot>.
Use this command when installing or removing cards. If a card or other module is present in this slot, power is prohibited to the contents of the slot. If the slot is empty, power is prohibited to any card inserted into the slot.
Format |
no set slot power [<unit/slot> | all] |
Mode |
Global Config |
|
reload (Stack)
This command resets the entire stack or the identified <unit>. The <unit> is the switch identifier. The system prompts you to confirm that you want to reset the switch.
Format |
reload [<unit>] |
Mode |
User EXEC |
|
show slot
This command displays information about all the slots in the system or for a specific slot.
Format |
show slot [<unit/slot>] |
Mode |
User EXEC |
|
Stacking Commands
25
ProSafe Managed Switch
Term |
Definition |
|
Slot |
The slot identifier in a <unit/slot> format. |
|
|
||
|
|
|
Slot Status |
The slot is empty, full, or has encountered an error |
|
|
||
|
|
|
Admin State |
The slot administrative mode is enabled or disabled. |
|
|
||
|
|
|
Power State |
The slot power mode is enabled or disabled. |
|
|
||
|
|
|
Configured Card |
The model identifier of the card preconfigured in the slot. Model Identifier is a |
|
Model Identifier |
||
32-character field used to identify a card. |
||
|
||
|
|
|
Pluggable |
Cards are pluggable or non-pluggable in the slot. |
|
|
||
|
|
|
Power Down |
Indicates whether the slot can be powered down. |
|
|
||
|
|
If you supply a value for <unit/slot>, the following additional information appears:
Term |
Definition |
|
Inserted Card |
The model identifier of the card inserted in the slot. Model Identifier is a 32-character |
|
Model Identifier |
||
field used to identify a card. This field is displayed only if the slot is full. |
||
|
||
|
|
|
Inserted Card |
The card description. This field is displayed only if the slot is full. |
|
Description |
||
|
||
Configured Card |
The card description of the card preconfigured in the slot. |
|
Description |
||
|
show supported cardtype
This commands displays information about all card types or specific card types supported in the system.
Format |
show supported cardtype [<cardindex>] |
Mode |
User EXEC |
|
If you do not supply a value for <cardindex>, the following output appears:
Term |
Definition |
|
Card Index (CID) |
The index into the database of the supported card types. This index is used when |
|
|
||
|
preconfiguring a slot. |
|
|
|
|
Card Model |
The model identifier for the supported card type. |
|
Identifier |
||
|
If you supply a value for <cardindex>, the following output appears:
Term |
Definition |
Card Type |
The 32-bit numeric card type for the supported card. |
|
|
|
|
Stacking Commands
26
ProSafe Managed Switch
Term |
Definition |
Model Identifier |
The model identifier for the supported card type. |
|
|
|
|
Card Description |
The description for the supported card type. |
|
|
|
|
show switch
This command displays information about all units in the stack or a single unit when you specify the unit value.
Format |
show switch [<unit>] |
|
Mode |
Privileged EXEC |
|
|
||
|
|
|
Term |
|
Definition |
Switch |
|
The unit identifier assigned to the switch. |
|
|
|
|
|
|
When you do not specify a value for <unit>, the following information appears:
Term |
Definition |
|
Management |
Indicates whether the switch is the Primary Management Unit, a stack member, or the |
|
Status |
||
status is unassigned. |
||
|
||
|
|
|
Preconfigured |
The model identifier of a preconfigured switch ready to join the stack. The Model |
|
Model Identifier |
||
Identifier is a 32-character field assigned by the device manufacturer to identify the |
||
|
||
|
device. |
|
|
|
|
Plugged-In Model |
The model identifier of the switch in the stack. Model Identifier is a 32-character field |
|
Identifier |
assigned by the device manufacturer to identify the device. |
|
|
||
|
|
|
Switch Status |
The switch status. Possible values for this state are: OK, Unsup ported, Code |
|
|
||
|
Mismatch, Config Mismatch, or Not Present. |
|
|
|
|
Code Version |
The detected version of code on this switch. |
|
|
||
|
|
When you specify a value for <unit>, the following information appears:
Term |
Definition |
|
Management |
Indicates whether the switch is the Primary Management Unit, a stack member, or the |
|
Status |
||
status is unassigned. |
||
|
||
|
|
|
Hardware |
The hardware management preference of the switch. The hardware management |
|
Management |
||
preference can be disabled or unassigned. |
||
Preference |
||
|
||
|
|
|
Admin |
The administrative management preference value assigned to the switch. This |
|
Management |
||
preference value indicates how likely the switch is to be chosen as the Primary |
||
Preference |
||
Management Unit. |
||
|
||
|
|
|
Switch Type |
The 32-bit numeric switch type. |
|
|
||
|
|
Stacking Commands
27
ProSafe Managed Switch
Term |
Definition |
|
Model Identifier |
The model identifier for this switch. Model Identifier is a 32-character field assigned by |
|
|
||
|
the device manufacturer to identify the device. |
|
|
|
|
Switch Status |
The switch status. Possible values are OK, Unsupported, Code Mismatch, Config |
|
|
||
|
Mismatch, or Not Present. |
|
|
|
|
Switch |
The switch description. |
|
Description |
||
|
||
Expected Code |
The expected code version. |
|
Version |
||
|
||
Detected Code |
The version of code running on this switch. If the switch is not present and the data is |
|
Version |
||
from pre-configuration, then the code version is “None”. |
||
|
||
|
|
|
Detected Code in |
The version of code that is currently stored in FLASH memory on the switch. This code |
|
Flash |
||
executes after the switch is reset. If the switch is not present and the data is from |
||
|
||
|
pre-configuration, then the code version is “None”. |
|
|
|
|
Up Time |
The system up time. |
|
|
||
|
|
show supported switchtype
This commands displays information about all supported switch types or a specific switch type.
Format |
show supported switchtype [<switchindex>] |
Mode |
User EXEC |
|
|
|
Privileged EXEC |
If you do not supply a value for <switchindex>, the following output appears:
Term |
Definition |
|
|
Switch Index (SID) The index into the database of supported switch types. This index is used when preconfiguring a member to be added to the stack.
Model Identifier |
The model identifier for the supported switch type. |
|
|
||
|
|
|
Management |
The management preference value of the switch type. |
|
Preference |
||
|
||
Code Version |
The code load target identifier of the switch type. |
|
|
If you supply a value for <switchindex>, the following output appears:
Term |
Definition |
|
Switch Type |
The 32-bit numeric switch type for the supported switch. |
|
|
||
|
|
|
Model Identifier |
The model identifier for the supported switch type. |
|
|
||
|
|
|
Switch |
The description for the supported switch type. |
|
Description |
||
|
Stacking Commands
28
ProSafe Managed Switch
This section describes the commands you use to view and configure front panel stacking information.
stack-port
This command sets front panel stacking per port to either stack or ethernet mode.
Default |
stack |
|
|
Format |
stack-port <unit/slot/port> [{ethernet | stack}] |
Mode |
Stack Global Config |
|
show stack-port
This command displays summary stack-port information for all interfaces.
Format |
show stack-port |
|
|
Mode |
Privileged EXEC |
|
|
|
|
||
|
|
|
|
Term |
|
Definition |
|
QOS Mode |
|
Front Panel Stacking QOS Mode for all Interfaces. |
|
|
|
|
|
|
|
|
|
For Each Interface: |
|
||
|
|
|
|
Term |
|
Definition |
|
Unit |
|
The unit number. |
|
|
|
|
|
|
|
|
|
Interface |
|
The slot and port numbers. |
|
|
|
|
|
|
|
|
|
Configured Stack |
Stack or Ethernet. |
|
|
Mode |
|
|
|
Running Stack |
|
Stack or Ethernet. |
|
Mode |
|
|
|
|
|
|
|
Link Status |
|
Status of the link. |
|
|
|
|
|
|
|
|
|
Link Speed |
|
Speed (Gbps) of the stack port link. |
|
|
|
|
|
|
|
|
|
show stack-port counters
This command displays summary data counter information for all interfaces.
Format |
show stack-port counters |
Mode |
Privileged EXEC |
|
Stacking Commands
29
ProSafe Managed Switch
Term |
Definition |
Unit |
The unit number. |
|
|
|
|
Interface |
The slot and port numbers. |
|
|
|
|
Tx Data Rate |
Trashing data rate in megabits per second on the stacking port. |
|
|
|
|
Tx Error Rate |
Platform-specific number of transmit errors per second. |
|
|
|
|
Tx Total Error |
Platform-specific number of total transmit errors since power-up. |
|
|
|
|
Rx Data Rate |
Receive data rate in megabits per second on the stacking port. |
|
|
|
|
Rx Error Rate |
Platform-specific number of receive errors per second. |
|
|
|
|
Rx Total Errors |
Platform-specific number of total receive errors since power-up. |
|
|
|
|
show stack-port diag
This command shows front panel stacking diagnostics for each port and is only intended for Field Application Engineers (FAEs) and developers. An FAE will advise on the necessity to run this command and capture this information.
Format |
show stack-port diag |
|
Mode |
Privileged EXEC |
|
|
||
|
|
|
Term |
|
Definition |
Unit |
|
The unit number. |
|
|
|
|
|
|
Interface |
|
The slot and port numbers. |
|
|
|
|
|
|
Diagnostic Entry1 |
80 character string used for diagnostics. |
|
|
|
|
|
|
|
Diagnostic Entry2 |
80 character string used for diagnostics. |
|
|
|
|
|
|
|
Diagnostic Entry3 |
80 character string used for diagnostics. |
|
|
|
|
|
|
|
Non-stop forwarding allows the stack units to continue to forward packets if the stack management unit restarts because of a power failure, hardware failure, or software fault.
nsf
Use this command to enable nonstop forwarding feature on the stack. When nonstop forwarding is enabled, if the management unit of a stack fails, the backup unit takes over as the master without clearing the hardware tables of any of the surviving units. Data traffic
Stacking Commands
30