Using the Bay Command Console (BCC™) BayRS Version 12.20 Site Manager Software Version 6.20 BCC 4.00 Part No. 117383-B Rev.
4401 Great America Parkway Santa Clara, CA 95054 8 Federal Street Billerica, MA 01821 Copyright © 1998 Bay Networks, Inc. All rights reserved. Printed in the USA. June 1998. The information in this document is subject to change without notice. The statements, configurations, technical data, and recommendations in this document are believed to be accurate and reliable, but are presented without express or implied warranty.
USA Requirements Only Note: This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to Part 15 of the FCC rules. These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment. This equipment generates, uses, and can radiate radio frequency energy.
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. Bay Networks, Inc.
SHALL THE LIABILITY OF BAY NETWORKS RELATING TO THE SOFTWARE OR THIS AGREEMENT EXCEED THE PRICE PAID TO BAY NETWORKS FOR THE SOFTWARE LICENSE. 5. Government Licensees. This provision applies to all Software and documentation acquired directly or indirectly 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 the use of any U.S. Government funds.
Contents About This Guide Conventions .....................................................................................................................viii Acronyms .......................................................................................................................... ix Ordering Bay Networks Publications ................................................................................. x Bay Networks Customer Service ...................................................................
Displaying Online Help .................................................................................................2-12 Using the BCC Help File ...............................................................................................2-22 Displaying Help File Version Data ................................................................................2-23 Displaying Configuration Data ......................................................................................
Chapter 4 Configuring a Network Device Creating and Modifying a Device Configuration .............................................................4-1 Entering Configuration Commands from a File ............................................................4-15 Disabling a Configured Object ......................................................................................4-16 Enabling a Configured Object .......................................................................................
Figures Figure 1-1. The Technician Interface and the BCC Interface .....................................1-1 Figure 1-2. Configuring IP and RIP on an Ethernet Interface ....................................1-5 Figure 2-1. Sample BCC Configuration (BN Router) ..................................................2-4 Figure 2-2. Object Location or Context ......................................................................2-5 Figure 2-3. Moving Away from Root (box) Level ................................
Tables Table 3-1. BCC Command Operators .....................................................................3-12 Table 3-2. Keystrokes for Editing BCC Command Lines .........................................3-13 Table A-1. System Commands ................................................................................ A-1 117383-B Rev.
About This Guide If you are responsible for configuring and managing Bay Networks® AN®, ANH, ARN, ASN, BN® (BCN® and BLN®), and System 5000 routers, read this guide to learn how to use the Bay Command Console (BCC™).
Using the Bay Command Console (BCC™) Conventions angle brackets (< >) Indicate a variable in a command line. The word or words inside the angle brackets describe the type of variable (for example, ). Do not type the angle brackets when entering an actual value for a variable. Example: if command syntax is ping , enter ping 192.32.10.12 bold text Indicates text (usually commands) that you enter at the BCC command line prompt. Example: Enter reset.
About This Guide italic text Indicates variable values in command syntax descriptions, new terms, file and directory names, and book titles. quotation marks (“ ”) Indicate a literal string in a command line, the title of a chapter, or a section within a book. screen text Indicates BCC or Technician Interface output to a console or Telnet screen, for example, prompts, system messages, statistical data, and configuration data.
Using the Bay Command Console (BCC™) Ordering Bay Networks Publications To purchase additional copies of this document or other Bay Networks publications, order by part number from Bay Networks Press™ at the following numbers: • Phone--U.S./Canada: 888-422-9773 • Phone--International: 510-490-4752 • FAX--U.S./Canada and International: 510-498-2609 The Bay Networks Press catalog is available on the World Wide Web at support.baynetworks.com/Library/GenMisc.
About This Guide How to Get Help If you purchased a service contract for your Bay Networks product from a distributor or authorized reseller, contact the technical support staff for that distributor or reseller for assistance. If you purchased a Bay Networks service program, call one of the following Bay Networks Technical Solutions Centers: 117383-B Rev.
Chapter 1 Overview of the BCC Interface The BCC is a command-line interface for configuring Bay Networks devices. After logging on to a device, you access the BCC by entering the bcc command at the Technician Interface prompt (Figure 1-1). Technician Interface Login Access the BCC BCC BCC0001B Figure 1-1. 117383-B Rev.
Using the Bay Command Console (BCC™) From the bcc> prompt, you can • Run any system command not classified as “Technician Interface only.” (See Appendix A, “System Commands.”) • Use configuration mode to perform tasks such as creating or deleting IP interfaces on the router. Enter BCC configuration mode by entering the config command at the bcc> prompt.
Overview of the BCC Interface Configurable Objects Refer to the Release Notes for the most up-to-date information about services you can configure using the BCC on any (AN/ANH, ARN, ASN, BCN, BLN, or System 5000) platform. 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.
Using the Bay Command Console (BCC™) Optional parameters -- The set of parameters for which you can optionally specify customized values, replacing any default values set by the system. For example, an optional parameter of an Ethernet interface is bofl-retries. This parameter normally has a system default value of 5 (5 retries), but you can change this to another numeric value. BCC instance identifier -- Uniquely identifies a single instance of an object configured on a Bay Networks device.
Overview of the BCC Interface You create a customized configuration by using BCC commands to create new objects, and to modify or delete objects in an existing configuration. You begin at root level in BCC configuration mode and navigate to (or create new) objects in the device configuration tree. For example, with a BLN router, you can use BCC commands to add a new physical interface (such as Ethernet) on box, add IP to the Ethernet interface, and then add RIP to IP on that interface.
Using the Bay Command Console (BCC™) The BCC indicates context by displaying a context-sensitive prompt in configuration mode. The prompt identifies the configured object at your current working location or level within the configuration hierarchy.
Overview of the BCC Interface Platform Interface/Port Numbering AN/ANH / • = Interface type: ethernet, token-ring, serial (etc.) • number always = 1 (AN/ANH is a 1-slot device) • numbering starts with connector 1.) Example: ethernet slot 1 connector 2 This is an Ethernet interface configured on AN/ANH connector 2, which exists on an Ethernet adapter module. (Connectors 1 and 2 are on the base.
Using the Bay Command Console (BCC™) Platform Interface/Port Numbering BN / • = Interface type: ethernet, token-ring, serial (etc.) • number = 2 to 5 (BLN) or 1 to 14 (BCN). • numbering starts with connector 1 on each slot (per media type). Example: ethernet slot 8 connector 3 This is an Ethernet interface configured on connector 3 of slot 8 of a BCN router.
Overview of the BCC Interface Interface, physical -- 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). Interface, logical -- An addressable entity for originating and terminating connections across an IP network. Protocol -- A configurable object that typically provides data link, network, transport, session, application, or management layer services on a network device.
Chapter 2 Learning to Use the BCC Interface This chapter provides primary instructions on how to use the BCC interface to complete any of the following tasks: Topic Page Entering and Exiting the BCC Interface page 2-1 Using the BCC Configuration Hierarchy page 2-3 Navigating in Configuration Mode page 2-7 Displaying Online Help page 2-12 Using the BCC Help File page 2-22 Displaying Configuration Data page 2-23 Entering and Exiting the BCC Interface To access the BCC interface on a Bay Network
Using the Bay Command Console (BCC™) To enter and exit the BCC: 1. Access the Technician Interface on the router by entering the Manager or User command at the Login prompt that appears on your Telnet or console display. After you start the BCC interface, the Manager login allows you to enter any system command. A Manager login also allows, by default, read-write access to the device configuration.
Learning to Use the BCC Interface Caution: When you enter BCC configuration commands with read-write (Manager) access privileges, you immediately modify the device configuration. This is equivalent to dynamic mode configuration with the Bay Networks Site Manager graphical user interface. 4. When you finish using BCC configuration mode, enter the exit command at any prompt. box# bcc> 5. exit When you finish using the BCC, enter the exit command at the bcc> prompt.
Using the Bay Command Console (BCC™) box (root) ospf (protocol) ip (protocol) arp (protocol) rip (protocol) snmp (protocol) telnet (protocol) tftp (protocol) BOX-WIDE/GLOBAL OBJECTS (Services supported on all slots) INTERFACE-SPECIFIC OBJECTS (Services supported on a specific slot) ospf/1.2.3.4 (protocol) ethernet/2/1 (interface) ethernet/2/2 (interface) ip/1.2.3.4/255.0.0.0 (protocol) arp/1.2.3.4/1 (protocol) serial/3/1 (interface) Figure 2-1.
Learning to Use the BCC Interface Note the tree-like hierarchy of this configuration, where • Box contains global objects IP, Telnet, TFTP, and SNMP, plus the physical interface objects ethernet/2/1, ethernet/2/2, and serial/3/1. • Global IP contains the ARP, RIP, and OSPF global objects.
Using the Bay Command Console (BCC™) Each semicolon in the path marks a transition from one level to the next branch level in the device configuration tree. The semicolon is also equivalent to a Return key entered at the end of a command, effectively starting a new command line. Displaying Context In BCC configuration mode, use the pwc (print working context) command to display the path from root (box) level to your current level in the device configuration tree. For example: rip/192.168.125.
Learning to Use the BCC Interface The prompt does not show the full path to the current object from root level. The prompt shows only the object that terminates the entire path from root (box) level. To obtain the full path, use the pwc command. Navigating in Configuration Mode Using BCC configuration commands, you can • Move back to a previous context or level. • Move back to root (box) level. • Move forward to the next level.
Using the Bay Command Console (BCC™) In this example, the back 2 command moves you from a current working location of rip/192.168.125.34, back two levels to ethernet/2/1 (with ip/192.168.125.34/255.255.255.224 as the intervening level). Note: If you enter an integer value that exceeds the actual number of levels back to root (box or stack) level, the BCC returns to root level.
Learning to Use the BCC Interface Moving Forward from Root (box) Level To move from your current working level to the next configured level (Figure 2-3), enter the BCC instance ID of the desired object, as follows: Example: (BN router) box# ethernet/2/1 ethernet/2/1# ip/1.2.3.4/255.0.0.0 ip/1.2.3.4/255.0.0.0# rip rip/1.2.3.4# Notice that a slash character (/) joins the name and any required parameter values to make a BCC instance ID for any configured object.
Using the Bay Command Console (BCC™) Example: (BN router) Move from ip/192.168.33.66/255.255.255.0 (on ethernet/2/1) to rip/1.2.3.4 on ethernet/2/2 (Figure 2-4). ip/192.168.33.66/255.255.255.0# box;ethernet/2/2;ip/1.2.3.4/255.0.0.0;rip rip/1.2.3.4# (Starting context) ip/192.168.33.66/255.255.255.0 ethernet/2/1 box ethernet/2/2 rip ip/1.2.3.4/255.0.0.0 (Ending context) BCC0009C Figure 2-4.
Learning to Use the BCC Interface Example: (BN router) Move from ip/192.168.33.66/255.255.255.0 on ethernet/2/1 to rip/1.2.3.4 on ethernet/2/2 (Figure 2-5). ip/192.168.33.66/255.255.255.0# 255.0.0.0;rip rip/1.2.3.4# ethernet/2/2;ip/1.2.3.4/ (Starting context) ethernet/2/1 ip/192.168.33.66/255.255.255.0 box ethernet/2/2 rip ip/1.2.3.4/255.0.0.0 (Ending context) BCC0009C Figure 2-5.
Using the Bay Command Console (BCC™) Displaying Online Help The BCC supports the following online Help and Help-oriented features: Help Feature Command Get Help on commands: Get an overview of Help-oriented command features. help List commands or command options you can enter. ? Or: ? Or:
Learning to Use the BCC Interface Help Feature Command Get configuration data (BCC configuration mode only): List the names of objects, parameters, and commands you ? can enter next. Get command usage Help and list parameters of an object
Using the Bay Command Console (BCC™) Example Get a terse overview of BCC Help features: bcc> help Help Summary _________________________________________________________________ System Help: * ? * ? + Example: show ? *
Learning to Use the BCC Interface Example Get an alphabetical list of BCC system commands (syntax only, with some examples, where needed): bcc> help commands SCROLL TO THE COMMAND YOU NEED.
Using the Bay Command Console (BCC™) Example Get a more detailed alphabetized list of BCC commands (with syntax and terse definitions): box# help commands -more SCROLL TO THE COMMAND YOU NEED.
Learning to Use the BCC Interface Example Define the purpose of each parameter of ethernet/2/1: ethernet/2/1# help ethernet Usage: "ethernet slot connector " Or: "ethernet /" ethernet Parameters: _________________________________________________________________ bofl Allows breath-of-life polls to be disabled. bofl-retries Specifies the BOFL Retry Count. bofl-timeout Specifies the number of seconds for the BOFL timer. bofl-tmo-divisor Specifies the BOFL TMO divisor.
Using the Bay Command Console (BCC™) Example (BN router) Show all objects you can configure on this device: box# help tree -all The entire configuration tree is: board virtual ip ospf neighbor ftp http ntp peer snmp community manager trap-entity trap-event tftp console telnet client server atm atm-interface signaling timers signaling-vc ilmi ilmi-vc sscop pvc-service pvc ip arp rip ospf neighbor rdisc igmp relay ipx rip sap static-route adjacent-host static-service . . . . . . . . . 2-18 117383-B Rev.
Learning to Use the BCC Interface Example (BN router) List objects you can configure, starting at the ethernet/2/1 branch of the device configuration: ethernet/2/1# help tree The configuration tree below this context is: ip arp rip ospf neighbor rdisc igmp relay ipx rip sap static-route adjacent-host static-service route-filter server-network-filter server-name-filter auto-neg Note: The main difference between the help tree and show config commands is that help tree shows what you can configure; show con
Using the Bay Command Console (BCC™) Example List the names of all objects, parameters, and system commands you can enter from the context of ip/192.168.125.34/255.255.255.0: ip/192.168.125.34/255.255.255.
Learning to Use the BCC Interface IP Configuration Sequence RIP OSPF ARP (Created automatically IGMP RDISC with IP) BCC0019A Figure 2-6. Objects to Configure at the Next (Branch) Level Example: (BN router) Get the values currently assigned to all parameters of IP (address 1.2.3.4) on ethernet/2/1: ip/1.2.3.4/255.0.0.0# info on ethernet/2/1 state enabled address 1.2.3.4 mask 255.0.0.0 assocaddr 0.0.0.0 cost 1 broadcast 1.2.3.
Using the Bay Command Console (BCC™) Using the BCC Help File To use any BCC command that begins with the verb help (for example, help commands, or help tree), the BCC Help file (called bcc.help, by default) must be present on the NVFS default volume. If the file is missing, or if you have not configured the box to find the Help file, the BCC displays the following message: The help data file is missing. Please transfer “bcc.help” to the default volume. You can obtain a copy of “bcc.
Learning to Use the BCC Interface Displaying Help File Version Data The BCC help-file-version command enables you to display version data for your BCC help file, bcc.help. Enter the command at any BCC prompt, as follows: Example: (BN router) box# help-file-version Help file 2:bcc.help, contains this version data: Data version is: 2. Creation date is: 1997 Nov 20 14:42:40 hrs.
Using the Bay Command Console (BCC™) Example bcc> show config -all box type freln board slot 1 type srml back board slot 2 type qenf back board slot 3 type wffddi2m . . . . . . . . . ethernet slot 2 connector 1 circuit-name E21-alpha ip address 192.168.3.4 mask 255.255.255.224 broadcast 192.168.3.5 rip back arp back back back . . . . . . . . . ftp default-volume 2 back snmp community label public access read-write manager address 0.0.0.0 back manager address 192.168.9.9 . . . . . . . . .
Learning to Use the BCC Interface Displaying the Configuration of One Object You can view objects configured within a specific part of the BCC configuration tree by using the show config command or the lso command. Example: (show config, BLN router) You can use the show config command to view the configuration of a specific configured object. Navigate to the object in configuration mode, and enter the show config command.
Using the Bay Command Console (BCC™) Displaying Binary Configuration Files as BCC Syntax After booting the device from a binary configuration file, you can 1. Use the show config command to view the current device configuration in readable BCC syntax. For an example of show config output, refer to “Displaying the Total Device Configuration” on page page 2-23. 2. Enter new configuration commands to override elements of the active device configuration.
Learning to Use the BCC Interface Saving Commands on a Workstation If you log in to a Bay Networks router from a workstation using Telnet or terminal emulation, you can use the native capabilities of the workstation to • Save the output of any show config command from the screen to an ASCII file. • Save a sequence of manually entered BCC commands to an ASCII file. You can also use an ASCII text editor on a workstation to create a file from which the BCC can read configuration and system commands.
Chapter 3 Entering Commands You can enter BCC configuration commands using basic (full), default, or abbreviated syntax. In addition, command operators enable you to perform certain operations more efficiently from your current location in the device configuration tree. This chapter provides information about the following topics: 117383-B Rev.
Using the Bay Command Console (BCC™) Command Input Features This section contains information about • Using Command Abbreviations • Recalling Commands • Entering Commands from a File • Entering Multiple Commands per Line • Continuing a Command Line (Underscore Prompt) • Entering Comments Using Command Abbreviations For configuration command input, you can shorten existing object and parameter names (for example, eth = ethernet).
Entering Commands Purpose Command Recall the previous command from the history list. Up arrow key or Control + p Recall the next command from the history list. Down arrow key or Control + n The command history list contains up to 20 commands by default. You can increase the number of commands in the history list to a maximum of 40 by setting new values for the history parameter of the console and telnet objects.
Using the Bay Command Console (BCC™) Note: If the BCC detects an error in the source file, it stops reading commands into the device configuration. Syntax for the source command is as follows: source : For information about how to save as an ASCII file the output of the show config command, or a manually entered set of commands, refer to “Saving Commands on a Workstation” on page page 2-27.
Entering Commands You must immediately follow the initial escape character ( \ ) with a newline (Return) character. The BCC treats these two characters and any trailing spaces as if they were exactly one space. Until you press Return without a preceding escape ( \ ) character, the BCC replaces the # symbol in the context-sensitive prompt with an underscore ( _ ) character. Example ip/1.2.3.4/255.0.0.0# ip/1.2.3.4/255.0.0.0_ ip/1.2.3.4/255.0.0.0_ ip/1.2.3.4/255.0.0.0_ ip/1.2.3.4/255.0.0.
Using the Bay Command Console (BCC™) Entering Comments You can use a text editor (such as vi on a UNIX workstation) to add descriptive comments to a BCC configuration file. Enter comments in the following format: box# ;# comment or box# #comment box# Example: (AN router) box# board slot 1 type andse;# 192.168.47.129 192.168.47.21 When you finish editing the file, save it on your workstation or PC. The comments are for reference only.
Entering Commands Configuration Commands Caution: Configuration commands and source commands make real-time changes to the device configuration. This section describes how to enter BCC configuration commands using any of the following formats: • Basic (full) syntax • Default syntax • Abbreviated syntax BCC syntax consists of object names, parameter names and values, and various types of punctuation.
Using the Bay Command Console (BCC™) { } is any parameter-value pair required to uniquely identify an object you specify in a BCC command line. An object may have one or more required parameters. For example, the full syntax for configuring an Ethernet interface on an AN/ANH, ARN, or BN router is ethernet slot connector And on an ASN or System 5000 router, the full syntax is: ethernet slot module connector
Entering Commands box# ethernet Required parameter "slot" was not specified for ethernet. Usage: "ethernet slot connector " Or: "ethernet /" The following commands are equivalent. Using full syntax: box# ethernet slot 2 connector 1 ethernet/2/1# Using default (minimum) syntax: box# ethernet 2/1 ethernet/2/1# ethernet is the object you want to configure. slot and connector are the required parameters of ethernet on AN/ANH, ARN, and BN platforms.
Using the Bay Command Console (BCC™) If you press Return before entering a sufficient number of characters for the BCC to recognize the name of the object or parameter you want to configure, the BCC returns an error message: Example: (BN router) box# e ambiguous command name "e": enable eof error ethernet eval exit expr Note that the BCC returns a list of all the commands available in the current context, and that also start with the letter “e”.
Entering Commands Note: The BCC uses required parameters to make up the unique instance identifier for a configured object. You cannot change the value of any parameter that makes up the instance identifier for an object. To change these parameter values, you must delete the object, and then add it back into the device configuration with new values.
Using the Bay Command Console (BCC™) Table 3-1. BCC Command Operators Operator Function disable Change the administrative state of a configured object from enabled to disabled, as follows: ip/1.2.3.4/255.0.0.0# disable You can accomplish the same change by assigning the value “disabled” to the state parameter of an object you want to disable. enable Change the administrative state of a configured object from disabled to enabled, as follows: ip/1.2.3.4/255.0.0.
Entering Commands Editing Command Lines Table 3-2 describes the keystrokes you can use to edit BCC command lines. Table 3-2.
Chapter 4 Configuring a Network Device This chapter describes how to complete the following tasks using BCC commands: Topic Page Creating and Modifying a Device Configuration page 4-1 Entering Configuration Commands from a File page 4-15 Disabling a Configured Object page 4-16 Enabling a Configured Object page 4-17 Deleting a Configured Object page 4-18 Configuration Command Responses page 4-19 Creating and Modifying a Device Configuration You configure a Bay Networks device by defining a se
Using the Bay Command Console (BCC™) 4. Use the save command to save your configuration as a bootable (binary) file on the device. 5. Exit BCC configuration mode, exit the BCC to the Technician Interface, and log out of the device. You may find it helpful to first diagram what you want to configure in terms of the BCC configuration tree or hierarchy for the device. For example, refer to the following sample router configuration.
Configuring a Network Device • Serial interface in slot 5 • Dual Token Ring interface in slot 9 • FDDI interface in slot 11 • SRML system controller in slot 7 Figure 4-1. fddi/11/1 ethernet/13/4 ip telnet arp server ip arp ethernet/13/3 ethernet/13/2 ethernet/13/1 token-ring/9/2 token-ring/9/1 serial/5/1 box rip Global Services snmp rip tftp ftp community “public” manager 0.0.0.
Using the Bay Command Console (BCC™) START/ CONTINUE Enter the name of any changed parameter to verify its new assigned value. Current prompt Enter ? for a list of parameters and objects configurable in this context or location in the configuration tree. Where necessary, enter the name of any parameter with a new value, for example: bofl disabled. Enter info to check parameter values assigned to the new (current) object. Enter an object name (for example, ethernet).
Configuring a Network Device To create the sample configuration shown in Figure 4-1 using BCC commands, proceed as follows: 1. Log on to the router as Manager, so that you can modify the device configuration. Bay Networks, Inc. and its Licensors. Copyright 1992, 1993, 1994, 1995, 1996, 1997. All rights reserved. Login: Manager Mounting new volume... Device label: Directory: 2: New Present Working Directory: 2: Welcome to the Backbone Technician Interface Router1> 2.
Using the Bay Command Console (BCC™) 4. Check the hardware configuration of the router.
Configuring a Network Device 6. Check to see what you can configure (sub-contexts and parameters) at this level.
Using the Bay Command Console (BCC™) 7. Add IP (address 192.168.133.114) to ethernet/13/1. ethernet/13/1# ip 192.168.133.114 Usage: "ip address mask " Or: "ip /" Required parameter "mask" was not specified for ip. The error message appears because the BCC requires you to enter a mask value whenever you create an IP interface.
Configuring a Network Device Change the subnet mask to 255.255.255.224. 9. ip/192.168.133.114/255.255.255.0# mask 255.255.255.224 "mask" parameter may not be modified ip/192.168.133.114/255.255.255.0# You cannot modify any parameter values included in the BCC instance identifier of a configured object, in this case, ip/192.168.133.114/255.255.255.0.
Using the Bay Command Console (BCC™) 12. Return to root (box) level to configure global system services. rip/192.168.133.114# box box# 13. Check to see what global services (protocols) and interfaces you can configure at this level.
Configuring a Network Device 16. Check to see what you can configure next at this level. snmp# ? Sub-Contexts: community trap-entity trap-event Parameters in Current Context: authentication-traps lock-timeout has name lock on lock-address scope-delimiter state type-of-service System Commands: . . . . . . . . . You can modify values currently assigned to attributes of SNMP, and you can add a community, define a trap entity, or define a trap event. 17.
Using the Bay Command Console (BCC™) 19. Check the values currently assigned to parameters of this SNMP community. community/public# info on snmp label public access read-only scope-type {} 20. To allow network management applications (such as Site Manager) to modify the device configuration, modify the value of the access attribute to read-write. community/public# access read-write community/public# 21. Define an SNMP manager for the router.
Configuring a Network Device 25. Check values currently assigned to attributes of TFTP. tftp# info on box state enabled default-volume 2 retry-timeout 5 close-timeout 25 retry-count 5 26. Change the default volume number for TFTP to 5. tftp# def 5 tftp# 27. Verify the change to the default-volume number. tftp# def default-volume 5 28. Add FTP globally to the router. tftp# ftp ftp# The BCC automatically searches back (toward root) to find the parent context suitable for FTP (in this case, box).
Using the Bay Command Console (BCC™) 30. Check values currently assigned to parameters of FTP. ftp# info on box state enabled default-volume 2 login-retries 3 idle-timeout 900 max-sessions 3 tcp-window-size 60000 31. Change the default volume number to 5. ftp# def 5 ftp# 32. Verify the change to the default volume number. ftp# def default-volume 5 33. Recheck the total device configuration.
Configuring a Network Device 34. Return to root level. ftp# box box# 35. Save the file using a name other than config until you can test the configuration. box# save config startup.cfg 36. Test the intial IP interface. box# ping 192.168.133.114 IP ping: 192.168.133.114 is alive (size = 16 bytes) 37. Ensure that the initial IP interface connects to another device on the network. box# ping 192.168.133.97 IP ping: 192.168.133.97 is alive (size = 16 bytes) 38.
Using the Bay Command Console (BCC™) The source command takes new BCC configuration commands and data from an ASCII file and merges those commands with existing configuration data in active device memory. If the file you specify in the source command contains configuration commands pertaining to objects already defined on a device, the commands in the file dynamically overwrite the configuration of those objects.
Configuring a Network Device Enabling a Configured Object If you disable a configured object to manage or troubleshoot the local device, you can use the BCC enable command to reenable that object. Here is a BN router example of how to enable an object (rip) previously disabled on ip/1.2.3.4/255.0.0.0: 1. Specify the configuration context for RIP. box# ethernet/2/1;ip/1.2.3.4/255.0.0.0;rip rip/1.2.3.4# 2. Reenable RIP. rip/1.2.3.4# rip/1.2.3.4# 3. enable Verify that you reenabled RIP. rip/1.2.3.
Using the Bay Command Console (BCC™) Deleting a Configured Object Because of the tree hierarchy, objects on higher branches of the tree depend on the state (and existence) of objects closer to the root of the tree. Deleting an object also deletes anything configured on that object. Here is a BN router example of how to delete an IP interface from the active device configuration: 1. Navigate to the object you want to delete: box# ethernet/13/1 ethernet/13/1# ip/192.168.133.114/255.255.255.224 ip/192.168.
Configuring a Network Device Configuration Command Responses The BCC completes the configuration task you entered unless a syntax, semantics, or completion error occurs. You can display and verify the configuration by entering the show config command. In certain circumstances, the BCC may be unable to complete a configuration command; this is a completion error. When this occurs, the BCC displays an appropriate error message. 117383-B Rev.
Appendix A System Commands AN/ANH, ARN, ASN, BCN, BLN, and System 5000 routers support all system commands shown in Table A-1. Note that some commands perform functions specific to your current interface level (Technician Interface, BCC, or BCC configuration mode) and login privilege level (Manager or User). Table A-1. System Commands Login/Access Privileges Command Purpose Manager User ? List the names of objects, parameters, and system commands you can enter next.
Using the Bay Command Console (BCC™) Table A-1. System Commands (continued) Login/Access Privileges Command Purpose Manager User back [] Move your current working location or level back levels closer to the root level of the BCC configuration tree. ✔ ✔ bcc Start the BCC from the Technician Interface prompt. ✔ ✔ boot [ {: | - } { : | - } ] Reboot the system. ✔ cd [:][] Set or display the current working volume and directory.
System Commands Table A-1. System Commands (continued) Login/Access Privileges Command Purpose Manager User config [-read-write|-read-only] Enter BCC configuration mode. If you logged on as Manager, you have read-write access to the device configuration; if you logged on as User, you have read-only access, which allows you to “show” or navigate the existing configuration, but prevents you from changing the configuration.
Using the Bay Command Console (BCC™) Table A-1. System Commands (continued) Login/Access Privileges Command Purpose Manager diags [] Perform CPU/memory, backbone, and link diagnostics before downloading the GAME image and rebooting on the specified slot. ✔ dinfo Display the status of each file system volume on this device. ✔ ✔ dir [:] Display the contents of the file system volume specified.
System Commands Table A-1. System Commands (continued) Login/Access Privileges Command Purpose Manager User help [[ commands ] [-more] | | syntax | tree [] | learning-bcc | editing ] (BCC only) The word help, entered without arguments, displays an overview of BCC Help-oriented features.
Using the Bay Command Console (BCC™) Table A-1. System Commands (continued) Login/Access Privileges Command Purpose Manager User help [ | -all ] The help command, entered without arguments at the Technician Interface prompt, displays an alphabetical list of all commands with syntax only. The list excludes commands available only in BCC mode. ✔ ✔ Display the command history list or recall command number from the history list.
System Commands Table A-1. System Commands (continued) Login/Access Privileges Command Purpose Manager User log [:] [-d] [-t
Using the Bay Command Console (BCC™) Table A-1. System Commands (continued) Login/Access Privileges Command Purpose Manager mset {|}.{| }.{} {} Modify (set) the values of data objects in the device MIB. ✔ partition {create|delete} [:] Create or delete a partition on existing file system media. ✔ password Manager Change the password of the Manager account. ✔ password User Change the password of the User account.
System Commands Table A-1. System Commands (continued) Login/Access Privileges Command Purpose Manager rm : Remove (delete) the file from the specified volume. ✔ save {config|aliases} : Store the current configuration, alias list, or system event. ✔ securelogin Turn SecurID access to the device on and off via Telnet. ✔ User (BCC only) set { | } .{| Modifies data objects in the MIB. } . { } {} ...
Using the Bay Command Console (BCC™) Table A-1. System Commands (continued) Login/Access Privileges Command Purpose Manager tftp {get|put}
: [:] Send files to, or retrieve files from, other hosts supporting TFTP. ✔ type [-x] : Display the contents of the designated file in ASCII or HEX (-x) format. ✔ xmodem {rb|sb} [ylw|p|n] ... Transfer files to or from this device over a dial (out-of-band) connection.Appendix B TCL Support The BCC supports the following subset of Tool Command Language (TCL) scripting commands on the router platform: • append • for • lrange • switch • break • foreach • lreplace • unset • case • gets • lsearch • uplevel • catch • global • lsort • upvar • close • if • open • while • concat • incr • proc • continue • interp • puts • eof • join • rename • error • lappend • return • eval • lindex • set • exit • linsert
System-Oriented Show Commands Appendix C System-Oriented Show Commands The BCC supports five system-oriented show commands, as follows: • show config • show console • show hardware • show process • show system This appendix describes all BCC system-oriented show commands, except for show config. The section “Displaying Configuration Data” in Chapter 2 describes the show config command. 117383-B Rev.
Using the Bay Command Console (BCC™) show console The show console
System-Oriented Show Commands Slot Number Slot on which the login session for the serial port is running. Baud Rate Current baud rate setting for the serial port. Data Bits Number of data bits in the serial port’s configuration. Parity Serial port’s current parity setting. Stop Bits Number of stop bits in the serial port’s configuration. Modem Control Configuration of modem control, as follows: • Disabled - Port is directly connected to a device, such as a dummy terminal or a terminal server.
Using the Bay Command Console (BCC™) Manager’s AutoScript Name of the script to run when the Manager account logs in to the router. If the script name does not contain a volume specifier, the system searches the volumes listed in “Initial Search Path.” User’s AutoScript Name of the script to run when the User account logs in to the router. If the script name does not contain a volume specifier, the system searches the volumes listed in “Initial Search Path.
System-Oriented Show Commands show hardware The show hardware
Using the Bay Command Console (BCC™) memory Displays memory configuration and capacity information about all slots or a specific slot. The table includes the following information: Slot Slot number. Local Memory Total memory capacity in megabytes of the processor on the slot. Global Memory Current memory configuration in megabytes of the processor on the slot. Total Memory Total in megabytes of local and global memory. proms Displays PROM information for all slots.
System-Oriented Show Commands show process The show process
Using the Bay Command Console (BCC™) cpu [detail|total] Displays the use in 100ths of seconds and percentage of cpu used by all processes on the router. By specifying the options that appear in the following command line, you can customize the output to display cpu usage for a particular process or slot on the router. show process cpu [detail| total] detail Displays details about cpu usage by all processes. total Displays only cpu statistic totals.
System-Oriented Show Commands The table includes the following information: detail Displays details about the amount of memory used by each process running on the router. total Displays only memory usage totals. Name The name of the process Slot Slot number. Used Number of memory bytes used by each process %Used Percentage of memory used by each process list Displays a list of all the processes running on each slot. 117383-B Rev.
Using the Bay Command Console (BCC™) show system The show system
System-Oriented Show Commands information Displays general system information (System name, Contact, node Location, Image data, MIB Version, and total uptime since last cold boot. memory Displays the global memory usage for all active slots in the system. Memory usage is not as volatile as buffer usage and a low free percent may indicate that you need more memory. The table includes the following information: Slot Slot number. Total Total number of memory (DRAM) bytes available on each slot.
Using the Bay Command Console (BCC™) tasks Displays the number of tasks scheduled to run on all slots. This number is highly volatile and a large %In Queue does not necessarily indicate a problem. The table includes the following information: C-12 Slot Slot number. Total Total number of tasks running on each slot. In_Queue Number of tasks scheduled to run. Out_Queue Number of tasks already run. 117383-B Rev.
Index A abbreviating commands and parameters, 1-9 acronyms, ix ASCII files, 2-27, 3-4 B backplane, hardware, C-5 Bay Networks Press, x BCC accessing, 1-1, 2-1 configurable objects, 1-3 configuration cycle, 4-4 console types, 2-1 defined, 1-1 error messages, 4-19 Help, 2-12, A-5 navigating in configuration mode, 2-7 platform requirements, 1-2 terminology and concepts, 1-3 board, defined, 1-6 Bootstrap Protocol (BootP) PROM, revision date, C-6 box-wide objects, 1-6 buffers, system, C-10 C class, defined, 1
context changing, 2-7 current, 2-6 defined, 1-5, 2-5 displaying, 2-6 context-sensitive prompt, 2-6 continuing a command line, 3-4 conventions, viii I image, software, C-5 info command, 3-12 information, show system command, C-11 instance identifier, 1-4, 2-6, 2-9, 3-11 interface, defined, 1-9 creating a new configuration, 4-1 L customer support programs, x Technical Solutions Centers, xi line, defined, 1-8 D delete command (operator), 3-12, 4-18 derived parameters, 1-3 Diagnostics PROM, revision date,
O objects defined, 1-3 deleting, 4-18 disabling, 4-16 enabing, 4-17 show commands console, C-2 hardware, C-5 system, C-10 show config command, 2-23 example, 2-25 online Help, BCC, 2-12, A-5 slot, defined, 1-6 optional attributes, 1-4 slots hardware, C-6 P source command defined, 3-3, 4-15 syntax, 3-4 parameters abbreviating, 1-9 defined, 1-3 derived values, 1-3 getting Help, 2-13 help definitions for, A-5 required and optional, 3-10 specifying multiple, 3-11 specifying values for, 3-10 system infor