Alteon OS Command Reference Nortel 10Gb Uplink Ethernet Switch Module for IBM BladeCenter Version 1.2 Part Number: BMD00007, November 2007 ® 2350 Mission College Blvd. Suite 600 Santa Clara, CA 95054 www.bladenetwork.net...
Page 2
Technologies, Inc. The use and purchase of this product does not convey a license under any patent rights, trademark rights, or any other intellectual property rights of Blade Network Technologies, Inc. Originated in the USA. Alteon OS, and Alteon are trademarks of Nortel Networks, Inc. in the United States and certain other ® countries. Cisco and EtherChannel and certain other countries.
Connecting to the Switch 20 Management Module Setup 20 Factory-Default vs. MM assigned IP Addresses 20 Default Gateway 21 Configuring management module for switch access 21 Connecting to the Switch via Telnet 23 Running Telnet 23 Establishing an SSH Connection 24...
Page 4
Alteon OS Command Reference Setup Part 3: VLANs 38 Setup Part 4: IP Configuration 39 IP Interfaces 39 Default Gateways 40 IP Routing 41 Setup Part 5: Final Steps 41 Optional Setup for Telnet Support 42 Setting Passwords 43 Changing the Default Administrator Password 43 Changing the Default User Password 45 Menu Basics 47 The Main Menu 48...
Page 5
Layer 2 Information 74 FDB Information 76 Show All FDB Information 77 Clearing Entries from the Forwarding Database 77 Link Aggregation Control Protocol Information 78 Show all LACP Information 78 GVRP Information 79 Show GVRP VLAN Database Information 80 Show GID State Machine Information 81 Show GID Port Ring Information 82 802.1x Information 83 Spanning Tree Information 85...
Page 6
Alteon OS Command Reference 802.1p Information 117 Access Control List Information 119 Link Status Information 120 Port Information 121 Fiber Port Transceiver Status 123 Information Dump 123 The Statistics Menu 125 Statistics Menu 125 Port Statistics 127 802.1x Authenticator Statistics 128 802.1x Authenticator Diagnostics 129 Bridging Statistics 131 Ethernet Statistics 133...
Page 7
SNMP Statistics 169 NTP Statistics 173 Statistics Dump 174 The Configuration Menu 175 Configuration Menu 176 Viewing, Applying, and Saving Changes 177 Viewing Pending Changes 177 Applying Pending Changes 178 Saving the Configuration 178 System Configuration 179 System Host Log Configuration 182 SSH Server Configuration 183 RADIUS Server Configuration 185 TACACS+ Server Configuration 187...
Page 8
Alteon OS Command Reference Layer 2 Configuration 217 802.1x Configuration 219 802.1x Global Configuration 220 802.1x Guest VLAN Configuration 222 802.1x Port Configuration 223 Rapid Spanning Tree Protocol/ Multiple Spanning Tree Protocol Configuration 225 Common Internal Spanning Tree Configuration 227 CIST Bridge Configuration 228 CIST Port Configuration 229 Spanning Tree Configuration 231...
Page 9
Routing Information Protocol Configuration 268 Routing Information Protocol Interface Configuration 269 Open Shortest Path First Configuration 271 Area Index Configuration 273 OSPF Summary Range Configuration 274 OSPF Interface Configuration 275 OSPF Virtual Link Configuration 277 OSPF Host Entry Configuration 278 OSPF Route Redistribution Configuration OSPF MD5 Key Configuration 280 Border Gateway Protocol Configuration 281...
Page 10
Loading New Software to Your Switch 341 Using the BBI 341 Using the CLI 343 Selecting a Software Image to Run 344 Uploading a Software Image from Your Switch 345 Selecting a Configuration Block 346 Resetting the Switch 347 Accessing the ISCLI 347...
Page 11
Alteon OS Syslog Messages 363 Alteon OS SNMP Agent 375 Working with Switch Images and Configuration Files 378 Loading a new switch image 379 Loading a saved switch configuration 380 Saving the switch configuration 380 Saving a switch dump 381...
Page 12
Alteon OS Command Reference Contents BMD00007, November 2007...
Nortel 10Gb Uplink Ethernet Switch Module (GbE Switch Module). For documentation on installing the switches physically, see the Installation Guide for your GbE Switch Module. For details about configuration and operation of your GbE Switch Mod- ule, see the Alteon OS Application Guide.
Alteon OS Command Reference Who Should Use This Book This Command Reference is intended for network installers and system administrators engaged in configuring and maintaining a network. The administrator should be familiar with Ethernet concepts, IP addressing, the IEEE 802.1d Spanning Tree Protocol, and SNMP configuration parameters.
Chapter 9 “The Maintenance Menu,” switch state information, how to clear it, and how to clear part or all of the forwarding database. Appendix A, “Alteon OS Syslog Messages,”...
Alteon OS Command Reference Typographic Conventions The following table describes the typographic styles used in this book. Table 1 Typographic Conventions Typeface or Symbol AaBbCc123 AaBbCc123 <AaBbCc123> This italicized type appears in command Preface Meaning This type is used for names of commands, files, and directories used within the text.
Page 17
Alteon OS Command Reference How to Get Help If you need help, service, or technical assistance, see the “Getting help and technical assis- tance” appendix in the Nortel 10Gb Uplink Ethernet Switch Module for IBM BladeCenter Installation Guide. BMD00007, November 2007...
Page 18
Alteon OS Command Reference Preface BMD00007, November 2007...
The command line interface is the most direct method for collecting switch information and performing switch configuration. Using a basic terminal, you are presented with a hierarchy of menus that enable you to view information and statistics about the switch, and to perform any necessary configuration.
Ethernet port on the management module, or the built-in serial port. You can use the four external Ethernet ports on the switch module for man- agement and control of the switch by selecting this mode as an option through the management module configuration utility program (see the applicable BladeCenter Installation and User’s...
Bay 3 Bay 4 – Switch Modules installed in Bay 1 and Bay 2 connect to server NICs 1 and 2, respec- tively. However, Windows operating systems show that Switch Modules installed in Bay 3 and Bay 4 connect to server NICs 4 and 3, respectively.
Page 22
Automatically through the IBM Director Configuration Wizard (available in Director release 4.21) – If you change the IP address of the GbE Switch Module, make sure that the switch module and the management module both reside on the same subnet.
– In Advanced Configuration > Advanced Setup, enable “Preserve new IP configura- tion on all switch resets,” to retain the switch’s IP interface when you restore factory defaults. This setting preserves the management port’s IP address in the management module’s memory, so you maintain connectivity to the management module after a reset.
The switch can do only one session of key/cipher generation at a time. Thus, a SSH/SCP client will not be able to login if the switch is doing key generation at that time or if another client has just logged in before this client. Similarly, the system will fail to do the key generation if a SSH/SCP client is logging in at that time.
SSH connection. The default setting for SSH access is disabled. To establish an SSH connection with the switch, run the SSH program on your workstation by issuing the SSH command, followed by the switch IP address: >>...
Access to switch functions is controlled through the use of unique surnames and passwords. Once you are connected to the switch via local Telnet, remote Telnet, or SSH, you are prompted to enter a password. The default user names/password for each access level are listed in the following table.
Page 27
BMD00007, November 2007 Description and Tasks Performed The superuser Administrator has complete access to all menus, information, and configuration commands on the GbE Switch Module, including the ability to change both the user and administrator passwords. Alteon OS Command Reference...
Setup Versus 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 the first-time configuration process.
47.” Idle Timeout By default, the switch will disconnect your Telnet session after five minutes of inactivity. This function is controlled by the idle timeout parameter, which can be set from 1 to 60 minutes. For information on changing this parameter, see “System Configuration”...
Page 30
Alteon OS Command Reference The Command Line Interface BMD00007, November 2007...
HAPTER First-Time Configuration To help with the initial process of configuring your switch, the Alteon 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.
Alteon OS Command Reference Using the Setup Utility Whenever you log in as the system administrator under the factory default configuration, you are asked whether you wish to run the Setup utility. Setup can also be activated manually from the command line interface any time after login. Information Needed For Setup Setup requests the following information: Basic system information...
– If the default admin login is unsuccessful, or if the administrator Main Menu appears instead, the system configuration has probably been changed from the factory default settings. If you are certain that you need to return the switch to its factory default settings, see ing a Configuration Block” on page Enter to begin the initial configuration of the switch, or n to bypass the Setup facility.
Alteon OS Command Reference Stopping and Restarting Setup Manually Stopping Setup To abort the Setup utility, press <Ctrl-C> 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. Restarting Setup You can restart the Setup utility manually at any time by entering the following command at the administrator prompt:...
Page 35
– When the GbE Switch Module is reset, the date and time to revert to default values. Use /cfg/sys/date and /cfg/sys/time to re-enter the current date and time. The system displays the date and time settings: System clock set to 18:55:36 Wed Jan 3, 2007.
Spanning Tree, or enter Setup Part 2: Port Configuration – When configuring port options for your switch, some of the prompts and options may be different. Select the port to configure, or skip port configuration at the prompt:...
Page 37
Configure Gigabit Ethernet port autonegotiation mode. If you selected a port that has a Gigabit Ethernet connector, the system prompts: Port Auto Negotiation: Current Port EXT1 autonegotiation: Enter new value ["on"/"off"]: Enter on to enable port autonegotiation, off to disable it, or press <Enter> to keep the current setting.
Alteon OS Command Reference Setup Part 3: VLANs If you chose to skip VLANs configuration back in Part 1, skip to tion” on page Select the VLAN to configure, or skip VLAN configuration at the prompt: VLAN Config: Enter VLAN number from 2 to 4094, NULL at end: If you wish to change settings for individual VLANs, enter the number of the VLAN you wish to configure.
IP interface provide the switch with an IP presence on your network. No two IP interfaces can be on the same IP subnet. The interfaces can be used for connecting to the switch for remote configuration, and for routing between subnets and VLANs (if used).
Alteon OS Command Reference To keep the current setting, press <Enter>. If configuring VLANs, specify a VLAN for the interface. This prompt appears if you selected to configure VLANs back in Part 1: Current VLAN: Enter new VLAN [1-4094]: Enter the number for the VLAN to which the interface belongs, or press <Enter> without spec- ifying a VLAN number to accept the current setting.
<Enter> without specifying any number. IP Routing When IP interfaces are configured for the various subnets attached to your switch, IP routing between them can be performed entirely within the switch. This eliminates the need to send inter-subnet communication to an external router device.
Optional Setup for Telnet Support – This step is optional. Perform this procedure only if you are planning on connecting to the GbE Switch Module through a remote Telnet connection. Telnet is enabled by default. To change the setting, use the following command: >>...
The default password for the administrator account is admin. To change the default password, follow this procedure: Connect to the switch and log in using the admin password. From the Main Menu, use the following command to access the Configuration Menu: Main# /cfg The Configuration Menu is displayed.
Page 44
Alteon OS Command Reference The System Menu is displayed. [System Menu] syslog sshd radius tacacs+ ldap ssnmp access date time timezone - Set system timezone (daylight savings) olddst dlight idle notice bannr hprompt reminder - Enable/disable Reminders From the System Menu, use the following command to select the System Access Menu: >>...
System# save Changing the Default User Password The user login has limited control of the switch. Through a user account, you can view switch information and statistics, but you can’t make configuration changes. The default password for the user account is user. This password can be changed from the user account.
Page 46
Alteon OS Command Reference From the Configuration Menu, use the following command to select the System Menu: >> Configuration# sys From the System Menu, use the following command to select the System Access Menu: >> System# access Select the user password. System# user/usrpw Enter the current administrator password at the prompt.
HAPTER Menu Basics The GbE Switch Module’s Command Line Interface (CLI) is used for viewing switch informa- tion 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.
Alteon OS Command Reference The Main Menu The Main Menu appears after a successful connection and login. The following table shows the Main Menu for the administrator login. Some features are not available under the user login. [Main Menu] info stats oper boot...
Operations Command Menu Operations-level commands are used for making immediate and temporary changes to switch configuration. This menu is used for bringing ports temporarily in and out of ser- vice, performing port mirroring, and enabling or disabling Server Load Balancing func- tions.
Alteon OS 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 con- figuration changes. For help on a specific command, type help. You will see the following screen: Global Commands: [can be issued from any menu] help lines...
Page 51
2 =Verbose: Everything is shown. When used without a value, the current setting is displayed. This command is used to telnet out of the switch. The format is as follows: telnet <hostname>|<IP address> [port] Where IP address is the hostname or IP address of the device.
Page 52
Alteon OS Command Reference Table 3-1 Description of Global Commands Command chpass_s Menu Basics Action Configures the password for the secondary TACACS+ server. BMD00007, November 2007...
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 3-2 Command Line History and Editing Options Option history <Ctrl-p>...
Alteon OS Command Reference Command Line Interface Shortcuts Command Stacking As a shortcut, you can type multiple commands on a single line, separated by forward slashes (/). You can connect as many commands as required to access the menu option that you want.
HAPTER The Information Menu You can view configuration information for the switch in both the user and administrator command This chapter discusses how to use the command line interface to display switch infor- modes. mation. BMD00007, November 2007...
Alteon OS Command Reference /info Information Menu [Information Menu] link port transcvr - Show Port Transceiver status dump The information provided by each menu option is briefly described in to detailed information. Table 4-1 Information Menu Options (/info) Command Syntax and Usage Displays the System Information Menu.
Page 57
Displays the status of the port transceiver module on each Fiber External Port. For details, see 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.
Displays most recent syslog messages. For details, see user Displays configured user names and their status. For details, see dump Dumps all switch information available from the Information Menu (10K or more, depending on your configuration). The Information Menu - SNMPv3 Information Menu...
/info/sys/snmpv3 SNMPv3 System Information Menu 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. [SNMPv3 Information Menu] view access...
Page 60
Alteon OS Command Reference Table 4-3 SNMPv3 information Menu Options (/info/sys/snmpv3) Command Syntax and Usage tparam Displays the Target parameters table information. To view a sample, see notify Displays the Notify table information. To view a sample, see dump Displays all the SNMPv3 information. To view a sample, see The Information Menu page page...
Description This is a string that represents the name of the user that you can use to access the switch. This indicates whether messages sent on behalf of this user are protected from disclosure using a privacy protocol. Alteon OS supports DES algorithm for privacy.
Alteon OS Command Reference /info/sys/snmpv3/view SNMPv3 View Table Information The user can control and restrict the access allowed to a group to only a subset of the manage- ment information in the management domain that the group can access within each context by specifying the group’s rights in terms of a particular MIB view for security reasons.
/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.
Alteon OS 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.
/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 ---------- --------------- ---- ---------- --------------- trap1 Table 4-9 SNMPv3 Target Address Table Information Parameters (/info/sys/ snmpv3/taddr) Field Name Transport Addr Port...
Alteon OS Command Reference /info/sys/snmpv3/tparam SNMPv3 Target Parameters Table Information Name --------------- -------- v1v2param Table 4-10 SNMPv3 Target Parameters Table Information (/info/sys/snmpv3/ tparam) Field Name MP Model User Name Sec Model Sec Level The Information Menu MP Model User Name -------------- snmpv2c v1v2only...
/info/sys/snmpv3/notify SNMPv3 Notify Table Information Name -------------------- -------------------- v1v2trap Table 4-11 SNMPv3 Notify Table Information (/info/sys/snmpv3/notify) Field Name BMD00007, November 2007 v1v2trap Description The locally arbitrary, but unique identifier associated with this snmpNotifyEntry. This represents a single tag value which is used to select entries in the snmpTargetAddrTable.
BladeCenter Chassis Information IBM BladeCenter Chassis Related Information: Switch Module Bay = 1 Chassis Type POST Results Management Module Control - Default Configuration Skip Extended Memory Test Disable External Ports POST Diagnostics Control Control Register Extended Control Register Management Module Status Reporting -...
– The display of temperature will come up only if the temperature of any of the sensors exceeds the temperature threshold. There will be a warning from the software if any of the sen- sors exceeds this temperature threshold. The switch will shut down if the power supply over- heats.
Page 71
Alteon OS Command Reference IP address of IP interface #1 Hardware version and part number Software image file and version number Configuration name Log-in banner, if one is configured BMD00007, November 2007 The Information Menu...
Alteon OS Command Reference /info/sys/log Show Recent Syslog Messages Date Time 17:25:41 17:25:41 17:25:41 17:25:41 17:25:41 17:25:41 17:25:41 17:25:41 17:25:41 17:25:41 17:25:41 17:25:41 17:25:41 17:25:41 17:25:42 17:25:42 17:25:42 17:25:42 17:25:42 17:25:42 17:25:42 Each syslog message has a criticality level associated with it, included in text form as a prefix to the log message.
/info/sys/user User Status Usernames: user oper admin Current User ID table: 1: name paul Current strong password settings: strong password status: disabled This command displays the status of the configured usernames. BMD00007, November 2007 - enabled - offline - disabled - offline - Always Enabled - online 1 session , dis, cos user , password valid, offline...
Alteon OS Command Reference /info/l2 Layer 2 Information [Layer 2 Menu] lacp gvrp 8021x cist trunk vlan dump The information provided by each menu option is briefly described in ers to where detailed information can be found. Table 4-12 Layer 2 Menu Options (/info/l2) Command Syntax and Usage Displays the Forwarding Database Information Menu.
Page 75
Table 4-12 Layer 2 Menu Options (/info/l2) Command Syntax and Usage In addition to seeing if STG is enabled or disabled, you can view the following STG bridge infor- mation: Priority Hello interval Maximum age value Forwarding delay Aging time You can also see the following port-specific STG information: Port alias and priority Cost...
Command Syntax and Usage dump Dumps all switch information available from the Layer 2 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.
00:11:f9:36:71:00 00:13:0a:4d:3c:00 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. If the state for the port is listed as unknown (UNK), the MAC address has not yet been learned by the switch, but has only been seen as a destination address.
Shows the value of the port’s operational key. The Information Menu - Show LACP aggregator information for the port - Show LACP port information - Show all LACP ports information GbE Switch Module. adminkey operkey selected page prio attached...
Use these commands to display Generic VLAN Registration Protocol (GVRP) status informa- tion for the GbE Switch Module. Table 4-15 GVRP Information Menu Options (/info/l2/gvrp) Command Syntax and Usage Displays general GVRP status information. Displays GVRP VLAN database information. For details, see Displays GARP Information Declaration (GID) information.
Fixed: The VLAN ignores GVRP registration information. Static VLANs have a fixed registration state. Forbidden: The VLAN does not participate in GVRP. – Management VLAN 4095 is not registered in GVRP. The switch declines any Join request received for VLAN 4095, and generates a syslog message. Static port members...
-------------|-------------|-------------| For each GVRP-registered VLAN, the GID State Machine table indicates the GVRP participa- tion of switch ports. It also displays the ports’ current Applicant and Registrar states. Table 4-16 lists the possible GVRP applicant states for the port. The GVRP port’s Applicant transitions from one state to another as it processes GPDUs.
Alteon OS Command Reference Table 4-17 lists the possible GVRP registrar states for the port. The registrar receives GVRP messages from other GVRP participants on the network. Registrar states are further defined as follows: Normal registration: The registrar responds normally to incoming GPDUs. Corresponding states are displayed as INn, LV, and MT.
Page 83
/info/l2/8021x 802.1x Information System capability : Authenticator System status Protocol version Port Auth Mode ----- ------------ INT1 force-auth *INT2 force-auth *INT3 force-auth *INT4 force-auth *INT5 force-auth *INT6 force-auth *INT7 force-auth *INT8 force-auth INT9 force-auth INT10 force-auth *INT11 force-auth *INT12 force-auth *INT13 force-auth *INT14 force-auth *MGT...
Page 84
Alteon OS Command Reference The following table describes the IEEE 802.1x parameters. Table 4-18 802.1x Parameter Descriptions (/info/l2/8021x) Parameter Port Auth Mode Auth Status Authenticator PAE State Backend Auth State The Information Menu Description Displays each port’s alias. Displays the Access Control authorization mode for the port. The Authoriza- tion mode can be one of the following: force-unauth auto...
/info/l2/stg Spanning Tree Information ------------------------------------------------------------------ upfast disabled, update 40 ------------------------------------------------------------------ Spanning Tree Group 1: On (STP/PVST+) Static VLANs: Dynamic VLANs: 30 Current Root: 8000 00:16:60:f9:1e:00 Parameters: Port Priority ---- -------- INT1 INT2 INT3 INT4 INT5 INT6 INT7 INT8 INT9 INT10 INT11 INT12 INT13...
Page 86
Alteon OS Command Reference The switch software uses the IEEE 802.1d Spanning Tree Protocol (STP). In addition to seeing if STG is enabled or disabled, you can view the following STG bridge information: Priority Hello interval Maximum age value Forwarding delay...
Page 87
Table 4-19 Spanning Tree Parameter Descriptions (Continued) Parameter Cost State Designated Bridge Designated Port BMD00007, November 2007 Description The port path cost parameter is used to help determine the designated port for a segment. Generally speaking, the faster the port, the lower the path cost. A setting of 0 indicates that the cost will be set to the appropriate default after the link speed has been auto negotiated.
Screen content varies based on the type of BladeCenter unit that you are using and the firmware versions and options that are installed. The switch software can be set to use the IEEE 802.1w Rapid Spanning Tree Protocol (RSTP) or the IEEE 802.1s Multiple Spanning Tree Protocol (MSTP).
Page 89
You can view port-specific RSTP information, including the following: Port number and priority Cost State The following table describes the STP parameters in RSTP or MSTP mode. Table 4-20 RSTP/MSTP Parameter Descriptions Parameter Current Root Priority (bridge) Hello MaxAge FwdDel Aging Prio (port) Cost...
Page 90
Alteon OS Command Reference Table 4-20 RSTP/MSTP Parameter Descriptions (Continued) Parameter Role Designated Bridge Designated Port Type The Information Menu Description The Role field shows the current role of this port in the Spanning Tree. The port role can be one of the following: Designated (DESG), Root (ROOT), Alternate (ALTN), Backup (BKUP), Disabled (DSB), Master (MAST), or Unknown (UNK).
/info/l2/cist Common Internal Spanning Tree Information Common Internal Spanning Tree: VLANs: 2-4094 Current Root: 8000 00:11:58:ae:39:00 Cist Regional Root: 8000 00:11:58:ae:39:00 Parameters: Port Prio ----- ---- --------- ----- INT1 INT2 INT3 INT4 INT5 INT6 INT7 INT8 INT9 INT10 INT11 INT12 INT13 INT14 EXT1...
Page 92
Alteon OS Command Reference You can view port-specific CIST information, including the following: Port number and priority Cost Link type and Port type The following table describes the CIST parameters. Table 4-21 CIST Parameter Descriptions Parameter CIST Root CIST Regional Root Priority (bridge) Hello MaxAge...
Table 4-21 CIST Parameter Descriptions Parameter Role Designated Bridge Designated Port Type /info/l2/trunk Trunk Group Information Trunk group 1, port state: EXT1: STG EXT2: STG When trunk groups are configured, you can view the state of each port in the various trunk groups.
Alteon OS Command Reference /info/l2/vlan VLAN Information VLAN ---- -------------------------------- Default VLAN VLAN 10 *VLAN 11 *VLAN 30 4095 Mgmt VLAN (*) = Dynamically created VLAN Private-VLAN ------------ --------- ---------- ---------- ----------------- 1000 1001 1002 1003 – The sample screens that appear in this document might differ slightly from the screens displayed by your system.
/info/l3 Layer 3 Information [Layer 3 Menu] route ospf igmp vrrp dump The information provided by each menu option is briefly described in ers to detailed information. Table 4-22 Layer 3 Menu Options (/info/l3) Command Syntax and Usage route Displays the IP Routing Menu. Using the options of this menu, the system displays the following for each configured or learned route: Route destination IP address, subnet mask, and gateway address Type of route...
Page 96
Displays the VRRP Information Menu. For details, see dump Dumps all switch information available from the Layer 3 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.
<interface number (1-128)> Displays routes on a single interface. dump Displays all routes configured in the switch. For more information, see BMD00007, November 2007 - Show a single route by destination IP address - Show routes to a single gateway...
Packets will be delivered to a destination host or subnet attached to the switch. Indicates a route to one of the switch’s IP interfaces. Indicates a broadcast route. The destination belongs to a host or subnet which is filtered out. Packets to this destination are discarded.
Page 99
BMD00007, November 2007 Description The address belongs to a host or subnet attached to the switch. The address is a static route which has been configured on the GbE Switch Module. The address belongs to one of the switch’s IP interfaces.
Alteon OS Command Reference /info/l3/arp ARP Information [Address Resolution Protocol Menu] find port vlan dump addr The ARP information includes IP address and MAC address of each entry, address status flags (see Table 4-26 on page information. Table 4-26 ARP Information Menu Options (/info/l3/arp) Command Syntax and Usage find <IP address (such as, 192.4.17.101>...
BMD00007, November 2007 Flags MAC address 00:e0:16:7c:28:86 00:03:42:fa:3b:30 00:c0:4f:60:3e:c1 00:03:42:fa:3b:30 Description Permanent entry created for switch IP interface. Indirect route entry. Unresolved ARP entry. The MAC address has not been learned. Alteon OS Command Reference VLAN Port INT6 INT6 The Information Menu...
Alteon OS Command Reference /info/l3/arp/addr ARP Address List Information IP address --------------- --------------- ----------------- ---- ----- 205.178.18.66 205.178.50.1 205.178.18.64 /info/l3/bgp BGP Information [BGP Menu] peer summary - Show all BGP peers in summary dump Table 4-28 BGP Peer Information Menu Options (/info/l3/bgp)) Command Syntax and Usage peer Displays BGP peer information.
/info/l3/bgp/peer BGP Peer information Following is an example of the information that /info/l3/bgp/peer provides. BGP Peer Information: 3: 2.1.1.1 Remote AS: 0, Local AS: 0, Link type: IBGP Remote router ID: 0.0.0.0, BGP status: idle, Old status: idle Total received packets: 0, Total sent packets: 0 Received updates: 0, Sent updates: 0 Keepalive: 0, Holdtime: 0, MinAdvTime: 60 LastErrorCode: unknown(0), LastErrorSubcode: unspecified(0)
Alteon OS Command Reference /info/l3/bgp/dump Show all BGP Information Following is an example of the information that /info/l3/bgp/dump provides. >> BGP# dump Status codes: * valid, > best, i - internal Origin codes: i - IGP, e - EGP, ? - incomplete Network --------------- --------------- *>...
/info/l3/ospf OSPF Information [OSPF Information Menu] general - Show general information aindex virtual - Show details of virtual links dbase sumaddr - Show summary address list nsumadd - Show NSSA summary address list routes dump Table 4-29 OSPF Information Menu options (/info/l3/ospf) Command Syntax and Usage general Displays general OSPF information.
Alteon OS Command Reference Table 4-29 OSPF Information Menu options (/info/l3/ospf) Command Syntax and Usage dump Displays the OSPF information. /info/l3/ospf/general OSPF General Information OSPF Version 2 Router ID: 10.10.10.1 Started at 1663 and the process uptime is 4626 Area Border Router: yes, AS Boundary Router: no LS types supported are 6 External LSA count 0 External LSA checksum sum 0x0...
/info/l3/ospf/if OSPF Interface Information Ip Address 10.10.12.1, Area 0.0.0.1, Admin Status UP Router ID 10.10.10.1, State DR, Priority 1 Designated Router (ID) 10.10.10.1, Ip Address 10.10.12.1 Backup Designated Router (ID) 10.10.14.1, Ip Address 10.10.12.2 Timer intervals, Hello 10, Dead 40, Wait 1663, Retransmit 5, Neighbor count is 1 /info/l3/ospf/dbase OSPF Database Information...
Page 108
Alteon OS Command Reference Table 4-30 OSPF Database Information Menu Options (/info/l3/ospf/dbase) Command Syntax and Usage dbsumm Displays the following information about the LS database in a table format: a) the number of LSAs of each type in each area. b) the total number of LSAs for each area.
Alteon OS Command Reference /info/l3/ospf/routes OSPF Information Route Codes 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...
Alteon OS Command Reference /info/l3/rip Routing Information Protocol Information [RIP Information Menu] routes dump Use this menu to view information about the Routing Information Protocol (RIP) configuration and statistics. Table 4-31 RIP Information Menu Options (/info/l3/rip) Command Syntax and Usage routes Displays RIP routes.
/info/l3/rip/dump <interface number> Show RIP User Configuration RIP USER CONFIGURATION : RIP on updat 30 RIP Interface 2 : 102.1.1.1, version 2, listen enabled, supply enabled, default none poison disabled, trigg enabled, mcast enabled, metric 1 auth none,key none RIP Interface 3 : 103.1.1.1, version 2, listen enabled, supply enabled, default none poison disabled, trigg enabled, mcast enabled, metric 1 BMD00007, November 2007...
Page 112
Alteon OS Command Reference /info/l3/ip IP Information IP information: AS number 0 Interface information: 1: 10.200.30.3 128: 10.90.90.97 Default gateway information: metric strict 1: 10.200.1.1, Current BOOTP relay settings: OFF 0.0.0.0, 0.0.0.0 Current IP forwarding settings: ON, dirbr disabled, noicmprd dis- abled Current network filter settings: none...
Table 4-32 describes the commands used to display information about IGMP groups learned by the switch. Table 4-32 IGMP Multicast Group Information Menu Options (/info/l3/igmp) Command Syntax and Usage mrouter Displays IGMP Multicast Router menu. To view menu options, see find <IP address>...
Table 4-33 IGMP Mrouter Information Menu Options (/info/igmp/mrouter) Command Syntax and Usage vlan <VLAN number> Displays the multicast router ports configured or learned on the selected VLAN. dump Displays information for all multicast groups learned by the switch. The Information Menu Group VLAN Port 232.1.1.1...
info/l3/igmp/mrouter/dump IGMP Mrouter Information VLAN Port ------- ------- EXT1 EXT3 EXT4 IGMP Mrouter information includes: VLAN and port where the Mrouter is connected IGMP version Mrouter expiration Maximum query response time Querier’s Robustness Variable (QRV) Querier’s Query Interval Code (QQIC) BMD00007, November 2007 Version Expires...
IP address, minimizing the number of unique IP addresses that must be configured. The Information Menu provides redun- GbE Switch Module 1, renter, prio 100, master, server 1, renter, prio 100, backup 1, renter, prio 100, master, proxy...
/info/qos Quality of Service Information [QoS Menu] 8021p Table 4-34 QoS Menu Options (/info/qos) Command Syntax and Usage 8021p Displays the 802.1p Information Menu. For details, see /info/qos/8021p 802.1p Information Current priority to COS queue information: Priority COSq -------- ---- Current port priority information: Port Priority...
Page 118
Alteon OS Command Reference The following table describes the IEEE 802.1p priority to COS queue information. Table 4-35 802.1p Priority-to-COS Queue Parameter Descriptions Parameter Priority COSq Weight The following table describes the IEEE 802.1p port priority information. Table 4-36 802.1p Port Priority Parameter Descriptions Parameter Port Priority...
info/acl Access Control List Information Current ACL information: ------------------------ Filter 2 profile: Ethernet - VID Meter - Set to disabled - Set committed rate : 64 - Set max burst size : 32 Re-Mark - Set use of TOS precedence to disabled Actions No ACL groups configured.
1000 full 1000 full 1000 full 1000 full 1000 full 1000 full 1000 full 1000 full 1000 full 1000 full 1000 full 1000 full 1000 full full 10000 10000 10000 1000 Link ------ down GbE Switch Module BMD00007, November 2007...
External Port. /info/dump Information Dump Use the dump command to dump all switch information available from the Information Menu (10K or more, depending on your configuration). This data is useful for tuning and debugging switch performance. If you want to capture dump data to a file, set your communication software on your worksta- tion to capture session data prior to issuing the dump commands.
HAPTER 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. /stats Statistics Menu [Statistics Menu] port clrports - Clear stats for all ports...
Page 124
Clears all management processor statistics. dump Dumps all switch statistics. Use this command to gather data for tuning and debugging switch per- formance. 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. For details, see...
/stats/port <port alias or number> Port Statistics This menu displays traffic statistics on a port-by-port basis. Traffic statistics include SNMP Management Information Base (MIB) objects. [Port Statistics Menu] 8021x ether link clear Table 5-2 Port Statistics Menu Options (/stats/port) Command Syntax and Usage 8021x Displays IEEE 802.1x statistics for the port.
Alteon OS Command Reference /stats/port <port alias or number>/8021x 802.1x Authenticator Statistics This menu option enables you to display the 802.1x authenticator statistics of the selected port. Authenticator Statistics: eapolFramesRx eapolFramesTx eapolStartFramesRx eapolLogoffFramesRx eapolRespIdFramesRx eapolRespFramesRx eapolReqIdFramesTx eapolReqFramesTx invalidEapolFramesRx eapLengthErrorFramesRx = 0 lastEapolFrameVersion lastEapolFrameSource Table 5-3 802.1x Authenticator Statistics of a Port (/stats/port/8021x)
/stats/port <port alias or number>/8021x 802.1x Authenticator Diagnostics This menu option enables you to display the 802.1x authenticator diagnostics of the selected port. Authenticator Diagnostics: authEntersConnecting authEapLogoffsWhileConnecting authEntersAuthenticating authSuccessesWhileAuthenticating authTimeoutsWhileAuthenticating authFailWhileAuthenticating authReauthsWhileAuthenticating authEapStartsWhileAuthenticating authEapLogoffWhileAuthenticating authReauthsWhileAuthenticated authEapStartsWhileAuthenticated authEapLogoffWhileAuthenticated backendResponses backendAccessChallenges backendOtherRequestsToSupplicant backendNonNakResponsesFromSupplicant = 460 backendAuthSuccesses backendAuthFails...
Alteon OS Command Reference Table 5-4 802.1x Authenticator Diagnostics of a Port (/stats/port/8021x) Statistics authTimeoutsWhile- Authenticating authFailWhileAu- thenticating authReauthsWhile- Authenticating authEapStartsWhi- leAuthenticating authEapLogoffWhi- leAuthenticating authReauthsWhile- Authenticated authEapStartsWhi- leAuthenticated authEapLogoffWhi- leAuthenticated backendResponses backendAccessChal- lenges backendOtherRe- questsToSupplicant backendNonNakRe- sponsesFromSuppli- cant The Statistics Menu Description Total number of times that the state machine transitions from AUTHENTICATING to ABORTING, as a result of the Backend Authen-...
Table 5-4 802.1x Authenticator Diagnostics of a Port (/stats/port/8021x) Statistics backendAuthSuc- cesses backendAuthFails /stats/port <port alias or number>/brg Bridging Statistics This menu option enables you to display the bridging statistics of the selected port. Bridging statistics for port INT1: dot1PortInFrames: dot1PortOutFrames: dot1PortInDiscards: dot1TpLearnedEntryDiscards:...
Page 130
Alteon OS Command Reference Table 5-5 Bridging Statistics of a Port (/stats/port/brg) Statistics dot1TpLearnedEntry Discards dot1StpPortForward Transitions The Statistics Menu Description The total number of Forwarding Database entries, which have been or would have been learnt, but have been discarded due to a lack of space to store them in the Forwarding Database.
/stats/port <port alias or number>/ether Ethernet Statistics This menu option enables you to display the ethernet statistics of the selected port Ethernet statistics for port INT1: dot3StatsAlignmentErrors: dot3StatsFCSErrors: dot3StatsSingleCollisionFrames: dot3StatsMultipleCollisionFrames: dot3StatsLateCollisions: dot3StatsExcessiveCollisions: dot3StatsInternalMacTransmitErrors: dot3StatsFrameTooLongs: dot3StatsInternalMacReceiveErrors: Table 5-6 Ethernet Statistics for Port (/stats/port/ether) Statistics dot3StatsAlignment Errors...
Page 132
Alteon OS Command Reference Table 5-6 Ethernet Statistics for Port (/stats/port/ether) Statistics dot3StatsMultiple- CollisionFrames dot3StatsLate- Collisions dot3StatsExcessive Collisions dot3StatsInternal- MacTransmitErrors dot3StatsFrameToo- Longs The Statistics Menu Description A count of successfully transmitted frames on a particular interface for which transmission is inhibited by more than one collision. A frame that is counted by an instance of this object is also counted by the corresponding instance of either the ifOutUcastPkts, ifOutMul- ticastPkts, or ifOutBroadcastPkts, and is not counted by the...
Page 133
Table 5-6 Ethernet Statistics for Port (/stats/port/ether) Statistics dot3StatsInternal- MacReceiveErrors BMD00007, November 2007 Description A count of frames for which reception on a particular interface fails due to an internal MAC sub layer receive error. A frame is only counted by an instance of this object if it is not counted by the corresponding instance of either the dot3StatsFrameTooLongs object, the dot3Stats- AlignmentErrors object, or the dot3StatsFCSErrors object.
Alteon OS Command Reference /stats/port <port alias or number>/if Interface Statistics This menu option enables you to display the interface statistics of the selected port. Interface statistics for port EXT1: Octets: UcastPkts: BroadcastPkts: MulticastPkts: Discards: Errors: Table 5-7 Interface Statistics for Port (/stats/port/if) Statistics ifInOctets ifInUcastPkts...
Page 135
Table 5-7 Interface Statistics for Port (/stats/port/if) Statistics ifInUnknownProtos ifOutOctets ifOutUcastPkts ifOutBroadcastPkts ifOutMulticastPkts ifOutDiscards ifOutErrors BMD00007, November 2007 Description For packet-oriented interfaces, the number of packets received via the interface which were discarded because of an unknown or unsupported protocol. For character-oriented or fixed-length interfaces which support protocol multiplexing, the number of transmission units received via the interface which were discarded because of an unknown or unsupported protocol.
The number of input datagrams discarded because the IP address in their IP header's destination field was not a valid address to be received at this entity (the switch). The number of input IP datagrams for which no problems were encoun- tered to prevent their continued processing, but which were discarded (for example, for lack of buffer space).
/stats/l2 Layer 2 Statistics [Layer 2 Statistics Menu] lacp gvrp The Layer 2 statistics provided by each menu option are briefly described in pointers to detailed information. Table 5-10 Layer 2 Statistics Menu Options (/stats/l2) Command Syntax and Usage fdb [clear] Displays FDB statistics.
Page 138
Alteon OS Command Reference Table 5-11 Forwarding Database Statistics (/stats/fdb) Statistic hiwat The Statistics Menu Description Highest number of entries recorded at any given time in the Forwarding Database. BMD00007, November 2007...
Alteon OS Command Reference /stats/l2/gvrp GVRP Statistics GARP/GVRP statistics ==================== Join Empty received: Join In received: Empty received: Leave In received: Leave Empty received: Leave All received: Join Empty transmitted: Join In transmitted: Empty transmitted: Leave In transmitted: Leave Empty transmitted: Leave All transmitted: Unaccepted Attribute Value: 0 Invalid Message/Attributes: 0...
Page 141
Table 5-13 GVRP Statistics (/stats/gvrp) Statistic Leave Empty trans- mitted Leave All transmit- Unaccepted Attribute Value Invalid Message/ Attributes Failure in regis- tration BMD00007, November 2007 Description The total number of Leave Empty messages sent. The total number of LeaveAll messages sent. The total number of GPDUs received that had an unacceptable attribute value.
Alteon OS Command Reference /stats/l3 Layer 3 Statistics [Layer 3 Statistics Menu] geal3 route icmp igmp ospf vrrp clrvrrp igmpgrps ipmcgrps clrigmp ipclear ripclear ospfclear - Clear all OSPF stats dump The Layer 3 statistics provided by each menu option are briefly described in pointers to detailed information.
Page 143
Displays Routing Information Protocol (RIP) statistics. See igmpgrps Displays the total number of IGMP groups that are registered on the switch. ipmcgrps Displays the total number of current IP multicast groups that are registered on the switch. clrigmp Clears IGMP statistics. ipclear Clears IP statistics.
Page 144
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.
The number of input datagrams for which this entity (the switch) was not their final IP destination, as a result of which an attempt was made to find a route to forward them to that final destination.
Page 146
(the switch). The number of IP datagrams that have been discarded because they needed to be fragmented at this entity (the switch) but could not be, for example, because their Don't Fragment flag was set. The number of IP datagram fragments that have been generated as a result of fragmentation at this entity (the switch).
Description The total number of ICMP messages which the entity (the switch) received. Note that this counter includes all those counted by icmpInErrors. The number of ICMP messages which the entity (the switch) received but determined as having ICMP-specific errors (bad ICMP checksums, bad length, and so forth).
Page 149
Note that this counter includes all those counted by icmpOutErrors. The number of ICMP messages which this entity (the switch) did not send due to problems discovered within ICMP such as a lack of buffer. This value should not include errors discovered outside the ICMP layer such as the inability of IP to route the resultant data- gram.
Page 150
Alteon OS Command Reference Table 5-19 ICMP Statistics (/stats/l3/icmp) Statistics icmpOutTimestamps icmpOutTimestampReps icmpOutAddrMasks icmpOutAddrMaskReps The Statistics Menu Description The number of ICMP Timestamp (request) messages sent. The number of ICMP Timestamp Reply messages sent. The number of ICMP Address Mask Request messages sent. The number of ICMP Address Mask Reply messages sent.
UBOUND quantity described in RFC 793. The limit on the total number of TCP connections the entity (the switch) can support. In entities where the maximum number of connections is dynamic, this object should contain the value -1.
Page 152
Alteon OS Command Reference Table 5-20 TCP Statistics (/stats/l3/tcp) Statistics tcpEstabResets tcpInSegs tcpOutSegs tcpRetransSegs tcpInErrs tcpCurBuff tcpCurConn tcpOutRsts The Statistics Menu Description The number of times TCP connections have made a direct transition to the CLOSED state from either the ESTABLISHED state or the CLOSE- WAIT state.
Description The total number of UDP datagrams delivered to the switch. The total number of UDP datagrams sent from this entity (the switch). The number of received UDP datagrams that could not be delivered for reasons other than the lack of an application at the destination port.
Alteon OS Command Reference /stats/l3/igmp <VLAN number> IGMP Statistics IGMP Snoop vlan 2 statistics: ----------------------------------------------------------------------- rxIgmpValidPkts: rxIgmpGenQueries: rxIgmpGroupSrcSpecificQueries: rxIgmpLeaves: txIgmpReports: txIgmpLeaves: rxIgmpV3SourceListChangeRecords:0 This menu option displays statistics about the use of the IGMP Multicast Groups. IGMP statistics are described in the following table: Table 5-22 IGMP Statistics (/stats/l3/igmp) Statistic rxIgmpValidPkts...
/stats/l3/ospf OSPF Statistics [OSPF stats Menu] general - Show global stats aindex Table 5-23 OSPF Statistics Menu (/stats/l3/ospf) Command Syntax and Usage general Displays global statistics. See aindex Displays area statistics. Displays interface statistics. BMD00007, November 2007 - Show area(s) stats - Show interface(s) stats page 158 for sample output.
Alteon OS Command Reference /stats/l3/ospf/general OSPF Global Statistics The OSPF General Statistics contain the sum total of all OSPF packets received on all OSPF areas and interfaces. OSPF stats ---------- Rx/Tx Stats: Pkts hello database ls requests ls acks ls updates Nbr change stats: hello start...
Page 157
Table 5-24 OSPF General Statistics (stats/l3/ospf/general) Statistics Rx/Tx Stats: Rx Pkts Tx Pkts Rx Hello Tx Hello Rx Database Tx Database Rx ls Requests Tx ls Requests Rx ls Acks Tx ls Acks Rx ls Updates Tx ls Updates BMD00007, November 2007 Description The sum total of all OSPF packets received on all OSPF areas and inter- faces.
Page 158
Alteon OS Command Reference Table 5-24 OSPF General Statistics (stats/l3/ospf/general) (Continued) Statistics Nbr Change Stats: hello Start n2way adjoint ok negotiation done exchange done bad requests bad sequence loading done n1way rst_ad down The Statistics Menu Description The sum total of all Hello packets received from neighbors on all OSPF areas and interfaces.
Page 159
Table 5-24 OSPF General Statistics (stats/l3/ospf/general) (Continued) Statistics Intf Change Stats: hello down loop unloop wait timer backup nbr change Timers Kickoff: hello retransmit lsa lock lsa ack dbage summary ase export BMD00007, November 2007 Description The sum total number of Hello packets sent on all interfaces and areas. The sum total number of interfaces down in all OSPF areas.
The total number of VRRP advertisements received that had a bad virtual router ID. The total number of VRRP advertisements received that had a bad address. The total number of VRRP advertisements received that had bad data. provides GbE Switch Module BMD00007, November 2007...
/stats/l3/rip Routing Information Protocol Statistics RIP ALL STATS INFORMATION: RIP packets received RIP packets sent RIP request received RIP response recevied = 12 RIP request sent RIP reponse sent RIP route timeout RIP bad size packet received = 0 RIP bad version received RIP bad zeros received RIP bad src port received RIP bad src IP received...
Alteon OS Command Reference /stats/mp Management Processor Statistics [MP-specific Statistics Menu] Table 5-26 Management Processor Statistics Menu Options (/stats/mp) Command Syntax and Usage Displays packet statistics, to check for leads and load. To view a sample output and a description of the stats, see Displays all TCP control blocks that are in use.
/stats/mp/pkt MP Packet Statistics Packet counts: allocs: mediums: jumbos: smalls: failures: Table 5-27 Packet Statistics (/stats/mp/pkt) Statistics allocs frees mediums mediums hi-water- mark jumbos jumbos hi-watermark The highest number of packet allocation with more than 1536 bytes from smalls smalls hi-watermark The highest number of packet allocation with size less than 128 bytes failures BMD00007, November 2007 1722684...
/stats/mp/ucb UCB Statistics All UDP allocated control blocks: 161: listen /stats/mp/cpu CPU Statistics This menu option enables you to display the CPU utilization statistics. CPU utilization: cpuUtil1Second: cpuUtil4Seconds: cpuUtil64Seconds: Table 5-29 CPU Statistics (stats/mp/cpu) Statistics cpuUtil1Second cpuUtil4Seconds cpuUtil64Seconds BMD00007, November 2007 Description The utilization of MP CPU over 1 second.
Alteon OS Command Reference /stats/acl ACL Statistics [ACL Menu] dump clracl ACL statistics are described in the following table. Table 5-30 ACL Statistics Menu Options (/stats/acl) Command Syntax and Usage acl <1-896> Displays the Access Control List Statistics for a specific ACL. For details, see dump Displays all ACL statistics.
SNMP protocol entity and were for an unsupported SNMP version. The total number of SNMP Messages delivered to the SNMP entity which used an SNMP community name not known to the said entity (the switch). The total number of SNMP Messages delivered to the SNMP protocol entity which represented an SNMP operation which was not allowed by the SNMP community named in the Message.
Page 168
ASN.1 type as a string of eight-bit octets. An object to enable or disable the authentication traps generated by this entity (the switch). The total number of SNMP Messages which were passed from the SNMP protocol entity to the transport service.
Page 169
Table 5-31 SNMP Statistics (/stats/snmp) Statistics snmpInTotalSetVars snmpInGetRequests snmpInGetNexts snmpInSetRequests snmpInGetResponses snmpInTraps snmpOutTooBigs snmpOutNoSuchNames snmpOutBadValues snmpOutReadOnlys snmpOutGenErrs snmpOutGetRequests snmpOutGetNexts snmpOutSetRequests snmpOutGet Responses BMD00007, November 2007 Description 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).
Page 170
Alteon OS Command Reference Table 5-31 SNMP Statistics (/stats/snmp) Statistics snmpOutTraps snmpSilentDrops snmpProxyDrops The Statistics Menu Description The total number of SNMP Trap Protocol Data Units (PDUs), which have been generated by the SNMP protocol entity. The total number of GetRequest-PDUs, GetNextRequest-PDUs, GetBulkRequest-PDUs, SetRequest-PDUs, and InformRe- quest-PDUs delivered to the SNMPv2 entity which were silently dropped because the size of a reply containing an alternate Response-...
Alteon 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 accu- rate syslogs.
The Statistics Menu Description Last update of time on the switch based on either primary or secondary NTP response received. The time stamp showing the time when the switch was last updated.
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.
Displays the Quality of Service Configuration Menu. To view menu options, see Displays the ACL Configuration Menu. To view menu options, see setup Step-by-step configuration set-up of the switch. For details, see The Configuration Menu - System-wide Parameter Menu - Port Menu...
Displays current configuration parameters. 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.
If you do not want the previous configuration block copied to the backup configuration block, enter the following instead: # save n You can decide which configuration you want to run the next time you reset the switch. Your options include: The active configuration block...
- Enable/disable Reminders This menu provides configuration of switch management parameters such as user and adminis- trator privilege mode passwords, Web-based management settings, and management access lists. Table 6-2 System Configuration Menu Options (/cfg/sys) Command Syntax and Usage syslog Displays the Syslog Menu.
Page 178
Displays the System Access Menu. To view menu options, see date Prompts the user for the system date. The date reverts to its default value when the switch is reset. time Configures the system time using a 24-hour clock format. The time reverts to its default value when the switch is reset.
Page 179
Table 6-2 System Configuration Menu Options (/cfg/sys) Command Syntax and Usage reminder disable|enable Enables or disables reminder messages in the CLI. The default value is enabled. Displays the current system parameters. BMD00007, November 2007 Alteon OS Command Reference The Configuration Menu...
Enables or disables delivering syslog messages to the console. When necessary, disabling con- sole ensures the switch is not affected by syslog messages. It is enabled by default. log <feature|all> <enable|disable> Displays a list of features for which syslog messages can be generated. You can choose to enable/ disable specific features (such as vlans, stg, or servers), or enable/disable syslog on all available features.
For the GbE Switch Module scripts can be viewed by using the /cfg/dump command (see Table 6-4 System Configuration Menu Options (/cfg/sys/sshd) Command Syntax and Usage intrval <0 - 24> Set the interval for auto-generation of the RSA server key.
Page 182
Alteon OS Command Reference Table 6-4 System Configuration Menu Options (/cfg/sys/sshd) Command Syntax and Usage Disables the SSH server. Displays the current SSH server configuration. The Configuration Menu BMD00007, November 2007...
This is the shared secret between the switch and the RADIUS server(s). secret2 <1-32 character secret> This is the secondary shared secret between the switch and the RADIUS server(s). port <RADIUS port configure, default 1645> Enter the number of the UDP port to be configured, between 1500 - 3000. The default is 1645.
Page 184
Alteon OS Command Reference Table 6-5 System Configuration Menu Options (/cfg/sys/radius) Command Syntax and Usage Disables the RADIUS server. Displays the current RADIUS server parameters. The Configuration Menu BMD00007, November 2007...
/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.
Page 186
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.
Page 187
Table 6-6 TACACS+ Server Menu Options (/cfg/sys/tacacs) Command Syntax and Usage passch enable|disable Enables or disables TACACS+ password change. The default value is disabled. chpass_p Configures the password for the primary TACACS+ server. The CLI will prompt you for input. chpass_s Configures the password for the secondary TACACS+ server.
Alteon OS 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 deter- mine whether access can be allowed to a given system. [LDAP Server Menu] prisrv secsrv...
Page 189
Table 6-7 LDAP Server Menu Options (/cfg/sys/ldap) Command Syntax and Usage telnet disable|enable Enables or disables the LDAP back door for telnet. The telnet command also applies to SSH/SCP connections, and the Browser-Based Interface (BBI). The default is disabled. To obtain the LDAP backdoor password for your GbESM, contact your IBM Service and Support line.
- Set NTP server resync interval This menu enables you to synchronize the switch clock to a Network Time Protocol (NTP) server. By default, this option is disabled. Table 6-8 NTP Configuration Menu Options (/cfg/sys/ntp) Command Syntax and Usage prisrv <NTP Server IP address>...
(client/manager) accesses a set of variables known as MIBs (Man- agement Information Base) provided by the managed device (agent). If you are running an SNMP network management station on your network, you can manage the switch using the following standard SNMP MIBs:...
Page 192
<new SNMP read community string, maximum 32 characters> Configures the SNMP read community string. The read community string controls SNMP “get” access to the switch. It can have a maximum of 32 characters. The default read community string is public.
/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. [SNMPv3 Menu] view access...
Page 194
Alteon OS Command Reference Table 6-10 SNMPv3 Configuration Menu Options (/cfg/sys/ssnmp/snmpv3) comm <snmpCommunity number [1-16]> The community table contains objects for mapping community strings and version-independent SNMP message parameters. To view menu options, see taddr <snmpTargetAddr number [1-16]> This command allows you to configure destination information, consisting of a transport domain and a transport address.
<32 character name> This command allows you to configure a string up to 32 characters long that represents the name of the user. This is the login name that you need in order to access the switch. auth md5|sha|none This command allows you to configure the authentication protocol between HMAC-MD5-96 or HMAC-SHA-96.
Alteon OS Command Reference Table 6-11 User Security Model Configuration Menu Options (/cfg/sys/ssnmp/ snmpv3/usm) Command Syntax and Usage Deletes the USM user entries. Displays the USM user entries. cfg/sys/ssnmp/snmpv3/view SNMPv3 View Configuration [SNMPv3 vacmViewTreeFamily 1 name tree mask type Table 6-12 SNMPv3 View Menu Options (/cfg/sys/ssnmp/snmpv3/view) Command Syntax and Usage name <32 character name>...
/cfg/sys/ssnmp/snmpv3/access 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. [SNMPv3 vacmAccess 1 name prefix...
Page 198
Alteon OS Command Reference Table 6-13 View-based Access Control Model Menu Options (/cfg/sys/ssnmp/ snmpv3/access) Command Syntax and Usage rview <32 character view name> This is a 32 character long read view name that allows you read access to a particular MIB view. If the value is empty or if there is no active MIB view having this value then no access is granted.
/cfg/sys/ssnmp/snmpv3/group SNMPv3 Group Configuration [SNMPv3 vacmSecurityToGroup 1 model uname gname Table 6-14 SNMPv3 Group Menu Options (/cfg/sys/ssnmp/snmpv3/group) Command Syntax and Usage model usm|snmpv1|snmpv2 Defines the security model. uname <32 character name> Sets the user name as defined in /cfg/sys/ssnmp/snmpv3/usm/name on gname <32 character name>...
Alteon OS 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 commu- nity strings in the Local Configuration Datastore (LCD) of SNMP engine.
/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.
Alteon OS 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 param- eters include the message processing model (for example: SNMPv3, SNMPv2c, SNMPv1), the security model (for example: USM), the security name, and the security level (noAuthno- Priv, authNoPriv, or authPriv).
/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 con- ditions. [SNMPv3 snmpNotifyTable 1 name Table 6-18 Notify Table Menu Options (/cfg/sys/ssnmp/snmpv3/notify) Command Syntax and Usage name <32 character name>...
Displays the HTTPS Menu. To view menu options, see wport <TCP port number (1-65535)> Sets the switch port used for serving switch Web content. The default is HTTP port 80. If Global Server Load Balancing is to be used, set this to a different port (such as 8080).
Page 205
Sets an optional telnet server port number for cases where the server listens for telnet sessions on a non-standard port. tport <TFTP port number (1-65535)> Sets the TFTP port for the switch. The default is port 69. Displays the current system access parameters. BMD00007, November 2007...
Alteon OS Command Reference /cfg/sys/access/mgmt Management Networks Configuration [Management Networks Menu] This menu is used to define IP address ranges which are allowed to access the switch for man- agement purposes. Table 6-20 Management Network Menu Options (/cfg/sys/access/mgmt) Command Syntax and Usage add <mgmt network address>...
Ejects the specified user from the GbESM. usrpw Sets the user (user) password. The user has no direct responsibility for switch management. He or she can view switch status information and statistics, but cannot make any configuration changes. The user password can have a maximum of 15 characters.
Alteon OS Command Reference /cfg/sys/access/user/uid <1-10> System User ID Configuration [User ID 1 name pswd Table 6-22 User ID Configuration Menu Options (/cfg/sys/access/user/uid) Command Syntax and Usage cos <user|oper|admin> Sets the Class-of-Service to define the user’s authority level. Alteon OS defines these levels as: User, Operator, and Administrator, with User being the most restricted level.
/cfg/sys/access/user/strongpw Strong Password Configuration [Strong Pwd Menu] expiry warning faillog Table 6-23 Strong Password Menu Options (/cfg/sys/access/user/strongpw) Command Syntax and Usage Enables Strong Password requirement. Disables Strong Password requirement. expiry <1-365> Configures the number of days allowed before the password must be changed. warning <1-365>...
Email (for example, email address) []: info@bladenetwork.net You will be asked to confirm if you want to generate the certificate. It will take approximately 30 seconds to generate the certificate. Then the switch will restart SSL agent. certSave Allows the client, or the Web browser, to accept the certificate and save the certificate to Flash to be used when the switch is rebooted.
- Enable/disable Port flood blocking Use the Port Configuration menu to configure settings for individual switch ports, except the management port (MGT). This command is enabled by default. Table 6-25 Port Configuration Menu (/cfg/port) Command Syntax and Usage If a port is configured to support Gigabit Ethernet, this option displays the Gigabit Ethernet Physi- cal Link Menu.
Page 212
Alteon OS Command Reference Table 6-25 Port Configuration Menu (/cfg/port) Command Syntax and Usage learn disable|enable Enables or disables FDB learning on the port. tag disable|enable Disables or enables VLAN tagging for this port. It is disabled by default. tagpvid disable|enable Disables or enables VLAN tag persistence.
– The speed and mode parameters are fixed for Gigabit Ethernet ports, and cannot be configured. Link menu options are described in for the GbE Switch Module and negotiation mode for the port link. Table 6-26 Port Link Configuration Menu Options (/cfg/port/gig) Command Syntax and Usage speed 10|100|1000|any Sets the link speed.
Displays current ACL QoS parameters. The Configuration Menu for other operations-level commands. - Add ACL or ACL group to this port - Remove ACL or ACL group from this port - Display current ACLs for this port GbE Switch Module BMD00007, November 2007...
Page 216
(/cfg/port x/fastfwd ena). macnotif enable|disable Enables or disables MAC Address Notification. With MAC Address Notification enabled, the switch generates a syslog message when a MAC address is added or removed from the MAC address table. upfast enable|disable Enables or disables Fast Uplink Convergence, which provides rapid Spanning Tree convergence to an upstream switch during failover.
/cfg/l2/8021x 802.1x Configuration [802.1x Configuration Menu] global port This feature allows you to configure the GbESM as an IEEE 802.1x Authenticator, to provide port-based network access control. Table 6-29 802.1x Configuration Menu (/cfg/l2/8021x) Command Syntax and Usage global Displays the global 802.1x Configuration Menu. To view menu options, see port <port alias or number>...
Alteon OS Command Reference /cfg/l2/8021x/global 802.1x Global Configuration [802.1x Global Configuration Menu] gvlan mode qtperiod - Set EAP-Request/Identity quiet time interval txperiod - Set EAP-Request/Identity retransmission timeout suptmout - Set EAP-Request retransmission timeout svrtmout - Set server authentication request timeout maxreq raperiod - Set reauthentication time interval reauth...
Page 219
Table 6-30 802.1x Global Configuration Menu Options (/cfg/l2/8021x/global) Command Syntax and Usage svrtmout <1-65535> Sets the time, in seconds, the authenticator waits for a response from the RADIUS server before declaring an authentication timeout. The default value is 30 seconds. The time interval between transmissions of the RADIUS Access-Request packet containing the supplicant’s (client’s) EAP-Response packet is determined by the current setting of /cfg/sys/radius/timeout (default is 3 seconds).
[802.1x Guest VLAN Configuration Menu] vlan The 802.1x Guest VLAN menu allows you to configure a Guest VLAN for unauthenticated ports. The Guest VLAN provides limited access to switch functions. Table 6-31 802.1x Guest VLAN Configuration Menu (/cfg/l2/8021x/global/gvlan) Command Syntax and Usage vlan <1-4094>...
/cfg/l2/8021x/port <alias or number> 802.1x Port Configuration [802.1x Port Configuration Menu] mode qtperiod - Set EAP-Request/Identity quiet time interval txperiod - Set EAP-Request/Identity retransmission timeout suptmout - Set EAP-Request retransmission timeout svrtmout - Set server authentication request timeout maxreq raperiod - Set reauthentication time interval reauth default global...
Page 222
Alteon OS Command Reference Table 6-32 802.1x Port Configuration Menu Options (/cfg/l2/8021x/port) Command Syntax and Usage svrtmout <1-65535> Sets the time, in seconds, the authenticator waits for a response from the RADIUS server before declaring an authentication timeout. The default value is 30 seconds. The time interval between transmissions of the RADIUS Access-Request packet containing the supplicant’s (client’s) EAP-Response packet is determined by the current setting of /cfg/sys/radius/timeout (default is 3 seconds).
/cfg/l2/mrst Rapid Spanning Tree Protocol/ Multiple Spanning Tree Protocol Configuration [Multiple Spanning Tree Menu] cist name maxhop mode Alteon OS supports the IEEE 802.1w Rapid Spanning Tree Protocol (RSTP) and IEEE 802.1s Multiple Spanning Tree Protocol (MSTP). MSTP allows you to map many VLANs to a small number of spanning tree groups, each with its own topology.
Page 224
Alteon OS Command Reference Table 6-33 MSTP/RSTP Configuration Menu Options (/cfg/l2/mrst) Command Syntax and Usage mode rstp|mstp Selects either Rapid Spanning Tree mode (rstp) or Multiple Spanning Tree mode (mstp). The default mode is RSTP. Globally turns RSTP/MSTP ON. Note: When RSTP is turned on, the configuration parameters for STG 1 apply to RSTP. Globally turns RSTP/MSTP OFF.
/cfg/l2/mrst/cist Common Internal Spanning Tree Configuration [Common Internal Spanning Tree Menu] - CIST Bridge parameter menu port - CIST Port parameter menu - Add VLAN(s) to CIST default - Default Common Internal Spanning Tree and Member parameters - Display current CIST parameters Table 6-34 describes the commands used to configure Common Internal Spanning Tree (CIST) parameters.
Configures the CIST bridge priority. The bridge priority parameter controls which bridge on the network is the MSTP root bridge. To make this switch the root bridge, configure the bridge priority lower than all other switches and bridges on your network. The lower the value, the higher the bridge priority.
/cfg/l2/mrst/cist/port <port alias or number> CIST Port Configuration [CIST Port 1 Menu] prior cost hello link edge CIST port parameters are used to modify MRST operation on an individual port basis. CIST parameters do not affect operation of STP/PVST+. For each port, RSTP/MSTP is turned on by default.
Page 228
Alteon OS Command Reference Table 6-36 CIST Port Configuration Menu Options (/cfg/l2/mrst/cist/port) Command Syntax and Usage edge disable|enable 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). This command is disabled by default.
Alteon OS supports the IEEE 802.1d Spanning Tree Protocol (STP). STP is used to prevent loops in the network topology. Up to 128 Spanning Tree Groups can be configured on the switch (STG 128 is reserved for management). – When VRRP is used for active/active redundancy, STG must be enabled.
Page 230
Alteon OS Command Reference Table 6-37 Spanning Tree Configuration Menu (/cfg/l2/stg) Command Syntax and Usage default Restores a spanning tree instance to its default configuration. Displays current Spanning Tree Protocol parameters. The Configuration Menu BMD00007, November 2007...
Configures the bridge priority. The bridge priority parameter controls which bridge on the network is the STG root bridge. To make this switch the root bridge, configure the bridge priority lower than all other switches and bridges on your network. The lower the value, the higher the bridge pri- ority.
Page 232
Alteon OS Command Reference Table 6-38 Spanning Tree Bridge Menu Options (/cfg/l2/stg/brg) Command Syntax and Usage fwd <new bridge Forward Delay (4-30 secs)> 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.
/cfg/l2/stg <STP Group number>/port <port alias or number> Spanning Tree Port Configuration [Spanning Tree Port EXT1 Menu] prior cost link edge By default for STP/PVST+, Spanning Tree is turned Off for internal ports and management ports, and turned On for external ports. By default for RSTP/MSTP, Spanning Tree is turned Off for internal ports and management ports, and turned On for external ports, with internal ports configured as Edge ports.
Page 234
Alteon OS Command Reference Table 6-39 Spanning Tree Port Menu Options (/cfg/l2/stg/port) Command Syntax and Usage edge disable|enable 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). Enables STG on the port.
/cfg/l2/fdb Forwarding Database Configuration [FDB Menu] static Use the following commands to configure the Forwarding Database (FDB) for the GbESM. Table 6-40 FDB Menu Options (/cfg/l2/fdb) Command Syntax and Usage static Displays the static FDB menu. To view menu options, see /cfg/l2/fdb/static Static FDB Configuration [Static FDB Menu]...
The default value is 200. ltime <100-65535> Configures the GARP Leave time value, in milliseconds. The Leave time is the interval the switch waits before removing the port from a VLAN on which it received the Leave message. The default value is 600.
Table 6-42 GVRP Menu Options (/cfg/l2/gvrp) Command Syntax and Usage Globally turns GVRP off. With GVRP off, the switch does not process GPDUs. When you turn GVRP off, existing dynamic VLANs are deleted. Display current GVRP configuration. /cfg/l2/gvrp/port GVRP Port Configuration...
Up to 11 trunk groups can be configured on the , with the following restrictions: Any physical switch port can belong to no more than one trunk group. Up to four ports/trunks can belong to the same trunk group.
[set IP Trunk Hash Settings Menu] smac dmac Trunk hash parameters are set globally for the GbE Switch Module. You can enable one or two parameters, to configure any of the following valid combinations: SMAC (source MAC only) DMAC (destination MAC only)
Page 240
Alteon OS Command Reference Use the following commands to configure IP trunk hash parameters for the GbESM. Table 6-46 IP Trunk Hash Menu Options (/cfg/l2/thash/set) Command Syntax and Usage smac enable|disable Enable or disable trunk hashing on the source MAC. dmac enable|disable Enable or disable trunk hashing on the destination MAC.
/cfg/l2/lacp LACP Configuration [LACP Menu] sysprio timeout port Use the following commands to configure Link Aggregation Control Protocol (LACP) for the GbESM. Table 6-47 LACP Menu Options (/cfg/l2/lacp) Command Syntax and Usage sysprio <1-65535> Defines the priority value (1 through 65535) for the GbESM. Lower numbers provide higher prior- ity.
Alteon OS Command Reference /cfg/l2/lacp/port <port alias or number> LACP Port Configuration [LACP Port EXT1 Menu] mode prio adminkey - Set LACP port admin key Use the following commands to configure Link Aggregation Control Protocol (LACP) for the selected port. Table 6-48 LACP Port Menu Options (/cfg/l2/lacp/port) Command Syntax and Usage mode off|active|passive...
Displays the Failover Trigger menu. To view menu options, see vlan on|off Globally turns VLAN monitor on or off. When the VLAN Monitor is on, the switch automati- cally disables only internal ports that belong to the same VLAN as ports in the failover trigger. The default value is off.
Displays the Auto Monitor menu for the selected trigger. To view menu options, see limit <0-2> Configures the the trigger initiates a failover event. If you enter a value of zero (0), the switch triggers a failover event only when no links in the trigger are operational. Enables the selected trigger.
/cfg/l2/failovr/trigger/amon Auto Monitor Configuration [Auto Monitor Menu] addtrnk remtrnk addkey remkey Table 6-51 Auto Monitor Menu Options (/cfg/l2/failovr/trigger/amon) Command Syntax and Usage addtrnk <Trunk Group number (1-11)> Adds a trunk group to the Auto Monitor. remtrnk <Trunk Group number (1-11)> Removes a trunk group from the Auto Monitor.
Alteon OS Command Reference /cfg/l2/vlan <VLAN number> VLAN Configuration [VLAN 1 Menu] pvlan privlan name The commands in this menu configure VLAN attributes, change the status of each VLAN, change the port membership of each VLAN, and delete VLANs. For more information on con- figuring VLANs, see By default, the VLAN menu option is disabled except VLAN 1, which is enabled all the time.
Page 247
Table 6-52 VLAN Configuration Menu Options (/cfg/l2/vlan) Command Syntax and Usage def <list of port numbers> Defines which ports are members of this VLAN. Every port must be a member of at least one VLAN. By default, internal server ports (INTx) and external ports (EXTx) are in VLAN 1. Enables this VLAN.
Alteon OS Command Reference /cfg/l2/vlan/pvlan <protocol number> Protocol-based VLAN Configuration [VLAN 1 Protocol 1 Menu] prio ports tagpvl taglist Use this menu to configure Protocol-based VLAN (PVLAN) for the selected VLAN. Table 6-53 PVLAN Menu Options (/cfg/l2/vlan/pvlan) Command Syntax and Usage pty <(Ether2|SNAP|LLC)>...
Page 249
Table 6-53 PVLAN Menu Options (/cfg/l2/vlan/pvlan) Command Syntax and Usage Enables the selected protocol on the VLAN. Disables the selected protocol on the VLAN. Deletes the selected protocol configuration from the VLAN. Displays current parameters for the selected PVLAN. BMD00007, November 2007 Alteon OS Command Reference The Configuration Menu...
Alteon OS Command Reference /cfg/l2/vlan/privlan Private VLAN Configuration [privlan Menu] type Use this menu to configure a Private VLAN. Table 6-54 Private VLAN Menu Options (/cfg/l2/vlan/privlan) Command Syntax and Usage type primary|isolated|community Defines the VLAN type, as follows: Primary: A Private VLAN must have only one primary VLAN. The primary VLAN carries unidirectional traffic to ports on the isolated VLAN or to community VLAN.
/cfg/l3 Layer 3 Configuration [Layer 3 Menu] route mroute frwd rmap ospf igmp bootp vrrp rtrid Table 6-55 Layer 3 Configuration Menu (/cfg/l3) Command Syntax and Usage if <interface number (1-128)> Displays the IP Interface Menu. To view menu options, see gw <default gateway number (1-4)>...
Page 252
Alteon OS Command Reference Table 6-55 Layer 3 Configuration Menu (/cfg/l3) Command Syntax and Usage rmap <route map number (1-32)> Displays the Route Map Menu. To view menu options see Displays the Routing Interface Protocol Menu. To view menu options, see ospf Displays the OSPF Menu.
– To maintain connectivity between the management module and the GbE Switch Mod- ule, use the management module interface to change the IP address of the switch. Table 6-56 IP Interface Menu Options (/cfg/l3/if) Command Syntax and Usage addr <IP address (such as 192.4.17.101)>...
Configures the IP address of the default IP gateway using dotted decimal notation. intr <0-60 seconds> The switch pings the default gateway to verify that it’s up. The intr option sets the time between health checks. The range is from 0 to 60 seconds. The default is 2 seconds.
Page 255
Table 6-57 Default Gateway Menu Options (/cfg/l3/gw) Command Syntax and Usage Enables the gateway for use. Disables the gateway. Deletes the gateway from the configuration. Displays the current gateway settings. BMD00007, November 2007 Alteon OS Command Reference The Configuration Menu...
Alteon OS Command Reference /cfg/l3/route IP Static Route Configuration [IP Static Route Menu] Up to 128 static routes can be configured. Table 6-58 IP Static Route Configuration Menu Options (cfg/l3/route) Command Syntax and Usage add <destination> <mask> <gateway> <interface number> Adds a static route.
/cfg/l3/mroute IP Multicast Route Configuration [IPMC Static Route Menu] The following table describes the IP Multicast Route menu options. Table 6-59 IP Static Route Configuration Menu Options (cfg/l3/mroute) Command Syntax and Usage add <IPMC destination> <vlan> <port> primary|backup|host <virtual router id|none> Adds a static multicast route.
Alteon OS 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.
Static ARP entries are permanent in the ARP cache and do not age out like the ARP entries that are learnt 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.
Enables or disables ICMP re-directs. This command is disabled by default. Enables IP forwarding (routing) on the GbE Switch Module. Disables IP forwarding (routing) on the GbE Switch Module. Forwarding is turned off by default. Displays the current IP forwarding settings.
/cfg/l3/nwf Network Filter Configuration [IP Network Filter 1 Menu] addr mask enable disable - Disable Network Filter delete current - Display current Network Filter configuration Table 6-63 IP Network Filter Menu Options (/cfg/l3/nwf) Command Syntax and Usage addr <IP address, such as 192.4.17.44> Sets the starting IP address for this filter.
Alteon OS Command Reference /cfg/l3/rmap <route map number> Routing Map Configuration – The map number (1-32) represents the routing map you wish to configure. [IP Route Map 1 Menu] alist aspath metric type prec weight enable disable - Disable route map delete current - Display current route map configuration Routing maps control and modify routing information.
Page 263
Table 6-64 Routing Map Menu Options (/cfg/l3/rmap) (Continued) Command Syntax and Usage prec <value (1-256)> Sets the precedence of the route map. The smaller the value, the higher the precedence. Default value is 10. weight <value (0-65534)>|none Sets the weight of the route map. enable Enables the route map.
Alteon OS Command Reference /cfg/l3/rmap <route map number>/alist <access list number> IP Access List Configuration – The route map number (1-32) and the access list number (1-8) represent the IP access list you wish to configure. [IP Access List 1 Menu] metric action enable...
/cfg/l3/rmap <route map number> aspath <autonomous system path> Autonomous System Filter Path – The rmap number (1-32) and the path number (1-8) represent the AS path you wish to configure. [AS Filter 1 Menu] action enable disable - Disable AS Filter delete current - Display current AS Filter configuration Table 6-66 AS Filter Menu Options (/cfg/l3/rmap/aspath)
Alteon OS Command Reference /cfg/l3/rip Routing Information Protocol Configuration [Routing Information Protocol Menu] update current The RIP Menu is used for configuring Routing Information Protocol (RIP) parameters. This option is turned off by default. Table 6-67 RIP Menu Options (/cfg/l3/rip) Command Syntax and Usage if <1-127>...
Configures the RIP version used by this interface. The default value is version 1. supply disable|enable This command is disabled by default. When enabled, the switch supplies routes to other routers. listen disable|enable This command is disabled by default. When enabled, the switch learns routes from other routers.
Page 268
Alteon OS Command Reference Table 6-68 RIP Interface Menu Options (/cfg/l3/rip/if) 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.
/cfg/l3/ospf Open Shortest Path First Configuration [Open Shortest Path First Menu] aindex range virt md5key host redist lsdb default - Originate default route information Table 6-69 OSPF Configuration Menu (/cfg/l3/ospf) Command Syntax and Usage aindex <area index (0-2)> Displays the area index menu. This area index does not represent the actual OSPF area number. page 273 range <range number (1-16)>...
Page 270
<metric (1-16777215)> <metric-type 1|2>|none Sets one default route among multiple choices in an area. Use none for no default. Enables OSPF on the GbE Switch Module. Disables OSPF on the GbE Switch Module. Displays the current OSPF configuration settings.
Configures a stub area to send a numeric metric value. All routes received via that stub area carry the configured metric to potentially influencing routing decisions. Metric value assigns the priority for choosing the switch for default route. Metric type determines the method for influencing routing decisions for external routes.
Configures the base IP address for the range. mask <IP address (such as, 192.4.17.101)> Configures the IP address mask for the range. aindex <area index (0-2)> Configures the area index used by the GbE Switch Module. hide disable|enable Hides the OSPF summary range. enable Enables the OSPF summary range.
Configures the OSPF area index. prio <priority value (0-255)> Configures the priority value for the GbE Switch Module’s OSPF interfaces. (A priority value of 255 is the highest and 1 is the lowest. A priority value of 0 specifies that the interface cannot be used as Designated Router (DR) or Backup Designated Router (BDR).)
Page 274
Alteon OS Command Reference Table 6-72 OSPF Interface Configuration Menu Options (/cfg/l3/ospf/if) Command Syntax and Usage hello <value (1-65535)> Configures the interval in seconds between the hello packets for the interfaces. dead <value (1-65535)> Configures the health parameters of a hello packet, which is set for an interval of seconds before declaring a silent router to be down.
/cfg/l3/ospf/virt <link number> OSPF Virtual Link Configuration [OSPF Virtual Link 1 aindex hello dead trans retra mdkey enable disable - Disable interface delete Table 6-73 OSPF Virtual Link Configuration Menu Options (/cfg/l3/ospf/virt) Command Syntax and Usage aindex <area index (0-2)> Configures the OSPF area index.
Alteon OS Command Reference /cfg/l3/ospf/md5key <key ID> OSPF MD5 Key Configuration [OSPF MD5 Key 1 Menu] delete Table 6-76 OSPF MD5 Key Configuration Menu Options (/cfg/ip/ospf/md5key) Command Syntax and Usage Sets the authentication key for this OSPF packet. delete Deletes the authentication key for this OSPF packet. Displays the current MD5 key configuration.
BGP (iBGP). When run between different autonomous systems, it's called external BGP (eBGP). BGP is defined in RFC 1771. The BGP Menu enables you to configure the switch to receive routes and to advertise static routes, fixed routes and virtual server IP addresses with other internal and external routers. In the current Alteon OS implementation, the that are learned from other BGP “speakers”.
Page 280
Alteon OS Command Reference Table 6-77 Border Gateway Protocol Menu (/cfg/l3/bgp) Command Syntax and Usage as <1-65535> Set Autonomous System number. pref <local preference (0-4294967294)> Sets the local preference. The path with the higher value is preferred. When multiple peers advertise the same route, use the route with the shortest AS path as the preferred route if you are using eBGP, or use the local preference if you are using iBGP.
Sets the period of time, in seconds, that will elapse before the peer session is torn down because the switch hasn’t received a “keep alive” message from the peer. The default value is 180 seconds. alive <keepalive time (0, 1-21845)>...
Page 282
Alteon OS Command Reference Table 6-78 BGP Peer Configuration Menu Options (/cfg/l3/bgp/peer) Command Syntax and Usage advert <min adv time (1-65535)> Sets time in seconds between advertisements. retry <connect retry interval (1-65535)> Sets connection retry interval, in seconds. orig <min orig time (1-65535)> Sets the minimum time between route originations, in seconds.
None: No routes are configured Import: Import these routes. Originate: The switch sends a default route to peers if it does not have any default routes in its routing table. Redistribute: Default routes are either configured through default gateway or learned through other protocols and redistributed to peer.
Alteon OS Command Reference /cfg/l3/bgp/aggr <aggregation number> BGP Aggregation Configuration [BGP Aggr 1 Menu] addr mask enable disable - Disable aggregation delete This menu enables you to configure BGP aggregation to specify the routes/range of IP destina- tions a peer router accepts from other peers. All matched routes are aggregated to one route, to reduce the size of the routing table.
/cfg/l3/igmp IGMP Configuration [IGMP Menu] snoop relay mrouter igmpflt Table 6-81 describes the commands used to configure basic IGMP parameters. Table 6-81 IGMP Menu Options (/cfg/l3/igmp) Command Syntax and Usage snoop Displays the IGMP Snoop Menu. To view menu options, see relay Displays the IGMP Relay Menu.
Configures the timeout value for IGMP Membership Queries (mrouter). Once the timeout value is reached, the switch removes the multicast router from its IGMP table, if the proper conditions are met. The range is from 1 to 600 seconds. The default is 255 seconds.
Use this command to limit the number of IGMP sources to provide more refined control. v1v2 enable|disable Enables or disables snooping on IGMP version 1 and version 2 reports. When disabled, the switch drops IGMPv1 and IGMPv2 reports. The default value is enabled.
Removes the VLAN from the list of IGMP Relay VLANs. clear Removes all VLANs from the list of IGMP Relay VLANs. report <0-150> Configures the interval between unsolicited Join reports sent by the switch, in seconds. The default value is 10. Enables IGMP Relay. The Configuration Menu...
Configures the time interval between ping attempts to the upstream Mrouters, in seconds. The default value is 2. retry <1-120> Configures the number of failed ping attempts required before the switch declares this Mrouter is down. The default value is 4. restr <1-128>...
<port number> <VLAN number> <IGMP version number> Removes a static multicast router from the selected port/VLAN combination. clear Clears all static multicast routers from the switch. Displays the current IGMP Static Multicast Router parameters. The Configuration Menu - Add port as Multicast Router Port...
/cfg/l3/igmp/igmpflt IGMP Filtering Configuration [IGMP Filter Menu] filter port Table 6-87 describes the commands used to configure an IGMP filter. Table 6-87 IGMP Filtering Menu Options (/cfg/l3/igmp/igmpflt) Command Syntax and Usage filter <filter number (1-16)> Displays the IGMP Filter Definition Menu. To view menu options, see port <port number>...
Alteon OS Command Reference /cfg/l3/igmp/igmpflt/filter <filter number> IGMP Filter Definition [IGMP Filter 1 Definition Menu] range action Table 6-88 describes the commands used to define an IGMP filter. Table 6-88 IGMP Filter Definition Menu Options (/cfg/l3/igmp/igmpflt/filter) Command Syntax and Usage range <IP multicast address (such as 224.0.0.10)>...
/cfg/l3/igmp/igmpflt/port <port alias or number> IGMP Filtering Port Configuration [IGMP Port EXT1 Menu] filt Table 6-89 describes the commands used to configure a port for IGMP filtering. Table 6-89 IGMP Filter Port Menu Options (/cfg/l3/igmp/igmpflt/port) Command Syntax and Usage filt enable|disable Enables or disables IGMP filtering on this port.
Configures the timeout value for IGMP Membership Reports (host). Once the timeout value is reached, the switch removes the host from its IGMP table, if the conditions are met. The range is from 1 to 255 seconds. The default is 10 seconds.
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. DNS parameters must be configured prior to using hostname parameters with the ping, traceroute, and tftp commands.
The Bootstrap Protocol (BOOTP) Relay Menu is used to allow hosts to obtain their configura- tions from a Dynamic Host Configuration Protocol (DHCP) server. The BOOTP configuration enables the switch to forward a client request for an IP address to two DHCP/BOOTP servers with IP addresses that have been configured on the BOOTP relay is turned off by default.
Displays the VRRP virtual router group menu, used to combine all virtual routers together as one logical entity. Group options must be configured when using two or more Alteon switches in a hot- standby failover configuration where only one switch is active at any given time. To view menu options, see if <interface number (1-127)>...
Page 298
Enables or disables hot standby processing, in which two or more switches provide redundancy for each other. By default, this option is disabled. Globally enables VRRP on this switch. Globally disables VRRP on this switch. Displays the current VRRP parameters.
This menu is used for configuring virtual routers for this switch. A virtual router is defined by its virtual router ID and an IP address. On each VRRP-capable routing device participating in redundancy for this virtual router, a virtual router will be configured to share the same virtual router ID and IP address.
Page 300
<interface number (1-127)> Selects a switch IP interface. If the IP interface has the same IP address as the addr option above, this switch is considered the “owner” of the defined virtual router. An owner has a special priority of 255 (highest) and will always assume the role of master router, even if it must preempt another virtual router which has assumed master routing authority.
When enabled, the priority for this virtual router will be increased for each other IP interface active on this switch. An IP interface is considered active when there is at least one active port on the same VLAN. This helps elect the virtual routers with the most available routes as the master. This command is disabled by default.
ID and IP address. – This option is required to be configured only when using at least two s in a hot-standby failover configuration, where only one switch is active at any time Table 6-96 Virtual Router Group Menu Options (/cfg/l3/vrrp/group)
Page 303
Note that even when preem is disabled, this virtual router will always preempt any other master if this switch is the owner (the IP interface address and virtual router addr are the same). By default, this option is enabled.
When enabled, the priority for this virtual router will be increased for each other IP interface active on this switch. An IP interface is considered active when there is at least one active port on the same VLAN. This helps elect the virtual routers with the most available routes as the master. This command is disabled by default.
/cfg/l3/vrrp/if <interface number> VRRP Interface Configuration – The interface-number (1 to 127) represents the IP interface on which authentication parameters must be configured. [VRRP Interface 1 Menu] auth passw This menu is used for configuring VRRP authentication parameters for the IP interfaces used with the virtual routers.
The Configuration Menu - Set priority increment for virtual router tracking - Set priority increment for IP interface tracking - Set priority increment for VLAN switch port tracking - Display current VRRP Priority Tracking configuration page 303), the priority level for the virtual router is page 303) are enabled.
/cfg/qos Quality of Service Configuration [QOS Menu] 8021p dscp 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 6-100 Quality of Service Menu Options (/cfg/qos) Command Syntax and Usage 8021p...
Configures the weight of the selected Class of Service queue (COSq). Enter the queue number, followed by the scheduling weight (0-15). numcos 2|8 Sets the number of Class of Service queues for switch ports. The default value is 2. Displays the current 802.1p parameters. The Configuration Menu...
/cfg/qos/dscp DSCP Configuration [dscp Menu] dscp prio Use this menu map the DiffServ Code Point (DSCP) value of incoming packets to a new value, or to an 802.1p priority value. Table 6-102 DSCP Menu Options (/cfg/qos/dscp) Command Syntax and Usage dscp <0-63>...
Alteon OS Command Reference /cfg/acl Access Control List Configuration [ACL Menu] group Use this menu to create Access Control Lists and ACL Groups. ACLs define matching criteria used for IP filtering and Quality of Service functions. Table 6-103 ACL Menu Options (/cfg/acl) Command Syntax and Usage acl <1-896>...
/cfg/acl/acl <ACL number> ACL Configuration [ACL 1 Menu] ethernet - Ethernet Header Options Menu ipv4 tcpudp meter re-mark pktfmt egrport action stats reset These menus allow you to define filtering criteria for each Access Control List (ACL). Table 6-104 ACL Menu Options (/cfg/acl/acl x) Command Syntax and Usage ethernet Displays the ACL Ethernet Header menu.
Alteon OS Command Reference Table 6-104 ACL Menu Options (/cfg/acl/acl x) Command Syntax and Usage stats enable|disable Enables or disables the statistics collection for the Access Control List. reset Resets the ACL parameters to their default values. Displays the current ACL parameters. /cfg/acl/acl <ACL number>/ethernet Ethernet Filtering Configuration smac...
Table 6-105 Ethernet Filtering Menu Options (/cfg/acl/acl x/ethernet) Command Syntax and Usage reset Resets Ethernet parameters for the ACL to their default values. Displays the current Ethernet parameters for the ACL. /cfg/acl/acl <ACL number>/ipv4 IP version 4 Filtering Configuration [Filtering IPv4 Menu] proto reset This menu allows you to define IPv4 matching criteria for an ACL.
Page 314
Alteon OS Command Reference Table 6-106 IP version 4 Filtering Menu Options (/cfg/acl/acl x/ipv4) Command Syntax and Usage tos <0-255> Defines a Type of Service value for the ACL. For more information on ToS, refer to RFC 1340 and 1349. reset Resets the IPv4 parameters for the ACL to their default values.
/cfg/acl/acl <ACL number>/tcpudp TCP/UDP Filtering Configuration [Filtering TCP/UDP Menu] sport dport flags reset This menu allows you to define TCP/UDP matching criteria for an ACL. Table 6-107 TCP/UDP Filtering Menu Options (/cfg/acl/acl x/tcpudp) Command Syntax and Usage sport <source port (1-65535)> <mask (0xFFFF)> Defines a source port for the ACL.
Alteon OS Command Reference Table 6-107 TCP/UDP Filtering Menu Options (/cfg/acl/acl x/tcpudp) Command Syntax and Usage reset Resets the TCP/UDP parameters for the ACL to their default values. Displays the current TCP/UDP Filtering parameters. /cfg/acl/acl <ACL number>/meter ACL Metering Configuration [Metering Menu] mbsize enable...
/cfg/acl/acl <ACL number>/re-mark Re-Mark Configuration [Re-mark Menu] inprof outprof reset You can choose to re-mark IP header data for the selected ACL. You can configure different re- mark values, based on whether packets fall within the ACL Metering profile, or out of the ACL Metering profile.
/cfg/acl/acl <ACL number>/re-mark/inprof/up1p Update User Priority Configuration [Update User Priority Menu] value utosp reset Table 6-111 ACL Re-Mark User Priority Menu (/cfg/acl/acl x/re-mark/inprof/up1p) Command Syntax and Usage value <0-7> Defines 802.1p value. The value is the priority bits information in the packet structure. utosp enable|disable Enable or disable mapping of TOS (Type of Service) priority to 802.1p priority for In-Profile packets.
Table 6-112 ACL Re-Mark Out-of-Profile Menu (/cfg/acl/acl x/re-mark/outprof) Command Syntax and Usage updscp <0-63> Sets the DiffServ Code Point (DSCP) of Out-of-Profile packets to the selected value. The switch sets the DSCP value on Out-of-Profile packets. reset Resets the update DSCP parameters for Out-of-Profile packets to their default values.
Table 6-113 ACL Packet Format Filtering Menu Options (/cfg/acl/acl x/pktfmt) Command Syntax and Usage reset Resets Packet Format parameters for the ACL to their default values. Displays the current Packet Format parameters for the ACL. /cfg/acl/group <ACL Group number> ACL Group Configuration [ACL Group 1 Menu] This menu allows you to compile one or more ACLs into an ACL Group.
- Monitoring Port based PM Menu Port mirroring is disabled by default. For more information about port mirroring on the GbE Switch Module, see “Appendix A: Troubleshooting” in the Alteon OS Application Guide. – Traffic on VLAN 4095 is not mirrored to the external ports.
/cfg/pmirr/monport Port-Mirroring Configuration [Port EXT1 Menu] delete Table 6-116 Port Mirroring Monitor Port Menu Options (/cfg/pmirr/monport) Command Syntax and Usage add <mirrored port (port to mirror from)> <direction (in, out, or both)> Adds the port to be mirrored. This command also allows you to enter the direction of the traffic. It is necessary to specify the direction because: If the source port of the frame matches the mirrored port and the mirrored direction is ingress or both (ingress and egress), the frame is sent to the mirrored port.
Telnet connection. When using Telnet to configure a new switch, paste the configuration commands from the script file at the command line prompt of the switch. The active configuration can also be saved or loaded via TFTP, as described on page 327.
When the gtcfg command is used, the active configuration will be replaced with the com- mands found in the specified configuration file. The file can contain a full switch configuration or a partial switch configuration. The configuration loaded using gtcfg is not activated until the apply command is used.
Page 326
Alteon OS Command Reference The Configuration Menu BMD00007, November 2007...
The Operations Menu is generally used for commands that affect switch performance immedi- ately, but do not alter permanent switch configurations. For example, you can use the Opera- tions 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.
The commands of the Operations Menu enable you to alter switch operational characteristics without affecting switch configuration. Table 7-1 Operations Menu (/oper) Command Syntax and Usage port <port alias or number> Displays the Operational Port Menu. To view menu options, see vrrp Displays the Operational Virtual Router Redundancy Menu.
Page 329
Table 7-1 Operations Menu (/oper) Command Syntax and Usage cfgtrk Displays a list of configuration changes made since the last apply command. Each time the apply command is sent, the configuration-tracking log is cleared. ntpreq Allows the user to send requests to the NTP server. BMD00007, November 2007 Alteon OS Command Reference The Operations Menu...
Displays the 802.1x Port Menu. To view menu options, see Temporarily enables the port. The port will be returned to its configured operation mode when the switch is reset. Temporarily disables the port. The port will be returned to its configured operation mode when the switch is reset.
/oper/port <port alias or number>/8021x Operations-Level Port 802.1x Options [802.1x Operation Menu] reset reauth Operations-level port 802.1x options are used to temporarily set 802.1x parameters for a port. Table 7-3 Operations-Level Port 802.1x Menu Options (/oper/port x/8021x) Command Syntax and Usage reset Re-initializes the 802.1x access-control parameters for the port.
This switch owns the virtual router (the IP addresses of the virtual router and its IP interface are the same) This switch’s virtual router has a higher priority and preemption is enabled.
/oper/ip/bgp Operations-Level BGP Options [Border Gateway Protocol Operations Menu] start stop current - Current BGP operational state Table 7-6 Operations-Level BGP Menu Options (/oper/ip/bgp) Command Syntax and Usage start <peer number (1-16)> Starts the peer session. stop <peer number (1-16)> Stops the peer session.
Enables exclusive local control of external ports. When Protected Mode is set to on, the manage- ment module cannot be used to disable external ports on the switch. The default value is enabled. Note: Due to current management module implementation, this setting cannot be disabled.
Page 335
Table 7-7 Protected Mode Options (/oper/prm) Command Syntax and Usage Turns Protected Mode off. When Protected Mode is turned off, the switch relinquishes exclusive local control of all enabled options. Displays the current Protected Mode configuration. BMD00007, November 2007 Alteon OS Command Reference...
Page 336
Alteon OS Command Reference The Operations Menu BMD00007, November 2007...
Selecting a configuration block to be used when the switch is next reset Downloading or uploading a new software image to the switch via FTP/TFTP In addition to the Boot Menu, you can use a Web browser or SNMP to work with switch image and configuration files. To use SNMP, refer to tion Files”...
Each of these options is discussed in greater detail in the following sections. Scheduled Reboot of the Switch This feature allows the switch administrator to schedule a reboot to occur at a particular time in future. This feature is particularly helpful if the user needs to perform switch upgrades during off-peak hours.
The switch software image is the executable code running on the 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. To get the latest version of software available for your GbE Switch Module, go to: http://www-304.ibm.com/jct01004c/systems/support...
Page 340
Alteon OS Command Reference The Switch Image and Configuration Management page appears. If you are loading software from your computer (HTTP client), go to step 4. If you are loading software from a FTP/TFTP server, enter the server’s information in the FTP/TFTP Settings section.
Once the image has loaded, the page refreshes to show the new software. Using the CLI To load a new software image to your switch, you need the following: The image or boot software loaded on a FTP/TFTP server on your network...
You should next select a software image to run, as described below. Selecting a Software Image to Run You can select which software image (image1 or image2) you want to run in switch mem- ory for the next reboot. At the Boot Options# prompt, enter: Boot Options# image Enter the name of the image you want the switch to use upon the next boot.
Uploading a Software Image from Your Switch You can upload a software image from the switch to a FTP or TFTP server. At the Boot Options# prompt, enter: Boot Options# ptimg The system prompts you for information. Enter the desired image: Enter name of switch software image to be uploaded ["image1"|"image2"|"boot"]: <image>...
Selecting a Configuration Block When you make configuration changes to the 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.
Resetting the Switch You can reset the switch to make your software image file and configuration block changes occur. – Resetting the switch causes the Spanning Tree Group to restart. This process can be lengthy, depending on the topology of your network.
Page 346
Alteon OS Command Reference The Boot Options Menu BMD00007, November 2007...
HAPTER The Maintenance Menu The Maintenance Menu is used to manage dump information and forward database informa- tion. It also includes a debugging menu to help with troubleshooting. BMD00007, November 2007...
Alteon OS Command Reference /maint Maintenance Menu – To use the Maintenance Menu, you must be logged in to the switch as the administrator. [Maintenance Menu] debug route igmp uudmp ptdmp cldmp panic tsdmp pttsdmp Dump information contains internal switch state data that is written to flash memory on the GbE Switch Module The switch administrator forces a switch panic.
Page 349
Dumps MP information to FLASH and reboots. For details, see tsdmp Dumps all GbE Switch Module information, statistics, and configuration.You can log the tsdump output into a file. pttsdmp Redirects the technical support dump (tsdmp) to an external TFTP server.
Alteon OS Command Reference /maint/sys System Maintenance This menu is reserved for use by IBM Service Support. The options are used to perform system debugging. [System Maintenance Menu] flags tmask Table 9-2 System Maintenance Menu Options (/maint/sys) Command Syntax and Usage flags <new NVRAM flags word as 0xXXXXXXXX>...
Displays all entries in the Forwarding Database. For details, see del <MAC address> [<VLAN>] Removes a single FDB entry. clear Clears the entire Forwarding Database from switch memory. BMD00007, November 2007 - Show a single FDB entry by MAC address - Show FDB entries for a single port...
Events traced to a buffer area when a reset occurs If the switch resets for any reason, the MP trace buffer is saved into the snap trace buffer area. The output from these commands can be interpreted by IBM Service Support.
Clears the entire ARP list from switch memory. – To display all ARP entries currently held in the switch, or a portion according to one of the options listed on the menu above (find, port, vlan, dump), you can also refer to “ARP Information”...
Shows routes on a single interface. dump Shows all routes. clear Clears the route table from switch memory. – To display all routes, you can also refer to “IP Routing Information” on The Maintenance Menu - Show a single route by destination IP address...
/maint/igmp IGMP Maintenance [IGMP Multicast Group Menu] group mrouter clear Table 9-7 describes the IGMP Maintenance commands. Table 9-7 IGMP Maintenance Menu Options (/maint/igmp) Command Syntax and Usage group Displays the Multicast Group menu. To view menu options, see mrouter Displays the Multicast Router Port menu.
Alteon OS Command Reference /maint/igmp/group IGMP Group Maintenance [IGMP Multicast Group Menu] find vlan port trunk detail dump clear The following table describes the IGMP Maintenance commands. Table 9-8 IGMP Multicast Group Maintenance Menu Options (/maint/igmp/group) Command Syntax and Usage find <IP address>...
Alteon OS 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.
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.
Alteon OS Command Reference /maint/panic Panic Command The panic command causes the switch to immediately dump state information to flash mem- ory and automatically reboot. To select panic, at the Maintenance# prompt, enter: >> Maintenance# panic A FLASH dump already exists.
PPENDIX Alteon OS Syslog Messages The following syntax is used when outputting syslog messages: <Time stamp><Log Label>Web OS<Thread ID>:<Message> where <Timestamp> The time of the message event is displayed in month day hour:minute:second format. For example: Aug 19 14:20:30 <Log Label> The following types of log messages are recorded: LOG_EMERG, LOG_ALERT, LOG_CRIT, LOG_ERR, LOG_WARNING, LOG_NOTICE, LOG_INFO, and LOG_DEBUG <Thread ID>...
Page 362
Alteon OS Command Reference LOG_ALERT Own BPDU received from port <port_id> STG <stg>, topology change detected CIST topology change detected STG <stg>, new root bridge CIST new root bridge Cannot contact default gateway <ip_address> VRRP Received errored advertisement from <ip_address> VRRP Received incorrect password from <ip_address>...
Page 363
LOG_CRITICAL SYSTEM BMD00007, November 2007 Can't allocate memory in load_MP_INT Currently not enough resource for loading RSA private key Currently not enough resource for loading RSA public key Temperature exceeds threshold Failed to Read SFP ID for port EXT<num> Failed to Select SFP for port EXT<num> ID Voltage (<volt>) is UNDER Range on port EXT<num>.
Page 364
Alteon OS Command Reference LOG_ERROR MGMT MGMT MGMT MGMT MGMT MGMT Alteon OS Syslog Messages PANIC at <file>:<line> in thread <thread id> VERIFY at <file>:<line> in thread <thread id> ASSERT at <file>:<line> in thread <thread id> Cannot contact <primary|secondary> NTP server <ip_address> Unable to listen to NTP port Error: Error writing STG config to FLASH Error: Error writing config to FLASH...
Page 365
LOG_ERROR (continued) PORT_MIRR MGMT MGMT BMD00007, November 2007 Port Mirroring changes are not applied Broadcast address for IP interface <interface_id> is invalid IP Interfaces <interface_id> and <interface_id> are on the same subnet Unapplied changes reverted Unsaved changes reverted SNMP source trap interface <IF> is not enabled Password already taken Radius is already turned ON Cannot ena/dis primary admin user...
Page 366
Alteon OS Command Reference LOG_ERROR (continued) VRRP VRRP VRRP VRRP VRRP VRRP VRRP VRRP VRRP VRRP VRRP VRRP VRRP VRRP Alteon OS Syslog Messages A previous apply is being executed. Try later. RADIUS secret must be 1-<len> characters long Please configure primary RADIUS server address. TACACS+ secret must be 1-<len>...
Page 368
Change fiber GIG port <port> mode to full duplex Change fiber GIG port <port> speed to 1000 Boot config block changed Boot image changed Switch reset from CLI Syslog host changed to <ip_address> Syslog host changed to this host BMD00007, November 2007...
Page 369
Administrator logout from BBI <login_level> login from host <ip_address> System clock set to <time> PANIC command from CLI Switch reset scheduled at <time> Switch reset at <time> has been cancelled Scheduled switch reboot Alteon OS Command Reference Alteon OS Syslog Messages...
Page 370
Alteon OS Command Reference LOG_NOTICE (continued) MGMT MGMT MGMT VLAN PORT_MIRR PORT_MIRR SYSTEM SYSTEM SYSTEM SYSTEM SYSTEM SYSTEM SYSTEM SYSTEM SYSTEM SYSTEM Alteon OS Syslog Messages <mins> minutes until scheduled reboot Password for <user> changed by <user>, notifying admin to save. Temperature OK Default VLAN can not be deleted "...
Page 371
LOG_NOTICE (continued) SYSTEM SYSTEM SYSTEM SYSTEM SYSTEM SYSTEM SYSTEM SYSTEM SYSTEM SYSTEM VRRP VRRP LOG_INFO MGMT MGMT MGMT MGMT MGMT MGMT MGMT MGMT MGMT MGMT BMD00007, November 2007 Management Port can only be enabled/disabled by the Management Module Cannot change the Management IP Interface VLAN Cannot enable/disable the Management IP Interface Cannot enable/disable forwarding on Management IP Interface Cannot delete the Management IP Interface...
Appendix B Alteon OS SNMP Agent The Alteon OS SNMP agent supports SNMP version 3. Security is provided through SNMP community strings. The default community strings are “public” for SNMP GET operation and “private” for SNMP SET operation. The community string can be modified only through the Command Line Interface (CLI).
Page 374
Alteon OS Command Reference Alteon OS SNMP agent supports the following generic traps as defined in RFC 1215: ColdStart WarmStart LinkDown LinkUp AuthenticationFailure The SNMP agent also supports two Spanning Tree traps as defined in RFC 1493: NewRoot TopologyChange The following are the enterprise SNMP traps supported in Alteon OS: Table 9-10 Alteon OS-Supported Enterprise SNMP Traps Trap Name altSwPrimaryPowerSupplyFailure...
Page 375
TCP connections from that client has reached a pre-determined threshold. A altSwTempExceedThreshold trap signifies that the switch temperature has exceeded maximum safety limits. Alteon OS SNMP Agent...
Working with Switch Images and Configuration Files This section describes how to use MIB calls to work with switch images and configuration files. You can use a standard SNMP tool to perform the actions, using the MIBs listed in Table 9-11.
Loading a new switch image To load a new switch image with the name “MyNewImage-1.img” into image2, follow the steps below. This example assumes you have a FTP/TFTP server at 192.168.10.10. Set the FTP/TFTP server address where the switch image resides: Set agTftpServer.0 “192.168.10.10”...
Set agTftpPassword.0 “MyPassword” Saving the switch configuration To save the switch configuration to a FTP/TFTP server follow the steps below. This example assumes you have a FTP/TFTP server at 192.168.10.10. Set the FTP/TFTP server address where the configuration file is saved: Set agTftpServer.0 “192.168.10.10”...
Saving a switch dump To save a switch dump to a FTP/TFTP server, follow the steps below. This example assumes you have a FTP/TFTP server at 192.168.10.10. Set the FTP/TFTP server address where the configuration will be saved: Set agTftpServer.0 “192.168.10.10”...
Page 380
Alteon OS Command Reference Alteon OS SNMP Agent BMD00007, November 2007...
(with preemption enabled). Tracking can be very valuable in an active/active configuration. You can track the following: BMD00007, November 2007 ifs: Active IP interfaces on the GbE Switch Module (increments priority by 2 for each) ports: Active ports on the same VLAN (increments priority by 2 for each)
Page 382
A shared address between two devices utilizing VRRP, as defined in RFC 2338. One vir- tual router is associated with an IP interface. This is one of the IP interfaces that the switch is assigned. All IP interfaces on the GbE Switch Module must be in a VLAN. If there is more than one VLAN defined on the GbE Switch Module, then the VRRP broadcasts will only be sent out on the VLAN of which the associated IP interface is a member.
... 306 VLAN active switch configuration ... 327 gtcfg ... 327 ptcfg ... 327 restoring active switch, saving and loading configuration addr ... 99 IP route tag ... 27, 32 administrator account ... 209 admpw (system option) aging ... 234 STP bridge option ...
Page 384
IP static route LDAP operating mode port link speed port mirroring port trunking ...16 save changes setup setup command SNMP switch IP address TACACS+ user password view changes VLAN default (PVID) VLAN IP interface VLAN tagging VRRP configuration block active backup...
Page 385
date ... 35 setup ... 180 system option ... 180 daylight savings time ... 349 debugging default gateway ... 96 information ... 256 interval, for health checks ... 27 default password delete ... 353 FDB entry ... 101 designated port. diff (global) command, viewing changes ...
Page 386
IP routing ...99 tag parameters ...258, 259 IP Static Route Menu ...147 IP statistics ...39 IP subnet mask ...144 IP switch processor statistics ...243 LACP ...74 Layer 2 Menu ...95 Layer 3 Menu ...86, 87, 92 LEARNING (port state) link ...215...
Page 387
... 271 host routes ... 271 interface interface configuration link state database Not-So-Stubby Area priority value of the switch interface range number redistribution menu route redistribution configuration spf, shortest path first ... 273 stub area summary range configuration ...
Page 388
(SNMP option) ... 350, 362 reboot ...213 receive flow control reference ports referenced port ... 319 re-mark restarting switch setup retries radius server retry health checks for default gateway IP route tag RIP Information RIP information RIP. See Routing Information Protocol.