Nortel Alteon OS 40M2420 Operating manual

2350 Mission College Blvd.
Suite 600
Santa Clara, CA 95054
www.bladenetwork.net
Alteon OS
Command Reference
Layer 2/3 GbE Switch Module for IBM BladeCenter®
Version 1.3
TM
Part Number: 40M2420, April 2007

Alteon OS Command Reference
240M2420, April 2007
Copyright © 2007 Blade Network Technologies, Inc., 2350 Mission College Blvd., Suite 600, Santa Clara,
California, 95054, USA. All rights reserved. Part Number: 40M2420.
This document is protected by copyright and distributed under licenses restricting its use, copying,
distribution, and decompilation. No part of this document may be reproduced in any form by any means
without prior written authorization of Blade Network Technologies, Inc. Documentation is provided “as
is” without warranty of any kind, either express or implied, including any kind of implied or express
warranty of non-infringement or the implied warranties of merchantability or fitness for a particular
purpose.
U.S. Government End Users: This document is provided with a “commercial item” as defined by FAR
2.101 (Oct. 1995) and contains “commercial technical data”and “commercial software documentation” as
those terms are used in FAR 12.211-12.212 (Oct. 1995). Government End Users are authorized to use this
documentation only in accordance with those rights and restrictions set forth herein, consistent with FAR
12.211- 12.212 (Oct. 1995), DFARS 227.7202 (JUN 1995) and DFARS 252.227-7015 (Nov. 1995).
Blade Network Technologies, Inc. reserves the right to change any products described herein at any time,
and without notice. Blade Network Technologies, Inc. assumes no responsibility or liability arising from
the use of products described herein, except as expressly agreed to in writing by Blade Network
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®are registered trademarks of Cisco Systems, Inc. in the United States
and certain other countries. Any other trademarks appearing in this manual are owned by their respective
companies.

40M2420, April 2007 3
Contents
Preface 13
Who Should Use This Book 14
How This Book Is Organized 15
Typographic Conventions 16
How to Get Help 17
The Command Line Interface 19
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
Running SSH 25
Accessing the Switch 26
Setup Versus CLI 28
Command Line History and Editing 29
Idle Timeout 29
First-Time Configuration 31
Using the Setup Utility 32
Information Needed For Setup 32
Starting Setup When You Log In 32
Stopping and Restarting Setup Manually 34
Stopping Setup 34
Restarting Setup 34
Setup Part 1: Basic System Configuration 34
Setup Part 2: Port Configuration 36

Alteon OS Command Reference
4 Contents 40M2420, April 2007
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
Menu Summary 49
Global Commands 50
Command Line History and Editing 53
Command Line Interface Shortcuts 54
Command Stacking 54
Command Abbreviation 54
Tab Completion 54
The Information Menu 55
Information Menu 56
System Information 58
SNMPv3 System Information Menu 59
SNMPv3 USM User Table Information 61
SNMPv3 View Table Information 62
SNMPv3 Access Table Information 63
SNMPv3 Group Table Information 64
SNMPv3 Community Table Information 64
SNMPv3 Target Address Table Information 65
SNMPv3 Target Parameters Table Information 66
SNMPv3 Notify Table Information 67
SNMPv3 Dump Information 68
BladeCenter Chassis Information 69
General System Information 70
Show Recent Syslog Messages 72
User Status 73
Layer 2 Information 74

Alteon OS Command Reference
Contents 540M2420, April 2007
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
802.1x Information 80
Spanning Tree Information 82
RSTP/MSTP Information 85
Common Internal Spanning Tree Information 88
Trunk Group Information 91
VLAN Information 91
Layer 3 Information 93
IP Routing Information 95
Show All IP Route Information 96
ARP Information 98
Show All ARP Entry Information 99
ARP Address List Information 99
BGP Information 100
BGP Peer information 100
BGP Summary information 101
Show all BGP Information 101
OSPF Information 102
OSPF General Information 103
OSPF Interface Information 104
OSPF Database Information 104
OSPF Information Route Codes 106
Routing Information Protocol Information 107
RIP Routes Information 107
Show RIP User Configuration 107
IP Information 108
IGMP Multicast Group Information 109
IGMP Group Information 110
IGMP Multicast Router Port Information 110
IGMP Mrouter Information 111
VRRP Information 112
Quality of Service Information 113
802.1p Information 113
Access Control List Information 115
Link Status Information 116
Port Information 117
Logical Port to GEA Port Mapping 118

Alteon OS Command Reference
6 Contents 40M2420, April 2007
Fiber Port SFP Status 119
Information Dump 119
The Statistics Menu 121
Statistics Menu 121
Port Statistics 123
802.1x Authenticator Statistics 124
802.1x Authenticator Diagnostics 125
Bridging Statistics 127
Ethernet Statistics 129
Interface Statistics 132
Interface Protocol Statistics 134
Link Statistics 134
Layer 2 Statistics 135
FDB Statistics 135
LACP Statistics 136
Layer 3 Statistics 137
IP Statistics 139
Route Statistics 141
ARP statistics 141
DNS Statistics 142
ICMP Statistics 142
TCP Statistics 145
UDP Statistics 147
IGMP Statistics 148
OSPF Statistics 149
OSPF Global Statistics 150
VRRP Statistics 154
Routing Information Protocol Statistics 155
Management Processor Statistics 156
MP Packet Statistics 157
TCP Statistics 158
UCB Statistics 158
CPU Statistics 159
ACL Statistics 160
ACL Statistics 160
ACL Meter Statistics 161
SNMP Statistics 162
NTP Statistics 166
Statistics Dump 167

Alteon OS Command Reference
Contents 740M2420, April 2007
The Configuration Menu 169
Configuration Menu 170
Viewing, Applying, and Saving Changes 172
Viewing Pending Changes 172
Applying Pending Changes 172
Saving the Configuration 173
System Configuration 174
System Host Log Configuration 177
SSH Server Configuration 178
RADIUS Server Configuration 179
TACACS+ Server Configuration 181
LDAP Server Configuration 184
NTP Server Configuration 186
System SNMP Configuration 188
SNMPv3 Configuration 190
User Security Model Configuration 192
SNMPv3 View Configuration 193
View-based Access Control Model Configuration 194
SNMPv3 Group Configuration 196
SNMPv3 Community Table Configuration 197
SNMPv3 Target Address Table Configuration 198
SNMPv3 Target Parameters Table Configuration 199
SNMPv3 Notify Table Configuration 200
System Access Configuration 201
Management Networks Configuration 203
User Access Control Configuration 204
System User ID Configuration 205
Strong Password Configuration 206
HTTPS Access Configuration 207
Port Configuration 208
Port Link Configuration 210
Temporarily Disabling a Port 211
Port ACL Configuration 211
ACL Port Metering Menu 212
Re-Mark Menu 213
Re-Marking In-Profile Menu 214
Update User Priority Menu 215
Re-Marking Out-of-Profile Menu 216
Layer 2 Configuration 217

Alteon OS Command Reference
8 Contents 40M2420, April 2007
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
Spanning Tree Bridge Configuration 233
Spanning Tree Port Configuration 235
Forwarding Database Configuration 237
Static FDB Configuration 238
Trunk Configuration 239
IP Trunk Hash Configuration 240
IP Trunk Hash 240
LACP Configuration 242
LACP Port Configuration 243
Layer 2 Failover Configuration 244
Failover Trigger Configuration 245
Auto Monitor Configuration 246
VLAN Configuration 247
Protocol-based VLAN Configuration 249
Private VLAN Configuration 251
Layer 3 Configuration 252
IP Interface Configuration 254
Default Gateway Configuration 255
IP Static Route Configuration 256
IP Multicast Route Configuration 257
ARP Configuration 258
ARP Static Configuration 259
IP Forwarding Configuration 260
Network Filter Configuration 261
Routing Map Configuration 262
IP Access List Configuration 264
Autonomous System Filter Path 265
Routing Information Protocol Configuration 266
Routing Information Protocol Interface Configuration 267

Alteon OS Command Reference
Contents 940M2420, April 2007
Open Shortest Path First Configuration 269
Area Index Configuration 271
OSPF Summary Range Configuration 272
OSPF Interface Configuration 273
OSPF Virtual Link Configuration 275
OSPF Host Entry Configuration 276
OSPF Route Redistribution Configuration 277
OSPF MD5 Key Configuration 278
Border Gateway Protocol Configuration 279
BGP Peer Configuration 281
BGP Redistribution Configuration 283
BGP Aggregation Configuration 284
IGMP Configuration 285
IGMP Snooping Configuration 286
IGMP Version 3 Configuration 287
IGMP Relay Configuration 288
IGMP Relay Multicast Router Configuration 289
IGMP Static Multicast Router Configuration 290
IGMP Filtering Configuration 291
IGMP Filter Definition 292
IGMP Filtering Port Configuration 293
IGMP Advanced Configuration 294
Domain Name System Configuration 295
Bootstrap Protocol Relay Configuration 296
VRRP Configuration 297
Virtual Router Configuration 299
Virtual Router Priority Tracking Configuration 301
Virtual Router Group Configuration 302
Virtual Router Group Priority Tracking Configuration 304
VRRP Interface Configuration 305
VRRP Tracking Configuration 306
Quality of Service Configuration 307
802.1p Configuration 308
DSCP Configuration 309
Access Control List Configuration 310
ACL Configuration 311
Ethernet Filtering Configuration 312
IP version 4 Filtering Configuration 313
TCP/UDP Filtering Configuration 314
Packet Format Filtering Configuration 315
ACL Block Menu 316

Alteon OS Command Reference
10 Contents 40M2420, April 2007
ACL Group Configuration 317
Port Mirroring Configuration 318
Port-Mirroring Configuration 319
Setup 320
Dump 320
Saving the Active Switch Configuration 321
Restoring the Active Switch Configuration 321
The Operations Menu 323
Operations Menu 324
Operations-Level Port Options 325
Operations-Level Port 802.1x Options 326
Operations-Level VRRP Options. 327
Operations-Level IP Options 328
Operations-Level BGP Options 328
The Boot Options Menu 329
Boot Menu 330
Scheduled Reboot of the Switch 330
Scheduled Reboot Menu 330
Updating the Switch Software Image 331
Loading New Software to Your Switch 331
Using the BBI 331
Using the AOS CLI 333
Selecting a Software Image to Run 334
Uploading a Software Image from Your Switch 335
Selecting a Configuration Block 336
Resetting the Switch 337
Accessing the ISCLI 337
The Maintenance Menu 339
Maintenance Menu 340
System Maintenance 342
Forwarding Database Maintenance 343
Debugging Options 344
ARP Cache Maintenance 345
IP Route Manipulation 346
IGMP Maintenance 347
IGMP Group Maintenance 347
IGMP Multicast Routers Maintenance 348

Alteon OS Command Reference
Contents 1140M2420, April 2007
Uuencode Flash Dump 349
TFTP System Dump Put 350
Clearing Dump Information 350
Panic Command 351
Unscheduled System Dumps 351
Alteon OS Syslog Messages 353
Alteon OS SNMP Agent 365
Working with Switch Images and
Configuration Files 368
Loading a new switch image 369
Loading a saved switch configuration 370
Saving the switch configuration 370
Saving a switch dump 371
Glossary 373
Index 1

Alteon OS Command Reference
12 Contents 40M2420, April 2007

40M2420, April 2007 13
Preface
The Alteon OS Command Reference describes how to configure and use the Alteon OS
software with your Layer 2/3 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
Module, see the Alteon OS Application Guide.

Alteon OS Command Reference
14 Preface 40M2420, April 2007
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.

Alteon OS Command Reference
Preface 1540M2420, April 2007
How This Book Is Organized
Chapter 1 “The Command Line Interface,” describes how to connect to the switch and access
the information and configuration menus.
Chapter 2 “First-Time Configuration,” describes how to use the Setup utility for initial
switch configuration and how to change the system passwords.
Chapter 3 “Menu Basics,” provides an overview of the menu system, including a menu map,
global commands, and menu shortcuts.
Chapter 4 “The Information Menu,” shows how to view switch configuration parameters.
Chapter 5 “The Statistics Menu,” shows how to view switch performance statistics.
Chapter 6 “The Configuration Menu,” shows how to configure switch system parameters,
ports, VLANs, Spanning Tree Protocol, SNMP, Port Mirroring, IP Routing, Port Trunking, and
more.
Chapter 7 “The Operations Menu,” shows how to use commands which affect switch per-
formance immediately, but do not alter permanent switch configurations (such as temporarily
disabling ports). The menu describes how to activate or deactivate optional software features.
Chapter 8 “The Boot Options Menu,” describes the use of the primary and alternate switch
images, how to load a new software image, and how to reset the software to factory defaults.
Chapter 9 “The Maintenance Menu,” shows how to generate and access a dump of critical
switch state information, how to clear it, and how to clear part or all of the forwarding database.
Appendix A, “Alteon OS Syslog Messages,” shows a listing of syslog messages.
Appendix B, “Alteon OS SNMP Agent,” lists the Management Interface Bases (MIBs) sup-
ported in the switch software.
“Glossary” includes definitions of terminology used throughout the book.
“Index” includes pointers to the description of the key words used throughout the book.

Alteon OS Command Reference
16 Preface 40M2420, April 2007
Typographic Conventions
The following table describes the typographic styles used in this book.
Table 1 Typographic Conventions
Typeface or
Symbol
Meaning Example
AaBbCc123 This type is used for names of commands,
files, and directories used within the text. View the readme.txt file.
It also depicts on-screen computer output and
prompts. Main#
AaBbCc123 This bold type appears in command exam-
ples. It shows text that must be typed in
exactly as shown.
Main# sys
<AaBbCc123> This italicized type appears in command
examples as a parameter placeholder. Replace
the indicated text with the appropriate real
name or value when using the command. Do
not type the brackets.
To establish a Telnet session, enter:
host# telnet <IP address>
This also shows book titles, special terms, or
words to be emphasized. Read your User’s Guide thoroughly.
[ ] Command items shown inside brackets are
optional and can be used or excluded as the
situation demands. Do not type the brackets.
host# ls [-a]

Alteon OS Command Reference
Preface 1740M2420, April 2007
How to Get Help
If you need help, service, or technical assistance, see the “Getting help and technical
assistance” appendix in the Layer 2/3 GbE Switch Module for IBM BladeCenter
Installation Guide.

Alteon OS Command Reference
18 Preface 40M2420, April 2007

40M2420, April 2007 19
CHAPTER 1
The Command Line Interface
Your GbE Switch Module (GbESM) is ready to perform basic switching functions right out of the
box. Some of the more advanced features, however, require some administrative configuration
before they can be used effectively.
The extensive Alteon OS switching software included in your switch provides a variety of
options for accessing and configuring the switch:
A built-in, text-based command line interface and menu system for access via a Telnet ses-
sion or serial-port connection
SNMP support for access through network management software such as IBM Director or
HP OpenView
Alteon OS Browser-Based Interface (BBI)
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.
This chapter explains how to access the Command Line Interface (CLI) for the switch.

Alteon OS Command Reference
20 Chapter 1: The Command Line Interface 40M2420, April 2007
Connecting to the Switch
You can access the command line interface in any one of the following ways:
Using a Telnet via the management module
Using a Telnet connection over the network
Using a SSH connection to securely log into another computer over a network
Using a serial connection using the serial port on the GbESM
Management Module Setup
The BladeCenter GbE Switch Module is an integral subsystem within the overall BladeCenter
system. The BladeCenter chassis includes a management module (MM) as the central element
for overall chassis management and control.
You can use the 100 Mbps Ethernet port on the management module to configure and manage
the GbE Switch Module. The GbE Switch Module communicates with the management mod-
ule through its internal port 15 (MGT1) and port 16 (MGT2), which you can access through the
Ethernet port on the management module. The factory default settings will permit only man-
agement and control access to the switch module through the Ethernet port on the management
module, or the built-in serial port. You can use the six external 10/100/1000 Mbps Ethernet
ports on the switch module for management 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 Guide publications for more information).
Factory-Default vs. MM assigned IP Addresses
Each GbE Switch Module must be assigned its own Internet Protocol address, which is used
for communication with an SNMP network manager or other transmission control protocol/
Internet Protocol (TCP/IP) applications (for example, BootP or TFTP). The factory-default IP
address is 10.90.90.9x, where x corresponds to the number of the bay into which the GbE