Avaya Bay Command Console User Manual

BayRS Version 14.20 Part No. 308659-14.20 Rev 00

August 2000 4401 Great America Parkway

Santa Clara, CA 95054

Using the Bay Command Console (BCC)

and recommendations in this document are believed to be accurate and reliable, but are presented without express or implied warranty. Users must t ak e full re sponsib ility fo r th eir a pplic atio ns o f a ny products specified in this document. The information in this document is proprietary to Nortel Networks NA Inc.

The software described in this document is furnished under a license agreement and may only be used in accordance with the terms of that license. A summary of the Software License is included in this document.

Trademarks

NORTEL NETWORKS is a trademark of Nortel Networks. Nortel Networks, AN, BCN, BLN, BN, and FRE are registered trademarks and ANH, ARN, ASN, BayRS, BayStack,

BCC, Passport, and System 5000 are trademarks of Nortel Networks. All other trademarks and registered trademarks are t he property of their respective owners.

Restricted Rights Legend

Use, duplication, or disclosure by the United States Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer So ftware clause at DFARS 252.227-7013.

Notwithstanding any other license agreement that may pertain to, or accompany the delivery of, this computer software, the rights of the United States Government regarding its use, reproduction, and disclosure are as set forth in the Commercial Computer Software-Restricted Rights cl ause at FAR 52.227-19.

Statement of Conditions

In the interest of improvi ng internal design, operational fun c tion , an d/o r re lia bi lity, No rtel Ne tworks NA Inc. re se rv es the right to make changes to the products described in this document without notice.

Nortel Networks NA Inc. does not assume any liability that may occur due to the use or application of the product(s) or circuit layout(s) described her ein.

Portions of the code in this software product may be Copyright © 1988, Regents of the University of California. All rights reserved. Redistribution and use in source and binary forms of such portions are permitted, provided that the above copyright notice and this paragraph are duplicated in all such forms and that any documentation, advertising materials, and other materials related to such distribution and use acknowledge that su ch portions of the software were developed by the University of California, Berkeley. The name of the University may not be used to endorse or promote products derived from such portions of the software without specific prior written permission.

SUCH PORTIONS OF THE SOFTWARE ARE PROVIDED “AS IS” AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

In addition, the program and information contained herein are licensed only pursuant to a license agreement that contains restrictions on use and disclosure (that may incorporate by reference certain limitations and notices imposed by third parties).

Nortel Networks NA Inc. Software License Agreement

NOTICE: Please carefully read this license agre ement before copying or using the accompanying software or installing the hardware unit with pre-enabled software (each of which is referred to as “Software” in this Agreement). BY COPYING OR USING THE SOFTWARE, YOU ACCEPT ALL OF THE TERMS AND CONDITIONS OF THIS LICENSE AGREEMENT. THE TERMS EXPRESSED IN THIS AGREEMENT ARE THE ONLY TERMS UNDER WHICH NORTEL NETWORKS WILL PERMIT YOU TO USE THE SOFTWARE. If you do not accept

308659-14.20 Rev 00

these terms and conditions, return the product, unused and in the original shipping container, within 30 days of purchase to obtain a credit for the full purchase price.

1. License Grant. Nortel Networks NA Inc. (“Nortel Networks”) grants the end user of the Software (“Licensee”) a personal, nonex clusive, nontransfera ble lic ense: a) to u se the Softw are eit her on a single compute r or, if applicable, on a single authorized device identified by host ID, for which it was originally acquired; b) to copy the Software solely for backup purposes in support of authorized use of the Software; and c) to use and copy the associated user manual solely in support of authoriz ed use of th e Softwa re b y Licen see. Thi s license applies t o the So ftware o nly and d oes not extend to Nortel Networks Agent software or other Nortel Networks software products. Nortel Networks Agent software or other Nortel Networks software products are licensed for use under the terms of the applicable N ortel Networks NA Inc. Software License Agreement that accompanies such software and upon payment by the end user of the applicable license fees for such software.

2. Restrictions on use; reservation of rights. The Software and user manuals are protected under copyright laws. Nortel Networks and/or its licensors retain all title and ownership in both the Software and user manuals, including any revisions made by Nortel Networks or its licensors. Th e copyright notice must be r e produced and incl uded with any copy of any portion of the Software or user manuals. Licensee may not modify, translate, decompile, disassemble, use for any competitive analysis, reverse engineer, distribute, or create derivative works from the Software or user manuals or any copy , in whole or in part. Except as expressly provided in this Agreement, Licensee may not copy or transfer the Software or user manuals, in whole or in part. The Software and user manuals embody Nortel Networks’ and its licensors’ confidential and propriet ary in telle c tu al pro p erty. Licensee shall not sublicense, assign, or ot he rwise disclose to any third party the Software, or any information about the operation, design, performance, or implementation of the Software and user manuals that is confidential to Nortel Networks and its licensors; however, Licensee may grant permission to its consultants, subcontractors, a nd agents to use the Softw are at Licensee’s facility, provided they have agreed to use the Software only in accordance with the terms of this license.

3. Limited warranty . Nortel Networks warrants each item of Software, as delivered by Nortel Networks and properly installed and operated on Nortel Networks hardware or other equipment it is originally licensed for, to function substantially as described in its accompanying user m anual during its warranty period , which begins on the date Software is first shipped to Licensee. If an y item of S oftware f ails to so function d uring its w arranty period, as the sole remedy Nortel Networks will at its discretion provide a suitable fix, patch, or workaround for the problem that may be included in a future Software release. Nortel Networks further warrants to Licensee that the media on which the Software is provided will be free from defec ts in materials and wo rkman ship under no rmal use for a peri od of 90 da ys from the date Software is first shipped to Licensee. Nortel Networks will replace defective media at no charge if it is returned to Nortel Netw orks during the warranty period along with proof of the date of sh ipment. This warrant y does not apply if the media has been damaged as a result of accident, misuse, or abuse. The Licensee assumes all responsibility for selection of the Software to achieve Licensee’s intended results and for the installation, use, and results obtained from the Software. Nortel Networks does not warrant a) that the functions contained in the software will meet the Licensee’s requirements, b) that the Software will operate in the hardware or software combinations that the Licensee may select, c) that the operation of the Software will be uninterrupted or error free, or d) that all defects in the operation of the Softw are will be corrected . Nortel Network s is not obligate d to remedy an y Software defect that cannot be reproduced with the latest Software release. These warranties do not apply to the Software if it has been (i) altered, except by Nortel Networks or in accordance with i ts instructions; (ii) used in conj unction with another vendor’s product, resulting in the de fect; or (iii) damaged by improper environment, abuse, misuse , accident, or negligence. THE FOREGOING WARRANTIES AND LIMITATIONS ARE EXCLUSIVE REMEDIES AND ARE IN LIEU OF ALL OTHER WARRANTIES EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITA TION ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Licensee is responsible for the security of its own data and information and for maintaining adequate procedures apart from the Software to reconstruct lost or altered files, data, or programs.

4. Limitation of liability. IN NO EVENT WILL NORTEL NETWORKS OR ITS LICENSORS BE LIABLE FOR ANY COST OF SUBSTITUTE PROCUREMENT; SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES; OR ANY DAMAGES RESULTING FROM INACCURATE OR LOST DATA OR LOSS OF USE OR PROFITS ARISING OUT OF OR IN CONNECTION WITH THE PERFORMANCE OF THE SOFTWARE, EVEN IF NORTEL NETWORKS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN NO EVENT

308659-14.20 Rev 00

iii

SHALL THE LIABILITY OF NORTEL NETWORKS RELATING TO THE SOFTWARE OR THIS AGREEMENT EXCEED THE PRICE PAID TO NORTEL NETWORKS FOR THE SOFTWARE LICENSE.

5. Government Licensees. This provision applies to a ll Softwa re and docum entation acquired d irectly or i ndirectly by or on behalf of the United States Government. The Software and documentation are commercial products, licensed on the open market at market prices, and were developed entirely at private expense and without th e use of any U.S. Government funds. The license to the U.S. Government is granted only with restricted rights, and use, duplication, or disclosure by the U.S. Government is subject to the restrictions set forth in subparagraph (c)(1) of the Commercial Computer Software––Restricte d Rig hts cla u se o f FAR 52.227-19 and the limitations set o ut in this license for ci vilian agencies, and subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause of DFARS

252.227-7013, for agencies of t he Department of Defense or their successors, whichever is applicable.

6. Use of Software in the European Community. This provision applies to all Software acquired for use within the European Community. If Licensee uses the Software within a country in the European Community, the Software Directive enacted by the Council of European Communities Directive dated 14 May, 1991, will apply to the examination of the Software to facilitate interoperability. Licensee agrees to notify Nortel Networks of any such intended examination of the Software an d may procure support and assista nce from Nortel Networks.

7. Term and termination. This license is effective until terminated; however, all of the restrictions with respect to Nortel Networks’ copyright in the Software and user manuals will cease being effective at the date of expiration of the Nortel Networks copyright; those restrictions relating to use and disclosure of Nortel Networks’ confidential information shall continue in effect. Licensee may terminate this license at any time. The license will automatically terminate if Licensee fails to comply with any of the terms and conditions of the license. Upon termination for any reason, Licensee will immediat ely destroy or return to Nortel Networks the Software, user manuals, and all copies. Nortel Networks is not liable to Licensee for damages in any form solely by reason of the termination of this license.

8. Export and Re-export. Licensee agrees not to export, directly or indirectly, the Software or related technical data or information without first obtaining any required export licenses or other governmental approvals. Without limiting the foregoing, Licensee, on behalf of itself and its subsidiaries and affiliates, agrees that it will not, without first obtaining all export licenses and approvals required by the U.S. Government: (i) export, re-export, transfer, or divert any such Software or technical data, or any direct product thereof, to any country to which such exports or re-exports are restricte d or em b argoed under Un ite d Sta t e s e xport control law s an d r egulations, or to any national or resident of such restricted or embargoed countries; or (ii) provide the Software or related technical data or information to any military end user or for any military end use, including the design, development, or production of any chemical, nuclear, or biological weapons.

9. General. If any provision of this Agreement is held to be invalid or unenf orceable by a court of competent jurisdiction, the remainder of the provisions of this Agreement shall remain in full force and effect. This Agreement will be governed by the laws of the state of California.

Should you have any questions concerning this Agreement, contact Nortel Netw orks, 4401 Great America Parkway, P.O. Box 58185, Santa Clara, California 95054-8185.

LICENSEE ACKNOWLEDGES THAT LICENSEE HAS READ THIS AGREEMENT, UNDERSTANDS IT, AND AGREES TO BE BOUND BY ITS TERMS AND CONDITIONS. LICENSEE FURTHER AGREES THAT THIS AGREEMENT IS THE ENTIRE AND EXCLUSIVE AGREEMENT BETWEEN NORTEL NETWORKS AND LICENSEE, WHICH SUPERSEDES ALL PRIOR ORAL AND WRITTEN AGREEMENTS AND COMMUNICATIONS BETWEEN THE PARTIES PERTAINING TO THE SUBJECT MATTER OF THIS AGREEMENT. NO DIFFERENT OR ADDITIONAL TERMS WILL BE ENFORCEABLE AGAINST NORTEL NETWORKS UNLESS NORTEL NETWORKS GIVES ITS EXPRESS WRITTEN CONSENT, INCLUDING AN EXPRESS WAIVER OF THE TERMS OF THIS AGREEMENT.

308659-14.20 Rev 00

Preface

Before You Begin .............................................................................................................xiii

Text Conventions .............................................................................................................xiv

Acronyms ........................... .......................... .......................... ......................... .................xvi

Hard-Copy Technical Manuals ........................................................... ....... ...... ....... ...... ...xvii

How to Get Help ............................................................................................................xviii

Chapter 1 Overview of the BCC

Introduction ........................ ............................................. ............................................. ... 1-2

Platform Requirements ............................................. ...... ....... ...... ...... ....... ...... ....... ...... ...1-3

Number of BCC Sessions ...............................................................................................1-3

Multilevel Access ............................................................................................................1-3

Terminology and Concepts .............................................................................................1-4

Configuration Hierarchy ............................................................................................1-4

Configuration Context ..............................................................................................1-6

Objects and Instances ..............................................................................................1-8

BCC Instance Identifier ......................................................................................1-8

Global (Box-Wide) Objects ............................................. ...... ....... ......................1-8

Physical Device Objects ....................................................................................1-9

Parameters ......................................................... ...................................... .............. 1-11

Required ..........................................................................................................1-11

Derived ............................................................................................................1-11

Optional ...........................................................................................................1-11

Chapter 2 Getting Started with the BCC

Entering and Exiting the BCC Interface ....................................................................... ...2- 2

Displaying Your Location in Configuration Mode ............................................................2-4

308659-14.20 Rev 00

Navigating in Configuration Mode ...................................................................................2-4

Navigating with the back Command .........................................................................2-4

Navigating with Configuration Commands ...............................................................2-5

Moving Back One or More Levels ......................................................................2-5

Moving Back to Root Level ................................................................................2-6

Moving Forward One or More Leve ls .................................................................2-6

Moving to Any Context in the Device Configuration ...........................................2-7

Displaying Configuration Data ........................................................................................2-9

Displaying Current/Active Configuration Data ..........................................................2-9

Displaying Configured Objects ........................................................................2-12

Displaying Configured Parameter Values ........................................................2-18

Displaying Configuration Choices ..........................................................................2-22

Displaying the Total Device Configuration Tree (All Available Choices) ...........2-23

Displaying Choices Available from the Current Context ..................................2-24

Displaying Choices Available at All Subcontext Levels ....................................2-24

Displaying Parameter Definitions ...........................................................................2-25

Saving Displayed Configuration Data .............................................................. ...... .2-28

Displaying Help on System Commands .......................................................................2-28

Displaying Help on show Commands ...........................................................................2-29

Chapter 3 Entering Commands and Using Command Files

Entering Commands .......... ...... ....... ...... ....... ...... ....................................... ...... ....... ...... ...3-2

Using Command Abbreviations ................................................................................3-2

Recalling Commands ...............................................................................................3-2

Using Command Completion ...................................................................................3-3

Editing Command Lines .............................................................. ....... ......................3-3

Entering Multiple Command s on a Line ................................ ...................................3-4

Continuing a Command Line ....................................................................................3-5

System Commands ................. ....... ...... ....... ...... ....... ...... ....... ...... ...... .............................3-6

Configuration Command Syntax .....................................................................................3-6

Command Syntax Requirements .............................................................................3-6

Using Basic (Full) Syntax .........................................................................................3-7

Using Default Syntax ................................................................................................3-8

Using Abbreviated Syntax ........................................................................................3-9

308659-14.20 Rev 00

Specifying Parameter Values ...................................................................................3-9

Required, Derived, and Other Parameters ......................................................3-10

Specifying Multiple Parameter-Value Pairs ......................................................3-10

Specifying Multiple Values for One Pa rameter ................................................3-10

Parameter Range Validation ............................................................................3-11

Specifying Name or String Values ...................................................................3-11

Disabling, Reenabling, and Deleting a Configured Object .....................................3-12

Creating and Using BCC Files ......................................................................................3-13

Saving Commands and Displays to a File on a Workstation ..................................3-13

Saving Configuration Commands to a File on a Device .........................................3-14

Adding Comments to a Command File ..................................................................3-14

Importing Configuration Commands from a File ....................................................3-15

Saving the Active Configuration as a Bootable File ...............................................3-16

Chapter 4 Tutorial: Configuring a Nortel Networks Router

Creating and Modifying a Device Configuration .............................................................4-2

Sample Router Configuration .........................................................................................4-2

Disabling a Configured Object . ....... ...... ....... ...... ....... ...... ....... ...................................... .4-15

Enabling a Configured Object .......................................................................................4-16

Deleting a Configured Object .......................................................................................4-17

Appendix A Multilevel Access

Introduction ........................ ............................................. ............................................. .. A-2

Multilevel Access Login ................................................................................................. A-2

How Access Is Granted ................................................................................................. A-2

Access Privileges .......................................................................................................... A-3

Access Security ............................................................................................................. A-4

Sharing Access Profiles ................................................................................................. A-4

Configuring Multilevel Access ........................................................................................ A-4

Configuring Access ................................................................................................. A-5

Configuring User ..................................................................................................... A-6

Configuring Group ................................................................................................... A-7

Configuring Audit ..................................................................................................... A-8

308659-14.20 Rev 00

vii

Disabling or Deleting Users and Groups ....................................................................... A-8

BCC Lock Messages ..................................................................................................... A-9

Appendix B System Commands

Appendix C TCL Support

Appendix D System show Commands

show access .................................................................................................................. D-2

show console ................................................................................................................. D-4

show hardware .............................................................................................................. D-7

show interface ................................................................................................................D-9

show process ............................................................................................................... D-10

show system ................................................................................................................ D-13

Appendix E Syntax for Module Location

Appendix F BN Console Slot Election

Introduction ........................ ............................................. ............................................. ...F-2

Using the BCC to Customize Console Slot Election .......................................................F-2

Disabling and Reenabling Console Slot Election ............................................................F-3

Console Slot Election Error Message .............................................................................F-4

Appendix G BCC Board Types

Introduction ........................ ............................................. ............................................. .. G-2

AN and ANH Board Types .............................................................................................G-2

ARN Board Types ..........................................................................................................G-5

ASN Board Types ..........................................................................................................G-6

BLN and BCN Board Types ...........................................................................................G-7

Passport 2430 Board Types ...........................................................................................G-9

Passport 5430 Board Types ...........................................................................................G-9

System 5000 Board Types ...........................................................................................G-10

Index

viii

308659-14.20 Rev 00

Figures

Figure 1-1. Technician Interface and the BCC Interface .............................................1-2

Figure 1-2. Sample BCC Configuration ......................................................................1-5

Figure 1-3. Configuring IP and RIP on an Ethernet Interface ....................................1-6

Figure 1-4. Location or Context in Configuration Mode ..............................................1-7

Figure 2-1. Moving Away from Root Level ..................................................................2-7

Figure 2-2. Navigating to an Object in the Configuration ...........................................2-8

Figure 2-3. Navigating with the BCC Recursive Search Feature ...............................2-9

Figure 2-4. Objects You Can Configure at the Next (Subcontext) Level ...................2-24

Figure 4-1. Sample BCC Configuration (BCN Router) ...............................................4-3

Figure 4-2. Typical BCC Configuration Cycle .............................................................4-4

Figure A-1. Configurable Multilevel Access Objects .................................................. A-5

308659-14.20 Rev 00

Tables

Table 2-1. Help for BCC System Commands ........................................... ....... ...... .2 -28

Table 3-1. Keystrokes for Editing BCC Command Lines ...........................................3-3

Table 3-2. BCC Commands for Disabling, Reenabling, and Deleting .....................3-12

Table A-1. Access Parameter Options ..................................................................... A-5

Table A-2. User Parameter Options ......................................................................... A-6

Table A-3. Group Parameter Options ....................................................................... A-7

Table A-4. Audit Parameter Options ......................................................................... A-8

Table B-1. System Commands ................................................................................. B-2

Table E-1. Syntax for Specifying Module Location per Device ................................. E-1

Table G-1. BCC Board Types: AN and ANH Modules ..............................................G-2

Table G-2. BCC Board Types: ARN Modules ...........................................................G-5

Table G-3. BCC Board Types: ASN Modules ...........................................................G-6

Table G-4. BCC Board Types: BLN and BCN Modules ............................................G-7

Table G-5. BCC Board Types: Passport 2430 Modules ............................................G-9

Table G-6. BCC Board Types: Passport 5430 Modules ............................................G-9

Table G-7. BCC Board Types: System 5000 Modules ............................................G-10

308659-14.20 Rev 00

The Bay Command Console (BCC™) is a command-line interface for configuring Nortel Networks Nortel Networks AN 2430, Passport 5430, and System 5000 use the BCC.

Before You Begin

Before using this guide, you must complete the following procedures. For a new router:

Preface

™

devices. If you are responsible for configuring and managing

, ANH™, ARN™, ASN™, BN® (BCN® and BLN®), Passport™

™

routers, read this guide to learn how to

• Install the router (see the installation guide that came with your router).

• Connect the router to the network and create a pilot configuration file (see

Make sure that you are runni ng the lates t versio n of Nortel Netw orks BayRS Site Manager software. For information about upgrading BayRS and Site Manager, see the upgrading guide for your version of BayRS.

308659-14.20 Rev 00

Quick-Starti ng Router s , Conf igur ing BaySt ac k Remote Acc ess , or Connecting ASN Routers to a Network).

™

and

xiii

Using the Bay Command Console (BCC)

Text Conventions

This guide uses the following text conventions:

angle brackets (< >) Indicate that you choose the text to enter based on the

description inside the brackets. Do not type the brackets when entering the command.

Example: If the command syntax is:

ping

<ip_address>

ping 192.32.10.12

, you enter:

bold text

Indicates command names and options and text that you need to enter. Example: Enter

Example: Use the

show ip {alerts | routes}

dinfo

command.

braces ({}) Indicate required elements in syntax descriptions

where there is more than one option. You must choose only one of the options. Unless explicitly instructed to do so, do not type the braces when entering the command.

Example: If the command syntax is:

show ip {alerts | routes} show ip alerts or show ip routes

, you must enter either:

, but not both.

If the command sets a parameter value consisting of multiple elements, you must type the braces as part of the command if instructed to do so. Example:

severity-mask {fault warning info}

brackets ([ ]) Indicate optional elements in syntax descriptions. Do

not type the brackets when entering the command.

xiv

Example: If the command syntax is:

show ip interfaces [-alerts] show ip interfaces

, you can enter either:

show ip interfaces -alerts

308659-14.20 Rev 00

Preface

ellipsis points (. . . ) Indicate that you repeat the last element of the

command as needed. Example: If the command syntax is:

ethernet/2/1 [ ethernet/2/1 and as many parameter-value pairs as

] . . . , you enter

needed.

italic text Indicates new terms, book titl es, and variables in

command syntax descri pti ons . W he re a variable is t wo or more words, the words are connected by an underscore.

Example: If the command syntax is:

show at

valid_route

<valid_route>

is one variable and you substitute one value

for it.

screen text Indicates system output, for example, prompts and

system messages. Example:

Filters

Set Nortel Networks Trap Monitor

separator ( > ) Shows menu paths.

Example: Protocols > I P ide nti fies the I P opt ion on the Protocols menu.

vertical line (

) Separates choices for command keywords and

arguments. Enter only one of the choices. Do not type the vertical line when entering the command.

Example: If the command syntax is:

show ip {alerts | routes}, you enter either: show ip alerts or show ip routes, but not both.

308659-14.20 Rev 00

Using the Bay Command Console (BCC)

Acronyms

This guide uses the following acronyms:

ARP Address Resolution Protocol ATM asynchronous transfer mode BofL Breath of Life DCM data collection module DRAM dynamic random access memory FDDI Fiber Distributed Data Interface GAME Gate Access Management Entity IP Internet P rotocol IPX Internetwork Packet Exchange ISDN Integrated Services Digital N etwork LAN local area network MIB Management Information Base

xvi

MAC media access control NVFS nonvolatile file system NVRAM nonvolatile random access memory OSPF Open Shortest Path First PCI peripheral component interconnect PMC PCI mezzanine card RADIUS Remote Access Dial-In User Services RIP Routing Information Protocol SNMP Simple Network Management Protocol SRM-L system resource module-link TCL Tool Command Language TCP/IP Transmission Control Protocol/Internet Protocol TFTP Trivial File Transfer Protocol

308659-14.20 Rev 00

VNR Virtual Network Routing WAN wide area network

Hard-Copy Technical Manuals

For more information about using the BCC to configure or monitor (show) behavior of a specific BayRS service, refer to the latest edition of the Task Map.

You can print selected technical manuals and release notes free, directly from the Internet. Go to support.baynetworks.com/library/tpubs/. Find the product for which you need documentation. Then locate the specific category and model or version for your hardw are or soft ware product . Usi ng Adobe Ac robat Re ader, you can open the manuals and releas e notes, search for the sections you ne ed, and print them on most standard printers. You can download Acrobat Reader free from the Adobe Systems Web site, www.adobe.com.

You can purchase selected documentation sets, CDs, and technical publications through the collateral catalog. The catalog is located on the World Wide Web at

support.baynetworks.com/catalog.html and is divided into sections arranged

alphabetically:

Preface

• The “CD ROMs” section lists available CDs.

• The “Guides/Books” section lists books on technical topics.

• The “Technical Manuals” section lists available printed documentation sets.

308659-14.20 Rev 00

xvii

Using the Bay Command Console (BCC)

How to Get Help

If you purchased a service contract for your Nortel Networks product from a distributor or authorized reseller, contact the technical support staff for that distributor or reseller for assistance.

If you purchased a Nort el Net wor ks ser vice pr ogram, c ontact one of the f ollowing Nortel Networks Technical Solutions Centers:

Technical Solutions Center Telephone Number

Billerica, MA 800-2LANWAN (800-252-6926) Santa Clara, CA 800-2LANWAN (800-252-6926) Valbonne, France 33-4-92-96-69-68 Sydney, Australia 61-2-9927-8800 Tokyo, Japan 81-3-5740-1700

xviii

308659-14.20 Rev 00

Chapter 1

Overview of the BCC

This chapter provides information about the following topics:

Topic Page

Introduction 1-2 Platform Requirements 1-3 Number of BCC Sessions 1-3 Multilevel Access 1-3 Terminology and Concepts 1-4

308659-14.20 Rev 00

1-1

Using the Bay Command Console (BCC)

Introduction

The BCC is a command-line interface for configuring Nortel Networks devices. After logging on to a de vice , you access the BCC by entering t he the Technician Interface prompt (Figure 1-1

Technician

Interface

bcc

command at

Figure 1-1. Technician Interface and the BCC Interface

Access the BCC

BCC

BCC0001B

From the BCC prompt, you can:

• Execute any system command not classified as “Technician Interface only” (see Appendix B, “System Commands

”).

• Execute configurat ion commands to perfor m tasks such as c reating or de leting IP interfaces on the router. Enter BCC configuration mode by entering the

config

command at the BCC prompt.

1-2

Note:

For a list of services you can configure using the BCC, see the Release

Notes. You can obtain a complete hierarchical listing of all objects

configurable on a device by entering the

help tree -all

command at any BCC

prompt.

308659-14.20 Rev 00

Platform Requirements

The BCC runs on AN, ANH, ARN, ASN, System 5000, and BN platforms including ARE, FRE

• 16 MB of dynamic RAM (DRAM)

• 2 MB of free memory space available when you start the BCC

If you try to start the BCC with insufficient DRAM or free memory on a slot, the BCC returns an error message. In that case, use Site Manager instead of the BCC.

, and FRE-2 processor modules. Each slot must have:

Number of BCC Sessions

You can open one BCC session per slo t i n r ead- wri t e (configurati on) mode. Ot her users can open additional BCC sessions in re ad- onl y (nonc onfiguration) mode on the same slot, depending on available memory. Each BCC session is mutually exclusive. If you make a change during a BCC session in read-write mode, this change does not appear in other BCC sessions.

Overview of the BCC

Multilevel Access

Multilev el access adds a thir d login le v el, that of Oper ator , to the e xistin g Manager and User login levels of the BCC. With multilevel access, multiple users (each with a distinct user name and password) can access the router simultaneously.

Multilevel access allows you to:

• Add multiple user names, passwords, and access privileges to the router

• Manage the distrib u t io n of user names, p asswords, and a ccess privileges from the BCC

• Vie w event logs sho wi ng each BCC command iss ued and t he use r resp onsibl e for issuing the command

For more information on how to configure and use multilevel access features, refer to Appendix A, “Multilevel Access privilege level required to execute them, refer to Appendix B, “System

Commands.”

308659-14.20 Rev 00

.” For a list of system commands and the

1-3

Using the Bay Command Console (BCC)

Terminology and Concepts

This sectio n describes key terms and concepts of the BCC interface.

Configuration Hierarchy

The BCC configuration hierarchy begins at a root-level object, called box for AN/ANH, ARN, and BN platforms, and stack for ASN and System 5000 platforms. Under the root-level object are branch objects such as interfaces and protocols that fan out from root level in a tree hierarchy.

You use the

help tree -all

show config -all

and

commands to display the

configuration hierarchy of a Nortel Networks router:

•The

help tree -all

command displays the hierarchy of every object you can configure. (These are the configuration choices you can make. These are not objects already configured.)

•The

show config -all

command displays the hierarchy of objects you have

actually configured.

Figure 1-2

illustrates a sample BCC configuration for an AN, BN, or ARN router.

1-4

308659-14.20 Rev 00

box

(root)

Overview of the BCC

ospf

(protocol)

snmp

(protocol)

telnet

(protocol)

tftp

(protocol)

INTERFACE-SPECIFIC OBJECTS

(Services supported on a specific slot)

ethernet/2/1

(interface)

ethernet/2/2

(interface)

arp

(protocol)

rip

(protocol)

BOX-WIDE/GLOBAL OBJECTS (Services supported on all slots)

ip/1.2.3.4/255.0.0.0

(protocol)

ospf/1.2.3.4

(protocol)

arp/1.2.3.4/1

(protocol)

Figure 1-2. Sample BCC Configuration

308659-14.20 Rev 00

serial/3/1

(interface)

BCC0012C

1-5

Using the Bay Command Console (BCC)

You use BCC commands to create new objects and to modify or delete objects in an existing configuration hierarchy. You begin at root level in BCC configuration mode and navigate to objects in the device configuration tree.

For exa mple, on a BL N rout er, you can use BCC commands to add a ne w phys ical interface (such as Ethernet) on box, add IP to the Ethernet interface, and th en add RIP to IP on that interface. Figure 1-3 to build this configuration.

box

box# ethernet/2/1

Ethernet

Slot 2

Connection 1

ethernet/2/1# ip address 1.2.3.4 mask 255.0.0.0

Address 1.2.3.4

Mask 255.0.0.0

shows the seq uence of commands ne cessary

rip/1.2.3.4

Figure 1-3. Configuring IP and RIP on an Ethernet Interface

Configuration Context

Your working location within the BCC configuration tree is referred to as the context. Just as a UNIX file system has a current working directory within which you can add, modify, or delete files, the BCC configuration tree has a current working context, within which you can add, modify, disable, reenable, or delete objects.

1-6

ip/1.2.3.4/255.0.0.0# rip

rip/1.2.3.4#

BCC0017A

308659-14.20 Rev 00

Overview of the BCC

The BCC displays the cont ext of an object in terms of its l ocation a long a pat h that begins at the root level of the device configuration tree. Each semicolon in the path marks a transition from one level to the next branch level in the device configurat ion tree. Using a semic olon is als o equi v ale nt to pressi ng [Retu rn] at the end of a command, effectively starting a new command line.

For example , if you co nf igur e an IP in te rf ace (add ress 1.2 .3.4, mask 255 .0.0.0) on ethernet/2/1 of a BLN router, the BCC displays its location as box; ethernet/2/1; ip/1.2.3.4/255.0.0.0 (Figure 1-4

box

box# ethernet/2/1

ethernet/2/1

ethernet/2/1# ip address 1.2.3.4 mask 255.0.0.0

Figure 1-4. Location or Context in Configuration Mode

308659-14.20 Rev 00

ip/1.2.3.4/255.0.0.0

ip/1.2.3.4/255.0.0.0#

BCC0017B

1-7

Using the Bay Command Console (BCC)

Objects and Instances

In BCC terminology, configurable entities are r eferr ed to as ob jects of a pa rtic ular class, each of which constitutes an instance:

•An object is a configurable physical or logical entity such as a physical interface or a pr ot ocol on an interface. Every configurabl e object belongs to a specific cla s s that defines its characteristics.

•A class is a template for a configurable object (such as Ethernet or the protocol IP). When you add a new object to the configuration of a device, the BCC creates a copy (instance) of the appropriate template.

•An instance is an object uniquely identifiable within the total device configuration. Each instance is identified by its BCC instance identifier.

BCC Instance Identifier

A BCC instance identifier uniquely identifies a single instance of an object configured on a de vi ce. Th e BCC in st ance I D consi sts typic ally of t he name of t he object, combined with the values you specify for its required parameter s. For example, the BCC insta nce ID for an Ether net i nterf ac e on a BN pl atfor m consis ts

ethernet/

of Ethernet interface on an ASN platform consists of

ethernet/

, as in

ethernet/2/1

ethernet/1/2/2

, as in

; the BCC in stance ID for an

1-8

A configurable object may also have required parameters that do not become part of its BCC instance ID. For example, the global OSPF object has a required router-id parameter that does not become part of the instance ID.

Each object has it s own requirements for unique instance identificat ion within the total device configuration.

Global (Box-Wide) Object s

Global (box-wide) objects provide services uniformly to all slots of a network device. Examples include global IP, BGP, TCP, SNMP, FTP, TFTP, and Telnet. Some protocols, such as IP, RIP, and OSPF, have global and interface-level objects.

308659-14.20 Rev 00

Overview of the BCC

Physical Device Objects

The following sections provide BCC terms for the physical device.

Box and Stack

The BCC uses the term box or st ack to identify the root level of the BCC configuration tree for a Nortel Networks device. Every box or stack object has a type parameter. The value assigned to the type parameter identifies the type of Nortel Networks device chassis:

type

Value Router Model

an AN/ANH arn ARN asn ASN freln BLN frecn BCN lite Passport 2430 fbr4slot Passport 5430 sys5000 System 5000

Board

The BCC uses the term board to identify any logic or circ uit board in a Nortel Networks device. Each board typically occupies a slot in a network device. On some Nortel Networks products, one board may contain another board such as an RMON data collection module (DCM). All board objects have a type parameter that identifies its hardware type. For example, “qenf” is the value of the type parameter for a Quad Ethernet with Hardware Filters board.

Note:

for any board object, see the Release Notes.

308659-14.20 Rev 00

For board descriptions based on the literal value of the type parameter

1-9

Using the Bay Command Console (BCC)

Module

The BCC uses the term module to identify network media-specific I/O modules (such as, Ethernet and token ring). Each module has one or more connectors for attachment to a physical network transmission medium.

Slot

The BCC uses the term slot to identify the location, as well as a physical and electrical means , for attac hing boa rds to l ogic an d power connection s a vailable on the device chassi s. Note the following:

• Multislot devices such as the BLN or BCN router accommodate a system module (SRM-L) in one slot, and one link module in each remaining slot.

• Single-slot devices such as the AN, ANH, ASN, and ARN routers accommodate one base module (slot 1), which may be augmented by one or two adapter modules and one expansion module.

Connector

The BCC uses the term connector to identify the physical and electrical means to interconnect a network device (slot or module) directly or indirectly to a physical network transmission medium.

1-10

Line

The BCC uses the term line to identify the physical (and in some cases, logical) circuit identified typically by means of a slot, connector, interface type (ethernet, sync, fddi, and so on), and, where applicable, a channel number (such as with T1/E1 interface types).

Port

The BCC uses the term port to identify an interface object defined by its type (for example, an Ethernet port) and location (slot and connector) within a network device. On a network device, a port is also a logical point of termination for data sent or received by a specific protocol or application.

308659-14.20 Rev 00

Parameters

Overview of the BCC

Interface

The BCC uses the term interface to identify circuitry and digital logic associated with the interconnection between a physical network medium (such as Ethernet) and a higher-layer protocol entity (such as IP).

Note:

A logical interface is an ad dressable entity for originating a nd

terminating connections across an IP network.

A parameter is an attribute (or property) of a configurable object. Parameters can be classified as one of the following:

•Required

• Derived

• Optional

Required

For any BCC object, required parameters are a minimum set of parameters for which the BCC requires you to supply values. For example, the required parameters of a physical port are

Derived

Derived parameters are parameters for which the BCC supplies a value. For example, a derived parameter of the global OSPF object is the BCC derives a value for configured on the device.

Optional

Optional parameters are par ameters for wh ich you ca n specif y custo mize d v a lues, replacing any default values set by the system. For example, an optional parameter of an Ethernet interface is value of 5 (5 retries), but you can change this to another numeric value.

308659-14.20 Rev 00

slot

router-id

bofl-retries

connector

and

router-id

. In this case,

from the add ress of the first IP interface

. This parameter normally has a default

1-11

+ 123 hidden pages

Avaya Bay Command Console User Manual

Using the Bay Command Console (BCC)

Contents

Figures

Tables

Before You Begin

Preface

Text Conventions

Acronyms

Hard-Copy Technical Manuals

How to Get Help

Introduction

Platform Requirements

Number of BCC Sessions

Multilevel Access

Terminology and Concepts

Configuration Hierarchy

Configuration Context

Objects and Instances

BCC Instance Identifier

Global (Box-Wide) Object s

Physical Device Objects

Parameters

Required

Derived

Optional