Bar Admin Guide
Bar Admin Guide
Bar Admin Guide
Declarations
Document Notice
Rights Pannaway Technologies, Inc. makes no representation that software programs and practices
described herein will not infringe on existing or future patent rights, copyrights, trademarks, trade
secrets or other proprietary rights of third parties and Pannaway Technologies, Inc. makes no
warranties of any kind, either express or implied, and expressly disclaims any such warranties,
including but not limited to any implied warranties of merchantability or fitness for a particular
purpose and any warranties of non-infringement. The descriptions contained herein do not imply the
granting of licenses to make, use, sell, license or otherwise transfer Pannaway Technologies, Inc.
products described herein. Pannaway Technologies, Inc. disclaims responsibility for errors which
may appear in this document, and it reserves the right, in its sole discretion and without notice, to
make substitutions and modifications in the products and practices described in this document.
Trademarks The Pannaway logo, Redefining Broadband Convergence, Service Convergence Network, PBG,
RGN, BAR, BAS and NMX are trademarks of Pannaway Technologies, Inc.
i
BAR Administration Guide
Under normal operating conditions for which the product was designed, Pannaway Technologies
warrants that all of its Service Convergence Network hardware components shall be free of defects in
material and workmanship for a period of twelve (12) months from the shipment date from Pannaway
Technologies, Inc.
Hardware In the event that Pannaway Technologies receives notice during the warranty period that any of its
hardware does not conform to its warranty, Pannaway Technologies will provide return-to-factory
repair, with a 10-business day turnaround from the date of receipt of the product at Pannaway
Technologies. Pannaway Technologies, at its sole option, will either repair or replace the
nonconforming hardware. Hardware replaced under the terms of any such warranty may be
refurbished or new equipment substituted at the option of Pannaway Technologies. All repaired or
replaced hardware shall carry a warranty that is equal to either the balance of the warranty on the
original purchase or 90 days, whichever is greater.
Items may only be returned with the prior approval of Pannaway Technologies. All approvals shall
reference a return material authorization (RMA) number issued by authorized Pannaway
Technologies Service personnel. Transportation costs, if any, incurred in connection with the return of
a defective component to Pannaway Technologies shall be paid by Pannaway Technologies. If,
however, Pannaway Technologies reasonably determines that the item is functional and not
defective, the customer shall pay all transportation costs.
Any shipment cost incurred for any component returned after the warranty period has expired shall
be the responsibility of the customer.
DOA Component For up to thirty (30) days from the delivery date of the product, Pannaway Technologies will provide
expedited replacement of inoperative hardware. Upon validation of a DOA request a new
replacement unit will be shipped within 2 business days.
Pannaway Technologies shall not be liable for any data contained within any returned warranty
components.
THIS LIMITED WARRANTY IS THE ONLY WARRANTY MADE FOR THE HARDWARE AND
SOFTWARE OF THIS PRODUCT. TO THE EXTENT ALLOWED BY LAW, NO OTHER WARRANTY
APPLIES, WHETHER EXPRESS, IMPLIED, OR STATUTORY, INCLUDING ANY WARRANTY OF
MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE, OR OF NON-
INFRINGEMENT.
This warranty gives you specific legal rights which may vary from state to state. Some states do not
allow the exclusion of liability for consequential damages, so the above limitation may not apply to
you.
ii
BAR Administration Guide
iii
BAR Administration Guide
iv
CONTENTS
DECLARATIONS
Document Notice .................................................................................................................................................................... i
Copyright .................................................................................................................................................................. i
Rights......................................................................................................................................................................... i
Trademarks ............................................................................................................................................................... i
Revision History ...................................................................................................................................................... i
Standard Limited Warranty.................................................................................................................................................... ii
Hardware.................................................................................................................................................................. ii
DOA Component................................................................................................................................................... ii
Return and Repair Policy ...................................................................................................................................................... iii
CHAPTER 1: INTRODUCTION
Welcome ................................................................................................................................................................................1-1
Contents of this Chapter: ...................................................................................................................................1-1
About This Manual ..............................................................................................................................................................1-2
Manual Contents..................................................................................................................................................1-2
Audience ...............................................................................................................................................................1-3
Related Documents .............................................................................................................................................1-3
Using This Manual ...............................................................................................................................................................1-4
Document Conventions .....................................................................................................................................1-4
Management and Administration Overview....................................................................................................................1-5
Getting Technical Support .................................................................................................................................................1-5
Understanding Errors..........................................................................................................................................................2-7
Unexpected Input Errors ...................................................................................................................................2-7
Incomplete Information Errors ........................................................................................................................2-8
Getting System Help............................................................................................................................................................2-8
Listing Available Commands .............................................................................................................................2-8
Auto-Completing Fields .....................................................................................................................................2-8
Showing Key Bindings........................................................................................................................................2-8
Identifying Interfaces...........................................................................................................................................................2-9
Physical Interfaces ...............................................................................................................................................2-9
Port-Channels.......................................................................................................................................................2-9
Routing Interfaces ...............................................................................................................................................2-9
CLI Documentation Conventions...................................................................................................................................2-10
vi
BAR Administration Guide
vii
BAR Administration Guide
viii
Chapter 1
Introduction
This guide provides administration and control information for the Pannaway
Technologies Broadband Aggregation Router (BAR). The features and commands
described in this Administration Guide are available on all Broadband Aggregation
Router platforms supplied by Pannaway Technologies.
The BAR Administration Guide covers the configuration and management of a BAR
that has been installed and powered up. Instructions for BAR physical installation and
initialization are provided in the Pannaway Broadband Aggregation Router Installation Guide.
1.1 Welcome
Thank you for taking the time to read the BAR Administration Guide. This manual
contains descriptions of BAR capabilities and instructions for configuring, monitoring,
and managing the BAR as a part of an active telecommunications network.
Contents of this This chapter provides information about the manual itself, a list of the chapters and
Chapter: appendices, and instructions for using the manual and the Pannaway documentation set
to your best advantage.
BAR Administration Guide
Topic on page
1-4
About This Management and Administration Overview 1-5
Manual
Getting Technical Support 1-5
1-2
BAR Administration Guide
Chapter 11, “Session Control”, details the commands that provide information about
active management sessions and the commands that give control over those sessions.
The commands in this chapter detail changing automated session timeouts, local
console port operation settings, and the administrative disconnection of active CLI
sessions.
Chapter 12, “HTTP and SSH Configuration”, presents the commands that control Secure 1.2
HyperText Transfer Protocol (HTTPs) and Secure Shell (SSH) operation in the BAR. About This
These protocols are used to manage the BAR through web clients (Secure HTTP) or Manual
remote shells (SSH).
Chapter 13, “SNMP Commands”, presents and describes the commands that configure
and manage the operation of the BAR’s Simple Network Management Protocol
(SNMP) management client. This chapter provides information on configuring the
BAR to send SNMP messages to a remote station, the modification of SNMP
communities, and the activation of SNMP traps.
Chapter 14, “Access Control Lists” describes the creation and modification of Access
Control Lists (ACLs) and rules for the BAR.
Chapter 15, “Device Utilities” provides descriptions of CLI commands that perform
utility functions on the BAR, including custom naming, configuration clearing, system
log operations, and file and configuration transfer.
Appendix A, “List of CLI Commands”, is an alphabetical list of all the CLI commands
presented in this document with page number references for their descriptions in the
main text. This list of commands may be useful for researching a particular command
or for finding a known command in the manual.
The manual also provides a topical Index, Table of Contents, and applicable notices and
statements of rights.
Audience This manual is intended for use by the following audience groups:
• Network Administrators and Engineers responsible for the configuration and
set-up of the Pannaway BAR.
• Network Administration and Management personnel responsible for
performing add/change operations, revising configurations, and rolling out new
services or capabilities.
• Network Management personnel tasked with tracking configurations,
monitoring operational statistics, and performing periodic examinations of
system operation.
• Troubleshooters attempting to isolate and correct network issues that may
involve the BAR.
The instructions and information in this manual assume that the network administrator
or engineer working with the BAR is knowledgeable about the signaling, routing, and
networking technologies being implemented. Further, the guide assumes familiarity
with the capabilities of the BAR itself.
Related Documents The BAR Administration Guide focuses on the configuration and management of the
BAR in a functioning network, and does not provide information about other
Pannaway products or about physical installation and physical plant troubleshooting.
Information on these topics may be found in other documents produced by Pannaway
Technologies.
1-3
BAR Administration Guide
Other Documents Other information about the configuration of the BAR, and the administration of the
Pannaway Service Convergence Network, may be found in the following documents:
• Pannaway BAR Installation Guide
• Pannaway BAR-GE12 Quick Installation Card
1.3 •
•
•
Pannaway BAS Installation and Administration Guide
Pannaway PBG User Guide
Pannaway RGN-ADSL User Guide
Using This
Manual Obtaining Documents Pannaway Technologies, Incorporated maintains its own document sets and provides
copies of documents to resellers and to supported customers directly. Pannaway
maintains current versions of the documentation set, and can supply versions applicable
to particular product releases if required.
If you require Pannaway documentation, you may call Pannaway Technologies to
request a documentation set. The documentation set can be provided in CD-ROM
format, or may be downloaded from the Pannaway Technologies support and service
web site.
Document Throughout this document, certain presentations of text and other items are used
Conventions consistently.
Cautions This document provides text callouts that announce potential hazards. The callouts are
used to draw attention to important safety or performance issues. The type of hazard or
danger is dependent upon the type of callout that is provided.
CAUTION: Cautions provide notification that an action, if taken, may damage the
BAR or other equipment, cause degradation of network performance, or result in
unintentional misconfiguration of the BAR.
In all cases, pay particular attention to the Caution callouts. Other types of warning and
caution callouts may be found in the text, and should always be read before proceeding
with a step or action.
Notes and Tips The Note and Tip callouts in the text supply additional information to make
installation, management, and configuration of the BAR easier. These notes and tips
may not apply to all conditions or implementations.
NOTE: This format is used for Notes. Notes are used to provide additional
information concerning associated steps or actions.
TIP: This format is used for Tips. Tips are used to provide advanced information
which will enhance the understanding of the task in the future.
1-4
BAR Administration Guide
CLI Presentation All CLI commands presented in this document follow a consistent organization and use
a particular formatting. A description of this formatting is provided in Chapter 2, “Using
the BAR CLI”, which gives a general introduction to the Command Line Interface’s
capabilities and to the command descriptions in this Guide.
1-5
BAR Administration Guide
1.5 •
•
•
Severity level of the issue
A brief problem description
Current firmware version
Getting • Pertinent log files
Technical • Serial numbers of affected hardware
Support • Pertinent network traces
• History of any network changes
Each issue reported to Pannaway Technologies will have an associated Service Request
(SR) number assigned. Be sure to obtain your SR number to properly track your issue.
For first-time service requests via web or e-mail, your SR number will be supplied to
you upon our initial response.
1-6
Chapter 2
Using the BAR CLI
This chapter explains the use of the Command Line Interface and the conventions used
in this document to present and describe CLI commands.
The Pannaway BAR provides a mode-based Command Line Interface that can be used
for the administration and monitoring of all BAR operations. Every configurable setting
in the BAR may be accessed and modified through the system CLI.
Topic on page
2.2 Local Console The BAR CLI can be accessed by a terminal or emulator connected to the front panel
Accessing CLI
Interface Console port of the BAR. This DB9 serial interface provides a direct, local connection
management to the system CLI.
The initial configuration of the BAR, as described in the Pannaway BAR Installation
Guide, must be performed through the front panel console connection. Only after the
completion of the minimum field configuration can the BAR be accessed by a remote
terminal session.
Instructions for connecting a terminal to the BAR console port and initiating a CLI
management session are provided in the Pannaway BAR Installation Guide. Once
connected, all management operations can be performed through the local connection
as presented in this Administration Guide. The default settings for a local console
management session are as follows:
• 9600 bps
• 8 data bits, 1 stop bit
• no parity
Remote Terminal The BAR CLI responds to remote, in-band terminal sessions. These sessions connect
Session to the BAR through existing and operating network interfaces, and can be initiated
remotely by any station that knows the BAR’s IP address and has a valid network
connection to any of its operating interfaces.
To establish a remote terminal session, a network management station must open a
Telnet or SSH connection to the BAR’s IP address - either via a terminal emulation
session or directly from the management station’s command line (if supported by
the OS).
Once the session is established, the BAR will prompt for a username and password
combination. The field configuration of the Pannaway BAR includes modifying the
default system password for improved security. Contact the responsible field installation
personnel to determine the password configured for the BAR.
A successful login places the terminal session in the “user exec” mode. From this mode,
some BAR statistics and settings may be examined or changed. To perform more
sensitive or detailed configuration, it is necessary to move through the various
command modes of the BAR CLI. These modes, and the means of changing between
them, are described in Section 2.5 , “Navigating Command Modes”.
2-2
BAR Administration Guide
Parameters A command may also require that certain values or settings be supplied. If the
parameters are needed for the command to be processed by the CLI, they are
considered mandatory parameters. If the additional parameters perform actions that
are not essential to the command, or that provide additional control information, they
are considered optional parameters.
A command parsed by the BAR CLI is examined for any mandatory parameters and
optional parameters that may specify a particular use of the command, or to determine
what settings to apply to the command. The CLI documentation provides indications
of both mandatory and optional parameters for every command.
Values Many parameters require the submission of values. Values may be alphanumeric strings
describing a configured field, numerical values representing configuration data, or a
combination of the two. Some values require input that falls within a certain acceptable
range. If a value is outside of the range, or provided in the wrong form, the CLI will
produce an error message and ignore the command. In all cases, the CLI
documentation will explain the expected type and acceptable ranges of command
values.
2-3
BAR Administration Guide
2.5 The Mode Structure The BAR CLI separates groups of control and monitoring commands into modes.
Navigating
These various modes each support specific aspects of BAR software operation. The
Command commands available to an operator at any given point in a management session depend
Modes on the current model of the CLI session. A mode’s commands are not available until
the management session has entered that mode. Once a session enters a mode, the
commands outside of that mode are not available to the management session.
NOTE: The “Privileged Exec” mode is an exception to this rule - in the Privileged
Exec mode, all commands of the “User Exec” mode are available to the
management session.
All CLI sessions begin in the “User Exec” mode. This mode provides a limited number
of commands and control options. Other modes can be reached by moving through the
mode hierarchy, as described in “Changing Modes” on page 2-6.
User Exec When the operator logs into the CLI, the User Exec mode is the initial mode. The User
Exec mode contains a limited set of commands.
2-4
BAR Administration Guide
Privileged Exec To have access to the full suite of commands, the operator must enter the Privileged
Exec mode. The Privileged Exec mode requires password authentication. From
Privileged Exec mode, the operator can issue any Exec command or enter the Global
Configuration mode.
Global Config This mode permits the operator to make modifications to the running configuration.
General setup commands are grouped in this mode. From the Global Configuration
2.5
mode, the operator can enter the System Configuration mode, the Physical Port config, Navigating
the Interface Configuration mode, or the Protocol Specific modes specified below. Command
From the Global Config mode, the operator may enter the following config modes: Modes
Interface Config Many features are enabled for a particular interface. The Interface commands enable or
modify the operation of an interface.
In this mode, a physical port is set up for a specific logical connection operation. The
Interface Config mode provides access to the router interface configuration commands.
Line Config This mode allows the operator to configure the console interface. The operator may
configure the interface from the directly connected console or the virtual terminal used
with a terminal emulation program.
Policy Map Use the policy-map command to access the QoS policy map configuration mode to
configure the QoS policy map.
Policy Class Use the class command to access the QoS policy-classmap mode to configure the QoS
policy map.
Class Map This mode consists of class creation/deletion and matching commands. The class
match commands specify layer 2, layer 3 and general match criteria. Use the class-map
commands to access the QoS class map configuration mode to configure QoS class
maps.
Router Config OSPF In this mode, the operator is allowed to access the router OSPF configuration
commands.
Router Config RIP In this mode, the operator is allowed to access the router RIP configuration commands.
Router Config BGP In this mode, the operator is allowed to access the router BGP4 configuration
commands.
Bwprovisioning Config Use the bwprovisioning command to access the Bandwidth provisioning Config Mode
to configure bandwidth provisioning.
Bwprovisioning - Use the traffic-class command to access the Bandwidth provisioning Config Mode to
Trafficclass configure bandwidth traffic class.
Bwprovisioning- Use the bwallocation command to access the Bandwidth provisioning Config Mode to
bwallocation configure bandwidth allocation.
DHCP Pool Configuration Use the ip dhcp pool <pool-name> command to access the DHCP Pool Config Mode.
2-5
BAR Administration Guide
Changing Modes Movement between the various modes is accomplished by submitting commands. To
enter the Privileged Exec mode, for example, the “enable” command is entered at a
User Exec prompt. The system then asks for a password (as the Privileged Exec mode
2.5 is password-secured) and changes the mode. To indicate the new mode, a series of
characters is added to the BAR’s name prompt. This “command suffix” identifies the
mode of the CLI.
Navigating
Command Entering Modes Other mode changes require the submission of specific commands. The table that
Modes follows presents each mode by name, describes the command needed to enter that
mode, and shows the prompt suffix that identifies the mode.
.
Router Config BGP From the Global Config mode, (Config-router bgp)#
enter the router bgp command
2-6
BAR Administration Guide
Bwprovisioning -
enter the traffic-class
command
Exiting Modes A management session may exit any CLI mode by either “backing out” to the next
highest mode, or by jumping directly to the User Exec mode. The following methods
are used to close and exit CLI modes:
• Type the “exit” command to leave a CLI mode and back out to the previous
mode. For example, entering the “exit” command when in the VLAN mode
will back the session out to the Privileged Exec mode.
• Press the CONTROL and Z keys on the terminal keyboard to send a session
reset signal to the BAR. If the CLI is in a configuration mode, it will “back out”
to the Privileged Exec mode. If the CLI is in Privileged Exec mode or another
non-configuration mode, the CLI will immediately exit the current CLI mode
and return the session to the User Exec mode.
• Type “logout” at the User Exec or Privileged Exec mode prompt to close the
terminal session and exit CLI management.
Unexpected Input The error messages produced by the BAR indicate the point at which the parsing of the
Errors command was interrupted. This point may show a misspelling of a command, or may
show that a parameter that is not part of the command was supplied mistakenly.
For instance, supposing the operator intends to enter the show arp brief routing
command, but accidentally types “show arpp brief”. The command parser would
display the following error message:
The user could then re-enter the command with the correct spelling, submit the
command, and get the summary arp information for the BAR (the expected output of
the command).
2-7
BAR Administration Guide
Incomplete If the CLI receives a command from the management session that lacks a required field
Information Errors or needs additional specificity, the CLI will produce an incomplete information error
message. This type of error message indicates only that the command requires some
2.7 additional input from the user. Following the error message, the command as it was
submitted is automatically entered at the current system prompt.
If, for example, an operator submitted the port-channel <name> CLI command, which
Getting System
creates a VLAN port channel, but did not provide the <name> parameter, the CLI
Help
would respond as shown below:
The operator could then refer to the documentation for the command, enter an
appropriate name for the new port channel, and re-submit the command.
Listing Available All modes of the BAR CLI provide access to a list of available commands for the
Commands current mode. To display the list of commands that may be entered, type the question
mark (“?”) character at the command prompt. A list of commands, in alphabetical
order, will be displayed.
Auto-Completing The BAR CLI supports an auto-completion function that can supply the full text of a
Fields command component or parameter. Auto-completion examines the content of the
current command line entry and compares any partially-completed command input to
the table of expected input for the command. If a match is found, the CLI can fill in the
remaining portion of the element or parameter, and the operator can continue typing or
submitting the command.
To call on the auto-completion function, press the Space Bar of the management client
after typing a portion of the command. If there is enough text available that the CLI
interface can determine the item or argument being entered, the text of that item will be
automatically filled in. If the information at the end of the command is insufficient for
the BAR CLI to make a completion determination, the CLI will simply add a space to
the current line of text.
The CLI cannot perform auto-completion for operator-supplied parameters such as
addresses, names, or configuration values.
Showing Key At any CLI prompt, the operator may type the “help” command to show a list of the
Bindings special keys that the CLI session supports. These special keys offer shortcuts for
common or useful operations, such as ending terminal sessions, moving the cursor
through a line of command text, or other special operations.
2-8
BAR Administration Guide
Physical Interfaces The physical interfaces of the BAR are grouped into slot “0” (zero). This slot contains
all the addressable physical interfaces in the BAR, including the Gigabit Ethernet Small
Form-factor Pluggable (SFP) transceiver ports and the two fixed-media RJ45 ports.
Ports in slot 0 are numbered from 1 to 12, with ports 1 through 10 representing the SFP
ports, and ports 11 and 12 representing the Cat5 10/100/1000BASE-T ports. The
numbering scheme for the ports corresponds to the numbering of the connectors
printed on the rear panel of the BAR chassis.
Port-Channels If link aggregation is enabled on the BAR, the slot/port designation is also used to
identify the link aggregations, or “port-channels”. All port-channels in the BAR are part
of slot “1” (one). This slot is a “logical”, or virtual slot, which is used by the BAR to
associate, concentrate, and direct traffic to and from an attached LAG-capable device.
Ports in slot 1 are numbered from 1 (one) to 6 (six). Port-channel port numbers are
automatically generated by the BAR through the use of the port-channel <name>
command, as described on page 4-2. Any currently defined port-channel interfaces can
be seen by using the command show port-channel {<logical slot/port> | all} on page 4-39.
NOTE: If the BAR being managed is operating with version 1.0.x firmware, the
Port-channel interfaces are assigned to ports 1 through 8.
Routing Interfaces If routing is enabled on a physical BAR interface, a routing interface is also created. All
routing interfaces in the BAR are members of slot “3” (three). Routing interfaces are
logical, or virtual interfaces that are used for the direction of routed traffic in the BAR.
Ports in slot 3 are numbered from 1 (one) to 16 (sixteen). The logical ports are
automatically generated by the BAR when routing is enabled on a particular BAR
interface.
NOTE: If the BAR being managed is operating with version 1.0.x firmware, the
routing interfaces are members of slot “2”.
2-9
BAR Administration Guide
Angle Brackets < > Angle brackets indicate a value, usually a numerical value or a string of alphanumeric
characters, that the operator must supply. An item in angle brackets must be provided to
a command unless it is specifically connected to, and enclosed in the square brackets of,
an optional parameter.
Square Brackets [ ] Square brackets show that the items enclosed in the brackets are optional parameters
that may be used. These optional parameters provide additional detail or greater
customization of a command or setting.
Curved Braces { } The use of curved braces around a value, command text, or a group of selections
indicates that the items inside the braces are mandatory.
Selections | If the brackets or braces contain multiple items separated by the “pipe” symbol ( | ),
those items are selections. When entering the CLI command, a value or item from the
selections provided is expected.
The following page shows an example of the CLI documentation format as it is
presented in the rest of the BAR Administration Guide.
2-10
BAR Administration Guide
2.9
Summary The Summary presents a short description of the command, and is provided as an aid
to scanning the command documentation.
Required Mode The Required Mode information lists the operational mode that must be active in order
CLI
to submit the command.
Documentation
User-Entered [mandatory parameter] Conventions
Parameters Each mandatory and optional parameter, its meaning, and any description of how it is
used is presented in this section.
<value>
Any values that the command uses are also listed here, with descriptions of the units,
format, and acceptable ranges of the value.
Description The Description field presents a more detailed explanation of the command. If any
additional information is useful for understanding the command, the effects of the
command, or calculating values that should be used, that information will be
presented here.
Defaults The Defaults section identifies the default condition or settings of the command. If the
mandatory parameters, optional parameters, or values have default states in the BAR,
those items will be presented here. Similarly, if a command activates or deactivates a
particular function in the BAR, the default state of that function will be identified.
Example This portion of the command documentation shows an example of the command as it
would be entered in a CLI session. If the command returns formatted output or
statistics, an example of that will be shown beneath the command.
Command Output Commands that provide statistics or system configuration information will provide this
Command Output section. This section lists the items shown on screen and explains
the importance or meaning of the information. If the information requires additional
description, a table may be provided.
Related Commands If a command has any other commands directly associated with it, those commands will
be listed here, with a reference to the chapter and page number where the command is
described.
2-11
BAR Administration Guide
2.9
CLI
Documentation
Conventions
2-12
Chapter 3
Switch Configuration
Commands
This chapter provides a list and descriptions of the switch configuration and set up
commands used to configure and control switching, port, and network behavior in the
Pannaway BAR.
Topic on page
auto-negotiate
User-Entered None
Parameters
Description This command configures the current interface to auto-negotiation. This allows the
interface to react to the network it is connected to and negotiate the highest allowable
throughput.
Example
3.2
(Pannaway BAR) (Interface 0/3)#auto-negotiate
auto-negotiate all
User-Entered None
Parameters
Description This command sets all interfaces on the Pannaway BAR to auto-negotiation mode. This
allows the interface to react to the network it is connected to and negotiate the highest
allowable throughput.
Example
Summary Manually set speed and duplex mode for current interface.
User-Entered <portspeed>
Parameters The interface operational mode to set the selected interface to. Valid choices are as
follows:
• 1000: 1000BASE-T
• 100: 100BASE-T
• 10: 10BASE-T
full-duplex
If the full duplex parameter is specified, the interface is set to full-duplex mode.
3-2
BAR Administration Guide
half-duplex
If the half-duplex parameter is supplied, the interface is configured for half-duplex
operation.
NOTE: Half-duplex mode is available for 10BASE-T and 100BASE-T port speeds
only. The 1000BASE-T port speed operates in full-duplex mode only. 3.2
Port
Configuration
Description This command sets the speed and duplex setting for the currently configured interface.
Commands
NOTE: If the port is currently set to auto-negotiate, you get a message informing
you that auto-negotiation must be disabled to change the physical port
configuration.
You cannot change the physical attributes of ports currently in a port-channel
(LAG).
Defaults None
Example
Summary Manually force speed and duplex mode for all interfaces.
User-Entered <portspeed>:
Parameters The interface operational mode to set the BAR interfaces to. Valid choices are as
follows:
• 1000: 1000BASE-T
• 100: 100BASE-T
• 10: 10BASE-T
full-duplex
If the full duplex parameter is specified, all BAR interfaces are set to full-duplex mode.
half-duplex
If the half-duplex parameter is supplied, all interfaces are configured for half-duplex
operation.
NOTE: Half-duplex mode is available for 10BASE-T and 100BASE-T port speeds
only. The 1000BASE-T port speed operates in full-duplex mode only.
3-3
BAR Administration Guide
Description This command sets the speed and duplex setting for all Gigabit Ethernet capable
interfaces in the BAR.
3.2
NOTE: If the port is currently set to auto-negotiate, you get a message informing
you that auto-negotiation must be disabled to change the physical port
configuration.
Port You cannot change the physical attributes of ports currently in a port-channel
Configuration (LAG).
Commands
“no” Form None
Defaults None
Example
shutdown
User-Entered None
Parameters
Description This command administratively disables the currently selected port of the BAR. The
port will not participate in the connected network, but the Link and Activity LEDs will
continue to show the status of the physical connection to any attached media.
Example
shutdown all
User-Entered None
Parameters
3-4
BAR Administration Guide
Description This command places all the network interface ports of the BAR into a disabled mode.
When in this mode, the interfaces will not participate in their connected networks. Link
and Activity LEDs on the BAR will show the physical status of the attached media but
the ports will pass no traffic.
User-Entered <age-time>
Parameters The bridge entry aging time to be configured, measured in seconds. This value may be
from 10 to 1000000.
[<fdbid> | al]]
The selection of either the forwarding database ID of a particular forwarding database,
or “all”, specifying all forwarding databases on the BAR.
Description This command configures the forwarding database address aging timeout in seconds.
Example
3-5
BAR Administration Guide
mtu <mtu-size>
Description This command sets the maximum transmission unit (MTU) size (in bytes) for physical
and port-channel (LAG) interfaces.
Example
Summary Set the type of MAC address the BAR will use.
Description This command specifies whether the burned-in MAC address or the locally-
administered MAC address is used.
Example
3-6
BAR Administration Guide
Description This command sets a locally administered MAC addresses for the switch.
Defaults None
Example
3-7
BAR Administration Guide
Description This command specifies the network configuration protocol to be used. If you modify
this value, the change is effective immediately, and any current IP configuration is
discarded. For example, switching from dhcp to none will release the DHCP-assigned
IP address.
User-Entered <ipaddr>
Parameters The IP address, in dotted decimal notation, to assign to the BAR’s IP interface.
<netmask>
The network mask, in dotted decimal notation, that identifies the network and host
portions of the IP address.
<gateway>
The default gateway for the IP interface of the BAR. This value is the IP address, in
dotted decimal notation, of the gateway interface.
Description This command sets the IP address, subnet mask and gateway of the BAR. The IP
address and the gateway must be on the same subnet. The network protocol must be set
to “none” to manually configure IP network information.
Defaults None
Example
Related Commands network protocol {none | bootp | dhcp} [yes] on page 3-7
show network on page 3-10
3-8
BAR Administration Guide
storm-control broadcast
10 Mbps 20 10
100 Mbps 5 2
1000 Mbps 5 2
Example
storm-control flowcontrol
User-Entered None
Parameters
Description This command enables 802.3x flow control for the switch.
3-9
BAR Administration Guide
Example
3.4
(Pannaway BAR) (Config)#storm-control flowcontrol
show network
User-Entered None
Parameters
Description This command displays configuration settings associated with the switch’s network
interface. The network interface is the logical interface used for in-band connectivity
with the switch via any of the switch’s network (Gigabit Ethernet) ports. The
configuration parameters associated with the switch’s network interface do not affect
the configuration of the front panel ports through which traffic is switched or routed.
Defaults None
Example
IP Address..................................... 10.10.4.137
Subnet Mask.................................... 255.255.255.0
Default Gateway................................ 10.10.4.1
Burned In MAC Address.......................... 00:0A:9F:50:00:18
Locally Administered MAC Address............... 5A:12:34:A3:25:C3
MAC Address Type............................... Burned In
Network Configuration Protocol Current......... DHCP
Management VLAN ID............................. 1
Web Mode....................................... Enable
Java Mode...................................... Enable
Command Output: The following information is presented in response to the show network command:
Subnet Mask The IP subnet mask for this interface. The factory
default value is 0.0.0.0.
Default Gateway The default gateway for this IP interface. The factory
default value is 0.0.0.0.
Burned In MAC Address The burned in MAC address used for in-band
connectivity.
3-10
BAR Administration Guide
Locally Administered MAC Address The local MAC address that has been adminstratively
configured for in-band connectivity (if set);
00:00:00:00:00:00 indicates a local MAC address is
not set.
MAC Address Type The currrently used MAC address type for in-band
connectivity (Burned In or Locally Administered). The
default setting is Burned In).
3.4
Switching
Network Configuration Protocol The network protocol being used.
Current Display
Commands
Management VLAN ID Indicates the management VLAN ID.
Java Mode Indicates if the switch allows access to the Java applet
in the header frame of the Web management
application. Enabled indicates the applet can be
viewed; the default is disabled.
show storm-control
Summary Show the broadcast storm and flow control settings of the BAR.
User-Entered None
Parameters
Description This command displays switch configuration information for the BAR, focusing on the
broadcast storm recovery and flow control settings.
Defaults None
Example
3-11
BAR Administration Guide
Command Output: The following information is shown in response to the show storm-control command:
Broadcast Storm Recovery Indicates whether Broadcast Storm Recovery mode is enabled
Mode or disabled; the default is disabled.
3.5 802.3x Flow Control Mode Indicates whether 802.3x Flow Control is enabled or disabled;
the default is disabled.
Spanning Tree
Related Commands storm-control broadcast on page 3-9
Configuration storm-control flowcontrol on page 3-9
Commands
spanning-tree
User-Entered None
Parameters
Example
3-12
BAR Administration Guide
Description This command sets the STP mode for a specific port-channel (LAG). This is the value
specified for STP Mode on the Port Configuration Menu. The interface is a logical slot
and port for a configured port-channel. The all option sets all configured port-channels
(LAGs) with the same option.
Description This command enables BPDU migration check on a specified interface. The all option
enables BPDU migration check on all interfaces.
Defaults None
Example
User-Entered <name>
Parameters A descriptive name of up to 32 characters.
NOTE: You must surround the Spanning Tree configuration name in quotation
marks (““) to use spaces in the name. If you enter a space in the text string without
using surrounding quotes, you get an invalid input error.
Description This command sets the Configuration Identifier Name for use in identifying the
configuration that this switch is currently using.
3-13
BAR Administration Guide
3.5 Defaults Name: the base MAC address displayed using hexadecimal notation as specified in the
IEEE 802 standard.
Summary Assign a configuration revision number to the current Spanning Tree settings.
User-Entered <revision-level>
Parameters A number from 0 to 65535 that indicates the revision or iteration of the Spanning Tree
configuration of the BAR.
Description This command sets the Configuration Identifier Revision Level for use in identifying
the configuration that this switch is currently using.
Defaults Revision-level: 0
Example
spanning-tree edgeport
User-Entered None
Parameters
Description This command specifies that the currently configured port is an Edge Port within the
common and internal spanning tree. This will allow this port to transition to
Forwarding State without delay.
3-14
BAR Administration Guide
Defaults
Example
None
3.5
(Pannaway BAR) (Interface 0/11)#spanning-tree edgeport
Spanning Tree
Configuration
Commands
spanning-tree forceversion <802.1d | 802.1w | 802.1s>
• 802.1d: ST BPDUs are transmitted rather than MST BPDUs (IEEE 802.1d
functionality supported)
• 802.1w: RST BPDUs are transmitted rather than MST BPDUs (IEEE 802.1w
functionality supported)
• 802.1s: MST BPDUs are transmitted (IEEE 802.1s functionality supported)
Description This command sets the Force Protocol Version parameter to a new value.
Example
User-Entered <f-time>
Parameters The forwarding time, in seconds, that will be used by the BAR. The range for this value
is from 4 to 30, with the value being greater than or equal to:
BridgeMaxAge
---------------------------------------- + 1
2
Description This command sets the Bridge Forward Delay parameter to a new value for the
common and internal spanning tree.
3-15
BAR Administration Guide
3.5 Defaults
Example
F-time: 15
User-Entered <h-time>
Parameters The hello time interval, in seconds, to be used on the BAR. The range for this value is
from 1 to 10, with the value being less than or equal to:
BridgeMaxAge
---------------------------------------- – 1
2
Description This command sets the Hello Time parameter to a new value for the common and
internal spanning tree.
Defaults H-time: 2
Example
Summary Set the bridge maximum age parameter for spanning tree operation on the BAR.
User-Entered <bridge-max-age>
Parameters The maximum age time, in seconds, that the BAR will use for both common and
internal spanning tree operation. The value may be from 6 to 40, with the value being
less than or equal to:
( BridgeForwardDelay – 1 ) × 2
3-16
BAR Administration Guide
Description This command sets the Bridge Max Age parameter to a new value for the common and
internal spanning tree.
User-Entered <mstid>
Parameters If the <mstid> parameter corresponds to an existing multiple spanning tree instance,
then the configurations are done for that multiple spanning tree instance. However,
if 0 (defined as the default CIST ID) is passed as the <mstid>, then the configurations
are performed for the common and internal spanning tree instance.
{<cost-value> | auto}
The path cost for this port within a multiple spanning tree instance or the common and
internal spanning tree instance, depending on the <mstid> parameter. The <cost-
value> is a number in the range of 1 to 200000000. If the “auto” selection is specified,
the pathcost value will be automatically determined based on Link Speed.
Description This command sets the Path Cost for the currently configured port within the multiple
spanning tree instance or in the common and internal spanning tree.
Example
Related Commands show spanning-tree mst port detailed <mstid> <slot/port> on page 3-25
3-17
BAR Administration Guide
Description This command sets the Port Priority for the currently configured port within the
multiple spanning tree instance or in the common and internal spanning tree.
Example
Related Commands show spanning-tree mst port detailed <mstid> <slot/port> on page 3-25
User-Entered <mstid>
Parameters The ID of the new multiple spanning tree instance being created on the BAR. The
<mstid> is a number within the range of 1 to 4094.
Description This command adds a multiple spanning tree instance to the switch. The maximum
number of multiple instances supported by the Pannaway BAR is 4.
Defaults None
3-18
BAR Administration Guide
Example
Related Commands show spanning-tree mst port detailed <mstid> <slot/port> on page 3-25
3.5
spanning-tree mst priority <mstid> <bridge-priority> Spanning Tree
Configuration
Summary Set priority for an MST instance. Commands
Required Mode Global Config
User-Entered <mstid>
Parameters The identification of an existing multiple spanning tree instance on the BAR. The
<mstid> is a number within the range of 1 to 4094.
<bridge-priority>
The bridge priority value for the MSTID. The priority value is a number within a range
of 0 to 61440 in increments of 4096.
NOTE: If the bridge priority value supplied is not a multiple of 4096, the system will
round the value supplied to the nearest multiple and provide a message to the
current CLI session.
Description This command sets the bridge priority for a specific multiple spanning tree instance.
If 0 (defined as the default CIST ID) is passed as the <mstid>, then this command sets
the Bridge Priority parameter to a new value for the common and internal spanning
tree.
Example
Priority specified was converted to 8192 (according to IEEE 802.1s) and stored
successfully.
User-Entered <mstid>
Parameters The identification of an existing multiple spanning tree instance on the BAR. The
<mstid> is a number within the range of 1 to 4094.
3-19
BAR Administration Guide
<vlanid>
The VLAN ID of an existing VLAN on the BAR.
Description This command adds an association between a multiple spanning tree instance and a
3.5
VLAN. The VLAN will no longer be associated with the common and internal
spanning tree.
Defaults None
Example
User-Entered None
Parameters
Description This command sets the Administrative Switch Port State for the currently configured
port to enabled.
Example
User-Entered None
Parameters
Description This command sets the Administrative Switch Port State for all ports to enabled.
3-20
BAR Administration Guide
Defaults
Example
Mode disabled
3.6
(Pannaway BAR) (Config)#spanning-tree port mode all
Spanning Tree
Display
Commands
Related Commands show spanning-tree interface <slot/port> on page 3-23
User-Entered [brief]
Parameters This optional parameter provides less extensive output.
Description This command displays spanning tree settings for the common and internal spanning
tree.
Defaults None
Example
3-21
BAR Administration Guide
Bridge Priority The current decimal value of the bridge priority value setting
of the BAR.
3.6 Bridge Identifier The octal value of the bridge priority, combined with the
bridge MAC address to form a unique identification.
Spanning Tree Time Since Topology Change The number of seconds that have elapsed since the last
Spanning Tree Topology Change notification was received.
Display
Commands Topology Change Count The number of topology change notifications received since
the last reset.
Topology Change in Progress Boolean value of the Topology Change parameter for the
switch indicating if a topology change is in progress on any
port assigned to the common and internal spanning tree.
Designated Root The octal value of the Root Bridge’s priority value and the
MAC address of that bridge port, combined to identify the
current designated root bridge.
Root Path Cost Value of the Root Path Cost parameter for the common and
internal spanning tree.
Root Port Max Age Configured maximum age for the root port’s eligibility.
Shown for root ports only.
Root Port Bridge Forward Delay Derived forwarding delay for the port. This value is
displayed for root ports only.
CST Regional Root Port priority and MAC address of the regional root bridge.
Regional Root Path Cost Path cost parameter for the regional root bridge.
Associated VLANs List of VLAN IDs currently associated with this instance.
When the “brief” optional parameter is included, this command displays spanning tree settings for
the bridge. In this case, the following details are displayed.
Bridge Priority The octal value of the bridge priority, combined with the
bridge MAC address to form a unique identification.
Bridge Identifier Value of the Root Path Cost parameter for the common and
internal spanning tree.
Bridge Max Age Configured maximum age for the root port’s eligibility.
3-22
BAR Administration Guide
User-Entered <slot/port>
Parameters A unique interface on the BAR identified by the combination of slot number and port
number.
Description This command displays the settings and parameters for a specific switch port within the
common and internal spanning tree.
Defaults None
Example
Command Output: The following details are displayed on execution of the command:
Port Up Time Since Counters Time since port was reset, displayed in days, hours, minutes,
Last Cleared and seconds.
STP BPDUs Transmitted Spanning Tree Protocol Bridge Protocol Data Units sent.
STP BPDUs Received Spanning Tree Protocol Bridge Protocol Data Units received.
RSTP BPDUs Transmitted Rapid Spanning Tree Protocol Bridge Protocol Data Units sent.
RSTP BPDUs Received Rapid Spanning Tree Protocol Bridge Protocol Data Units
received.
MSTP BPDUs Transmitted Multiple Spanning Tree Protocol Bridge Protocol Data Units
sent.
MSTP BPDUs Received Multiple Spanning Tree Protocol Bridge Protocol Data Units
received.
3-23
BAR Administration Guide
Spanning Tree Summary Show spanning tree settings for a multiple spanning tree instance.
Display
Commands Required Mode Privileged Exec and User Exec
User-Entered <mstid>
Parameters The numerical ID of an existing Multiple Spanning Tree instance.
Description This command displays settings and parameters for the specified multiple spanning tree
instance. The instance <mstid> is a number that corresponds to the desired existing
multiple spanning tree instance ID.
Defaults None
Example
MST Bridge Priority The decimal priority value of the MST interface.
MST Bridge Identifier The octal value of the bridge priority, combined with the bridge
MAC address to form a unique identification.
Time Since Topology Change The number of seconds that have elapsed since the last
Spanning Tree Topology Change notification was received.
Topology Change Count Number of times the topology has changed for this multiple
spanning tree instance.
Topology Change in Progress Value of the Topology Change parameter for the multiple
spanning tree instance.
Designated Root Identifier of the Regional Root for this multiple spanning tree
instance.
3-24
BAR Administration Guide
Root Path Cost Path Cost to the Designated Root for this multiple spanning
tree instance.
Root Port Identifier Port to access the Designated Root for this multiple spanning
3.6
tree instance.
Summary Show detailed settings for a port within a multiple spanning tree instance.
User-Entered <mstid>
Parameters The numerical ID of an existing Multiple Spanning Tree instance.
<slot/port>
A unique interface on the BAR identified by the combination of slot number and port
number.
Description This command displays the detailed settings and parameters for a specific switch port
within a particular multiple spanning tree instance.
Defaults None
Example
3-25
BAR Administration Guide
MST Instance ID The identification number of the Multiple Spanning Tree instance.
3.6
Port Identifier Octal value identifying the MST port.
Port Path Cost Configured value of the Internal Port Path Cost parameter.
Designated Root The Identifier of the designated root for this port.
Designated Port Cost Path Cost offered to the LAN by the Designated Port.
Designated Bridge Bridge Identifier of the bridge with the Designated Port.
Designated Port Identifier Port on the Designated Bridge that offers the lowest cost to the
LAN.
If 0 (defined as the default CIST ID) is passed as the <mstid>, then this command
displays the settings and parameters for a specific switch port within the common and
internal spanning tree. The <slot/port> is the desired switch port. In this case, the
following are displayed.
Port Identifier The port identifier for this port within the CST.
Port Forwarding State The forwarding state of the port within the CST.
Port Role The role of the specified interface within the CST.
Port Path Cost The configured path cost for the specified interface.
Designated Root Identifier of the designated root for this port within the CST.
Designated Port Cost Path Cost offered to the LAN by the Designated Port.
Designated Port Identifier Port on the Designated Bridge that offers the lowest cost to the
LAN.
Topology Change Value of flag in next Configuration Bridge Protocol Data Unit
Acknowledgement (BPDU) transmission indicating if a topology change is in
progress for this port.
Edge Port The configured value indicating if this port is an edge port.
Edge Port Status The derived value of the edge port status. True if operating as an
edge port; false otherwise.
Point To Point MAC Status Derived value indicating if this port is part of a point to point link.
CST Regional Root The regional root identifier in use for this port.
CST Port Cost The configured path cost for this port.
3-26
BAR Administration Guide
Related Commands spanning-tree mst <mstid> {cost <cost-value> | auto} on page 3-17
spanning-tree mst instance <mstid> on page 3-18
spanning-tree mst priority <mstid> <bridge-priority> on page 3-19
spanning-tree mst vlan <mstid> <vlanid> on page 3-19
User-Entered <mstid>
Parameters The numerical ID of an existing Multiple Spanning Tree instance.
{<slot/port> | all}:
The selection of either an identified unique interface on the BAR (identified by the
combination of slot number and port number), or “all”, specifying all interfaces on the
BAR.
Description This command displays the settings of one or all ports within the specified multiple
spanning tree instance.
If 0 (defined as the default CIST ID) is passed as the <mstid>, then the status summary
is displayed for one or all ports within the common and internal spanning tree.
Defaults None
Example
STP Mode This field shows the condition (Enabled or Disabled) of Spanning Tree
operation on the port. The enabled condition indicates that 802.1d or
fast spanning tree mode is active on the port.
3-27
BAR Administration Guide
Type This field is not fully supported in the current implementation of the
Spanning Tree display commands.
STP State The forwarding state of the port in the specified spanning tree instance.
3.6 Port Role The role of the specified port within the spanning tree.
Summary Show information about all multiple spanning tree instances on the BAR.
User-Entered None
Parameters
Description This command displays summary information about all multiple spanning tree
instances in the switch.
Defaults None
Example
MST Instance ID List List of multiple spanning trees IDs currently configured.
Associated FIDs List of forwarding database identifiers associated with this instance.
3-28
BAR Administration Guide
Defaults None
Example
Spanning Tree Version Version of 802.1 currently supported (IEEE 802.1s, IEEE
802.1w, or IEEE 802.1d) based upon the Force Protocol
Version parameter.
Configuration Revision Level The revision level of the current spanning tree configuration.
Configuration Digest Key A generated key used to uniquely identify the configuration.
3-29
BAR Administration Guide
Summary Show associations between a VLAN and a multiple spanning tree instance.
Defaults None
Example
VLAN Identifier................................ 2
Associated MST Instance........................ 2
Associated MST Identifier for the associated multiple spanning tree instance or "CST"
Instance if associated with the common and internal spanning tree.
User-Entered None
Parameters
Description This command displays connectivity between the switch and other devices. The
Address Resolution Protocol (ARP) cache identifies the MAC addresses of the IP
stations communicating with the switch.
Defaults None
3-30
BAR Administration Guide
Example
Slot/Port Slot and port combination indicating the BAR interface that the ARP
information (response) was received on.
Description This command displays a summary of statistics for a specific port or a count of all CPU
traffic based upon the argument.
Defaults None
Example
Command Output: The display output when the <slot/port> parameter is supplied are as follows:
Packets Received Without Error The total number of packets (including broadcast packets
and multicast packets) received by the processor.
Packets Received With Error The number of inbound packets that contained errors
preventing them from being deliverable to a higher-layer
protocol.
3-31
BAR Administration Guide
Broadcast Packets Received The total number of packets received that were directed to
the broadcast address. Note that this does not include
multicast packets.
3.7
Packets Transmitted Without The total number of packets transmitted out of the
Errors interface.
Transmit Packets Errors The number of outbound packets that could not be
System transmitted because of errors.
Information and Collision Frames The best estimate of the total number of collisions on this
Statistics Ethernet segment.
Commands Time Since Counters Last Cleared The elapsed time, in days, hours, minutes, and seconds
since the statistics for this port were last cleared.
Packets Received Without Error The total number of packets (including broadcast packets
and multicast packets) received by the processor.
Broadcast Packets Received The total number of packets received that were directed to
the broadcast address. Note that this does not include
multicast packets.
Packets Received With Error The number of inbound packets that contained errors
preventing them from being deliverable to a higher-layer
protocol.
Packets Transmitted Without The total number of packets transmitted out of the
Errors interface.
Broadcast Packets Transmitted The total number of packets that higher-level protocols
requested to be transmitted to the Broadcast address,
including those that were discarded or not sent.
Transmit Packet Errors The number of outbound packets that could not be
transmitted because of errors.
Address Entries Currently In Use The total number of Forwarding Database Address Table
entries now active on the switch, including learned and
static entries.
VLAN Entries Currently In Use The number of VLAN entries presently occupying the
VLAN table.
Time Since Counters Last Cleared The elapsed time, in days, hours, minutes, and seconds
since the statistics for this switch were last cleared.
Summary Show the Ethernet traffic and operational statistics for one or more BAR ports.
Description This command displays detailed statistics for a specific port or for all CPU traffic based
upon the argument.
3-32
BAR Administration Guide
Defaults None
3.7
Example
Command Output: The display parameters when the argument is ‘<slot/port>’ are as follows:
Packets Received:
Octets Received The total number of octets of data (including those in bad
packets) received on the network (excluding framing bits
but including FCS octets). This object can be used as a
reasonable estimate of ethernet utilization.
Packets Received < 64 Octets The total number of packets (including bad packets)
received that were < 64 octets in length (excluding
framing bits but including FCS octets).
Packets Received 64 Octets The total number of packets (including bad packets)
received that were 64 octets in length (excluding framing
bits but including FCS octets).
Packets Received 65-127 Octets The total number of packets (including bad packets)
received that were between 65 and 127 octets in length
inclusive (excluding framing bits but including FCS
octets).
Packets Received 128-255 Octets The total number of packets (including bad packets)
received that were between 128 and 255 octets in length
inclusive (excluding framing bits but including FCS
octets).
Packets Received 256-511 Octets The total number of packets (including bad packets)
received that were between 256 and 511 octets in length
inclusive (excluding framing bits but including FCS
octets).
3-33
BAR Administration Guide
Packets Received 512-1023 Octets The total number of packets (including bad packets)
received that were between 512 and 1023 octets in
length inclusive (excluding framing bits but including FCS
octets).
Packets Received > 1522 Octets The total number of packets received that were longer
than 1522 octets (excluding framing bits, but including
FCS octets) and were otherwise well formed.
Total The total number of packets received that were without errors.
Multicast Packets Received The total number of good packets received that were directed
to a multicast address. Note that this number does not include
packets directed to the broadcast address.
Broadcast Packets Received The total number of good packets received that were directed
to the broadcast address. Note that this does not include
multicast packets.
Jabbers Received The total number of packets received that were longer than 1518
octets (excluding framing bits, but including FCS octets), and had
either a bad Frame Check Sequence (FCS) with an integral
number of octets (FCS Error) or a bad FCS with a non-integral
number of octets (Alignment Error). Note that this definition of
jabber is different than the definition in IEEE-802.3 section 8.2.1.5
(10BASE5) and section 10.3.1.4 (10BASE2). These documents
define jabber as the condition where any packet exceeds 20 ms.
The allowed range to detect jabber is between 20 ms and 150 ms.
Fragments/Undersize The total number of packets received that were less than
Received 64 octets in length (excluding framing bits but including FCS
octets).
Alignment Errors The total number of packets received that had a length (excluding
framing bits, but including FCS octets) of between 64 and 1518
octets, inclusive, but had a bad Frame Check Sequence (FCS) with
a non-integral number of octets.
Rx FCS Errors The total number of packets received that had a length (excluding
framing bits, but including FCS octets) of between 64 and 1518
octets, inclusive, but had a bad Frame Check Sequence (FCS) with
an integral number of octets
Overruns The total number of frames discarded as this port was overloaded
with incoming packets, and could not keep up with the inflow.
3-34
BAR Administration Guide
Local Traffic Frames The total number of frames dropped in the forwarding
process because the destination address was located off of
this port.
3.7
System
802.3x Pause Frames Received A count of MAC Control frames received on this interface.
Information and
This counter does not increment when the interface is
operating in half-duplex mode. Statistics
Commands
Unacceptable Frame Type The number of frames discarded from this port due to being
an unacceptable frame type.
VLAN Membership Mismatch The number of frames discarded on this port due to ingress
filtering.
VLAN Viable Discards The number of frames discarded on this port when a lookup
on a particular VLAN occurs while that entry in the VLAN
table is being modified, or if the VLAN has not been
configured.
Multicast Tree Viable Discards The number of frames discarded when a lookup in the
multicast tree for a VLAN occurs while that tree is being
modified.
Reserved Address Discards The number of frames discarded that are destined to an
IEEE 802.1 reserved address and are not supported by the
system.
Broadcast Storm Recovery The number of frames discarded that are destined for
FF:FF:FF:FF:FF:FF when Broadcast Storm Recovery is
enabled.
CFI Discards The number of frames discarded that have CFI bit set and
the addresses in RIF are in non-canonical format.
Packets Transmitted 64 Octets The total number of packets (including bad packets)
transmitted that were 64 octets in length (excluding
framing bits but including FCS octets).
Packets Transmitted 65-127 Octets The total number of packets (including bad packets)
transmitted that were between 65 and 127 octets in
length inclusive (excluding framing bits but including
FCS octets).
Packets Transmitted 128-255 Octets The total number of packets (including bad packets)
transmitted that were between 128 and 255 octets in
length inclusive (excluding framing bits but including
FCS octets).
3-35
BAR Administration Guide
Packets Transmitted 256-511 Octets The total number of packets (including bad packets)
transmitted that were between 256 and 511 octets in
length inclusive (excluding framing bits but including
FCS octets).
3.7 Packets Transmitted 512-1023 Octets The total number of packets (including bad packets)
transmitted that were between 512 and 1023 octets in
length inclusive (excluding framing bits but including
System FCS octets).
Information and Packets Transmitted 1024-1518 The total number of packets (including bad packets)
Statistics Octets transmitted that were between 1024 and 1518 octets in
Commands length inclusive (excluding framing bits but including
FCS octets).
Packets Transmitted 1519-1522 The total number of packets (including bad packets)
Octets transmitted that were between 1519 and 1522 octets in
length inclusive (excluding framing bits but including
FCS octets).
Max Info The maximum size of the Info (non-MAC) field that this
port will receive or transmit.
Unicast Packets Transmitted The total number of packets that higher-level protocols
requested be transmitted to a subnetwork-unicast address,
including those that were discarded or not sent.
Multicast Packets Transmitted The total number of packets that higher-level protocols
requested be transmitted to a Multicast address, including
those that were discarded or not sent.
Broadcast Packets Transmitted The total number of packets that higher-level protocols
requested be transmitted to the Broadcast address,
including those that were discarded or not sent.
Transmit Errors:
Tx FCS Errors The total number of packets transmitted that had a length (excluding
framing bits, but including FCS octets) of between 64 and 1518 octets,
inclusive, but had a bad Frame Check Sequence (FCS) with an integral
number of octets.
Oversized The total number of frames that exceeded the max permitted frame size.
This counter has a max increment rate of 815 counts per sec. at
10 Mb/s.
Underrun Errors The total number of frames discarded because the transmit FIFO buffer
became empty during frame transmission.
3-36
BAR Administration Guide
Transmit Discards:
Total Discards The sum of single collision frames discarded, multiple collision
frames discarded, and excessive frames discarded.
Port Membership The number of frames discarded on egress for this port due to
egress filtering being enabled.
VLAN Viable Discards The number of frames discarded on this port when a lookup on a
particular VLAN occurs while that entry in the VLAN table is
being modified, or if the VLAN has not been configured.
Protocol Statistics:
BPDU’s received The count of BPDU’s (Bridge Protocol Data Units) received
in the spanning tree layer.
BPDU’s Transmitted The count of BPDU’s transmitted from the spanning tree
layer.
802.3x Pause Frames Received A count of MAC Control frames received on this interface.
This counter does not increment when the interface is
operating in half-duplex mode.
GVRP PDU’s Received The count of GVRP PDU’s received in the GARP layer.
GVRP PDU’s Transmitted The count of GVRP PDU’s transmitted from the GARP layer.
GVRP Failed Registrations The number of times attempted GVRP registrations could
not be completed.
GMRP PDU’s received The count of GMRP PDU’s received in the GARP layer.
GMRP PDU’s Transmitted The count of GMRP PDU’s transmitted from the GARP
layer.
GMRP Failed Registrations The number of times attempted GMRP registrations could
not be completed.
STP BPDUs Transmitted Spanning Tree Protocol Bridge Protocol Data Units sent.
STP BPDUs Received Spanning Tree Protocol Bridge Protocol Data Units
received.
RST BPDUs Transmitted Rapid Spanning Tree Protocol Bridge Protocol Data Units
sent.
RSTP BPDUs Received Rapid Spanning Tree Protocol Bridge Protocol Data Units
received.
MSTP BPDUs Transmitted Multiple Spanning Tree Protocol Bridge Protocol Data Units
sent.
MSTP BPDUs Received Multiple Spanning Tree Protocol Bridge Protocol Data Units
received.
3-37
BAR Administration Guide
Dot1x Statistics:
EAPOL Frames Received The number of valid EAPOL frames of any type that have
been received by this authenticator.
3.7 EAPOL Frames Transmitted The number of EAPOL frames of any type that have been
transmitted by this authenticator.
System Time Since Counters Last Cleared The elapsed time, in days, hours, minutes, and seconds
since the statistics for this port were last cleared.
Information and
Statistics
Commands The display parameters when the argument is ‘switchport’ is as follows:
Multicast Packets Received The total number of packets received that were directed
to a multicast address. Note that this number does not
include packets directed to the broadcast address.
Broadcast Packets Received The total number of packets received that were directed
to the broadcast address. Note that this does not include
multicast packets.
Receive Packets Discarded The number of inbound packets which were chosen to
be discarded even though no errors had been detected
to prevent their being deliverable to a higher-layer
protocol. A possible reason for discarding a packet could
be to free up buffer space.
Packets Transmitted without Errors The total number of packets transmitted out of the
interface.
Unicast Packets Transmitted The total number of packets that higher-level protocols
requested be transmitted to a subnetwork-unicast
address, including those that were discarded or not sent.
Multicast Packets Transmitted The total number of packets that higher-level protocols
requested be transmitted to a Multicast address,
including those that were discarded or not sent.
Broadcast Packets Transmitted The total number of packets that higher-level protocols
requested be transmitted to the Broadcast address,
including those that were discarded or not sent.
Transmit Packets Discarded The number of outbound packets which were chosen to
be discarded even though no errors had been detected
to prevent their being deliverable to a higher-layer
protocol. A possible reason for discarding a packet could
be to free up buffer space.
Most Address Entries Ever Used The highest number of Forwarding Database Address
Table entries that have been learned by this switch since
the most recent reboot.
Address Entries Currently in Use The number of Learned and static entries in the
Forwarding Database Address Table for this switch.
3-38
BAR Administration Guide
Maximum VLAN Entries The maximum number of Virtual LANs (VLANs) allowed
on this switch.
Most VLAN Entries Ever Used The largest number of VLANs that have been active on
3.7
this switch since the last reboot.
Static VLAN Entries The number of presently active VLAN entries on this
switch that have been created statically.
Dynamic VLAN Entries The number of presently active VLAN entries on this
System
switch that have been created by GVRP registration. Information and
Statistics
VLAN Deletes The number of VLANs on this switch that have been
created and then deleted since the last reboot. Commands
Time Since Counters Last Cleared The elapsed time, in days, hours, minutes, and seconds,
since the statistics for this switch were last cleared.
Description This command displays the forwarding database entries. If the command is entered
with no parameter, the entire table is displayed.
Defaults None
Example
3-39
BAR Administration Guide
MAC Address A unicast MAC address for which the switch has forwarding and or
filtering information. The format is 6 or 8 two-digit hexadecimal numbers
3.7
that are separated by colons, for example 01:23:45:67:89:AB. In an IVL
system the MAC address will be displayed as 8 bytes. In an SVL
system, the MAC address will be displayed as 6 bytes.
System slot/port The combination of slot and port identifying the BAR interface that the
Information and MAC address was learned on.
Statistics if Index The ifIndex of the interface table entry associated with this port.
Commands
Status The status of this entry. The meanings of the values are:
• Static: The value of the corresponding instance was added by the
system or a user when a static MAC filter was defined. It cannot be
relearned.
• Learned: The value of the corresponding instance was learned by
observing the source MAC addresses of incoming traffic, and is
currently in use.
• Management: The value of the corresponding instance (system
MAC address) is also the value of an existing instance of
dot1dStaticAddress. It is identified with interface 0/1 and is
currently used when enabling VLANs for routing.
• Self: The value of the corresponding instance is the address of
one of the switch’s physical interfaces (the system’s own MAC
address).
• GMRP: Learned The value of the corresponding was learned via
GMRP and applies to Multicast.
• Other: The value of the corresponding instance does not fall into
one of the other categories.
Summary Show the configured age time of a forwarding database or the entire BAR.
Defaults None
Example
3-40
BAR Administration Guide
Command Output: The following information is presented for each forwarding database:
Address Aging Timeout in Seconds The aging timer setting (in seconds) for the associated
database. The range is 10-1,000,000 seconds; the default
is 300.
3.7
System
Related Commands bridge aging-time <age-time> [<fdbid> | all] on page 3-5 Information and
Statistics
Commands
3-41
BAR Administration Guide
3.7
System
Information and
Statistics
Commands
3-42
Chapter 4
VLAN Configuration
Commands
This chapter describes the commands that configure and monitor Virtual Local Area
Network (VLAN) operation in the BAR.
Topic on page
port-channel staticcapability
User-Entered None
Parameters
Description This command enables the support of port-channels (static link aggregations – LAGs)
on the device. By default, the static capability for all port-channels is disabled.
BAR Administration Guide
4.2 Defaults
Example
Mode disabled
port-channel <name>
User-Entered <name>
Parameters The name assigned to the port-channel being created. This name must be made up of
alphanumeric characters and not include any spaces or special characters. The name
may be up to 15 characters in length.
Description This command configures a new port-channel (LAG) and generates a logical slot and
port number for it.
NOTE: Before adding a port to a port-channel, set the physical mode of the port.
Refer to “Switching Configuration Commands” starting on page 3-5 for port physical
mode and speed commands.
Once the port-channel is created, the BAR assigns a logical slot and port number
combination to it. This combination of <logical slot-port> is needed for some
configuration commands. To find the port-channel logical slot and port combination,
use the command show port-channel {<logical slot/port> | all} on page 4-39.
Defaults None
Example
4-2
BAR Administration Guide
all
This argument applies the command to all existing port-channels.
<name>
The name being newly assigned to the port-channel. This name must be made up of
alphanumeric characters and not include any spaces or special characters. The name
may be up to 15 characters in length.
Description This command defines a name for the port-channel (LAG). This command is used to
modify the name that was associated with the port-channel when it was created.
Defaults None
Example
4-3
BAR Administration Guide
all
This argument applies the command to all existing port-channels.
all
This argument applies the command to all existing port-channels.
Description This command enables link trap notifications for the port-channel (LAG).
Example
4-4
BAR Administration Guide
NOTE: Before adding a port to a port-channel, set the physical mode of the port.
Refer to “Switching Configuration Commands” starting on page 3-5 for port physical
mode and speed commands.
Defaults None
Example
Description This command deletes the currently configured port from an existing port-channel
(LAG) configuration.
Defaults None
Example
4-5
BAR Administration Guide
Port-Channel
Commands deleteport all
User-Entered None
Parameters
Description This command removes all configured ports from their port-channels.
Defaults None
Example
Summary Delete the currently selected interface from the named port-channel.
all
This argument applies the command to all existing port-channels.
Description This command deletes a specific interface or all interfaces from an existing port-
channel (LAG). The interface is a logical slot and port in a configured port-channel.
The all option removes all configured port-channels (LAGs).
Defaults None
4-6
BAR Administration Guide
Example
User-Entered yes]
Parameters Entering the “Yes” flag at the causes the CLI to parse the command without prompting
you to confirm your action.
Defaults None
Example
User-Entered <vlanid>
Parameters A numerical valid VLAN identification number. The range for this field is 1-4036.
Description This command configures the Management VLAN ID. The Management VLAN ID
may have the value 1 to 4036; the default value is 1.
4-7
BAR Administration Guide
Defaults VlanID: 1
Example
4.3
(Pannaway BAR) #network mgmt_vlan 2
User-Entered <vlanid>
Parameters A numerical valid VLAN identification number. The range for this field is 2-4036 (ID 1
is reserved for the default management VLAN).
Description This command creates a new VLAN in the BAR VLAN database and assigns it an ID.
Defaults None
Example
Summary Set the frame acceptance mode for the current interface.
User-Entered vlanonly
Parameters This parameter sets the frame acceptance mode for the interface to accept only VLAN
tagged frames. Other frames (untagged or priority frames are discarded).
all
The “all” parameter configures the interface to accept all frames and assign the VLAN
ID of the current port to them.
Description This command sets the frame acceptance mode (VLAN only or all) for the currently
configured interface. With either option, VLAN tagged frames are forwarded in
accordance with the IEEE 802.1Q VLAN specification.
4-8
BAR Administration Guide
Example
4.3
(Pannaway BAR) (Interface 0/8)#vlan acceptframe vlanonly
vlan ingressfilter
User-Entered None
Parameters
Description This command enables ingress filtering on the currently configured interface. When
filtering is enabled, received frames whose VLAN ID does not match the VLAN
membership of the interface are discarded.
Example
User-Entered <vlanid>
Parameters The VLAN ID number (from 2-4036) of the existing VLAN.
4-9
BAR Administration Guide
4.3 <name>
The name to be assigned to the VLAN. This name is an alphanumeric string of up to 16
characters. You must surround the VLAN name in quotation marks (“ ”) to use spaces
VLAN
Management in the name.
Commands Description This command changes the name of a VLAN.
Example
User-Entered <participation-mode>
Parameters The participation mode, or option, that the VLAN will operate under. Participation
options are:
• “include” – The interface is always a member of this VLAN. This is equivalent to
registration “fixed”.
• “exclude” – The interface is never a member of this VLAN. This is equivalent to
registration “forbidden”.
• “auto” – (not supported).
<vlanid>
The VLAN ID number (from 2-4036) of an existing, non-default VLAN.
Description This command specifies the degree of participation for the currently configured
interface in a VLAN.
Defaults None
Example
4-10
BAR Administration Guide
User-Entered <participation-mode>
Parameters The participation mode, or operation, that the VLAN will operate under. Participation
options are:
• “include” – The interface is always a member of this VLAN. This is equivalent to
registration “fixed”.
• “exclude” – The interface is never a member of this VLAN. This is equivalent to
registration “forbidden”.
• “auto” – (not supported)
<vlanid>
The VLAN ID number (from 1-4036) of an existing VLAN. This command can
include VLAN ID number 1, the default VLAN.
Description This command configures the degree of participation for all interfaces in a VLAN. The
ID is a valid VLAN identification number, and the interface is a valid interface number.
Defaults None
Example
4-11
BAR Administration Guide
User-Entered vlanonly
Parameters This parameter sets the frame acceptance mode for the interface to accept only VLAN
tagged frames. Other frames (untagged or priority frames) are discarded.
4.3
all
The “all” parameter configures the interface to accept all frames and assign the VLAN
ID of the current port to them.
VLAN
Description This command sets the frame acceptance mode for all interfaces. Regardless of mode,
Management
VLAN tagged frames are forwarded in accordance with the IEEE 802.1Q VLAN
Commands
Specification.
Example
User-Entered None
Parameters
Example
4-12
BAR Administration Guide
User-Entered <vlanid>
Parameters The VLAN ID number (from 1-4036) of an existing VLAN. This command can
include VLAN ID number 1, the default VLAN.
Description This command changes the VLAN ID for all interfaces to the specified VLAN ID.
Example
User-Entered <vlanid>
Parameters The VLAN ID number (from 1-4036) of an existing VLAN. This command can
include VLAN ID number 1, the default VLAN.
Description This command enables the tagging behavior for all interfaces in a VLAN. If tagging is
enabled, traffic is transmitted as tagged frames.
Defaults None
4-13
BAR Administration Guide
Example
User-Entered <vlanid>
Parameters The VLAN ID number (from 1-4036) of an existing VLAN. This command can
include VLAN ID number 1, the default VLAN.
Description This command changes the VLAN ID for the current interface.
Defaults Vlanid: 1
Example
User-Entered <vlanid>
Parameters The VLAN ID number (from 1-4036) of an existing VLAN. This command can
include VLAN ID number 1, the default VLAN.
Description This command configures the tagging behavior for a specific interface in a VLAN to
enabled. If tagging is enabled, traffic is transmitted as tagged frames.
4-14
BAR Administration Guide
Defaults
Example
None
4.3
(Pannaway BAR) (Interface 0/7)#vlan tagging 2
VLAN
Management
Commands
Related Commands vlan priority <priority> on page 4-29
show vlan port {<slot/port> | all} on page 4-43
vlan participation <participation-mode> <vlanid> on page 4-10
vlan acceptframe {vlanonly | all} on page 4-8
vlan port ingressfilter all on page 4-12
vlan port acceptframe all {vlanonly | all} on page 4-11
vlan pvid <vlanid> on page 4-14
User-Entered yes]
Parameters Entering the “Yes” flag at the causes the CLI to parse the command without prompting
you to confirm your action.
Description This command resets VLAN configuration parameters to the factory defaults. All
previously configured VLANs are deleted, so that only the default VLAN remains.
Defaults None
Example
Are you sure you want to restore all VLANs to default? (y/n)y
VLANs Restored!
4-15
BAR Administration Guide
User-Entered <macaddr>
Parameters The Media Access Control (MAC) address that the VLAN will filter for. The parameter
must be specified as a 6-byte hexadecimal number in the format of
“nn:nn:nn:nn:nn:nn”.
The restricted MAC Addresses are: 00:00:00:00:00:00, 01:80:C2:00:00:00 to
01:80:C2:00:00:0F, 01:80:C2:00:00:20 to 01:80:C2:00:00:21, and FF:FF:FF:FF:FF:FF.
<vlanid>
The VLAN ID number (from 1-4036) of an existing VLAN. This command can
include VLAN ID number 1, the default VLAN.
Description This command adds a static MAC filter entry for the MAC address <macaddr> on the
VLAN <vlanid>.
Up to 100 static MAC filters may be created.
Defaults None
Example
User-Entered <macaddr>
Parameters The Media Access Control (MAC) address that the VLAN will filter for. The parameter
must be specified as a 6-byte hexadecimal number in the format of
“nn:nn:nn:nn:nn:nn”.
4-16
BAR Administration Guide
4.4
The VLAN ID number (from 1-4036) of an existing VLAN. This command can
include VLAN ID number 1, the default VLAN.
Description This command adds the interface to the destination filter set for the MAC filter with the MAC Filtering
given <macaddr> and VLAN of <vlanid>. Commands
“no” Form no macfilter adddest <macaddr> <vlanid>
The “no” form of this command removes a port from the destination filter set for the
MAC filter with the given <macaddr> and VLAN of <vlanid>.
Defaults None
Example
User-Entered <macaddr>
Parameters The Media Access Control (MAC) address that the VLAN will filter for. The parameter
must be specified as a 6-byte hexadecimal number in the format of
“nn:nn:nn:nn:nn:nn”.
<vlanid>
The VLAN ID number (from 1-4036) of an existing VLAN. This command can
include VLAN ID number 1, the default VLAN.
Description This command adds all interfaces to the destination filter set for the MAC filter with the
given <macaddr> and VLAN of <vlanid>.
Defaults None
Example
4-17
BAR Administration Guide
MAC Filtering i
User-Entered <macaddr>
Parameters The Media Access Control (MAC) address identifying the MAC filter. The parameter
must be specified as a 6-byte hexadecimal number in the format of
“nn:nn:nn:nn:nn:nn”.
<vlanid>
The VLAN ID number (from 1-4036) of an existing VLAN. This command can
include VLAN ID number 1, the default VLAN.
Description This command adds the interface to the source filter set for the MAC filter with the
MAC address of <macaddr> and VLAN of <vlanid>.
Defaults None
Example
User-Entered <macaddr>
Parameters The Media Access Control (MAC) address identification of the source filter. The
parameter must be specified as a 6-byte hexadecimal number in the format of
“nn:nn:nn:nn:nn:nn”.
4-18
BAR Administration Guide
<vlanid>
The VLAN ID number (from 1-4036) identifying the source filter.
Description This command adds all interfaces to the source filter set for the MAC filter with the
4.5
MAC address <macaddr> and <vlanid>.
Example
port lacpmode
User-Entered None
Parameters
Description This command enables Link Aggregation Control Protocol (LACP) on a port.
Example
4-19
BAR Administration Guide
Example
User-Entered <groupname>
Parameters A character string of 1 to 16 characters representing the name of the protocol group.
Description This command adds a protocol-based VLAN group to the system. When it is created,
the protocol group will be assigned a unique number that will be used to identify the
group in subsequent commands.
TIP: The protocol group identification number (groupid) can be found by entering the
“show port protocol {<groupid> | all} command.
Defaults None
Example
4-20
BAR Administration Guide
User-Entered <groupid>
Parameters The ID number assigned to the VLAN protocol group.
<protocol>
The protocol to be added to the protocol-based VLAN. Values include:
• IP: to add Internet Protocol to the VLAN.
• ARP: adds Address Resolution Protocol to the VLAN.
• IPX: adds the Internet Protocol Exchange to the VLAN.
• PPPOE: adds Point to Point Protocol over Ethernet to the VLAN.
Description This command adds the specified protocol to the protocol-based VLAN identified by
the <groupid> parameter. A group may have more than one protocol associated with it.
Each interface and protocol combination can only be associated with one group. If
adding a protocol to a group causes any conflicts with interfaces currently associated
with the group, this command will fail and the protocol will not be added to the group.
Defaults None
Example
4-21
BAR Administration Guide
User-Entered <groupid>
Parameters The ID number assigned to the VLAN protocol group to be removed.
Description This command removes the protocol-based VLAN group that is identified by the
4.6
specified <groupid> value.
User-Entered <groupid>
Parameters The identification number of an existing protocol group.
<vlanid>
The VLAN ID number (from 1-4036) of an existing VLAN. This command can
include VLAN ID number 1, the default VLAN.
Defaults None
Example
4-22
BAR Administration Guide
User-Entered <groupid>
Parameters The identification number of an existing protocol group.
Description This command adds the currently configured physical interface to the protocol-based
VLAN identified by <groupid>. A group may have more than one interface associated
with it. Each interface and protocol combination can only be associated with one group.
If adding an interface to a group causes any conflicts with protocols currently
associated with the group, this command will fail and the interface(s) will not be added
to the group.
Defaults None
Example
User-Entered <groupid>
Parameters The identification number of an existing protocol group.
4-23
BAR Administration Guide
Description This command adds all physical interfaces to the protocol-based VLAN identified by
<groupid>. A group may have more than one interface associated with it. Each
interface and protocol combination can only be associated with one group. If adding an
interface to a group causes any conflicts with protocols currently associated with the
Defaults None
Example
set igmp
User-Entered None
Parameters
Description This command enables IGMP Snooping mode on the system. The IGMP application
supports the following:
• Global configuration or per interface configuration. Per VLAN configuration is
not supported in the IGMP snooping application.
• Validation of the IP header checksum (as well as the IGMP header checksum)
and discarding of the frame upon checksum error.
• Maintenance of the forwarding table entries based on the MAC address versus
the IP address.
• Flooding of unregistered multicast data packets to all ports in the VLAN.
If the command is entered in Interface Config mode, IGMP Snooping is activated on
the current interface. If the command is entered in Global Config mode, IGMP
Snooping is activated for all interfaces.
4-24
BAR Administration Guide
Example
4.7
(Pannaway BAR) (Config)#set igmp
User-Entered None
Parameters
Description This command enables IGMP Snooping on all interfaces. If an interface which has
IGMP Snooping enabled is enabled for routing or is enlisted as a member of a port-
channel (LAG), IGMP Snooping functionality will be disabled on that interface. IGMP
Snooping functionality will subsequently be re-enabled if routing is disabled or port-
channel (LAG) membership is removed from an interface that has IGMP Snooping
enabled.
Example
Summary Set the maximum response interval time for IGMP operation on the BAR.
User-Entered <response-interval>
Parameters The amount of time, in seconds, that the BAR will wait to receive a response after
sending a query. This value must be less than the IGMP Query Interval time value. The
range is 1 to 3600.
4-25
BAR Administration Guide
Description This command sets the IGMP Maximum Response time on the system.
4.7 Defaults
to its default of 10 seconds.
Response-interval: 10
IGMP
Example
Commands
(Pannaway BAR) (Config)#set igmp maxresponse 20
User-Entered <membership-interval>
Parameters The amount of time, in seconds, that the BAR will wait for a report or response from
the IGMP group before deleting the interface from the membership list of the group.
The interval is measured in seconds, from 1 to 3600.
Description This command sets the IGMP Group Membership Interval time on the system. The
Group Membership Interval value must be greater than the IGMP Maximum Response
time value.
Example
4-26
BAR Administration Guide
User-Entered <expire-time>
Parameters This is the amount of time in seconds that a switch will wait for a query to be received
on an interface before the interface is removed from the list of interfaces with multicast
routers attached. The range is 0 to 3600 seconds.
NOTE: To set an infinite timeout (no expiration) set the <expire-time> value to 0.
4.7
IGMP
Commands
Description This command sets the Multicast Router Present Expiration time on the system.
Example
User-Entered yes]
Parameters Entering the “Yes” flag at the causes the CLI to parse the command without prompting
you to confirm your action.
Description This command clears the tables managed by the IGMP Snooping function and will
attempt to delete these entries from the Multicast Forwarding Database.
Defaults None
Example
Are you sure you want to clear all IGMP snooping entries? (y/n)y
4-27
BAR Administration Guide
User-Entered <userpriority>
Parameters The numerical value of the 802.1p user priority assigned to the traffic class. This value
may be from 0 to 7.
<trafficclass>
The number of the internal or external traffic class. This value may be from 0 to 7.
Description This command maps an 802.1p priority to an internal traffic class for a device when in
‘Global Config’ mode. The number of available traffic classes may vary with the
platform. Userpriority and trafficclass can both be the range from 0-7. Under ‘Interface
Config’ mode, this command maps an 802.1p priority to an internal traffic class for a
specific interface.
Defaults None
Example
Summary Set the 802.1p port priority for all interfaces on the BAR.
User-Entered <priority>
Parameters The 802.1p priority value that will be assigned to all interfaces. This value may be an
integer from 0 to 7.
Description This command configures the port priority assigned for untagged packets for all ports
presently plugged into the device. The range for the priority is 0-7. Any subsequent per
port configuration will override this configuration setting.
Defaults None
4-28
BAR Administration Guide
Example
User-Entered <priority>
Parameters The 802.1p priority value for the interface. This value may be an integer from 0 to 7.
Description This command configures the default 802.1p port priority assigned for untagged
packets for a specific interface.
Defaults None
Example
User-Entered <slot/port>
Parameters The combination of a slot in the BAR chassis and a port on that slot that identifies a
unique network interface.
Description This command displays the current 802.1p priority mapping to internal traffic classes
for a specific interface, as specified by the slot/port parameter.
Defaults None
4-29
BAR Administration Guide
Example
4.9 -------------
0
1
-------------
2
0
VLAN Display 2 2
3 3
Commands
4 4
5 5
6 6
7 7
Command Output: The command displays a table of the User priorities configured on the BAR and the ID
of the traffic class associated with each user priority.
User-Entered <slot/port>:
Parameters This parameter identifies a unique slot and port combination. This parameter is used
twice in the command; once to identify the source (monitored) port and then again to
identify the destination (probe) port.
Description This command configures a probe port and a monitored port for session monitoring
(port monitoring).
Defaults None
4-30
BAR Administration Guide
Example
User-Entered None.
Parameters
Description This command enables the BAR’s port monitoring mode. The probe and monitored
ports must be configured before port monitoring can be enabled. If enabled, the probe
port will monitor all traffic received and transmitted on the physical monitored port. It
is not necessary to disable port monitoring before modifying the probe and monitored
ports.
Defaults Disabled
Example
Related Commands monitor session source <slot/port> destination <slot/port> on page 4-30
show monitor on page 4-36
show igmpsnooping
User-Entered None
Parameters
Defaults None
4-31
BAR Administration Guide
Example
Command Output: The following information is displayed on the show igmpsnooping screen:
Admin Mode Indicates the status of IGMP Snooping (enabled or disabled) on the
switch.
Group Membership Shows the IGMP Group membership interval configured for the
Interval group. The membership interval is the amount of time, in seconds,
that the BAR will wait for a report or response from the IGMP group
before deleting the interface from the membership list of the group.
Max Response Time Indicates the amount of time the switch will wait after sending a query
on an interface because it did not receive a report for a particular
group on that interface.
Multicast Router If a query is not received on an interface within this amount of time,
Present Expiration Time the interface is removed from the list of interfaces with multicast
routers attached.
Multicast Control The number of multicast control frames that are processed by the
Frame Count CPU. This status value is only displayed when IGMP Snooping is
enabled.
Data Frames Forwarded Shows the number of data frames that have been forwarded under
by the CPU IGMP snooping operation.
User-Entered None
Parameters
Description This command displays the IGMP Snooping entries in the Multicast Forwarding
Database (MFDB) table.
4-32
BAR Administration Guide
Defaults None
Command Output: The show mac-address-table igmpsnooping screen shows the following information:
Mac Address A unicast MAC address for which the switch has forwarding and or filtering
information. The format is 6 or 8 two-digit hexadecimal numbers that are
separated by colons, for example 01:23:45:67:89:AB. In an IVL system the
MAC address will be displayed as 8 bytes. In an SVL system, the MAC
4.9
address will be displayed as 6 bytes.
VLAN Display
Commands
Type Displays the type of the entry. Static entries are those that are configured by
the end user. Dynamic entries are added to the table as a result of a learning
process or protocol.
Interfaces The list of interfaces that are designated for forwarding (Fwd:) and filtering
(Flt:).
User-Entered <macaddr>
Parameters This optional parameter is the MAC address of an interface that the command will
present the MFDB table for.
all
The optional all parameter specifies that the MFDB table should be retrieved for all
interfaces.
Description This command displays the Multicast Forwarding Database (MFDB) information. If
the command is entered with no parameter, the entire table is displayed. The user can
display the table entry for one MAC Address by specifying <macaddr> as an optional
parameter.
Defaults None
Command Output: The following information is shown on the mac-address-table multicast screen:
Mac Address A unicast MAC address for which the switch has forwarding and or
filtering information. The format is 6 or 8 two-digit hexadecimal
numbers that are separated by colons, for example 01:23:45:67:89:AB.
In an IVL system the MAC address will be displayed as 8 bytes. In an
SVL system, the MAC address will be displayed as 6 bytes.
Type The type of the entry. Static entries are those that are configured by the
end user. Dynamic entries are added to the table as a result of a
learning process or protocol.
Component The component that is responsible for this entry in the Multicast
Forwarding Database. Possible values are IGMP Snooping, GMRP,
and Static Filtering.
4-33
BAR Administration Guide
Interfaces A list of interfaces that are designated for forwarding (Fwd:) and
filtering (Flt:).
Forwarding Interfaces The resultant forwarding list is derived from combining all the
4.9
component forwarding interfaces and removing the interfaces that are
listed as the static filtering interfaces.
Description This command displays the Static MAC Filtering information for all Static MAC Filters.
Defaults None
Command Output: The following information is presented on the show mac-address-table static screen:
Mac Address The MAC address of the static MAC filter entry.
Source Port(s) Indicates the source port filter set’s slot and port(s).
Destination Port(s) Indicates the destination port filter set’s slot and port(s).
User-Entered None
Parameters
Description This command displays the Static Filtering entries in the Multicast Forwarding
Database (MFDB) table.
4-34
BAR Administration Guide
Defaults None
Command Output The following information is presented in response to the show mac-address-table
staticfiltering command:
Mac Address A unicast MAC address for which the switch has forwarding and or filtering
information. The format is 6 or 8 two-digit hexadecimal numbers that are
4.9
separated by colons, for example 01:23:45:67:89:AB. In an IVL system the VLAN Display
MAC address will be displayed as 8 bytes. In an SVL system, the MAC address
will be displayed as 6 bytes. Commands
Type The type of the entry. Static entries are those that are configured by the end
user. Dynamic entries are added to the table as a result of a learning process or
protocol.
Interfaces The list of interfaces that are designated for forwarding (Fwd:) and filtering (Flt:).
User-Entered None
Parameters
Description This command displays the Multicast Forwarding Database (MFDB) statistics.
Defaults None
Example
Command Output: The show mac-address-table stats command provides the following information:
Max MFDB Table Entries The total number of entries that can possibly be in the Multicast
Forwarding Database table.
Most MFDB Entries Since The largest number of entries that have been present in the
Last Reset Multicast Forwarding Database table. This value is also known as
the MFDB high-water mark.
Current Entries The current number of entries in the Multicast Forwarding Database
table.
4-35
BAR Administration Guide
show monitor
Description This command displays the port monitoring information for the system.
Defaults None
Example
Command Output: The following information is presented in response to the show monitor command:
Port Monitor Mode Indicates whether the Port Monitoring feature is enabled or disabled.
Probe Port Slot/Port The slot/port that is configured as the probe port. If this value has not
been configured, ‘Not Configured’ will be displayed.
Monitored Port Slot/Port The slot/port that is configured as the monitored port. If this value has
not been configured, ‘Not Configured’ will be displayed.
User-Entered <slot/port>
Parameters A combination of slot and port numbers that identifies a single interface on the BAR.
all
This argument applies the command to all BAR interfaces.
Description This command displays port information for a specified port, or all ports.
Defaults None
4-36
BAR Administration Guide
Example
Command Output: The following information is presented on the show port screen:
Slot/Port The combination of a slot and physical port identifying an interface on the
BAR.
Type If not blank, this field indicates that this port is a special type of port. The
possible values are:
• Mirror: This port is performing port monitoring of the probe port.
• PC Mbr: This port is a member of a port-channel (LAG).
• Probe: This port is a probe port.
Admin Mode Displays the Port control administration state (enabled or disabled). The port
must be enabled (the default) in order for it to be allowed into the network.
Physical Mode Indicates the configured port speed and duplex mode. If auto-negotiation
support is selected, then the duplex mode and speed were set from the
auto-negotiation process. Otherwise, this object displays the port’s duplex
mode and transmission rate.
Physical Status Indicates the port speed and duplex mode configured for the port.
Link Trap Indicates whether or not the port sends a trap when link status changes. The
default is to send traps (enabled).
4-37
BAR Administration Guide
Description This command displays the Protocol-Based VLAN information for either the entire
system, or for the indicated group.
Defaults None
Example
Group
Group Name ID Protocol(s) VLAN Interface(s)
---------------- ------ ----------- ---- ------------------------
MCAST 1 IP 2 0/6,0/7
Command Output: The show port protocol command presents the following information as output:
Group Name Displays the group name of an entry in the Protocol-based VLAN table.
Interface(s) Lists the slot/port interface(s) that are associated with this protocol group.
4-38
BAR Administration Guide
Description This command displays an overview of all port-channels (LAGs) on the switch.
Defaults None
Example
Command Output: The show port-channel command displays the following information:
Log. Slot/Port The logical slot and the logical port that identify the LAG.
Port-Channel The name of this port-channel (LAG). This may be any string of up to 15
Name alphanumeric characters.
Admin Mode The administrative status of this port-channel LAG: enabled (factory default)
or disabled.
Link Trap Mode Indicates whether the port-channel (LAG) is configured to send a trap when
link status changes. Enabled (En.) indicates traps are sent; disabled (Dis.)
indicates no traps are sent. The default is enabled.
STP Mode The Spanning Tree Protocol Administrative Mode associated with the port or
port-channel (LAG).
Mbr Ports A listing of the ports that are members of this port-channel (LAG), in slot/port
notation. There can be a maximum of eight ports assigned to a given port-
channel (LAG).
Port Active The activity condition of the indicated member port. True indicates the port
is active, False indicates the port is inactive.
4-39
BAR Administration Guide
User-Entered None
Parameters
Description This command displays the static capability of all port-channels (LAGs) on the device
as well as a summary of individual port-channels.
Defaults None
Example
Logical Slot/Port Port-Channel Name Link State Mbr Ports Active Ports
----------------- ----------------- ---------- --------- ------------
1/1 test Down 0/1,0/2,
0/3
Command Output: The following information is presented in the port-channel brief information table:
Static Capability This field displays whether or not the device has static capability
enabled.
Logical Slot/Port The logical slot and the logical port identifying the LAG.
Mbr Ports Lists the ports that are members of this port-channel, in slot/port notation.
Active Ports Lists the ports that are actively participating in this port-channel.
4-40
BAR Administration Guide
User-Entered <vlanid>
Parameters The unique identification number of a specific VLAN on the BAR.
Description This command displays detailed information, including interface information, for the
VLAN specified by the valid VLAN identification number.
Defaults None
Example
VLAN ID: 2
VLAN Name: VLAN 2
VLAN Type: Static
4-41
BAR Administration Guide
Command Output: The following information is shown on the show vlan screen:
VLAN ID The VLAN Identifier (VID) associated with the VLAN, ranging from 1 to 4036.
4.9
VLAN Name The optional text description associated with this VLAN (up to 16 alphanumeric
characters long, including blanks). The default is blank. VLAN ID 1 always has
a name of ‘Default.’
VLAN Display VLAN Type The type of VLAN: Default (VLAN ID = 1) or Static (one that is configured and
permanently defined).
Commands
slot/port Indicates by slot ID and port number which port is controlled by the fields on
this line.
Current Determines the degree of participation of this port in this VLAN. The
permissible values are:
• Include: This port is always a member of this VLAN. This is equivalent to
registration “fixed” in the IEEE 802.1Q standard.
• Exclude: This port is never a member of this VLAN. This is equivalent to
registration “forbidden” in the IEEE 802.1Q standard.
Configured Determines the configured degree of participation of this port in this VLAN. The
permissible values are:
• Include: This port is always a member of this VLAN. This is equivalent to
registration “fixed” in the IEEE 802.1Q standard.
• Exclude: This port is never a member of this VLAN. This is equivalent to
registration “forbidden” in the IEEE 802.1Q standard.
Tagging Displays the tagging behavior for this port in this VLAN. Possible values are:
• Tagged: This port transmits traffic for this VLAN as tagged frames.
• Untagged: This port transmits traffic for this VLAN as untagged frames.
User-Entered None
Parameters
Defaults None
4-42
BAR Administration Guide
Example
VLAN ID The VLAN Identifier (vlanid) associated with each VLAN. The range of the
VLAN ID is 1 to 4036.
VLAN Name The optional descriptive text string associated with this VLAN (up to 16
characters). A blank entry indicates that no custom name has been assigned
to the VLAN. VLAN ID 1 always has a name of ‘Default’.
VLAN Type The type of VLAN: Default (VLAN ID = 1) or Static (one that is configured and
permanently defined).
User-Entered <slot/port>
Parameters A combination of slot and port numbers that identifies a unique interface on the BAR.
all
This argument applies the command to all BAR interfaces.
Defaults None
Example
4-43
BAR Administration Guide
Command Output: The show vlan port command displays the following information:
slot/port Indicates by slot ID and port number which port is controlled by the
fields on this line.
4.9 Port VLAN ID The VLAN ID that this port will assign to untagged frames or priority
tagged frames received on this port. The value must be for an
existing VLAN. The factory default is 1 (the default VLAN).
VLAN Display
Acceptable Frame Types The types of frames that may be received on this port. The options
Commands are ’VLAN only’ and ’Admit All’. When set to ’VLAN only’, untagged
frames or priority tagged frames received on this port are discarded.
When set to ’Admit All’, untagged frames or priority tagged frames
received on this port are accepted and assigned the value of the
Port VLAN ID for this port. With either option, VLAN tagged frames
are forwarded in accordance to the 802.1Q VLAN specification.
Default Priority The 802.1p priority assigned to tagged packets arriving on the port.
4-44
Chapter 5
Protocol Independent
Routing Commands
This chapter presents the CLI commands that are used to configure and monitor
protocol-independent routing operations for the Pannaway BAR.
Topic on page
Commands for OSPF, VRRP, and RIP routing configuration and monitoring are found
in chapters specifically focused on those technologies.
User-Entered <ipaddress>
Parameters The IP address of the interface in Dotted Decimal Notation. This IP address must be
on a different subnetwork than the subnetwork to which the BAR’s network IP port
belongs.
5.2 <subnetmask>
The subnet mask value for the interface in Dotted Decimal Notation.
General Routing
Description Set an IP address and subnet mask combination for the current interface.
Configuration
Commands “no” Form no ip address <ipaddr> <subnetmask>
The “no” form of this command deleted the specified IP address and subnet mask
combination.
Defaults None
Example
routing
User-Entered None
Parameters
Example
5-2
BAR Administration Guide
Description This command sets the Link Layer Encapsulation type that the currently selected
interface will use.
Defaults
Example
Type: Ethernet
5.2
General Routing
(Pannaway BAR) (Interface 0/2)#encapsulation snap Configuration
Commands
Related Commands None
ip irdp
User-Entered None
Parameters
Description This command enables the Internet Router Discovery Protocol on the current
interface.
Example
Summary Configure the advertised router address for the current interface.
User-Entered <ipaddress>:
Parameters The IP address that the interface will advertise as its router address. The valid values are
224.0.0.1 and 255.255.255.255.
Description This command configures the address to be used to advertise the router for the
interface.
5-3
BAR Administration Guide
5.2 Defaults
Example
IP Address: 224.0.0.1
User-Entered <maxadvertinterval>
Parameters The maximum number of seconds allowed between router advertisements. Acceptable
values are from 4 to 1800.
Description This command configures the maximum time, in seconds, allowed between sending
router advertisements from the interface.
Example
User-Entered <minadvertinterval>
Parameters This parameter is the duration, in seconds, of the interval between router
advertisements from the interface. Values for this parameter are from 3 seconds up to
the current maxadvertinterval value for the interface.
Description This command configures the minimum time, in seconds, allowed between sending
router advertisements from the interface.
5-4
BAR Administration Guide
Defaults
Example
Minadvertinterval: (0.75 * maxadvertinterval)
5.2
(Pannaway BAR) (Interface 0/2)#ip irdp minadvertinterval 800
General Routing
Configuration
Commands
Related Commands ip irdp maxadvertinterval <maxadvertinterval> on page 5-4
show ip irdp [<slot/port> | all] on page 5-8
Summary Set hold time for IRDP advertisements from this interface.
User-Entered <time>
Parameters The amount of time, in seconds, that the router will hold IRDP advertisements from
this interface. Values for this parameter may be from the configured maxadvertinterval
value (maximum advertising interval, default of 600 seconds) up to 9000 seconds.
Description This command configures the value, in seconds, of the holdtime field of the router
advertisement sent from this interface.
Example
User-Entered <irdp-preference>
Parameters Preference value of the interface. This value may be from
-2,147,483,648 to 2,147,483,648. Enter the value without commas.
Description This command configures the preferability of the address as a default router address,
relative to other router addresses on the same subnet.
5-5
BAR Administration Guide
5.3 Defaults
Example
IRDP-preference: 0
ip netdirbcast
User-Entered None
Parameters
Description This command activates the Network Directed Broadcasting mode for the BAR
interface.
Example
User-Entered <slot/port>
Parameters A combination of slot and port numbers that identifies a single interface on the BAR.
Description This command displays the IP network settings for the BAR, including the IP address,
subnet mask, and some router operational modes.
5-6
BAR Administration Guide
Defaults None
Example
5.3
(Pannaway BAR) #show ip interface 0/5
IP Address..................................... 66.15.30.2
Subnet Mask.................................... 255.255.255.252
Routing Mode................................... Enable General Routing
Administrative Mode............................ Enable Display
Forward Net Directed Broadcasts................ Disable
Active State................................... Active
Commands
Link Speed Data Rate........................... 1000 Full
MAC Address.................................... 00:0A:9F:50:00:96
Encapsulation Type............................. Ethernet
Command Output The show ip interface statistics screen displays the following information:
Subnet Mask A mask of the network and host portion of the IP address
for the router interface. This is a configured value.
Link Speed Data Rate An integer representing the physical link data rate of the
specified interface. This is measured in Megabits per
second (Mbps).
Encapsulation Type The encapsulation type for the specified interface. The
types are: Ethernet or SNAP. This is a configured value.
5-7
BAR Administration Guide
Defaults None
Example
Command Output The show ip interface brief screen displays the following information:
IP Address The IP address of the routing interface in 32-bit dotted decimal format.
IP Mask The IP mask of the routing interface in 32-bit dotted decimal format.
Netdir Bcast Indicates if net-directed broadcasts are forwarded on this interface. Possible
values are Enable or Disable.
MultiCast Fwd Indicates the multicast forwarding administrative mode on the interface.
Possible values are Enable or Disable.
Summary Display IRDP settings for the specified interface or all interfaces on the BAR.
User-Entered <slot/port>:
Parameters A combination of slot and port numbers that identifies a single interface on the BAR.
all:
This argument applies the command to all BAR interfaces.
Description This command supplies a table of IRDP settings reflecting the configuration of each
IRDP-enabled interface in the BAR.
5-8
BAR Administration Guide
Defaults None
5.4
Example
Intf The slot and port combination identifying the IRDP interface.
Ad Mode The advertise mode which indicates whether router discovery is enabled
or disabled on this interface.
Max Int The maximum advertise interval which is the maximum time allowed
between sending router advertisements from the interface in seconds.
Min Int The minimum advertise interval which is the minimum time allowed
between sending router advertisements from the interface in seconds.
Hold Time The amount of time for IRDP advertisements on the interface.
User-Entered <ipaddress>
Parameters IP address of a device on a subnet attached to an existing routing interface.
<macaddress>
The unicast MAC address for the device identified by the <ipaddress> parameter. The
format is 6 two-digit hexadecimal numbers that are separated by colons.
Description This command creates an entry in the BAR’s system Address Resolution Protocol table.
5-9
BAR Administration Guide
Defaults None
Example
5.4
(Pannaway BAR) (Config)#arp 10.10.4.252 00:00:1d:5f:a3:15
User-Entered <entries>
Parameters The size, in entries, of the ARP cache. The acceptable range of this value is 152 - 3304.
Description This command manually configures the maximum number of entries that can be stored
in the BAR system ARP cache. When the ARP cache entry limit is reached, newer ARP
table entries will automatically overwrite older ones.
Example
arp dynamicrenew
User-Entered None
Parameters
Description This command enables the system ARP component to automatically renew ARP entries
of the “dynamic” type when they age out.
Example
5-10
BAR Administration Guide
User-Entered <ipaddr>
Parameters The IP address to be purged from the ARP cache.
Description This command causes the IP address specified by <ipaddr> to be removed from the
ARP cache. Only entries of type dynamic or gateway are affected by this command.
Defaults None
Example
User-Entered <resp-timeout>
Parameters Duration of the timeout in seconds. The range of this value is from 1-10 in whole
number increments.
Description This command configures the ARP request response timeout. The value for
<resp-timeout> is a valid positive integer, ranging from 1-10, which represents the IP
ARP entry response timeout time in seconds.
Defaults Resp-timeout: 1
Example
5-11
BAR Administration Guide
Defaults Retries: 4
Example
User-Entered <seconds>
Parameters The number of seconds that ARP entries will be held in the ARP cache. Values are from
15 - 21600, in whole number increments only.
Description This command configures the ARP entry ageout time, in seconds.
Example
5-12
BAR Administration Guide
Description This command clears the contents of the BAR’s ARP cache.
Defaults None
Example
show arp
Summary Show the ARP cache and ARP settings for the BAR.
User-Entered None
Parameters
Description This command displays the Address Resolution Protocol (ARP) cache. The displayed
results are not the total ARP entries. To view the total ARP entries, you should view the
show arp results in conjunction with the results of show arp switch on page 3-30.
Defaults None
5-13
BAR Administration Guide
Example
5.5 Retries........................................
Cache Size.....................................
Dynamic Renew Mode ............................
4
3304
Disable
ARP Display Total Entry Count Current / Peak .............. 30 / 35
Static Entry Count Current / Max .............. 0 / 64
Commands
IP Address MAC Address Interface Type Age
--------------- ----------------- ----------- -------- -----------
10.10.2.1 00:0A:9F:00:02:AE 0/11 Gateway 0h 0m 20s
10.10.2.2 00:01:E7:1E:4B:80 0/11 Dynamic 0h 15m 55s
10.10.2.17 00:09:5B:05:D1:3B 0/11 Dynamic 0h 11m 47s
10.10.2.18 00:09:5B:0A:67:95 0/11 Dynamic 0h 2m 9s
10.10.2.19 00:09:5B:0A:DF:7B 0/11 Dynamic 0h 4m 44s
10.10.2.20 00:0A:9F:40:00:2B 0/11 Dynamic 0h 12m 58s
10.10.2.24 00:0A:9F:00:02:A4 0/11 Dynamic 0h 16m 17s
10.10.2.29 00:0A:9F:00:02:59 0/11 Dynamic 0h 16m 13s
10.10.2.31 00:08:74:DE:6D:08 0/11 Dynamic 0h 0m 7s
--More-- or (q)uit
Command Output The response to this command displays the following information:
Age Time (seconds) The time, in seconds, that an ARP table entry is retained
before being deleted.
Response Time (seconds) The amount of time, in seconds, that the BAR waits for an
ARP response before timing out the request.
Total Entry Count Current / Peak Lists the total entries in the ARP table and the peak entry
count in the ARP table.
Static Entry Count Current / Max Lists the static entry count in the ARP table and maximum
static entry count in the ARP table.
Interface The routing slot/port associated with the device ARP entry.
Type The type of ARP entry. The possible values are Local, Gateway, Dynamic
and Static.
Age The current age of the ARP entry since last refresh (in hh:mm:ss format).
5-14
BAR Administration Guide
User-Entered None
Parameters
Description This command displays an abbreviated set of information pertaining to the ARP cache
for the BAR.
Defaults None
Example
Command Output In response to this command, the system presents the following information:
Age Time (seconds) The time, in seconds, that an ARP table entry is retained
before being deleted.
Response Time (seconds) The amount of time, in seconds, that the BAR waits for an
ARP response before timing out the request.
Total Entry Count Current / Peak Lists the total entries in the ARP table and the peak entry
count in the ARP table.
Static Entry Count Current / Max Lists the static entry count in the ARP table and maximum
static entry count in the ARP table.
5-15
BAR Administration Guide
User-Entered None
Parameters
Description This command enables the use of Circuit ID Option mode (cidoptmode) on the BAR.
The circuit ID option mode provides for the limitation of addresses assigned by DHCP
to a single client. Enabling this mode for DHCP relay allows servers supporting this
functionality to pass circuit ID option information in DHCP packets.
Example
bootpdhcprelay disable
User-Entered None
Parameters
Description This command disables BootP and DHCP Relay request forwarding on the BAR.
5-16
BAR Administration Guide
Example
User-Entered <hops>
Parameters The maximum number of relay agent hops. Values are from 1 to 16.
Description This command sets the maximum number of relay agent hops that BootP and DHCP
Relay requests from the BAR’s locally connected networks may cross.
Defaults Hops: 4
Example
User-Entered <min-wait>
Parameters Number of seconds the BAR will wait for resolution of a BootP/DHCP Relay request.
Values are from 0-100.
Description Entering this command sets the BAR’s BootP/DHCP Relay wait timer to the supplied
value.
Defaults min-wait: 0
Example
5-17
BAR Administration Guide
Description This command configures up to eight server IP addresses for BootP/DHCP Relay on
the system.
Example
show bootpdhcprelay
Summary Show BootP and DHCP Relay settings for the BAR.
User-Entered None
Parameters
Description When this command is entered, the BAR displays BootP and DHCP Relay
configuration information.
Defaults None
5-18
BAR Administration Guide
Example
Server IP Address (1 - 8) The IP Addresses of the BootP/DHCP Relay servers configured for
the BAR.
Circuit Id Option Mode Indicates the DHCP Circuit ID setting (enabled or disabled).
5-19
BAR Administration Guide
5.7
BootP/DHCP
Relay Display
Commands
5-20
Chapter 6
RIP Routing Commands
This chapter provides detailed information about Routing Information Protocol (RIP)
routing configuration and monitoring for the Pannaway BAR.
The Routing Information Protocol (RIP) is an interior gateway protocol (IGP) that uses
a distance-vector algorithm to determine the best route to a destination, using a hop
count as the route metric or “cost” value.
Topic on page
System-Level RIP Use the following commands to configure RIP (Routing Information Protocol) on
Commands the BAR.
auto-summary
User-Entered None
Parameters
Example
6.2
(Pannaway BAR) (Config-router)#auto-summary
User-Entered None
Parameters
Description This command enables the BAR to advertise its own default routes to other RIP
routers.
Example
default-metric <metric>
User-Entered <metric>:
Parameters A numerical value of the weight the RIP protocol assigns to RIP router interfaces on
the BAR by default. Values from 1 to 15 are allowable.
Description This command is used to set a default metric value for distributed RIP routes.
Example
6-2
BAR Administration Guide
Defaults Distance: 15
Example
Summary Create access list index for the specified source protocol.
User-Entered <listnumber>
Parameters A numerical value identifying the access list. Acceptable values are from 1 to 199.
Description This command is used to specify a standard IP access list index number, ranging from
1-199, for which routes received from the specified source protocol will be filtered.
Defaults None
Example
6-3
BAR Administration Guide
enable
Example
hostroutesaccept
User-Entered None
Parameters
Description This command enables the RIP host routes accept mode.
Example
6-4
BAR Administration Guide
Description This command configures RIP routing to redistribute routes from the specified source
protocol/routers. The route value can be OSPF, BGP, Static, or Connected.
Example
redistribute ospf [metric <metricvalue>] [match [internal] [external 1] [external 2] [nssa-external 1] [nssa-
external-2]]
“no” Form no redistribute ospf [match [internal] [external 1] [external 2] [nssa-external 1] [nssa-external 2]]
The “no” version of this command prevents RIP routing from redistributing OSPF
routes of the specified match type.
6-5
BAR Administration Guide
Example
RIP
Configuration split-horizon {none | simple | poison}
Commands
Summary Set RIP split horizon mode on the BAR.
Description The use of an appropriate mode limits the propagation of already known routes. When
a route is learned, a BAR using split horizon will not re-advertise the route through the
interface it came in on. A BAR using the poison reverse mode will send updates with
invalid metrics to “prune” any re-advertised routes from connected RIP routers.
Example
Interface-level RIP The commands in this section configure RIP operation on an individual interface level.
Commands
ip rip
User-Entered None
Parameters
Description This command enables the operation of the RIP protocol on the currently selected
BAR interface.
6-6
BAR Administration Guide
Defaults
Example
Mode disabled.
6.2
(Pannaway BAR) (Interface 0/2)#ip rip
RIP
Configuration
Commands
Related Commands show ip rip interface <slot/port> on page 6-11
User-Entered none
Parameters If this parameter is selected, no authentication will be used for RIP.
simple <key>
If the “simple” parameter is selected the BAR will use simple (password) authentication
for RIP operations. A <key> value must be supplied. The <key> is up to 8
alphanumeric, non-control characters.
encrypt <key> <keyid>
If “encrypt” is selected as the authentication parameter, the BAR will use encrypted RIP
authentication. A <key> value of up to 256 alphanumeric characters must be supplied,
and an additional <keyid> value, from 0 - 255, must also be specified.
Description This command sets the RIP Version 2 Authentication Type and Key (if used) for the
specified interface.
Example
6-7
BAR Administration Guide
Summary Set RIP control packet receive permissions for the interface.
Description This command configures the interface to allow RIP control packets of the specified
version(s) to be received or discarded.
Example
Summary Set the RIP control packet format sent by the interface.
User-Entered rip1
Parameters Only broadcast RIP version 1 formatted control packets.
rip1c
Only broadcast RIP version 1c formatted control packets.
rip2
Only broadcast RIP version 2 formatted control packets.
none
Do not broadcast RIP control packets.
Description This command configures the interface to allow RIP control packets of the specified
version(s) to be broadcast transmitted, or deny broadcasting of the specified control
packets.
6-8
BAR Administration Guide
Defaults
Example
Version: rip1c
6.3
(Pannaway BAR) (Interface 0/2)#ip rip send version rip1c
RIP Display
Commands
Related Commands show ip rip interface <slot/port> on page 6-11
show ip rip
User-Entered None
Parameters
Description This command displays information relevant to the RIP operation of the Broadband
Aggregation Router, including current RIP settings and modes.
Defaults None
Example
Redistributing.................................
Source......................................... ospf
Metric......................................... 12
Match Value.................................... ’nssa-external 2’
Distribute List................................ 2
Redistributing.................................
Source......................................... bgp
Metric......................................... 10
Distribute List................................ Not configured
6-9
BAR Administration Guide
Command Output The following information is displayed on the show ip rip screen:
RIP Admin Mode The administrative mode of router RIP operation: enabled or
disabled.
Global Queries The number of responses sent to RIP queries from other
systems.
Default-metric The default metric value set for RIP operation. This is a
configured value.
Default Route Advertise Indicates whether the default routes received from other source
protocols are advertised or not.
Match-Value The criteria by which OSPF routes are redistributed into other
routing domains (OSPF only).
User-Entered None
Parameters
Description This command displays a short table of basic RIP settings, modes, and conditions for
the interfaces of the BAR.
Defaults None
6-10
BAR Administration Guide
Example
Command Output The following information is displayed on the show ip rip interface brief screen:
Send Version The RIP version(s) used when sending updates on the interface. The
types are none, RIP-1, RIP-1c, or RIP-2.
Receive Version The RIP version(s) allowed when receiving updates from the interface.
The types are none, RIP-1, RIP-2, or Both.
RIP Mode The administrative mode of router RIP operation on the interface:
enabled or disabled.
Link State The link state of the interface (link up or link down).
Summary Display the RIP configuration and mode settings for the specified interface.
User-Entered <slot/port>
Parameters A combination of slot and port numbers that identifies a single interface on the BAR.
Description This command displays RIP information related to the interface identified by
<slot/port>.
Defaults None
6-11
BAR Administration Guide
Example
Interface...................................... 0/1
6.3 IP Address.....................................
Send version...................................
Receive version................................
10.10.23.1
RIP-1c
Both
RIP Display RIP Admin Mode................................. Enable
Link State..................................... Down
Commands
Authentication Type............................ None
Default Metric................................. -----
Bad Packets Received........................... -----
Bad Routes Received............................ -----
Updates Sent................................... -----
Command Output The following fields are displayed on the show ip rip interface screen:
Send version The RIP version(s) used when sending updates on the specified
interface: none, RIP-1, RIP-1c, or RIP-2.
Receive version The RIP version(s) allowed when receiving updates from the
specified interface: none, RIP-1, RIP-2, or both.
RIP Admin Mode The administrative mode of RIP operation on this interface: enabled
or disabled.
Authentication Type The RIP Authentication Type for the interface: none, simple, and
encrypt.
Authentication Key The RIP Authentication Key for the interface is simple or encrypted
authentication are set for the interface. The actual key will be **** to
avoid compromising privacy.
Authentication Key ID The RIP Authentication Key ID for the specified interface.
Default Metric The metric used for default routes in RIP updates originated on the
specified interface.
Bad Packets Received The number of RIP response packets received by the RIP process
which were subsequently discarded for any reason.
Bad Routes Received The number of routes contained in valid RIP packets that were
ignored for any reason.
Updates Sent The number of triggered RIP updates actually sent on this interface.
6-12
Chapter 7
OSPF Routing Commands
This chapter provides detailed information about Open Shortest Path First (OSPF)
routing commands in the Pannaway BAR.
Topic on page
System-Level OSPF These commands configure OSPF on the BAR at a system-wide level.
Commands
1583compatibility
User-Entered None
Parameters
Description This command enables the RFC 1583 compatibility mode of operation for the
interfaces in the BAR.
NOTE: 1583 compatibility mode is enabled by default. If all OSPF routers in the
routing domain are capable of operating according to RFC 2328, OSPF 1583
compatibility mode should be disabled with the “no” form of the command.
BAR Administration Guide
7.2 Example
User-Entered <areaid>
Parameters The identification of the OSPF area to be configured. Values from 0.0.0.0 to
255.255.255.255 are acceptable.
none
Sets the BAR to use no authentication for OSPF area operation.
simple
Configures the BAR to use simple authentication for OSPF.
encrypt
Sets the BAR to use encrypted authentication methods for OSPF on this area.
Description This command specifies the authentication type to be used for the specified OSPF area.
Example
User-Entered <areaid>
Parameters The identification of the OSPF area to be configured. Values from 0.0.0.0 to
255.255.255.255 are acceptable.
7-2
BAR Administration Guide
<cost>
The OSPF cost of the stub area or not-so-stubby area. Acceptable values are from
1 - 16,777,215.
7.2
Description This command configures the monetary default cost for the stub area or nssa. The
operator must specify the <areaid> and an integer value between 1-16,777,215 for
default cost.
OSPF
“no” Form None Configuration
Defaults None Commands
Example
User-Entered <areaid>
Parameters The identification of the OSPF area to be configured. Values from 0.0.0.0 to
255.255.255.255 are acceptable.
Description This command configures the specified <areaid> to function as an NSSA (“not so
stubby area”).
Defaults None
Example
User-Entered <areaid>
Parameters The identification of the OSPF area to be configured. Values from 0.0.0.0 to
255.255.255.255 are acceptable.
[<metric>]
The optional <metric> parameter specifies the metric of the default route and must be
in a range of 1-16,777,215.
7-3
BAR Administration Guide
{comparable | non-comparable}
Selects the metric type that will be advertised for the NSSA. The metric type can be
“comparable” (nssa-external 1) or “non-comparable” (nssa-external 2).
7.2
Description This command configures the metric value and type for the default route advertised
into the NSSA specified by <areaid>.
If no metric is specified, the default metric value is 1 and the metric type is comparable.
OSPF
Configuration “no” Form no area <areaid> nssa default-info-originate
Commands The “no” form of this command sets the specified area to the default values for the
Metric and Metric-type parameters.
Defaults Metric: 1
Metric-type: comparable
Example
User-Entered <areaid>
Parameters The identification of the OSPF area to be configured. Values from 0.0.0.0 to
255.255.255.255 are acceptable.
Description This command configures the NSSA ABR (Area Border Router) so that learned
external routes will not be redistributed to the NSSA specified by <areaid>.
Example
7-4
BAR Administration Guide
User-Entered <areaid>
Parameters The identification of the OSPF area to be configured. Values from 0.0.0.0 to
255.255.255.255 are acceptable.
7.2
Description This command configures the NSSA so that summary LSAs are not advertised into the
NSSA specified by <areaid>.
Example
User-Entered <areaid>
Parameters The identification of the OSPF area to be configured. Values from 0.0.0.0 to
255.255.255.255 are acceptable.
{always | candidate}
The translator role that the specified NSSA will take:
• Always: The router will assume the role of the translator the instant it becomes a
border router. It will always translate Type-7 LSAs into Type-5 LSAs regardless
of the translator state of other NSSA border routers.
• Candidate: The router will participate in the translator election process when it
attains border router status.
Description This command configures the translator role of the NSSA specified by <areaid>. This
specifies whether or not an NSSA border router will unconditionally translate Type-7
LSAs into Type-5 LSAs.
Example
7-5
BAR Administration Guide
Description This command configures the translator stability interval of the NSSA border router.
Defaults Stabilityinterval: 40
Example
User-Entered <areaid>
Parameters The identification of the OSPF area to be configured. Values from 0.0.0.0 to
255.255.255.255 are acceptable.
<ipaddr>
The <ipaddr> is a valid IP address.
<subnetmask>
The <subnetmask> is a valid subnet mask.
{summarylink | nssaexternallink}
The Link State Database (LSDB) type for the area range.
[advertise | not-advertise]
The optional advertising setting of the new area. Entering “advertise” allows
advertisement.
Description This command creates a defined area range for the NSSA specified by <areaid>. The
range performs the dual function of setting propagation policy via its Advertise/
DoNotAdvertise parameter and aggregation via its network address and mask pair.
7-6
BAR Administration Guide
Defaults
Example
None
7.2
(Pannaway BAR) (Config-router)#area 0.0.0.7 range 10.10.10.0 255.255.255.252
OSPF
nssaexternallink advertise Configuration
Commands
Related Commands show ip ospf area <areaid> on page 7-24
User-Entered <areaid>
Parameters The identification of the OSPF area that the stub will be created on. Values from 0.0.0.0
to 255.255.255.255 are acceptable.
Description This command creates a stub area for the specified <areaid>. A stub area is
characterized by the fact that AS External LSAs (Autonomous System External Link
Service Announcements) are not propagated into the area. Removing AS External
LSAs and Summary LSAs can significantly reduce the link state database of routers
within the stub area.
Defaults None
Example
User-Entered <areaid>
Parameters The identification of the OSPF area to be configured. Values from 0.0.0.0 to
255.255.255.255 are acceptable.
Description This command configures the Summary LSA mode for the stub area identified by
<areaid> to enabled. The Summary LSA mode is configured as enabled.
7-7
BAR Administration Guide
7.2 Defaults
Example
Mode disabled
User-Entered <areaid>
Parameters The identification of the OSPF area to be configured. Values from 0.0.0.0 to
255.255.255.255 are acceptable.
<neighbor>
The IP address of a neighbor interface for the new virtual link.
Description This command creates the OSPF virtual interface for the specified <areaid> and
<neighbor>.
NOTE: Virtual links cannot be created across stub areas and NSSAs.
Defaults None
Example
area <areaid> virtual-link <neighbor> authentication {none | simple <key> | encrypt <key> <keyid>}
User-Entered <areaid>
Parameters The identification of the OSPF area to be configured. Values from 0.0.0.0 to
255.255.255.255 are acceptable.
7-8
BAR Administration Guide
<neighbor>
The IP address of the neighbor interface for the virtual link.
{none | simple | encrypt}
7.2
The encryption mode that the interface will use.
<key>
An authentication key that will be used for the interface. A key must be supplied if
“simple” or “encrypt” are selected as authentication options. The key must consist of OSPF
standard alphanumeric characters. Configuration
Commands
If “simple” authentication is used, the <key> must be 8 bytes or less in length. If
“encrypt” authentication is used, the key may be up to 256 bytes.
<keyid>
The identification number of the key to be used for encrypted authentication. The keyid
is a number from 0 to 255.
Description This command configures the authentication type and key for the OSPF virtual
interface identified by <areaid> and <neighbor>.
Example
User-Entered <areaid>
Parameters The identification of the OSPF area to be configured. Values from 0.0.0.0 to
255.255.255.255 are acceptable.
<neighbor>
The IP address of the neighbor interface that identifies the virtual link.
<d-interval>
The dead interval value for the virtual interface, measured in seconds. The acceptable
range for this value is from 1 to 65,535 seconds.
Description This command configures the dead interval for the OSPF virtual interface on the
virtual interface identified by <areaid> and <neighbor>.
7-9
BAR Administration Guide
Defaults D-interval: 40
7.2 Example
User-Entered <areaid>
Parameters The identification of the OSPF area to be configured. Values from 0.0.0.0 to
255.255.255.255 are acceptable.
<neighbor>
The IP address of the neighbor interface that identifies the virtual link.
<h-interval>
The hello interval value for the virtual interface, measured in seconds. The acceptable
range for this value is from 1 to 65535 seconds.
Description This command configures the hello interval (in seconds) for the OSPF virtual interface
on the virtual interface identified by <areaid> and <neighbor>.
Defaults H-interval: 10
Example
7-10
BAR Administration Guide
User-Entered <areaid>
Parameters The identification of the OSPF area to be configured. Values from 0.0.0.0 to
255.255.255.255 are acceptable.
7.2
<neighbor>
The IP address of the neighbor interface that identifies the virtual link.
<r-interval>
The retransmit interval value for the virtual interface, measured in seconds. The OSPF
acceptable range for this value is from 0 to 3600 seconds. Configuration
Commands
Description This command configures the retransmit interval for the OSPF virtual interface on the
virtual interface identified by <areaid> and <neighbor>.
Defaults R-interval: 5
Example
User-Entered <areaid>
Parameters The identification of the OSPF area to be configured. Values from 0.0.0.0 to
255.255.255.255 are acceptable.
<neighbor>
The IP address of the neighbor interface that identifies the virtual link.
<delay>
The transmit delay setting for the virtual interface, measured in seconds. The acceptable
range for this value is from 0 to 3600 seconds.
Description This command configures the transmit delay for the OSPF virtual interface on the
virtual interface identified by <areaid> and <neighbor>.
Defaults Delay: 1
7-11
BAR Administration Guide
Example
7.2 Related Commands show ip ospf virtual-link <areaid> <neighbor> on page 7-28
show ip ospf virtual-link brief on page 7-30
OSPF
Configuration default-information originate [always] [metric <value>] [metric-type {1 | 2}]
Commands
Summary Set route advertisement behavior.
User-Entered [always]
Parameters This optional parameter sets the BAR to always advertise default routes.
[metric <value>]
This optional parameter specifies a metric value for default routes advertised by the
BAR. The <value> may be from 0 to 16,777,215
[metric-type {1 | 2}]
This optional parameter specifies the metric type that the BAR will advertise.
Example
default-metric <value>
User-Entered <value>
Parameters This parameter specifies the new default metric for distributed OSPF routes. The value
may be from 1 to 16,777,215
Description This command is used to set a default metric value for distributed OSPF routes.
7-12
BAR Administration Guide
Example
7.2
(Pannaway BAR) (Config-router)#default-metric 15
<preference-value>
The preference value assigned to the specified route type. The acceptable range of
values for this parameter is 0 - 255. Lower values represent an increased preference for
the route.
Description This command sets the preference value of OSPF in the router for each route type.
Lower route preference values are preferred when determining the best route. The type
of OSPF route can be intra, inter, type-1, or type-2.
The OSPF specification (RFC 2328) requires that preferences must be given to the
routes learned via OSPF in the following order: intra < inter < type-1 < type-2.
Example
enable
User-Entered None
Parameters
Description This command resets the default administrative mode of OSPF in the router to enabled
(active).
7-13
BAR Administration Guide
7.2 Defaults
Example
Mode enabled
exit-overflow-interval <o-interval>
User-Entered <o-interval>
Parameters This interval is the number of seconds after entering overflow state that a router will
wait before attempting to leave the overflow state. Acceptable values are from 0 (never
automatically leave overflow state) to 2,147,483,647 seconds.
Description This command configures the exit overflow interval for OSPF. This allows the router to
again originate non-default AS-external-LSAs. When set to 0, the router will not leave
overflow state until restarted.
Example
external-lsdb-limit <l-limit>
User-Entered <l-limit>
Parameters The LSDB limit for OSPF operation on the BAR. The value for this parameter may be
from -1 (indicating no limit) to 2,147,483,647.
Description This command configures the external LSDB limit for OSPF. When the number of
non-default AS-external-LSAs in a router’s link-state database reaches the external
LSDB limit, the router enters overflow state. The router never holds more than the
external LSDB limit non-default AS-external-LSAs in its database. The external LSDB
limit MUST be set identically in all routers attached to the OSPF backbone and/or any
regular OSPF area.
7-14
BAR Administration Guide
Defaults
Example
L-limit: -1
7.2
(Pannaway BAR) (Config-router)#external-lsdb-limit 200000
OSPF
Configuration
Commands
Related Commands show ip ospf on page 7-22
Summary Specify a standard access list index number for incoming protocols.
User-Entered <list-number>
Parameters A numerical value identifying the access list. Acceptable values are from 1 to 199.
Description This command is used to specify a standard IP access list index number, ranging from
1-199, for which routes received from the specified source protocol will be filtered.
Defaults None
Example
redistribute {rip | bgp | static | connected} [metric <metrictype>] [metric-type {1 | 2}] [tag <tagvalue>]
[subnets]
7-15
BAR Administration Guide
metric-type {1 | 2}
This optional parameter defines the type of metric that the <metrictype> parameter
represents.
7.2
tag <tagvalue>
This optional parameter specifies a tag value for the redistributed routes. The
<tagvalue> value is a whole number from 0 to 4,294,967,295.
OSPF subnets
Configuration This optional parameter, if specified, applies the redistribute command to subnets.
Commands
Description This command configures OSPF routing to redistribute routes from the specified
source protocol/routers.
“no” Form no redistribute {rip | bgp | static | connected} [metric] [metric-type] [tag] [subnets]
The “no” version of this command prevents OSPF routing from redistributing routes
from the specified source/protocol routers.
Example
router-id <router_id>
User-Entered <router_id>
Parameters The number, in dotted decimal notation, of the router OSPF ID.
Description This command sets the unique identifier of the router OSPF ID.
Defaults None
Example
trapflags
7-16
BAR Administration Guide
User-Entered None
Parameters
User-Entered None
Parameters
Example
User-Entered <areaid>
Parameters The identification of the OSPF area that the interface connects to. Values from 0.0.0.0
to 255.255.255.255 are acceptable.
Description This command sets the OSPF area to which the specified router interface belongs.
7-17
BAR Administration Guide
Defaults None
7.2
Example
OSPF
Related Commands show ip ospf area <areaid> on page 7-24
Configuration
Commands
ip ospf authentication {none | {simple <key>} | {encrypt <key> <keyid>}}
<key>
An authentication key that will be used for the interface. A key must be supplied if
“simple” or “encrypt” are selected as authentication options. The key must be made of
standard alphanumeric characters.
If “simple” authentication is used, the <key> must be 8 bytes or less in length. If
“encrypt” authentication is used, the key may be up to 256 bytes.
<keyid>
The identification number of the key to be used for encrypted authentication. The keyid
is a number from 0 to 255.
Description This command sets the OSPF Authentication Type and Key for the specified interface.
NOTE: The authentication setting must match the authentication set for the OSPF
area to which the port belongs.
Example
Related Commands area <areaid> authentication {none | simple | encrypt} on page 7-2
show ip ospf interface <slot/port> on page 7-31
7-18
BAR Administration Guide
User-Entered <cost>
Parameters The cost of the interface. Values from 1 to 65,535 are acceptable.
User-Entered <h-interval>
Parameters The hello interval for the interface. Values are measured in seconds, and may be from 1
to 65,535 seconds.
NOTE: The hello interval used for the interface must be the same for all OSPF
routers attached to the network.
Description This command sets the OSPF hello interval for the specified interface, in seconds.
Example
7-19
BAR Administration Guide
User-Entered <d-interval>
Parameters The dead interval value for the interface. The acceptable range for this value is from 1
to 2,147,483,647 seconds. The recommended value for the dead interval is a multiple of
the hello interval configured for the interface.
7.2 Description This command sets the OSPF dead interval for the specified interface, in <seconds>.
The value is a valid positive integer, which represents the length of time in seconds that
OSPF a router’s Hello packets have not been seen before its neighbor routers declare that the
Configuration router is down. The value for the length of time must be the same for all routers
Commands attached to a common network.
Example
User-Entered <priority>
Parameters The priority value assigned to the interface. Acceptable values are from 0 to 255. Lower
values indicate a higher priority. A priority value of ‘0’ indicates that the router is not
eligible to become the designated router on this network.
Description This command sets the OSPF priority for the specified router interface.
Defaults Priority: 1
Example
7-20
BAR Administration Guide
Example
User-Entered <delay>
Parameters The retransmit delay value for the interface. Acceptable values are from 1 to 3600,
measured in seconds.
Description This command sets the OSPF Transmit Delay for the specified interface. In addition, it
sets the estimated number of seconds it takes to transmit a link state update packet over
this interface.
Example
7-21
BAR Administration Guide
User-Entered None
Parameters
Defaults None
Example
Redistributing.................................
Source......................................... bgp
Metric......................................... 0
Metric Type.................................... 2
--More-- or (q)uit
Tag............................................ 0
Subnets........................................ Yes
Distribute List................................ Not configured
Command Output The following information is show in response to the show ip ospf command:
Router ID The 32 bit integer in dotted decimal format identifying the router
about which information is displayed.
7-22
BAR Administration Guide
7.3
possible values for the ASBR status is enabled (if the router is
configured to re-distribute routes learnt by other protocols) or
disabled (if the router is not configured for the same).
RFC 1583 Compatibility Indicates whether 1583 compatibility is enabled or disbled. OSPF Display
Default-Metric The router’s default metric value for redistributed routes. Commands
Source Source protocol/routes that the router can redistribute.
Match-value The criteria by which OSPF routes are redistributed into other
routing domains.
Subnets For redistributing routes into OSPF, the scope of redistribution for
the specified protocol.
Default Route Advertise Indicates whether the default routes received from other source
protocols are advertised (Enabled) or not (Disabled).
ABR Status Indicates whether or not the router is an OSPF Area Border
Router.
Exit Overflow Interval The number of seconds that, after entering OverflowState, a
router will attempt to leave OverflowState.
External LSA count The number of external (LS type 5) link-state advertisements in
the link-state database.
External LSA Checksum A number which represents the sum of the LS checksums of
external link-state advertisements contained in the link-state
database.
New LSAs Originated The number of new link-state advertisements that have been
originated.
7-23
BAR Administration Guide
Defaults None
Example
Command Output The following information is shown on the show ip ospf area screen:
Authentication Type The configured authentication type to use for this area.
Spf Runs The number of times that the intra-area route table has been
calculated using this area’s link-state database.
Area Border Router Count The total number of area border routers reachable within this
area.
Area LSA Count The total number of link-state advertisements in this area’s link-
state database, excluding AS External LSA’s.
7-24
BAR Administration Guide
Area LSA Checksum A number representing the Area LSA Checksum for the
specified AreaID excluding the external (LS type 5) link-state
advertisements.
7.3
Stub Mode Indicates whether the specified Area is a stub area or not. The
possible values are enabled and disabled.
Import Summary LSAs Indicates whether the area Summary LSA mode for stub areas
is enabled or disabled. OSPF Display
Commands
If the value is configured as a stub area, the following stub area-specific information is
displayed
Metric Type The Default Metric Type for the specified Area.
No-Summary Mode Indicates whether the area Summary LSA mode for NSSAs is
enabled or disabled.
No-Redistribute Mode Indicates the No Redistribute mode setting for the NSSA:
enabled (external routes are not distributed) or disabled
(external routes are distributed).
Default Information Originate Indicates whether the metric value and type for the default
route advertised into the NSSA has been administratively
configured (TRUE) or left at the default state (FALSE).
Default Metric Indicates the metric value for the default route advertised into
the NSSA.
Default Metric Type Indicates the metric type (comparable or non-comparable) for
the default route advertised into the NSSA.
Translator Stability Interval Displays the translator stability interval set for this NSSA’s
border router.
Related Commands area <areaid> authentication {none | simple | encrypt} on page 7-2
area <areaid> default-cost <cost> on page 7-2
area <areaid> nssa default-info-originate [<metric>] {comparable | non-comparable} on
page 7-3
area <areaid> nssa no-redistribute on page 7-4
area <areaid> nssa no-summary on page 7-4
area <areaid> nssa translator-role {always | candidate} on page 7-5
area <areaid> nssa translator-stab-intv <stabilityinterval> on page 7-6
area <areaid> stub on page 7-7
area <areaid> stub summarylsa on page 7-7
show ip ospf area <areaid> on page 7-24
7-25
BAR Administration Guide
Description This command displays the link state database. This command will only display
information if OSPF administrative mode is enabled on the BAR.
Defaults None
Example
--More-- or (q)uit
Router ID The 32 bit dotted decimal number representing the LSDB interface.
LSA Type The types are: router, network, ipnet sum, asbr sum, as external, group
member, tmp 1, tmp 2, opaque link, opaque area.
7-26
BAR Administration Guide
Options An indicator of any special handling LSA receives during routing calculations.
7.3
Related Commands router-id <router_id> on page 7-16 OSPF Display
area <areaid> nssa on page 7-3 Commands
area <areaid> stub on page 7-7
ip ospf areaid <areaid> on page 7-17
Summary Show the ranges configured for the specified Area ID.
User-Entered <areaid>
Parameters The identification of the OSPF area to be examined.
Description This command displays information about the area ranges for the specified <areaid>.
Defaults None
Example
Command Output The following information is presented in response to the show ip ospf range
command:
Lsdb Type The type of link advertisement associated with this area range.
Related Commands area <areaid> range <ipaddr> <subnetmask> {summarylink | nssaexternallink} [advertise |
not-advertise] on page 7-6
7-27
BAR Administration Guide
Description This command displays the OSPF stub table. The information below will only be
displayed if OSPF is initialized on the switch.
Defaults None
Example
Command Output The following information is shown in the OSPF stub table:
Type of Service The type of service (TOS) associated with the stub metric. The BAR
only supports Normal TOS.
Metric Val The metric value is applied based on the TOS. It defaults to the
least metric of the type of service among the interfaces to other
areas. The OSPF cost for a route is a function of the metric value.
Import Summary LSA Indicates whether summary LSAs are imported into stub areas.
User-Entered <areaid>
Parameters The identification of the OSPF area that the virtual link resides in.
<neighbor>
The IP address of the neighbor interface that (in combination with the areaID) defines
the virtual link.
Description This command displays the OSPF Virtual Interface information for a specific area and
neighbor.
7-28
BAR Administration Guide
Defaults None
7.3
Example
Command Output The virtual interface information consists of the following fields:
Hello Interval The configured hello interval for the OSPF virtual interface.
Dead Interval The configured dead interval for the OSPF virtual interface.
Iftransit Delay Interval The configured transit delay for the OSPF virtual interface.
Retransmit Interval The configured retransmit interval for the OSPF virtual interface.
State The current state of the OSPF interface: down, loopback, waiting,
point-to-point, designated router, and backup designated router.
Authentication Type The configured authentication type of the OSPF virtual interface.
7-29
BAR Administration Guide
“
Description This command displays the OSPF Virtual Interface information for all areas in the
system.
Defaults None
Example
Hello Interval The configured hello interval for the OSPF virtual interface.
Dead Interval The configured dead interval for the OSPF virtual interface.
Retransmit Interval The configured retransmit interval for the OSPF virtual interface.
Transit Delay The configured transit delay for the OSPF virtual interface.
7-30
BAR Administration Guide
User-Entered <slot/port>
Parameters The combination of slot number and port number that identifies a unique interface on
the BAR.
Description This command displays the information for the interface object or virtual interface
tables.
Defaults None
Example
IP Address..................................... 10.10.10.1
Subnet Mask.................................... 255.255.255.252
OSPF Admin Mode................................ Enable
OSPF Area ID................................... 0.0.0.7
Router Priority................................ 2
Retransmit Interval............................ 5
Hello Interval................................. 10
Dead Interval.................................. 60
LSA Ack Interval............................... 1
Iftransit Delay Interval....................... 5
Authentication Type............................ MD5
Authentication Key............................. ********
Authentication Key ID.......................... 5
Metric Cost.................................... 20
OSPF Interface Type............................ broadcast
State.......................................... designated-router
Designated Router.............................. 10.10.5.17
Backup Designated Router....................... 0.0.0.0
Number of Link Events.......................... 2504
Command Output The following information is shown in the ip ospf interface table:
Subnet Mask A mask of the network and host portion of the IP address for the
OSPF interface.
OSPF Area ID Indicates the OSPF Area ID for the specified interface.
Router Priority The OSPF Priority setting for the specified interface.
Retransmit Interval The OSPF Retransmit Interval for the specified interface.
7-31
BAR Administration Guide
Hello Interval The OSPF Hello Interval for the specified interface.
Dead Interval The OSPF Dead Interval for the specified interface.
LSA Ack Interval The OSPF LSA Acknowledgement Interval for the specified
Authentication Key ID The number of the key type being used in multi-key configurations.
OSPF Interface Type Broadcast LANs, such as Ethernet and IEEE 802.5, take the
value ’broadcast’. The OSPF Interface Type will be ’broadcast’.
Backup Designated Router The router ID representing the backup designated router.
7-32
BAR Administration Guide
Defaults None
Example
Command Output The show ip ospf interface brief command presents the following information:
Slot/Port The combination of a slot number and port number in the BAR that
identifies an OSPF interface.
Router Priority The OSPF Priority setting for the specified interface.
Hello Intval The OSPF Hello Interval for the specified interface.
Dead Intval The OSPF Dead Interval for the specified interface.
Retrax Intval The OSPF Retransmit Interval for the specified interface.
Retrax Delay The OSPF Transit Delay for the specified interface.
LSA Ack Intval The OSPF LSA Acknowledgement Interval for the specified
interface.
7-33
BAR Administration Guide
Description This command displays the statistics for a specific interface. The information below will
only be displayed if OSPF is enabled.
Defaults None
Example
Related Commands The show ip ospf interface stats screen displays the following statistics:
Spf Runs The number of times that the intra-area route table has been
calculated using this area’s link-state database.
Area Border Router Count The total number of area border routers reachable within this
area. This is initially zero, and is calculated in each SPF pass.
AS Border Router Count The total number of Autonomous System border routers
reachable within this area.
Area LSA Count The total number of link-state advertisements in this area’s link-
state database, excluding AS External LSAs.
OSPF Interface Events The number of times the specified OSPF interface has changed
its state, or an error has occurred.
Virtual Events The number of state changes or errors that occurred on this
virtual link.
Neighbor Events The number of times this neighbor relationship has changed
state, or an error has occurred.
7-34
BAR Administration Guide
External LSA Count The number of external (LS type 5) link-state advertisements in
the link-state database.
User-Entered [<ipaddr>]
Parameters An optional parameter that identifies a particular neighbor to the interface. If this
parameter is supplied, information presented will be specific to the neighbor.
<slot/port>
The combination of slot number and port number that identifies a unique interface on
the BAR.
Description This command displays the OSPF neighbor table list for a given interface. The
information below will only be displayed if OSPF is enabled and the interface has a
neighbor.
Defaults None
Example
Interface...................................... 0/5
Router ID...................................... 10.10.10.10
Options........................................ 2
Router Priority................................ 1
State.......................................... Full
Events......................................... 5
Permanence..................................... Dynamic
Hellos Suppressed.............................. No
Retransmission Queue Length.................... 0
7-35
BAR Administration Guide
7.3
relationships will not even start to form) if there is a mismatch
in certain crucial OSPF capabilities.
Router Priority Displays the OSPF priority for the specified interface. The
OSPF Display priority of an interface is a priority integer from 0 to 255. A
value of ’0’ indicates that the router is not eligible to become
Commands the designated router on this network.
Permanence This variable displays the status of the entry, either dynamic
or permanent. This refers to how the neighbor became
known.
Hellos Suppressed This indicates whether Hellos are being suppressed to the
neighbor. The types are enabled and disabled.
7-36
BAR Administration Guide
t
Description This command displays abbreviated OSPF neighbor table information for the interface
identified by <slot/port>, or for all interfaces. The information below will only be
displayed if OSPF is enabled and the interface has a neighbor.
Defaults None
Example
Neighbor Interface Index The slot/port identifying the internal interface number of the
OSPF neighbor.
7-37
BAR Administration Guide
7.3
OSPF Display
Commands
7-38
Chapter 8
VRRP Routing Commands
This chapter provides detailed information about Virtual Router Redundancy Protocol
(VRRP) configuration on the BAR.
Topic on page
ip vrrp
User-Entered None
Parameters
Description This command enables the administrative mode of VRRP in the router.
Example
ip vrrp <vrID>
Description This command sets the virtual router ID on an interface for virtual router configuration
in the router.
Defaults None
Example
User-Entered <vrID>
Parameters This parameter is the virtual router identification (vrID) of the virtual router on the
interface that the address will be assigned to. This value is a number from 1 to 255.
<ipaddr>
This parameter is the IP address (in dotted decimal notation) to assign to the virtual
router.
Description This command sets the IP address value for a virtual router, identified by its <vrID>,
that is configured on a given interface.
Defaults None
Example
8-2
BAR Administration Guide
Description This command sets the authentication details value for a specified virtual router
configured on a given interface.
Defaults No authentication
Example
User-Entered <vrID>
Parameters This parameter is the virtual router identification (vrID) of the virtual router that
preemption will be enabled for. This value is a number from 1 to 255.
Description This command enables the preemption mode value for a virtual router, identified by its
<vrID>, that is configured on a given interface.
Example
8-3
BAR Administration Guide
Description This command sets the priority value for the virtual router, identified by its <vrID>,
that is configured on a given interface.
Example
User-Entered <vrID>
Parameters This parameter is the virtual router identification (vrID) of a virtual router on the
interface that the advertised value will be set for. This value is a number from 1 to 255.
<adv-interval>
This parameter is the advertisement value for the virtual router. This value is a number
of seconds from 1 to 255.
Description This command sets the advertisement value for a virtual router, identified by its
<vrID>, that is configured on a given interface.
Defaults Advertise: 1
8-4
BAR Administration Guide
Example
User-Entered <vrID>
Parameters This parameter is the virtual router identification (vrID) of the virtual router that will be
enabled on the interface. This value is a number from 1 to 255.
Description This command enables a virtual router, identified by its <vrID>, that is configured on a
given interface. This starts the virtual router.
Example
show ip vrrp
User-Entered None
Parameters
Description This command displays whether VRRP functionality is enabled or disabled on the BAR.
It also displays some global parameters which are required for monitoring. This
command takes no options.
Defaults None
8-5
BAR Administration Guide
Example
VRRP Display Command Output The show ip vrrp command displays the following information:
Commands
Admin Mode Displays the admin mode for VRRP functionality on the switch.
Router Checksum Errors The total number of VRRP packets received with an invalid VRRP
checksum value.
Router Version Errors The total number of VRRP packets received with Unknown or
unsupported version number.
Router VRID Errors The total number of VRRP packets received with invalid VRID for
this virtual router.
User-Entered <slot/port>
Parameters A combination of slot and port numbers that identifies a single interface on the BAR.
<vrID>
This parameter is the virtual router identification (vrID) of the virtual router to be
examined. This value is a number from 1 to 255.
Description This command displays all configuration information and VRRP router statistics of a
virtual router configured on a specific interface.
Defaults None
Example
8-6
BAR Administration Guide
Command Output The show ip vrrp interface command provides the following information:
8.3
VMAC address The VMAC address of the specified router.
Authentication Type The authentication type for the specific virtual router.
User-Entered None
Parameters
Description This command displays information about each virtual router configured on the BAR.
This command takes no options. It displays information about each virtual router.
Defaults None
Example
Command Output The following statistics are shown on the show ip vrrp interface brief screen:
8-7
BAR Administration Guide
VRRP Display Summary Display VRRP configuration and stats for a virtual router.
Commands
Required Mode Privileged Exec and User Exec
User-Entered <slot/port>
Parameters A combination of slot and port numbers that identifies a single interface on the BAR.
<vrID>
This parameter is the virtual router identification (vrID) of the virtual router to be
examined. This value is a number from 1 to 255.
Description This command displays the statistical information about each virtual router configured
on the BAR.
Defaults None
Example
Command Output The following items are shown on the show ip vrrp interface stats screen:
State Transitioned to Master The total number of times the virtual router state has
changed to MASTER.
Advertisement Interval Errors The total number of VRRP advertisements received for
which the advertisement interval is different than the
configured value for this virtual router.
8-8
BAR Administration Guide
Authentication Failure The total number of VRRP packets received that did not pass
the authentication check.
IP TTL errors The total number of VRRP packets received by the virtual
8.3
router with the IP TTL (time to live) not equal to 255.
Zero Priority Packets Received The total number of VRRP packets received by the virtual
router with a priority of ’0’.
Zero Priority Packets Sent The total number of VRRP packets sent by the virtual router
VRRP Display
with a priority of ’0’. Commands
Invalid Type Packets Received The total number of VRRP packets received by the virtual
router with an invalid “type” field.
Address List Errors The total number of VRRP packets received for which the
address list does not match the locally configured list for the
virtual router.
Invalid Authentication Type The total number of VRRP packets received with an
unknown authentication type.
Authentication Type Mismatch The total number of VRRP advertisements received for
which the ‘auth type’ is not equal to the one locally
configured for this virtual router.
Packet Length Errors The total number of VRRP packets received with a packet
length less than the length of the VRRP header.
8-9
BAR Administration Guide
8.3
VRRP Display
Commands
8-10
Chapter 9
Multicast Commands
This chapter provides descriptions of the commands that configure multicast routing
on the BAR and retrieve configuration information and statistics related to multicast
operation.
Topic on page
System-Level The commands in this section provide configuration and control over the operation of
Commands multicast routing for all interfaces of the BAR. These commands offer system-wide
configuration of multicast settings.
ip igmp
User-Entered None
Parameters
Description This command sets the administrative mode of IGMP in the BAR to active.
Example
9.2
Pannaway BAR (Config)#ip igmp
User-Entered None
Parameters
Description This command sets the administrative mode of the IP multicast forwarder in the router
to active. For multicast routing to become operational, IGMP must be currently
enabled.
An error message will be displayed on the CLI if multicast routing is enabled while
IGMP is disabled. However, the IP multicast mode configuration is stored in the
multicast configuration file and is automatically enabled once IGMP is enabled.
Example
ip dvmrp
User-Entered None
Parameters
Description This command sets the administrative mode of Distance-Vector Multicast Routing
Protocol (DVMRP) in the BAR to active. IGMP must be enabled before DVMRP can
be enabled.
9-2
BAR Administration Guide
Example
User-Entered None
Parameters
Example
User-Entered <sourceipaddr>
Parameters The IP address, in dotted decimal notation, of the multicast packet source the static
route defines a connection to.
<mask>
The network mask, in dotted decimal notation, that specifies the network portion of the
<sourceipaddr> parameter.
<rpfipaddr>
The IP address, in dotted decimal notation, of the next router hop toward the multicast
packet source.
<metric>
The metric, or cost, of the route entry. Values may be from 0 to 255.
<slot/port>
The combination of a BAR slot and port (on that slot) identifying a unique interface
that will be used by the static route to validate Reverse Path Forwarding operation.
Description This command creates a static route which is used to perform Reverse Path Forwarding
checking in multicast packet forwarding.
9-3
BAR Administration Guide
9.2 Defaults
Example
None
Multicast (Pannaway BAR) (Config)#ip multicast staticroute 229.3.3.3 255.255.0.0 10.10.1.4 1 0/1
Configuration
Commands
ip pimdm
User-Entered None
Parameters
Description This command sets the administrative mode of Protocol Independent Multicast –
Dense Mode (PIM-DM) on the BAR to enabled. IGMP must be enabled before PIM-
DM can be enabled.
Example
ip pimsm
User-Entered None
Parameters
Description This command sets administrative mode of PIM-SM multicast routing across the router
to enabled. IGMP must be enabled before PIM-SM can be enabled.
9-4
BAR Administration Guide
Example
User-Entered <d-threshold>
Parameters The data threshold rate, in kilobits per second, for BAR PIM-SM routing operations.
The acceptable range for this value is from 0 to 2000 kbps.
Description This command configures the data threshold rate for the PIM-SM router.
Example
User-Entered <msg-interval>
Parameters The Join/Prune message interval, measured in seconds, that will be used for PIM-SM
router operations on the BAR. The valid range for this value is 10 to 3600 seconds.
Description This command is used to configure the global join/prune interval for PIM-SM router.
The join/prune interval is specified in seconds.
Defaults Msg-interval: 60
Example
9-5
BAR Administration Guide
Description This command configures the Threshold rate for the Rendezvous Point (RP) router to
switch to the shortest path. The rate is specified in Kilobytes per second.
Defaults 50 Kbps
Example
ip pim-trapflags
User-Entered None
Parameters
Description This command enables the PIM trap mode for both Sparse Mode (SM) and Dense
Mode (DM).
Example
9-6
BAR Administration Guide
Description This command is used to create an RP IP address for the PIM-SM router.
Defaults None
Example
Interface-Level The commands in this section control the operation of multicast routing on individual
Commands BAR interfaces.
User-Entered <metric>:
Parameters The metric to be set for the current interface. Acceptable range for this value is from
1 to 63.
Description This command configures the metric for the current interface. This value is used in the
DVMRP messages as the cost to reach this network.
Defaults Metric: 1
Example
9-7
BAR Administration Guide
ip dvmrp
Example
User-Entered <count>
Parameters The number of queries sent to group members on the interface. Acceptable values are
whole numbers from 1 to 20.
Description This command sets the number of Group-Specific Queries sent before the router
assumes that there are no local members on the current interface.
Defaults Count: 2
Example
9-8
BAR Administration Guide
Example
User-Entered <query-interval>
Parameters The time (in seconds) that elapses between the transmission of IGMP Host Query
packets on this interface. The range is from 1 to 3600.
Description This command configures the query interval for the currently configured interface. This
is the frequency at which IGMP Host-Query packets are transmitted on this interface.
Example
9-9
BAR Administration Guide
Description This command configures the maximum response time interval for the currently
configured interface, which is the maximum query response time advertised in IGMPv2
queries on this interface.
Example
User-Entered <robustness>
Parameters The numerical rating of the interface’s robustness, a measure of expected packet loss.
Ranges for this value are from 1 to 255
Description This command configures the robustness that allows tuning of the interface. The
robustness is the tuning for the expected packet loss on a subnet. If a subnet is expected
to have a lot of loss, the Robustness variable may be increased for the interface.
Defaults Robustness: 2
Example
9-10
BAR Administration Guide
Summary Set the number of queries the interface will send at startup.
Defaults Count: 2
Example
User-Entered <interval>
Parameters The amount of time, in seconds, that the interface will wait before sending a new
general query. Acceptable range for this value is from 1 to 300.
Description This command sets the interval (in seconds) between General Queries sent by a Querier
on startup on the currently configured interface.
Example
9-11
BAR Administration Guide
Description This command configures the version of IGMP to be supported for this interface.
Defaults Version: 2
Example
User-Entered <groupipaddr>
Parameters A group IP address in dotted decimal notation.
<mask>
A group IP mask in dotted decimal notation.
Defaults None
Example
9-12
BAR Administration Guide
Summary Set the Time To Live (TTL) threshold value for the interface.
Defaults TTLvalue: 1
Example
User-Entered <slot/port>
Parameters The combination of a BAR slot and a port in that location that identifies a unique
interface.
Description This command sets the administrative mode of PIM-DM on the currently configured
interface to enabled.
Example
9-13
BAR Administration Guide
Description This command sets the transmission frequency of hello messages between PIM enabled
neighbors for the currently configured interface.
Defaults DMQ-interval: 30
Example
Summary Set Candidate Bootstrap Router (CBSR) preference for a PIM-SM interface.
User-Entered <preference>
Parameters This parameter is the numerical value representing the CBSR preference value for the
interface. The range of this parameter is from -1 to 255.
Description This command configures the CBSR preference for a particular PIM-SM interface. This
preference value is used in the bootstrap router election process.
Defaults Preference: 0
Example
9-14
BAR Administration Guide
ip pimsm mode
Example
User-Entered <smq-interval>
Parameters The length, in seconds, of the query interval for the interface. The acceptable range of
this value is from 10 to 3600 seconds.
Description This command sets the transmission frequency of hello messages between PIM enabled
neighbors for the currently configured interface.
Defaults SMQ-interval: 30
Example
9-15
BAR Administration Guide
Multicast Query and The following commands are used to initiate various multicast query and trace
Trace Commands commands.
User-Entered None
Parameters
Description This command is used to disable the processing capability of mtrace query on the BAR.
If the mode is enabled, the BAR process mtrace queries that it receives and forwards
them appropriately. If the mode is disabled, the BAR does not respond to the mtrace
queries it receives from other router devices.
Defaults None
Example
mrinfo <ipaddr>
User-Entered <ipaddr>
Parameters The IP address of the system to query. If no IP address is specified, the default of the
current BAR is used.
Description This command is used to query the neighbor information of a multicast-capable router
specified by <ipaddr>. The default value is the IP address of the system at which the
command is issued. The mrinfo command can take up to 2 minutes to complete. Only
one mrinfo command may be in process at a time. The results of this command will be
available in the results bufferpool which can be displayed by using show mrinfo.
9-16
BAR Administration Guide
Example
(BAR) (Config)#mrinfo
Summary Finds the IP Multicast packet race and loss information from a multicast source to a
receiver.
User-Entered None
Parameters
Description This command is used to find the IP Multicast packet rate and loss information path
from a source to a receiver (unicast router id of the host running mstat). The results of
this command will be available in the results bufferpool which can be displayed by using
the command “show mstat”. If a debug command is already in progress, a message is
displayed and the new request fails.
The <source> is the IP address of the remote multicast-capable source. The [receiver]
is the IP address of the receiver. The default value is the IP address of the system at
which the command is issued. The [group] is a multicast address of the group to be
displayed. The default value is 224.2.0.1(the group used for the multicast backbone).
Note that the group and receiver IP addresses can be entered in any order.
Defaults None
Example
User-Entered None
Parameters
9-17
BAR Administration Guide
Description This command is used to find the IP Multicast path from a source to a receiver (unicast
router ID of the host running mtrace). A trace query is passed hop-by-hop along the
reverse path from the receiver to the source, collecting hop addresses, packet counts,
and routing error conditions along the path, and then the response is returned to the
9.3 requestor. The results of this command are available in the results buffer pool which
can be displayed by using the command “show mtrace”.
The <source> is the IP address of the remote multicast-capable source. The
Multicast
[destination] is the IP address of the receiver system. The default value is the IP address
Display
of system at which the command is issued.
Commands
The [group] is the multicast address of the group to be displayed. The default value is
224.2.0.1(the group used for the multicast backbone).
If a debug command is already in execution, a message is displayed and the new request
fails.
Defaults None
Example
show ip dvmrp
User-Entered None
Parameters
Defaults None
9-18
BAR Administration Guide
Example
Reachable Routes The number of entries in the routing table with non-infinite metrics.
Protocol State The current state of DVMRP on this interface: Operational or Non-
Operational.
User-Entered <slot/port>
Parameters The combination of a BAR slot and a port in that location that identifies a unique
interface.
Description This command displays the interface information for DVMRP on the specified
interface.
Defaults None
9-19
BAR Administration Guide
Example
The following field is displayed only when DVMRP is operational on the interface.
Generation ID The Generation ID value for the interface. This is used by the neighboring
routers to detect that the DVMRP table should be resent.
The following fields are displayed only if DVMRP is enabled on this interface.
Sent Routes The number of routes that have been sent on this interface.
User-Entered None
Parameters
Defaults None
Nbr IP Addr The IP Address of the DVMRP neighbor for which this entry contains
information.
Expiry Time The time remaining for the neighbor to age out. This field is not
applicable if the State is DOWN.
9-20
BAR Administration Guide
Capabilities
Received Routes
The capabilities of the neighbor.
User-Entered None
Parameters
Description This command displays the next hop information on outgoing interfaces for routing
multicast datagrams.
Defaults None
Example
Next Hop
Source IP Source Mask Interface Type
--------------- --------------- --------- -------
10.10.5.50 255.255.255.0 3/1 BRANCH
Command Output The CLI provides the following information in response to the command:
Source IP The sources for which this entry specifies a next hop on an outgoing
interface.
Source Mask The IP Mask for the sources for which this entry specifies a next hop
on an outgoing interface.
Next Hop Interface The interface in Slot/Port format for the outgoing interface for this
next hop.
9-21
BAR Administration Guide
Defaults None
Source Mask Displays the network Mask for the prune source. It should be all 1s or
both the prune source and prune mask must match.
Expiry Time (secs) The expiry time in seconds. This is the time remaining for this prune to
age out.
User-Entered None
Parameters
Description This command displays the multicast routing information for DVMRP.
Defaults None
Upstream Neighbor The IP Address of the neighbor which is the source for the packets for
a specified multicast address.
Interface The interface used to receive the packets sent by the sources.
Expiry Time (secs) The expiry time in seconds. This is the time remaining for this route to
age out.
Up Time (secs) The time when a specified route was learnt, in seconds.
9-22
BAR Administration Guide
Description This command displays the registered multicast groups on the interface. If “detail” is
specified this command displays the registered multicast groups on the specified <slot/
port> interface in detail.
Defaults None
Example
IP Address..................................... 10.10.5.1
Subnet Mask.................................... 255.255.255.0
Interface Mode................................. Enable
Querier Status................................. Querier
Multicast Group IP............................. 224.224.224.224
Multicast Group IP............................. 228.4.1.200
Command Output If detail is not specified, the following fields are displayed:
Subnet Mask The subnet mask of the interface participating in the multicast group.
Querier Status Indicates whether the interface has IGMP in Querier mode or Non-Querier
mode.
Multicast Group IP Displays the address of the multicast group registered on this interface.
9-23
BAR Administration Guide
Multicast IP Address The IP Address of the registered multicast group on this interface.
9.3
Last Reporter The IP Address of the source of the last membership report received
for the specified multicast group address on this interface.
Up Time The time elapsed since the entry was created for the specified
Multicast multicast group address on this interface.
Display Expiry Time The amount of time remaining to remove this entry before it is
Commands aged out.
Version1 Host Timer The time remaining until the local router will assume that there are no
longer any IGMP version 1 multicast members on the IP subnet
attached to this interface.
show ip igmp
User-Entered None
Parameters
Description This command displays system-wide IGMP information, including the status of IGMP
on each physical or virtual interface.
Defaults None
Example
Command Output The following information is displayed in response to the show ip igmp command:
Protocol State Indicates the current state of IGMP on this interface: Operational or
Non-Operational.
9-24
BAR Administration Guide
Defaults None
Example
Command Output The command output provides the following configuration and statistical information:
IGMP Version Indicates the version of IGMP running on the interface. This value
can be configured to create a router capable of running either IGMP
version 1 or 2.
Query Interval The frequency at which IGMP Host-Query packets are transmitted
on this interface.
Query Max Response The maximum query response time advertised in IGMPv2 queries
Time on this interface.
Robustness The tuning for the expected packet loss on a subnet. If a subnet is
expected to be have a lot of loss, the Robustness variable may be
increased for that interface.
Startup Query Interval The interval between General Queries sent by a Querier on startup.
Startup Query Count The number of Queries sent out on startup, separated by the
Startup Query Interval.
Last Member Query The Maximum Response Time inserted into Group-Specific Queries
Interval sent in response to Leave Group messages.
Last Member Query The number of Group-Specific Queries sent before the router
Count assumes that there are no local members.
9-25
BAR Administration Guide
Description This command displays the list of interfaces that have registered in the multicast group
specified by the group address.
Defaults None
Example
Slot/Port The slot and port which identify the interface participating in the multicast
group.
State Indicates whether the interface has IGMP in Querier mode or Non-Querier
mode.
User-Entered <slot/port>
Parameters The combination of a BAR slot and a port, or a virtual slot and port combination, that
identifies a unique interface.
Description This command displays the IGMP statistical information for the physical or virtual
interface specified by <slot/port>. The statistics are only displayed when the interface
is enabled for IGMP.
Defaults None
9-26
BAR Administration Guide
Example
Querier Up Time The time since the interface Querier was last changed.
Querier Expiry Time The amount of time remaining before the Other Querier
Present Timer expires. If the local system is the querier,
the value of this object is zero.
Wrong Version Queries The number of queries received whose IGMP version
does not match the IGMP version of the interface.
show ip mcast
User-Entered None
Parameters
Description This command displays system-wide multicast information for the BAR.
Defaults None
Example
9-27
BAR Administration Guide
Command Output The show ip mcast command provides the following information as output:
9.3
Protocol State The current state of the multicast protocol: Operational
or Non-Operational.
Table Max Size The maximum number of entries allowed in the multicast
Multicast table.
Display Number Of Packets For Which The number of packets for which the source is not found.
Commands Source Not Found
Number Of Packets For Which The number of packets for which the group is not found.
Group Not Found
Highest Entry Count The highest entry count in the multicast table.
User-Entered <slot/port>
Parameters The combination of a BAR slot and a port, or a virtual slot and port combination, that
identifies a unique interface.
all
This parameter instructs the CLI to return multicast boundary information for all
interfaces.
Description This command displays the configured administrative scoped multicast boundaries for a
given physical or logical interface, or for all interfaces.
Defaults None
9-28
BAR Administration Guide
User-Entered <slot/port>
Parameters The combination of a BAR slot and a port, or a virtual slot and port combination, that
identifies a unique interface.
9.3
Description This command displays the multicast information for the physical or logical interface
specified by <slot/port>.
Command Output The following information is presented in the multicast information table:
User-Entered detail
Parameters The detail parameter causes the CLI to present detailed information about the contents
of the BAR multicast table, including some operational statistics.
summary
This parameter instructs the CLI to present an abbreviated version of the multicast
table information in response to the command.
Description This command displays information about the multicast table in summary mode or
detail mode.
Defaults None
9-29
BAR Administration Guide
Example
Command Output If the “detail” parameter is specified, the following fields are displayed:
Up Time The time elapsed since the entry was created in seconds.
Protocol The multicast routing protocol by which this entry was created.
Incoming Interface The interface on which the packet for this source/group arrives.
Outgoing Interface List The list of outgoing interfaces on which this packet is forwarded.
User-Entered <groupipaddr>
Parameters The group address of a multicast group in the mroute table to be examined.
9-30
BAR Administration Guide
detail
The detail parameter causes the CLI to present detailed information about the contents
of the BAR mroute table, including some operational statistics.
9.3
summary
This parameter instructs the CLI to present an abbreviated version of the mroute table
information in response to the command.
Multicast
Description This command displays the multicast configuration settings such as flags, timer settings,
Display
incoming and outgoing interfaces, RPF neighboring routers, and expiration times of all
the entries in the multicast mroute table containing the given <groupipaddr>. Commands
Defaults None
Example
Command Output If the summary parameter is selected, the following fields are displayed:
Protocol The multicast routing protocol by which this entry was created.
Incoming Interface The interface on which the packet for this group arrives.
Outgoing Interface List The list of outgoing interfaces on which this packet is forwarded.
If the detail parameter is selected, the Source IP and Group IP appear (as described
above) are displayed, as well as the following fields:
Up Time (secs) The time elapsed since the entry was created in seconds.
9-31
BAR Administration Guide
Description This command displays the multicast configuration settings such as flags, timer settings,
incoming and outgoing interfaces, RPF neighboring routers, and expiration times of all
the entries in the multicast mroute table containing the given <sourceipaddr> or
<sourceipaddr> [<groupipaddr>] pair.
Defaults None
Example
9-32
BAR Administration Guide
Command Output If the summary parameter is selected, the following fields are displayed:
9.3
Group IP The IP address of the destination of the multicast packet.
Protocol The multicast routing protocol by which this entry was created.
Incoming Interface The interface on which the packet for this group arrives.
Multicast
Outgoing Interface List The list of outgoing interfaces on which this packet is forwarded. Display
Commands
If the detail parameter is selected, the Source IP and Group IP appear (as described
above) are displayed, as well as the following fields:
Up Time (secs) The time elapsed since the entry was created in seconds.
User-Entered <sourceipaddr>
Parameters The IP address, in dotted decimal notation, of a source station to show static route
information for.
Description This command displays all the static routes configured in the static mcast table if no IP
address is specified or displays the static route associated with the particular source
station IP address.
Defaults None
Source Mask The mask applied to the IP address of the multicast packet source.
RPF Address The IP address to be used for Reverse Path Forwarding for the given
source and mask.
Slot/Port The incoming interface number whose IP address is used as RPF for the
given source and mask.
9-33
BAR Administration Guide
show ip pimdm
Defaults None
Example
Command Output The show ip pimdm command presents the following information:
Slot/Port Indicates the slot and port of the interface on which PIM-DM
operation is active.
User-Entered <slot/port>
Parameters The combination of a BAR slot and a port, or a virtual slot and port combination, that
identifies a unique interface.
Description This command displays the interface information for PIM-DM on the specified
interface.
Defaults None
9-34
BAR Administration Guide
Example
PIM-DM Interface Hello Interval Indicates the frequency at which PIM hello messages are
transmitted on this interface.
User-Entered <slot/port>
Parameters The combination of a BAR slot and a port, or a virtual slot and port combination, that
identifies a unique interface.
all
This parameter instructs the CLI to return statistics for all interfaces.
Description This command displays statistical information for PIM-DM on the physical or logical
interface specified by <slot/port>.
Defaults None
Example
Hello Designated
Interface IP Address Nbr Count Interval Router
---------- --------------- --------- ---------- ---------------
3/1 10.10.5.1 0 30 10.10.5.1
3/3 50.50.50.1 0 30 50.50.50.1
Command Output The following fields are presented on the interface information table:
Hello Interval The time interval between two hello messages sent from the router on
the given interface.
Designated Router The IP Address of the Designated Router for this interface.
9-35
BAR Administration Guide
Description This command displays the neighbor information for PIM-DM on the physical or
logical interface specified by <slot/port>, or on all interfaces.
Example
Command Output The CLI provides the following information in response to the command:
Up Time The time since this neighbor has become active on this interface.
show ip pimsm
User-Entered None
Parameters
Defaults None
9-36
BAR Administration Guide
Example
Join/Prune Interval (secs) Displays the interval at which periodic PIM-SM Join/Prune
messages are to be sent.
Data Threshold Rate (Kbps) Displays the data threshold rate for the PIM-SM router.
Register Threshold Rate (Kbps) Displays the threshold rate for the RP router to switch to
the shortest path.
Protocol State Indicates the current state of the PIM-SM protocol on the
interface: Operational or Non-Operational.
User-Entered None
Parameters
Description This command displays the IP multicast groups for which the local router is to advertise
itself as a Candidate-Rendezvous Point when the value of hold time is non-zero.
Defaults None
Command Output The command provides the following information from the Candidate-RP table:
9-37
BAR Administration Guide
Summary Show the component table for the BAR’s PIM domains.
Defaults None
Command Output The following information is presented for each entry in the table:
Component BSR Address Displays the IP address of the bootstrap router (BSR) for the
local PIM region.
Component BSR Expiry Time The minimum time remaining before the BSR in the local
domain will be declared down.
Component CRP Hold Time The hold time of the component when it is a candidate.
User-Entered <slot/port>
Parameters The combination of a BAR slot and a port, or a virtual slot and port combination, that
identifies a unique interface.
Description This command displays the interface information for PIM-SM on the physical or logical
interface specified by <slot/port>.
Defaults None
Subnet Mask The Subnet Mask for the IP address of the PIM interface.
Interface Mode Indicates whether PIM-SM is enabled or disabled on the specified interface.
Hello Interval Indicates the frequency at which PIM-SM hello messages are transmitted
on this interface.
CBSR Preference Shows the preference value for the local interface as a candidate bootstrap
router.
9-38
BAR Administration Guide
Description This command displays the statistical information for PIM-SM on the physical or
logical interface specified or for all interfaces.
Defaults None
Command Output The following fields are shown in response to the command:
Designated Router The IP Address of the Designated Router for this interface.
User-Entered <slot/port>
Parameters The combination of a BAR slot and a port, or a virtual slot and port combination, that
identifies a unique interface.
all
This parameter instructs the CLI to return statistics for all interfaces.
Description This command displays the neighbor information for PIM-SM on the physical or
logical interface specified by <slot/port>, or for all interfaces. If the optional
parameters are not included in the command, information about all interfaces is
displayed.
9-39
BAR Administration Guide
Command Output The CLI provides the following information in response to the command:
9.3
IP Address The IP Address of the neighbor on an interface.
Up Time The time since this neighbor has become active on this interface.
User-Entered <groupaddress>
Parameters The address of the multicast group to show RP information for.
<groupmask>
The mask that identifies the group portion of the <groupaddress> parameter.
candidate
Supply this parameter to restrict the displayed information to RP candidate
information.
all
Supply this parameter to show data for all group RPs.
Description This command displays the PIM information for candidate Rendezvous Points (RPs)
for all IP multicast groups or for the specific <groupaddress> <groupmask> provided
in the command. The information in the table is displayed for each IP multicast group.
Defaults None
Expiry Time The minimum time remaining before the Candidate-RP will be declared down.
Component The number which uniquely identifies the component. Each protocol instance
connected to a separate domain should have a different index value.
9-40
BAR Administration Guide
Summary Show the static Rendezvous Point information for one group.
Defaults None
Command Output: The command output provides the IP address of the RP and the group mask for the
RP’s group address.
User-Entered None
Parameters
Description This command displays the static RP information for the PIM-SM router.
Defaults None
9-41
BAR Administration Guide
show mrinfo
Defaults None
Example
show mstat
Summary Displays the results of an mstat command, reflecting packet rate and loss information.
User-Entered None
Parameters
9-42
BAR Administration Guide
Description This command is used to display the results of packet rate and loss information from
the results buffer pool of the router, subsequent to the execution/completion of a mstat
<source> [group] [receiver] command. Within two minutes of the completion of the
mstat command, the results will be available in the buffer pool. The next issuing of
“no” Form
mstat overwrites the buffer pool with fresh results.
None
9.3
Multicast
Defaults None Display
Commands
Example
show mtrace
User-Entered None
Parameters
Description This command is used to display results of multicast trace path from the results buffer
pool of the router, subsequent to the execution/completion of a mtrace <source>
[group] [receiver] command. The results subsequent to the completion of the mtrace
will be available in the buffer pool within two minutes and thereafter. A subsequent
mtrace command overwrites the results in the buffer pool.
Defaults None
9-43
BAR Administration Guide
Example
Hops Away From Destination The ordering of intermediate routers between the
source and the destination
Intermediate Router Address The address of the intermediate router at the specified
hop distance.
Mcast Protocol In Use The multicast routing protocol used for the out interface
of the specified intermediate router.
Time Elapsed Between Hops The time between arrival at one intermediate router to
(msecs) the arrival at the next.
9-44
Chapter 10
DHCP Server Commands
This chapter describes the CLI commands that control Dynamic Host Configuration
Protocol (DHCP) server operation on the BAR.
Topic on page
service dhcp
User-Entered None
Parameters
Description This command enables the DHCP server features on the BAR.
Example
[highaddress]
The optional [highaddress] parameter identifies the upper end of the excluded IP
address range. This value is expressed in dotted decimal notation.
Description This command specifies the IP addresses that a DHCP server should not assign to
DHCP clients.
Defaults None
Example
User-Entered <packet-count>
Parameters The number of packets that a DHCP server sends in its PING verification that an
address in the DHCP pool is not in use. This number may be any number from 2 to 10,
or may be set to 0 (zero) to block server PINGs of pool address.
Description This command is used to specify the number of packets a DHCP server sends to a pool
address to verify that the address is not already in use on the network.
Defaults Packet-count: 2
10-2
BAR Administration Guide
Example
User-Entered <name>
Parameters The alphanumeric name of the DHCP pool to be created on the DHCP server.
Description This command configures a DHCP address pool, identified by <name>, on a DHCP
server and enters DHCP pool configuration mode.
Defaults None
Example
client-identifier <uniqueidentifier>
User-Entered <uniqueidentifier>
Parameters The unique-identifier is a valid notation in hexadecimal format, and must be a minimum
of two bytes long.
Description This command specifies the unique identifier for a DHCP client. Although a client
generally uses its MAC address as its identifier when issuing DHCP requests, some
DHCP clients can have a manually configured client identifier.
Defaults None
10-3
BAR Administration Guide
Example
10.3 Related Commands show ip dhcp pool configuration {<name> | *} on page 10-9
User-Entered <name>
Parameters The name is a brief string consisting of standard ASCII characters used to identify the
client for reference purposes.
Defaults None
Example
User-Entered <address(N)>
Parameters The <address> parameter is the IP address, in dotted decimal notation, of a default
router. Up to eight addresses can be supplied to the command, which will be used as
default routers in the preference order supplied.
Description This command specifies the default router list for a DHCP client.
Defaults None
Example
10-4
BAR Administration Guide
Description This command specifies the Domain Name System (DNS) server for a DHCP client.
At least one DNS server must be set.
Defaults None
Example
User-Entered <hardwareaddress>
Parameters The MAC address of the hardware platform of the client consisting of 6 bytes in
hexadecimal format, each separated by colons.
[type]
The optional type parameter indicates the protocol of the hardware platform. Select 1
to specify traditional Ethernet framing (Ethernet II) or 6 for IEEE 802.n framing (for
Token Ring/Token Bus, for example).
Defaults Type: 1
Example
10-5
BAR Administration Guide
[<mask>]
The network mask, in dotted decimal notation, identifying the network portion of the
supplied IP address.
[<prefix-length>]
The network mask, specified as a whole number representing the number of bits that
make up the prefix (for example, 24), where prefix-length is an integer from 0 to 32.
Description This command specifies the IP address and an optional network mask for a manual
binding to a DHCP client.
Defaults None
Example
User-Entered <days>
Parameters The number of 24-hour days that a leased IP address may be held by a DHCP client.
This parameter may be from 0 to 59.
NOTE: Configuring a lease duration beyond the maximum allowable lease (86,400
minutes) will result in an error message.
[hours]
The number of hours, in addition to the number of <days> specified, that an assigned
IP address may be retained. The value of this optional parameter may be from 0 to
1,339.
[minutes]
The duration, in minutes, that DHCP leases may be held. This value may be from 0 to
86399.
10-6
BAR Administration Guide
[infinite]
Supplying this parameter in place of values for <days>, [hours], and [minutes] will set
the lease duration for DHCP assigned IP addresses to be infinite until released by the
client.
Description This command configures the duration of the lease for an IP address that is assigned
from a DHCP server to a DHCP client.
10.3
DHCP Pool
“no” Form no lease Configuration
The “no” form of this command resets the lease time to its default value of one day.
Defaults Days: 1
Example
User-Entered <networknumber>
Parameters A valid IP address, in dotted decimal notation, identifying a member of the subnet to be
configured.
[<mask>]
The network mask, in dotted decimal notation, identifying the network portion of the
supplied IP address.
[<prefix-length>]
The network mask, specified as a whole number representing the number of bits that
make up the prefix (for example, 24), where prefix-length is an integer from 0 to 32.
Description This command configures a subnet number and mask for a DHCP address pool on the
server.
Defaults None
Example
10-7
BAR Administration Guide
Description This command displays MAC address to IP bindings for a specified IP <address> on
the DHCP server. If no IP address is specified, the bindings corresponding to all the
addresses are displayed.
Defaults None
Example
Hardware Address The MAC address or client identifier of the leasing client.
Lease Expiration The time remaining on the address lease, in HH:MM:SS format.
Type The manner in which the IP address was assigned to the client
(automatic or static).
User-Entered None
Parameters
10-8
BAR Administration Guide
Description This command displays system-wide configuration for the DHCP server running on
the BAR.
Defaults
Example
None
10.4
DHCP Server
(Pannaway BAR) #show ip dhcp global configuration Display
Service DHCP................................... Enable Commands
Number of Ping Packets......................... 2
Excluded Address............................... 111.222.100.1 to 111.222.100.16
Service DHCP Displays the administrative status of the DHCP server service on
the BAR: Enable or Disable.
Number of Ping Packets The maximum number of PINGs that will be sent to verify that an
IP address is not already assigned.
Excluded Address The ranges of IP addresses that the DHCP server service should
not assign to DHCP clients.
User-Entered {<name>}
Parameters If a DHCP pool name is supplied, the CLI presents the configuration information for
that pool.
{*}
The use of the wildcard (asterisk) character in the show dhcp pool configuration
command causes the CLI to provide information on all DHCP pools.
Description This command displays configuration information for a DHCP address pool or for all
address pools configured on the system if * is specified.
Defaults None
10-9
BAR Administration Guide
Example
10.4 Network........................................
Lease Time.....................................
DNS Servers....................................
111.222.100.0 255.255.255.128
1 days 0 hrs 0 mins
172.16.1.5
DHCP Server
Pool: test
Display
Pool Type...................................... Manual
Commands Hardware Address............................... 00:00:1d:ab:cd:ef
Hardware Address Type.......................... ethernet
Host........................................... 172.16.99.99 255.255.255.0
Lease Time..................................... 1 days 0 hrs 0 mins
Command Output The following information is shown for every type of DHCP pool:
Pool Type The address pool type: Dynamically leased (Dynamic) or statically
configured (Manual).
Lease Time The lease expiration time of the IP Address assigned to the client.
DNS Servers The list of DNS servers available to the DHCP client.
The following additional field is displayed for a Dynamic DHCP address pool:
Network The network number and the mask for the DHCP address pool.
The following additional fields are displayed for a Manual DHCP address pool:
Host The IP address and the mask for a manual binding to a DHCP
client.
10-10
BAR Administration Guide
Defaults None
Example
Messages Received
---------- ----------
DHCP DISCOVER.................................. 13
DHCP REQUEST................................... 13
DHCP DECLINE................................... 0
DHCP RELEASE................................... 0
DHCP INFORM.................................... 2
Messages Sent
---------- ------
DHCP OFFER..................................... 0
DHCP ACK....................................... 0
DHCP NACK...................................... 0
Command Output The CLI command provides a display of the following statistics:
Automatic Bindings The number of IP addresses that have been automatically mapped
to the MAC addresses of hosts that are found in the DHCP
database.
Malformed Bindings The number of truncated or corrupted messages that were received
by the DHCP server.
10-11
BAR Administration Guide
DHCP DISCOVER The number of DHCP DISCOVER messages that were received by
the server.
10.5 DHCP REQUEST The number of DHCP REQUEST messages that were received by the
server.
DHCP Server DHCP DECLINE The number of DHCP DECLINE messages that were received by the
server.
Clear
Commands DHCP RELEASE The number of DHCP RELEASE messages that were received by the
server.
DHCP INFORM The number of DHCP INFORM messages that were received by the
server.
DHCP OFFER The number of DHCP OFFER messages that were sent by the server.
DHCP ACK The number of DHCP ACK (acknowledged) messages that were sent by
the server.
DHCP NACK The number of DHCP NACK (not acknowledged) messages that were sent
by the server.
User-Entered <address>
Parameters This parameter specifies a single IP address, in dotted decimal notation, that the
command will delete the bindings for.
<*>
If the wildcard (asterisk) parameter is specified, the bindings for all IP addresses on the
DHCP server are cleared.
Description This command deletes an automatic address binding from the DHCP server database.
Defaults None
Example
10-12
BAR Administration Guide
Defaults None
Example
10-13
BAR Administration Guide
10.5
DHCP Server
Clear
Commands
10-14
Chapter 11
Session Control
This chapter describes the commands that control the function of the BAR serial
interface (console port) and the operation of Telnet and terminal sessions to and from
the BAR.
Topic on page
User-Entered <sessions>
Parameters A number, from 0 to 5, of the maximum number of remote sessions that can be
simultaneously active on the BAR.
CAUTION: If the maximum number of sessions is set to 0 (zero), CLI management
of the BAR can only be performed through a local console connection.
Description This command specifies the maximum number of remote connection sessions that can
be established.
Defaults Sessions: 5
BAR Administration Guide
Example
User-Entered <timeout>
Parameters The maximum time (in minutes) that an inactive remote Telnet session can remain
connected. The range for this parameter is 0 to 160, with a value of 0 indicating an
infinite maximum time.
Description This command sets the remote connection session timeout value, in minutes. Once a
remote Telnet session passes the timeout value, it is deactivated and disconnected.
Defaults Timeout: 5
Example
User-Entered {baud}
Parameters This value identifies the baud rate of the serial connection. The following bit per second
(bps) values may be set for the serial interface’s operation: 1200, 2400, 4800, 9600,
19200, 38400, 57600, 115200.
Description This command sets the serial baud rate for the BAR management interface.
11-2
BAR Administration Guide
Example
11.2
(Pannaway BAR) (Line) #serial baudrate 57600
User-Entered <timeout>
Parameters The maximum time (in minutes) that an inactive console session can remain connected.
The range for this parameter is 0 to 160, with a value of 0 indicating an infinite
maximum time.
Description This command specifies the maximum duration that a local console connection can
remain idle (not sending commands or keystrokes) before it is automatically
disconnected.
Defaults Timeout: 5
Example
session-limit <0-5>
User-Entered <0-5>
Parameters The maximum number of outbound telnet sessions, from 0-5.
Description This command sets the maximum number of outbound telnet sessions. A value of 0
indicates that no outbound telnet sessions are allowed.
11-3
BAR Administration Guide
Example
User-Entered <0-160>
Parameters The number of minutes an outbound telnet session can be inactive before timing out.
Description This command sets the duration (in minutes) for which an outbound telnet session can
be inactive before timing out and exiting the session. A value of 0 indicates the session
can be indefinite (not timed out).
Example
Description This command changes the text string that is presented as the command line prompt.
11-4
BAR Administration Guide
Example
User-Entered None
Parameters
Description This command activates pagination of output (via the “More” prompt).
Example
Summary Activate Telnet session support in the inbound and outbound directions.
Description This command enables or disables the establishment of Telnet sessions to or from the
BAR. If inbound sessions are enabled, new Telnet sessions can be established until
there are no more sessions available.
Example
11-5
BAR Administration Guide
Description This command opens a Telnet session between a BAR and a remote host. Telnet is
considered insecure communication, because all information is passed across the wire
in plain text (including authentication information).
Example
Connected to 192.168.199.199.
(BAS-BX)
Username: Admin
Password:
User-Entered <sessionID>
Parameters The session ID number of an active Telnet session on the BAR.
all
Supply this parameter to close all active Telnet sessions.
Description This command closes a specified Telnet session, or all active Telnet sessions.
Defaults None
Example
11-6
BAR Administration Guide
Description This command adds a new user account name, if space permits. Up to six user names
can be defined.
Defaults Two user names are provided by default: admin and guest.
Example
Related Commands users snmpv3 accessmode <username> {readonly | readwrite} on page 13-10
users snmpv3 authentication <username> {none | md5 | sha} on page 13-11
users snmpv3 encryption <username> {none | des [key]} on page 13-11
User-Entered <username>
Parameters The name of an existing user account on the BAR.
Description This command changes the password of the existing user account.
After the <username> parameter is entered, a prompt appears that asks for the user’s
existing password. If no password was previously set, press ENTER.
The system then prompts you to enter a new password, and then provides a
confirmation prompt. If the new password and confirmation entries match, a message
is displayed that indicates the operation was successful.
A user password should not be more than eight characters in length. If a user is
authorized for authentication or encryption is enabled, the password must be the full
eight characters. The username and password are not case-sensitive.
11-7
BAR Administration Guide
Defaults None
Example
11.2
(Pannaway BAR) (Config)#users passwd FIELD
network javamode
User-Entered None
Parameters
Description This command specifies that the BAR should allow access to the Java applet in the
header frame of the Web interface. When access is enabled, the Java applet can be
viewed from the Web interface.
Example
User-Entered yes]
Parameters Entering the “Yes” flag at the causes the CLI to parse the command without prompting
you to confirm your action.
Description This command resets all user passwords to the factory defaults without powering off
the switch. You are prompted to confirm that the password reset should proceed.
11-8
BAR Administration Guide
Defaults None
11.3
Example
Are you sure you want to reset all passwords? (y/n)y Session
Monitoring and
Passwords Reset! Display
Commands
Related Commands users passwd <username> on page 11-7
show remotecon
User-Entered None
Parameters
Defaults None
Example
Command Output: The following commands are shown in response to the show remotecon command:
Remote Connection Login Timeout Indicates the number of minutes (0-160) a remote
(minutes) connection session is allowed to remain inactive before
being logged off. A zero means there will be no timeout.
Allow New Telnet Sessions Indicates whether remote connection sessions are allowed
(Yes) or disallowed (No) when an existing session is in
progress.
11-9
BAR Administration Guide
show serial
Defaults None
Example
Serial Port Login Timeout Indicates the time, in minutes, of inactivity on a Serial port
(minutes) connection before the connection is closed.
Baud Rate (bps) The default baud rate at which the serial port will try to connect.
Character Size (bits) The number of bits in a character. The number of bits is always 8.
Stop Bits The number of Stop bits per character; this is always set to 1.
Parity The Parity Method used on the Serial Port (always set to None).
show loginsession
User-Entered None
Parameters
Description This command displays current Telnet and serial port connections to the switch.
Defaults None
11-10
BAR Administration Guide
Example
Connection From IP address of the Telnet client machine or EIA-232 for the serial
port connection.
show users
User-Entered None
Parameters
Description This command displays the configured user names and their settings. This command is
only available for users with read/write privileges. The SNMPv3 fields will only be
displayed if SNMP is available on the system.
Defaults None
Example
11-11
BAR Administration Guide
Command Output: The following information is shown for each user account:
User Name The name used to login via the serial port, Telnet or Web.
11.3
User Access Mode Indicates the operator’s access level: Read/Write (able to change
parameters on the switch) or Read Only (only able to view switch
parameters).
Session SNMPv3 Access Mode Displays the SNMPv3 Access Mode. If the value is Read/Write, the
SNMPv3 user can set and retrieve parameters on the system. If the
Monitoring and value is set to Read Only, the SNMPv3 user can only retrieve
Display parameter information. The SNMPv3 access mode may be different
Commands than the CLI and Web access mode.
SNMPv3 Authentication Displays the authentication protocol assigned to the specified login
user.
SNMPv3 Encryption Displays the encryption protocol assigned to the specified login user.
11-12
Chapter 12
HTTP and SSH Configuration
This chapter provides configuration information for Secure Shell and Secure Hyper
Text Transfer Protocol operation on the BAR.
Topic on page
User-Entered <portid>
Parameters The port ID number that will be used as the Secure HTTP port. Valid values for this
parameter are from 1 to 65,535.
Example
Secure HTTP Summary Set the version(s) of Secure HTTP supported on the BAR.
Commands
Required Mode Privileged Exec
User-Entered [SSL3]
Parameters Enter this parameter to configure the BAR for Secure Socket Layer 3 (SSL3) protocol
support.
[TLS1]
Enter this parameter to set up the BAR to support the Transport Layer Security
protocol.
Description This command is used to set protocol levels (versions). The protocol level can be set to
TLS1, SSL3 or to both TLS1 and SSL3.
Example
ip http secure-server
User-Entered None
Parameters
Description This command is used to enable the secure socket layer for secure HTTP.
Example
12-2
BAR Administration Guide
User-Entered None
Parameters
Description This command enables access to the switch through the Web interface. When access is
enabled, the user can log in to the switch from the Web interface.
Example
show ip http
User-Entered None
Parameters
Description This command displays the HTTP settings for the switch.
Defaults None
12-3
BAR Administration Guide
Example
HTTP Mode (Unsecure) Indicates whether the HTTP mode is enabled or disabled.
Secure Protocol Level Indicates the secure HTTP protocol level: SSL3, TLS1, or
both SSL3 and TLS1.
ip ssh
User-Entered None
Parameters
Description This command is used to enable SSH (Secure Shell protocol for remote
communications).
Example
12-4
BAR Administration Guide
Description This command is used to set or remove protocol levels (or versions) for SSH. Either
SSH1, SSH2, or both SSH1 and SSH2 can be set.
Example
show ip ssh
User-Entered None
Parameters
Defaults None
Example
12-5
BAR Administration Guide
12.3 Protocol Level Indicates the SSH protocol level: version 1, version 2 or both
versions 1 and version 2.
12-6
Chapter 13
SNMP Commands
Topic on page
User-Entered <name>
Parameters The community name of the new SNMP community. This value may be up to 16 case-
sensitive alphanumeric characters.
Description This command adds (and names) up to six new SNMP communities. A community
name is a name associated with the switch and with a set of SNMP managers that
manage it with a specified privileged level. The case-sensitive name can be up to 16
characters long.
NOTE: Community names in the SNMP community table must be unique. If you
make multiple entries using the same community name, the first entry is kept and
processed and all duplicate entries are ignored.
BAR Administration Guide
13.2 Defaults
Example
Two community names are configured by default: public and private.
User-Entered <ipaddr>
Parameters The client IP address for the SNMP community.
<name>
The name of an existing SNMP community.
Description This command sets a client IP address for an SNMP community. The address is the
associated community SNMP packet sending address and is used along with the client
IP mask value to denote a range of IP addresses from which SNMP clients may use that
community to access the device. A value of 0.0.0.0 allows access from any IP address.
Otherwise, this value is ANDed with the snmp-server community mask to determine
the range of allowed client IP addresses. The name is the applicable community name.
Example
13-2
BAR Administration Guide
Description This command sets a client IP mask for an SNMP community. The address is the
associated community SNMP packet sending address and is used along with the client
IP address value to denote a range of IP addresses from which SNMP clients may use
that community to access the device. A value of 255.255.255.255 will restrict access to
only the station specified in the snmp-server community ipaddr command. A value of
0.0.0.0 will allow access from any IP address. Masks between these extremes provide
access to stations in various subnets of the specified IP address. The name is the
applicable community name.
Example
User-Entered <name>
Parameters The name of an existing, but inactive SNMP community.
13-3
BAR Administration Guide
13.2 Defaults
until the Status is changed back to Enable.
The default private and public communities are enabled by default. The four undefined
SNMP communities are disabled by default.
Configuration
Commands Example
User-Entered <name>
Parameters
The name of an existing SNMP community.
Description This command restricts SNMP sessions from the named community to viewing
configuration settings only. The access mode is read-only (also called public).
Defaults None
Example
13-4
BAR Administration Guide
Defaults None
Example
User-Entered None
Parameters
Defaults None
Example
13-5
BAR Administration Guide
Example
User-Entered None
Parameters
Description This command enables Link Up/Down traps for the entire switch. When enabled, link
traps are sent only if the Link Trap flag setting associated with the port is enabled (see
‘snmp trap link-status’ command).
Example
13-6
BAR Administration Guide
Example
User-Entered None
Parameters
Description This command enables the sending of new root traps and topology change notification
traps.
Example
13-7
BAR Administration Guide
Description This command adds an SNMP trap destination community, identified by the
combination of a community name and IP address.
Defaults None
Example
User-Entered <name>
Parameters The name of an existing SNMP community.
<ipaddrold>
The IP address, in dotted decimal notation, of the previous SNMP trap station.
<ipaddrnew>
The new IP address, in dotted decimal notation, for the SNMP trap station.
Description This command assigns a new IP address to a specified trap receipt station with a
previously associated IP address.
NOTE: IP addresses in the SNMP trap receiver table must be unique. If you make
multiple entries using the same IP address, the first entry is retained and
processed. All duplicate entries are ignored.
Defaults None
13-8
BAR Administration Guide
Example
User-Entered <name>
Parameters The name of an existing SNMP community.
<ipaddr>
An IP address, in dotted decimal notation, of the SNMP trap destination.
Description This command enables the sending of SNMP trap to a designated community of
receivers. Enabled trap receivers are active (able to receive traps).
Defaults None
Example
User-Entered None
Parameters
Description This command enables Link Up/Down traps for the selected interface.
13-9
BAR Administration Guide
Example
SNMP
Configuration snmp trap link-status all
Commands
Summary Enable the generation of link status traps.
User-Entered None
Parameters
Description This command enables Link Up/Down traps for all interfaces on the BAR.
Example
User-Entered <username>
Parameters A login name on the BAR.
{readonly | readwrite}
The control setting for the SNMPv3 user: Read Only (can view information) or Read-
Write (can view information and change settings).
Description This command specifies the snmpv3 access privileges for the specified login user.
Defaults Control setting: readwrite for admin user; readonly for all other users
13-10
BAR Administration Guide
Example
User-Entered <username>
Parameters A login name on the BAR.
Description This command specifies the authentication protocol to be used for the specified login
user. The valid authentication protocols are none, md5 or sha. If md5 or sha are
specified, the user login password will be used as the snmpv3 authentication password.
NOTE: If the user password is shorter than eight characters, you receive an error
message when attempting to change the authentication protocol to md5 or sha, as
shown in the second example below. The password must be exactly eight
characters for these methods.
Defaults No authentication
Example
User-Entered <username>
Parameters A login name on the BAR.
13-11
BAR Administration Guide
13.3 Description This command specifies the encryption protocol and key to be used for the specified
login user. The valid encryption protocols are none or des.
SNMP Display
Commands “no” Form no users snmpv3 encryption <username>
The “no” form of this command sets the encryption protocol to none (the default
setting).
Defaults No encryption
Example
Related Commands
show snmpcommunity
User-Entered None
Parameters
Description This command displays SNMP community information. Up to six SNMP communities
are supported. The SNMP agent of the BAR complies with SNMP Version 1. The
SNMP agent sends traps through TCP/IP to an external SNMP manager based on the
SNMP configuration (the trap receiver and other SNMP community parameters).
Defaults None
Example
13-12
BAR Administration Guide
Command Output: The following information is shown for each configured SNMP community:
SNMP Community Name The community string to which this entry grants access. Each
row of this table contains a unique community name.
Client IP Address An IP address (or portion thereof) from which this device will
accept SNMP packets with the associated community. The
requesting entity’s IP address is ANDed with the Subnet Mask
13.3
before being compared to the IP Address. Note that if the Subnet SNMP Display
Mask is set to 0.0.0.0, an IP Address of 0.0.0.0 matches all IP Commands
addresses.
Access Mode The access level for this community string (“Read Only” or
”Read/Write”).
show snmptrap
User-Entered None
Parameters
Description This command displays SNMP trap receivers. Trap messages are sent across a network
to these trap receivers. These messages alert the manager to events occurring within the
switch or on the network. The BAR simultaneously supports up to six trap receivers.
Defaults None
Example
13-13
BAR Administration Guide
SNMP Trap Name The community string of the SNMP trap packet sent to the trap
manager.
13.3 IP Address The IP address of the trap manager device (SNMP network
management station).
SNMP Display Status Indicates whether trap forwarding to the indicated trap manager is
active (enable) or inactive (disable).
Commands
Related Commands snmptrap <name> <ipaddr> on page 13-8
snmptrap ipaddr <name> <ipaddrold> <ipaddrnew> on page 13-8
snmptrap mode <name> <ipaddr> on page 13-9
show trapflags
User-Entered None
Parameters
Description This command displays which traps are configured to be enabled (sent) or disabled (not
sent). If a trap condition is enabled and the condition is detected, the switch’s SNMP
agent sends the trap to all enabled trap receivers. The switch does not have to be reset
to implement the changes. Cold and warm start traps are always generated and cannot
be disabled.
Defaults None
Example
Command Output: The following information is shown in response to the show trapflags command:
Authentication Flag Indicates whether authentication failure traps will be sent; the
default is enabled.
Link Up/Down Flag Indicates whether link status traps will be sent; the default is
enabled.
Multiple Users Flag Indicates whether a trap will be sent when the same user ID is
logged into the switch more than once at the same time (either via
Telnet or serial port). The default is enabled.
13-14
BAR Administration Guide
Spanning Tree Flag Indicates whether spanning tree traps will be sent; the default is
enabled.
Broadcast Storm Flag Indicates whether broadcast storm traps will be sent; the default is
13.3
enabled.
DVMRP Traps Indicates whether DVMRP traps will be sent; the default is disabled.
OSPF Traps Indicates whether OSPF traps will be sent; the default is disabled.
SNMP Display
PIM Traps Indicates whether PIM traps will be sent; the default is disabled. Commands
13-15
BAR Administration Guide
13.3
SNMP Display
Commands
13-16
Chapter 14
Access Control Lists
This chapter describes the commands used to configure Access Control Lists, or Access
Lists, on the BAR. Access Control Lists allow or deny passage of packets through the
Broadband Aggregation Router based on criteria specified during list creation. The
criteria for an Access Control List can be based on the protocols, source locations,
destinations, groups, or subscriber identifications of the packet or message being
filtered.
NOTE: Access Control Lists are implemented in the inbound direction only. The BAR does
not support Access Control Lists for outbound traffic.
User-Entered <accesslistnumber>
Parameters The number of the Access Control List being created. The acceptable range for normal
Access Control Lists is from 1 - 99.
{deny | permit}
This parameter identifies the type of list being created. If deny is specified, the list will
block access to packets meeting the specified criteria, while allowing all others. If permit
is provided for this parameter, the list will permit access only to packets meeting the
additional criteria, and deny all others.
{every | <srcip> <srcmask>}
The ending parameter provides the criteria for the Access Control List. The parameter
indicates if the Access Control List should filter for every packet, or only those
originating from the network identified by the combination of a Source IP Address
<srcip> and Source Subnet Mask <srcmask> supplied.
Description This command creates a new normal Access Control List on the BAR. This control list
provides a rule for allowing or denying access to the BAR for received traffic.
BAR Administration Guide
14.1 Defaults
Example
None
access-list <accesslistnumber> {deny | permit} {every | icmp | igmp | ip | tcp | udp | <protocolnumber>}
<srcip> <srcmask> [eq {<srcl4portnumber> | <srcportkey>}] <dstip> <dstmask> [eq
{<dstl4portnumber> | <dstportkey>}] [precedence <precedence> | tos <tos> <tosmask> | dscp <dscp>]
User-Entered <accesslistnumber>
Parameters The number of the Access Control List being created. The acceptable range for
extended Access Control Lists is from 100 - 199.
{deny | permit}
This parameter identifies the type of list being created. If deny is specified, the list will
block access to packets meeting the specified criteria, while allowing all others. If permit
is provided for this parameter, the list will permit access only to packets meeting the
additional criteria, and deny all others.
{every | icmp | igmp | ip | tcp | udp | <protocolnumber>}
The selection provided in this parameter indicates the type of protocol that the filter is
examining packets from. If “every” is selected, the ACL will permit or deny every
packet, regardless of origin. If one of the named protocols (ICMP, IGMP, IP, TCP, or
UDP) or the IANA-assigned well-known protocol number (from 0-255) is specified,
the ACL will permit or deny packets from the specified protocol.
<srcip>
The IP address, in Dotted Decimal Notation (DDN), of a source station on the
network the extended ACL applies to.
<srcmask>
The mask, in DDN, that identifies the network portion of the source IP address the
ACL applies to.
{<srcL4portnumber> | <srcportkey>}
The Layer 4 port number (an integer from 0 to 65,535 representing a well-known port
number), or the source port keyword (options are domain, echo, ftp, ftpdata, smtp,
snmp, Telnet, tftp, and www) that will be filtered by the ACL.
<dstip>
The IP address, in DDN, of the destination station that the extended ACL will control
traffic to.
<dstmask>
The subnet mask, in DDN format, that identifies the network portion of the
destination IP address specified for the ACL.
14-2
BAR Administration Guide
{<dstL4portnumber> | <dstportkey>}
The Layer 4 port number (an integer from 0 to 65535 representing a well-known port
number), or the destination port keyword (options are domain, echo, ftp, ftpdata, smtp,
snmp, telnet, tftp, and www) that will be filtered by the ACL.
[precedence <precedence> | tos <tos> <tosmask> | dscp <dscp>]
The Service Type that the ACL will filter traffic for. The <precedence> parameter is an
IP preference value from 1 to 7. The <tos> is a Type of Service in hexadecimal format
14.1
ACL Control
(from 00 to FF), accompanied by the TOS’ mask value (also in hexadecimal format). A Commands
Differentiated Service Control Point can be selected as an option, in which case the
DSCP number, an integer from 0 to 63, must be supplied.
Description This command creates an extended Access Control List on the BAR. The Access
Control List provides a number of criteria for filtering traffic received by the BAR,
which are used to determine if the traffic should be permitted or denied.
Defaults None
Example
User-Entered <accesslistnumber>
Parameters The number of the normal or extended Access Control List being assigned to the
interface. The acceptable range for this parameter is from 1 - 199, and the number
provided must match an existing Access Control List on the BAR.
NOTE: The same Access Control List can be assigned to more than one interface,
but each interface may only have one active ACL at a time. If an ACL is assigned to
a port with an existing ACL, the new assignment is discarded and an error message
is returned.
{in | out}
The selection of what type of traffic the Access Control List applies to; inbound or
outbound.
Description This command attaches the specified Access Control List to the currently selected
interface of the BAR.
Defaults None
Example
14-3
BAR Administration Guide
Description This command assigns a single Access Control List to all BAR interfaces.
Defaults None
Example
User-Entered <accesslistnumber>
Parameters The number of an existing normal or extended Access Control List on the BAR. The
acceptable range for this parameter is from 1 - 199.
Description Submitting this command causes the BAR to display a table of the Access Control List’s
configuration and settings.
Defaults None
14-4
BAR Administration Guide
Example
Match Precedence 1
14.1
Action......................................... deny ACL Control
Match All...................................... FALSE
Commands
IP DSCP........................................ 0x1
Match Precedence 2
Action......................................... deny
Match All...................................... FALSE
IP Precedence.................................. 1
Match Precedence 3
Action......................................... deny
Match All...................................... FALSE
IP TOS......................................... TOS Bits: 0xff TOS Mask: 0xff
Match Precedence 4
Action......................................... deny
Match Precedence 5
Action......................................... deny
Match All...................................... FALSE
Destination L4 Port Keyword.................... 100
IP DSCP........................................ 0x14
Action The action associated with the rule: deny (discard packet) or
permit (allow packet).
Source IP Mask The associated subnet mask for the source IP.
Source L4 Port Keyword The keyword identifying the source filtering port (if used).
Source L4 Port The layer-4 port number identifying the filtered source port (if
used).
Destination IP Mask The associated subnet mask for the destination IP.
Destination L4 Port Keyword The keyword identifying the destination filtering port (if used).
Destination L4 Port The layer-4 port number identifying the filtered destination port
(if used).
14-5
BAR Administration Guide
IP TOS If used, the settings for TOS Bits and TOS Mask (displayed
and set in hexadecimal).
ACL Control
Commands
14-6
Chapter 15
Device Utilities
This chapter provides information and descriptions of various commands that control
the general configuration and characteristics of the BAR.
The BAR provides commands that offer control over BAR operation and
configuration, but which are not concerned with a particular network protocol or
operational aspect. These commands are presented and described in this chapter.
System Use the following commands to set and display the SNMP System Group information
Identification for the BAR. The SNMP MIB-II System Group settings provide information that is
Commands used by a network or element management system (such as Pannaway’s Broadband
Access Manager) to identify an IP network device within its community.
Summary Assign custom name, location, and contact information to the BAR.
User-Entered <name>
Parameters An alphanumeric name, up to 31 characters in length (including any spaces), that will be
used to identify the BAR to management sessions and logs.
NOTE: You must surround any descriptive string in quotation marks (“ ”) to use
spaces in entry. If you enter a space in the text string without using surrounding
quotes, you get an invalid input error.
<location>
A description of the location (address, office, rack, or other location) that the BAR
resides in. This field may be up to 31 characters in length, and is subject to the same
restrictions as the <name> parameter, described above.
<contact>
A name, email address, or telephone number of the primary service contact for the
BAR or the facility. This field may be up to 31 characters in length, and is subject to the
same restrictions as the <name> parameter, described above.
BAR Administration Guide
Description This command sets the name and the physical location of the switch, and the
organization responsible for the network.
15.1 Defaults
Example
None
Utility
Commands (Pannaway BAR) (Config)#snmp-server sysname “BAR_Rk2_Sh1”
General System Use the commands in this section to control the configuration and start-up settings of
Commands the BAR, clear various counters and logs, control log-in sessions, transfer files to and
from the BAR, and execute system utilities such as PING and traceroute.
User-Entered yes]
Parameters Entering the “Yes” flag at the causes the CLI to parse the command without prompting
you to confirm your action.
Description This command resets all configuration to the factory defaults without powering off the
switch. The switch is automatically reset when this command is processed. You are
prompted to confirm that the reset should proceed.
Defaults None
Example
15-2
BAR Administration Guide
Defaults None
Example
Are you sure you want to clear ALL port stats? (y/n)y
User-Entered [yes]
Parameters Entering the “Yes” flag at the causes the CLI to parse the command without prompting
you to confirm your action.
Defaults None
Example
15-3
BAR Administration Guide
User-Entered <source-location>
Parameters The <source-location> value is a local TFTP or Xmodem Uniform Resource Locator
(URL) or a memory location in the BAR. The values of the <source-location>
parameter vary depending on the type of copy operation.
<destination-location>
The <destination-location> value is a local TFTP or Xmodem URL or a memory
location in the BAR. The values of the <destination-location> parameter vary
depending on the type of copy operation.
If you will be uploading a file to the BAR:
i If uploading a previously saved configuration file or a firmware image to the
BAR, the destination-location value is one of the following locations:
nvram:startup-config Upload the file at the URL to replace the BAR startup configuration file.
i If uploading SSH key files to the BAR, the following locations may also be
specified:
nvram:sslpem-root Copy the file to the BAR as the root HTTP secure-server root
certificate.
nvram:sslpem-server Copy the file to the BAR as the root HTTP secure-server certificate.
nvram:sslpem-dhweak Copy the file to the BAR as the root HTTP secure-server DH-weak
certificate.
nvram:sslpem-strong Copy the file to the BAR as the root HTTP secure-server DH-strong
certificate.
15-4
BAR Administration Guide
Defaults None
Example
Mode........................................... TFTP
Set TFTP Server IP............................. 172.16.1.187
TFTP Path...................................... ./
TFTP Filename.................................. BAR_Config
Data Type...................................... Config File
Mode........................................... XMODEM
Data Type...................................... Code
logout
User-Entered None
Parameters
15-5
BAR Administration Guide
Description This command closes the current Telnet connection or resets the current serial
connection.
NOTE: Save any configuration changes before exiting the session. The system will
15.1
provide a prompt if any unsaved changes have been made during the session
being ended.
Example
User-Entered <ipaddr>
Parameters The IP address, in dotted decimal notation, of a host or interface on the network for
which you want to determine route hops.
[port]
The optional port parameter is the UDP port used as the destination of packets sent as
part of the traceroute. This port should be an unused port on the destination system, in
the range of 0 (zero) to 65,534, with a default of 33,434.
Description This command is used to discover the routes that packets actually take when traveling
to their destination through the network on a hop-by-hop basis.
Example
1 10.1.6.1 0 ms 0 ms 10 ms
2 172.17.3.1 0 ms 0 ms 0 ms
3 172.16.1.4 0 ms 10 ms 0 ms
15-6
BAR Administration Guide
reload [yes]
Description This command resets the switch. The switch uses the stored configuration to initialize
the switch. You are prompted to confirm that the reset should proceed. A successful
reset is indicated by the LEDs on the switch.
CAUTION: A reset of the BAR will interrupt all active sessions AND all active
connections to the BAR’s network interfaces.
Only saved configurations are loaded after a reset. The system will prompt you to
save if there are unsaved changes in the BAR’s memory.
Defaults None
Example
Configuration Saved!
System will now restart!
ping <ipaddr>
User-Entered <ipaddr>
Parameters The IP address, in dotted decimal notation, of a host or interface on the network.
Description This command checks if another host is on the network and listens for responses. To
use this command, configure the BAR for a network (in-band) connection. The source
and target devices must have the ping utility enabled and running on top of TCP/IP.
The switch can be pinged from any IP workstation with which the switch is connected
through the default VLAN (VLAN 1), as long as there is a physical path between the
switch and the workstation. The terminal interface sends three pings to the target
station.
Defaults None
15-7
BAR Administration Guide
Example
User-Entered None
Parameters
Description This command displays the trap log maintained by the switch.
Defaults None
Example
Number of Traps Since Last The number of traps that have occurred since the last reset of
Reset this device.
Number of Traps Since Log The number of traps that have occurred since the traps were
Last Viewed last displayed. Getting the traps by any method (terminal
interface display, Web display, upload file from switch etc.) will
result in this counter being cleared to 0.
System Up Time The relative time since the last reboot of the switch at which
this trap occurred.
15-8
BAR Administration Guide
User-Entered None
Parameters
Description This command displays used and available system memory on the BAR.
“no” Form
Defaults
None
None
15.1
Utility
Example Commands
Output The following output is displayed for free memory and allocated memory:
User-Entered None
Parameters
Description This command displays the percentage of CPU processing used during the past 5
second, 1 minute, and five minute intervals.
Defaults None
Example
15-9
BAR Administration Guide
show running-config
Description This command is used to display the current setting of different protocol packages
supported on switch. This command displays only those parameters with values that
differ from their default. The output is displayed in the script format, which can be used
to configure another switch with same configuration.
Defaults None
Example
!Current Configuration:
!
remotecon timeout 60
network protocol dhcp
vlan database
exit
configure
!System Description "Pannaway BAR"
!System version 1.0.3
!
exit
...
ip http secure-port 443
no ip ssh
show sysinfo
User-Entered None
Parameters
15-10
BAR Administration Guide
Defaults None
Example
15.1
(Pannaway BAR) #show sysinfo
MIBs Supported:
System Name Custom name used to identify the switch. The factory default is blank.
System Location Text used to identify the location of the switch. May be up to 31 alpha-
numeric characters. The factory default is blank.
System Contact Text used to identify a contact person for this switch. May be up to 31
alpha-numeric characters. The factory default is blank.
System ObjectID The base object ID for the switch’s enterprise MIB.
System Up Time The time in days, hours and minutes since the last switch reboot.
Related Commands snmp-server {sysname <name> | location <loc> | contact <con>} on page 15-1
15-11
BAR Administration Guide
show eventlog
Description This command displays the event log, which contains error messages from the system.
The event log is not cleared on a system reset.
Defaults None
Example
show msglog
User-Entered None
Parameters
Description This command displays the message log maintained by the switch. The message log
contains system trace information. The message log contains a maximum of 256 entries
that wrap.
Defaults None
15-12
BAR Administration Guide
Example
show hardware
User-Entered None
Parameters
Defaults None
Example
Vendor..........................................Pannaway Technologies
System Description............................. Pannaway BAR
Product Type....................................BAR
Serial Number.................................. 4024310077a20
CLEI code......................................
Part Number.....................................BAR-GE12
HW Version......................................rev 0A
Manufacturer....................................0xbc
Burned In MAC Address...........................00:0A:9F:50:00:78
Firmware Version............................... 1.1.0
Boot code Version...............................1.2.31
Command Output: The following information is shown on the show hardware screen:
CLEI code Common Language Equipment Identifier code for the BAR.
15-13
BAR Administration Guide
15.2 Boot code Version The version number of the boot code currently running on the
switch.
System Clock
Commands 15.2 System Clock Commands
The following commands allow you to set and view the system clock at the BAR,
including the Daylight Savings setting. The time can be set manually, or can be set
automatically via the Network Time Protocol (NTP).
Manual System Use the following command to set the BAR’s system clock manually.
Clock Setting
NOTE: When the BAR is manually set, it displays its system clock in Greenwich
Mean Time (GMT)/Universal Coordinated Time (CUT) unless a time zone is set.
User-Entered <Year>
Parameters The four-digit date indicating the current year.
NOTE: All parameters supplied for the system clock setting must be separated from
one another with colons (:) in order to be accepted by the BAR.
<Month>
The two-digit number (01 to 12) of the current calendar month.
<Day>
The two-digit number (01 to 31) of the day of the specified month.
<Hour>
The two-digit hour, in 24-hour format (00 to 24) indicating the present hour.
<Minute>
A two-digit number (from 00 to 59) representing the current minute.
<Second>
A two-digit number (from 00 to 59) representing the current second.
Description This command changes the BAR clock setting to the specified value.
Defaults None
15-14
BAR Administration Guide
Example
Related Commands clock timezone <atlantic | eastern | central | mountain | pacific | alaska | hawaii | samoan>
on page 15-19
clock daylight-savings enable on page 15-20
15.2
show clock on page 15-20 System Clock
Commands
Automatic System Use the following command to set the BAR’s system time automatically via a Simple
Clock Setting Network Time Protocol (SNTP) Server. The following commands allow you to
configure SNTP servers, as well as the client operation of the BAR with respect to the
server.
NOTE: When the BAR is set to NTP, it displays its system clock in Greenwich Mean
Time (GMT)/Universal Coordinated Time (CUT) unless a time zone is set.
• If set to unicast, the BAR must be configured with an SNTP server address to
which it will send poll messages to retrieve its system time settings.
• If set to broadcast, the BAR listens for broadcast SNTP messages at a given
interval, and then resets its clock accordingly.
Description Sets the operational mode of the system’s SNTP client with respect to an SNTP server.
NTP is a protocol built on top of TCP/IP that assures accurate local timekeeping with
reference to radio, atomic or other clocks located on the Internet. Once the clock is set,
the BAR – acting as the SNTP Client – will re-synchronize its clock with the server in
either unicast mode (active polling) or broadcast mode (passive update).
i If the client mode is set to unicast, you must also specify the SNTP servers that
the BAR will poll to retrieve its system clock settings. You can optionally set the
poll interval, number of retries, and poll timeout for the unicast SNTP client on
the BAR.
i If the client mode is set to broadcast and there is an SNTP broadcast server on
the network, no other configuration is required for the BAR to retrieve system
clock settings. You can optionally change the interval at which the BAR listens
for broadcast updates.
15-15
BAR Administration Guide
Example .
15.2 Related Commands sntp broadcast client poll-interval <6-10> on page 15-16
sntp unicast client poll-interval <6-10> on page 15-17
sntp unicast client poll-retry <0-10> on page 15-17
System Clock sntp unicast client poll-timeout <1-30> on page 15-18
Commands sntp server <ip_address> {priority_value} on page 15-18
show sntp [client | server ] on page 15-21
Summary Sets the TCP/UDP port on which the SNTP client will listen for SNTP broadcasts, and
transmit SNTP unicast requests.
User-Entered <port_value>
Parameters The Transmit and Receive TCP/UDP port value, in the range of 1-65,535.
Description Sets the operational mode of the system’s SNTP client with respect to an SNTP server.
NTP is a protocol built on top of TCP/IP that assures accurate local timekeeping with
reference to radio, atomic or other clocks located on the Internet. Once the clock is set,
the BAR – acting as the SNTP Client – will re-synchronize its clock with the server in
either unicast mode (active polling) or broadcast mode (passive update).
Example .
Summary When the SNTP client is in broadcast mode, sets the interval at which the client wakes
to listen for broadcast packets.
User-Entered <6-10>
Parameters The interval value setting expressed as a power of 2 in the range of 26 to 210 (an actual
interval of 64, 128, 256, 512, or 1024 seconds).
Description Sets the interval at which the SNTP client (in broadcast mode) listens for broadcast
packets and updates its system clock accordingly.
15-16
BAR Administration Guide
Example .
Summary When the SNTP client is in unicast mode, sets the interval at which the client transmits
a unicast poll to the SNTP server.
User-Entered <6-10>
Parameters The interval value setting expressed as a power of 2 in the range of 26 to 210 (an actual
interval of 64, 128, 256, 512, or 1024 seconds).
Description Sets the interval at which the SNTP client (in broadcast mode) transmits a unicast poll
to the specified SNTP server(s) and updates its system clock accordingly.
Example .
Summary When the SNTP client is in unicast mode, sets the number of poll retries which the
client will use before switching to another server (or waiting until the next poll interval).
User-Entered <6-10>
Parameters The interval value setting expressed as a power of 2 in the range of 26 to 210 (an actual
interval of 64, 128, 256, 512, or 1024 seconds).
15-17
BAR Administration Guide
Description Sets the number of server retries that the SNTP client uses after the first failed poll. If
all retries expire, the SNTP client attempts the second or third server in order. If there is
no response after all servers and retry attempts have been exhausted, the BAR
maintains its current clock setting until the next successful SNTP client poll attempt.
Example .
Summary When the SNTP client is in unicast mode, sets the response timeout value at which a
poll is considered unsuccessful and a retry poll is sent (or polling expires).
User-Entered <1-30>
Parameters The timeout value, ranging from 1-30 seconds.
Description Sets the duration of the response timeout after which the SNTP client sends another
poll (if more retries are configured) or halts polling the current SNTP server until the
next interval.
Defaults 5 seconds
Example .
Summary Configures the SNTP server to which the SNTP client sends an SNTP request (when in
Unicast mode).
15-18
BAR Administration Guide
User-Entered <ip_address>
Parameters The IP address of a known time server.
{priority value}
15.2
The optional server priority in a range of 1-3 (up to the total number of SNTP servers).
Description
Identifies an SNTP time server to which the BAR can send SNTP requests to update its
system clock settings. Up to three time servers can be configured for the BAR. If a poll System Clock
cycle to the primary server fails (all poll retries have been exhausted), the optional Commands
second and third servers are polled.
If no priority server is defined, all servers are considered equal in priority and after a
failed poll cycle, the next server is polled in the order that it was added to the
configuration. If an optional priority order is defined, servers are polled in the given
priority order.
Defaults None
Example .
Timezone and The following commands apply to the system clock setting, whether it is manually set or
Daylight Savings retrieved via NTP:
clock timezone <atlantic | eastern | central | mountain | pacific | alaska | hawaii | samoan>
Summary Sets the system’s time zone, based upon official United States time.
Description Set the system’s time zone setting. Any clock setting of UCT (coordinated universal
time or GMT) retrieved via an NTP server is converted to the local time zone setting.
Note also that the clock time zone must be set before enabling daylight savings via the
“clock daylight-savings enable” command described below.
Example .
15-19
BAR Administration Guide
User-Entered None
Parameters
Description Set the system clock to automatically adjust itself for daylight savings, based on the
current system clock setting. Note also that the clock time zone must be set before
enabling daylight savings via the “clock timezone” command described above.
Example .
Clock and SNTP The following commands display system clock information and SNTP server
Display Commands information.
show clock
User-Entered None
Parameters
Description Displays the system’s real time clock setting. It also displays the clock time zone setting
and configured daylight savings setting, as well as the time of the last administrative or
NTP server update.
NOTE: When the BAR is set to NTP, it displays its system clock in Greenwich Mean
Time (GMT)/Universal Coordinated Time (CUT) unless a time zone is set.
15-20
BAR Administration Guide
Example .
Command Output The system clock setting in Day, Month, Date, MM:HH:SS Year format, along with
Timezone information, Daylight Savings Time usage, and the last time that the system
clock was last started.
Summary Displays SNTP information, including detailed SNTP server and client information.
User-Entered None
Parameters
Description Displays information about the latest SNTP server updates, as well as optional SNTP
server and client information.
Example .
Broadcast Count: 0
15-21
BAR Administration Guide
15.2 Server
Server
Server
Server
Stratum:
Reference Id:
Mode:
Maximum Entries:
1
NTP Ref: ACTS
Server
3
System Clock
Server Current Entries: 2
Commands
SNTP Servers
------------
IP Address: 129.6.15.28
Address Type: IPV4
Priority: 1
Version: 4
Port: 123
Last Update Time: OCT 27 12:58:32 2005
Last Attempt Time: OCT 27 12:58:32 2005
Last Update Status: Success
Total Unicast Requests: 58
Failed Unicast Requests: 0
IP Address: 192.43.244.18
Address Type: IPV4
Priority: 1
Version: 4
Port: 123
Last Attempt Time: JAN 01 00:00:00 1970
Last Update Status: Other
Total Unicast Requests: 0
Failed Unicast Requests: 0
Command Output If the command is executed without the optional client or server commands, the
following output is displayed:
Last Attempt Time Time of last transmit query (in unicast mode).
Last Attempt Status Status of the last SNTP request (in unicast mode) or unsolicited
message (in broadcast mode).
Broadcast Count Current number of unsolicited broadcast messages that have been
received and processed by the SNTP client since last reboot..
15-22
BAR Administration Guide
15.2
SNTP Version The highest SNTP version the client supports.
Poll Timeout (seconds) Poll timeout value in seconds for SNTP clients.
Server Stratum Claimed stratum of the server for the last received valid packet.
Server Reference ID Reference clock identifier of the server for the last received valid
packet.
Version SNTP Version number of the server. The protocol version used to
query the server in Unicast mode.
Last Update Time Last server attempt time for the specified server.
Last Update Status Last server attempt status for the server.
15-23
BAR Administration Guide
15.2
System Clock
Commands
15-24
Appendix A
List of CLI Commands
This Appendix provides an alphabetical list of all the CLI commands provided in this
document. It may be used as a quick reference for locating commands, or as a very brief
reminder of the format and parameters of the several commands available on the
BAR CLI.
telnet <ip_address>: 11-6
1583compatibility: 7-1
access-list <accesslistnumber> {deny | permit} {every | <srcip> <srcmask>}: 14-1
access-list <accesslistnumber> {deny | permit} {every | icmp | igmp | ip | tcp | udp | <protocolnumber>} <srcip> <src-
mask> [eq {<srcl4portnumber> | <srcportkey>}] <dstip> <dstmask> [eq {<dstl4portnumber> | <dstportkey>}] [prece-
dence <precedence> | tos <tos> <tosmask> | dscp <dscp>]: 14-2
addport <logical slot/port>: 4-5
area <areaid> authentication {none | simple | encrypt}: 7-2
area <areaid> default-cost <cost>: 7-2
area <areaid> nssa default-info-originate [<metric>] {comparable | non-comparable}: 7-3
area <areaid> nssa no-redistribute: 7-4
area <areaid> nssa no-summary: 7-4
area <areaid> nssa translator-role {always | candidate}: 7-5
area <areaid> nssa translator-stab-intv <stabilityinterval>: 7-6
area <areaid> nssa: 7-3
area <areaid> range <ipaddr> <subnetmask> {summarylink | nssaexternallink} [advertise | not-advertise]: 7-6
area <areaid> stub summarylsa: 7-7
area <areaid> stub: 7-7
area <areaid> virtual-link <neighbor> authentication {none | simple <key> | encrypt <key> <keyid>}: 7-8
area <areaid> virtual-link <neighbor> dead-interval <d-interval>: 7-9
area <areaid> virtual-link <neighbor> hello-interval <h-interval>: 7-10
area <areaid> virtual-link <neighbor> retransmit-interval <r-interval>: 7-10
area <areaid> virtual-link <neighbor> transmit-delay <delay>: 7-11
area <areaid> virtual-link <neighbor>: 7-8
arp <ipaddress> <macaddr>: 5-9
arp cachesize <entries>: 5-10
arp dynamicrenew: 5-10
arp purge <ipaddr>: 5-11
arp resptime <resp-timeout>: 5-11
arp retries <retries>: 5-12
arp timeout <seconds>: 5-12
auto-negotiate all: 3-2
auto-negotiate: 3-1
auto-summary: 6-1
bootpdhcprelay cidoptmode: 5-16
bootpdhcprelay disable: 5-16
bootpdhcprelay maxhopcount <hops>: 5-17
BAR Administration Guide
A-2
BAR Administration Guide
A-3
BAR Administration Guide
A-4
BAR Administration Guide
A-5
BAR Administration Guide
A-6
BAR Administration Guide
A-7
BAR Administration Guide
A-8
Index
Page numbers in this index that are presented in boldface type indicate references to CLI commands in the text.
heading format 10
A disconnecting sessions 6
Address pools error messages 7
DHCP 3 local connection 2
Addressing modes 4–7
auto-configuration 7 mode structure 4
MAC address 6 privileged exec, enabling 6
Arguments prompt suffixes 6
see CLI, parameters starting mode 2
ARP modes, changing 6
in protocol-based VLANs 21 modes, exiting 7
Auto-completion 8 parameters 3, 10
passwords, setting 7
prompt, customizing 4
B user accounts, creating 7
values 3
Baud rate 2, 3, 4
Clock 14
BGP, CLI configuration mode 5
Color-coding, use of to identify CLI commands 10
BootP 7
Commands - see CLI
Braces, meaning in command descriptions 10
Community - see SNMP
Brackets, meaning in command descriptions 10
Configuration, reloading 7
Bridge - see Switching
Configuration, reset to default 2
Broadcast storms 9
Console
BWprovisioning
session timeout 2
see CLI modes
settings 2
Console port 1
baud rate 2, 3, 4
C timeout 3
Cautions 4 Contact information, assigning to BAR 1
CBSR - see Multicast, PIM-SM
Class map - see CLI modes
Clearing configuration 2 D
CLI
Date 14
auto-completion of commands 8
daylight savings time 20
command format 10
Default routers, in DHCP service 4
commands 3
Default, restoring BAR to default configuration 2
"no" variants 3
BAR Administration Guide
DHCP 7
address pools I
creating 3 Idle timeout 3
excluding 2 IGMP - see Multicast
G M
Gigabit Ethernet MAC address
auto-negotiation 1 filtering, see VLAN
see also ports, Ethernet modifying 6
Global Config Manuals, related documents 3
see CLI modes MTU, setting length 6
Multicast
boundaries, specifying 12
H DVMRP
Half-duplex (Ethernet port setting) 2 activating 8
Help metric, setting 7
showing key bindings 8 mode, activating 2
system help capabilities 8 forwarding mode, activating 2
Technical Support 5 IGMP
activating 1
host query interval 9
last member query count 8
last member query interval 9
response time (maximum) 10
robustness metric, setting for an
interface 10
Index-2
BAR Administration Guide
Index-3
BAR Administration Guide
Index-4
BAR Administration Guide
U
Uploading 3
User Exec - see CLI modes
Users
creating 7
passwords 7
V
Virtual ports 9
VLAN
(CLI mode) -see CLI modes
adding ports (to port-channel) 5
clearing configurations 15
creating 8
frame acceptance, configuring 11
IDs, changing 13, 14
ingress filtering, activating 9
ingress filtering, enabling 12
LACP 19–20
LAGs - see VLAN, port-channels 1
MAC address filtering 16–19
names, assigning 9
network management VLAN, setting 7
participation mode, setting 10, 11
port-channel
activating 3
adding ports to 5
clearing 7
creating 2
deleting interfaces from 6
deleting ports from 6
enabling support 1
naming 3
Index-5
BAR Administration Guide
Index
Index-6