BLADE OS™ Command Reference RackSwitch™ G8124 Version 5.0 Part Number: BMD00142, November 2009 2350 Mission College Blvd. Suite 600 Santa Clara, CA 95054 www.bladenetwork.
BLADE OS 5.0 Command Reference Copyright © 2009 BLADE Network Technologies, Inc., 2350 Mission College Blvd., Suite 600, Santa Clara, California, 95054, USA. All rights reserved. Part Number: BMD00142. This document is protected by copyright and distributed under licenses restricting its use, copying, distribution, and decompilation. No part of this document may be reproduced in any form by any means without prior written authorization of BLADE Network Technologies, Inc.
BLADE OS 5.0 Command Reference Contents Preface 11 Who Should Use This Book 11 How This Book Is Organized 11 Typographic Conventions 13 How To Get Help 14 Chapter 1: The Command Line Interface 15 Connecting to the Switch 15 Connecting to the Switch via Telnet 16 Connecting to the Switch via SSH 16 Accessing the Switch 17 Setup vs.
BLADE OS 5.
BLADE OS 5.
BLADE OS 5.
BLADE OS 5.
BLADE OS 5.
BLADE OS 5.
BLADE OS 5.
Preface The BLADE OS 5.0 Command Reference describes how to configure and use the BLADE OS 5.0 software with your RackSwitch G8124 (G8124). This guide lists each command, together with the complete syntax and a functional description, using the BLADE OS Command Line Interface (CLI). For documentation on installing the switches physically, see the Installation Guide for your RackSwitch G8124. For details about configuration and operation of your G8124, see the BLADE OS 5.0 Application Guide.
BLADE OS 5.0 Command Reference Chapter 7, “The Operations Menu,” shows how to use commands which affect switch performance immediately, but do not alter permanent switch configurations (such as temporarily disabling ports). The menu describes how to activate or deactivate optional software features. Chapter 8, “The Boot Options Menu,” describes the use of the primary and alternate switch images, how to load a new software image, and how to reset the software to factory defaults.
BLADE OS 5.0 Command Reference Typographic Conventions The following table describes the typographic styles used in this book. Table 1 Typographic Conventions Typeface or Symbol Meaning Example AaBbCc123 This type is used for names of commands, files, and directories used within the text. View the readme.txt file. It also depicts on-screen computer output Main# and prompts. AaBbCc123 This bold type appears in command examples. It shows text that must be typed in exactly as shown.
BLADE OS 5.0 Command Reference How To Get Help If you need help, service, or technical assistance, call BLADE Network Technologies Technical Support: US toll free calls: 1-800-414-5268 International calls: 1-408-834-7871 You also can visit our web site at the following address: http://www.bladenetwork.net Click the Support tab. The warranty card received with your product provides details for contacting a customer support representative.
CHAPTER 1 The Command Line Interface Your RackSwitch G8124 is ready to perform basic switching functions right out of the box. Some of the more advanced features, however, require some administrative configuration before they can be used effectively.
BLADE OS 5.0 Command Reference Connecting to the Switch via Telnet A Telnet connection offers the convenience of accessing the switch from any workstation connected to the network. Telnet access provides the same options for user access and administrator access as those available through the console port. To configure the switch for Telnet access, the switch must have an IP address.
BLADE OS 5.0 Command Reference The following SSH clients have been tested: OpenSSH_5.1p1 Debian-3ubuntu1 SecureCRT 5.0 (Van Dyke Technologies, Inc.) Putty beta 0.60 Note – The BLADE OS implementation of SSH supports both versions 1.5 and 2.0 and supports SSH client version 1.5 - 2.x. Using SSH to Access the Switch Once the IP parameters are configured and the SSH service is enabled on the G8124 (it is disabled by default), you can access the command line interface using an SSH connection.
BLADE OS 5.0 Command Reference Administrators are the only ones that may make permanent changes to the switch configuration—changes that are persistent across a reboot/reset of the switch. Administrators can access switch functions to configure and troubleshoot problems on the G8124. Because administrators can also make temporary (operator-level) changes as well, they must be aware of the interactions between temporary and permanent changes.
BLADE OS 5.0 Command Reference Setup vs. CLI Once the administrator password is verified, you are given complete access to the switch. If the switch is still set to its factory default configuration, the system will ask whether you wish to run Setup (see Chapter 2, “First-Time Configuration”), a utility designed to help you through the first-time configuration process. If the switch has already been configured, the Main Menu of the CLI is displayed instead.
BLADE OS 5.
CHAPTER 2 First-Time Configuration To help with the initial process of configuring your switch, the BLADE OS software includes a Setup utility. The Setup utility prompts you step-by-step to enter all the necessary information for basic configuration of the switch. This chapter describes how to use the Setup utility and how to change system passwords. Before you run Setup, you must first connect to the switch (see Chapter 1, “Connecting to the Switch”).
BLADE OS 5.0 Command Reference Optional configuration of IP parameters IP address, subnet mask, and VLAN for each IP interface IP addresses for default gateway Destination, subnet mask, and gateway IP address for each IP static route Whether IP forwarding is enabled or not Whether the RIP supply is enabled or not Starting Setup When You Log In The Setup prompt appears automatically whenever you login as the system administrator under the factory default settings. 1.
BLADE OS 5.0 Command Reference Stopping and Restarting Setup Manually Stopping Setup To abort the Setup utility, press during any Setup question. When you abort Setup, the system will prompt: Would you like to run from top again? [y/n] Enter n to abort Setup, or y to restart the Setup program at the beginning.
BLADE OS 5.0 Command Reference 3. Enter the month of the current system date at the prompt: System Date: Enter month [1]: Enter the month as a number from 1 to 12. To keep the current month, press . 4. Enter the day of the current date at the prompt: Enter day [3]: Enter the date as a number from 1 to 31. To keep the current day, press . 5. Enter the hour of the current system time at the prompt: System Time: Enter hour in 24-hour format [18]: Enter the hour as a number from 00 to 23.
BLADE OS 5.0 Command Reference Setup Part 2: Port Configuration Note – When configuring port options for your switch, some prompts and options may be different. 1. Select the port to configure, or skip port configuration at the prompt: Port Config: Will you configure VLANs and VLAN tagging for ports? [y/n] If you wish to change settings for VLANs, enter y, or enter n to skip VLAN configuration.
BLADE OS 5.0 Command Reference 5. If configuring VLANs, enable or disable VLAN tagging for the port. If you have selected to configure VLANs back in Part 1, the system prompts: Port VLAN tagging config (tagged port can be a member of multiple VLANs) Current VLAN tag support: disabled Enter new VLAN tag support [d/e]: Enter d to disable VLAN tagging for the port or enter e to enable VLAN tagging for the port. To keep the current setting, press . 6.
BLADE OS 5.0 Command Reference 4. Configure Spanning Tree Group membership for the VLAN: Spanning Tree Group membership: Enter new Spanning Tree Group index [1-127]: 5. The system prompts you to configure the next VLAN: VLAN Config: Enter VLAN number from 2 to 4094, NULL at end: Repeat the steps in this section until all VLANs have been configured. When all VLANs have been configured, press without specifying any VLAN. Setup Part 4: IP Configuration The system prompts for IP parameters.
BLADE OS 5.0 Command Reference 2. For the specified IP interface, enter the IP address in dotted decimal notation: Current IP address: Enter new IP address: 0.0.0.0 To keep the current setting, press . 3. At the prompt, enter the IP subnet mask in dotted decimal notation: Current subnet mask: Enter new subnet mask: 0.0.0.0 To keep the current setting, press . 4. If configuring VLANs, specify a VLAN for the interface.
BLADE OS 5.0 Command Reference 2. At the prompt, enter the IP address for the selected default gateway: Current IP address: Enter new IP address: 0.0.0.0 Enter the IP address in dotted decimal notation, or press without specifying an address to accept the current setting. 3. At the prompt, enter y to enable the default gateway, or n to leave it disabled: Enable default gateway? [y/n] 4.
BLADE OS 5.0 Command Reference 2. When prompted, decide whether you wish to review the configuration changes: Review the changes made? [y/n] Enter y to review the changes made during this session of the Setup utility. Enter n to continue without reviewing the changes. We recommend that you review the changes. 3. Next, decide whether to apply the changes at the prompt: Apply the changes? [y/n] Enter y to apply the changes, or n to continue without applying. Changes are normally applied. 4.
BLADE OS 5.0 Command Reference Setting Passwords It is recommended that you change the user and administrator passwords after initial configuration and as regularly as required under your network security policies. To change the administrator password, you must login using the administrator password. Note – If you forget your administrator password, call your technical support representative for help using the password fix-up mode.
BLADE OS 5.0 Command Reference The System Menu is displayed.
BLADE OS 5.0 Command Reference 6. Enter the current administrator password at the prompt: Changing ADMINISTRATOR password; validation required... Enter current administrator password: Note – If you forget your administrator password, call your technical support representative for help using the password fix-up mode. 7. Enter the new administrator password at the prompt: Enter new administrator password: 8.
BLADE OS 5.0 Command Reference 5. Select the user password. System# user/usrpw 6. Enter the current administrator password at the prompt. Only the administrator can change the user password. Entering the administrator password confirms your authority. Changing USER password; validation required... Enter current administrator password: 7. Enter the new user password at the prompt: Enter new user password: 8. Enter the new user password, again, at the prompt: Re-enter new user password: 9.
CHAPTER 3 Menu Basics The RackSwitch G8124 Command Line Interface (CLI) is used for viewing switch information and statistics. In addition, the administrator can use the CLI for performing all levels of switch configuration. To make the CLI easy to use, the various commands have been logically grouped into a series of menus and sub-menus. Each menu displays a list of commands and/or sub-menus that are available, along with a summary of what each command will do.
BLADE OS 5.0 Command Reference Menu Summary Information Menu Provides sub-menus for displaying information about the current status of the switch: from basic system settings to VLANs, and more. Statistics Menu Provides sub-menus for displaying switch performance statistics. Included are port, IF, IP, ICMP, TCP, UDP, SNMP, routing, ARP, DNS, and VRRP statistics. Configuration Menu This menu is available only from an administrator login.
BLADE OS 5.0 Command Reference Global Commands Some basic commands are recognized throughout the menu hierarchy. These commands are useful for obtaining online help, navigating through menus, and for applying and saving configuration changes. For help on a specific command, type help.
BLADE OS 5.0 Command Reference Table 3 Description of Global Commands Command Action apply Apply pending configuration changes. save Write configuration changes to non-volatile flash memory. revert Remove pending configuration changes between “apply” commands. Use this command to remove any configuration changes made since last apply. revert apply Remove pending or applied configuration changes between “save” commands. Use this command to remove any configuration changes made since last save.
BLADE OS 5.0 Command Reference Table 3 Description of Global Commands Command Action verbose n Sets the level of information displayed on the screen: 0 = Quiet: Nothing appears except errors—not even prompts. 1 = Normal: Prompts and requested output are shown, but no menus. 2 = Verbose: Everything is shown. When used without a value, the current setting is displayed. telnet This command is used to telnet out of the switch.
BLADE OS 5.0 Command Reference Command Line History and Editing Using the command line interface, you can retrieve and modify previously entered commands with just a few keystrokes. The following options are available globally at the command line: Table 4 Command Line History and Editing Options Option Description history Display a numbered list of the last 64 previously entered commands. !! Repeat the last entered command. !n Repeat the nth command shown on the history list.
BLADE OS 5.0 Command Reference Command Line Interface Shortcuts The following shortcuts allow you to enter commands quickly and easily. CLI List and Range Inputs For CLI commands that allow an individual item to be selected from within a numeric range, lists and ranges of items can now be specified.
BLADE OS 5.0 Command Reference Command Abbreviation Most commands can be abbreviated by entering the first characters which distinguish the command from the others in the same menu or sub-menu. For example, the command shown above could also be entered as follows: Main# c/l2/stg 1/po Tab Completion By entering the first letter of a command at any menu prompt and hitting , the CLI will display all commands or options in that menu that begin with that letter.
CHAPTER 4 The Information Menu You can view configuration information for the switch in both the user and administrator command modes. This chapter discusses how to use the command line interface to display switch information.
BLADE OS 5.0 Command Reference Table 5 Information Menu Options Command Syntax and Usage qos Displays the Quality of Service (QoS) Information menu. For details, see page 100. acl Displays the current configuration profile for each Access Control List (ACL). For details, see page 102.
BLADE OS 5.0 Command Reference Table 5 Information Menu Options Command Syntax and Usage transcvr Displays the status of the port transceiver module on each external port. For details, see page 106. dump Dumps all switch information available from the Information menu (10K or more, depending on your configuration). If you want to capture dump data to a file, set your communication software on your workstation to capture session data prior to issuing the dump commands.
BLADE OS 5.0 Command Reference /info/sys System Information Menu [System Menu] errdis snmpv3 general log user dump - Errdisable Menu SNMPv3 Information Menu Show general system information Show syslog messages Show current user status Dump all system information The information provided by each menu option is briefly described in Table 6, with pointers to where detailed information can be found.
BLADE OS 5.0 Command Reference Table 6 System Information Options Command Syntax and Usage user Displays configured user names and their status. For details, see page 59. dump Dumps all switch information available from the Information menu (10K or more, depending on your configuration).
BLADE OS 5.0 Command Reference /info/sys/snmpv3 SNMPv3 System Information SNMP version 3 (SNMPv3) is an extensible SNMP Framework that supplements the SNMPv2 Framework by supporting the following: a new SNMP message format security for messages access control remote configuration of SNMP parameters For more details on the SNMPv3 architecture please refer to RFC2271 to RFC2276.
BLADE OS 5.0 Command Reference Table 8 SNMPv3 information Options Command Syntax and Usage taddr Displays the Target Address table information. To view a sample, see page 53. tparam Displays the Target parameters table information. To view a sample, see page 54. notify Displays the Notify table information. To view a sample, see page 54. dump Displays all the SNMPv3 information. To view a sample, see page 55.
BLADE OS 5.0 Command Reference Table 9 USM User Table Information Field Description User Name This is a string that represents the name of the user that you can use to access the switch. Protocol This indicates whether messages sent on behalf of this user are protected from disclosure using a privacy protocol. BLADE OS supports DES algorithm for privacy. The software also supports two authentication algorithms: MD5 and HMAC-SHA.
BLADE OS 5.0 Command Reference /info/sys/snmpv3/access SNMPv3 Access Table Information The access control sub system provides authorization services. The vacmAccessTable maps a group name, security information, a context, and a message type, which could be the read or write type of operation or notification into a MIB view. The View-based Access Control Model defines a set of services that an application can use for checking access rights of a group.
BLADE OS 5.0 Command Reference /info/sys/snmpv3/group SNMPv3 Group Table Information A group is a combination of security model and security name that defines the access rights assigned to all the security names belonging to that group. The group is identified by a group name.
BLADE OS 5.0 Command Reference /info/sys/snmpv3/taddr SNMPv3 Target Address Table Information This command displays the SNMPv3 target address table information, which is stored in the SNMP engine. Name Transport Addr Port Taglist Params ---------- --------------- ---- ---------- --------------trap1 47.81.25.66 162 v1v2trap v1v2param Table 14 SNMPv3 Target Address Table Information Field Description Name Displays the locally arbitrary, but unique identifier associated with this snmpTargetAddrEntry.
BLADE OS 5.0 Command Reference /info/sys/snmpv3/tparam SNMPv3 Target Parameters Table Information Name MP Model --------------- -------v1v2param snmpv2c User Name -------------v1v2only Sec Model --------snmpv1 Sec Level --------noAuthNoPriv Table 15 SNMPv3 Target Table Information Field Description Name Displays the locally arbitrary, but unique identifier associated with this snmpTargeParamsEntry. MP Model Displays the Message Processing Model used when generating SNMP messages using this entry.
BLADE OS 5.0 Command Reference /info/sys/snmpv3/dump SNMPv3 Dump Information usmUser Table: User Name -------------------------------adminmd5 adminsha v1v2only vacmAccess Group Name ---------v1v2grp admingrp Table: Model ------snmpv1 usm Level -----------noAuthNoPriv authPriv Protocol -------------------------------HMAC_MD5, DES PRIVACY HMAC_SHA, DES PRIVACY NO AUTH, NO PRIVACY ReadV ---------iso iso vacmViewTreeFamily Table: View Name Subtree -------------------- --------------iso 1.3 v1v2only 1.
BLADE OS 5.0 Command Reference /info/sys/general General System Information System Information at 13:41:04 Fri Jan 20, 2009 Time zone: America/Barbados Daylight Savings Time Status: Disabled Blade Network Technologies RackSwitch G8124 Switch has been up for 0 days, 17 hours, 10 minutes and 45 seconds. Last boot: 20:41:01 Thu Jan 19, 2000 (power cycle) MAC address: 00:25:03:49:83:00 IP (If 1) address: 0.0.0.0 MGMT-A Port MAC Address: 00:25:03:49:83:ee MGMT-A Port IP Address (if 127): 172.16.2.
BLADE OS 5.0 Command Reference System information includes: System date and time Switch model Switch name and location Time of last boot MAC address of the switch management processor Software image file and version number, and configuration name.
BLADE OS 5.
BLADE OS 5.0 Command Reference /info/sys/user User Status Information Usernames: user - enabled - offline oper - disabled - offline admin - Always Enabled - online 1 session Current User ID table: 1: name paul , dis, cos user , password valid, offline Current strong password settings: strong password status: disabled This command displays the status of the configured usernames.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 17 Layer 2 Information Options Command Syntax and Usage stp Displays Spanning Tree information, including the status (on or off), Spanning Tree mode (STP/PVST+, RSTP, PVRST, or MSTP), and VLAN membership.
BLADE OS 5.0 Command Reference Table 17 Layer 2 Information Options Command Syntax and Usage trunk When trunk groups are configured, you can view the state of each port in the various trunk groups. For details, see page 77. vlan Displays VLAN configuration information, including: VLAN Number VLAN Name Status Port membership of the VLAN Private VLAN information For details, see page 78. pvlan Displays Protocol VLAN information. prvlan Displays Private VLAN information.
BLADE OS 5.0 Command Reference /info/l2/fdb FDB Information [Forwarding Database Menu] find - Show a single FDB entry by MAC address port - Show FDB entries on a single port vlan - Show FDB entries on a single VLAN state - Show FDB entries by state dump - Show all FDB entries The forwarding database (FDB) contains information that maps the media access control (MAC) address of each known device to the switch port where the device address was learned.
BLADE OS 5.0 Command Reference /info/l2/fdb/dump Show All FDB Information MAC address ----------------00:04:38:90:54:18 00:09:6b:9b:01:5f 00:09:6b:ca:26:ef 00:0f:06:ec:3b:00 00:11:43:c4:79:83 VLAN ---1 1 4095 4095 1 Port ---4 13 1 1 4 Trnk ---- State ----FWD FWD FWD FWD FWD Permanent --------- P An address that is in the forwarding (FWD) state, means that it has been learned by the switch. When in the trunking (TRK) state, the port field represents the trunk group number.
BLADE OS 5.0 Command Reference /info/l2/lacp Link Aggregation Control Protocol Information [LACP Menu] aggr port dump - Show LACP aggregator information for the port - Show LACP port information - Show all LACP ports information Use these commands to display Link Aggregation Protocol (LACP) status information about each port on the switch.
BLADE OS 5.0 Command Reference /info/l2/lacp/dump Show All LACP Information port mode adminkey operkey selected prio aggr trunk status ----------------------------------------------------------------------1 active 30 30 yes 32768 17 19 up 2 active 30 30 yes 32768 17 19 up 3 off 3 3 no 32768 ---4 off 4 4 no 32768 ---... LACP dump includes the following information for each external port in the G8124: mode Displays the port’s LACP mode (active, passive, or off).
BLADE OS 5.0 Command Reference /info/l2/failovr/trigger Show Layer 2 Failover Information Trigger 1 Auto Monitor: Enabled Trigger 1 limit: 0 Monitor State: Up Member Status ------------------trunk 1 2 Operational 3 Operational Control State: Auto Disabled Member Status ------------------1 Operational 2 Operational 3 Operational 4 Operational ... A monitor port’s Failover status is Operational only if all the following conditions hold true: Port link is up.
BLADE OS 5.0 Command Reference /info/l2/hotlink Hot Links Information [Hot Links Info Menu] trigger - Show Trigger information Table 21 Hot Links Information Options Command Syntax and Usage trigger Displays status and configuration information for each Hot Links trigger. To view a sample display, see page 68.
BLADE OS 5.
BLADE OS 5.0 Command Reference When STP is used, in addition to seeing if STG is enabled or disabled, you can view the following STG bridge information: Table 22 Spanning Tree Parameter Descriptions Parameter Description Current Root The Current Root shows information about the root bridge for the Spanning Tree. Information includes the priority (in hexadecimal notation) and MAC address of the root.
BLADE OS 5.0 Command Reference Table 22 Spanning Tree Parameter Descriptions (continued) Parameter Description Designated Bridge The Designated Bridge shows information about the bridge connected to each port, if applicable. Information includes the priority (in hexadecimal notation) and MAC address of the Designated Bridge. Designated Port The identifier of the port on the Designated Bridge to which this port is connected.
BLADE OS 5.
BLADE OS 5.0 Command Reference The following table describes the STP parameters in RSTP or MSTP mode. Table 23 RSTP/MSTP Parameter Descriptions Parameter Description Current Root The Current Root shows information about the root bridge for the Spanning Tree. Information includes the priority (in hexadecimal notation) and MAC address of the root. Priority (bridge) The bridge priority parameter controls which bridge on the network will become the STP root bridge.
BLADE OS 5.0 Command Reference Table 23 RSTP/MSTP Parameter Descriptions (continued) Parameter Description Designated Bridge The Designated Bridge shows information about the bridge connected to each port, if applicable. Information includes the priority (in hexadecimal notation) and MAC address of the Designated Bridge. Designated Port The port ID of the port on the Designated Bridge to which this port is connected. Type Type of link connected to the port, and whether the port is an edge port.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 24 CIST Parameter Descriptions Parameter Description Hello The hello time parameter specifies, in seconds, how often the root bridge transmits a configuration bridge protocol data unit (BPDU). Any bridge that is not the root bridge uses the root bridge hello value. MaxAge The maximum age parameter specifies, in seconds, the maximum time the bridge waits without receiving a configuration bridge protocol data unit before it reconfigure the STP network.
BLADE OS 5.0 Command Reference /info/l2/trunk Trunk Group Information Trunk group 1: Enabled Protocol - Static Port state: 1: STG 1 forwarding 2: STG 1 forwarding When trunk groups are configured, you can view the state of each port in the various trunk groups. Note – If Spanning Tree Protocol on any port in the trunk group is set to forwarding, the remaining ports in the trunk group will also be set to forwarding.
BLADE OS 5.
BLADE OS 5.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 25 Layer 3 Information Options Command Syntax and Usage ecmp Displays ECMP route information. For details, see page 93. ip Displays IP Information. For details, see page 94. IP information, includes: IP interface information: Interface number, IP address, subnet mask, VLAN number, and operational status.
BLADE OS 5.0 Command Reference /info/l3/route IP Routing Information [IP Routing Menu] find - Show gw - Show type - Show tag - Show if - Show dump - Show a single route by destination IP address routes to a single gateway routes of a single type routes of a single tag routes on a single interface all routes Using the commands listed below, you can display all or a portion of the IP routes currently held in the switch.
BLADE OS 5.0 Command Reference /info/l3/route/dump Show All IP Route Information Status code: * - best Destination Mask --------------- --------------* 0.0.0.0 0.0.0.0 * 12.0.0.0 255.0.0.0 * 12.31.0.0 255.255.0.0 * 12.31.36.139 255.255.255.255 * 12.31.255.255 255.255.255.255 * 224.0.0.0 224.0.0.0 * 224.0.0.0 240.0.0.0 * 255.255.255.255 255.255.255.255 Gateway --------------172.31.1.1 0.0.0.0 172.31.36.139 172.31.36.139 172.31.255.255 0.0.0.0 0.0.0.0 255.255.255.
BLADE OS 5.0 Command Reference The following table describes the Tag parameters. Table 28 IP Routing Tag Parameters Parameter Description fixed The address belongs to a host or subnet attached to the switch. static The address is a static route which has been configured on the G8124. addr The address belongs to one of the switch’s IP interfaces. rip The address was learned by the Routing Information Protocol (RIP). ospf The address was learned by Open Shortest Path First (OSPF).
BLADE OS 5.0 Command Reference /info/l3/arp ARP Information [Address Resolution Protocol Menu] find - Show a single ARP entry by IP address port - Show ARP entries on a single port vlan - Show ARP entries on a single VLAN addr - Show ARP address list dump - Show all ARP entries The ARP information includes IP address and MAC address of each entry, address status flags (see Table 29 on page 85), VLAN and port for the address, and port referencing information.
BLADE OS 5.0 Command Reference /info/l3/arp/addr ARP Address List Information Current ARP configuration: rearp 5 Current static ARP: ip mac -----------------------------IP Address -------------127.20.1.1 127.20.254.21 Flags -----P interface --------- Hardware Address ----------------00:15:40:07:20:42 00:22:00:4d:b9:00 Interface --------1 1 The Port field shows the target port of the ARP entry.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 31 OSPF Information Options Command Syntax and Usage nsumadd Displays the list of summary ranges belonging to NSSA areas. routes Displays OSPF routing table. See page 92 for a sample output. dump Displays the OSPF information.
BLADE OS 5.0 Command Reference /info/l3/ospf/general OSPF General Information OSPF Version 2 Router ID: 10.10.10.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 32 OSPF Database Information Options Command Syntax and Usage ext || Displays the AS-external (type 5) LSAs with detailed information of each field of the LSAs. The usage of this command is the same as the usage of the command asbrsum. nw || Displays the network (type 2) LSAs with detailed information of each field of the LSA.network LS database.
BLADE OS 5.0 Command Reference /info/l3/ospf/routes OSPF Route Codes Information Codes: IA - OSPF inter area, N1 - OSPF NSSA external type 1, N2 - OSPF NSSA external type 2 E1 - OSPF external type 1, E2 - OSPF external type 2 IA 10.10.0.0/16 via 200.1.1.2 IA 40.1.1.0/28 via 20.1.1.2 IA 80.1.1.0/24 via 200.1.1.2 IA 100.1.1.0/24 via 20.1.1.2 IA 140.1.1.0/27 via 20.1.1.2 IA 150.1.1.0/28 via 200.1.1.2 E2 172.18.1.1/32 via 30.1.1.2 E2 172.18.1.2/32 via 30.1.1.2 E2 172.18.1.3/32 via 30.1.1.2 E2 172.18.1.
BLADE OS 5.0 Command Reference /info/l3/rip/routes RIP Routes Information >> IP Routing# /info/l3/rip/routes 30.1.1.0/24 directly connected 3.0.0.0/8 via 30.1.1.11 metric 4 4.0.0.0/16 via 30.1.1.11 metric 16 10.0.0.0/8 via 30.1.1.2 metric 3 20.0.0.0/8 via 30.1.1.2 metric 2 This table contains all dynamic routes learnt through RIP, including the routes that are undergoing garbage collection with metric = 16. This table does not contain locally configured static routes.
BLADE OS 5.0 Command Reference /info/l3/ip IP Information IP information: Interface information: 1: 127.16.2.45 255.255.0.0 127.16.255.255, vlan 4095, up Default gateway information: metric strict 1: 127.16.1.1, FAILED Current BOOTP relay settings: OFF Current primary BOOTP server: 0.0.0.0 Current secondary BOOTP server: 0.0.0.
BLADE OS 5.
BLADE OS 5.0 Command Reference /info/l3/igmp/querier IGMP Querier Information Current IGMP Querier information: IGMP Querier information for vlan 1: Other IGMP querier - none Switch-querier enabled, current state: Querier Switch-querier type: Ipv4, address 0.0.0.
BLADE OS 5.0 Command Reference /info/l3/igmp/mrouter IGMP Multicast Router Port Information [IGMP Multicast Router Menu] vlan - Show all multicast router ports on a single vlan dump - Show all learned multicast router ports Table 35 describes the commands used to display information about multicast routers (Mrouters) learned through IGMP Snooping.
BLADE OS 5.0 Command Reference /info/l3/igmp/dump IGMP Group Information Note: Local groups (224.0.0.x) are not snooped/relayed and will not appear. Source Group VLAN Port Version Mode Expires Fwd -------------- --------------- ------- ------ -------- ----- ------- --10.1.1.1 232.1.1.1 2 4 V3 INC 4:16 Yes 10.1.1.5 232.1.1.1 2 4 V3 INC 4:16 Yes * 232.1.1.1 2 4 V3 INC No 10.10.10.43 235.0.0.1 9 1 V3 INC 2:26 Yes * 236.0.0.
BLADE OS 5.0 Command Reference /info/l3/vrrp VRRP Information Virtual Router Redundancy Protocol (VRRP) support on the G8124 provides redundancy between routers in a LAN. This is accomplished by configuring the same virtual router IP address and ID number on each participating VRRP-capable routing device. One of the virtual routers is then elected as the master, based on a number of priority criteria, and assumes control of the shared virtual router IP address.
BLADE OS 5.0 Command Reference /info/qos Quality of Service Information Menu [QoS Menu] 8021p - Show QOS 802.1p information Table 36 QoS Information Options Command Syntax and Usage 8021p Displays 802.1p information. For details, see page 100. /info/qos/8021p 802.
BLADE OS 5.0 Command Reference The following table describes the IEEE 802.1p priority to COS queue information. Table 37 802.1p Priority-to-COS Queue Parameter Descriptions Parameter Description Priority Displays the 802.1p priority level. COSq Displays the Class of Service queue. Weight Displays the scheduling weight of the COS queue. The following table describes the IEEE 802.1p port priority information. Table 38 802.
BLADE OS 5.0 Command Reference /info/acl Access Control List Information Menu [ACL Information Menu] acl-list - Show ACL list Table 39 ACL Information Options Command Syntax and Usage acl-list Displays ACL list information. For details, see page 102.
BLADE OS 5.0 Command Reference Access Control List (ACL) information includes configuration settings for each ACL. Table 40 ACL List Parameter Descriptions Parameter Description Filter x profile Indicates the ACL number. Ethernet Displays the ACL Ethernet header parameters, if configured. IPv4 Displays the ACL IPv4 header parameters, if configured. TCP/UDP Displays the ACL TCP/UDP header parameters, if configured. Meter Displays the ACL meter parameters.
BLADE OS 5.
BLADE OS 5.
BLADE OS 5.0 Command Reference /info/transcvr Port Transceiver Status Ports : SFP1 SFP+: Is Present NOT APPROVED SFP2 SFP+: Is Present Is Approved Vendor:Blade Network Part:BN-CKM-SP-SR Rev:-SPLaser:850nm Serial:AD0752E01KL Date:071225 SFP3 SFP+: Is Present NOT APPROVED SFP4 SFP+: Is Present NOT APPROVED This command displays the status of the transceiver module on each external port.
CHAPTER 5 The Statistics Menu You can view switch performance statistics in both the user and administrator command modes. This chapter discusses how to use the command line interface to display switch statistics.
BLADE OS 5.0 Command Reference Table 41 Statistics Menu Options Command Syntax and Usage l3 Displays the Layer 3 Stats menu. To view menu options, see page 121. mp Displays the Management Processor Statistics menu. Use this command to view information on how switch management processes and resources are currently being allocated. To view menu options, see page 140. acl Displays ACL Statistics menu. To view menu options, see page 145. snmp Displays SNMP statistics. See page 146 for sample output.
BLADE OS 5.0 Command Reference /stats/port Port Statistics Menu This menu allows you to display traffic statistics on a port-by-port basis. Traffic statistics include SNMP Management Information Base (MIB) objects.
BLADE OS 5.0 Command Reference /stats/port /brg Bridging Statistics This option displays the bridging statistics of the selected port. Bridging statistics for port 1: dot1PortInFrames: dot1PortOutFrames: dot1PortInDiscards: dot1TpLearnedEntryDiscards: dot1StpPortForwardTransitions: 63242584 63277826 0 0 0 Table 43 Bridging Statistics of a Port Statistics Description dot1PortInFrames The number of frames that have been received by this port from its segment.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 44 Ethernet Statistics for Port Statistics Description dot3StatsSingleCollision A count of successfully transmitted frames on a particular interface for Frames which transmission is inhibited by exactly one collision.
BLADE OS 5.0 Command Reference Table 44 Ethernet Statistics for Port Statistics Description dot3StatsFrameToo Longs A count of frames received on a particular interface that exceed the maximum permitted frame size. The count represented by an instance of this object is incremented when the frameTooLong status is returned by the MAC service to the LLC (or other MAC user). Received frames for which multiple error conditions obtained are, according to the conventions of IEEE 802.
BLADE OS 5.0 Command Reference /stats/port /if Interface Statistics This option displays the interface statistics of the selected port.
BLADE OS 5.0 Command Reference Table 45 Interface Statistics for Port Statistics Description ifInErrors For packet-oriented interfaces, the number of inbound packets that contained errors preventing them from being delivered to a higher-layer protocol. For character-oriented or fixed-length interfaces, the number of inbound transmission units that contained errors preventing them from being deliverable to a higher-layer protocol.
BLADE OS 5.0 Command Reference /stats/port /ip Interface Protocol Statistics This option displays the interface statistics of the selected port. GEA IP statistics for port 1: ipInReceives : 0 Table 46 Interface Protocol Statistics of a Port Statistics Description ipInReceives The total number of input datagrams received from interfaces, including those received in error.
BLADE OS 5.0 Command Reference /stats/l2 Layer 2 Statistics Menu [Layer 2 Statistics Menu] fdb - Show FDB stats lacp - Show LACP stats hotlink - Show Hot Links stats The Layer 2 statistics provided by each menu option are briefly described in Table 48, with pointers to detailed information. Table 48 Layer 2 Statistics Menu Options Command Syntax and Usage fdb [clear] Displays FDB statistics. See page 118 for sample output. Use the clear option to delete all FDB statistics.
BLADE OS 5.0 Command Reference /stats/l2/fdb [clear] FDB Statistics FDB statistics: current: 83 hiwat: 855 This option displays statistics about the use of the forwarding database, including the number of new entries, finds, and unsuccessful searches. FDB statistics are described in the following table: Table 49 Forwarding Database Statistics Statistic Description current Current number of entries in the Forwarding Database.
BLADE OS 5.
BLADE OS 5.0 Command Reference /stats/l2/hotlink Hotlinks Statistics Hot Links Trigger Stats: Trigger 1 statistics: Trigger Name: Trigger 1 Master active: Backup active: FDB update: 0 0 0 failed: 0 The following table describes the Hotlinks statistics: Table 51 Hotlinks Statistics Statistic Description Master active Total number of times the Master interface transitioned to the Active state. Backup active Total number of times the Backup interface transitioned to the Active state.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 52 Layer 3 Statistics Menu Options Command Syntax and Usage icmp [clear] Displays ICMP statistics. See page 127 for sample output. Use the clear option to delete all ICMP statistics. tcp [clear] Displays TCP statistics. See page 129 for sample output. Use the clear option to delete all TCP statistics. udp [clear] Displays UDP statistics. See page 131 for sample output. Use the clear option to delete all UDP statistics. igmp Displays IGMP statistics.
BLADE OS 5.0 Command Reference Table 52 Layer 3 Statistics Menu Options Command Syntax and Usage ospfclear Clears Open Shortest Path First (OSPF) statistics. dump Dumps all Layer 3 statistics. Use this command to gather data for tuning and debugging switch performance. If you want to capture dump data to a file, set your communication software on your workstation to capture session data prior to issuing the dump command.
BLADE OS 5.0 Command Reference Table 53 IP Statistics Statistics Description ipInDiscards The number of input IP datagrams for which no problems were encountered to prevent their continued processing, but which were discarded (for example, for lack of buffer space). Note that this counter does not include any datagrams discarded while awaiting re-assembly. ipInDelivers The total number of input datagrams successfully delivered to IP user-protocols (including ICMP).
BLADE OS 5.0 Command Reference /stats/l3/route [clear] Route Statistics Route statistics: ipRoutesCur: ipRoutesMax: 11 4096 ipRoutesHighWater: 11 Table 54 Route Statistics Statistics Description ipRoutesCur The total number of outstanding routes in the route table. ipRoutesHighWater The highest number of routes ever recorded in the route table. ipRoutesMax The maximum number of routes that are supported. Use the clear option to delete all route statistics.
BLADE OS 5.0 Command Reference /stats/l3/dns [clear] DNS Statistics This option displays Domain Name System (DNS) statistics. DNS statistics: dnsOutRequests: dnsBadRequests: 0 0 Table 56 DNS Statistics Statistics Description dnsOutRequests The total number of DNS response packets that have been transmitted. dnsBadRequests The total number of DNS request packets received that were dropped. Use the clear option to delete all DNS statistics.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 57 ICMP Statistics Statistics Description icmpInAddrMasks The number of ICMP Address Mask Request messages received. icmpInAddrMaskReps The number of ICMP Address Mask Reply messages received. icmpOutMsgs The total number of ICMP messages which this entity (the switch) attempted to send. Note that this counter includes all those counted by icmpOutErrors.
BLADE OS 5.0 Command Reference /stats/l3/tcp [clear] TCP Statistics TCP statistics: tcpRtoAlgorithm: tcpRtoMax: tcpActiveOpens: tcpAttemptFails: tcpInSegs: tcpRetransSegs: tcpCurBuff: tcpOutRsts: 4 240000 252214 528 756401 0 0 417 tcpRtoMin: tcpMaxConn: tcpPassiveOpens: tcpEstabResets: tcpOutSegs: tcpInErrs: tcpCurConn: 0 512 7 4 756655 0 3 Table 58 TCP Statistics Statistics Description tcpRtoAlgorithm The algorithm used to determine the timeout value used for retransmitting unacknowledged octets.
BLADE OS 5.0 Command Reference Table 58 TCP Statistics Statistics Description tcpAttemptFails The number of times TCP connections have made a direct transition to the CLOSED state from either the SYN-SENT state or the SYN-RCVD state, plus the number of times TCP connections have made a direct transition to the LISTEN state from the SYN-RCVD state.
BLADE OS 5.0 Command Reference /stats/l3/udp [clear] UDP Statistics UDP statistics: udpInDatagrams: udpInErrors: 54 0 udpOutDatagrams: udpNoPorts: 43 1578077 Table 59 UDP Statistics Statistics Description udpInDatagrams The total number of UDP datagrams delivered to the switch. udpOutDatagrams The total number of UDP datagrams sent from this entity (the switch).
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 60 IGMP Statistics Statistic Description rxIgmpV3FilterChange Records Total number of Filter Change records received. txIgmpGenQueries Total number of General Membership Query packets transmitted /stats/l3/ospf OSPF Statistics [OSPF stats Menu] general - Show global stats aindex - Show area(s) stats if - Show interface(s) stats Table 61 OSPF Statistics Options Command Syntax and Usage general Displays global statistics. See page 134 for sample output.
BLADE OS 5.0 Command Reference /stats/l3/ospf/general OSPF General Statistics The OSPF General Statistics contain the sum total of all OSPF packets received on all OSPF areas and interfaces.
BLADE OS 5.0 Command Reference Table 62 OSPF General Statistics (stats/l3/ospf/general) Statistics Description Rx/Tx Stats: Rx Pkts The sum total of all OSPF packets received on all OSPF areas and interfaces. Tx Pkts The sum total of all OSPF packets transmitted on all OSPF areas and interfaces. Rx Hello The sum total of all Hello packets received on all OSPF areas and interfaces. Tx Hello The sum total of all Hello packets transmitted on all OSPF areas and interfaces.
BLADE OS 5.0 Command Reference Table 62 OSPF General Statistics (stats/l3/ospf/general) (continued) Statistics Description n2way The sum total number of bidirectional communication establishment between this router and other neighboring routers. adjoint ok The sum total number of decisions to be made (again) as to whether an adjacency should be established/maintained with the neighbor across all OSPF areas and interfaces.
BLADE OS 5.0 Command Reference Table 62 OSPF General Statistics (stats/l3/ospf/general) (continued) Statistics Description Intf Change Stats: hello The sum total number of Hello packets sent on all interfaces and areas. down The sum total number of interfaces down in all OSPF areas. loop The sum total of interfaces no longer connected to the attached network across all OSPF areas and interfaces. unloop The sum total number of interfaces, connected to the attached network in all OSPF areas.
BLADE OS 5.0 Command Reference /stats/l3/vrrp VRRP Statistics Virtual Router Redundancy Protocol (VRRP) support on the RackSwitch G8124 (G8124) provides redundancy between routers in a LAN. This is accomplished by configuring the same virtual router IP address and ID number on each participating VRRP-capable routing device. One of the virtual routers is then elected as the master, based on a number of priority criteria, and assumes control of the shared virtual router IP address.
BLADE OS 5.0 Command Reference Table 63 VRRP Statistics Statistics Description vrrpBadPassword The total number of VRRP advertisements received that had a bad password. vrrpBadInterval The total number of VRRP advertisements received that had a bad interval.
BLADE OS 5.0 Command Reference /stats/mp Management Processor Statistics Menu [MP-specific Statistics Menu] thr - Show STEM thread stats i2c - Show I2C stats pkt - Show Packet stats tcb - Show All TCP control blocks in use ucb - Show All UDP control blocks in use cpu - Show CPU utilization mem - Show Memory utilization stats Table 64 Management Processor Statistics Menu Options Command Syntax and Usage thr Displays STEM thread statistics. This command is used by Technical Support personnel.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 65 Packet Statistics Statistics Description current Total number of packet allocations with size between 128 to 1536 bytes from the packet buffer pool by the TCP/IP protocol stack. hi-watermark The highest number of packet allocation with size between 128 to 1536 bytes from the packet buffer pool by the TCP/IP protocol stack. hi-water time Time stamp that indicates when the hi-watermark was reached.
BLADE OS 5.0 Command Reference /stats/mp/tcb TCP Statistics All TCP allocated control blocks: 10ad41e8: 0.0.0.0 0 <=> 0.0.0.0 10ad5790: 47.81.27.5 1171 <=> 47.80.23.243 80 23 listen established Table 66 MP Specified TCP Statistics Statistics Description 10ad41e8/10ad5790 Memory 0.0.0.0/47.81.27.5 Destination IP address 0/1171 Destination port 0.0.0.0/47.80.23.
BLADE OS 5.0 Command Reference /stats/mp/cpu CPU Statistics This option displays the CPU utilization statistics. CPU utilization: cpuUtil1Second: cpuUtil4Seconds: cpuUtil64Seconds: 53% 54% 54% Table 67 CPU Statistics Statistics Description cpuUtil1Second The utilization of MP CPU over 1 second. It shows the percentage. cpuUtil4Seconds The utilization of MP CPU over 4 seconds. It shows the percentage. cpuUtil64Seconds The utilization of MP CPU over 64 seconds. It shows the percentage.
BLADE OS 5.0 Command Reference /stats/acl ACL Statistics Menu [ACL Menu] acl dump clracl - Display ACL stats - Display all available ACL stats - Clear ACL stats ACL statistics are described in the following table. Table 68 ACL Statistics Menu Options Command Syntax and Usage acl Displays the Access Control List Statistics for a specific ACL. For details, see page 145. dump Displays all ACL statistics. clracl Clears all ACL statistics.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 69 SNMP Statistics Statistics Description snmpInASNParseErrs The total number of ASN.1 or BER errors encountered by the SNMP protocol entity when decoding SNMP Messages received. Note: OSI's method of specifying abstract objects is called ASN.1 (Abstract Syntax Notation One, defined in X.208), and one set of rules for representing such objects as strings of ones and zeros is called the BER (Basic Encoding Rules, defined in X.209). ASN.
BLADE OS 5.0 Command Reference Table 69 SNMP Statistics Statistics Description snmpInTotalReqVars The total number of MIB objects which have been retrieved successfully by the SNMP protocol entity as a result of receiving valid SNMP Get-Request and Get-Next Protocol Data Units (PDUs). snmpInTotalSetVars The total number of MIB objects, which have been altered successfully by the SNMP protocol entity as a result of receiving valid SNMP Set-Request Protocol Data Units (PDUs).
BLADE OS 5.0 Command Reference Table 69 SNMP Statistics Statistics Description snmpOutGetNexts The total number of SNMP Get-Next Protocol Data Units (PDUs), which have been generated by the SNMP protocol entity. snmpOutSetRequests The total number of SNMP Set-Request Protocol Data Units (PDUs), which have been generated by the SNMP protocol entity. snmpOutGet Responses The total number of SNMP Get-Response Protocol Data Units (PDUs), which have been generated by the SNMP protocol entity.
BLADE OS 5.0 Command Reference /stats/ntp NTP Statistics BLADE OS uses NTP (Network Timing Protocol) version 3 to synchronize the switch’s internal clock with an atomic time calibrated NTP server. With NTP enabled, the switch can accurately update its internal clock to be consistent with other devices on the network and generates accurate syslogs.
BLADE OS 5.0 Command Reference Table 70 NTP Statistics Field Description Last update based on response from primary server Last update of time on the switch based on either primary or secondary NTP response received. Last update time The time stamp showing the time when the switch was last updated.
BLADE OS 5.
CHAPTER 6 The Configuration Menu This chapter discusses how to use the Command Line Interface (CLI) for making, viewing, and saving switch configuration changes. Many of the commands, although not new, display more or different information than in the previous version. Important differences are called out in the text.
BLADE OS 5.0 Command Reference Each configuration option is briefly described in Table 71, with pointers to detailed menu commands. Table 71 Configuration Menu Options Command Syntax and Usage sys Displays the System Configuration menu. To view menu options, see page 157. port Displays the Port Configuration menu. To view menu options, see page 197. qos Displays the Quality of Service Configuration menu. To view menu options, see page 204. acl Displays the ACL Configuration menu.
BLADE OS 5.0 Command Reference Viewing, Applying, and Saving Changes As you use the configuration menus to set switch parameters, the changes you make do not take effect immediately. All changes are considered “pending” until you explicitly apply them. Also, any changes are lost the next time the switch boots unless the changes are explicitly saved. Note – Some operations can override the settings in the Configuration menu.
BLADE OS 5.0 Command Reference To save the new configuration, enter the following command at any CLI prompt: # save When you save configuration changes, the changes are saved to the active configuration block. The configuration being replaced by the save is first copied to the backup configuration block.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 72 System Configuration Menu Options Command Syntax and Usage radius Displays the RADIUS Authentication menu. To view menu options, see page 166. tacacs+ Displays the TACACS+ Authentication menu. To view menu options, see page 168. ldap Displays the LDAP Authentication menu. To view menu options, see page 171. ntp Displays the Network Time Protocol (NTP) Server menu. To view menu options, see page 173. ssnmp Displays the System SNMP menu.
BLADE OS 5.0 Command Reference Table 72 System Configuration Menu Options Command Syntax and Usage dlight enable|disable Disables or enables daylight savings time in the system clock. When enabled, the switch will add an extra hour to the system clock so that it is consistent with the local clock. The default value is disabled. idle Sets the idle timeout for CLI sessions, from 1 to 60 minutes. The default is 10 minutes. notice <'.
BLADE OS 5.0 Command Reference Table 72 System Configuration Menu Options Command Syntax and Usage rstctrl disable|enable Enables or disables the reset control flag. When enabled, the switch continues to function after a crash of the main processor, using the last known Layer 2/3 information. The default value is enabled. cur Displays the current system parameters.
BLADE OS 5.0 Command Reference /cfg/sys/errdis System Error Disable and Recovery Configuration [System ErrDisable Menu] timeout - Set ErrDisable timeout (sec) ena - Enable ErrDisable recovery dis - Disable ErrDisable recovery cur - Display current ErrDisable configuration The Error Disable and Recovery feature allows the switch to automatically disable a port if an error condition is detected on the port.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 74 System Host Log Options Command Syntax and Usage log Displays a list of features for which syslog messages can be generated. You can choose to enable or disable specific features (such as vlans, stg, or servers), or to enable or disable syslog on all available features. cur Displays the current syslog settings.
BLADE OS 5.0 Command Reference /cfg/sys/sshd SSH Server Configuration [SSHD Menu] intrval scpadm hkeygen skeygen sshport ena dis on off cur - Set Interval for generating the RSA server key Set SCP-only admin password Generate the RSA host key Generate the RSA server key Set SSH server port number Enable the SCP apply and save Disable the SCP apply and save Turn SSH server ON Turn SSH server OFF Display current SSH server configuration This menu enables Secure Shell access from any SSH client.
BLADE OS 5.0 Command Reference Table 75 SSH Configuration Options Command Syntax and Usage off Disables the SSH server. cur Displays the current SSH server configuration.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 76 System Configuration Options Command Syntax and Usage bckdoor disable|enable Enables or disables the RADIUS backdoor for Telnet/SSH/HTTP/HTTPS. The default value is disabled. To obtain the RADIUS backdoor password for your switch, contact your Service and Support line. secbd enable|disable Enables or disables the RADIUS back door using secure password for telnet/SSH/HTTP/HTTPS. This command does not apply when backdoor (telnet) is enabled.
BLADE OS 5.0 Command Reference /cfg/sys/tacacs+ TACACS+ Server Configuration TACACS (Terminal Access Controller Access Control system) is an authentication protocol that allows a remote access server to forward a user's logon password to an authentication server to determine whether access can be allowed to a given system. TACACS is an encryption protocol, and therefore less secure than TACACS+ and Remote Authentication Dial-In User Service (RADIUS) protocols.
BLADE OS 5.0 Command Reference Table 77 TACACS+ Server Options Command Syntax and Usage prisrv [-ma|-mgta|-mb|-mgtb|-d|-data] Defines the primary TACACS+ server address and the interface port to use to send TACACS+ requests. secsrv [-ma|-mgta|-mb|-mgtb|-d|-data] Defines the secondary TACACS+ server address and the interface port to use to send TACACS+ requests. secret <1-32 character secret> This is the shared secret between the switch and the TACACS+ server(s).
BLADE OS 5.0 Command Reference Table 77 TACACS+ Server Options Command Syntax and Usage secbd enable|disable Enables or disables TACACS+ secure back door access through Telnet, SSH/SCP, or HTTP/HTTPS only when the TACACS+ servers are not responding. This feature is recommended to permit access to the switch when the TACACS+ servers become unresponsive. If no back door is enabled, the only way to gain access when TACACS+ servers are unresponsive is to use the back door via the console port.
BLADE OS 5.0 Command Reference /cfg/sys/ldap LDAP Server Configuration LDAP (Lightweight Directory Access Protocol) is an authentication protocol that allows a remote access server to forward a user's logon password to an authentication server to determine whether access can be allowed to a given system.
BLADE OS 5.0 Command Reference Table 78 LDAP Server Options Command Syntax and Usage bckdoor disable|enable Enables or disables the LDAP back door for Telnet, SSH/SCP, or HTTP/HTTPS. The default setting is disabled. To obtain the LDAP backdoor password for your switch, contact your Service and Support line. on Enables the LDAP server. off Disables the LDAP server. This is the default setting. cur Displays current LDAP configuration parameters.
BLADE OS 5.0 Command Reference /cfg/sys/ntp NTP Server Configuration [NTP Server Menu] prisrv - Set primary NTP server hostname|IP address secsrv - Set secondary NTP server hostname|IP address intrval - Set NTP server resync interval on - Turn NTP service ON off - Turn NTP service OFF cur - Display current NTP configuration This menu enables you to synchronize the switch clock to a Network Time Protocol (NTP) server. By default, this option is disabled.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 80 System SNMP Options Command Syntax and Usage snmpv3 Displays SNMPv3 menu. To view menu options, see page 176. name <1-64 characters> Configures the name for the system. locn <1-64 characters> Configures the name of the system location. cont <1-64 characters> Configures the name of the system contact. rcomm <1-32 characters> Configures the SNMP read community string. The read community string controls SNMP “get” access to the switch.
BLADE OS 5.0 Command Reference /cfg/sys/ssnmp/snmpv3 SNMPv3 Configuration SNMP version 3 (SNMPv3) is an extensible SNMP Framework that supplements the SNMPv2 Framework by supporting the following: a new SNMP message format security for messages access control remote configuration of SNMP parameters For more details on the SNMPv3 architecture please refer to RFC2271 to RFC2276.
BLADE OS 5.0 Command Reference Table 81 SNMPv3 Configuration Options group Maps the user name to the access group names and their access rights needed to access SNMP management objects. A group defines the access rights assigned to all names that belong to a particular group. To view menu options, see page 182. comm The community table contains objects for mapping community strings and version-independent SNMP message parameters.
BLADE OS 5.0 Command Reference /cfg/sys/ssnmp/snmpv3/usm User Security Model Configuration You can make use of a defined set of user identities using this Security Model. An SNMP engine must have the knowledge of applicable attributes of a user. This menu helps you create a user security model entry for an authorized user. You need to provide a security name to create the USM entry.
BLADE OS 5.0 Command Reference Table 82 User Security Model Configuration Options Command Syntax and Usage del Deletes the selected USM user entries. cur Displays the selected USM user entries.
BLADE OS 5.0 Command Reference /cfg/sys/ssnmp/snmpv3/view SNMPv3 View Configuration [SNMPv3 vacmViewTreeFamily 1 Menu] name - Set view name tree - Set MIB subtree(OID) which defines a family of view subtrees mask - Set view mask type - Set view type del - Delete vacmViewTreeFamily entry cur - Display current vacmViewTreeFamily configuration Table 83 SNMPv3 View Options Command Syntax and Usage name <1-32 characters> Defines the name for a family of view subtrees. tree
BLADE OS 5.0 Command Reference /cfg/sys/ssnmp/snmpv3/access <1-32> View-Based Access Control Model Configuration The view-based Access Control Model defines a set of services that an application can use for checking access rights of the user. Access control is needed when the user has to process SNMP retrieval or modification request from an SNMP entity.
BLADE OS 5.0 Command Reference Table 84 View-based Access Control Model Options Command Syntax and Usage del Deletes the View-based Access Control entry. cur Displays the View-based Access Control configuration.
BLADE OS 5.0 Command Reference /cfg/sys/ssnmp/snmpv3/comm SNMPv3 Community Table Configuration This command is used for configuring the community table entry. The configured entry is stored in the community table list in the SNMP engine. This table is used to configure community strings in the Local Configuration Datastore (LCD) of SNMP engine.
BLADE OS 5.0 Command Reference /cfg/sys/ssnmp/snmpv3/taddr SNMPv3 Target Address Table Configuration This command is used to configure the target transport entry. The configured entry is stored in the target address table list in the SNMP engine. This table of transport addresses is used in the generation of SNMP messages.
BLADE OS 5.0 Command Reference /cfg/sys/ssnmp/snmpv3/tparam SNMPv3 Target Parameters Table Configuration You can configure the target parameters entry and store it in the target parameters table in the SNMP engine. This table contains parameters that are used to generate a message. The parameters include the message processing model (for example: SNMPv3, SNMPv2c, SNMPv1), the security model (for example: USM), the security name, and the security level (noAuthnoPriv, authNoPriv, or authPriv).
BLADE OS 5.0 Command Reference Table 88 Target Parameters Table Configuration Options Command Syntax and Usage del Deletes the targetParamsTable entry. cur Displays the current targetParamsTable configuration. /cfg/sys/ssnmp/snmpv3/notify SNMPv3 Notify Table Configuration SNMPv3 uses Notification Originator to send out traps. A notification typically monitors a system for particular events or conditions, and generates Notification-Class messages based on these events or conditions.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 90 System Access Options Command Syntax and Usage http disable|enable Enables or disables HTTP (Web) access to the Browser-Based Interface. It is enabled by default. tnet enable|disable Enables or disables Telnet access. This command is enabled by default. tsbbi enable|disable Enables or disables Telnet/SSH configuration access through the Browser-Based Interface (BBI).
BLADE OS 5.0 Command Reference /cfg/sys/access/mgmt Management Networks Configuration [Management Networks Menu] add - Add mgmt network definition rem - Remove mgmt network definition cur - Display current mgmt network definitions clear - Clear current mgmt network definitions This menu is used to define IP address ranges which are allowed to access the switch for management purposes.
BLADE OS 5.0 Command Reference /cfg/sys/access/user User Access Control Configuration [User Access Control Menu] uid - User ID Menu eject - Eject user usrpw - Set user password (user) opw - Set operator password (oper) admpw - Set administrator password (admin) strongpw - Strong password menu cur - Display current user status Note – Passwords can be a maximum of 128 characters. Table 92 User Access Control Options Command Syntax and Usage uid Displays the User ID menu.
BLADE OS 5.0 Command Reference Table 92 User Access Control Options Command Syntax and Usage strongpw Displays the Strong User Password menu. To view menu options, see page 192. cur Displays the current user status.
BLADE OS 5.0 Command Reference Table 93 User ID Configuration Options Command Syntax and Usage del Deletes the user ID. cur Displays the current user ID configuration.
BLADE OS 5.0 Command Reference /cfg/sys/access/https HTTPS Access Configuration [https Menu] access port generate certSave cur - Enable/Disable HTTPS Web access HTTPS WebServer port number Generate self-signed HTTPS server certificate save HTTPS certificate Display current SSL Web Access configuration Table 95 HTTPS Access Configuration Options Command Syntax and Usage access ena|dis Enables or disables BBI access (Web access) using HTTPS.
BLADE OS 5.0 Command Reference /cfg/sys/dst Custom Daylight Savings Time Configuration [Custom DST Menu] dststart - Set the DST start day dstend - Set the DST stop day ena - Enable custom DST dis - Disable custom DST cur - Display custom DST configuration Use this menu to configure custom Daylight Savings Time. The DST will be defined by two rules, the start rule and end rule. The rules specify the date and time when the DST starts and finishes.
BLADE OS 5.0 Command Reference Table 96 Custom DST Configuration Options Command Syntax and Usage dis Disables the Custom Daylight Savings Time settings. cur Displays the current Custom DST configuration. /cfg/sys/sflow sFlow Configuration [sFlow Menu] ena dis saddress sport port cur - Enable sFlow Disable sFlow Set the sFlow Analyzer IP address Set the sFlow Analyzer port sFlow port Menu Display sFlow configuration sFlow is a sampling method used for monitoring high speed switched networks.
BLADE OS 5.0 Command Reference Table 97 sFlow Configuration Options Command Syntax and Usage port Configures the sFlow interface port. cur Displays the current sFlow configuration. /cfg/sys/sflow/port sFlow Port Configuration [sFlow Port Menu] polling - Set the sFlow polling interval sampling - Set the sFlow sampling rate cur - Display sFlow port configuration Use this menu to configure the sFlow port on the switch.
BLADE OS 5.0 Command Reference /cfg/port Port Configuration Menu [Port 1 Menu] errdis gig aclqos stp 8021ppri pvid name bpdugrd dscpmrk learn tag tagpvid floodblk macnotif brate mrate drate ena dis cur - ErrDisable Menu Gig Phy Menu Acl/Qos Configuration Menu STP Menu - for PVRST only Set default 802.
BLADE OS 5.0 Command Reference Table 99 Port Configuration Menu Command Syntax and Usage 8021ppri <0-7> Configures the port’s 802.1p priority level. pvid Sets the default VLAN number which will be used to forward frames which are not VLAN tagged. The default number is 1 for non-management ports. name <1-64 characters>|none Sets a name for the port. The assigned port name appears next to the port number on some information and statistics screens. The default setting is none.
BLADE OS 5.0 Command Reference Table 99 Port Configuration Menu Command Syntax and Usage brate <0-262143>|dis Limits the number of broadcast packets per second to the specified value. If disabled (dis), the port forwards all broadcast packets. mrate <0-262143>|dis Limits the number of multicast packets per second to the specified value. If disabled (dis), the port forwards all multicast packets. drate <0-262143>|dis Limits the number of unknown unicast packets per second to the specified value.
BLADE OS 5.0 Command Reference /cfg/port /errdis Port Error Disable and Recovery Configuration [Port 2 ErrDisable Menu] ena - Enable ErrDisable recovery dis - Disable ErrDisable recovery cur - Display current ErrDisable configuration The Error Disable and Recovery feature allows the switch to automatically disable a port if an error condition is detected on the port.
BLADE OS 5.0 Command Reference /cfg/port /gig Port Link Configuration [Gigabit Link speed mode fctl auto cur Menu] - Set link speed - Set full or half duplex mode - Set flow control - Set autonegotiation - Display current gig link configuration Port link menu options are described in the following table. Table 101 Port Link Configuration Options Command Syntax and Usage speed 10|100|1000|10000|any Sets the link speed. Some options are not valid on all ports.
BLADE OS 5.0 Command Reference Table 101 Port Link Configuration Options Command Syntax and Usage auto on|off Turns auto-negotiation on or off. Note: Data ports are fixed at 10000 Mbps, and cannot be set to auto-negotiate, unless a 1 Gb SFP transceiver is used. cur Displays current port parameters.
BLADE OS 5.0 Command Reference /cfg/port /stp Port Spanning Tree Configuration [Port 1 STP Menu] edge - Enable/disable edge port link - Set port link type (for PVRST only) cur - Display current port stp configuration Table 103 Port STP Options Command Syntax and Usage edge e|d Enables or disables this port as an edge port. An edge port is not connected to a bridge, and can begin forwarding traffic as soon as the link is up. Configure server ports as edge ports (enabled).
BLADE OS 5.0 Command Reference /cfg/qos Quality of Service Configuration Menu [QOS Menu] 8021p dscp cur - 802.1p Menu - Dscp Menu - Display current QOS configuration Use the Quality of Service (QoS) menus to configure the 802.1p priority value and DiffServ Code Point (DSCP) value of incoming packets. This allows you to differentiate between various types of traffic, and provide different priority levels. Table 104 Quality of Service Menu Options Command Syntax and Usage 8021p Displays 802.
BLADE OS 5.0 Command Reference /cfg/qos/8021p 802.1p Configuration [802.1p Menu] priq qweight default cur - Set priority to COS queue mapping Set weight to a COS queue Reset 802.1p configuration to default values. Display current 802.1p configuration This feature provides the capability to filter IP packets based on the 802.1p bits in the packet's VLAN header. The 802.1p bits specify the priority that you should give to the packets while forwarding them.
BLADE OS 5.0 Command Reference /cfg/qos/dscp DSCP Configuration [dscp Menu] dscp prio on off cur - Remark DSCP value to a new DSCP value Remark DSCP value to a 802.1p priority Globally turn DSCP remarking ON Globally turn DSCP remarking OFF Display current DSCP remarking configuration Use this menu map the DiffServ Code Point (DSCP) value of incoming packets to a new value, or to an 802.1p priority value.
BLADE OS 5.0 Command Reference /cfg/acl Access Control List Configuration Menu [ACL Menu] acl outdscp cur - Access Control List Item Config Menu - Set the update DSCP for out profile - Display current ACL configuration Use this menu to create Access Control Lists (ACLs). ACLs define matching criteria used for IP filtering and Quality of Service functions. Table 107 ACL Configuration Options Command Syntax and Usage acl <1-254> Displays Access Control List configuration menu.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 108 ACL Options Command Syntax and Usage stats e|d Enables or disables the statistics collection for the Access Control List. reset Resets the ACL parameters to their default values. cur Displays the current ACL parameters.
BLADE OS 5.0 Command Reference /cfg/acl/acl /ethernet Ethernet Filtering Configuration smac dmac vlan etype pri reset cur - Set to filter on source MAC Set to filter on destination MAC Set to filter on VLAN ID Set to filter on ethernet type Set to filter on priority Reset all fields Display current parameters This menu allows you to define Ethernet matching criteria for an ACL.
BLADE OS 5.0 Command Reference /cfg/acl/acl /ipv4 IP version 4 Filtering Configuration [Filtering IPv4 Menu] sip - Set to filter on source IP address dip - Set to filter on destination IP address proto - Set to filter on prototype tos - Set to filter on TOS reset - Reset all fields cur - Display current parameters This menu allows you to define IPv4 matching criteria for an ACL. Table 111 IP version 4 Filtering Options Command Syntax and Usage sip
BLADE OS 5.0 Command Reference Table 111 IP version 4 Filtering Options Command Syntax and Usage reset Resets the IPv4 parameters for the ACL to their default values. cur Displays the current IPV4 parameters.
BLADE OS 5.0 Command Reference /cfg/acl/acl /tcpudp TCP/UDP Filtering Configuration [Filtering TCP/UDP Menu] sport - Set to filter on TCP/UDP source port dport - Set to filter on TCP/UDP destination port flags - Set to filter TCP/UDP flags reset - Reset all fields cur - Display current parameters This menu allows you to define TCP/UDP matching criteria for an ACL.
BLADE OS 5.0 Command Reference Table 112 TCP/UDP Filtering Options Command Syntax and Usage reset Resets the TCP/UDP parameters for the ACL to their default values. cur Displays the current TCP/UDP Filtering parameters.
BLADE OS 5.0 Command Reference Table 113 ACL Metering Options Command Syntax and Usage reset Reset ACL Metering parameters to their default values. cur Displays current ACL Metering parameters. /cfg/acl/acl /re-mark Re-Mark Configuration [Re-mark Menu] inprof outprof up1p reset cur - In Profile Menu Out Profile Menu Set Update User Priority Menu Reset re-mark settings Display current settings You can choose to re-mark IP header data for the selected ACL.
BLADE OS 5.0 Command Reference /cfg/acl/acl /re-mark/inprof Re-Marking In-Profile Configuration [Re-marking - In Profile Menu] updscp - Set the update DSCP reset - Reset update DSCP settings cur - Display current settings Table 115 ACL Re-Mark In-Profile Options Command Syntax and Usage updscp <0-63> Sets the DiffServ Code Point (DSCP) of In-Profile packets to the selected value. reset Resets the update DSCP parameters to their default values.
BLADE OS 5.0 Command Reference /cfg/acl/acl /re-mark/up1p Update User Priority Configuration [Update User Priority Menu] value - Set the update user priority reset - Reset in profile up1p settings cur - Display current settings Table 117 ACL Re-Mark Update User Priority Options Command Syntax and Usage value <0-7> Defines 802.1p value. The value is the priority bits information in the packet structure. reset Resets UP1P settings to their default values.
BLADE OS 5.0 Command Reference /cfg/pmirr Port Mirroring Configuration Menu [Port Mirroring monport mirror cur - Menu] Monitoring Port based PM Menu Enable/Disable Mirroring Display All Mirrored and Monitoring Ports Port mirroring is disabled by default. For more information about port mirroring on the G8124, see “Appendix A: Troubleshooting” in the BLADE OS Application Guide. The Port Mirroring menu is used to configure, enable, and disable the monitor port.
BLADE OS 5.0 Command Reference /cfg/pmirr/monport Port-Mirroring Configuration [Port 1 Menu] add rem delete cur - Add "Mirrored" port Rem "Mirrored" port Delete this "Monitor" port Display current Port-based Port Mirroring configuration Table 119 Port Mirroring Monitor Port Options Command Syntax and Usage add Adds the port to be mirrored. This command also allows you to enter the direction of the traffic.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 120 Layer 2 Configuration Menu Options Command Syntax and Usage lacp Displays the Link Aggregation Control Protocol menu. To view menu options, see page 238. failovr Displays the Failover Configuration menu. To view menu options, see page 240. hotlink Displays the Hot Links Configuration menu. To view menu options, see page 245. vlan Displays the VLAN Configuration menu. To view menu options, see page 249.
BLADE OS 5.0 Command Reference /cfg/l2/mrst RSTP/MSTP Configuration [Multiple Spanning Tree Menu] cist - Common and Internal Spanning Tree menu name - Set MST region name rev - Set revision level of this MST region maxhop - Set Maximum Hop Count for MST (4 - 60) mode - Spanning Tree Mode on - Globally turn Multiple Spanning Tree (MSTP/RSTP/PVRST) ON off - Globally turn Multiple Spanning Tree (MSTP/RSTP/PVRST) OFF cur - Display current MST parameters BLADE OS supports the IEEE 802.
BLADE OS 5.0 Command Reference Table 121 MSTP/RSTP/PVRST Configuration Options Command Syntax and Usage mode rstp|mstp|pvrst Selects the Spanning Tree mode, as follows: Per VLAN Rapid Spanning Tree Plus (pvrst), Rapid Spanning Tree (rstp), Multiple Spanning Tree (mstp). The default mode is RSTP. on Globally turns RSTP/MSTP/PVRST ON. Note: When RSTP is turned on, the configuration parameters for STG 1 apply to RSTP. off Globally turns RSTP/MSTP/PVRST OFF.
BLADE OS 5.0 Command Reference /cfg/l2/mrst/cist Common Internal Spanning Tree Configuration [Common Internal Spanning Tree Menu] brg - CIST Bridge parameter menu port - CIST Port parameter menu add - Add VLAN(s) to CIST default - Default Common Internal Spanning Tree and Member parameters cur - Display current CIST parameters Table 122 describes the commands used to configure Common Internal Spanning Tree (CIST) parameters.
BLADE OS 5.0 Command Reference /cfg/l2/mrst/cist/brg CIST Bridge Configuration [CIST Bridge Menu] prior - Set CIST bridge mxage - Set CIST bridge fwd - Set CIST bridge cur - Display current Priority (0-65535) Max Age (6-40 secs) Forward Delay (4-30 secs) CIST bridge parameters CIST bridge parameters are used only when the switch is in MSTP mode. CIST parameters do not affect operation of STP/PVST+.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 124 CIST Port Configuration Options Command Syntax and Usage link [auto|p2p|shared] Defines the type of link connected to the port, as follows: auto: Configures the port to detect the link type, and automatically match its settings. p2p: Configures the port for Point-To-Point protocol. shared: Configures the port to connect to a shared medium (usually a hub). The default link type is auto. edge enable|disable Enables or disables this port as an edge port.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 125 Spanning Tree Configuration Options Command Syntax and Usage off Globally disables Spanning Tree Protocol. default Restores a Spanning Tree instance to its default configuration. cur Displays current Spanning Tree Protocol parameters.
BLADE OS 5.0 Command Reference /cfg/l2/stp /brg Spanning Tree Bridge Configuration [Bridge Spanning Tree Menu] prior - Set bridge Priority [0-65535] hello - Set bridge Hello Time [1-10 secs] mxage - Set bridge Max Age (6-40 secs) fwd - Set bridge Forward Delay (4-30 secs) cur - Display current bridge parameters Spanning Tree bridge parameters affect the global STG operation of the switch.
BLADE OS 5.0 Command Reference Table 126 Spanning Tree Bridge Options Command Syntax and Usage fwd Configures the bridge forward delay parameter. The forward delay parameter specifies the amount of time that a bridge port has to wait before it changes from the listening state to the learning state and from the learning state to the forwarding state. The range is 4 to 30 seconds, and the default is 15 seconds.
BLADE OS 5.0 Command Reference The port option of STG is turned on by default. Table 127 Spanning Tree Port Options Command Syntax and Usage prior Configures the port priority. The port priority helps determine which bridge port becomes the designated port. In a network topology that has multiple bridge ports connected to a single segment, the port with the lowest port priority becomes the designated port for the segment. The default value is 128.
BLADE OS 5.0 Command Reference Table 127 Spanning Tree Port Options Command Syntax and Usage off Disables STG on the port. cur Displays the current STG port parameters. /cfg/l2/fdb Forwarding Database Configuration [FDB Menu] static aging cur - Static FDB Menu - Configure FDB aging value - Display current FDB configuration Use the following commands to configure the Forwarding Database (FDB) for the G8124.
BLADE OS 5.0 Command Reference /cfg/l2/fdb/static Static FDB Configuration [Static FDB Menu] add - Add a permanent FDB entry del - Delete a static FDB entry clear - Clear static FDB entries cur - Display current static FDB configuration Use the following commands to configure static entries in the Forwarding Database (FBD). Table 129 Static FDB Configuration Options Command Syntax and Usage add Adds a permanent FDB entry.
BLADE OS 5.0 Command Reference /cfg/l2/trunk Trunk Configuration [Trunk group 1 Menu] add - Add port to trunk group rem - Remove port from trunk group ena - Enable trunk group dis - Disable trunk group del - Delete trunk group cur - Display current Trunk Group configuration Trunk groups can provide super-bandwidth connections between G8124s or other trunk capable devices. A trunk is a group of ports that act together, combining their bandwidth to create a single, larger port.
BLADE OS 5.0 Command Reference /cfg/l2/thash IP Trunk Hash Configuration [IP Trunk Hash Menu] set - IP Trunk Hash Settings Menu cur - Display current IP trunk hash configuration Use the following commands to configure IP trunk hash settings for the G8124. The trunk hash settings affect both static trunks and LACP trunks. Table 131 IP Trunk Hash Options Command Syntax and Usage set Displays the Trunk Hash Settings menu. To view menu options, see page 237. cur Display current trunk hash configuration.
BLADE OS 5.0 Command Reference /cfg/l2/thash/set IP Trunk Hash [set IP Trunk smac dmac sip dip cur Hash Settings Menu] - Enable/disable smac hash - Enable/disable dmac hash - Enable/disable sip hash - Enable/disable dip hash - Display current trunk hash setting Trunk hash parameters are set globally for the G8124.
BLADE OS 5.0 Command Reference /cfg/l2/lacp LACP Configuration [LACP Menu] port sysprio timeout delete default cur - LACP Port Menu - Set LACP system priority - Set LACP system timeout scale for timing out partner info - Delete an LACP trunk - Restore default LACP system configuration - Display current LACP configuration Use the following commands to configure Link Aggregation Control Protocol (LACP) for the G8124.
BLADE OS 5.0 Command Reference /cfg/l2/lacp/port LACP Port Configuration [LACP Port 1 Menu] mode - Set LACP mode prio - Set LACP port priority adminkey - Set LACP port admin key default - Restore default LACP port configuration cur - Display current LACP port configuration Use the following commands to configure Link Aggregation Control Protocol (LACP) for the selected port.
BLADE OS 5.0 Command Reference /cfg/l2/failovr Layer 2 Failover Configuration [Failover Menu] trigger on off cur - Trigger Menu Globally turn Failover ON Globally turn Failover OFF Display current Failover configuration Use this menu to configure Layer 2 Failover. For more information about Layer 2 Failover, see “High Availability” in the BLADE OS Application Guide. Table 135 Layer 2 Failover Configuration Options Command Syntax and Usage trigger <1-8> Displays the Failover Trigger menu.
BLADE OS 5.0 Command Reference /cfg/l2/failovr/trigger <1-8> Failover Trigger Configuration [Trigger 1 Menu] mmon - Manual Monitor Menu limit - Limit of Trigger ena - Enable Trigger dis - Disable Trigger del - Delete Trigger cur - Display current Trigger configuration Table 136 Failover Trigger Options Command Syntax and Usage mmon Displays the Manual Monitor menu for the selected trigger. To view menu options, see page 242.
BLADE OS 5.0 Command Reference /cfg/l2/failovr/trigger/mmon Manual Monitor Configuration [Manual Monitor monitor control cur - Menu] Monitor Menu Control Menu Display current Manual Monitor configuration Use this menu to configure Failover Manual Monitor. These menus allow you to manually define both the monitor and control ports that participate in failover teaming.
BLADE OS 5.0 Command Reference /cfg/l2/failovr/trigger/mmon/monitor Manual Monitor Port Configuration [Monitor Menu] addport remport addtrnk remtrnk addkey remkey cur - Add port to Monitor Remove port from Monitor Add trunk to Monitor Remove trunk from Monitor Add LACP port adminkey to Monitor Remove LACP port adminkey from Monitor Display current Monitor configuration Use this menu to define the port link(s) to monitor. The Manual Monitor - Monitor configuration accepts only external uplink ports.
BLADE OS 5.0 Command Reference /cfg/l2/failovr/trigger/mmon/control Manual Monitor Control Configuration [Control Menu] addport remport addtrnk remtrnk addkey remkey cur - Add port to Control Remove port from Control Add trunk to Control Remove trunk from Control Add LACP port adminkey to Control Remove LACP port adminkey from Control Display current Control configuration Use this menu to define the port link(s) to control.
BLADE OS 5.0 Command Reference /cfg/l2/hotlink Hot Links Configuration [Hot Links Menu] trigger - Trigger Menu bpdu - Enable/disable BPDU flood sndfdb - Enable/disable FDB update on - Globally turn Hot Links ON off - Globally turn Hot Links OFF cur - Display current Hot Links configuration Table 139 describes the Hot Links menu options. Table 139 Hot Links Configuration Options Command Syntax and Usage trigger <1-25> Displays the Hot Links Trigger menu. To view menu options, see page 246.
BLADE OS 5.0 Command Reference /cfg/l2/hotlink/trigger <1-25> Hot Links Trigger Configuration [Trigger 2 Menu] master - Master Menu backup - Backup Menu fdelay - Set Forward Delay (secs) name - Set Trigger Name preempt - Enable/disable Preemption ena - Enable Trigger dis - Disable Trigger del - Delete Trigger cur - Display current Trigger configuration Table 140 Hot Links Trigger Options Command Syntax and Usage master Displays the Master interface menu for the selected trigger.
BLADE OS 5.0 Command Reference Table 140 Hot Links Trigger Options Command Syntax and Usage del Deletes the Hot Links trigger. cur Displays the current Hot Links Trigger configuration.
BLADE OS 5.0 Command Reference /cfg/l2/hotlink/trigger <1-25>/backup Hot Links Trigger Backup Configuration [Backup Menu] port trunk adminkey cur - Set port in Backup Set trunk in Backup Set adminkey in Backup Display current Backup configuration Table 142 Hot Links Trigger Backup Options Command Syntax and Usage port Adds the selected port to the Backup interface. Enter 0 (zero) to clear the port. trunk Adds the selected trunk to the Backup interface.
BLADE OS 5.0 Command Reference /cfg/l2/vlan VLAN Configuration [VLAN 1 Menu] privlan name stg add rem def ena dis del cur - Private-VLAN Menu Set VLAN name Assign VLAN to a Spanning Tree Group Add port to VLAN Remove port from VLAN Define VLAN as list of ports Enable VLAN Disable VLAN Delete VLAN Display current VLAN configuration The commands in this menu configure VLAN attributes, change the status of each VLAN, change the port membership of each VLAN, and delete VLANs.
BLADE OS 5.0 Command Reference Table 143 VLAN Configuration Options Command Syntax and Usage def Defines which ports are members of this VLAN. Every port must be a member of at least one VLAN. By default, all ports are members of VLAN 1. ena Enables this VLAN. dis Disables this VLAN without removing it from the configuration. del Deletes this VLAN. cur Displays the current VLAN configuration. Note – All ports must belong to at least one VLAN.
BLADE OS 5.0 Command Reference /cfg/l2/vlan/privlan Private VLAN Configuration [privlan Menu] type map ena dis cur - Set Private-VLAN type Associate secondary VLAN with a primary VLAN Enable Private-VLAN Disable Private-VLAN Display current Private-VLAN configuration Use this menu to configure a Private VLAN. Table 144 Private VLAN Configuration Options Command Syntax and Usage type primary|isolated|community Defines the VLAN type, as follows: primary: A Private VLAN must have only one primary VLAN.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 145 Layer 3 Configuration Menu Command Syntax and Usage rip Displays the Routing Interface Protocol menu. To view menu options, see page 267. ospf Displays the OSPF menu. To view menu options, see page 271. igmp Displays the IGMP menu. To view menu options, see page 283. dns Displays the IP Domain Name System menu. To view menu options, see page 293. bootp Displays the Bootstrap Protocol menu. To view menu options, see page 294.
BLADE OS 5.0 Command Reference /cfg/l3/if IP Interface Configuration [IP Interface addr mask vlan relay ena dis del cur 1 - Menu] Set IP address Set subnet mask Set VLAN number Enable/disable BOOTP relay Enable IP interface Disable IP interface Delete IP interface Display current interface configuration The G8124 can be configured with up to 128 IP interfaces. Each IP interface represents the G8124 on an IP subnet on your network. The Interface option is disabled by default.
BLADE OS 5.0 Command Reference Table 146 IP Interface Configuration Options Command Syntax and Usage del Removes this IP interface. cur Displays the current interface settings.
BLADE OS 5.0 Command Reference Table 147 Default Gateway Configuration Options Command Syntax and Usage arp disable|enable Enables or disables Address Resolution Protocol (ARP) health checks. The default value is disabled. The arp option does not apply to management gateways. ena Enables the gateway for use. dis Disables the gateway. del Deletes the gateway from the configuration. cur Displays the current gateway settings.
BLADE OS 5.0 Command Reference /cfg/l3/route IPv4 Static Route Configuration [IP Static Route Menu] add - Add static route rem - Remove static route clear - Clear static routes interval - Change ECMP route health check ping interval retries - Change the number of retries for ECMP health check ecmphash - Choose ECMP hash mechanism cur - Display current static route configuration Up to 128 IPv4 static routes can be configured.
BLADE OS 5.0 Command Reference Table 148 IP Static Route Configuration Options Command Syntax and Usage ecmphash [sip][dip][protocol][tcpl4][udpl4][sport][dport] Configures ECMP hashing parameters. You may choose one or more of the following parameters: sip: Source IP address dip: Destination IP address protocol: Layer 3 protocol tcpl4: Layer 4 TCP traffic udpl4: Layer 4 UDP traffic sport: Source port dport: Destination port cur Displays the current IPv4 static routes.
BLADE OS 5.0 Command Reference /cfg/l3/arp ARP Configuration Address Resolution Protocol (ARP) is the TCP/IP protocol that resides within the Internet layer. ARP resolves a physical address from an IP address. ARP queries machines on the local network for their physical addresses. ARP also maintains IP to physical address pairs in its cache memory. In any IP communication, the ARP cache is consulted to see if the IP address of the computer or the router is present in the ARP cache.
BLADE OS 5.0 Command Reference /cfg/l3/arp/static ARP Static Configuration Static ARP entries are permanent in the ARP cache and do not age out like the ARP entries that are learned dynamically. Static ARP entries enable the switch to reach the hosts without sending an ARP broadcast request to the network. Static ARPs are also useful to communicate with devices that do not respond to ARP requests.
BLADE OS 5.0 Command Reference /cfg/l3/frwd IP Forwarding Configuration [IP Forwarding Menu] dirbr - Enable or disable forwarding directed broadcasts noicmprd - Enable/disable No ICMP Redirects on - Globally turn IP Forwarding ON off - Globally turn IP Forwarding OFF cur - Display current IP Forwarding configuration Table 151 IP Forwarding Configuration Options Command Syntax and Usage dirbr disable|enable Enables or disables forwarding directed broadcasts. The default setting is disabled.
BLADE OS 5.0 Command Reference /cfg/l3/nwf <1-256> Network Filter Configuration [IP Network Filter 1 Menu] addr - IP Address mask - IP network filter mask enable - Enable Network Filter disable - Disable Network Filter delete - Delete Network Filter cur - Display current Network Filter configuration Table 152 IP Network Filter Options Command Syntax and Usage addr Sets the IP address that will be accepted by the peer when the filter is enabled.
BLADE OS 5.0 Command Reference /cfg/l3/rmap Routing Map Configuration Note – The map number (1-32) represents the routing map you wish to configure.
BLADE OS 5.0 Command Reference Table 153 Routing Map Configuration Options Command Syntax and Usage type |none Assigns the type of OSPF metric. The default is type 1. Type 1—External routes are calculated using both internal and external metrics. Type 2—External routes are calculated using only the external metrics. Type 1 routes have more cost than Type 2. none—Removes the OSPF metric. prec Sets the precedence of the route map.
BLADE OS 5.0 Command Reference /cfg/l3/rmap /alist IP Access List Configuration Note – The route map number (1-32) and the access list number (1-8) represent the IP access list you wish to configure.
BLADE OS 5.0 Command Reference /cfg/l3/rmap /aspath Autonomous System Filter Path Note – The rmap number (1-32) and the path number (1-8) represent the AS path you wish to configure.
BLADE OS 5.0 Command Reference /cfg/l3/rip Routing Information Protocol Configuration [Routing Information Protocol Menu] if - RIP Interface Menu update - Set update period in seconds redist - RIP Route Redistribute Menu on - Globally turn RIP ON off - Globally turn RIP OFF current - Display current RIP configuration The RIP menu is used for configuring Routing Information Protocol (RIP) parameters. This option is turned off by default.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 157 RIP Interface Options Command Syntax and Usage trigg disable|enable Enables or disables Triggered Updates. Triggered Updates are used to speed convergence. When enabled, Triggered Updates force a router to send update messages immediately, even if it is not yet time for the update message. The default value is enabled. mcast disable|enable Enables or disables multicast updates of the routing table (using address 224.0.0.9). The default value is enabled.
BLADE OS 5.0 Command Reference /cfg/l3/rip/redist fixed|static|ospf|eospf RIP Route Redistribution Configuration [RIP Redistribute Fixed Menu] add - Add rmap into route redistribution list rem - Remove rmap from route redistribution list export - Export all routes of this protocol cur - Display current route-maps added The following table describes the RIP Route Redistribute menu options.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 159 OSPF Configuration Options Command Syntax and Usage redist fixed|static|rip Displays the OSPF Route Distribution menu. See page 281 to view menu options. lsdb Sets the link state database limit. default |none Sets one default route among multiple choices in an area. Use none for no default. on Enables OSPF on the G8124. off Disables OSPF on the G8124.
BLADE OS 5.0 Command Reference /cfg/l3/ospf/aindex Area Index Configuration [OSPF Area (index) 1 Menu] areaid - Set area ID type - Set area type metric - Set stub area metric auth - Set authentication type spf - Set time interval between two SPF calculations enable - Enable area disable - Disable area delete - Delete area cur - Display current OSPF area configuration Table 160 Area Index Configuration Options Command Syntax and Usage areaid
BLADE OS 5.0 Command Reference Table 160 Area Index Configuration Options Command Syntax and Usage auth none|password|md5 none: No authentication required. password: Authenticates simple passwords so that only trusted routing devices can participate. md5: This parameter is used when MD5 cryptographic authentication is required. spf Sets time interval between two successive SPF (shortest path first) calculations of the shortest path tree using the Dijkstra’s algorithm.
BLADE OS 5.0 Command Reference /cfg/l3/ospf/range OSPF Summary Range Configuration [OSPF Summary addr mask aindex hide enable disable delete cur Range 1 Menu] - Set IP address - Set IP mask - Set area index - Enable/disable hide range - Enable range - Disable range - Delete range - Display current OSPF summary range configuration Table 161 OSPF Summary Range Configuration Options Command Syntax and Usage addr
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 162 OSPF Interface Configuration Options Command Syntax and Usage trans <1-3600> Configures the transit delay in seconds. retra <1-3600> Configures the retransmit interval in seconds. key |none Sets the authentication key to clear the password. mdkey |none Assigns an MD5 key to the interface. passive enable|disable Sets the interface as passive.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 163 OSPF Virtual Link Configuration Options Command Syntax and Usage mdkey |none Sets MD5 key ID for each virtual link. Default is none. enable Enables OSPF virtual link. disable Disables OSPF virtual link. delete Deletes OSPF virtual link. cur Displays the current OSPF virtual link settings.
BLADE OS 5.0 Command Reference /cfg/l3/ospf/host OSPF Host Entry Configuration [OSPF Host Entry 1 Menu] addr - Set host entry IP address aindex - Set area index cost - Set cost of this host entry enable - Enable host entry disable - Disable host entry delete - Delete host entry cur - Display current OSPF host entry configuration Table 164 OSPF Host Entry Configuration Options Command Syntax and Usage addr
BLADE OS 5.0 Command Reference /cfg/l3/ospf/redist fixed|static|rip OSPF Route Redistribution Configuration [OSPF Redistribute Fixed Menu] add - Add rmap into route redistribution list rem - Remove rmap from route redistribution list export - Export all routes of this protocol cur - Display current route-maps added Table 165 OSPF Route Redistribution Options Command Syntax and Usage add ( )... |all Adds selected routing maps to the rmap list.
BLADE OS 5.0 Command Reference /cfg/l3/ospf/md5key OSPF MD5 Key Configuration [OSPF MD5 Key key delete cur 1 - Menu] Set authentication key Delete key Display current MD5 key configuration Table 166 OSPF MD5 Key Configuration Options Command Syntax and Usage key <1-16 characters> Sets the authentication key for this OSPF packet. delete Deletes the authentication key for this OSPF packet. cur Displays the current MD5 key configuration.
BLADE OS 5.0 Command Reference /cfg/l3/igmp IGMP Configuration [IGMP Menu] snoop mrouter igmpflt querier on off cur - IGMP Snoop Menu Static Multicast Router Menu IGMP Filtering Menu IGMP Querier Menu Globally turn IGMP ON Globally turn IGMP OFF Display current IGMP configuration Table 167 describes the commands used to configure basic IGMP parameters. Table 167 IGMP Configuration Options Command Syntax and Usage snoop Displays the IGMP Snooping menu. To view menu options, see page 284.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 168 IGMP Snoop Options Command Syntax and Usage robust <2-10> Configures the IGMP Robustness variable, which allows you to tune the switch for expected packet loss on the subnet. If the subnet is expected to be lossy (high rate of packet loss), increase the value. The default value is 2. flood enable|disable Configures the switch to flood unregistered IP multicast traffic to all ports. The default setting is enabled.
BLADE OS 5.0 Command Reference /cfg/l3/igmp/snoop/igmpv3 IGMP Version 3 Configuration [IGMP V3 Snoop Menu] sources - Set the number of sources to snoop in group record v1v2 - Enable/disable snooping IGMPv1/v2 reports exclude - Enable/disable snooping EXCLUDE mode reports ena - Enable IGMPv3 Snooping dis - Disable IGMPv3 Snooping cur - Display current IGMP Snooping V3 configuration Table 169 describes the commands used to configure IGMP version 3.
BLADE OS 5.0 Command Reference /cfg/l3/igmp/mrouter IGMP Static Multicast Router Configuration [Static Multicast Router Menu] add - Add port as Multicast Router Port rem - Remove port as Multicast Router Port clear - Remove all Static Multicast Router Ports cur - Display current Multicast Router configuration Table 170 describes the commands used to configure a static multicast router. Note – When static Mrouters are used, the switch continues learning dynamic Mrouters via IGMP snooping.
BLADE OS 5.0 Command Reference /cfg/l3/igmp/igmpflt IGMP Filtering Configuration [IGMP Filter Menu] filter - IGMP Filter Definition Menu port - IGMP Filtering Port Menu ena - Enable IGMP Filtering dis - Disable IGMP Filtering cur - Display current IGMP Filtering configuration Table 171 describes the commands used to configure an IGMP filter. Table 171 IGMP Filtering Options Command Syntax and Usage filter Displays the IGMP Filter Definition menu. To view menu options, see page 289.
BLADE OS 5.0 Command Reference /cfg/l3/igmp/igmpflt/filter IGMP Filter Definition [IGMP Filter 1 Definition Menu] range - Set IP Multicast address range action - Set filter action ena - Enable filter dis - Disable filter del - Delete filter cur - Display current IGMP filter configuration Table 172 describes the commands used to define an IGMP filter. Table 172 IGMP Filter Definition Options Command Syntax and Usage range
BLADE OS 5.0 Command Reference /cfg/l3/igmp/igmpflt/port IGMP Filtering Port Configuration [IGMP Port 1 Menu] filt - Enable/disable IGMP filtering on port add - Add IGMP filter to port rem - Remove IGMP filter from port cur - Display current IGMP filtering Port configuration Table 173 describes the commands used to configure a port for IGMP filtering. Table 173 IGMP Filter Port Options Command Syntax and Usage filt enable|disable Enables or disables IGMP filtering on this port.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 174 IGMP Querier Options Command Syntax and Usage count <1-10> Configures the Startup Query Count, which is the number of IGMP Queries sent out at startup. Each Query is separated by the Startup Query Interval. sinter <1-608> Configures the Startup Query Interval, which is the interval between General Queries sent out at startup. version [v1|v2|v3] Configures the IGMP version. on Globally turns IGMP Querier on. off Globally turns IGMP Querier off.
BLADE OS 5.0 Command Reference /cfg/l3/dns Domain Name System Configuration [Domain Name System Menu] prima - Set IP address of primary DNS server secon - Set IP address of secondary DNS server dname - Set default domain name cur - Display current DNS configuration The Domain Name System (DNS) menu is used for defining the primary and secondary DNS servers on your local network, and for setting the default domain name served by the switch services.
BLADE OS 5.0 Command Reference /cfg/l3/bootp Bootstrap Protocol Relay Configuration [Bootstrap Protocol Relay Menu] addr - Set IP address of BOOTP server addr2 - Set IP address of second BOOTP server on - Globally turn BOOTP relay ON off - Globally turn BOOTP relay OFF cur - Display current BOOTP relay configuration The Bootstrap Protocol (BOOTP) Relay menu is used to allow hosts to obtain their configurations from a Dynamic Host Configuration Protocol (DHCP) server.
BLADE OS 5.0 Command Reference /cfg/l3/vrrp VRRP Configuration [Virtual Router vr group if track on off cur - Redundancy Protocol Menu] VRRP Virtual Router menu VRRP Virtual Router Group menu VRRP Interface menu VRRP Priority Tracking menu Globally turn VRRP ON Globally turn VRRP OFF Display current VRRP configuration Virtual Router Redundancy Protocol (VRRP) support on the G8124 provides redundancy between routers in a LAN.
BLADE OS 5.0 Command Reference Table 177 VRRP Configuration Options Command Syntax and Usage on Globally enables VRRP on this switch. off Globally disables VRRP on this switch. cur Displays the current VRRP parameters.
BLADE OS 5.0 Command Reference Virtual routers are disabled by default. Table 178 VRRP Virtual Router Options Command Syntax and Usage track Displays the VRRP Priority Tracking menu for this virtual router. Tracking is an BLADE OS proprietary extension to VRRP, used for modifying the standard priority system used for electing the master router. To view menu options, see page 299. vrid Defines the virtual router ID.
BLADE OS 5.0 Command Reference Table 178 VRRP Virtual Router Options Command Syntax and Usage prio <1-254> Defines the election priority bias for this virtual server. This can be any integer between 1 and 254. The default value is 100. During the master router election process, the routing device with the highest virtual router priority number wins. If there is a tie, the device with the highest IP interface address wins.
BLADE OS 5.0 Command Reference Table 178 VRRP Virtual Router Options Command Syntax and Usage dis Disables this virtual router. del Deletes this virtual router from the switch configuration. cur Displays the current configuration information for this virtual router.
BLADE OS 5.0 Command Reference Some tracking criteria (vrs, ifs, and ports below) apply to standard virtual routers, otherwise called “virtual interface routers.” A virtual server router is defined as any virtual router whose IP address (addr) is the same as any configured virtual server IP address.
BLADE OS 5.
BLADE OS 5.0 Command Reference Table 180 Virtual Router Group Options Command Syntax and Usage prio <1-254> Defines the election priority bias for this virtual router group. This can be any integer between 1 and 254. The default value is 100. During the master router election process, the routing device with the highest virtual router priority number wins. If there is a tie, the device with the highest IP interface address wins.
BLADE OS 5.0 Command Reference Table 180 Virtual Router Group Options Command Syntax and Usage del Deletes the virtual router group from the switch configuration. cur Displays the current configuration information for the virtual router group.
BLADE OS 5.0 Command Reference /cfg/l3/vrrp/if VRRP Interface Configuration Note – The interface-number represents the IP interface on which authentication parameters must be configured. [VRRP Interface auth passw del cur - 1 Menu] Set authentication types Set plain-text password Delete interface Display current VRRP interface configuration This menu is used for configuring VRRP authentication parameters for the IP interfaces used with the virtual routers.
BLADE OS 5.0 Command Reference /cfg/l3/vrrp/track VRRP Tracking Configuration [VRRP Tracking Menu] vrs - Set priority increment for virtual router tracking ifs - Set priority increment for IP interface tracking ports - Set priority increment for VLAN switch port tracking cur - Display current VRRP Priority Tracking configuration This menu is used for setting weights for the various criteria used to modify priority levels during the master router election process.
BLADE OS 5.0 Command Reference /cfg/setup Setup The setup program steps you through configuring the system date and time, BOOTP, IP, Spanning Tree, port speed/mode, VLAN parameters, and IP interfaces. To start the setup program, at the Configuration# prompt, enter: Configuration# setup For a complete description of how to use setup, see “First-Time Configuration” on page 21. /cfg/dump Dump The dump program writes the current switch configuration to the terminal screen.
BLADE OS 5.0 Command Reference /cfg/ptcfg Saving the Active Switch Configuration When the ptcfg command is used, the switch’s active configuration commands (as displayed using /cfg/dump) will be uploaded to the specified script configuration file on the FTP/TFTP server.
BLADE OS 5.
CHAPTER 7 The Operations Menu The Operations menu is generally used for commands that affect switch performance immediately, but do not alter permanent switch configurations. For example, you can use the Operations menu to immediately disable a port (without the need to apply or save the change), with the understanding that when the switch is reset, the port returns to its normally configured operation.
BLADE OS 5.0 Command Reference The commands of the Operations menu enable you to alter switch operational characteristics without affecting switch configuration. Table 184 Operations Menu Options Command Syntax and Usage port Displays the Operational Port menu. To view menu options, see page 311. vrrp Displays the Operational Virtual Router Redundancy menu. To view menu options, see page 312. sys Displays the Operational System menu. To view menu options, see page 312.
BLADE OS 5.0 Command Reference /oper/port Operations-Level Port Options [Operations Port 1 Menu] ena - Enable port dis - Disable port lena - Enable FDB Learning ldis - Disable FDB Learning cur - Current port state Operations-level port options are used for temporarily disabling or enabling a port, and for re-setting the port. Table 185 Operations-Level Port Options Command Syntax and Usage ena Temporarily enables the port.
BLADE OS 5.0 Command Reference /oper/vrrp Operations-Level VRRP Options [VRRP Operations Menu] back - Set virtual router to backup Table 186 Operations-Level VRRP Options Command Syntax and Usage back {|group} Forces the specified master virtual router on this switch into backup mode. This is generally used for passing master control back to a preferred switch once the preferred switch has been returned to service after a failure.
CHAPTER 8 The Boot Options Menu To use the Boot Options menu, you must be logged in to the switch as the administrator.
BLADE OS 5.0 Command Reference Updating the Switch Software Image The switch software image is the executable code running on the RackSwitch G8124. A version of the image ships with the switch, and comes pre-installed on the device. As new versions of the image are released, you can upgrade the software running on your switch. On the support site, click on software updates. On the switch, use the /boot/cur command to determine the current software version.
BLADE OS 5.0 Command Reference 1. At the Boot Options# prompt, enter: Boot Options# gtimg 2. Enter the name of the switch software to be replaced: Enter name of switch software image to be replaced ["image1"/"image2"/"boot"]: 3. Enter the hostname or IPv4 address of the FTP or TFTP server. Enter hostname or IP address of FTP/TFTP server: 4. Enter the name of the new software file on the server.
BLADE OS 5.0 Command Reference The system informs you of which image is currently set to be loaded at the next reset, and prompts you to enter a new choice: Currently set to use switch software "image1" on next reset. Specify new image to use on next reset ["image1"/"image2"]: Uploading a Software Image from Your Switch You can upload a software image from the switch to a FTP or TFTP server. 1. At the Boot Options# prompt, enter: Boot Options# ptimg 2. The system prompts you for information.
BLADE OS 5.0 Command Reference Selecting a Configuration Block When you make configuration changes to the G8124, you must save the changes so that they are retained beyond the next time the switch is reset. When you perform the save command, your new configuration changes are placed in the active configuration block. The previous configuration is copied into the backup configuration block. There is also a factory configuration block.
BLADE OS 5.0 Command Reference Accessing the ISCLI The default command-line interface for the G8124 is the BLADE OS CLI. To access the ISCLI, enter the following command and reset the G8124: Main# boot/mode iscli To access the BLADE OS CLI, enter the following command from the ISCLI and reload the G8124: Switch (config)# boot cli-mode bladeos-cli Users can select the CLI mode upon login, if the /boot/prompt command is enabled. Only an administrator can view and enable /boot/prompt.
CHAPTER 9 The Maintenance Menu The Maintenance menu is used to manage dump information and forward database information. It also includes a debugging menu to help with troubleshooting. /maint Maintenance Menu Note – To use the Maintenance menu, you must be logged in to the switch as the administrator.
BLADE OS 5.0 Command Reference Table 187 Maintenance Menu Options (/maint) Command Syntax and Usage sys Displays the System Maintenance menu. To view menu options, see page 321. fdb Displays the Forwarding Database Manipulation menu. To view menu options, see page 322. debug Displays the Debugging menu. To view menu options, see page 323. arp Displays the ARP Cache Manipulation menu. To view menu options, see page 324. route Displays the IP Route Manipulation menu. To view menu options, see page 325.
BLADE OS 5.0 Command Reference /maint/sys System Maintenance This menu is reserved for use by Technical Support personnel. The options are used to perform system debugging. [System Maintenance Menu] flags - Set NVRAM flag word tmask - Set MP trace mask word Table 188 System Maintenance Options Command Syntax and Usage flags This command sets the flags that are used for debugging purposes by Technical Support personnel.
BLADE OS 5.0 Command Reference /maint/fdb Forwarding Database Maintenance [FDB Manipulation Menu] find - Show a single FDB entry by MAC address port - Show FDB entries for a single port vlan - Show FDB entries for a single VLAN dump - Show all FDB entries del - Delete an FDB entry clear - Clear entire FDB The Forwarding Database Manipulation menu can be used to view information and to delete a MAC address from the forwarding database or clear the entire forwarding database.
BLADE OS 5.0 Command Reference /maint/debug Debugging [Miscellaneous Debug Menu] tbuf - Show MP trace buffer snap - Show MP snap (or post-mortem) trace buffer clrcfg - Clear all flash configs The Miscellaneous Debug menu displays trace buffer information about events that can be helpful in understanding switch operation.
BLADE OS 5.0 Command Reference /maint/arp ARP Cache Maintenance [Address Resolution Protocol Menu] find - Show a single ARP entry by IP address port - Show ARP entries on a single port vlan - Show ARP entries on a single VLAN addr - Show ARP entries for switch's interfaces dump - Show all ARP entries clear - Clear ARP cache Table 191 ARP Maintenance Options Command Syntax and Usage find Shows a single ARP entry by IP address.
BLADE OS 5.0 Command Reference /maint/route IP Route Manipulation [IP Routing Menu] find - Show a single route by destination IP address gw - Show routes to a single gateway type - Show routes of a single type tag - Show routes of a single tag if - Show routes on a single interface dump - Show all routes clear - Clear route table Table 192 IP Route Manipulation Options Command Syntax and Usage find Shows a single route by destination IP address.
BLADE OS 5.0 Command Reference /maint/igmp IGMP Maintenance [IGMP Multicast snoop mrouter clear - Group Menu] IGMP Snooping Menu IGMP Multicast Router Port Menu Clear group and mrouter tables Table 193 describes the IGMP Maintenance commands. Table 193 IGMP Maintenance Options Command Syntax and Usage group Displays the IGMP Snooping maintenance menu. To view menu options, see page 327. mrouter Displays the Multicast Router Port menu. To view menu options, see page 326.
BLADE OS 5.0 Command Reference /maint/igmp/snoop IGMP Group Maintenance [IGMP Multicast find vlan port trunk detail dump clear - Group Menu] Show a single group by IP group address Show groups on a single vlan Show groups on a single port Show groups on a single trunk Show detail of a single group by IP address Show all groups Clear group tables Table 193 describes the IGMP Snooping maintenance commands.
BLADE OS 5.0 Command Reference /maint/igmp/mrouter IGMP Multicast Routers Maintenance [IGMP Multicast vlan dump clear - Routers Menu] Show all multicast router ports on a single vlan Show all multicast router ports Clear multicast router port table Table 195 describes the IGMP multicast router (Mrouter) maintenance commands. Table 195 IGMP Mrouter Maintenance Options Command Syntax and Usage vlan Shows all IGMP multicast router ports on a single VLAN.
BLADE OS 5.0 Command Reference /maint/uudmp Uuencode Flash Dump Using this command, dump information is presented in uuencoded format. This format makes it easy to capture the dump information as a file or a string of characters. If you want to capture dump information to a file, set your communication software on your workstation to capture session data prior to issuing the uudmp command. This will ensure that you do not lose any information.
BLADE OS 5.0 Command Reference /maint/cldmp Clearing Dump Information To clear dump information from flash memory, at the Maintenance# prompt, enter: Maintenance# cldmp The switch clears the dump region of flash memory and displays the following message: FLASH dump region cleared. If the flash dump region is already clear, the switch displays the following message: FLASH dump region is already clear.
APPENDIX A BLADE OS Syslog Messages The following syntax is used when outputting syslog messages:
BLADE OS 5.0 Command Reference LOG_CRIT Thread Message SSH can't allocate memory in load_MP_INT() SSH currently not enough resource for loading RSA {private|public key} SYSTEM System memory is at percent Log_WARNING Thread Message There is an IP address () conflict on the network. CFG Authentication should be disabled to run RIPv2 in RIPv1 compatibility mode on interface .
BLADE OS 5.0 Command Reference Thread Message SYSTEM I2C device set to access state [from CLI] SYSTEM Interface failed to renew DHCP Lease. Use factory default while requesting for a new DHCP offer.
BLADE OS 5.
BLADE OS 5.0 Command Reference Thread Message VRRP VRRP : received incorrect IP addresses list from VRRP VRRP : received incorrect IP addresses list from . Received virtual routers instead of LOG_ERR Thread Message CFG Configuration file is EMPTY CFG Configuration is too large CFG Default VLAN cannot be a private-VLAN.
BLADE OS 5.0 Command Reference Thread Message PORT_MIRR ERROR: Management port cannot be a mirrored port PORT_MIRR ERROR: Only 4 monitoring port sessions can be supported STP Cannot set "{Hello Time|Max Age|Forward Delay|Aging}" (Switch is in MSTP mode) SYSTEM Error: BOOTP Offer was found incompatible with the other IP interfaces SYSTEM Error: DHCP Offer was found invalid by ip configuration checking; please see system log for details.
BLADE OS 5.0 Command Reference Thread Message CONSOLE RADIUS: No configured RADIUS server CONSOLE RADIUS: trying alternate server... HOTLINKS "Error" is set to "Standby|Active" HOTLINKS "Learning" is set to "Standby|Active" HOTLINKS "None" is set to "Standby|Active" HOTLINKS "Side Max" is set to "Standby|Active" HOTLINKS has no "{Side Max|None|Learning|Error}" interface IP default gateway {disabled|enabled|operational} IP Either Route or Arp table is full.
BLADE OS 5.0 Command Reference Thread Message MGMT Authentication failed for backdoor. Telnet disabled! MGMT boot config block changed MGMT boot image changed MGMT boot mode changed MGMT enable password changed MGMT Error in setting the new config MGMT Failed login attempt via {BBI|TELNET} from host .
BLADE OS 5.0 Command Reference Thread Message MGMT scp() login {on Console|from host } MGMT second syslog host changed to {this host|} MGMT selectable [boot] mode changed MGMT STP BPDU statistics cleared MGMT switch reset from CLI MGMT syslog host changed to {this host| } MGMT System clock set to
BLADE OS 5.
BLADE OS 5.
BLADE OS 5.0 Command Reference Thread Message VLAN Default VLAN can not be deleted VRRP virtual router is now BACKUP|MASTER VRRP Virtual Router Group is disabled due to no enabled virtual routers. WEB ejected from BBI WEB ejected from BBI because username password was changed WEB RSA host key is being saved to Flash ROM, please don't reboot the box immediately. LOG_INFO Thread Message System log cleared by user . System log cleared via SNMP.
BLADE OS 5.0 Command Reference Thread Message MGMT boot kernel Firmware upload failed. MGMT boot kernel Firmware uploaded. MGMT Can't downgrade to image with only single flash support MGMT Could not revert unsaved changes MGMT Download already currently in progress. Try again later via MGMT Error in setting the new config MGMT Failed to allocate buffer for diff track.
BLADE OS 5.0 Command Reference Thread Message MGMT invalid image download completed. Now writing to flash. MGMT invalid image downloaded from host , file '', software version MGMT invalid image downloaded {from host |via browser}, filename too long to be displayed, software version MGMT invalid image Firmware upload failed. MGMT invalid image Firmware uploaded.
BLADE OS 5.0 Command Reference Thread Message MGMT undefined downloaded {from host |via browser}, filename too long to be displayed, software version MGMT undefined Firmware upload failed. MGMT undefined Firmware uploaded.
BLADE OS 5.
Index Symbols / command .......................................................... 37 [ ]....................................................................... 13 Numerics 802.1p information ............................................ 100 802.1p priority configuration .............................. 205 A abbreviating commands (CLI) .............................. 42 access control user ........................................................... 190 Access Control Lists ...................................
BLADE OS 5.0 Command Reference command (help) .................................................. 37 Command-Line Interface (CLI) ....... 15 to 19, 21, 35 commands abbreviations ................................................ 42 conventions used in this manual...................... 13 global commands .......................................... 37 shortcuts ...................................................... 41 stacking ....................................................... 41 tab completion .............
BLADE OS 5.0 Command Reference Final Steps .......................................................... 29 first-time configuration ......................... 19, 21 to 34 fixed IP route tag .................................................. 84 flag field ............................................................. 86 flow control ................................................ 44, 104 configuring ................................................ 201 setup .....................................................
BLADE OS 5.0 Command Reference link status ........................................................... 44 command ................................................... 104 duplex mode ........................................ 44, 104 port speed ............................................ 44, 104 Link Status Information ..................................... 104 linkt (SNMP option) .......................................... 175 LISTENING (port state).......................................
BLADE OS 5.0 Command Reference password administrator account .................................... 18 default ......................................................... 18 user account ................................................. 18 VRRP authentication ................................... 304 passwords ........................................................... 18 ping ................................................................... 38 poisoned reverse, as used with split horizon .........
BLADE OS 5.0 Command Reference setup facility ................................................. 19, 21 IP configuration ............................................ 27 IP subnet mask ............................................. 28 port auto-negotiation mode ............................ 25 port configuration ......................................... 25 port flow control ........................................... 25 restarting ..................................................... 23 Spanning-Tree Protocol .
BLADE OS 5.0 Command Reference timeout radius server ............................................... 166 timeouts idle connection ............................................. 19 timers kickoff.................................................... 137 tnport system option ............................................. 187 trace buffer ....................................................... 323 traceroute............................................................ 38 Tracking VRRP ..............................
