BayRS Version 14.00Part No. 308659-14.00 Rev 00September 19994401 Great America ParkwaySanta Clara, CA 95054Using the Bay Command Console (BCC)
Using the Bay Command Console (BCC)A-8308659-14.00 Rev 00Configuring AuditThe audit log includes the name of the command, the name of the user that is
Multilevel Access308659-14.00 Rev 00A-9 BCC Lock MessagesMultilevel access includes messages that identify which user has exclusive read-write access
Using the Bay Command Console (BCC)A-10308659-14.00 Rev 00This message appears when a Site Manager user attempts to open a dynamic configuration sessi
308659-14.00 Rev 00B-1 Appendix BSystem CommandsThe BCC supports the system commands listed in Table B-1. For more detailed information about any comm
Using the Bay Command Console (BCC)B-2308659-14.00 Rev 00Table B-1. System CommandsCommand PurposeLogin/Access PrivilegesManager Operator User?<com
System Commands308659-14.00 Rev 00B-3 compact <volume>: Compact existing files into a contiguous address space on a volume, and compact all unus
Using the Bay Command Console (BCC)B-4308659-14.00 Rev 00date [<mm/dd/yy>] [<hh:mm:ss>] [{+|-}<hh:mm>]Display or update the system t
System Commands308659-14.00 Rev 00B-5 getcfg(Technician Interface, AN routers only)Display network boot parameters. (Display the current parameter set
Using the Bay Command Console (BCC)B-6308659-14.00 Rev 00help [<command> | -all](Technician Interface only)The help command, entered without arg
System Commands308659-14.00 Rev 00B-7 log [<vol>:<logfile>] [-d<date>] [-t<time>] [-e“<entity>” ] [-f<severity>] [
308659-14.00 Rev 00xiFiguresFigure 1-1. The Technician Interface and the BCC Interface ...1-1Figure 1-2. Sample BCC
Using the Bay Command Console (BCC)B-8308659-14.00 Rev 00mset {<obj_name>|<obj_id>}.{<attr_name>|<attr_id>}.{<inst_id>}
System Commands308659-14.00 Rev 00B-9 restart [<slot_ID>] Restart the GAME image on the specified slot. If the slot ID argument is absent, the G
Using the Bay Command Console (BCC)B-10308659-14.00 Rev 00telnet [-d] [-e <escape_char>] [<host_ip> [<port>]](Technician Interface
308659-14.00 Rev 00C-1 Appendix CTCL SupportThe BCC supports the following subset of Tool Command Language (TCL) scripting commands on the router plat
308659-14.00 Rev 00D-1 Appendix DSystem show CommandsThis appendix describes the following BCC system show commands.Topic Pageshow accessD-2show conso
Using the Bay Command Console (BCC)D-2308659-14.00 Rev 00show accessThe show access <option> command displays information about multiuser access
System show Commands308659-14.00 Rev 00D-3 lockDisplays information about the lock status of the user currently in configuration mode. The table inclu
Using the Bay Command Console (BCC)D-4308659-14.00 Rev 00show consoleThe show console <option> commands display console port configuration and s
System show Commands308659-14.00 Rev 00D-5 Parity Serial port’s current parity setting.Stop Bits Number of stop bits in the serial port’s configuratio
Using the Bay Command Console (BCC)D-6308659-14.00 Rev 00statsDisplays login information and console port error statistics.The table includes the foll
System show Commands308659-14.00 Rev 00D-7 show hardwareThe show hardware <option> commands display information about router hardware.The show h
Using the Bay Command Console (BCC)D-8308659-14.00 Rev 00memory [<slot>]Displays memory configuration and capacity information about all slots o
System show Commands308659-14.00 Rev 00D-9 show interfaceThe show interface command displays information about all media-specific interfaces configure
Using the Bay Command Console (BCC)D-10308659-14.00 Rev 00show processThe show process <option> commands display information about the use of re
System show Commands308659-14.00 Rev 00D-11 cpu [detail | total]Displays the CPU usage in hundredths of seconds and the percentage of total CPU time u
Using the Bay Command Console (BCC)D-12308659-14.00 Rev 00memory [detail | total]Displays the number of bytes and the percentage of memory used by all
System show Commands308659-14.00 Rev 00D-13 show syslogThe show syslog <option> commands let you obtain Syslog statistical data from the managem
Using the Bay Command Console (BCC)D-14308659-14.00 Rev 00log-hostDisplays statistics associated with any Syslog log-host object configured on the dev
System show Commands308659-14.00 Rev 00D-15 filterDisplays statistics of entity filters configured on the router. This command supports the following
308659-14.00 Rev 00xiiiTablesTable 2-1. Help for BCC System Commands ...2-26Table 3-1. Keystrok
Using the Bay Command Console (BCC)D-16308659-14.00 Rev 00show systemThe show system <option> commands display information about the overall sys
System show Commands308659-14.00 Rev 00D-17 informationDisplays general system information (system name, contact, node location, image data, MIB versi
Using the Bay Command Console (BCC)D-18308659-14.00 Rev 00tasksDisplays the number of tasks scheduled to run on all slots. This number is highly volat
308659-14.00 Rev 00E-1 Appendix ESyntax for Module LocationTable E-1 lists the syntax for specifying the physical location of a module for each Nortel
Using the Bay Command Console (BCC)E-2308659-14.00 Rev 00ARN<interface> <slot> <connector>•<interface> = interface type: ether
Syntax for Module Location308659-14.00 Rev 00E-3 BN<interface> <slot> <connector>•<interface> = interface type: ethernet, toke
308659-14.00 Rev 00F-1 Appendix FBN Console Slot ElectionThe BCC console slot election feature allows you to specify slots eligible to run the router
Using the Bay Command Console (BCC)F-2308659-14.00 Rev 00Using the BCC to Customize Console Slot ElectionTo limit the choice of slots considered by th
BN Console Slot Election308659-14.00 Rev 00F-3 4.Enter the following command:console-slot-mask noneIf you want to permanently disable the console slot
308659-14.00 Rev 00G-1 Appendix GConfiguring Syslog ServicesThis appendix provides information on configuring and managing Syslog services. It include
Using the Bay Command Console (BCC)G-2308659-14.00 Rev 00Figure G-1. Syslog and syslogd OperationsSyslog software:• Polls slot logs• Retrieves event
Configuring Syslog Services308659-14.00 Rev 00G-3 On each slot, Syslog performs the following functions:• Polls the local events log buffer to retriev
Using the Bay Command Console (BCC)G-4308659-14.00 Rev 00You configure entity filters on each router to capture only the messages that you specify.You
Configuring Syslog Services308659-14.00 Rev 00G-5 Syslog Message FormatSyslog running on each slot maps filtered event messages into Syslog message fo
Using the Bay Command Console (BCC)G-6308659-14.00 Rev 00UDP Data -- The UDP data field in the Syslog packet contains a reformatted router event messa
Configuring Syslog Services308659-14.00 Rev 00G-7 Severity LevelsThe error-level code identifies the level of urgency of a received message for UNIX s
Using the Bay Command Console (BCC)G-8308659-14.00 Rev 00For instructions on how to enable the time-sequencing feature, see “Enabling Sequential Syslo
Configuring Syslog Services308659-14.00 Rev 00G-9 Figure G-5 shows the BCC configuration hierarchy for Syslog services on the router.Figure G-5. BCC C
308659-14.00 Rev 00xv PrefaceThe BCC is a command-line interface for configuring Nortel Networks™ devices. If you are responsible for configuring and
Using the Bay Command Console (BCC)G-10308659-14.00 Rev 005.Obtain the process ID for the syslogd process currently running on the workstation by ente
Configuring Syslog Services308659-14.00 Rev 00G-11 To enable Syslog services, you must configure at least one host to receive Syslog messages from the
Using the Bay Command Console (BCC)G-12308659-14.00 Rev 00You can configure up to 10 filters per remote host without changing configuration context. F
Configuring Syslog Services308659-14.00 Rev 00G-13 Syslog includes the upper and lower boundary values as part of this range. For example, an entity f
Using the Bay Command Console (BCC)G-14308659-14.00 Rev 00You can create an entity filter to capture only event messages that have the severity levels
Configuring Syslog Services308659-14.00 Rev 00G-15 Examples:filter/192.168.3.4/telnet-sessions# severity-mask {trace}filter/192.168.3.4/telnet-session
Using the Bay Command Console (BCC)G-16308659-14.00 Rev 00slot-lower-bound <slot_number>slot-upper-bound <slot_number>slot_number is the l
Configuring Syslog Services308659-14.00 Rev 00G-17 Managing Syslog ServicesOnce you finish configuring Syslog on a router, you may occasionally need t
Using the Bay Command Console (BCC)G-18308659-14.00 Rev 00Stopping or Restarting Syslog Messaging to one HostYou can stop Syslog messaging to a specif
Configuring Syslog Services308659-14.00 Rev 00G-19 To confirm the change, check the current value of the filter state parameter by entering:filter/192
Using the Bay Command Console (BCC)xvi308659-14.00 Rev 00Text ConventionsThis guide uses the following text conventions:angle brackets (< >) Ind
Using the Bay Command Console (BCC)G-20308659-14.00 Rev 00Deleting a Configured Host and Its FiltersTo delete a specific remote host entry from the Sy
Configuring Syslog Services308659-14.00 Rev 00G-21 Mapping Router Message Severity Levels to UNIX System Error LevelsIn most cases, you can accept the
Using the Bay Command Console (BCC)G-22308659-14.00 Rev 00Specifying the Interval Between Polling CyclesSyslog polls the events log buffer on each slo
Configuring Syslog Services308659-14.00 Rev 00G-23 Enabling Sequential Syslog MessagingMessage time-sequencing allows Syslog to capture and forward ro
Using the Bay Command Console (BCC)G-24308659-14.00 Rev 00Table G-2. Parameters of log-host (box or stack > syslog > log-host)Parameter Function
Configuring Syslog Services308659-14.00 Rev 00G-25 severity-mask Specifies the severity levels of router event messages -- warning, information, trace
308659-14.00 Rev 00Index-1Aacronyms, xviiiBbackplane hardware, D-7BCCaccessing, 2-1command files, 3-12commandsentering, 3-1show, D-1system, B-1configu
Index-2308659-14.00 Rev 00Eediting commands, 3-3enable command, 3-12, 4-16entering the BCC, 2-1entity filtersSyslog remote hosts, G-3events (via Syslo
308659-14.00 Rev 00Index-3publications, hard copy, xixpwc command, 2-3Rreading commands from a file, 3-15recalling commands, 3-2required, 3-7required
Preface308659-14.00 Rev 00xvii ellipsis points (. . . ) Indicate that you repeat the last element of the command as needed.Example: If the command syn
Using the Bay Command Console (BCC)xviii308659-14.00 Rev 00AcronymsThis guide uses the following acronyms:ARP Address Resolution ProtocolATM asynchron
Preface308659-14.00 Rev 00xix Hard-Copy Technical ManualsYou can print selected technical manuals and release notes free, directly from the Internet.
ii308659-14.00 Rev 00 Copyright © 1999 Nortel NetworksAll rights reserved. Printed in the USA. September 1999.The information in this document is subj
308659-14.00 Rev 001-1 Chapter 1Overview of the BCCThe BCC is a command-line interface for configuring Nortel Networks devices. After logging on to a
Using the Bay Command Console (BCC)1-2308659-14.00 Rev 00From the BCC prompt, you can: • Execute any system command not classified as “Technician Inte
Overview of the BCC308659-14.00 Rev 001-3 Multilevel access allows you to:• Add multiple user names, passwords, and access privileges to the router.•
Using the Bay Command Console (BCC)1-4308659-14.00 Rev 00Figure 1-2. Sample BCC Configurationipospfserial/3/1box(root)arpethernet/2/1ethernet/2/2ip/1.
Overview of the BCC308659-14.00 Rev 001-5 You use BCC commands to create new objects and to modify or delete objects in an existing configuration hier
Using the Bay Command Console (BCC)1-6308659-14.00 Rev 00The BCC displays the context of an object in terms of its location along a path that begins a
Overview of the BCC308659-14.00 Rev 001-7 •A class is a template for a configurable object (such as Ethernet or the protocol IP). When you add a new o
Using the Bay Command Console (BCC)1-8308659-14.00 Rev 00Physical Device ObjectsThe following sections provide BCC terms for the physical device.Box a
Overview of the BCC308659-14.00 Rev 001-9 ModuleThe BCC uses the term module to identify network media-specific I/O modules (for Ethernet, Token Ring,
308659-14.00 Rev 00iiiNortel Networks NA Inc. Software License AgreementNOTICE: Please carefully read this license agreement before copying or using t
Using the Bay Command Console (BCC)1-10308659-14.00 Rev 00InterfaceThe BCC uses the term interface to identify circuitry and digital logic associated
308659-14.00 Rev 002-1 Chapter 2Getting Started with the BCCThis chapter provides information about the following topics:Entering and Exiting the BCC
Using the Bay Command Console (BCC)2-2308659-14.00 Rev 00The Manager login allows you to enter any system command and allows read-write access to the
Getting Started with the BCC308659-14.00 Rev 002-3 6.When you finish using the BCC, enter the exit command at the BCC prompt.bcc> exitRouter1>E
Using the Bay Command Console (BCC)2-4308659-14.00 Rev 00Navigating with the back CommandIn BCC configuration mode, use the back command to move a spe
Getting Started with the BCC308659-14.00 Rev 002-5 Navigating with Configuration CommandsUsing BCC configuration commands, you can:• Move back to a pr
Using the Bay Command Console (BCC)2-6308659-14.00 Rev 00Moving Forward One or More LevelsTo move from your current working level to the next configur
Getting Started with the BCC308659-14.00 Rev 002-7 Example:To move from ip/192.168.33.66/255.255.255.0 (on ethernet/2/1) to rip/1.2.3.4 on ethernet/2/
Using the Bay Command Console (BCC)2-8308659-14.00 Rev 00In this example, the BCC searches backward to find ethernet/2/2 (specified first in the comma
Getting Started with the BCC308659-14.00 Rev 002-9 The optional arguments you add to these commands depend on what you want to see, as follows:Command
iv308659-14.00 Rev 00for the security of its own data and information and for maintaining adequate procedures apart from the Software to reconstruct
Using the Bay Command Console (BCC)2-10308659-14.00 Rev 00Regardless of the command options you enter, output of the show config command typically inc
Getting Started with the BCC308659-14.00 Rev 002-11 • The total device configuration tree (active configuration only)• The IDs of all configured objec
Using the Bay Command Console (BCC)2-12308659-14.00 Rev 00Example:box# show config ip/192.168.125.34/255.255.255.224 -r ip address 192.168.12
Getting Started with the BCC308659-14.00 Rev 002-13 Example:box# eth 2/1ethernet/2/1# show config -rethernet slot 2 connector 1 circuit-name E21-a
Using the Bay Command Console (BCC)2-14308659-14.00 Rev 00 prompt {"%slot%:"} auto-manager-script automgr.bat auto-user-scr
Getting Started with the BCC308659-14.00 Rev 002-15 box; snmp; community/public; manager/public/0.0.0.0 manager/public/192.32.241.36box; snmp
Using the Bay Command Console (BCC)2-16308659-14.00 Rev 00 board slot 1 type srml board slot 2 type qenf board slot 3 type wffd
Getting Started with the BCC308659-14.00 Rev 002-17 To display the most detailed information on values for the same parameter, use the ? command:ethe
Using the Bay Command Console (BCC)2-18308659-14.00 Rev 00Example (using the show config -verbose command):ethernet/2/1# show config -v ethernet slot
Getting Started with the BCC308659-14.00 Rev 002-19 show config [<BCC_instance_ID>] -recursive -verbose or:show config [<BCC_instance_ID>]
308659-14.00 Rev 00vContents PrefaceBefore You Begin ...
Using the Bay Command Console (BCC)2-20308659-14.00 Rev 00Example:Display parameters associated with all objects configured on ip/192.168.125.34/255.2
Getting Started with the BCC308659-14.00 Rev 002-21 Displaying the Total Device Configuration Tree (All Available Choices)To display, from any BCC pro
Using the Bay Command Console (BCC)2-22308659-14.00 Rev 00Displaying Choices Available from the Current ContextTo list the names of all objects and pa
Getting Started with the BCC308659-14.00 Rev 002-23 Example:ethernet/2/1# help treeThe configuration tree below this context is: ip arp rip
Using the Bay Command Console (BCC)2-24308659-14.00 Rev 00Example:ethernet/2/1# help ethernetUsage: "ethernet slot <value> connector <va
Getting Started with the BCC308659-14.00 Rev 002-25 This happens when you enter help ip:ethernet/13/1# help ip"help ip" is ambiguous. Copy
Using the Bay Command Console (BCC)2-26308659-14.00 Rev 00If you want to display the definition for a specific parameter of the current object only,
Getting Started with the BCC308659-14.00 Rev 002-27 keyword is a subcommand that further specifies what aspect of object_name you want to see, such as
Using the Bay Command Console (BCC)2-28308659-14.00 Rev 00• To display every -filter and filter_argument available for a specific show command, insert
308659-14.00 Rev 003-1 Chapter 3Entering Commands and Using Command FilesThis chapter provides information about the following topics:Entering Command
vi308659-14.00 Rev 00Navigating with Configuration Commands ...2-5Moving Back One or More
Using the Bay Command Console (BCC)3-2308659-14.00 Rev 00Using Command AbbreviationsWhen you enter BCC commands in configuration mode, you can shorten
Entering Commands and Using Command Files308659-14.00 Rev 003-3 Editing Command LinesTable 3-1 describes the keystrokes you can use to edit BCC comman
Using the Bay Command Console (BCC)3-4308659-14.00 Rev 00Entering Multiple Commands on a LineTo enter multiple commands on the same line, type a semic
Entering Commands and Using Command Files308659-14.00 Rev 003-5 System CommandsThe BCC supports all system commands described in Appendix B. For help
Using the Bay Command Console (BCC)3-6308659-14.00 Rev 00Command Syntax RequirementsBCC syntax consists of object names, parameter names and values, a
Entering Commands and Using Command Files308659-14.00 Rev 003-7 required_parameter and value are required to add a new object, or to navigate to an ex
Using the Bay Command Console (BCC)3-8308659-14.00 Rev 00The following commands are equivalent.Using full syntax:box# ethernet slot 2 connector 1ethe
Entering Commands and Using Command Files308659-14.00 Rev 003-9 Specifying Parameter Values You must specify each parameter value in the form of a par
Using the Bay Command Console (BCC)3-10308659-14.00 Rev 00Example:In the following example, you specify multiple parameter-value pairs on each command
Entering Commands and Using Command Files308659-14.00 Rev 003-11 If you try to enter a value outside of the legal value range for the mtu parameter, t
308659-14.00 Rev 00viiParameter Range Validation ...3-10Specifying Name or St
Using the Bay Command Console (BCC)3-12308659-14.00 Rev 00 To disable, reenable, or delete an object in the immediate subcontext, relative to your cur
Entering Commands and Using Command Files308659-14.00 Rev 003-13 You can also save TCL scripting commands to a file, use the source command to read th
Using the Bay Command Console (BCC)3-14308659-14.00 Rev 00Saving Configuration Commands to a File on a Nortel Networks DeviceYou can save the output o
Entering Commands and Using Command Files308659-14.00 Rev 003-15 When you finish editing the file, save it on your workstation or PC. The comments are
308659-14.00 Rev 004-1 Chapter 4Tutorial: Configuring a Nortel Networks RouterThis chapter provides a tutorial that guides you through the initial con
Using the Bay Command Console (BCC)4-2308659-14.00 Rev 006.Exit BCC configuration mode, exit the BCC to the Technician Interface, and log out of the d
Tutorial: Configuring a Nortel Networks Router308659-14.00 Rev 004-3 • Serial interface in slot 5• Dual token ring interface in slot 9• FDDI interface
Using the Bay Command Console (BCC)4-4308659-14.00 Rev 00Figure 4-2. Typical BCC Configuration CycleBCC0013BEnter info to check parameter values assig
Tutorial: Configuring a Nortel Networks Router308659-14.00 Rev 004-5 To create the sample configuration shown in Figure 4-1 using BCC commands:1.Log o
viii308659-14.00 Rev 00Appendix B System CommandsAppendix C TCL SupportAppendix D System show Commandsshow access ...
Using the Bay Command Console (BCC)4-6308659-14.00 Rev 004.Check the hardware configuration of the router.box# show config -allbox type frecn (BCN rou
Tutorial: Configuring a Nortel Networks Router308659-14.00 Rev 004-7 6.Check to see what you can configure (subcontexts and parameters) at this level.
Using the Bay Command Console (BCC)4-8308659-14.00 Rev 007.Add IP (address 192.168.133.114) to ethernet/13/1.ethernet/13/1# ip 192.168.133.114Usage: &
Tutorial: Configuring a Nortel Networks Router308659-14.00 Rev 004-9 9.Change the subnet mask to 255.255.255.224.ip/192.168.133.114/255.255.255.0# mas
Using the Bay Command Console (BCC)4-10308659-14.00 Rev 0012.Return to root (box) level to configure global system services.rip/192.168.133.114# box b
Tutorial: Configuring a Nortel Networks Router308659-14.00 Rev 004-11 16.Check what you can configure next at this level.box# snmpsnmp# ?Sub-Contexts:
Using the Bay Command Console (BCC)4-12308659-14.00 Rev 0019.Check the values currently assigned to parameters of this SNMP community.community/public
Tutorial: Configuring a Nortel Networks Router308659-14.00 Rev 004-13 25.Check the values currently assigned to parameters of TFTP.tftp# info on box
Using the Bay Command Console (BCC)4-14308659-14.00 Rev 0030.Check values currently assigned to parameters of FTP. ftp# info on box state enabled
Tutorial: Configuring a Nortel Networks Router308659-14.00 Rev 004-15 34.Return to root level.ftp# boxbox# 35.Save the file using a name other than co
308659-14.00 Rev 00ixConfiguring a Remote Host to Receive Router Syslog Messages ...G-11Creating Entity Filters for the Remote Ho
Using the Bay Command Console (BCC)4-16308659-14.00 Rev 003.Verify that you disabled RIP.rip/1.2.3.4# state state disabledrip/1.2.3.4#You can also d
Tutorial: Configuring a Nortel Networks Router308659-14.00 Rev 004-17 Example:ip/1.2.3.4/255.0.0.0# enable rip/1.2.3.4ip/1.2.3.4/255.0.0.0#Using this
Using the Bay Command Console (BCC)4-18308659-14.00 Rev 00You can also delete an object by entering the following command from its parent context:dele
308659-14.00 Rev 00A-1 Appendix AMultilevel AccessThe Technician Interface provides, by default, two user logins: Manager and User, stored in nonvolat
Using the Bay Command Console (BCC)A-2308659-14.00 Rev 00Multilevel Access LoginTo access a Nortel Networks router using this feature, enter your logi
Multilevel Access308659-14.00 Rev 00A-3 Access PrivilegesA user’s privilege level determines the system commands a user can execute. In addition to th
Using the Bay Command Console (BCC)A-4308659-14.00 Rev 00Sharing Access ProfilesTo share user access profiles configured on one router across multiple
Multilevel Access308659-14.00 Rev 00A-5 Figure A-1. Configurable Multilevel Access ObjectsConfiguring AccessThe access object lets you set the minimum
Using the Bay Command Console (BCC)A-6308659-14.00 Rev 00For example, to set the minimum password length to 6 characters, enter:box# accessaccess# min
Multilevel Access308659-14.00 Rev 00A-7 For example, to create the login ID for a user, enter:box# accessaccess# usersusers# user login-id daviduser/d
Comments to this Manuals