Nortel ALTEON OS BMD00007 Installation manual

2350 Mission College Blvd.
Suite 600
Santa Clara, CA 95054
www.bladenetwork.net
Alteon OS
Command Reference
Nortel 10Gb Uplink Ethernet Switch Module for IBM BladeCenter®
Version 1.2
TM
Part Number: BMD00007, November 2007

Alteon OS Command Reference
2BMD00007, November2007
Copyright © 2007 Blade Network Technologies, Inc., 2350 Mission College Blvd., Suite 600, Santa Clara,
California, 95054, USA. All rights reserved. Part Number: BMD00007.
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.

BMD00007, November 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 33
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 BMD00007, November 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

Alteon OS Command Reference
Contents 5BMD00007, November 2007
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
RSTP/MSTP Information 88
Common Internal Spanning Tree Information 91
Trunk Group Information 93
VLAN Information 94
Layer 3 Information 95
IP Routing Information 97
Show All IP Route Information 98
ARP Information 100
Show All ARP Entry Information 101
ARP Address List Information 102
BGP Information 102
BGP Peer information 103
BGP Summary information 103
Show all BGP Information 104
OSPF Information 105
OSPF General Information 106
OSPF Interface Information 107
OSPF Database Information 107
OSPF Information Route Codes 109
Routing Information Protocol Information 110
RIP Routes Information 110
Show RIP User Configuration 111
IP Information 112
IGMP Multicast Group Information 113
IGMP Group Information 114
IGMP Multicast Router Port Information 114
IGMP Mrouter Information 115
VRRP Information 116
Quality of Service Information 117

Alteon OS Command Reference
6 Contents BMD00007, November 2007
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
Interface Statistics 136
Interface Protocol Statistics 138
Link Statistics 138
Layer 2 Statistics 139
FDB Statistics 139
LACP Statistics 141
GVRP Statistics 142
Layer 3 Statistics 144
IP Statistics 147
Route Statistics 149
ARP statistics 149
DNS Statistics 150
ICMP Statistics 150
TCP Statistics 153
UDP Statistics 155
IGMP Statistics 156
OSPF Statistics 157
OSPF Global Statistics 158
VRRP Statistics 162
Routing Information Protocol Statistics 163
Management Processor Statistics 164
MP Packet Statistics 165
TCP Statistics 166
UCB Statistics 167
CPU Statistics 167
ACL Statistics 168
ACL Statistics 168

Alteon OS Command Reference
Contents 7BMD00007, November 2007
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
LDAP Server Configuration 190
NTP Server Configuration 192
System SNMP Configuration 193
SNMPv3 Configuration 195
User Security Model Configuration 197
SNMPv3 View Configuration 198
View-based Access Control Model Configuration 199
SNMPv3 Group Configuration 201
SNMPv3 Community Table Configuration 202
SNMPv3 Target Address Table Configuration 203
SNMPv3 Target Parameters Table Configuration 204
SNMPv3 Notify Table Configuration 205
System Access Configuration 206
Management Networks Configuration 208
User Access Control Configuration 209
System User ID Configuration 210
Strong Password Configuration 211
HTTPS Access Configuration 212
Port Configuration 213
Port Link Configuration 215
Temporarily Disabling a Port 216
Port ACL Configuration 216

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

Alteon OS Command Reference
Contents 9BMD00007, November 2007
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 279
OSPF MD5 Key Configuration 280
Border Gateway Protocol Configuration 281
BGP Peer Configuration 283
BGP Redistribution Configuration 285
BGP Aggregation Configuration 286
IGMP Configuration 287
IGMP Snooping Configuration 288
IGMP Version 3 Configuration 289
IGMP Relay Configuration 290
IGMP Relay Multicast Router Configuration 291
IGMP Static Multicast Router Configuration 292
IGMP Filtering Configuration 293
IGMP Filter Definition 294
IGMP Filtering Port Configuration 295
IGMP Advanced Configuration 296
Domain Name System Configuration 297
Bootstrap Protocol Relay Configuration 298
VRRP Configuration 299
Virtual Router Configuration 301
Virtual Router Priority Tracking Configuration 303
Virtual Router Group Configuration 304
Virtual Router Group Priority Tracking Configuration 306
VRRP Interface Configuration 307
VRRP Tracking Configuration 308
Quality of Service Configuration 309
802.1p Configuration 310
DSCP Configuration 311
Access Control List Configuration 312
ACL Configuration 313
Ethernet Filtering Configuration 314
IP version 4 Filtering Configuration 315
TCP/UDP Filtering Configuration 317

Alteon OS Command Reference
10 Contents BMD00007, November 2007
ACL Metering Configuration 318
Re-Mark Configuration 319
Re-Marking In-Profile Configuration 320
Update User Priority Configuration 321
Re-Marking Out-of-Profile Configuration 322
Packet Format Filtering Configuration 322
ACL Group Configuration 323
Port Mirroring Configuration 324
Port-Mirroring Configuration 325
Setup 326
Dump 326
Saving the Active Switch Configuration 327
Restoring the Active Switch Configuration 327
The Operations Menu 329
Operations Menu 330
Operations-Level Port Options 332
Operations-Level Port 802.1x Options 333
Operations-Level VRRP Options. 334
Operations-Level IP Options 334
Operations-Level BGP Options 335
Protected Mode Options 336
The Boot Options Menu 339
Boot Menu 340
Scheduled Reboot of the Switch 340
Scheduled Reboot Menu 340
Updating the Switch Software Image 341
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
The Maintenance Menu 349
Maintenance Menu 350
System Maintenance 352

Alteon OS Command Reference
Contents 11BMD00007, November 2007
Forwarding Database Maintenance 353
Debugging Options 354
ARP Cache Maintenance 355
IP Route Manipulation 356
IGMP Maintenance 357
IGMP Group Maintenance 358
IGMP Multicast Routers Maintenance 359
Uuencode Flash Dump 360
TFTP System Dump Put 361
Clearing Dump Information 361
Panic Command 362
Unscheduled System Dumps 362
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
Glossary 383
Index 385

Alteon OS Command Reference
12 Contents BMD00007, November 2007

BMD00007, November 2007 13
Preface
The Alteon OS Command Reference describes how to configure and use the Alteon OS soft-
ware with your 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
14 Preface BMD00007, November 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 15BMD00007, November 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 BMD00007, November 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 17BMD00007, November 2007
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.

Alteon OS Command Reference
18 Preface BMD00007, November 2007

BMD00007, November 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 The Command Line Interface BMD00007, November 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(s) through its internal port 15 (MGT), which you can access through the Ethernet port on
each management module. The factory default settings will permit only management and con-
trol access to the switch module through the 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
Guide publications for more information).
NOTE – Support for both management modules is included within the single management
port (MGT). The MGT port dynamically connects to the active management module.
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