Summary of Contents for Allied Telesis SwitchBlade x908 Series
Page 1
® SwitchBlade x908 and x900 Series Switches AlliedWare Plus™ Operating System Software Reference for Version 5.3.1 SwitchBlade x908 ® x900-12XT/S x900-24XS x900-24XT x900-24XT-N C613-50007-01-Rev B...
Page 2
GNU General Public License (GPL) and will make all required source code available. If you would like a copy of the GPL source code contained in Allied Telesis products, please send us a request by registered mail including a cheque for US$15 to cover production and shipping costs and a CD with the GPL code will be mailed to you.
Page 3
New Features in AlliedWare Plus 5.3.1. The following features have been added to the AlliedWare Plus 5.3.1-01 release: Loop Protection Thrash Limiting, also known as Rapid MAC Movement, detects and resolves Loop Protection Thrash Limiting network loops. Chapter 14, Loop Protection for information about the Loop Protection feature.
Page 4
See the chapters “PIM-DM Commands” on page 46.1, “PIM-DM Configuration” on page 45.1 for information on the PIM Dense Mode feature. Appendix A: Commands List Appendix B: Release Notes for links to commands New 5.3.1 Commands introduced into the AlliedWare Plus 5.3.1software release. Software Reference for SwitchBlade®...
Table of Contents Part 1 Setting up the Switch Chapter 1. Getting Started ....................1.1 Introduction........................................1.2 How to log-in......................................... 1.2 How to get command help ................................... 1.2 Viewing a list of valid parameters............................. 1.3 Completing keywords................................1.6 Viewing command error messages ..........................1.8 How to work with command modes ..............................
Page 7
Chapter 13. Interface Testing Commands ...............13.1 Introduction........................................13.2 Part 2 Layer Two Switching Chapter 14. Switching Introduction..................14.1 Introduction........................................14.2 Physical Layer Information ..................................14.3 Switch Ports....................................14.3 Port ranges ....................................14.3 Activating and Deactivating Switch Ports ........................14.4 Autonegotiation..................................14.4 Duplex mode.....................................14.4 Speed options....................................14.4 Configuring the port speed..............................14.5 MDI MDIX Connection Modes (10BASE-T) ......................14.5 The Layer 2 Switching Process ................................14.7 The Ingress Rules ..................................14.7...
Page 8
Private VLAN Operation ..............................16.10 Example Configuration ..............................16.11 Chapter 17. VLAN Commands ..................17.1 Introduction........................................17.2 Chapter 18. Spanning Tree Introduction: STP, RSTP, and MSTP18.1 Introduction........................................18.2 Overview of Spanning Trees................................18.2 Spanning tree operation ..............................18.2 Spanning tree modes................................18.4 Spanning Tree Protocol (STP) ................................18.5 Configuring STP ......................................18.5 Rapid Spanning Tree Protocol (RSTP) ............................18.6 Configuring RSTP.......................................18.8 Multiple Spanning Tree Protocol (MSTP)..........................18.10...
Page 9
Chapter 23. IP Addressing and Protocol Commands .............23.1 Introduction........................................23.2 Chapter 24. IPv6 Introduction ...................24.1 Introduction........................................24.2 Overview ........................................24.2 IPv6 Addresses and Prefixes................................24.3 Address types ....................................24.3 IPv6 Headers ....................................24.4 The Internet Control Message Protocol (ICMPv6) .....................24.7 IPv6 Routing....................................24.9 Integration of IPv4 and IPv6............................24.10 IPv6 on your Switch....................................24.10 Enabling IPv6....................................24.10 The 6bone Network ................................24.10...
Page 12
TCP Flags....................................48.12 Chapter 49. Access Control List (ACL) Commands............49.1 Introduction........................................49.2 Chapter 50. Quality of Service (QoS) ................50.1 Introduction........................................50.2 QoS Operations..................................50.2 QoS Packet Information ..................................50.3 Link Layer QOS..................................50.3 Differentiated Services Architecture..........................50.4 The Differential Services Field............................50.6 Processing pre-marked packets............................50.7 Applying QoS on Your Switch................................50.8 Classifying your Data ................................50.8 Class Maps ....................................50.8 Policy Maps....................................50.11...
Page 17
VCS Supported Platforms..............................82.2 Features of Virtual Chassis Stacking ..........................82.2 The Physical Stack ...................................82.3 Stack Back-to-Back Configuration ..........................82.3 Resilient Stacked Topology..............................82.5 Stack Formation ......................................82.7 The Role of the Stack Master............................82.7 Stack Management VLAN ..............................82.9 Stack Member Failure and Recovery.........................82.11 VCS Failure Recovery.................................82.13 Stack Maintenance ................................82.14 Software Version Auto Synchronization ...........................82.15 Introduction .....................................82.15...
Page 18
Software Reference for SwitchBlade® x908 and x900 Series Switches xviii AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
Page 19
Part 1: Setting up the Switch Chapter 1 Getting Started ■ Chapter 2 Command Syntax Conventions in this Software Reference ■ Chapter 3 Start-up Sequence ■ Chapter 4 CLI Navigation Commands ■ Chapter 5 User Access Commands ■ Chapter 6 Creating and Managing Files ■...
Chapter 1: Getting Started Introduction................................1.2 How to log-in................................1.2 How to get command help ..........................1.2 Viewing a list of valid parameters......................1.3 Completing keywords..........................1.6 Viewing command error messages .....................1.8 How to work with command modes......................1.9 How to see the current configuration....................1.13 Default settings..............................1.14 The default configuration script........................1.15 How to change the password........................1.16 How to set a management IP address ....................1.16...
Getting Started Introduction This chapter introduces a number of commonly-used management features of the AlliedWare Plus operating system (OS). How to log-in Step 1: Set the console baud rate The default baud rate is 9600. By default the AlliedWare Plus OS supports VT100 compatible terminals on the console port.
Getting Started Viewing a list of valid parameters To get syntax help, type ? (i.e. “space question mark”) after: ■ the prompt. This will list all commands available in the mode you are in. one or more parameters. This will list parameters that can come next in the partial ■...
Page 24
Getting Started Figure 1-1: Example output from the ? command Exec commands: activate Activate a script Change the current working directory clear Reset functions clock Manage clock configure Enter configuration mode copy Copy from one file to another debug Debugging functions (see also 'undebug') delete Delete a file List the files on a filesystem...
Page 25
Getting Started Figure 1-2: Example output from the ? command Configure commands: Authentication,Authorization and Accounting access-list Add an access list entry Address Resolution Protocol (ARP) auth-web-server Web authentication server configuration commands banner Define a login banner Border Gateway Protocol (BGP) boot Boot configuration class-map...
Getting Started Example To see which show commands that start with “i” are available in Privileged Exec mode, enter “?” after show i: awplus# show i? This results in the following output: Figure 1-3: Example output from the show i? command interface Select an interface to configure Internet Protocol (IP)
Page 27
Getting Started Figure 1-4: Example output after entering the command, show ip <Tab> as-path-access-list community-list dhcp dhcp-relay domain-list domain-name extcommunity-list filter forwarding igmp interface irdp mroute mvif name-server ospf protocols route awplus# show ip d<Tab> Figure 1-5: Example output after entering the command, show ip d<Tab> dhcp dhcp-relay domain-list...
Getting Started Viewing command error messages The switch displays the following generic error messages about command input: % Incomplete command—this message indicates that the command requires more parameters. Use the ? help to find out what other parameters are available. awplus# interface % Incomplete command.
Getting Started How to work with command modes The following figure shows the command mode hierarchy and the commands you use to move to lower-level modes. Multiple users can telnet and issue commands using the Exec mode and the Privileged Exec mode.
Page 30
Getting Started Global To change from Privileged Exec to Global Configuration mode, enter the command: Configuration mode awplus# configure terminal From Global Configuration mode, you can configure most aspects of the switch. The default Global Configuration mode prompt is awplus(config)#. Lower-level A number of features are configured by entering a lower-level mode from Global configuration...
Page 31
Getting Started Some protocols have commands in both Global Configuration mode and lower-level configuration modes. For example, to configure MSTP, you use: Global Configuration mode to select MSTP as the spanning tree mode ■ ■ MST mode to create instances and specify other MSTP settings ■...
Page 32
Getting Started To go from Privileged Exec to User Exec: awplus# exit awplus> Entering As you configure the switch you will be constantly entering various show commands to confirm Privileged Exec your configuration. This requires constantly changing between configuration modes and commands when Privileged Exec mode.
Getting Started How to see the current configuration The current configuration is called the running-config. To see it, enter the following command in either Privileged Exec mode or any configuration mode: awplus# show running-config To see only part of the current configuration, enter the command: awplus# show running-config|include <word>...
Getting Started Default settings When the switch first starts up with the AlliedWare Plus OS, it applies default settings and copies these defaults dynamically into its running-config. These default settings mean that the AlliedWare Plus OS: ■ encrypts passwords, such as user passwords records log message priority in log messages ■...
Getting Started The default configuration script Most of the above default settings are in the form of commands, which the switch copies to its running-config when it first boots up. The switch stores a copy of the default configuration commands in the file, default.cfg and uses this as its default start-up file.
Getting Started How to change the password To change the password for the manager account, enter Global Configuration mode and enter the following command: awplus(config)# username manager password <new-password> The password can contain any printable character and is case sensitive. How to set a management IP address This section describes how to set an IP address on the eth0 management port.
Getting Started How to save and boot from the current configuration This section tells you how to save your configuration and run the saved configuration when the switch starts up. You can either: save the configuration to the switch’s default configuration file (called “default.cfg”). By ■...
Page 38
Getting Started The output looks like this: Figure 1-9: Boot configuration --------------------------------------------------------- Current software : r1-5.3.1.rel Current boot image : flash:/r1-5.3.1.rel Backup boot image : Not set Default boot config: flash:/.configs/default.cfg Current boot config: flash:/example.cfg (file exists) Step 4: Continue updating the file when you change the configuration When you next want to save the current configuration, enter Privileged Exec mode and enter the command: awplus#...
Getting Started How to return to the factory defaults The switch dynamically adds the default settings to the running-config at start-up if the default file is not present. This section describes how to use this feature to return to the factory defaults.
Getting Started How to see system information This section describes how to view the following system information: overview information ■ ■ details of temperature and voltage serial number ■ Viewing overall system information To display an overview of the switch hardware, software, and system settings, enter User Exec or Privileged Exec mode and enter the command: awplus# show system...
Getting Started Viewing temperature, voltage, and fan status The switch monitors the environmental status of the switch and its power supplies and fan. To display this information, enter User Exec or Privileged Exec mode and enter the command: awplus# show system environment The output looks like the following figure.
Getting Started Viewing the serial number The switch’s serial number is displayed in the output of the show system command, but for convenience, you can also display it by itself. To do this, enter User Exec or Privileged Exec mode and enter the command: awplus# show system serialnumber The output looks like this:...
Getting Started How to name the switch To give the switch a name, enter Global Configuration mode and enter the command: awplus(config)# hostname <name> For example, to name the switch “switch1.mycompany.com”: awplus(config)# hostname switch1.mycompany.com The prompt displays the new name: switch1.mycompany.com(config)# The name can contain hyphens and underscore characters.
Getting Started This results in the following output at login: awplus login: manager Password: this is a new banner awplus> Removing the To return to the default banner (AlliedWare Plus OS version and build date), enter the banner command: awplus(config)# banner motd default To remove the banner instead of replacing it, enter the command: awplus(config)#...
Getting Started How to set the time and date To set the time and date, enter Privileged Exec mode and enter the clock set command: clock set <hh:mm:ss> <day> <month> <year> :where: hh is two digits giving the hours in 24-hour format (e.g. 14) ■...
Getting Started The <start-time> and <end-time> are in the form hh:mm, in 24-hour time. Note that if you specify 5 for the week, this changes the time on the last day of the month, not the 5th week. Example To configure EDT, enter the command: awplus(config)# clock summer-time EDT recurring 2 Sun Mar 02:00 1 Sun Nov 02:00 60...
Getting Started The output looks like this: Line User Host(s) Idle Location 130 vty 0 manager idle 01:36:37 10.33.27.11 131 vty 1 idle 00:00:00 10.33.22.13 To list all configured users, enter User Exec or Privileged Exec mode and enter the command: awplus# show running-config |include username The output looks like this:...
Getting Started How to undo settings There are two possibilities for undoing settings: the no parameter and the default parameter. How to use the no parameter To undo most settings, simply re-enter the first parameters of the configuration command with the parameter no before them.
Getting Started How to upgrade the firmware New releases of the AlliedWare Plus OS become available regularly. Contact your customer support representative for more information. Step 1: Put the new release onto your TFTP server Step 2: If necessary, create space in the switch’s Flash memory for the new release Note that you cannot delete the current release file.
Getting Started Controlling “show” command output You can control the output of show commands by using the | and > tokens in either of the following ways: ■ To display only part of the output, follow the command with | and then other keywords (see Output Modifiers below)
Page 51
Getting Started Include The include parameter includes only those lines of output that contain the input string. In the output below, all lines containing the word “input” are included: awplus# show interface eth0 | include input input packets 80434552, bytes 2147483647, dropped 0, multicast packets 0 input errors 0, length 0, overrun 0, CRC 0, frame 0, fifo 1, missed 0...
Getting Started Commands available in each mode This appendix lists the commands available in the following command modes for software Software Version 5.3.1. ■ “User Exec mode” on page 1.32 ■ “Privileged Exec mode” on page 1.33 ■ “Global Configuration mode” on page 1.34 User Exec mode awplus>...
Getting Started Privileged Exec mode awplus# Exec commands: activate Activate a script Change the current working directory clear Reset functions clock Manage clock configure Enter configuration mode copy Copy from one file to another debug Debugging functions (see also 'undebug') delete Delete a file List the files on a filesystem...
Getting Started terminal Set terminal line parameters test Test device functionality traceroute Trace route to destination trigger Automatic scripted responses to device events undebug Disable debugging functions (see also 'debug') wait Wait for a specified number of seconds write Write running configuration to memory, file or terminal Global Configuration mode awplus(config)#...
Page 55
Getting Started mail Send an email max-fib-routes Set maximum fib routes number max-static-routes Set maximum static routes number maximum-access-list Maximum access-list entries maximum-paths Set multipath numbers installed to FIB Multi-Layer Switch(L2/L3) Negate a command or set its defaults Configure NTP ospf Open Shortest Path First (OSPF) ping-poll...
Getting Started AlliedWare Plus GUI Information on loading and using the AlliedWare Plus GUI is outside the scope of the main body of this reference manual. This topic is covered in a separate appendix to this document. Appendix C: GUI Reference.
Chapter 2: Command Syntax Conventions in this Software Reference The following table describes how command line interface syntax is shown in this Software Reference. Syntax element Example What to enter in the command line Keywords are shown in lowercase Some keywords are required, and show spanning-tree mst fixed-width font or bold variable- others are optional parameters.
Page 58
Command Syntax Conventions in this Software Reference Software Reference for SwitchBlade® x908, x900 and x600 Series Switches AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
Chapter 3: Start-up Sequence AlliedWare Plus™ Start-up..........................3.2 Diagnostic menu..............................3.2 Bootloader menu..............................3.4 Start-up sequence..............................3.8 Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1...
Start-up Sequence AlliedWare Plus™ Start-up Every switch has a start-up process. A specified version of product software must be loaded and executed. The bootloader is the executable code responsible for setting up the system and loading the release software. The bootloader is the software that runs the unit when it first powers up, performing basic initialization and executing the product software release.
Page 61
Start-up Sequence For example, enter “2” to select a Quick RAM test: Quick RAM test - press Q to quit, S to skip when failing Writing pattern ........ Checking pattern ........ Writing complemented pattern ....Checking complemented pattern ....Pass 1 total errors 0 Enter “7”...
Start-up Sequence Bootloader menu Enter Ctrl+B during start-up to access the bootloader menu where boot options can be set. The boot options shown are explained in detail under this example. Boot Menu: ------------------------------------------------------ B. Boot backup software ------------------------------------------------------ 0. Restart 1.
Page 63
Start-up Sequence You can select a one-off boot from flash, SD card, network server (TFTP), or ymodem. The selected option will be used for the next restart (only) of the switch. If you select to boot from the network, the bootloader prompts the user for the required network address details: Note: These settings are specific to the Bootloader.
Page 64
This option allows for the bootloader code to be updated. It is not detailed here, as it is envisioned that this would rarely need to be done, and only at the request of (and with support from) Allied Telesis engineering. Select device: 0.
Start-up Sequence System information The system information option provides some details on the hardware platform in use, such as CPU, memory, hardware (MAC) address and so on. System information: System (Detected values) ------------------------------------------------------ CPU: Type ....: MPC8541E Speed ....: 666 MHz Memory: Total installed ..: 512 MB Speed ....: 133 MHz...
Page 67
Start-up Sequence There are three possible status results displayed for each module loaded - OK, INFO, ERROR: ■ OK means that the module has loaded correctly. ■ INFO means that an error occurred, but the device is usable. ■ ERROR means that an error occurred and device operation may be affected. Additional specific information accompanies an INFO or ERROR status result.
Page 68
Start-up Sequence Software Reference for SwitchBlade® x908, x900 and x600 Series Switches 3.10 AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
Page 69
Chapter 4: CLI Navigation Commands Introduction................................4.2 configure terminal..............................4.2 disable...................................4.2 do....................................4.3 enable ...................................4.3 end....................................4.4 exit....................................4.4 help ....................................4.5 logout....................................4.5 show cli..................................4.6 show history................................4.6 show list..................................4.7 Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1...
CLI Navigation Commands Introduction This chapter provides an alphabetized reference for the commands used to navigate between different modes. This chapter also provides a reference for the help and show commands used to help navigate within the CLI. configure terminal This command enters the configure command mode.
CLI Navigation Commands This command lets you to run Exec and Privileged Exec mode commands when you are in a configuration mode. Syntax do <line> Parameter Description <line> Specify the command and its parameters. Any configuration mode Command Mode Example awplus# configure terminal awplus(config)#...
CLI Navigation Commands This command returns the prompt to the Privileged Exec command mode from any other advanced command mode. Syntax All command modes Mode The following example shows the use of the end command to return to the Privileged Exec Examples mode directly from Interface mode.
CLI Navigation Commands help This command displays a description of the AlliedWare Plus OS help system. Syntax help All command modes Mode Figure 4-1: Example output from the help command Output When you need help at the command line, press '?'. If nothing matches, the help list will be empty.
CLI Navigation Commands show cli Use this command to display the CLI tree of the current mode. Syntax show cli All command modes Mode To display the CLI tree of the current mode, use the command: Example awplus# show cli Figure 4-2: Example output from the show cli command Output +-ospf...
CLI Navigation Commands show list Use this command to display a list of all the commands relevant to the current mode. Syntax show list All command modes. Command Mode To run the show list command: Examples awplus# show list Figure 4-4: Example output from the show list command in Configure mode Output echo LINE edit...
Page 76
CLI Navigation Commands Software Reference for SwitchBlade® x908, x900 and x600 Series Switches AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
Page 77
Chapter 5: User Access Commands Introduction................................5.2 clear line console..............................5.2 clear line vty ................................5.2 enable password..............................5.3 exec-timeout ................................5.5 length ....................................5.6 line ....................................5.7 privilege level ................................5.8 service advanced-vty ............................5.8 service password-encryption...........................5.9 service telnet................................5.10 service terminal-length .............................5.11 show privilege ...............................5.11 show telnet................................5.12 show users ................................5.12 telnet ..................................5.13 telnet server ................................5.14 terminal length..............................5.15...
User Access Commands Introduction This chapter provides an alphabetical reference of commands used to configure user access. clear line console This command resets a console line. If a terminal session exists on the line then it is closed. Syntax clear line console 0 Privileged Exec mode Mode To reset the console use the command:...
User Access Commands enable password To set a local password to control access to various privilege levels, use the enable password global configuration command. Use the enable password command to modify or create a password to be used, and use the no enable password command to remove the password. Note: Do not use encrypted passwords for GUI users.
Page 80
User Access Commands Configuration Output in the Configuration File awplus#configure terminal awplus#show run Current configuration: awplus(config)#enable password hostname awplus mypasswd enable password 8 fU7zHzuutY2SA service password-encryption awplus(config)#service password- encryption interface lo awplus(config)#end Configuration Output in the Configuration File awplus#configure terminal awplus#show run Current configuration: hostname awplus...
User Access Commands exec-timeout This command sets the interval your device waits for user input from either a console or VTY connection. Once the timeout interval is reached, the connection is dropped. This command sets the time limit when the console or VTY connection automatically logs off after no activity. The no parameter removes a specified timeout and resets to the default timeout (10 minutes).
User Access Commands length Use this command to specify the number of rows of output that the device will display before pausing, for the console or VTY line that you are configuring. If the output from a command is longer than the length of the line the output will be paused and the ‘–More–’...
User Access Commands line Use this command to move to line configuration mode for the specified VTYs or the console. Syntax line vty <first-line> [<last-line>] line console 0 Parameter Description <0-32> Specify the first line number. <first-line> <last-line> <0-32> Specify the last line number. Global Configuration mode Mode The following example shows the use of the line command to enter the Line command...
User Access Commands privilege level This command sets a privilege level for VTY or console connections. This privilege level overrides a specific user’s privilege. Syntax privilege level <0-15> Line mode Mode To set the console connection to have the maximum privilege level, use the command: Example awplus(config)# line console 0 0...
User Access Commands service password-encryption Use this command to enable password encryption. This is enabled by default. When password encryption is enabled, the device displays passwords in the running config in encrypted form instead of in plain text. Use the no parameter to stop the device from displaying newly-entered passwords in encrypted form.
User Access Commands service telnet service telnet Command Modified vs_531 %flag User Access Commands Updated telnet command for IPv6 addressing. Use this command to enable the telnet server. The server is enabled by default. Enabling the telnet server starts the switch listening for incoming telnet sessions on the configured port. The server listens on port 23, unless you have changed the port by using the privilege level command on page...
User Access Commands service terminal-length Use this command to specify the number of rows of output that the device will display before pausing, for all console and VTY lines. Use the no parameter to remove the length specified by this command. The default length will apply unless you have changed the length for some or all lines by using the length command on page...
User Access Commands show telnet show telnet Command Modified vs_531 %flag User Access Commands Updated telnet command for IPv6 addressing. This command shows the Telnet server settings. Syntax show telnet Exec mode and Privileged Exec mode. Mode To show the Telnet server settings use the command: Example awplus# show telnet...
User Access Commands telnet telnet Command Modified vs_531 %flag User Access Commands Updated telnet command for IPv6 addressing. Use this command to open a telnet session to a remote device. Syntax telnet {ip <ipv4-address>|ipv6 <ipv6-address>} [<port>] Parameter Description Keyword used to specify the IPv4 address or host name of a remote system.
User Access Commands telnet server This command enables the telnet server on the specified TCP port. If the server is already enabled then it will be restarted on the new port. Changing the port number does not affect the port used by existing sessions. Syntax telnet server [<1-65535>|default] Parameter...
User Access Commands terminal length Use the terminal length command to specify the number of rows of output that the device will display before pausing, for the currently-active terminal only. Use the terminal no length command to remove the length specified by this command. The default length will apply unless you have changed the length for some or all lines by using the length command on page 5.6.
User Access Commands username This command creates or modifies a user. Note: Do not use encrypted passwords for GUI users. The GUI requires unencrypted user passwords only - not encrypted user passwords. Do not use option for GUI users. Syntax username <name>...
Page 93
Chapter 6: Creating and Managing Files Introduction................................6.2 Working with files..............................6.2 Listing files................................6.2 Displaying the contents of configuration and text files............6.4 Navigating through the file system ......................6.4 Using the editor..............................6.6 Creating and Using Configuration Files .....................6.7 Creating a Configuration File........................6.7 Specifying the Start-up Configuration Script..................6.7 Working with Configuration Files ......................6.8 Copying Files To and From Your Device ....................6.9 URL Syntax ...............................6.9...
Creating and Managing Files Introduction This chapter provides information on: Working with files ■ ■ Creating and Using Configuration Files Copying Files To and From Your Device ■ Working with files The AlliedWare Plus OS lets you create directory trees for file storage. This section shows: ■...
Creating and Managing Files Listing files in NVS memory or on an SD card To list the contents of a directory in NVS, enter Privileged Exec mode and enter the command: awplus#dir nvs:<directory-name> To list the contents of a directory on an SD card, enter the command: awplus#dir card:<directory-name>...
Page 97
Creating and Managing Files Changing to a directory in NVS memory or on an SD card To change to the top-level directory in the NVS memory file system, enter Privileged Exec mode and enter the command: awplus#cd nvs: To change to the top-level directory on an SD card, enter the command: awplus#cd card:/ Note that the prefix for the SD card is “card”...
Creating and Managing Files Using the editor The inbuilt editor is JOE (Joe’s Own Editor). To edit an existing file, enter Privileged Exec mode and enter the command: edit <filename> To open the editor with an empty file, enter the command: edit When you save the new file, you may need to specify the file system to store it on.
Creating and Managing Files Creating and Using Configuration Files This section provides instructions on: Creating a Configuration File ■ ■ Specifying the Start-up Configuration Script Working with Configuration Files ■ Creating a Configuration File A configuration file is a text file that contains a sequence of standard commands for a specific purpose.
Creating and Managing Files You can change the content of the file set as the startup-config file by: ■ entering commands directly into the CLI, then saving this configuration using the command: awplus#copy running-config startup-config This command saves the device’s dynamic configuration into the file that is currently configured as the startup-config file.
Creating and Managing Files Copying Files To and From Your Device This section provides instructions on: URL Syntax ■ ■ Copying files URL Syntax Many of the file management commands use the placeholder “URL” to represent the name and location of the file that you want to act on. The following table explains the syntax of this URL for each different type of file location.
Page 102
Creating and Managing Files Copying within a file system Within a To copy a file within the same directory, enter Privileged Exec mode and enter the command: directory awplus#copy <source-filename> <destination-filename> If the file already exists, the switch asks whether to overwrite it, with a message like this: Overwrite flash:/example.cfg? (y/n)[n]: To overwrite, press the “y”...
Page 103
Creating and Managing Files Copying with ZMODEM ZMODEM allows you to copy files from a network host over an asynchronous port. Use the command: awplus#copy zmodem to open Minicom and transfer a file. Alternatively you can specify the file name within the command: awplus#copy SOURCE-URL zmodem For example, to copy the file “july.cfg”...
Creating and Managing Files The prompts, responses, and messages look like this: Enter source file name []:example.cfg Enter destination host name []:172.1.1.1 Enter destination file name [example.cfg]: Copying from source file, please wait... Copying to destination file, please wait... 0: Successful operation To load the file “bob.key”...
Page 106
File Management Commands show running-config switch .............................7.41 show running-config switch lacp...........................7.42 show running-config switch radius-server .......................7.42 show running-config switch vlan...........................7.43 show startup-config..............................7.44 show version..................................7.45 write file ....................................7.46 write memory..................................7.46 write terminal ..................................7.46 Software Reference for SwitchBlade® x908, x900 and x600 Series Switches AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
File Management Commands Introduction This chapter provides an alphabetized reference of AlliedWare Plus OS file management commands. URL Syntax and Many of the commands in this chapter use the placeholder “URL” to represent the name and Keyword Usage location of the file that you want to act on. The following table explains the syntax of this URL for each different type of file location.
File Management Commands boot backup This command specifies a backup release file to load during the next boot cycle. If your device cannot load the main release file, then the file specified with this command is used. Syntax boot backup <filename> Parameter Description Name of a release file.
File Management Commands boot system This command specifies the release file to load during the next boot cycle. Syntax boot system <filename> Parameter Description Name of a release file. The specified file must exist in the root <filename> directory of the flash file system. Valid release files must have a .rel extension.
File Management Commands copy current-software This command copies the AlliedWare Plus OS software that the device has booted from to a destination file. Specify whether the destination is Flash or Card when saving the software to the local file system. Syntax copy current-software <destination-url>...
File Management Commands copy LOCAL This command copies a file between local file systems. This allows you to copy a file stored on flash memory to or from a different memory type attached to your device, such as an SD card. By default, the destination filename is the same as the source file.
File Management Commands copy running-config This command copies the running-config to a destination file, or copies a source file into the running-config. Commands entered in the running-config do not survive a device reboot unless they are saved in a configuration file. Syntax copy <source-url>...
File Management Commands copy startup-config This command copies the startup-config script into a destination file, or alternatively copies a configuration script from a source file into the startup-config file. Specify whether the destination is flash or card when loading from the local file system. Syntax copy <source-url>...
File Management Commands copy URL This command copies a file. This allows you to: copy files from your device to a remote device ■ ■ copy files from a remote device to your device copy files stored on flash memory to or from a different memory type, such as an SD card ■...
File Management Commands copy zmodem This command allows you to copy files using ZMODEM using Minicom. ZMODEM works over a serial connection and does not need any interfaces configured to do a file transfer. Syntax copy <source-url> zmodem copy zmodem Parameter Description <source-url>...
File Management Commands delete This command deletes files or directories. Syntax delete [force] [recursive] <url> Parameter Description Ignore nonexistent filenames and never prompt before deletion. force Remove the contents of directories recursively. recursive URL of the file to delete. See “URL Syntax and Keyword Usage”...
File Management Commands This command lists the files on a filesystem. If no directory or file is specified then this command lists the files in the current working directory. Syntax dir [all] [recursive] [<url>|flash|nvs|card|debug] Parameter Description List all files. List the contents of directories recursively. recursive URL of the directory or file.
File Management Commands edit This command opens a text file in the AlliedWare Plus text editor. Once opened you can use the editor to alter to the file. If a filename is specified and it already exists, then the editor opens it in the text editor. If no filename is specified, the editor prompts you for one when you exit it.
File Management Commands edit URL This command opens a remote text file as read-only in the AlliedWare Plus text editor. Before starting the editor make sure your terminal, terminal emulation program, or Telnet client is 100% compatible with a VT100 terminal. The editor uses VT100 control sequences to display text on the terminal.
File Management Commands license These commands enable or disable the specified licensed software feature set. For feature licenses, contact your authorised distributor or reseller. If a license key expires or a proper key is not installed, some software features will not be available.
File Management Commands move This command renames or moves a file. Syntax move <source-url> <destination-url> Parameter Description The URL of the source file. See “URL Syntax and Keyword <source-url> Usage” on page 7.3 for valid URL syntax. The URL of the destination file. See “URL Syntax and Keyword <destination-url>...
File Management Commands move debug This command moves a specified debug file to a destination debug file. Specify whether the destination is Flash or Card when saving the software to the local file system. Syntax move debug {<destination-url>|card|debug|flash|nvs|scp|tftp} {<source-url>|card|debug|flash|nvs|scp|tftp} Parameter Description The URL where you would like the debug output moved to.
File Management Commands rmdir This command removes a directory. The directory must be empty for the command to work unless the optional force keyword is used to remove all subdirectories or files in a directory. Syntax rmdir [force] <url> Parameter Description Optional keyword that allows you to delete any directories that are force...
File Management Commands show boot This command displays the current boot configuration. Syntax show boot Privileged Exec mode Mode Figure 7-1: Example output from the show boot command Output Boot configuration ---------------------------------------------------------------- Current software : r1-5.2.2.rel Current boot image : flash:/r1-5.3.1.rel Backup boot image : flash:/r1-5.2.2.rel Default boot config: flash:/default.cfg...
File Management Commands show file This command displays the contents of a specified file. Syntax show {<filename>|<url>} Parameter Description Name of a file on the local Flash file system. <filename> URL of a file. <url> Privileged Exec mode Mode To display the contents of the file oldconfig.cfg, which is in the current directory, use the Example command: awplus#...
File Management Commands show file systems This command lists the file systems and their utilization information where appropriate. If this command is entered on the stack master, it will list the file systems for all the stack members. A stack member heading is displayed to distinguish the different lists shown for each stack member.
Page 127
File Management Commands Parameters in output of the show file systems command Parameter Meaning The total memory available to this file system. The units are given after Size (B) Available the value and are M for Megabytes or k for kilobytes. Free (B) The total memory free within this file system.
File Management Commands show license This command displays license information about a specified licensed software feature, or all enabled software feature licenses. Syntax show license [<name>|index <index-number>] [brief] Parameter Description The licence name of the software feature to show information <name>...
Page 129
File Management Commands Figure 7-5: Output from the show license brief command awplus>show license brief Software Feature Licenses ------------------------------------------------------------------------ Index License name Quantity Customer name Type Period ------------------------------------------------------------------------ Base License Base License Full ATL-NZ ATL-NZ Full Current enabled features: BGP-64 BGP4+ VRRP OSPF-64...
File Management Commands show running-config This command displays the current configuration of the device. You can control the output in any one of the following ways: ■ To display only lines that contain a particular word, follow the command with | include word ■...
File Management Commands show running-config access-list show running-config access-listCommand vs_531 %flag File Management Commands Use this command to show the running system status and configuration details for access-list. Use this command to show the running system status and configuration details for access-list. For information on output options, see “Controlling “show”...
File Management Commands show running-config bgp show running-config bgp Command vs_531 %flag File Management Commands Use this command to show the running system BGP related configuration. Use this command to show the running system BGP related configuration. For information on output options, see “Controlling “show”...
File Management Commands show running-config community-list show running-config community-listCommand vs_531 %flag File Management Commands Use this command to show the running system status and configuration details for community-list. Use this command to show the running system status and configuration details for community- list For information on output options, see “Controlling “show”...
File Management Commands show running-config full show running-config full Command vs_531 %flag File Management Commands Use this command to show the complete status and configuration of the running system. Use this command to show the complete status and configuration of the running system. For information on output options, see “Controlling “show”...
File Management Commands show running-config interface show running-config interfaceCommand vs_531 %flag File Management Commands This command displays the current configuration of one or more interfaces on the switch. This command displays the current configuration of one or more interfaces on the switch. For information on output options, see “Controlling “show”...
Page 136
File Management Commands Figure 7-12: Example output from a show running-config interface port1.0.2 command Output awplus#sh running-config interface port1.0.2 interface port1.0.2 switchport switchport mode access Figure 7-13: Example output from the show running-config interface command awplus#sh running-config interface interface port1.0.1-1.0.24 switchport switchport mode access interface vlan1...
File Management Commands show running-config ip pim dense-mode show running-config ip pim dense-modeCommand vs_531 %flag File Management Commands Use this command to show the running system status and configuration details for PIM-DM. Use this command to show the running system status and configuration details for PIM-DM. For information on output options, see “Controlling “show”...
File Management Commands show running-config ip route show running-config ipv6 routeCommand vs_531 %flag File Management Commands Use this command to show the running system static IPv4 route configuration. Use this command to show the running system static IPv4 route configuration. For information on output options, see “Controlling “show”...
File Management Commands show running-config ipv6 mroute show running-config ipv6 mrouteCommand vs_531 %flag File Management Commands Use this command to show the running system static IPv6 route configuration. Use this command to show the running system static IPv6 route configuration. For information on output options, see “Controlling “show”...
File Management Commands show running-config ipv6 route show running-config ipv6 routeCommand vs_531 %flag File Management Commands Use this command to show the running system static ip routes configuration. Use this command to show the running system static ip routes configuration. For information on output options, see “Controlling “show”...
File Management Commands show running-config prefix-list show running-config prefix-listCommand vs_531 %flag File Management Commands Use this command to show the running system status and configuration details for prefix-list. Use this command to show the running system status and configuration details for prefix-list. For information on output options, see “Controlling “show”...
File Management Commands show running-config route-map show running-config route-mapCommand vs_531 %flag File Management Commands Use this command to show the running system status and configuration details for route-map. Use this command to show the running system status and configuration details for route-map. For information on output options, see “Controlling “show”...
File Management Commands show running-config router show running-config router Command vs_531 %flag File Management Commands Use the show running-config router command to display the current running configuration for a given router. Use the show running-config router command to display the current running configuration for a given router.
File Management Commands show running-config router-id show running-config router-idCommand vs_531 %flag File Management Commands Use this command to show the running system global router ID configuration. Use this command to show the running system global router ID configuration. For information on output options, see “Controlling “show”...
File Management Commands show running-config switch show running-config switch Command vs_531 %flag File Management Commands Use this command to show the running system status and configuration details for a given switch. Use this command to show the running system status and configuration details for a given switch.
File Management Commands show running-config switch lacp show running-config switch lacpCommand vs_531 %flag File Management Commands Use this command to show the running system LACP related configuration. Use this command to show the running system LACP related configuration. For information on output options, see “Controlling “show”...
File Management Commands show running-config switch vlan show running-config switch vlanCommand vs_531 %flag File Management Commands Use this command to show the running system VLAN related configuration. Use this command to show the running system VLAN related configuration. For information on output options, see “Controlling “show”...
File Management Commands show startup-config This command displays the contents of the start-up configuration file, which is the file that the device runs on start-up. For information on output options, see “Controlling “show” command output” on page 1.30. Syntax show startup-config Privileged Exec mode Mode Figure 7-30: Example output from the show startup-config command...
File Management Commands show version This command displays the version number and copyright details of the current AlliedWare Plus OS your device is running. For information on output options, see “Controlling “show” command output” on page 1.30. Syntax show version Privileged Exec mode and Exec mode Mode Figure 7-31: Example output from the show version command...
File Management Commands write file This command copies the running-config into the file that is set as the current startup-config file. This command is a synonym of the write memory and copy running-config startup-config commands. Syntax write [file] Privileged Exec mode Mode To write configuration data to the start-up configuration file, use the command: Examples...
Page 151
Chapter 8: System Configuration and Monitoring Commands Introduction................................8.2 banner exec ................................8.2 banner login................................8.4 banner motd................................8.5 clock set..................................8.6 clock summer-time date ............................8.7 clock summer-time recurring ..........................8.8 clock timezone ................................8.9 debug nsm................................8.10 debug nsm packet ..............................8.10 hostname .................................8.11 no debug all................................8.12 max-fib-routes ..............................8.12 max-static-routes..............................8.13 service advanced-vty ............................8.13 show clock ................................8.14...
System Configuration and Monitoring Commands Introduction This chapter provides an alphabetized reference of AlliedWare Plus OS commands for configuring and monitoring the system. banner exec This command configures the Exec mode banner that is displayed on the console after you login.
Page 153
System Configuration and Monitoring Commands To remove the Exec mode banner after login, issue the following commands: awplus#configure terminal awplus(config)#banner exec default awplus(config)#exit awplus#exit awplus login: manager Password: awplus> banner login Related Commands banner motd Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1...
System Configuration and Monitoring Commands banner login This command configures the login banner that is displayed on the console when you login. The login banner is displayed on all connected terminals. The login banner is displayed after the MOTD (Message-of-the-Day) banner and before the login username and password prompts. Use the no banner login command to disable the login banner.
System Configuration and Monitoring Commands banner motd This command displays a text MOTD (Message-of-the-Day) banner on login. The MOTD banner is displayed on all connected terminals. The MOTD banner is useful for sending messages that affect all network users, for example, any imminent system shutdowns. Use the no parameter to not display a text MOTD (Message-of-the-Day) banner on login.
System Configuration and Monitoring Commands clock set This command sets the time and date for the system clock. Syntax clock set <hh:mm:ss> <day> <month> <year> Parameter Description Local time in 24-hour format <hh:mm:ss> Day of the current month <day> <1-31> The first three letters of the current month.
System Configuration and Monitoring Commands clock summer-time date This command defines the start and end of summertime for a specific year only, and specifies summertime’s offset value to Standard Time for that year. The no parameter removes the device’s summertime setting. This clears both specific summertime dates and recurring dates (set with the clock summer-time recurring command on page...
System Configuration and Monitoring Commands clock summer-time recurring This command defines the start and end of summertime for every year, and specifies summertime’s offset value to Standard Time. The no parameter removes the device’s summertime setting. This clears both specific summertime dates (set with the clock summer-time date command on page 8.7) and...
System Configuration and Monitoring Commands To remove any summertime settings on the system, use the command: awplus(config)# no clock summer-time clock summer-time date Related Commands clock timezone show clock clock timezone This command defines the device’s clock timezone. The timezone is set as a offset to the UTC. The no parameter resets the system time to UTC.
System Configuration and Monitoring Commands debug nsm This command specifies a set of debug options for use by Allied Telesis authorized service personnel only. Use this command to specify the debug options set for the routing manager. Syntax debug nsm [all|events]...
System Configuration and Monitoring Commands hostname This command sets the name applied to the device as shown at the prompt. The hostname is: displayed in the output of the show system command ■ ■ displayed in the CLI prompt so you know which device you are configuring stored in the MIB object sysName ■...
System Configuration and Monitoring Commands no debug all This command disables the debugging facility for all features on your device. This stops the device from generating any diagnostic debugging messages. The debugging facility is disabled by default. Syntax no debug all Global Configuration mode and Privileged Exec mode.
System Configuration and Monitoring Commands max-static-routes Use this command to set the maximum number of static routes, excluding fib routes. Note that fib routes are set and reset using max-fib-routes. Use the no max-static-routes command to set the maximum number of static routes to the default value of 1000 static routes.
System Configuration and Monitoring Commands show clock This command displays the system’s current configured local time and date. It also displays other clock related information such as timezone and summertime configuration. Syntax show clock Exec and Privileged Exec mode. Mode To display the system’s current local time, use the command: Example awplus#...
System Configuration and Monitoring Commands show cpu This command displays a list of running processes with their CPU utilization. Entering this command on the stack master will display the information of all the stack members. A stack member heading will distinguish the different information for every stack member device.
Page 166
System Configuration and Monitoring Commands Figure 8-2: Example output from the show cpu command Output Stack member 1: CPU averages: 1 second: 5%, 20 seconds: 0%, 60 seconds: 0% System load averages: 1 minute: 0.00, 5 minutes: 0.00, 15 minutes: 0.00 Current CPU load: userspace: 4%, kernel: 1%, interrupts: 0% iowaits: 0% user processes...
Page 167
System Configuration and Monitoring Commands Stack member 3: CPU averages: 1 second: 12%, 20 seconds: 2%, 60 seconds: 2% System load averages: 1 minute: 0.03, 5 minutes: 0.02, 15 minutes: 0.00 Current CPU load: userspace: 6%, kernel: 4%, interrupts: 1% iowaits: 0% user processes ============== pid name...
Page 168
System Configuration and Monitoring Commands Parameter Meaning The ID of the stack member. Displayed if the switch is in a stack. STACK member The average number of processes waiting for CPU time for the periods System load averages stated. Current CPU utilization specified by load types. Current CPU load Average CPU utilization for the periods stated.
System Configuration and Monitoring Commands show cpu history This command prints a graph showing the historical CPU utilization. If this command is entered on the stack master, it will print graphs for all the stack members. A stack member heading will be displayed to distinguish the different graphs for every stack member.
Page 170
System Configuration and Monitoring Commands Figure 8-3: Example output from the show cpu history command Output Stack member 1: Per second CPU load history 10 ************************************************************ |..|..|..|..|..|..|..|..|..|..|..|..Oldest Newest CPU load% per second (last 60 seconds) * = average CPU load% Per minute CPU load history **************************************************** |..|..|..|..|..|..|..|..|..|..|..|..
System Configuration and Monitoring Commands show debugging nsm This command displays system details for use by Allied Telesis authorized service personnel only. Syntax show debugging nsm Exec mode and Privileged Exec mode Mode debug nsm Related Commands Software Reference for SwitchBlade® x908, x900 and x600 Series Switches...
System Configuration and Monitoring Commands show memory This command displays the memory used by each process that is currently running. If this commands is entered on the stack master, it will display corresponding memory utilization information for all the stack members. A stack member heading will be displayed to distinguish the different lists for every stack member.
Page 173
System Configuration and Monitoring Commands Parameter Meaning Total amount of RAM memory free. RAM total Available memory size. free Memory allocated kernel buffers. buffers Identifier number for the process. Short name used to describe the process. name Percentage of memory utilization the process is currently using. mem% Amount of memory currently used by the process.
System Configuration and Monitoring Commands show memory allocations This command displays the memory allocations used by processes. If entered on the stack master, this command will display corresponding memory utilization information for all the stack members. A stack member heading will be displayed to distinguish the different lists for every stack member.
System Configuration and Monitoring Commands show memory history This command prints a graph showing the historical memory usage. If entered on the stack master, this command will display corresponding memory utilization information for all the stack members. A stack member heading will be displayed to distinguish the different lists for every stack member.
Page 176
System Configuration and Monitoring Commands Figure 8-6: Example output from the show memory history command Output STACK member 1: Per minute memory utilization history 40 ************************************************************* |..|..|..|..|..|..|..|..|..|..|..|..Oldest Newest Memory utilization% per minute (last 60 minutes) * = average memory utilisation%. ---------------------------------------------------------------- STACK member 2: Per minute memory utilization history...
System Configuration and Monitoring Commands show memory pools This command shows the memory pools used by processes. Syntax show memory pools [<process>] Parameter Description Displays the memory pools used by the specified process. <process> Exec mode and Privileged Exec mode Mode To shows the memory pools used by processes, use the command: Example...
System Configuration and Monitoring Commands show nsm client This command displays system details for use by Allied Telesis authorized service personnel only. Syntax show nsm client Privileged Exec mode Mode show process This command lists a summary of the current running processes.
System Configuration and Monitoring Commands Parameter Meaning Average CPU load for the given period. CPU load Total memory size. RAM total Available memory. free Memory allocated to kernel buffers. buffers Identifier for the process. Short name to describe the process. name Number of threads in the process.
System Configuration and Monitoring Commands show system This command displays general system information about the device, including the hardware installed, memory, and software versions loaded. It also displays location and contact details when these have been set. For a stacked configuration, if this command is entered on the stack master, it will display the information for all the stack members.
Page 181
System Configuration and Monitoring Commands Figure 8-10: Example output from the show system command for a stacked configuration Stack System Status Tue Aug 7 05:25:09 2007 Stack member 1: Board Board Name Serial number -------------------------------------------------------------------------------- Base x900-24XT 41FY68006 Expansion Bay1 XEM-1XP 41AR65001 Expansion...
System Configuration and Monitoring Commands show system environment This command displays the current environmental status of your device and any attached PSU, XEM, or other expansion option. The environmental status covers information about temperatures, fans, and voltage. For a stacked configuration, if this command is entered on the stack master, it will display the information for all the stack members.
System Configuration and Monitoring Commands show system interrupts Use this command to display the number of interrupts for each IRQ (Interrupt Request) used to interrupt input lines on a PIC (Programmable Interrupt Controller) on your switch. Syntax show system interrupts Parameter Description Show running system information...
System Configuration and Monitoring Commands show system pci device Use this command to display the PCI devices on your switch. Syntax show system pci device Parameter Description Show running system information show system System properties PCI information device PCI device list Exec mode and Privileged Exec mode Mode To display information about the PCI devices on your switch, use the command:...
System Configuration and Monitoring Commands show system pci tree Use this command to display the PCI tree on your switch. Syntax show system pci tree Parameter Description Show running system information show system System properties PCI information tree PCI tree view Exec mode and Privileged Exec mode Mode To display information about the PCI tree on your switch, use the command:...
System Configuration and Monitoring Commands show system pluggable This command displays information about the pluggable LAN connectors, such as SFPs, XFPs, and GBICs, that are currently installed in your device. For a stacked configuration, if this command is entered on the stack master, it will display the information for all the stack members.
System Configuration and Monitoring Commands show tech-support The show tech-support command generates system and debugging information for the switch and saves it to a file. You can optionally limit it to display only information for a given protocol. The command generates a large amount of output and the output is saved into a file. The output file name can be specified by outfile option.
Page 188
System Configuration and Monitoring Commands To capture show output related to IP module and save it to file tech-support-ip.txt.gz on the SD card, use the command: awplus# show tech-support ip outfile card:tech-support-ip.txt.gz To capture the system technical support information, use the command: awplus(config)# show tech-support system The output of this command may include the result of the following commands:...
Page 189
System Configuration and Monitoring Commands show system show system environment show system pluggable show table vlan show users show vlan brief show vrrp show debugging nsm Related Commands Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1 8.39...
System Configuration and Monitoring Commands system territory This command sets the territory of the system. Use the no parameter to return the territory to its default setting of japan. Syntax system territory {australia|nz|europe|japan|usa|china|korea} no system territory Parameter Description System properties system territory Territory of system...
System Configuration and Monitoring Commands undebug nsm This command specifies a set of debug options for use by Allied Telesis authorized service personnel only. This command disables the debugging option for the nsm events. Syntax undebug nsm [all|events] Privileged Exec mode...
Page 192
System Configuration and Monitoring Commands Software Reference for SwitchBlade® x908, x900 and x600 Series Switches 8.42 AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
Chapter 9: Debugging and Logging Introduction................................9.2 Debugging ..................................9.2 Logging to terminal............................9.2 Turning off debugging ..........................9.2 Logging ..................................9.3 Log Outputs ..............................9.3 Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1...
Debugging and Logging Introduction AlliedWare Plus has a comprehensive debugging and logging facility in various protocols and components. This chapter describes how to start/stop debugging and logging. Debugging Many protocols have debug commands. Debug commands, when used with the parameters, log protocol-specific information.
Debugging and Logging Logging Protocols generate important debugging messages by default, and send them to the logging system. Additional more detailed messages can be generated by enabling debugging (“Debugging” on page 9.2). Messages can be filtered based on: the program that generated the message, the severity level of the message, the type of facility that generated the message, substrings within the message text.
Page 196
Debugging and Logging Buffered log The buffered log is a file stored in RAM on the device. Because it is stored in RAM its content does not survive a reboot of the device. A device can only have one instance of the buffered log.
Page 197
Debugging and Logging log permanent size Specify the amount of memory the permanent log may use clear log Remove the contents of the buffered log and permanent log clear log permanent Remove the contents of the permanent log only default log permanent Restore the permanent log to its default configuration Host log...
Page 198
Debugging and Logging The other email log commands are: show log config Displays the configuration of all log outputs log email time Adjust the time information in messages to a time zone other than the one configured on this device Restores the device default settings for log default log email messages sent to an email address.
Logging Commands clear exception log Resets the contents of the exception log. This command does not remove the associated core files. Note: When this command is used within a virtual chassis stack (VCS), it will remove the contents of the exception logs in all stack members. Syntax clear exception log Parameter...
Logging Commands clear log buffered Removes the contents of the buffered log. Note: When this command is used within a virtual chassis stack (VCS), it will remove the contents of the buffered logs in all stack members. Syntax clear log buffered Parameter Description Remove dynamic information...
Logging Commands clear log permanent Removes the contents of the permanent log. Note: When this command is used within a virtual chassis stack (VCS), it will remove the contents of the permanent logs in all stack members. Syntax clear log permanent Parameter Description Remove dynamic information...
Logging Commands default log buffered Restores the default settings for the buffered log stored in RAM. By default the size of the buffered log is 50 kB and it accepts messages with the severity level of "warnings" and above. The buffered log is enabled by default. Syntax default log buffered Parameter...
Logging Commands default log console Restores the default settings for log messages sent to the terminal when a log console command is issued. By default all messages are sent to the console when a log console command is issued. Syntax default log console Parameter Description...
Logging Commands default log host Restores the default settings for log sent to a remote syslog server. By default no filters are defined for remote syslog servers. Filters must be defined before messages will be sent. Also restores the remote syslog server time offset value to local (no offset). Syntax default log host <ip-address>...
Logging Commands default log monitor Restores the default settings for log messages sent to the terminal when a terminal monitor command is issued. By default all messages are sent to the terminal when a terminal monitor command is issued. Syntax default log monitor Parameter Description...
Logging Commands exception coredump size Core files are generated when a process crashes. The size of a core file can vary, its upper limit is controlled by this command. Files larger than this limit will be truncated by reducing the amount of stack and variable information stored.
Logging Commands log buffered Configures the device to store log messages in RAM. Messages stored in RAM are not retained on the device over a restart. Once the buffered log reaches its configured maximum allowable size old messages will be deleted to make way for new ones. The buffered log is configured by default.
Logging Commands log buffered (filter) Use this command to create a filter to select messages to be sent to the buffered log. Selection can be based on the priority/ severity of the message, the program that generated the message, the logging facility used, a sub-string within the message or a combination of some or all of these.
Page 210
Logging Commands Parameter (Cont) Description (Cont) Filter messages to the buffered log by program. Include messages from program a specified program in the buffered log. The name of a program to log messages from, either one of the <program-name> following predefined program names (not case-sensitive), or another program name (case -sensitive) that you find in the log output.
Logging Commands To add a filter to send all messages generated by BGP that have a severity of "notices" or higher Examples to the buffered log use the command: awplus(config)# log buffered level notices program bgp To add a filter to send all messages containing the text "Bridging initialization", to the buffered log use the command: awplus(config)# log buffered msgtext Bridging initialization...
Logging Commands log console Configures the device to send log messages to consoles. The console log is configured by default to send messages to the devices main console port. Use the no version of this command to configure the device not to send log messages to consoles.
Logging Commands log console (filter) Creates a filter to select messages to be sent to all consoles when the log console command is given. Selection can be based on the priority/severity of the message, the program that generated the message, the logging facility used, a sub-string within the message or a combination of some or all of these.
Page 214
Logging Commands Parameter (Cont) Description (Cont) Filter messages by program. Include messages from a specified program. program The name of a program to log messages from, either one of the following <program- name> predefined program names (not case-sensitive), or another program name (case -sensitive) that you find in the log output.
Logging Commands To create a filter to send all messages containing the text "Bridging initialization" to console instances where the log console command has been given use the command: awplus(config)# log console msgtext "Bridging initialization" To remove a filter that sends all messages generated by BGP that have a severity of "notices" or higher to consoles use the command: awplus(config)# no log console level notices program bgp...
Logging Commands log email (filter) Creates a filter to select messages to be sent to an email address. Selection can be based on the priority/ severity of the message, the program that generated the message, the logging facility used, a sub-string within the message or a combination of some or all of these. The no log email to command configures the device to no longer send log messages to a specified email address.
Page 217
Logging Commands Parameter (Cont) Description (Cont) Filter messages by program. Include messages from a specified program program in the log. The name of a program to log messages from, either one of the <program-name> following predefined program names (not case-sensitive), or another program name (case -sensitive) that you find in the log output.
Page 218
Logging Commands To create a filter to send all messages containing the text "Bridging initialization", to the email address admin@homebase.com use the command: awplus(config)# log email admin@homebase.com msgtext "Bridging initialization" To create a filter to send messages with a severity level of "informational" and above to the email address admin@alliedtelesis.com use the command: awplus(config)# log email admin@alliedtelesis.com level informational...
Logging Commands log email time Configures the time used in messages sent to an email address. Use local if the email recipient is in the same time zone as this device. Messages will display the time as on the local device when the message was generated.
Logging Commands log host Configures the device to send log messages to a remote syslog server via UDP port 514. The IP address of the remote server must be specified. By default no filters are defined for remote syslog servers. Filters must be defined before messages will be sent. Syntax log host <ip-address>...
Logging Commands log host (filter) Creates a filter to select messages to be sent to a remote syslog server. Selection can be based on the priority/severity of the message, the program that generated the message, the logging facility used, a substring within the message or a combination of some or all of these. The no log host command configures the device to no longer send log messages to a remote syslog server.
Page 222
Logging Commands Parameter (Cont) Description (Cont) Filter messages by program. Include messages from a specified program in program the log. The name of a program to log messages from, either one of the following <program- name> predefined program names (not case-sensitive), or another program name (case -sensitive) that you find in the log output.
Page 223
Logging Commands To create a filter to send all messages containing the text "Bridging initialization", to a remote syslog server with IP address 10.32.16.21 use the command: awplus(config)# log host 10.32.16.21 msgtext "Bridging initialization" To create a filter to send messages with a severity level of "informational" and above to the syslog server with IP address 10.32.16.21 use the command: awplus(config)# log host 10.32.16.21 level informational...
Logging Commands log host time Configures the time used in messages sent to a remote syslog server. Use local if the syslog server is in the same time zone as this device. Messages will display the time as on the local device when the message was generated.
Logging Commands log monitor (filter) Creates a filter to select messages to be sent to the terminal when the terminal monitor command is given. Selection can be based on the priority/severity of the message, the program that generated the message, the logging facility used, a sub-string within the message or a combination of some or all of these.
Page 226
Logging Commands Parameter (Cont) Description (Cont) Filter messages to the permanent log by program. Include messages from a program specified program in the log. The name of a program to log messages from, either one of the following <program- name> predefined program names (not case-sensitive), or another program name (case -sensitive) that you find in the log output.
Logging Commands To remove a filter that sends all messages generated by BGP that have a severity of "notices" or higher to the terminal use the command: awplus(config)# no log monitor level notices program bgp To remove a default filter that include everything sending to the terminal use the command: awplus(config)# no log monitor level debugging show log config...
Logging Commands log permanent (filter) This command creates a filter to select messages to be sent to the permanent log. Selection can be based on the priority/ severity of the message, the program that generated the message, the logging facility used, a sub-string within the message or a combination of some or all of these.
Page 229
Logging Commands Parameter (Cont) Description (Cont) Filter messages to the permanent log by program. Include messages from a program specified program in the log. The name of a program to log messages from, either one of the following <program- name> predefined program names (not case-sensitive), or another program name (case -sensitive) that you find in the log output.
Page 230
Logging Commands To create a filter to send all messages containing the text "Bridging initialization", to the permanent log use the command: awplus(config)# log permanent msgtext Bridging initialization show log config Validation Commands default log permanent Related Commands log permanent log permanent size show log permanent Software Reference for SwitchBlade®...
Logging Commands log permanent size Configures the amount of memory that the permanent log is permitted to use. Once this memory allocation has been filled old messages will be deleted to make room for new messages. Syntax log permanent size <50-250> Parameter Description Logging control...
Logging Commands show log Displays the contents of the buffered log. By default the entire contents of the buffered log is displayed. If the optional "tail" parameter is specified only the latest 10 messages in the buffered log are displayed. A numerical value can be specified after the "tail" parameter to select how many of the latest messages should be displayed.
Logging Commands show log config Related Commands show log permanent show log config Displays information about the logging system. This includes the configuration of the various log destinations, buffered, permanent, syslog servers (hosts) and email addresses. It also displays the latest status information for each of these destinations.
Page 234
Logging Commands In the above example the ’’ next to filter 1 in the buffered log configuration indicates that this is the default filter. The permanent log has had its default filter removed, so none of the filters are marked with ’’. Note: Statistics are updated periodically, not in real time.
Logging Commands show log permanent Displays the contents of the permanent log. If the optional "tail" parameter is specified only the latest 10 messages in the permanent log are displayed. A numerical value can be specified after the "tail" parameter to select how many of the latest messages should be displayed. Note: When this command is used within a virtual chassis stack (VCS), it will display the permanent log information for all stack members.
Logging Commands To display the contents of the permanent log use the command: Examples awplus# show log permanent show running-config log This command displays the current running configuration of the Log utility. Syntax show running-config log Parameter Description Show running-config information show Current operating configuration running-...
Chapter 11: Scripting Commands activate ..................................11.2 echo....................................11.3 Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1 11.1...
Page 238
Scripting Commands activate This command activates a script file. Syntax activate [background] <script> Parameter Description Activate a script activate background Activate a script to run in the background. A process that is running in the background will operate as a separate task, and will not interrupt foreground processing.
Page 239
Scripting Commands echo This command echoes a string to the terminal, followed by a blank line. It is useful in CLI scripts, to make the script print user-visible comments. Syntax echo <line> Parameter Description Echo a string echo The string to echo. <line>...
Page 240
Scripting Commands Software Reference for SwitchBlade® x908, x900 and x600 Series Switches 11.4 AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
Page 241
Chapter 12: Interface Commands Introduction................................12.2 description................................12.2 interface..................................12.3 mtu ....................................12.4 show interface...............................12.5 show interface brief ............................12.6 shutdown.................................12.7 Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1 12.1...
Interface Commands Introduction This chapter provides an alphabetical reference of commands used to configure and display interfaces. description This command adds a description to a specific port or interface. Syntax description <description> Parameter Description Text describing the specific interface. <description> Interface mode Mode The following example uses this command to describe the device that a switch port is...
Interface Commands interface Use this command to select one or more interfaces to configure. Syntax interface <interface-list> interface lo Parameter Description The interfaces or ports to configure. An interface-list can be: <interface- list> an interface, a switch port, or a channel group (e.g., vlan2, port1.1.12, ■...
Interface Commands Use this command to set the Maximum Transmission Unit (MTU) size for a VLAN interface. Use the no command to remove a previously specified Maximum Transmission Unit (MTU) size for a VLAN interface. Syntax mtu <mtu_size> no mtu Parameter Description <mtu_size>...
Interface Commands show interface Use this command to display interface configuration and status. Syntax show interface [<interface-list>] Parameter Description The interfaces or switch ports to display information about. An interface- <interface- list> list can be: an interface, a switch port, or a channel group (e.g., vlan2, port1.1.12, ■...
Interface Commands show interface brief Use this command to display brief interface configuration and status. Syntax show interface brief Parameter Description Brief summary of interface status and configuration. brief Exec mode and Privileged Exec mode Mode Figure 12-2: Example output from the show interface brief command Output...
Interface Commands shutdown This command shuts down the selected interface. This administratively disables the link and takes the link down at the physical (electrical) layer. Use the no form of this command to disable this function and therefore to bring the link back up again.
Page 248
Interface Commands Software Reference for SwitchBlade® x908, x900 and x600 Series Switches 12.8 AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
Page 249
Chapter 13: Interface Testing Commands Introduction................................13.2 clear test interface ..............................13.2 service test ................................13.3 test interface ................................13.4 Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1 13.1...
Interface Testing Commands Introduction This chapter provides an alphabetical reference of AlliedWare Plus OS commands for testing interfaces. clear test interface This command clears test results and counters after issuing a test interface command. Test results and counters must be cleared to issue subsequent test interface commands later on. Syntax clear test interface {<port-list>|all} Parameter...
Interface Testing Commands service test This command puts the device into the interface testing state, ready to begin testing. After entering this command, enter Interface Configuration mode for the desired interfaces and enter the command test interface. Do not test interfaces on a device that is part of a live network—disconnect the device first. Use the no parameter to stop the test service.
Interface Testing Commands test interface This command starts a test on an interface or all interfaces or a selected range or list of interfaces. Use the no form of this command to disable this function. The test duration can be configured by specifying the time in minutes after specifying an interface or interfaces to test.
Page 253
Interface Testing Commands To see the output, use the commands: awplus# show test awplus# show test count To start the test on all interfaces for 1 minute use the command: awplus# test interface all time 1 To start the test on ports 1 to 12 for XEM 1 (port1.1.1 through port1.1.12) use the command: awplus# test interface port1.1.1-port1.1.12 To stop testing ports 1 to 12 for XEM 1 (port1.1.1 through port1.1.12) use the command:...
Page 254
Interface Testing Commands Software Reference for SwitchBlade® x908, x900 and x600 Series Switches 13.6 AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
Switching Introduction Introduction This chapter gives an overview of Layer 1 and 2 switching. Layer 2 switches are used to connect multiple Local Area Network (LAN) segments together to form an extended LAN. Stations connected to different LANs can be configured to communicate with one another as if they were on the same LAN.
Switching Introduction Physical Layer Information Switch Ports A unique port number identifies each switch port. The software supports a number of features at the physical level that allow it to be connected in a variety of physical networks. This physical layer (layer 1) versatility includes: ■...
Switching Introduction Activating and Deactivating Switch Ports An active switch port is one that is available for packet reception and transmission. Disabling a switch port does not affect the STP operation on the port. By default ports and VLANs are activated.
Switching Introduction Make sure that the configuration of the switch matches the configuration of the device at the far end of the link. In particular, avoid having one end autonegotiate duplex mode while the other end is fixed. For example, if you set one end of a link to autonegotiate and fix the other end at full duplex, the autonegotiating end cannot determine that the fixed end is full duplex capable.
Page 262
Switching Introduction Configuring MDI MDIX Although switch ports are set to MDIX by default, you can reconfigure them by using the polarity command on page 15.23. To set the MDI/MDIX mode for port 1.0.1 Enter the config terminal mode. awplus#configure terminal Enter the Config-Interface mode to awplus(config-if)#configure interface port1.0.1...
Switching Introduction The Layer 2 Switching Process The Layer 2 switching process comprises these related but separate processes: The Ingress Rules ■ ■ The Learning Process The Forwarding Process ■ ■ The Egress Rules Ingress rules admit or discard frames based on their VLAN tagging. The Learning process learns the MAC addresses and VLAN membership of frames admitted on each port.
Switching Introduction Access Mode This mode can be used to connect to VLAN unaware devices. Frames to and from access mode ports carry no VLAN tagging information. Trunk Mode This mode is used to connect VLAN capable devices. All devices that connect using trunk mode ports must be VLAN aware.
Switching Introduction The Forwarding Process After a VID is assigned to a frame using the ingress rules, the switch forwards it to the destination MAC address specified in the frame. To do this the switch must learn which MAC addresses are available on each port for each VLAN. When the destination MAC address is not found, the switch floods the frame on all ports that are members of the VLAN except the port on which the frame was received.
Switching Introduction Layer 2 Filtering The switch has a forwarding database (also known as the MAC address table) whose entries determine whether frames are forwarded or discarded over each port. Entries in the forwarding database are created dynamically by the learning process. A dynamic entry is automatically deleted from the forwarding database when its ageing timer expires.
Switching Introduction Channel Groups (Link Aggregation) Channels (either static or dynamic—LACP) increase channel reliability by distributing the data path over more than one physical link. Channels must be configured on both ends of a link or network loops may result. Ports in a channel group need not be contiguous. A mirror port cannot be a member of either a static or a dynamic channel group.
Page 268
Switching Introduction Link Aggregation Control Protocol (LACP) LACP operates where systems are connected over multiple communications links. Once LACP has been initially configured and enabled, it automatically creates Ether-channels and assigns appropriate links to their membership. LACP continues to monitor these groups and dynamically adds or removes links to them as network changes occur.
Switching Introduction Storm Control The packet storm protection feature enables you to set limits on the reception rate of broadcast, multicast frames and destination lookup failures. You can set separate limits beyond which each of the different packet types are discarded. Note: A destination lookup failure (DLF) is the event of receiving a unicast Ethernet frame with an unknown destination address.
Switching Introduction Loop Protection Loop protection is a general term that embraces several different methods you can apply to protect your network from effects such as broadcast storms that can result from data loops or equipment malfunction. Presently two methods of loop protection are available: ■...
Switching Introduction Configuration To enable loop protection and configure its basic parameters, you use the loop-protection command on page 15.9. To enable the loop-detect mechanism, and generate loop-detect frames once every 5 seconds, Example use the command: awplus(config) # loop-protection loop-detect ldf-interval 5 Note: LDFs are sent sequentially for each VLAN defined to a particular port.
Switching Introduction To set a thrash action for a port, use the thrash-limiting command on page 15.44: To view the thrash action that is set for a port, use the show interface switchport command on page 15.25: Re-enabling a When a port is disabled, either completely or for a specific VLAN, it remains disabled until it is port manually re-enabled in any of the following ways: ■...
Switching Introduction Port Mirroring Port mirroring enables traffic being received and transmitted on a switch port to be sent to another switch port, the mirror port, usually for the purposes of capturing the data with a protocol analyzer. The mirror port is the only switch port that does not belong to a VLAN, and therefore does not participate in any other switching.
Switching Introduction Quality of Service Quality of Service (QoS) enables you to both prioritize traffic and limit its available bandwidth. The concept of QoS is a departure from the original networking protocols, in which all traffic on the Internet or within a LAN had the same available bandwidth. Without QoS, all traffic types are equally likely to be dropped if a link becomes oversubscribed.
Switching Introduction IGMP Snooping IGMP (Internet Group Management Protocol) is used by IP hosts to report their multicast group memberships to routers and switches. IP hosts join a multicast group to receive broadcast messages directed to the multicast group address. IGMP is an IP-based protocol and uses IP addresses to identify both the multicast groups and the host members.
Page 276
Switching Introduction Software Reference for SwitchBlade® x908, x900 and x600 Series Switches 14.20 AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
Page 277
Chapter 15: Switching Commands Introduction................................15.2 clear loop-protection counters........................15.2 clear mac address-table static ........................15.3 clear mac address-table dynamic .......................15.4 clear port counter...............................15.5 debug platform packet.............................15.6 duplex..................................15.7 flowcontrol................................15.8 loop-protection..............................15.9 loop-protection action..........................15.10 loop-protection timeout..........................15.11 mac address-table acquire .......................... 15.11 mac address-table ageing-time......................... 15.12 mac address-table static ..........................
Switching Commands Introduction This chapter provides an alphabetized reference for each of the Switching Commands. clear loop-protection counters clear loop-protection countersCommand vs_531 %flag Switching Commands This is one of several new loop protection commands. Use this command to clear the counters for the Loop Protection counters. Syntax clear loop-protection [interface <ifrange>] counters Parameters...
Switching Commands clear mac address-table static Use this command to: clear all filtering database entries configured through CLI (static) ■ ■ clear all static database entries based on a mac address Syntax clear mac address-table static [address <mac-address>|vlan <vid>| interface <port>] Parameter Description Filtering database entries for the given VLAN.
Switching Commands clear mac address-table dynamic Use this command to clear the filtering database of all entries learned for a given MAC address, interface or VLAN. Syntax clear mac address-table dynamic [address <mac-address>|vlan <vid>| interface <port>] Parameter Description Filtering database entries for the given port. interface when filtering database entries are cleared based on VLANs.
Switching Commands clear port counter Clears the packet counters of the port. Syntax clear port counter [<port>] Parameter Description The port number or range <port> Exec mode and Privileged Exec mode Mode To clear the packet counter for port1.0.1 Example awplus# clear port counter port1.0.1 show platform table port...
Switching Commands debug platform packet This command enables platform to CPU level packet debug. This command can be used to trace packets sent and received by the CPU. If a timeout is not specified, then a default 5 minute timeout will be applied. If a timeout of 0 is specified, packet debug will be generated until the no debug platform packet command is used or another timeout value is specified.
Switching Commands duplex This command changes the duplex mode for the specified port. By default, ports auto-negotiate duplex mode (except for 100Base-FX ports which do not support auto-negotiation, so default to full duplex mode). To see the currently-negotiated duplex mode for ports whose links are up, use the command show interface.
Switching Commands flowcontrol Use this command to enable or disable flow control for the port. Syntax flowcontrol receive on flowcontrol receive off Parameter Description When the port receives pause frames, it temporarily stops (pauses) receive sending traffic. Enable the specified flow control. Disable the specified flow control.
Switching Commands loop-protection loop-protection Command vs_531 %flag Switching Commands This command enables the Loop Protection - loop detection - feature, and configures the detection mechanism parameters. Use this command to enable the Loop Protection - loop detection - feature, and configure the detection mechanism parameters.
Switching Commands loop-protection action loop-protection action Command vs_531 %flag Switching Commands This command to specify the protective action to apply when a network loop is detected. This command specifies the protective action to apply when a network loop is detected. Syntax loop-protection action {learn-disable|link-down|log-only| port-disable|vlan-disable|none}...
Switching Commands loop-protection timeout loop-protection timeout Command vs_531 %flag Switching Commands This command specifies the Loop Protection recovery action duration. Use this command to specify the Loop Protection recovery action duration. Syntax loop-protection timeout <duration> no loop-protection timeout Parameter Description The time (in seconds) for which the configured action will apply before <duration>...
Switching Commands mac address-table ageing-time Use this command to specify an ageing-out time for a learned MAC address. The learned MAC address will persist for at least the specified time. Syntax mac address-table ageing-time <ageing-timer> none no mac address-table ageing-time Parameter Description <10-1000000>...
Switching Commands mac address-table static Use this command to statically configure the MAC address-table to forward or discard frames with a matching destination MAC address. Syntax mac address-table static <mac-addr> {forward|discard} interface <port> [vlan <vid>] no mac address-table static <mac-addr> {forward|discard} interface <port>...
Switching Commands mac address-table thrash-limit Use this command to set the thrash limit on the switch or stack. Thrashing occurs when a MAC address table rapidly “flips” its mapping of a single MAC address between two subnets, usually as a result of a network loop. Syntax mac address-table thrash-limit <rate>...
Switching Commands mirror interface Use this command to define a mirror port and mirrored (monitored) ports and direction of traffic to be mirrored. The port for which you enter interface mode will be the mirror port. The destination port is removed from all VLANs, and no longer participates in other switching. Use the no parameter with this command to disable port mirroring by the destination port on the specified source port.
Switching Commands platform bist This command performs a self test on the switch. This command tests the ASIC (Application Specific Integrated Circuit) memory. Syntax platform bist instance {<0-127>|all} [full] Parameter Description ASIC (Application Specific Integrated Circuit) instance instance ASIC instance number <0-127>...
Switching Commands platform control-plane-prioritization rate The CPU protection feature ensures that different traffic types can share the CPU effectively. Use this command to set the maximum traffic rate on the CPU port to limit the CPU getting overloaded with unnecessary data packets that may result in poor performance of the control plane, for example, CLI console lock up or control packet loss following a broadcast storm.
Page 294
Switching Commands Confirm the maximum traffic rate has been configured using the following show command: awplus#show platform Load Balancing srt-dst-mac, src-dst-ip Control-plane-prioritization Max 10 Mbps Jumboframe support Enhanced mode qos counters Vlan-stacking TPID 0x8100 Reset the maximum traffic rate on the CPU port to 60 Mbps using the following no command: awplus(config)# no platform control-plane-prioritization show platform...
Switching Commands platform enhancedmode This command rearranges memory in the silicon so that it can either store QoS traffic class counters, or store a greater number of routes than usual. For the enhanced mode to take effect, you must restart the device after entering this command. The switch remains in enhanced mode until you change it with a no platform enhancedmode.
Switching Commands platform jumboframe This command enables the device to forward jumbo frames. For more information, see “Support for Jumbo Frames” on page 14.16. When jumbo frame support is enabled, the maximum size of packets that the device can forward is: ■...
Switching Commands platform load-balancing This command selects which packet fields are used in the channel load balancing algorithm. Use the no platform load-balancing command to restrict the default choice of packet fields in the channel load balancing algorithm. The load balancing algorithm determines the member port of a channel group when the packet is destined for a port within a channel.
Switching Commands platform routingratio Syntax platform routingratio {ipv4only|ipv4andipv6} This command changes the amount of memory allocated to IPv4 routing tables relative to IPv6 Description routing tables. The switching hardware contains memory that it uses to store tables of routes and nexthop addresses.
Switching Commands platform vlan-stacking-tpid This command specifies the Tag Protocol Identifier (TPID) value that applies to all frames that are carrying double tagged VLANs. All nested VLANs must use the same TPID value. (This feature is sometimes referred to as VLAN stacking or VLAN double-tagging.) Note: Because the additional tag increases the frame size beyond 1522 bytes, you must turn on Jumbo frames to activate VLAN-stacking.
Switching Commands show flowcontrol interface Use this command to display flow control information. Syntax show flowcontrol interface <ifname> Parameter Description Specifies the name of the interface to be displayed. <ifname> Exec and Privileged Exec mode Mode Figure 15-1: Example output from the show flowcontrol interface command for a specific Output interface Port...
Switching Commands show interface switchport Use this command to display VLAN information about each switch port. Syntax show interface switchport Exec and Privileged Exec mode Mode Example awplus# show interface switchport The following is an output of this command displaying the characteristics of this switch ports. Output awplus#show interface switchport Interface name...
Switching Commands show loop-protection show loop-protection Command vs_531 %flag Switching Commands This command displays the current loop protection setup for the device. Use this command to display the current loop protection setup for the device. Syntax show loop-protection [interface <ifrange>] [counters] Parameter Description The interface selected for display.
Switching Commands show mac address-table Use this command to display the mac address-table for all configured VLANs. Syntax show mac address-table Exec and Privileged Exec mode Mode The show mac address-table command is only applicable to view a mac address-table for Usage layer 2 switched traffic within VLANs.
Page 304
Switching Commands Also note manually configured static mac-addresses are shown to the right of the type column: awplus(config)#mac address-table static 0000.1111.2222 for int port1.0.11 vlan 2 awplus(config)#end awplus# awplus#show mac address-table VLAN port type unknown 0000.cd28.0752 forward static port1.0.9 0030.846e.bac7 forward dynamic port1.0.11...
Switching Commands show mac address-table thrash-limit Use this command to display the current thrash limit set for all interfaces on the device. Syntax show mac address-table thrash-limit Exec mode and Privileged Exec mode Mode To display the current, use the command: Example awplus# show mac address-table thrash-limit...
Switching Commands show mirror interface Use this command to display port mirroring configuration for a mirrored (monitored) switch port. Syntax show mirror interface <port> Parameter Description The monitored switch port to display information about. <port> Interface, Privileged Exec and Exec mode Mode To display port mirroring configuration for the port1.0.4, use the command: Example...
Switching Commands show platform This command displays the settings configured using the platform commands. Syntax show platform Exec and Privileged Exec modes Mode To check whether the device accepts jumbo frames, use the command: Example awplus# show platform Figure 15-6: Example output from the show platform command Output Control-plane-prioritization Max 60 Mbps Jumboframe support...
Switching Commands show platform bist This command displays the result of a previously run BIST (Built In Self Test) on the switch. Syntax show platform bist Parameter Description Show running system information show Show platform global settings or self-test results platform Display the BIST (Built In Self Test) bist...
Switching Commands show platform table port This command displays the various port registers for specified ports. Syntax show platform table port [<port-list>|counters] Parameter Description show the platform table show platform show the platform table show the platform table table port show the ports The ports to display information about.
Switching Commands show port-security interface Shows the current configuration and the switch port status. Syntax show port-security interface <port> Parameter Description Show running system information show Port Security port-security Interface interface The port to display information about. The port may be a switch port <port>...
Switching Commands show port-security intrusion Shows the intrusion list. If the port is not give, entire intrusion table is shown. Syntax show port-security intrusion [interface <port>] Parameter Description Show running system information show Port Security port-security Display intrusion list intrusion Specify a port interface The port to display information about.
Switching Commands show storm-control Use this command to display storm control information for all interfaces or a particular interface. Syntax show storm-control [<port>] Parameter Description The port to display information about. The port may be a switch port (e.g., <port> port1.1.4), a static channel group (e.g., sa3), or an LACP channel group (e.g., po4).
Switching Commands speed This command changes the speed of the specified port. By default, ports auto-negotiate speed (except for 100Base-FX ports which do not support auto-negotiation, so default to 100M). To see the currently-negotiated speed for ports whose links are up, use the command show interface.
Switching Commands storm-control level Use this command to specify the threshold level for broadcasting, multicast, or destination lookup failure (DLF) traffic for the port. Storm control limits the specified traffic type to the specified threshold. Use the no parameter with this command to disable storm control for broadcast, multicast or DLF traffic.
Switching Commands switchport enable vlan Enables you to manually re-enable a port in a VLAN. Syntax switchport enable vlan [<1-4094>] Parameter Description Switchport switchport enable Re-enables the vlan on the port Re-enables the vlan on the port vlan <1-4094> VLAN ID The default VLAN is VLAN ID 1 Default Interface mode...
Switching Commands switchport port-security aging Sets the port-security MAC to time out. Use the no switchport port-security aging command to set the port-security to not time out. Syntax switchport port-security aging no switchport port-security aging Parameter Description Negate a command or set its defaults Set the switching characteristics of the Layer2 interface switchport port-security...
Switching Commands switchport port-security maximum Sets the maximum MAC address that each port can learn. Use the no switchport port-security maximum command to unset the maximum number of MAC addresses that each port can learn. This is same as setting the maximum number to 0.
Switching Commands switchport port-security violation Sets the violation action for a switch port. The port action can be either shutdown, restrict or protect. If shutdown is set, the physical link will be disabled and "shutdown" will be shown in the config. If restrict is set, the packet from the un-authorized MAC will be discarded and SNMP TRAP will be generated to alert management.
Switching Commands thrash-limiting Sets and configures the thrash limit action that will be applied to any port on the switch when a thrashing condition is detected. The thrash-limiting timeout specifies the time, in seconds, for which the thrash action is employed. Syntax thrash-limiting {[action {learn-disable|link-down|port-disable| vlan-disable|none}][timeout <0-86400>]}...
Page 321
Chapter 16: VLAN Introduction Introduction................................16.2 Configuring VLANs ...........................16.3 VLAN Double Tagging (VLAN Stacking) .....................16.5 How double-tagged VLANs work ....................16.5 VLAN Rules for Double Tagging.......................16.5 Restrictions when using Double-Tagged VLANs..............16.6 Configuring Double-Tagged VLANs ....................16.6 Private VLANs ..............................16.8 Membership Rules .............................16.8 Promiscuous Ports .............................16.9 Host Ports ..............................16.9 Private VLAN Operation........................
VLAN Introduction Introduction A Virtual LAN (VLAN) is a logical, software-defined subnetwork. It allows similar devices on the network to be grouped together into one broadcast domain, irrespective of their physical position in the network. Multiple VLANs can be used to group workstations, servers, and other network equipment connected to the switch, according to similar data and security requirements.
VLAN Introduction Configuring VLANs Defaults By default, all switch ports are in access mode, are associated with the default VLAN (vlan1), and have ingress filtering on. You cannot delete vlan1. VLAN names When you create a VLAN (vlan command on page 17.17), you give it a numerical VLAN Identifier (VID)—a number from 2 to 4094, which is included in VLAN-tagged Ethernet frames to and from this VLAN.
Page 324
VLAN Introduction Prompt Command Description Associate switch ports with VLANs interface <port-list> Associate switch ports in access mode with awplus(config-vlan)# VLANs: switchport access vlan <vlan-id> awplus(config-if)# Enter Interface Configuration mode for the ■ switch ports that will be in access mode for a particular VLAN.
VLAN Introduction VLAN Double Tagging (VLAN Stacking) VLAN double tagging, also known as VLAN Stacking, Nested VLANs, or Q-in-Q VLANs, are used to operate a number of private Layer 2 networks within a single public Layer 2 network. This feature provides simple access infrastructure for network service providers to operate Metropolitan Area Networks (MANs) as commercial value added networks.
Configuring Double-Tagged VLANs You need a special feature licence to use double-tagged VLANs. Contact your authorized Allied Telesis distributor or reseller for more information. Turn on Jumbo frame support Adding the S-Tag can result in frame sizes that exceed the maximum of 1522 bytes. In order to cope with these larger than normal frames, you should turn on Jumbo packet support on all devices running within the service provider network.
Page 327
VLAN Introduction Step 3: Configure port 1.0.3 as a customer edge port member of VLAN 10. awplus# configure terminal awplus(config)# interface port port1.0.3 awplus(config)# switchport mode access awplus(config)# switchport access vlan 10 awplus(config-if)# switchport vlan-stacking customer-edge-port Step 4: Configure port 1.0.4 as a customer edge port member of VLAN 20. awplus# configure terminal awplus(config)#...
VLAN Introduction Private VLANs Private VLANs combine the network advantages of conventional VLANs, with an added degree of privacy obtained by limiting the connectivity between selected ports. An example application of a private VLAN would be a library in which user booths each have a PC with Internet access.
VLAN Introduction A host port: ■ can be a member of multiple private (community) VLANs, but all these VLANs must share the same promiscuous port ■ cannot be a host port in some VLANs and a non-host port in others ■...
VLAN Introduction Private VLAN Operation A basic private VLAN operation is shown in Figure 16-1. It comprises primary VLAN 20 plus three secondary VLANS, two community VLANs 21 and 22, and an isolated VLAN 21. Figure 16-1: Private VLAN Internet Server Promiscuous Port 1.0.1...
VLAN Introduction Private VLANs operate within a single switch and comprise one primary VLAN plus a number of secondary VLANS. All data enters the private VLAN ports untagged. Using the example of figure Figure 16-1, data enters the switch via the promiscuous port 1.0.1 and is forwarded to the host ports using VLAN 20, the primary VLAN.
Page 332
VLAN Introduction Step 3: Associate the secondary VLANs with the primary VLAN awplus(config-vlan)# private-vlan 20 association add 21 awplus(config-vlan)# private-vlan 20 association add 22 awplus(config-vlan)# private-vlan 20 association add 23 Step 4: Set port 1.0.1 to be the promiscuous port. Note that you must first return to the prompt.
Page 333
Chapter 17: VLAN Commands Introduction................................17.2 private-vlan ................................17.2 private-vlan association............................17.3 show vlan.................................17.4 show vlan classifier group..........................17.5 show vlan classifier interface group ......................17.5 show vlan classifier rule ...........................17.6 show vlan private-vlan............................17.6 switchport access vlan............................17.7 switchport enable vlan .............................17.8 switchport mode access ..........................17.9 switchport mode private-vlan........................
VLAN Commands Introduction This chapter provides an alphabetized reference for each of the VLAN Commands. private-vlan Use this command to a create a private VLAN. Private VLANs can be either primary or secondary. Secondary VLANs can be ether community or isolated. Use the no form of this command to remove the specified private vlan.
VLAN Commands private-vlan association Use this command to associate a secondary VLAN to a primary VLAN. Only one isolated VLAN can be associated to a primary VLAN. Multiple community VLANs can be associated to a primary VLAN. Use the no form of this command to remove association of all the secondary VLANs to a primary VLAN.
VLAN Commands show vlan Use this command to display information about a particular VLAN by specifying the VLAN ID. It displays information for all the VLANs configured. Syntax show vlan {all|brief|dynamic|static|<1-4094>} Parameter Description Display information about the VLAN specified by the VLAN ID. <1-4094>...
VLAN Commands show vlan classifier group Use this command to display information about all configured VLAN classifier groups or a specific group. Syntax show vlan classifier group [<1-16>] Parameter Description VLAN classifier group identifier <1-16> Exec mode and Privileged Exec mode Mode If a group ID is not specified, all configured VLAN classifier groups are shown.
VLAN Commands show vlan classifier rule Use this command to display information about all configured VLAN classifier rules or a specific rule. Syntax show vlan classifier rule [<1-256>] Parameter Description VLAN classifier rule identifier <1-256> Exec mode and Privileged Exec mode Mode If a rule ID is not specified, all configured VLAN classifier rules are shown.
VLAN Commands switchport access vlan Use this command to change the port-based VLAN of the current port. Use the no parameter to change the port-based VLAN of this port to the default VLAN, vlan1. Syntax switchport access vlan <vlan-id> no switchport access vlan Parameter Description <2-4094>...
VLAN Commands switchport enable vlan Enables the VLAN on the port manually once disabled by certain actions, such as QSP/EPSR. If the VID is not given, all the disabled VLAN will be re-enabled. Syntax switchport enable vlan [<1-4094>] Parameter Description Switchport switchport Re-enables the vlan on the port...
VLAN Commands switchport mode access Use this command to set the switching characteristics of the port to access mode. Received frames are classified based on the VLAN characteristics, then accepted or discarded based on the specified filtering criteria. Syntax switchport mode access [ingress-filter {enable|disable}] Parameter Description Set the ingress filtering for the received frames.
VLAN Commands switchport mode private-vlan Use this command to make a layer 2 port as private-vlan host port or promiscuous port. Use the no form of this command to remove the configuration. Syntax switchport mode private-vlan {host|promiscuous} no switchport mode private-vlan {host|promiscuous} Parameter Description This port type can communicate with all other host ports assigned to the...
VLAN Commands switchport mode trunk Use this command to set the switching characteristics of the port to trunk. Received frames are classified based on the VLAN characteristics, then accepted or discarded based on the specified filtering criteria. Syntax switchport mode trunk [ingress-filter {enable|disable}] Parameter Description Set the ingress filtering for the frames received.
VLAN Commands switchport private-vlan host-association Use this command to associate a primary vlan and a secondary vlan to a host port. Only one primary and secondary vlan can be associated to a host port. Use the no form of this command to remove the association. Syntax switchport private-vlan host-association <primary-vlan-id>...
VLAN Commands switchport private-vlan mapping Use this command to associate a primary VLAN and a set of secondary VLANs to a promiscuous port. Use the no form of this to remove all the association of secondary VLANs to primary VLANs for a promiscuous port.
VLAN Commands switchport trunk allowed vlan Use this command to add VLANs to be trunked over this switch port. Traffic for these VLANs can be sent and received on the port. The all parameter sets the port to be a tagged member of all the VLANs configured on the device.
VLAN Commands The following shows adding a range of VLANs to the port’s member set. awplus# configure terminal awplus(config)# interface port1.0.2 awplus(config-if)# switchport trunk allowed vlan add 2-4 The following shows adding a list of VLANs to the port’s member set. awplus# configure terminal awplus(config)#...
VLAN Commands switchport vlan-stacking (double tagging) Use this command to enable VLAN stacking on a port and set it to be a customer-edge-port or provider-port. This is sometimes referred to as VLAN double-tagging, nested VLANs, or QinQ. Use no parameter with this command to disable VLAN stacking on an interface. Syntax switchport vlan-stacking {customer-edge-port|provider-port} no switchport vlan-stacking...
VLAN Commands vlan This command creates VLANs, assigns names to them, and enables or disables them. Specifying the disable state causes all forwarding over the specified VLAN ID to cease. Specifying the enable state allows forwarding of frames on the specified VLAN. The no version of this command destroys the specified VLANs.
VLAN Commands vlan classifier activate Use this command to associate a VLAN classifier group with the switch port. Use the no version of this command to remove the group from the switch port. Syntax vlan classifier activate <vlan-class-grp-id> no vlan classifier activate Parameter Description VLAN classifier group identifier (1-16).
VLAN Commands vlan classifier group Use this command to create a group of VLAN classifier rules. The rules must already have been created. Use the no version of this command to delete a group of VLAN classifier rules. Syntax vlan classifier group <1-16> {add|delete} rule <vlan-class-rule-id> no vlan classifier group <1-16>...
VLAN Commands vlan classifier rule ipv4 Use this command to create an IPv4 subnet-based VLAN classifier rule and map it to a specific VLAN. Use the no version to delete the rule. Syntax vlan classifier rule <1-256> ipv4 <ip-address/m> vlan <1-4094> no vlan classifier rule <1-256>...
Page 353
VLAN Commands Example awplus# configure terminal awplus(config)# vlan classifier rule 3 ipv4 3.3.3.3/8 vlan 5 show vlan classifier rule Related Commands vlan classifier activate vlan classifier rule proto Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1 17.21...
VLAN Commands vlan classifier rule proto Use this command to create a protocol type-based VLAN classifier rule, and map it to a specific VLAN. The no vlan classifer rule proto command destroys the rule. Syntax vlan classifier rule <1-256> proto <protocol> encap {ethv2|nosnapllc|snapllc} vlan <vid>...
VLAN Commands vlan database Use this command to enter the VLAN configuration mode. Syntax vlan database Global Configuration mode Mode Use this command to enter the VLAN configuration mode. You can then add or delete a Usage VLAN, or modify its values. In the following example, note the change to VLAN configuration mode from Configure mode: Examples awplus#...
Spanning Tree Introduction: STP, RSTP, and MSTP Introduction This chapter describes and provides configuration procedures for: ■ Spanning Tree Protocol (STP) ■ Rapid Spanning Tree Protocol (RSTP) Multiple Spanning Tree Protocol (MSTP) ■ For detailed information about the commands used to configure spanning trees, see Chapter 19, Spanning Tree Commands.
Page 359
Spanning Tree Introduction: STP, RSTP, and MSTP The logical tree computed by the spanning tree algorithm has the following properties: ■ A single bridge is selected to become the spanning tree’s unique root bridge. This is the device that advertises the lowest Bridge ID. Each bridge is uniquely identified by its Bridge ID, which comprises the bridge’s root priority (a spanning tree parameter) followed by its MAC address.
Spanning Tree Introduction: STP, RSTP, and MSTP The logical spanning tree, sometimes called the active topology, includes the root bridge and all designated bridges, meaning all ports that are to be used for communication within the spanning tree. These ports are in the forwarding state. Ports removed from the logical spanning tree are not in the forwarding state.
Spanning Tree Introduction: STP, RSTP, and MSTP Spanning Tree Protocol (STP) STP uses the process described in Table 18-1 to avoid loops. STP port states In STP mode, each switch port can be in one of five spanning tree states, and one of two switch states.
Spanning Tree Introduction: STP, RSTP, and MSTP Command Description Configure Root Guard The Root Guard feature makes sure that the port on which it is enabled is a designated port. If the Root Guard enabled port receives a superior BPDU, it goes to a Listening state (for STP) or discarding state (for RSTP and MSTP). interface <port-list>...
Page 363
Spanning Tree Introduction: STP, RSTP, and MSTP Table 18-4: RSTP port states State Meaning DISABLED STP operations are disabled on the port. DISCARDING The port does not participate in frame relay. The forwarding process discards received frames and does not submit forwarded frames for transmission.
Spanning Tree Introduction: STP, RSTP, and MSTP Configuring RSTP RSTP is enabled by default with default settings on all switch ports to prevent layer 2 loops in your network. No further configuration is required if you want to use RSTP with these default settings.
Page 365
Spanning Tree Introduction: STP, RSTP, and MSTP Command Description Configure BPDU Guard spanning-tree portfast bpdu-guard If required, enable the BPDU Guard feature, and awplus(config)# configure timeout parameters. spanning-tree errdisable-timeout awplus(config)# enable spanning-tree errdisable-timeout awplus(config)# interval <10-1000000> Check RSTP configuration exit Return to Privileged Exec mode.
Spanning Tree Introduction: STP, RSTP, and MSTP Multiple Spanning Tree Protocol (MSTP) Conceptually, MSTP views the total bridged network as one that comprises a number of Multiple Spanning Tree Regions (MSTRs), where each region can contain up to 64 spanning trees that operate locally, called Multiple Spanning Tree Instances (MSTIs).
Spanning Tree Introduction: STP, RSTP, and MSTP Multiple Spanning Tree Instances (MSTI) MSTP enables the grouping and mapping of VLANs to different spanning tree instances. So, an MST Instance (MSTI) is a particular set of VLANs that are all using the same spanning tree. In a network where all VLANs span all links of the network, judicious choice of bridge priorities for different MSTIs can result in different switches becoming root bridges for different MSTIs.
Spanning Tree Introduction: STP, RSTP, and MSTP MSTP Regions An MST region is a set of interconnected switches that all have the same values for the following MST configuration identification elements: MST configuration name - the name of the MST region ■...
Page 369
Spanning Tree Introduction: STP, RSTP, and MSTP The task of assigning each bridge to a particular region is achieved by the member bridges each comparing their MST configuration identifiers. More information on configuration identifiers is provided in Table 18-6, but for the moment an MST configuration identifier can simply be thought of as an identifier that represents the mapping of VLANs to MSTIs within each bridge.
Spanning Tree Introduction: STP, RSTP, and MSTP Common and Internal Spanning Tree (CIST) The CIST is the default spanning tree instance of MSTP, i.e. all VLANs that are not members of particular MSTIs are members of the CIST. Also, an individual MST region can be regarded as a single virtual bridge by other MST regions.
Page 371
Spanning Tree Introduction: STP, RSTP, and MSTP CIST In addition to the individual MSTIs within each MSTP region, the MSTP region is a member of a network-wide spanning tree called the Common and Internal Spanning Tree (CIST). Conceptually, each region represents a virtual bridge. Internal and external bridge connectivity are two independent functions.
Spanning Tree Introduction: STP, RSTP, and MSTP MSTP Bridge Protocol Data Units (BPDUs) The main function of bridge protocol data units is to enable MSTP to select its root bridges for the CIST (“Common and Internal Spanning Tree (CIST)” on page 18.14) and each MSTI.
Page 373
Spanning Tree Introduction: STP, RSTP, and MSTP Field Name Octets Description Version 3 Length 37–38 Used to convey the Version 3 length. It is the number of octets taken by the parameters that follow in the BPDU. MST Configuration 39–89 An identifier comprising elements of the following: Identifier Format Selector...
Spanning Tree Introduction: STP, RSTP, and MSTP Configuring MSTP By default, RSTP is enabled with default settings on all switch ports. To configure MSTP, see the configuration procedure in Table 18-9. To configure other modes, see “Configuring RSTP” on page 18.8 “Configuring STP”...
Spanning Tree Introduction: STP, RSTP, and MSTP Command Description region <region-name> Specify the MSTP region. The region is an awplus(config-mst)# arbitrary string that specifies the name you want to assign to the MST region for identification. revision <revision-number> Specify the MSTP revision number <0-255>. The awplus(config-mst)# revision parameter specifies the revision of the current MST configuration.
Page 376
Spanning Tree Introduction: STP, RSTP, and MSTP Command Description spanning-tree guard root The Root Guard feature makes sure that the port awplus(config-if)# on which it is enabled is a designated port. If the Root Guard enabled port receives a superior BPDU, it goes to a Listening state (for STP) or discarding state (for RSTP and MSTP).
Page 377
Chapter 19: Spanning Tree Commands Introduction................................19.2 cisco-interoperability (MSTP)........................19.2 clear spanning-tree detected protocols (RSTP and MSTP) ............19.3 debug mstp (RSTP and STP) ........................19.4 instance priority (MSTP) ..........................19.7 instance vlan (MSTP) ............................19.8 region (MSTP) ..............................19.9 revision (MSTP) ..............................19.10 show debugging mstp............................ 19.11 show spanning-tree............................
Spanning Tree Commands Introduction This chapter lists the commands that are used to configure RSTP, STP or MSTP. For information about spanning trees, including configuration procedures, see Chapter 18, Spanning Tree Introduction: STP, RSTP, and MSTP cisco-interoperability (MSTP) Use this command to enable/disable Cisco-interoperability for MSTP. Use this command for MSTP only.
Spanning Tree Commands clear spanning-tree detected protocols (RSTP and MSTP) Use this command to clear the detected protocols for a specific port, or all ports. Use this command in RSTP or MSTP mode only. Syntax clear spanning-tree detected protocols [interface <port>] Parameter Description The port to clear detected protocols for.
Spanning Tree Commands debug mstp (RSTP and STP) Use this command to enable debugging for the configured spanning tree mode, and echo data to the console, at various levels. Note that although this command uses the keyword mstp it displays debugging output for RSTP and STP protocols as well the MSTP protocol. Use the no parameter with this command, to disable spanning tree debugging.
Page 381
Spanning Tree Commands Output 1 awplus#terminal monitor awplus#debug mstp topology-change interface port1.0.19 10:09:09 awplus MSTP[1409]: Topology change rcvd on port1.0.19 (internal) 10:09:09 awplus MSTP[1409]: Topology change rcvd on MSTI 1 port1.0.19 aawplus#debug mstp topology-change interface port1.0.21 10:09:29 awplus MSTP[1409]: Topology change rcvd on port1.0.21 (external) 10:09:29 awplus MSTP[1409]: Topology change rcvd on MSTI 1 port1.0.21 Use the debug mstp packet rx|tx decode interface command to generate debugging messages Usage 2...
Spanning Tree Commands instance priority (MSTP) Use this command to set the priority for this device to become the root bridge for the specified MSTI. Use this command for MSTP only. Use the no version of this command to restore the root bridge priority of the device for the instance to the default.
Spanning Tree Commands instance vlan (MSTP) Use this command to create an MST Instance (MSTI), and associate the specified VLANs with it. An MSTI is a spanning tree instance that exists within an MST region (MSTR). An MSTR can contain up to 15 MSTIs. When a VLAN is associated with an MSTI the member ports of the VLAN are automatically configured to send and receive spanning-tree information for the associated MSTI.
Spanning Tree Commands region (MSTP) Use this command to assign a name to the device’s MST Region. MST Instances (MSTI) of a region form different spanning trees for different VLANs. Use this command for MSTP only. Use the no version of the command to remove this region name and reset it to the default. Syntax region <region-name>...
Spanning Tree Commands revision (MSTP) Use this command to specify the MST revision number to be used in the configuration identifier. Use this command for MSTP only. Syntax revision <revision-number> Parameter Description <0-255> Revision number. <revision-number> MST Configuration Mode Mode The default value of revision number is 0.
Spanning Tree Commands show debugging mstp Use this command to display the MSTP debugging option set. To modify the lines displayed, use the | (output modifier token); to save the output to a file use the > output redirection token. Syntax show debugging mstp Privileged Exec mode...
Spanning Tree Commands show spanning-tree Use this command to display detailed spanning tree information on the specified port or on all ports. Use this command for RSTP, MSTP or STP. Note that any list of interfaces specified must not span any interfaces that are not installed. A topology change counter has been included for RSTP and MSTP.
Page 389
Spanning Tree Commands awplus>show spanning-tree interface port1.0.23 % 1: Bridge up - Spanning Tree Enabled % 1: Root Path Cost 0 - Root Port 0 - Bridge Priority 32768 % 1: Forward Delay 15 - Hello Time 2 - Max Age 20 % 1: Root Id 80000000cd20f093 % 1: Bridge Id 80000000cd20f093 % 1: last topology change Sun Nov 20 12:24:24 1977...
Page 390
Spanning Tree Commands Figure 19-1: Example output from the show spanning-tree command awplus#show spanning-tree % 1: Bridge up - Spanning Tree Enabled % 1: Root Path Cost 0 - Root Port 0 - Bridge Priority 32768 % 1: Forward Delay 15 - Hello Time 2 - Max Age 20 % 1: Root Id 80000000cd24ff2d % 1: Bridge Id 80000000cd24ff2d % 1: last topology change Thu Jul 26 02:06:26 2007...
Spanning Tree Commands show spanning-tree mst This command displays bridge-level information about the CIST and VLAN to MSTI mappings. Syntax show spanning-tree mst Exec mode and Privileged Exec mode and Interface mode Mode The following is an output of this command displaying the number of instances created, and the Usage VLANs associated with it.
Spanning Tree Commands show spanning-tree mst config Use this command to display MSTP configuration identifier for the device. Syntax show spanning-tree mst config Exec mode and Privileged Exec mode and Interface mode Mode The region name, the revision number, and the digest of the VLAN to MSTI configuration Usage table must be the same on all devices that are intended to be in the same MST region.
Spanning Tree Commands show spanning-tree mst detail This command prints the detailed information about each instance, and all interfaces associated with that particular instance. Syntax show spanning-tree mst detail Exec mode and Privileged Exec mode and Interface mode Mode The following is an output of this command displaying detailed information about each instance, Usage and all interfaces associated with them.
Page 394
Spanning Tree Commands (Continued) port1.0.2: forward-transitions 0 port1.0.2: Version Multiple Spanning Tree Protocol - Received None - Send ST port1.0.2: No portfast configured - Current portfast off port1.0.2: portfast bpdu-guard default - Current portfast bpdu-guard off port1.0.2: portfast bpdu-filter default - Current portfast bpdu-filter off port1.0.2: no root guard configured - Current root guard off...
Spanning Tree Commands show spanning-tree mst detail interface This command prints detailed information about the specified switch port, and the MST instances associated with it. Syntax show spanning-tree mst detail interface <port> Parameter Description <port> The port to display information about. The port may be a switch port (e.g., port1.1.4), a static channel group (e.g., sa3), or an LACP channel group (e.g., po4).
Spanning Tree Commands show spanning-tree mst instance This command displays detailed information for the specified instance, and all switch ports associated with that instance. A topology change counter has been included for RSTP and MSTP. You can see the topology change counter for RSTP by using the show spanning-tree command.
Spanning Tree Commands show spanning-tree mst instance interface This command displays detailed information for the specified instance, and the specified switch port associated with that instance. Syntax show spanning-tree mst instance <1-15> interface <port> Parameter Description The port to display information about. The port may be a switch port (e.g., <port>...
Spanning Tree Commands show spanning-tree mst interface This command displays the number of instances created, and VLANs associated with it for the specified switch port. Syntax show spanning-tree mst interface <port> Parameter Description The port to display information about. The port may be a switch port (e.g., <port>...
Spanning Tree Commands spanning-tree autoedge (RSTP and MSTP) Use this command to enable the autoedge feature on the port. The autoedge feature allows the port to automatically detect that it is an edge port. If it does not receive any BPDUs in the first three seconds after linkup, enabling, or entering RSTP or MSTP mode, it sets itself to be an edgeport and enters the forwarding state.
Spanning Tree Commands spanning-tree edgeport (RSTP and MSTP) Use this command to set a port as an edge-port. Use this command for RSTP or MSTP. This command has the same effect as the spanning-tree portfast command, but the configuration displays differently in the output of some show commands. Use the no parameter with this command to set a port to its default state (not an edge-port).
Spanning Tree Commands spanning-tree enable Use this command to enable or disable the spanning tree protocol for the configured spanning tree mode on the device. Use the no parameter to disable the configured spanning tree protocol on the device. Syntax spanning-tree {mstp|rstp|stp} enable no spanning-tree {mstp|rstp|stp} enable Parameter...
Spanning Tree Commands spanning-tree errdisable-timeout enable Use this command to enable the errdisable-timeout facility, which sets a timeout for ports that are disabled due to the BPDU guard feature. Use this command for RSTP or MSTP. Syntax spanning-tree errdisable-timeout enable no spanning-tree errdisable-timeout enable Global Configuration mode Mode...
Spanning Tree Commands spanning-tree errdisable-timeout interval Use this command to specify the time interval after which a port is brought back up when it has been disabled by the BPDU guard feature. Use this command for RSTP or MSTP. Syntax spanning-tree errdisable-timeout interval <10-1000000>...
Spanning Tree Commands spanning-tree force-version Use this command to force the protocol version for the switch port. Use this command for RSTP or MSTP only. Syntax spanning-tree force-version <version> no spanning-tree force-version Parameter Description <0-3> Version identifier. <version> 0 - Forces the port to operate in STP mode 1- Not supported 2 - Forces the port to operate in RSTP mode.
Spanning Tree Commands spanning-tree forward-time Use this command to set the forward delay. The forward delay sets the time (in seconds) to control how fast a port changes its spanning tree state when moving towards the forwarding state. If the mode is set to STP, the value determines how long the port stays in each of the listening and learning states which precede the forwarding state.
Spanning Tree Commands spanning-tree guard root Use this command to enable the Root Guard feature for the port. The root guard feature disables reception of superior BPDUs. Use this command for RSTP, STP or MSTP. Use the no parameter with this command to disable the root guard feature for the port. Syntax spanning-tree guard root no spanning-tree guard root...
Spanning Tree Commands spanning-tree hello-time This sets the time in seconds between the transmission of switch spanning tree configuration information when the switch is the Root Bridge of the spanning tree or is trying to become the Root Bridge. Use this command to set the hello-time. Use this command for RSTP, STP or MSTP.
Spanning Tree Commands spanning-tree link-type Use this command to enable or disable point-to-point or shared link types on the switch port. Use this command for RSTP or MSTP only. Use the no parameter to return the port to the default link type. Syntax spanning-tree link-type {point-to-point|shared} no spanning-tree link-type...
Spanning Tree Commands spanning-tree max-age Use this command to set the max-age. This sets the maximum age, in seconds, that dynamic spanning tree configuration information is stored in the switch before it is discarded. Use this command for RSTP, STP or MSTP. Use the no parameter with this command to restore the default value of max-age.
Spanning Tree Commands spanning-tree max-hops (MSTP) Use this command to specify the maximum allowed hops for a BPDU in an MST region. This parameter is used by all the instances of the MST region. To restore the default value, use the no parameter with this command.
Spanning Tree Commands spanning-tree mode Use this command to change the spanning tree protocol mode on the device. This can be either STP, RSTP, or MSTP. Syntax spanning-tree mode {stp|rstp|mstp} The default mode is RSTP. Default With no configuration, the device will have spanning tree enabled, and the spanning tree mode Usage will be set to RSTP.
Spanning Tree Commands spanning-tree mst instance Use this command to assign a Multiple Spanning Tree instance (MSTI) to a switch port or channel group. Note that ports are automatically configured to send and receive spanning-tree information for the associated MSTI when VLANs are assigned to MSTIs using the instance vlan command. You can disable automatic configuration of member ports of a VLAN to an associated MSTI by using a no spanning-tree mst instance command to remove the member port from the MSTI.
Spanning Tree Commands spanning-tree mst instance path-cost Use this command to set the cost of a path associated with a port, for the specified MSTI. This specifies the port’s contribution to the cost of a path to the MSTI regional root via that port.
Spanning Tree Commands spanning-tree mst instance priority Use this command to set the port priority for an MST instance (MSTI). This sets the value of the priority field contained in the port identifier. The MST algorithm uses the port priority when determining the root port for the switch in the MSTI. The port with the lowest value is considered to have the highest priority and will be chosen as root port over a port - equivalent in all other aspects - but with a higher priority value.
Spanning Tree Commands spanning-tree path-cost Use this command to set the cost of a path for the specified port. This value then combines with others along the path to the root bridge in order to determine the total cost path value from the particular port, to the root bridge.
Spanning Tree Commands spanning-tree portfast Use this command to set a port as an edge-port. The portfast feature enables a port to rapidly move the forwarding state, without having first to pass through the intermediate spanning tree states. This command has the same effect as the spanning-tree edgeport (RSTP and MSTP) command, but the configuration displays differently in the output of some show commands.
Spanning Tree Commands spanning-tree portfast bpdu-filter This command sets the portfast feature and applies a filter to any BPDUs received. Enabling this feature ensures that PortFast configured ports will not transmit any BPDUs and will ignore (filter out) any BPDUs received. Using the no parameter variant of this command will turn off the bpdu-filter, but retain the port’s status a portfast.
Spanning Tree Commands spanning-tree portfast bpdu-guard This command sets the portfast feature and applies a BPDU guard to the port. A port with the portfast feature enabled will block all traffic (BPDUs and user data), if it starts receiving BPDUs. Use the no parameter with this command to disable the BPDU Guard feature on a switch.
Spanning Tree Commands show spanning-tree spanning-tree portfast spanning-tree portfast bpdu-guard spanning-tree priority (bridge priority) Use this command to set the bridge priority for the switch. A lower priority value indicates a greater likelihood of the switch becoming the root bridge. Use this command for RSTP, STP or MSTP.
Spanning Tree Commands spanning-tree priority (port priority) Use this command to set the port priority for port. A lower priority value indicates a greater likelihood of the port becoming part of the active topology. Use this command for RSTP, STP, or MSTP. When the device is in MSTP mode, this will apply to the CIST.
Chapter 20: Link Aggregation Configuration Introduction................................20.2 Configuring LACP...............................20.2 Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1 20.1...
Configuring LACP The following example shows how to configure three links between two Allied Telesis managed Layer 3 Switches. The three links are assigned the same administrative key (1), so that they aggregate to form a single channel 1. They are viewed by the STP as one interface.
Page 423
Link Aggregation Configuration Switch 1 Enter the Configure mode. awplus#configure terminal Set the system priority of this switch. This priority is awplus(config)#lacp system-priority 20000 used for determining the system that is responsible for resolving conflicts in the choice of aggregation groups. A lower numerical value has a higher priority.
Page 424
Link Aggregation Configuration Software Reference for SwitchBlade® x908, x900 and x600 Series Switches 20.4 AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
Page 425
Chapter 21: Link Aggregation Commands Introduction................................21.2 clear lacp counters .............................21.2 channel-group mode............................21.3 debug lacp................................21.5 lacp port-priority ..............................21.6 lacp system-priority............................21.6 lacp timeout ................................21.7 show debugging lacp............................21.8 show etherchannel.............................21.9 show etherchannel detail ..........................21.10 show etherchannel summary ........................21.11 show lacp-counter............................21.12 show lacp sys-id ..............................
Link Aggregation Commands Introduction This chapter provides an alphabetical reference for static link aggregation (static channel group) commands and dynamic link aggregation (LACP channel group) commands. Link aggregation is also sometimes referred to as channelling. For a description of static and dynamic link aggregation (LACP), see “Channel Groups (Link Aggregation)”...
Link Aggregation Commands channel-group mode Use this command to add the switch port to a dynamic (LACP) channel group specified by the channel group number, and set its mode. You can create up to 31 channel groups. This command enables LACP link aggregation on the switch port, so that it may be selected for aggregation by the local system.
Page 428
Link Aggregation Commands To reference the pre-defined LACP channel group 2 as an interface apply commands as below: awplus# configure terminal awplus(config)# interface port1.1.8 awplus(config-if)# channel-group 2 mode active awplus(config-if)# exit awplus(config)# interface port.1.1.10 awplus(config-if)# channel-group 2 mode active awplus(config-if)# exit awplus(config)# interface po2...
Link Aggregation Commands debug lacp Use this command to enable all LACP troubleshooting functions. Use the no parameter with this command to disable this function. Syntax debug lacp {all|cli|event|ha|packet|sync|timer[detail]} no debug lacp {all|cli|event|ha|packet|sync|timer[detail]} Parameter Description Turn on all debugging for LACP. Specifies debugging for CLI messages.
Link Aggregation Commands lacp port-priority Sets the priority of a switch port. Ports are selected for aggregation based on their priority, with the higher priority (numerically lower) ports selected first. Use the no parameter with this command to reset the priority of port to the default value (32768).
Link Aggregation Commands lacp timeout Use this command to set the short or long timeout on a port. Ports will time out of the aggregation if three consecutive updates are lost. The default is the long timeout of 30 seconds. Syntax lacp timeout {short|long} Parameter...
Link Aggregation Commands show debugging lacp Use this command to display the LACP debugging option set. To modify the lines displayed, use the | (output modifier token); to save the output to a file use the > output redirection token. Syntax show debugging lacp Exec and Privileged Exec mode...
Link Aggregation Commands show etherchannel Use this command to display information about an LACP etherchannel specified by the channel-group number. The command output also shows the thrash limiting status. If thrash limiting is detected and the thrash limiting parameter of the thrash-limiting command on page 15.44 is set to vlan disable, the output will also show the VLANs on which thrashing is detected.
Link Aggregation Commands show etherchannel detail Use this command to display detailed information about all LACP channels. To modify the lines displayed, use the | (output modifier token); to save the output to a file, use the > output redirection token. Syntax show etherchannel detail Privileged Exec mode...
Link Aggregation Commands show etherchannel summary Use this command to display a summary of all LACP channels. To modify the lines displayed, use the | (output modifier token); to save the output to a file, use the > output redirection token. Syntax show etherchannel summary Privileged Exec mode...
Link Aggregation Commands show lacp-counter Use this command to display the packet traffic on all ports of all present LACP aggregators, or a given LACP aggregator. To modify the lines displayed, use the | (output modifier token); to save the output to a file, use the >...
Link Aggregation Commands show port etherchannel Use this command to show LACP details of the switch port specified. To modify the lines displayed, use the | (output modifier token); to save the output to a file, use the > output redirection token. Syntax show port etherchannel <port>...
Link Aggregation Commands show static-channel-group Use this command to display all configured static channel groups and their corresponding member ports. Note that a static channel group is the same as a static aggregator. The command output also shows the thrash limiting status. If thrash limiting is detected and the thrash limiting parameter of the thrash-limiting command on page 15.44 is set to vlan...
Link Aggregation Commands static-channel-group Use this command to create a static channel group (also known as a static aggregator), or add a member port to an already-existing static channel group. Use the no parameter with this command to remove the switch port from the static channel group. Syntax static-channel-group <1-31>...
Page 440
Link Aggregation Commands To reference the pre-defined static channel group 2 as an interface apply commands as below: awplus# configure terminal awplus(config)# interface port1.1.8 awplus(config-if)# static-channel-group 2 awplus(config-if)# exit awplus(config)# interface port.1.1.10 awplus(config-if)# static-channel-group 2 awplus(config-if)# exit awplus(config)# interface sa2 awplus(config-if)# show static-channel-group Related Commands...
Internet Protocol (IP) Addressing and Protocols Introduction This chapter describes how to configure IPv4 addressing and the protocols used to help IP function on your network. As well as the familiar Internet, with uppercase “I”, the term internet (with lowercase “i”) can refer to any network (usually a wide area network) that uses the Internet protocol.
Internet Protocol (IP) Addressing and Protocols Address Resolution Protocol (ARP) Address Resolution Protocol (ARP) is used by your device to dynamically learn the layer 2 address of devices in its networks. Most hosts also have a MAC physical in addition to the assigned IP address.
Internet Protocol (IP) Addressing and Protocols Deleting ARP Entries To remove a static ARP entry, use the command: awplus(config-if)#no arp <ip-address> To clear the ARP cache of dynamic entries, use the command: clear arp-cache awplus(config)# This removes the dynamic ARP entries for all interfaces. To display the entries in the ARP cache, use the command: show arp awplus(config)#...
Page 447
Internet Protocol (IP) Addressing and Protocols ip address 192.168.2.2/24 See the sample configuration commands and validation command with resulting output showing proxy ARP disabled on VLAN 2 below: awplus#configure terminal awplus(config)#interface vlan2 awplus(config-if)#no ip proxy-arp awplus(config-if)#end awplus(config)#exit awplus#show running-config interface vlan2 ip address 192.168.2.2/24 Software Reference for SwitchBlade®...
Page 448
Internet Protocol (IP) Addressing and Protocols Local Proxy ARP Local Proxy ARP lets you stop MAC address resolution between hosts within an interface’s subnet. This ensures that devices within a subnet cannot send traffic that bypasses layer 3 routing on your device. This lets you monitor, filter, and control traffic between devices in the same subnet.
Internet Protocol (IP) Addressing and Protocols Domain Name System (DNS) The Domain Name System allows you to access remote systems by entering human-readable device host names rather than IP addresses. DNS works by creating a mapping between a device name, such as “www.alliedtelesis.com”, and its IP address. These mappings are held on DNS servers.
Page 450
Internet Protocol (IP) Addressing and Protocols If you then use the command ping host2, your device sends a DNS request for host2.example.net. To check the domain name configured with this command, use the command: show ip domain-name awplus# Alternatively you can create a list of domain names that your device will try in turn by using the command: ip domain-list <domain_name>...
Internet Protocol (IP) Addressing and Protocols Internet Control Message Protocol (ICMP) The Internet Control Message Protocol (ICMP) allows networking devices to send information and control messages to other devices or hosts. Your device implements all non-obsolete ICMP functions. The following table lists the ICMP messages implemented by your device. ICMP Message Type Device Response Echo reply (0)
Internet Protocol (IP) Addressing and Protocols ICMP Router Discovery Protocol (IRDP) Router discovery Your device supports the router specification sections of RFC 1256, ICMP Router Discovery Messages. If this feature is configured, your device sends router advertisements periodically and in response to router solicitations. It does not support the Host Specification section of this RFC.
Page 453
Internet Protocol (IP) Addressing and Protocols Solicitation A router solicitation is an ICMP (type 10) message containing: message ■ source Address: an IP address belonging to the interface from which the message is sent ■ destination Address: the configured Solicitation Address, and ■...
Page 454
Internet Protocol (IP) Addressing and Protocols cause a large amount of extra traffic, even if there are several routers on the LAN. If you change these settings, keep the following proportions: lifetime=3 x maxadvertisementinterval minadvertisementinverval=0.75 x maxadvertisementinterval You cannot set the maximum advertisement interval below the minimum interval. If you are lowering the maximum interval to a value below the current minimum interval, you must change the minimum value first.
Internet Protocol (IP) Addressing and Protocols Checking IP Connections To verify connections between networks and network devices, use the ping (Packet Internet Groper) and trace route functions on your device. Ping Ping tests the connectivity between two network devices to determine whether each network device can “see”...
Internet Protocol (IP) Addressing and Protocols IP Helper The IP Helper feature allows the switch to receive UDP broadcasts on one subnet, and forward them as broadcasts or unicasts into another subnet, so a client can use an application which uses UDP broadcast (such as Net-BIOS) when the client and server are located in different subnets.
Chapter 23: IP Addressing and Protocol Commands Introduction ................................23.2 arp-aging-timeout ..............................23.2 arp (IP address MAC address)........................23.3 clear arp-cache..............................23.4 debug ip packet interface..........................23.5 debug ip irdp................................23.7 ip address.................................23.8 ip domain-list................................23.9 ip domain-lookup .............................23.10 ip domain-name ..............................23.11 ip directed-broadcast .............................23.12 ip forwarding ...............................23.13 ip forward-protocol udp ..........................23.13 ip gratuitous-arp-link............................23.14 ip helper-address ..............................23.16...
IP Addressing and Protocol Commands Introduction This chapter provides an alphabetized command reference for the following protocols: Address Resolution Protocol (ARP) ■ ■ Domain Name Service (DNS) ICMP Router Discovery Advertisements (IRDP) ■ arp-aging-timeout This command sets a timeout period on dynamic ARP entries associated with a specific interface.
IP Addressing and Protocol Commands arp (IP address MAC address) This command adds a static ARP entry to the ARP cache. This is typically used to add entries for hosts that do not support ARP or to speed up the address resolution function for a host. The ARP entry must not already exist.
IP Addressing and Protocol Commands clear arp-cache This command deletes the dynamic ARP entries from the ARP cache. To display the entries in the ARP cache, use the show arp command. To remove static ARP entries, use the no arp <ip-address> command.
IP Addressing and Protocol Commands debug ip packet interface The debug ip packet interface command enables IP packet debug and is controlled by the terminal monitor command. ■ The required interface placeholder following the optional interface keyword can be specified as either all or as a single layer 3 interface to show debugging for either all interfaces or a single interface.
Page 462
IP Addressing and Protocol Commands To turn off IP packet interface debugging on all interfaces, use the command: awplus# no debug ip packet interface To turn off IP packet interface debugging on interface VLAN 2, use the command: awplus# no debug ip packet interface vlan2 no debug all Related Commands show debugging ip packet...
IP Addressing and Protocol Commands debug ip irdp This command enables debugging of ICMP Router Discovery Protocol (IRDP) events and messages on your device. IRDP debugging is disabled by default. ■ If event is specified, then IRDP events related debugging will be enabled. ■...
IP Addressing and Protocol Commands ip address This command sets a static IP address on an interface. To set the primary IP address on the interface, specify only ip address <ip-address/m>. This overwrites any configured primary IP address. To add additional IP addresses on this interface, use the secondary parameter. You must configure a primary address on the interface before configuring a secondary address.
IP Addressing and Protocol Commands ip domain-list This command adds a domain to the DNS list. Domain are appended to incomplete host names in DNS requests. Each domain in this list is tried in turn in DNS lookups. This list is ordered so that the first entry you create is checked first.
IP Addressing and Protocol Commands ip domain-lookup This command enables the DNS client on your device. This allows you to use domain names instead of IP addresses in commands. The DNS client resolves the domain name into an IP address by sending a DNS enquiry to a DNS server, specified with the ip name-server command.
IP Addressing and Protocol Commands ip domain-name This command sets a default domain for the DNS. The DNS client appends this domain to incomplete host-names in DNS requests. If there are no domains in the DNS list (created using the ip domain-list command) then your device uses the domain specified with this command.
IP Addressing and Protocol Commands ip directed-broadcast ip directed-broadcast Command vs_531 %flag IP Addressing and Protocol Commands Use this command to enable flooding of directed broadcast packets into a directly connected subnet. Use this command to enable flooding of directed broadcast packets into a directly connected subnet.
IP Addressing and Protocol Commands ip forwarding This command enables IP forwarding on your device. When enabled, your device routes IP packets. The no form disables IP forwarding on your device. Even when IP forwarding is not enabled, the device can still work as an IP host; in particular, it can be managed by IP-based applications, such as SNMP, Telnet and SSH.
IP Addressing and Protocol Commands Use the no parameter to remove a port number from the list of destination port numbers that are used as the criterion for deciding if a given UDP broadcast should be forwarded to the IP helper address(es).
Page 471
IP Addressing and Protocol Commands However, when a link is flapping, and the switchport’s state is set to forwarding several times, the gratuitous-arp feature may be sent undesirably often. This time limit restricts sending of gratuitous-arps to one within the specified time in seconds. Syntax ip gratuitous-arp-link <0-300>...
IP Addressing and Protocol Commands ip helper-address ip helper-address Command vs_531 %flag IP Addressing and Protocol Commands This command adds a forwarding destination address for IP Helper to enable forwarding of User Datagram Protocol (UDP) broadcasts on an interface. This command adds a forwarding destination address for IP Helper to enable forwarding of User Datagram Protocol (UDP) broadcasts on an interface.
IP Addressing and Protocol Commands ip irdp This command enables ICMP Router Discovery advertising on an interface. However, the interface does not send or process Router Discovery messages until at least one IP address is configured on the interface with the ip address command.
IP Addressing and Protocol Commands ip irdp address preference When multiple routers connected to a LAN are all sending Router Discovery advertisements, hosts need to be able to choose the best router to use. Therefore the IRDP defines a preference value to place in the Router Discovery advertisements. Hosts choose the router with the highest preference value.
IP Addressing and Protocol Commands ip irdp broadcast This command configures broadcast Router Discovery advertisements on an interface. The interface sends IRDP advertisements with the broadcast address (255.255.255.255) as the IP destination address. The no form configures multicast Router Discovery advertisements on an interface. The interface sends IRDP advertisements with the all-system multicast address (224.0.0.1) as the IP destination address.
IP Addressing and Protocol Commands ip irdp holdtime This command sets the maximum length of time that the advertised addresses are to be considered as valid router addresses by hosts. The no form sets the holdtime back to the default of 1800 seconds. Syntax ip irdp holdtime <0-9000>...
IP Addressing and Protocol Commands ip irdp lifetime This command sets the maximum length of time that hosts should consider the Router Discovery advertised addresses as valid router addresses. If you change the lifetime value, also change the maxadvertisementinterval and the minadvertisementinterval to maintain the following ratios: lifetime=3 x maxadvertisementinterval minadvertisementinterval=0.75 x maxadvertisementinterval...
IP Addressing and Protocol Commands ip irdp maxadvertinterval This command sets the maximum time allowed between sending router advertisements from the interface. If you change the maxadvertisementinterval value, also change the lifetime and the minadvertisementinterval to maintain the following ratios: lifetime=3 x maxadvertisementinterval minadvertisementinterval=0.75 x maxadvertisementinterval You cannot set the maximum advertisement interval below the minimum interval.
IP Addressing and Protocol Commands ip irdp minadvertinterval This command sets the minimum time allowed between sending router advertisements from the interface. If you change the minadvertisementinterval value, also change the lifetime and the maxadvertisementinterval to maintain the following ratios: lifetime=3 x maxadvertisementinterval minadvertisementinterval=0.75 x maxadvertisementinterval You cannot set the minimum advertisement interval above the maximum interval.
IP Addressing and Protocol Commands ip irdp multicast This command configures multicast Router Discovery advertisements on an interface. The interface sends IRDP advertisements with the all-system multicast address (224.0.0.1) as the IP destination address. The no form configures broadcast Router Discovery advertisements on an interface. The interface sends IRDP advertisements with the broadcast address (255.255.255.255) as the IP destination address.
IP Addressing and Protocol Commands ip irdp preference When multiple routers connected to a LAN are all sending Router Discovery advertisements, hosts need to be able to choose the best router to use. Therefore the IRDP defines a preference value to place in the Router Discovery advertisements. Hosts choose the router with the highest preference value.
IP Addressing and Protocol Commands ip local-proxy-arp This command allows you to stop MAC address resolution between hosts within a private VLAN edge interface. Local Proxy ARP works by intercepting ARP requests between hosts within a subnet and responding with your device’s own MAC address details instead of the destination host’s details.
IP Addressing and Protocol Commands ip name-server This command adds the IP address of a DNS server to the device’s list of servers. The DNS client on your device sends DNS queries to devices on this list when trying to resolve a DNS hostname.
IP Addressing and Protocol Commands ip proxy-arp This command enables Proxy ARP responses to ARP requests on an interface. When enabled, your device intercepts ARP broadcast packets and substitutes its own physical address for that of the remote host. By responding to the ARP request, your device ensures that subsequent packets from the local host are directed to its physical address, and it can then forward these to the remote host.
Page 485
IP Addressing and Protocol Commands ping This command sends a query to another host (send Echo Request messages). Syntax ping [ip] <host> [broadcast] [df-bit {yes|no}] [interval <0-128>] [pattern <hex-data-pattern>] [repeat {<1-2147483647>|continuous}] [size <36-18024>] [source <ip-address>] [timeout <1-65535>] [tos <0-255>] Parameter Description Specify the destination address or hostname.
IP Addressing and Protocol Commands router ip irdp This command globally enables ICMP Router Discovery (IRDP) advertisements on your device. However, your device does not send or process IRDP messages until at least one interface is configured to use IP and has had IRDP enabled on the interface with the ip irdp command.
IP Addressing and Protocol Commands show arp This command displays the dynamic and static ARP entries in the ARP cache. The ARP cache contains mappings of IP addresses to physical addresses for hosts. To have a dynamic entry in the ARP cache, a host must have used the ARP protocol to access another host. To modify the lines displayed, use the | (output modifier token);...
IP Addressing and Protocol Commands show debugging ip packet Use this command to show the IP interface debugging status. IP interface debugging is set using the debug ip packet interface command. To modify the lines displayed, use the | (output modifier token); to save the output to a file, use the >...
IP Addressing and Protocol Commands show hosts This command shows the default domain, domain list, and name servers configured on your device. To modify the lines displayed, use the | (output modifier token); to save the output to a file, use the >...
IP Addressing and Protocol Commands show ip domain-name This command shows the default domain configured on your device. When there are no entries in the DNS list, the DNS client appends this domain to incomplete hostnames when sending a DNS enquiry to a DNS server. To modify the lines displayed, use the | (output modifier token);...
IP Addressing and Protocol Commands show ip interface brief Use this command to display brief information about interfaces and the IP addresses assigned to them. To display information about a specific interface, specify the interface name with the command. To modify the lines displayed, use the | (output modifier token); to save the output to a file, use the >...
IP Addressing and Protocol Commands show ip irdp This command displays whether IRDP is globally enabled on your device, and the status of the debugging modes. ■ If the debug ip irdp command has been set with the detail parameter then the both parameter is also set and the output will show "packet debugging mode is all".
IP Addressing and Protocol Commands show ip irdp interface This command displays the configuration of IRDP on all interfaces, or for a specified interface. To modify the lines displayed, use the | (output modifier token); to save the output to a file, use the >...
Page 494
IP Addressing and Protocol Commands Parameters in output of the show ip irdp interface command Parameter Meaning Whether this interface is sending broadcast or multicast router Sending mode advertisements. This means the destination IP address of router advertisements will be either the multicast address 224.0.0.1, or the broadcast address 255.255.255.255.
IP Addressing and Protocol Commands show ip name-server This command displays the list of DNS servers your device sends DNS requests to. This is a static list configured using the ip name-server command. To modify the lines displayed, use the | (output modifier token); to save the output to a file, use the >...
Page 496
IP Addressing and Protocol Commands tcpdump Use the tcpdump command to start a tcpdump, which gives the same output as the UNIX tcpdump command to display TCP/IP traffic. Press <ctrl> + c to stop a running tcpdump. See the relevant unix man pages for complete tcpdump usage and syntax descriptions. Syntax tcpdump <line>...
Chapter 24: IPv6 Introduction Introduction................................24.2 Overview.................................24.2 IPv6 Addresses and Prefixes.........................24.3 Address types ...............................24.3 IPv6 Headers..............................24.4 The Internet Control Message Protocol (ICMPv6)..............24.7 IPv6 Routing..............................24.9 Integration of IPv4 and IPv6 ......................24.10 IPv6 on your Switch ............................24.10 Enabling IPv6 .............................. 24.10 The 6bone Network ..........................
IPv6 Introduction Introduction This chapter describes the main features of IPv6, the switch’s implementation of IPv6 and how to configure and operate IPv6 on the switch. This chapter describes the following IPv6 features: ■ linking together networks that run IPv6. ■...
IPv6 Introduction IPv6 Addresses and Prefixes IPv6 addresses are hexadecimal, and are made up of eight pairs of octets separated by colons. An example of a valid address is fe80:0000:0000:0000:0260:0000:97ff:64aa. In the interests of brevity, addresses can be abbreviated in two ways: ■...
IPv6 Introduction Among the special addresses that have been defined are addresses that allow multicasting to: ■ All interfaces on a particular host (FF01::1) ■ All nodes on a local network (FF01::2) ■ All routers on the local link (FF02::2) ■...
Page 501
IPv6 Introduction Table 24-1: The following table describes fields in an IPv6 packet. Field Function Version of the IP protocol that created the packet. For IPv6, this field has a value of 6. Differentiated Services 8-bit value that contains the 6-bit DSCP and is used to prioritize traffic as part of a Quality of Service system.
Page 502
IPv6 Introduction Basic IPv6 header structure The headers contain information necessary to move the packet across the internet. They must be able to cope with missing and duplicated packets as well as possible fragmentation (and reassembly) of the original packet. IPv6 headers are twice as long as IPv4 headers (40 bytes instead of 20 bytes) and contain four times the address space size (128 bits instead of 32 bits).
IPv6 Introduction The Encapsulating Security Payload (ESP) header. This encrypts a packet and verifies the integrity of its contents. The Upper Layer Protocol header. This indicates which protocol a higher layer (such as the transport layer) is to process the packet with (for example, TCP). The Internet Control Message Protocol (ICMPv6) The Internet Control Message Protocol, ICMPv6, provides a mechanism for error reporting and route discovery and diagnostics.
Page 504
IPv6 Introduction The following table explains packet types and services. Packet Type Description address resolution A method for carrying out address autoconfiguration, and is achieved using the Neighbour Solicitation Message and the Neighbour Advertisement Message. router and prefix discovery On connection to a link, a node needs to know the address of a router that the node can use to reach the rest of the world.
IPv6 Introduction If no neighbour advertisement is received, the node concludes that the address is available and assigns it to the chosen interface. On the host The node then sends one or more router solicitations to detect if any routers are present. Any routers present responds with a router advertisement.
IPv6 Introduction Integration of IPv4 and IPv6 IPv6 has been designed in such a way that a smooth transition from IPv4 is possible. The most effective way to ensure this is to use a dual IP stack. A node configured as a dual stack system has both a 128-bit IPv6 address and a 32-bit IPv4 address, and so can communicate with nodes running IPv4 and those running IPv6.
IPv6 Commands Introduction This chapter lists, in alphabetical order, the IPv6 commands used by the AlliedwarePlus™ Operating System. clear ipv6 neighbors clear ipv6 neighbors Command vs_531 %flag IPv6 Commands This new command clears all dynamic IPv6 neighbor entries. Use this command to clear all dynamic IPv6 neighbor entries. Syntax clear ipv6 route kernel Privileged Exec mode...
IPv6 Commands ipv6 forwarding ipv6 forwarding Command vs_531 %flag IPv6 Commands This new command Use this command turns on IPv6 forwarding. Use this command to turn on IPv6 forwarding. Use the no parameter with this command to turn off IPv6 forwarding. Note: The switch will not apply any IPv6 functionality unless you have allocated it memory resource by using the...
IPv6 Commands ipv6 nd managed-config-flag ipv6 nd managed-config-flag Command vs_531 %flag IPv6 Commands This new command is used to set the managed address configuration flag, contained within the router advertisement field. Use this command to set the managed address configuration flag, contained within the router advertisement field.
IPv6 Commands ipv6 nd other-config-flag ipv6 nd other-config-flag Command vs_531 %flag IPv6 Commands This new command is used to set the other stateful configuration flag (contained within the router advertisement field) to be used for IPv6 address auto-configuration. Use this command to set the other stateful configuration flag (contained within the router advertisement field) to be used for IPv6 address auto-configuration.
IPv6 Commands ipv6 nd prefix ipv6 nd prefix Command vs_531 %flag IPv6 Commands This new command is used to specify the IPv6 prefix information that is advertised by the router advertisement for IPv6 address auto-configuration. Use this command to specify the IPv6 prefix information that is advertised by the router advertisement for IPv6 address auto-configuration.
IPv6 Commands The following example configures the switch to issue router advertisements on VLAN4, and Example advertises the address prefix of 2001:0DB8::/64. awplus# configure terminal awplus(config)# interface vlan4 awplus(config-if)# ipv6 nd prefix 2001:0db8::/64 ipv6 nd suppress-ra Related Commands ipv6 nd ra-interval ipv6 nd ra-interval Command vs_531...
IPv6 Commands ipv6 nd ra-lifetime ipv6 nd ra-lifetime Command vs_531 %flag IPv6 Commands This new command is used to specify the time period that this router can usefully act as a default gateway for the network. Use this command to specify the time period that this router can usefully act as a default gateway for the network.
IPv6 Commands ipv6 nd reachable-time ipv6 nd reachable-time Command vs_531 %flag IPv6 Commands This new command is used to specify the reachable time in the router advertisement to be used for detecting reachability of the IPv6 neighbor. Use this command to specify the reachable time in the router advertisement to be used for detecting reachability of the IPv6 neighbor.
IPv6 Commands ipv6 nd suppress-ra ipv6 nd suppress-ra Command vs_531 %flag IPv6 Commands This new command is used to inhibit IPv6 Router Advertisement (RA) transmission for the current interface. Router advertisements are used when applying IPv6 stateless auto-configuration. Use this command to inhibit IPv6 Router Advertisement (RA) transmission for the current interface.
IPv6 Commands ipv6 neighbor ipv6 neighbor Command vs_531 %flag IPv6 Commands This command is used to add a static IPv6 neighbor entry. Use this command to add a static IPv6 neighbor entry. Use the no form of this command to a specific IPv6 neighbor entry.
IPv6 Commands ipv6 route ipv6 route Command vs_531 %flag IPv6 Commands This new command is used to establish the distance for static routes of a network prefix. Use this command to establish the distance for static routes of a network prefix. Use the no form of this command to disable the distance for static routes of the network prefix.
IPv6 Commands show ipv6 interface brief show ipv6 interface brief Command vs_531 %flag IPv6 Commands This new command is used to display brief information about interfaces and the IPv6 address assigned to them. Use this command to display brief information about interfaces and the IPv6 address assigned to them.
IPv6 Commands show ipv6 route show ipv6 route Command vs_531 %flag IPv6 Commands This command is used to display the IP routing table for a protocol or from a particular table. Use this command to display the IP routing table for a protocol or from a particular table. To modify the lines displayed, use the | (output modifier token);...
IPv6 Commands show ipv6 route summary show ipv6 route summary Command vs_531 %flag IPv6 Commands This command is used to display the summary of the current NSM RIB entries. Use this command to display the summary of the current NSM RIB entries. To modify the lines displayed, use the | (output modifier token);...
Page 522
IPv6 Commands Software Reference for SwitchBlade® x908, x900 and x600 Series Switches 25.16 AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
IPv6to4 Tunneling Configuration Introduction This chapter contains a basic IPv6to4 automatic tunneling configuration example for reference. To see details on the Tunneling commands used in this sample configuration, or to see the outputs of the Validation commands, refer to Chapter 27, IPv6to4 Tunneling Commands.
IPv6to4 Tunneling Configuration When a switch is required to deliver packets, via a tunnel interface, to IPv6 addresses in the range 2002:<ipv4-address>::/48, the switch knows that the IPv4 address to which the switch must deliver that packet is given by the 17th through 48th bits of the IPv6 destination address.
IPv6to4 Tunneling Configuration Sample 6to4 configuration The following example shows the minimum configuration required for 6to4 automatic tunnel configuration. Follow the commands and descriptions in the tables below the sample network: IPv6 Site IPv6 Site 6to4 Tunnel Switch 1 Switch 3 in the range in the range 2002:8f1d:8812::/48...
Page 527
IPv6to4 Tunneling Configuration Switch 2 Enter the Configure mode. awplus#configure terminal Specify the interface (vlan2) and enter the awplus(config)#interface vlan2 Interface mode. awplus(config-if)#ip address 212.149.1.2/24 Set the IPv4 address of the interface (vlan2). Exit Interface mode and enter Configure awplus(config-if)#exit mode.
Page 528
IPv6to4 Tunneling Configuration Exit Interface mode and enter Configure awplus(config-if)#exit mode. Add a route to send traffic for other 6to4 subnets via awplus(config)#ipv6 route 2002::/16 tunnel 100 the tunnel interface. Create an OSPF routing instance. awplus(config)#router ospf Specify a Router ID for the OSPF routing process. awplus(config-router)#router-id 10.70.0.76 Enable OSPF routing with a specified Area ID on awplus(config-router)#network 143.29.136.0/24...
IPv6to4 Tunneling Commands Introduction This chapter contains AlliedWare Plus commands related to IPv6to4 automatic tunneling. interface tunnel interface tunnel Command vs_531 %flag IPv6to4 Tunneling Commands Use this command to create a new tunnel interface, which is identified by an integer (1-145). Use this command to create a new tunnel interface, which is identified by an integer (1-145).
IPv6to4 Tunneling Commands tunnel dscp tunnel dscp Command vs_531 %flag IPv6to4 Tunneling Commands Use this command to configure the value (0-63) to use for the IPv4 DSCP (Differentiated Services Code Point) field in the IPv4 header that encapsulates the tunneled IPv6 packets. Use this command to configure the value (0-63) to use for the IPv4 DSCP (Differentiated Services Code Point) field in the IPv4 header that encapsulates the tunneled IPv6 packets.
IPv6to4 Tunneling Commands tunnel mode ipv6ip tunnel mode ipv6ip Command vs_531 %flag IPv6to4 Tunneling Commands Use this command to specify the IPv6 transition tunnel mode. Use this command to specify the IPv6 transition tunnel mode. In AlliedWare Plus version 5.3.1, 6to4 automatic tunneling is the only tunnel mode supported. Use the no parameter to return the mode of the IPv6 transition tunnel to an undefined state.
IPv6to4 Tunneling Commands tunnel source tunnel source Command vs_531 %flag IPv6to4 Tunneling Commands Use this command to specify the IPv4 source address for packets being encapsulated in the tunnel. Use this command to specify the IPv4 source address for packets being encapsulated in the tunnel.
Page 534
IPv6to4 Tunneling Commands tunnel ttl tunnel ttl Command vs_531 %flag IPv6to4 Tunneling Commands Use this command to configure the value to use for the Time to Live (TTL) field in the IPv4 header that encapsulates the tunneled IPv6 packets. Use this command to configure the value to use for the Time to Live (TTL) field in the IPv4 header that encapsulates the tunneled IPv6 packets.
Chapter 28: Routing Protocol Overview Introduction ................................28.2 RIP....................................28.2 OSPF...................................28.2 BGP .....................................28.3 PIM-SM..................................28.4 VRRP...................................28.4 Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1 28.1...
Routing Protocol Overview Introduction This chapter introduces the basic routing protocols supported within the AlliedWare Plus Operating System. A distance-vector protocol, Routing Information Protocol (RIP) is an Interior Gateway Protocol (IGP) that uses hop counts as its metrics. The AlliedWare Plus RIP module supports RFCs 1058 and 1723;...
Routing Protocol Overview During boot-up, an OSPF router initializes its routing-protocol-specific data structures and tables. When the lower-layer protocols with which it interfaces are functional, it sends the OSPF Hello protocol packets to find neighboring routers. A router sends Hello packets as keep-alive packets, informing other routers about its continuing functionality.
Routing Protocol Overview PIM-SM The AlliedWare Plus Protocol Independent Multicast–Sparse Mode (PIM-SM) module is a multicast routing protocol module that uses the underlying unicast Routing Information Base (RIB) to determine the best next-hop neighbor to reach the root of the multicast data distribution tree, the Rendezvous Point (RP), or the source.
Chapter 29: Route Selection Introduction................................29.2 Types of Routes..............................29.2 Interface Routes ............................29.2 Static Routes ..............................29.2 Dynamic Routes............................29.2 RIB and FIB Routing Tables ...........................29.4 Administrative Distance..........................29.4 Equal Cost Multipath Routing ......................29.5 How the AlliedWare Plus OS Adds Routes................29.7 How the AlliedWare Plus OS Deletes Routes ..............29.8 Software Reference for SwitchBlade®...
Route Selection Introduction This chapter describes the route selection process used by the AlliedWare Plus Understanding the route selection process helps in analysing and troubleshooting route-related problems. The process of routing packets consists of selectively forwarding data packets from one network to another.
Page 541
Route Selection Routing protocols use different metrics to calculate the best path for a destination. However, when two paths have an equal cost/metric and Equal Cost Multipath (ECMP) is enabled on a system, AlliedWare Plus may receive two paths from the same protocol. Routing Information Protocol (RIP) ■...
Route Selection RIB and FIB Routing Tables Your device maintains its routing information in routing tables that tell your device how to find a remote network or host. Each route is uniquely identified in a table by its IP address, network mask, next hop, interface, protocol, and policy.
Route Selection The following table lists the default administrative distances of protocols. Protocols Distance Preference Connected 1 (highest) Routes directly connected to an interface. Static Routes added using the ip route command or learnt through DHCP options on interfaces using DHCP to obtain an IP address.
Page 544
Route Selection ECMP allows the AlliedWare Plus OS to distribute traffic over multiple equal-cost routes to a destination. The software determines that two or more routes are equal cost if they have the same destination IP address and mask. When the software learns such multiple routes, it puts them in an ECMP route group.
Route Selection How the AlliedWare Plus OS Adds Routes The following flow chart shows how the software adds a route to the FIB. route_1 Start: The AlliedWare Plus OS receives a route from a routing protocol Adds route to its RIB Does the route for this prefix already...
Route Selection How the AlliedWare Plus OS Deletes Routes When the AlliedWare Plus OS receives a route delete request from a routing protocol, it first deletes the specified route from its RIB. Then it checks if the specified route is in the FIB. If the route is in the FIB, it deletes it from the FIB and checks if another route is available in its database for the same prefix.
Chapter 30: Routing Commands Introduction................................30.2 ip route ..................................30.2 maximum-paths ..............................30.3 show ip route................................30.4 show ip route database...........................30.6 show ip route summary ..........................30.7 Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1 30.1...
Routing Commands Introduction This chapter provides an alphabetized reference for the routing commands that are common across the routing IP protocols. ip route This command adds a static route to the Routing Information Base (RIB). If this route is the best route for the destination, then your device adds it to the Forwarding Information Base (FIB).
Page 549
Routing Commands maximum-paths This command enables ECMP on your device, and sets the maximum number of paths that each route has in the Forwarding Information Base (FIB). ECMP is enabled by default. The no form sets the maximum paths to the default of 4. Syntax maximum-paths <1-8>...
Routing Commands show ip route Use the show ip route command to display the current state of the routing table. This command displays the routes in the FIB. The FIB contains the best routes to a destination, and your device uses these routes when forwarding traffic. You can use this command to view a subset of the FIB based on protocol or network.
Page 551
Routing Commands Figure 30-1: Example output from the show ip route command Codes: C - connected, S - static, R - RIP, B - BGP O - OSPF, IA - OSPF inter area N1 - OSPF NSSA external type 1, N2 - OSPF NSSA external type 2 E1 - OSPF external type 1, E2 - OSPF external type 2 * - candidate default 10.10.37.0/24 [110/11] via 10.10.31.16, vlan2, 00:20:54...
Routing Commands show ip route database This command displays the routing entries in the RIB. When multiple entries are available for the same prefix, RIB uses the routes’ administrative distances to choose the best route. All best routes are entered into the FIB. To view the routes in the FIB, use the show ip route command.
Routing Commands If the static route becomes unavailable, then the device automatically selects the OSPF route and installs it in the FIB. To display the static routes in the RIB, use the command: Examples awplus# show ip route database static maximum-paths Related Commands show ip route...
Page 554
Routing Commands Software Reference for SwitchBlade® x908, x900 and x600 Series Switches 30.8 AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
Chapter 31: RIP Configuration Introduction................................31.2 Enabling RIP................................31.2 Specifying the RIP version ..........................31.3 RIPv2 authentication (single key) .......................31.4 RIPv2 text authentication (multiple keys) .....................31.6 RIPv2 md5 authentication (multiple keys)....................31.9 Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1 31.1...
This example shows the minimum configuration required for enabling two devices to exchange routing information using RIP. The routing devices in this example are Allied Telesis managed Layer 3 Switches. Switch 1 and Switch 2 are two neighbors connecting to network 10.10.11.0/24.
Configure a router to receive and send specific versions of RIP packets on an interface. The routing devices in this example are Allied Telesis managed Layer 3 Switches. In this example, Switch 2 is configured to receive and send RIP version 1 and version 2 information on both port 1.0.1and port 1.0.2 interfaces.
RIP Configuration RIPv2 authentication (single key) AlliedWare Plus RIP implementation provides the choice of configuring authentication for a single key or for multiple keys. This example illustrates authentication of the routing information exchange process for RIP using a single key. The routing devices in this example are Allied Telesis managed Layer 3 Switches.
Page 559
RIP Configuration Names of Commands Used ip rip authentication string, ip rip authentication mode, redistribute, network Validation Commands show ip rip, show running-config, show ip protocols rip, show ip rip interface, show ip route Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1...
This example illustrates text authentication of the routing information exchange process for RIP using multiple keys. The routing devices in this example are Allied Telesis managed Layer 3 Switches. Switch 1 and Switch 2 are running RIP and exchanging routing updates. To configure authentication on Switch 1, define a key chain, specify keys in the key chain and then define the authentication string or passwords to be used by the keys.
Page 561
RIP Configuration Add another authentication key (20) to the key chain awplus(config-keychain)#key 20 SUN. Specify a password (Earth) to be used by the specified awplus(config-keychain-key)#key-string Earth key. Specify the time period during which authentication key awplus(config-keychain-key)#accept-lifetime 12:00:00 Mar 7 2007 14:00:00 Mar 12 2007 string Earth can be received.
Page 562
RIP Configuration Specify the time period during which authentication key awplus(config-keychain-key)#accept-lifetime 12:00:00 Mar 7 2007 14:00:00 Mar 12 2007 string Earth can be received. In this case, key string Earth can be received from noon of March 7 to 2 pm March 12, 2007.
This example illustrates the md5 authentication of the routing information exchange process for RIP using multiple keys. The routing devices in this example are Allied Telesis managed Layer 3 Switches. Switch 1 and Switch 2 are running RIP and exchange routing updates. To configure authentication on Switch 1, define a key chain, specify keys in the key chain and then define the authentication string or passwords to be used by the keys.
Page 564
RIP Configuration Exit the keychain-key mode and return to awplus(config-keychain-key)#exit keychain mode. Add another authentication key (2) to the key chain awplus(config-keychain)#key 2 SUN. Specify a password (Earth) to be used by the awplus(config-keychain-key)#key-string Earth specified key. Specify the time period during which authentication awplus(config-keychain-key)#accept-lifetime 12:00:00 Mar 7 2007 14:00:00 Mar 12 2007 key string Earth can be received.
Page 565
RIP Configuration Specify the time period during which authentication awplus(config-keychain-key)#accept-lifetime 12:00:00 Mar 7 2007 14:00:00 Mar 12 2007 key string Earth can be received. In this case, key string Earth can be received from noon of March 7 to 2 pm March 12, 2007. Specify the time period during which authentication awplus(config-keychain-key)#send-lifetime 12:00:00 Mar 7 2007 12:00:00 Mar 12 2007...
Page 566
RIP Configuration Software Reference for SwitchBlade® x908, x900 and x600 Series Switches 31.12 AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
RIP Commands Introduction This chapter provides an alphabetized reference for each of the RIP Commands. accept-lifetime Use this command to specify the time period during which the authentication key on a key chain is received as valid. Use the no accept-lifetime command to remove a specified time period for an authentication key on a key chain as set previously with the accept-lifetime command.
Page 569
RIP Commands awplus# configure terminal awplus(config)# key chain mychain awplus(config-keychain)# key 1 awplus(config-keychain-key)# accept-lifetime 03:03:01 3 Dec 2007 04:04:02 6 Oct 2008 Related Commands key-string key chain send-lifetime clear ip rip route Use this command to clear specific data from the RIP routing table. Syntax clear ip rip route {<ip-dest-network/m>|static|connected|rip|ospf| bgp|all}...
RIP Commands debug rip Use this command to specify the options for the displayed debugging information for RIP events and RIP packets. Use the no parameter with this command to disable the specified debug option. Syntax debug rip {events|nsm|<packet>|all} no debug rip {events|nsm|<packet>|all} Parameter Description events...
Page 571
RIP Commands default-metric Use this command to specify the metrics to be assigned to redistributed routes. Use the no parameter with this command to reset the metric back to its default value (1). Syntax default-metric <metric> no default-metric <metric> no default-metric Parameter Diagnostic <1-16>...
RIP Commands distance (rip) This command sets the administrative distance for RIP routes. Your device uses this value to select between two or more routes to the same destination from two different routing protocols. The route with the smallest administrative distance value is added to the Forwarding Information Base (FIB).
Page 573
RIP Commands distribute-list Use this command to filter incoming or outgoing route updates using the access-list or the prefix-list. Use the no parameter with this command to disable this feature. Syntax distribute-list {<access-list> prefix <prefix-list> {in|out} [<ifname>] no distribute-list {<access-list> prefix <prefix-list>...
RIP Commands ip rip authentication key-chain Use this command to enable RIPv2 authentication on an interface and specify the name of the key chain to be used. Use the no parameter with this command to disable this function. Syntax ip rip authentication key-chain <key-chain-name> no ip rip authentication key-chain Parameter Description...
Page 575
RIP Commands Step 4: Set key management options: This step can be performed at this stage or later when multiple keys are used. The options are configured in the keychain-key command mode. Set the time period during which the authentication key on a key chain is received as valid, using the accept-lifetime command:...
Page 576
RIP Commands awplus(config-if)# ip rip authentication key-chain cars awplus(config-if)# ip rip authentication mode md5 awplus(confi-if)# exit awplus(config)# exit awplus# In the following example, interface VLAN23 is configured to use key-chain authentication with Example the keychain mykey. See the command for a description of how a key chain is created. awplus# configure terminal awplus(config)#...
RIP Commands ip rip authentication mode Use this command to specify the type of authentication mode used for RIP v2 packets. Use the no ip rip authentication mode command to restore clear text authentication. Syntax ip rip authentication mode {md5|text} no ip rip authentication mode {md5|text} Parameter Description...
Page 578
RIP Commands For multiple keys authentication, use the following steps to configure a route to enable RIPv2 authentication using multiple keys at different times: Step 1: Define a key chain: In the Configure mode, identify a key chain with a key chain name using the following command: awplus(config)# key chain <key-chain-name>...
Page 579
RIP Commands Step 6: Specify the mode of authentication for the given interface: In the Interface mode, specify whether the interface uses text or MD5 authentication using: awplus(config-if)# ip rip authentication mode {md5|text} In the following sample multiple keys authentication RIP configuration, a password toyota is set Example for key 1 in key chain cars.
RIP Commands ip rip authentication string Use this command to specify the authentication string or password used by a key. Use the no parameter with this command to remove the authentication string. Syntax ip rip authentication string <auth-string> no ip rip authentication string <auth-string> Parameter Description The authentication string or password used by a key.
RIP Commands ip rip authentication key-chain Related commands ip rip authentication mode ip rip receive-packet Use this command to configure the interface to enable the reception of RIP packets. Use the no parameter with this command to disable this feature. Syntax ip rip receive-packet no ip rip receive-packet...
RIP Commands ip rip receive version Use this command to specify the version of RIP packets accepted on an interface and override the setting of the version command. Use the no form of this command to use the setting specified by the version command. Syntax ip rip receive version {[1][2]} no ip rip receive version...
RIP Commands ip rip send-packet Use this command to enable sending RIP packets through the current interface. Use the no parameter with this command to disable this feature. Syntax ip rip send-packet no ip rip send-packet Send packet is enabled Default Interface mode Mode...
RIP Commands ip rip send version 1-compatible Use this command to send RIP version 1 compatible packets from a version 2 RIP interface. This mechanism causes version 2 RIP to broadcast the packets instead of multicasting them. Use the no parameter with this command to use the global RIP version control rules. Syntax ip rip send version 1-compatible Disabled...
Page 585
RIP Commands Use this command to manage, add and delete authentication keys in a key-chain. Use the no key command to delete the authentication key. Syntax key <keyid> no key <keyid> Parameter Description <0-2147483647> Key identifier number <keyid> Keychain mode Mode This command allows you to enter the keychain-key mode where a password can be set for Usage...
RIP Commands key chain Use this command to enter the key chain management mode and to configure a key chain with a key chain name. Use the no parameter on this command to remove the key chain and all configured keys. Syntax key chain <key-chain-name>...
Page 587
RIP Commands key-string Use this command to define the password to be used by a key. Use the no parameter to remove a password. Syntax key-string <key-password> no key-string <key-password> Parameter Description <key-password> A string of characters to be used as a password by the key. Keychain-key mode Mode Use this command to specify passwords for different keys.
Page 588
RIP Commands maximum-prefix Use this command to configure the maximum number of RIP routes stored in the routing table. Use the no parameter with this command to disable all limiting of the number of RIP routes stored in the routing table. Syntax maximum-prefix <maxprefix>...
Page 589
RIP Commands neighbor Use this command to specify a neighbor router. It is used for each router to which you wish to send unicast RIP updates. Use the no parameter with this command to stop sending unicast updates to the specific router.
Page 590
RIP Commands network Use this command to specify a network or interface as one that runs Routing Information Protocol (RIP). Use the no parameter with this command to remove the specified network or interface as one that runs RIP. Syntax network {<ip-address>|<interface>} no network {<ip-address>...
Page 591
RIP Commands offset-list Use this command to add an offset to in and out metrics to routes learned through RIP. Use the no parameter with this command to remove the offset list. Syntax offset-list <access_list> {in|out} <offset> [<interface>] no offset-list <access_list> {in|out} <offset> [<interface>] Parameter Description Specifies the access-list number or names to apply.
Page 592
RIP Commands passive-interface Use this command to block RIP broadcasts on the interface. Use the no parameter with this command to disable this function Syntax passive-interface <interface> no passive-interface <interface> Parameter Description Specifies the interface name. <interface> Disabled Default Router mode Mode Example awplus#...
Page 593
RIP Commands redistribute Use this command to redistribute information from other routing protocols into RIP. Using the no parameter with this command will disable the specified redistribution. The parameters metric and routemap may be used on this command, but have no effect. Syntax redistribute {connected|static|ospf|bgp}[metric <0-16>][routemap <word>]...
RIP Commands restart rip graceful Use this command to force the RIP process to restart. Syntax restart rip graceful [grace-period <1-65535>] Privileged Exec mode Mode After this command is executed, the RIP process immediately shuts down. It notifies the system Usage that RIP has performed a graceful shutdown.
Page 595
RIP Commands route Use this command to configure static RIP routes. Use the no parameter with this command to disable this function. Syntax route <ip-address/m> no route <ip-address/m> Parameter Description <ip-address/m> The IP address and subnet mask, entered in the form A.B.C.D/M. Where M is the subnet mask length.
RIP Commands router rip Use this global command to enable the RIP routing process. Use the no parameter with this command to disable the RIP routing process. Syntax router rip no router rip Global Configuration mode Mode This command is used to begin the RIP routing process: Example awplus# configure terminal...
Page 597
RIP Commands send-lifetime Use this command to specify the time period during which the authentication key on a key chain can be sent. Syntax send-lifetime <start-date>{<end-date>|duration <seconds>|infinite} no send-lifetime Parameter Description <start- Specifies the start period - time and date in the format DD MMM YYYY or date>...
RIP Commands show debugging rip Use this command to display the RIP debugging status for these debugging options: nsm debugging, RIP event debugging, RIP packet debugging and RIP nsm debugging. To modify the lines displayed, use the | (output modifier token); to save the output to a file use the >...
RIP Commands show ip rip Use this command to show RIP routes. To modify the lines displayed, use the | (output modifier token); to save the output to a file use the > output redirection token. Syntax show ip rip Exec mode and Privileged Exec mode Mode Example...
RIP Commands show ip rip interface Use this command to display information about the RIP interfaces. You can specify an interface name to display information about a specific interface. To modify the lines displayed, use the | (output modifier token); to save the output to a file use the >...
Page 601
RIP Commands timers Use this command to adjust routing network timers. Use the no parameter with this command to restore the defaults. Syntax timers basic <update> <timeout> <garbage> no timers basic Parameter Description <5-2147483647> Specifies the period at which RIP route update packets <update>...
RIP Commands undebug rip Use this command to disable the options set for debugging information of RIP events, packets and communication between RIP and NSM. This command has the same effect as the no debug rip command. Syntax undebug rip {all|events|nsm|<packet>} Parameter Description Disables all RIP debugging.
Page 603
RIP Commands version Use this command to specify a RIP version used globally by the router. Use the no parameter with this command to restore the default version. Syntax version {1|2} no version Parameter Description Specifies the version of RIP processing. Default is RIP v2. Version 2 Default Router mode...
Page 604
RIP Commands Software Reference for SwitchBlade® x908, x900 and x600 Series Switches 32.38 AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
Chapter 33: RIPng Configuration Introduction................................33.2 Enabling RIPng...............................33.2 Troubleshooting RIPng Adjacency ......................33.4 Step 1. Confirm the Interface is not shutdown.................33.4 Step 2. Confirm RIPng is enabled on the Interface..............33.4 Step 3. Check the Interface is not a Passive Interface............33.5 Step 4. Ensure RIPng Advertisements get exchanged............33.5 Software Reference for SwitchBlade®...
RIPng Configuration Introduction This chapter contains a basic RIPng configuration example. To see details on the RIPng commands used in these examples, or to see the outputs of the Validation commands, refer to Chapter 34, RIPng Commands. Enabling RIPng This example shows the minimum configuration required for enabling RIPng on an interface. Switch 1 and Switch 2 are two switches connecting to network 3ffe:11::/64.
Page 607
RIPng Configuration Switch 2 Enter the Configure mode. awplus#configure terminal Specify the interface (vlan5) and enter the awplus(config)#interface vlan5 Interface mode. awplus(config-if)#ipv6 router rip Enable RIPng routing on interface vlan5 awplus(config-if)#exit Exit Interface mode and enter Configure mode. awplus(config)#interface vlan4 Specify the interface (vlan4) and enter the Interface mode.
RIPng Configuration Troubleshooting RIPng Adjacency Follow the steps below to troubleshoot RIPng adjacency: Step 1. Confirm the Interface is not shutdown Enter the Configure mode. awplus#configure terminal Specify the interface (vlan2) and enter the awplus(config)#interface vlan2 Interface mode. Ensure the interface is not administratively shutdown. awplus(config-if)#no shutdown Exit Interface mode and enter Configure awplus(config-if)#exit...
RIPng Configuration Step 3. Check the Interface is not a Passive Interface Check the interface is not configured as a passive awplus#show running-config interface using show running-config command. passive interface <interface-name> displays in the config if it is configured to be passive. router ipv6 rip passive interface vlan2 Enter the Configure mode.
Page 610
RIPng Configuration Software Reference for SwitchBlade® x908, x900 and x600 Series Switches 33.6 AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
RIPng Commands Introduction RIPng is a new feature of this software release RIPng Commands Feature vs_531%flag RIPng Commands This chapter contains AlliedWare Plus RIPng commands. RIPng (Routing Information Protocol next generation) is an extension of RIPv2 to support IPv6. RFC 2080 specifies RIPng. The differences between RIPv2 and RIPng are: ■...
RIPng Commands clear ipv6 rip route clear ipv6 rip route Command vs_531 %flag RIPng Commands Use this command to clear specific data from the RIPng routing table. Use this command to clear specific data from the RIPng routing table. Syntax clear ipv6 rip route {<ipv6-addr/prefix-length>|all|connected|rip| static} Parameter...
RIPng Commands debug ipv6 rip debug ipv6 rip Command vs_531 %flag RIPng Commands Use this command to enable RIPng debugging and specify debugging for RIPng events, RIPng packets, or RIPng NSM communication. Use this command to enable RIPng debugging and specify debugging for RIPng events, RIPng packets, or RIPng communication with NSM processes.
RIPng Commands default-information originate (IPv6) default-information originate (IPv6)Command vs_531 %flag RIPng Commands Use this command to generate a default route into RIPng. Use this command to generate a default route into RIPng. Use the no parameter with this command to disable this feature. Syntax default-information originate no default-information originate...
RIPng Commands distribute-list (IPv6) distribute-list (IPv6) Command vs_531 %flag RIPng Commands Use this command to filter incoming or outgoing route updates using the access-list or the prefix-list. Use this command to filter incoming or outgoing route updates using the access-list or the prefix-list.
RIPng Commands ipv6 rip split-horizon ipv6 rip split-horizon Command vs_531 %flag RIPng Commands Use this command to avoid including routes in updates sent to the same gateway from which they were learned. Use this command to perform the split-horizon action on the interface. The default is split- horizon with poisoned reverse.
RIPng Commands ipv6 router rip ipv6 router rip Command vs_531 %flag RIPng Commands Use this command to enable RIPng routing on the interface. Use this command to enable RIPng routing on the interface. Use the no parameter with this command to disable RIPng routing. Syntax ipv6 router rip no ipv6 router rip...
RIPng Commands neighbor (IPv6) neighbor (IPv6) Command vs_531 %flag RIPng Commands Use this command to specify a neighbor router. Use this command to specify a neighbor router. Use the no parameter with this command to disable the specific router. Syntax neighbor <ipv6-link-local-addr>...
RIPng Commands offset-list (IPv6) offset-list (IPv6) Command vs_531 %flag RIPng Commands Use this command to add an offset to in and out metrics to routes learned through RIPng. Use this command to add an offset to in and out metrics to routes learned through RIPng. Use the no parameter with this command to remove an offset list.
RIPng Commands passive-interface (IPv6) passive-interface (IPv6) Command vs_531 %flag RIPng Commands Use this command to enable suppression of routing updates on an interface. Use this command to enable suppression of routing updates on an interface. Use the no parameter with this command to disable this function. Syntax passive-interface <ifname>...
RIPng Commands redistribute (IPv6) redistribute (IPv6) Command vs_531 %flag RIPng Commands Use this command to redistribute information from other routing protocols into RIPng. Use this command to redistribute information from other routing protocols into RIPng. Use the no parameter with this command to disable the specified redistribution. The parameters metric and routemap may be used on this command, but have no effect.
RIPng Commands route (IPv6) route (IPv6) Command vs_531 %flag RIPng Commands Use this command to configure static RIPng routes. Use this command to configure static RIPng routes. Use the no parameter with this command to disable this function. Syntax route <ipv6-addr/prefix-length> no route <ipv6-addr/prefix-length>...
RIPng Commands router ipv6 rip router ipv6 rip Command vs_531 %flag RIPng Commands Use this global command to enable a RIPng routing process. Use this global command to enable a RIPng routing process. Use the no parameter with this command to disable the RIPng routing process. Syntax router ipv6 rip no router ipv6 rip...
RIPng Commands show ipv6 protocols rip show ipv6 protocols rip Command vs_531 %flag RIPng Commands Use this command to display RIPng process parameters and statistics. Use this command to display RIPng process parameters and statistics. To modify the lines displayed, use the | (output modifier token); to save the output to a file use the >...
RIPng Commands show ipv6 rip show ipv6 rip Command vs_531 %flag RIPng Commands Use this command to show RIPng routes. Use this command to show RIPng routes. To modify the lines displayed, use the | (output modifier token); to save the output to a file use the >...
RIPng Commands show ipv6 rip database show ipv6 rip database Command vs_531 %flag RIPng Commands Use this command to display information about the RIPng database. Use this command to display information about the RIPng database. To modify the lines displayed, use the | (output modifier token); to save the output to a file use the >...
RIPng Commands show ipv6 rip interface show ipv6 rip interface Command vs_531 %flag RIPng Commands Use this command to display information about the RIPng interfaces. Use this command to display information about the RIPng interfaces. You can specify an interface name to display information about a specific interface. To modify the lines displayed, use the | (output modifier token);...
RIPng Commands timers (IPv6) timers (IPv6) Command vs_531 %flag RIPng Commands Use this command to adjust the RIPng routing network timers. Use this command to adjust the RIPng routing network timers. Use the no parameter with this command to restore the defaults. Syntax timers basic <update>...
RIPng Commands undebug ipv6 rip undebug ipv6 rip Command vs_531 %flag RIPng Commands Use this command to disable debugging options of RIPng events, RIPng packets, and communication between RIPng and NSM processes. Use this command to disable debugging options of RIPng events, RIPng packets, and communication between RIPng and NSM processes.
Chapter 35: OSPF Configuration Introduction................................35.2 Terminology................................35.2 Enabling OSPF on an Interface........................35.3 Setting priority ..............................35.4 Configuring an Area Border Router......................35.6 Redistributing routes into OSPF.........................35.7 OSPF Cost ................................35.8 Configuring Virtual Links ..........................35.10 OSPF Authentication............................. 35.11 Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1...
The following is a brief description of terms and concepts used to describe the OSPF protocol: OSPF Router Any Layer 3 routing device that is running OSPF, such as an Allied Telesis managed Layer 3 switch or Allied Telesis router.
This example shows the minimum configuration required for enabling OSPF on an interface. In this example, the OSPF routers are Allied Telesis managed Layer 3 switches. Switch 1 and Switch 2 are two OSPF routers in Area 0 connecting to network 10.10.10.0/24.
OSPF router to make it the Designated Router (DR). In this example, the OSPF routers are Allied Telesis managed Layer 3 switches. Switch 3 is configured to have a priority of 10, which is higher than the default priority (default priority is 1) of Switch 1 and Switch 2;...
Page 635
OSPF Configuration Switch 3 Specify the interface (vlan2)to be configured. awplus(config)#interface vlan2 Specify the router priority to a higher priority (10) to make awplus(config-if)#ip ospf priority 10 Switch 3 the Designated Router (DR). Exit the Interface mode and return to the Configure awplus(config-if)#exit mode.
This example shows configuration for an Area Border Router (ABR). In this example, the OSPF routers are Allied Telesis managed Layer 3 switches. Switch 2 is an ABR, where interface vlan2 is in Area 0 and interface vlan3 is in Area 1.
In this example the configuration causes BGP routes to be imported into the OSPF routing table and advertised as Type 5 External LSAs into Area 0. In this example, the OSPF routers, labelled “Device 1-5” represent any Allied Telesis managed Layer 3 switches or Allied Telesis routers.
You can make a route the preferred route by changing its cost. In this example, the OSPF routers are Allied Telesis managed Layer 3 switches. The cost has been configured to make Switch 2 the next hop for Switch 1.
Page 639
OSPF Configuration Switch 3 Specify the interface (vlan3)to be configured. awplus(config)#interface vlan3 Set the OSPF cost of this link to 100. awplus(config-if)#ip ospf cost 150 Exit the Interface mode and return to Configure awplus(config-if)#exit mode. Configure the Routing process and specify the Process ID awplus(config)#router ospf 100 (100).
In this example, the OSPF routers shown represent any Allied Telesis managed Layer 3 switches or Allied Telesis routers. In the network below, there is no area border router that connects Area2 to the backbone. So a virtual link needs to be created between ABR Device 1 and ABR Device 2 to connect Area 2 to Area 0.
Commands for OSPF authentication commands. In this example, the OSPF routers are Allied Telesis managed Layer 3 switches. Switch 1 and Switch 2 are configured for both the interface and area authentications. The authentication type of interface vlan2 on Switch 1 and interface vlan2 on Switch 2 is md5 mode and is defined by the area authentication command;...
Page 642
OSPF Configuration Switch 2 port1.0.1 10.10.11.50 10.10.10.50/24 Area 0 port1.0.2 port1.0.1 10.10.10.10/24 port1.0.2 Switch 1 10.10.11.10 ospf_7 Switch 1 Enter the Configure mode. awplus#configure terminal awplus(config)#router ospf 100 Configure the Routing process and specify the Process ID (100). The Process ID should be a unique positive integer identifying the routing process.
Page 643
OSPF Configuration Switch 2 Enter the Configure mode. awplus#configure terminal Configure the Routing process and specify the Process ID awplus(config)#router ospf 100 (100). The Process ID should be a unique positive integer identifying the routing process. Define interfaces on which OSPF runs and associate the awplus(config-router)#network 10.10.10.0/ 24 area 0 area ID (0) with the interface (area ID 0 specifies the...
Page 644
OSPF Configuration Software Reference for SwitchBlade® x908, x900 and x600 Series Switches 35.14 AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
Chapter 36: OSPF Commands Introduction................................36.3 area authentication.............................36.3 area default-cost ..............................36.4 area filter-list................................36.5 area nssa...................................36.6 area range................................36.8 area stub...................................36.9 area virtual-link..............................36.10 auto-cost reference bandwidth ....................... 36.12 bandwidth................................36.13 capability opaque ............................. 36.13 capability restart..............................36.14 clear ip ospf process............................36.14 compatible rfc1583............................
Page 646
OSPF Commands ospf restart helper............................36.48 ospf router-id..............................36.49 overflow database............................36.50 overflow database external ........................36.51 passive-interface ..............................36.52 redistribute................................36.53 restart ospf graceful............................36.54 router ospf ................................36.54 router-id.................................36.55 show debugging ospf............................36.55 show ip ospf................................36.56 show ip ospf border-routers ........................36.58 show ip ospf database ...........................36.59 show ip ospf database asbr-summary ....................36.60 show ip ospf database external........................36.61 show ip ospf database network.......................36.62 show ip ospf database nssa-external.....................36.64...
OSPF Commands Introduction This chapter provides an alphabetical reference for each of the OSPF Commands. area authentication Use this command to enable authentication for an OSPF area. By default, no authentication occurs. Specifying the area authentication sets the authentication to Type 1 authentication or the Simple Text password authentication (details in RFC 2328).
OSPF Commands area default-cost This command specifies a cost for the default summary route sent into a stub or NSSA area. The default-cost option provides the metric for the summary default route, generated by the area border router, into the NSSA or stub area. Use this option only on an area border router that is attached to the NSSA or stub area.
OSPF Commands area filter-list This command configures filters to advertise summary routes on Area Border Routers (ABR). This command is used to suppress particular intra-area routes from/to an area to/from the other areas. You can use this command in conjunction with either the access-list or prefix-list command.
OSPF Commands area nssa This command sets an area as a Not-So-Stubby-Area (NSSA). By default, no NSSA area is defined. Use this command to simplify administration if you are connecting a central site using OSPF to a remote site that is using a different routing protocol. You can extend OSPF to cover the remote connection by defining the area between the central router and the remote router as an NSSA.
Page 651
OSPF Commands Examples awplus# configure terminal awplus(config)# router ospf 100 awplus(config-router)# area 0.0.0.51 nssa awplus(config-router)# area 3 nssa translator-role candidate no- redistribution default-information- originate metric 34 metric-type 2 area default-cost Related Commands Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1...
OSPF Commands area range This command summarizes OSPF routes at an area boundary. By default, this feature is disabled. The area range command is used to summarize intra-area routes for an area. The set of summary routes created by this command are then advertised to other areas by the Area Border Routers (ABRs).
OSPF Commands area stub This command defines an OSPF area as a stub area. By default, no stub area is defined. Use this command when routers in the area do not require learning about summary LSAs from other areas. You can define the area as a totally stubby area by configuring the Area Border Router of that area using the area stub no-summary command.
OSPF Commands area virtual-link This command configures a link between two backbone areas that are physically separated through other nonbackbone areas. In OSPF, all non-backbone areas must be connected to a backbone area. If the connection to the backbone is lost, the virtual link repairs the connection. The no form removes the virtual link.
Page 655
OSPF Commands Parameter Description Use message-digest authentication. message-digest Use null authentication to override password or message digest. null If no packets are received from a particular neighbor for dead-interval dead-interval seconds, the router considers that neighboring router as being off-line. Default: 40 seconds The number of seconds in the interval.
OSPF Commands auto-cost reference bandwidth This command controls how OSPF calculates default metrics for the interface. By default, OSPF calculates the OSPF metric for an interface by dividing the reference bandwidth by the interface bandwidth. The default value for the reference bandwidth is 100 Mbps.
OSPF Commands bandwidth Use this command to specify the maximum bandwidth to be used for each interface. The bandwidth value is in bits. OSPF uses this to calculate metrics for the interface. The no form removes the maximum bandwidth. Syntax bandwidth <bandwidth-setting>...
OSPF Commands capability restart This command enables OSPF graceful restart or restart signaling features. By default, this is enabled. The no form of this command to disables OSPF graceful restart and restart signalling features. Syntax capability restart [graceful|signaling] no capability restart Parameter Description graceful...
OSPF Commands compatible rfc1583 This command changes the method used to calculate summary route to the that specified in RFC 1583. By default, OSPF uses the method specified in RFC 2328. RFC 1583 specifies a method for calculating the metric for summary routes based on the minimum metric of the component paths available.
OSPF Commands debug ospf events This command enables OSPF debugging for OSPF event troubleshooting. To enable all debugging options, specify debug ospf event with no additional parameters. The no and undebug form disables OSPF debugging. Use this command without parameters to disable all the options.
OSPF Commands debug ospf ifsm This command specifies debugging options for OSPF Interface Finite State Machine (IFSM) troubleshooting. To enable all debugging options, specify debug ospf ifsm with no additional parameters. The no and undebug form disables OSPF IFSM debugging. Use this command without parameters to disable all the options.
OSPF Commands debug ospf lsa This command enables debugging options for OSPF Link State Advertisements (LSA) troubleshooting. This displays information related to internal operations of LSAs. To enable all debugging options, specify debug ospf lsa with no additional parameters. The no and undebug form disables OSPF LSA debugging. Use this command without parameters to disable all the options.
OSPF Commands debug ospf nfsm This command enables debugging options for OSPF Neighbor Finite State Machines (NFSMs). To enable all debugging options, specify debug ospf nfsm with no additional parameters. The no and undebug form disables OSPF NFSM debugging. Use this command without parameters to disable all the options.
OSPF Commands debug ospf nsm This command enables debugging options for the OSPF Network Service Module. To enable both debugging options, specify debug ospf nsm with no additional parameters. The no and undebug form disables OSPF NSM debugging. Use this command without parameters to disable both options.
OSPF Commands debug ospf packet This command enables debugging options for OSPF packets. To enable all debugging options, specify debug ospf packet with no additional parameters. The no and undebug form disables OSPF packet debugging. Use this command without parameters to disable all options. Syntax debug ospf packet [dd] [detail] [hello] [ls-ack] [ls-request] [ls-update] [recv] [send]...
OSPF Commands debug ospf route This command enables debugging of route calculation. Use this command without parameters to turn on all the options. To enable all debugging options, specify debug ospf routet with no additional parameters. The no and undebug form disables OSPF route debugging. Use this command without parameters to disable all options.
Page 667
OSPF Commands default-information originate This command creates a default external route into an OSPF routing domain. When you use the default-information originate command to redistribute routes into an OSPF routing domain, then the system acts like an Autonomous System Boundary Router (ASBR) .
Page 668
OSPF Commands default-metric This command sets default metric values for the OSPF routing protocol. A default metric facilitates redistributing routes even with incompatible metrics. If the metrics do not convert, the default metric provides an alternative and enables the redistribution to continue.
OSPF Commands distance (ospf) This command sets the administrative distance for OSPF routes based on the route type. Your device uses this value to select between two or more routes to the same destination from two different routing protocols. The route with the smallest administrative distance value is added to the Forwarding Information Base (FIB).
Page 670
OSPF Commands distribute-list This command applies a filter to the choice of routes that will be redistributed from another routing protocol into OSPF. The no form of this command removes the distribute command. Syntax distribute-list <list-name> in distribute-list <list-name> out {bgp|connected|rip|static} no distribute-list <list-name>...
OSPF Commands host area This command configures a stub host entry belonging to a particular area. You can use this command to advertise specific host routes in the router-LSA as stub link. Since stub host belongs to the specified router, specifying cost is optional. By default, no host entry is configured.
OSPF Commands ip ospf authentication This command sets the authentication method used when sending and receiving OSPF packets on the current interface. The default is to use no authentication. If no authentication method is specified in this command, then plain text authentication will be used.
OSPF Commands ip ospf authentication-key This command specifies an OSPF authentication password for the neighboring routers. This command creates a password (key) that is inserted into the OSPF header when AlliedWare Plus software originates routing protocol packets. Assign a separate password to each network for different interfaces.
OSPF Commands ip ospf cost This command explicitly specifies the cost of the link-state metric in a router-LSA. The interface cost indicates the overhead required to send packets across a certain interface. This cost is stated in the Router-LSA’s link. Typically, the cost is inversely proportional to the bandwidth of an interface.
OSPF Commands ip ospf database-filter This command turns on the LSA database-filter for a particular interface. OSPF floods new LSAs over all interfaces in an area, except the interface on which the LSA arrives. This redundancy ensures robust flooding. However, too much redundancy can waste bandwidth and might lead to excessive link and CPU usage in certain topologies, resulting in destabilizing the network.
OSPF Commands ip ospf dead-interval The dead-interval is the amount of time that OSPF waits to receive an OSPF hello packet from the neighbor before declaring the neighbor is down. This value is advertised in the router’s hello packets. It must be a multiple of the hello-interval and be the same for all routers on a specific network.
OSPF Commands ip ospf hello-interval This command specifies the interval between hello packets. The hello-interval is advertised in the hello packets. Configure the same hello-interval for all routers on a specific network. A shorter hello interval ensures faster detection of topological changes, but results in more routing traffic.
OSPF Commands ip ospf message-digest-key This command registers an MD5 key for OSPF MD5 authentication. Message Digest Authentication is a cryptographic authentication. A key (password) and key-id are configured on each router. The router uses an algorithm based on the OSPF packet, the key, and the key-id to generate a message digest that gets appended to the packet.
OSPF Commands The following example shows configuring OSPF authentication on the interface VLAN2 for the IP address 1.1.1.1. (If the interface has two IP addresses assigned-- 1.1.1.1 & 2.2.2.2, OSPF authentication will be enabled only for the IP address 1.1.1.1) awplus# configure terminal awplus(config)#...
OSPF Commands ip ospf mtu-ignore Use this command to configure OSPF so that it does not check the MTU size during DD (Database Description) exchange. By default, during DD exchange process, OSPF checks the MTU size described in DD packets received from the neighbor.
OSPF Commands ip ospf network This command configures the OSPF network type to a type different from the default for the particular interface. This command forces the interface network type to the specified type. Depending on the network type, OSPF changes the behaviour of the packet transmission and the link description in LSAs.
OSPF Commands ip ospf priority This command sets the router priority, which is a parameter used in the election of the designated router for the network. The no form of this command returns the router priority to the default of 1. Syntax ip ospf [<ip_address>] priority <priority>...
OSPF Commands ip ospf resync-timeout Use this command to set the interval after which adjacency is reset if out-of-band resynchronization has not occurred. The interval period starts from the time a restart signal is received from a neighbor. Use the no parameter with this command to return to the default value. Syntax ip ospf [<ip_address>] resync-timeout <1-65535>...
OSPF Commands ip ospf retransmit-interval Use this command to specify the time between link-state advertisement (LSA) retransmissions for adjacencies belonging to the interface. Use the no parameter with this command to return to the default value of 5 seconds. Syntax ip ospf [<ip_address>] retransmit-interval <interval>...
OSPF Commands ip ospf transmit-delay Use this command to set the estimated time it takes to transmit a link-state-update packet on the interface. Use the no parameter with this command to return to the default value of 1 second. Syntax ip ospf [<ip_address>] transmit-delay <delay>...
Page 686
OSPF Commands max-concurrent-dd Use this command to set the limit for the number of Database Descriptors (DD) that can be processed concurrently. Use the no max-concurrent-dd command to reset the limit for the number of Database Descriptors (DD) that can be processed concurrently. Syntax max-concurrent-dd <1-65535>...
Page 687
OSPF Commands maximum-area Use this command to set the maximum number of OSPF areas. Use the no maximum-area command to set the maximum number of OSPF areas to the default value. The default value for the maximum number of OSPF areas is 4294967294. Syntax maximum-area <1-4294967294>...
Page 688
OSPF Commands neighbor Use this command to inform the router of other neighboring routers that are connected to the same NBMA network. Use the no parameter with this command to remove a configuration. Syntax neighbor <ip_address> [<cost>]{<priority>|<poll-interval>} no neighbor <ip_address> [<cost>]{<priority>|<poll-interval>} Parameter Description <ip_address>...
OSPF Commands network area Use this command to enable OSPF routing with a specified Area ID on interfaces with IP addresses that match the specified network address. Use the no parameter with this command to disable OSPF routing on the interfaces. Syntax network <network_address>...
OSPF Commands ospf abr-type Use this command to set an OSPF Area Border Router (ABR) type. Use the no parameter with this command to revert the ABR type to the default setting (Cisco). Syntax ospf abr-type {cisco|ibm|standard} no ospf abr-type {cisco|ibm|standard} Parameter Description cisco...
OSPF Commands ospf restart grace-period Use this command to configure the Grace Period for restarting OSPF. Use the no parameter with this command to revert to default. Syntax ospf restart grace-period <1-1800> no ospf restart grace-period Parameter Description Specifies the grace period in seconds. <1-1800>...
OSPF Commands ospf restart helper Use this command to configure the helper behavior for the OSPF Graceful Restart feature. Use the no parameter with this command to revert to the default. Syntax ospf restart helper {max-grace-period <1-1800>|never|only-reload|only-upgrade} no ospf restart helper [max-grace-period] Parameter Description Help only if received grace-period is less than specified value...
OSPF Commands ospf router-id Use this command to specify a router ID for the OSPF process. Use the no parameter with this command to disable this function. Syntax ospf router-id <ip_address> no ospf router-id Parameter Description Specifies the router ID in IPv4 address format. <ip_address>...
OSPF Commands overflow database Use this command to limit the maximum number of Link State Advertisements (LSAs) that can be supported by the current OSPF instance. Use the no parameter with this command to have no limit on the maximum number of LSAs. Syntax overflow database <0-4294967294>...
OSPF Commands overflow database external Use this command to configure the size of the external database and the time the router waits before it tries to exit the overflow state. Use the no parameter with this command to revert to default. Syntax overflow database external <max_lsas>...
Page 696
OSPF Commands passive-interface Use this command to suppress the sending of Hello packets on the specified interface. Use the no passive-interface command to allow the sending of Hello packets on the specified interface. Syntax passive-interface {<interface>}[<ip_address>] no passive-interface {<interface>}[<ip_address>] Parameter Description <interface>...
Page 697
OSPF Commands redistribute Use this command to redistribute routes from other routing protocols, static routes and connected routes into an ospf routing table. Use the no parameter with this command to disable this function. Syntax redistribute {<protocol>} {METRIC|METRIC-TYPE|ROUTE-MAP|TAG} no redistribute {<protocol>} {METRIC|METRIC-TYPE|ROUTE-MAP|TAG} Parameter Description <protocol>...
OSPF Commands restart ospf graceful Use this command to force the OSPF process to restart. Syntax restart ospf graceful [grace-period <1-1800>] Privileged Exec mode Mode After this command is executed, the OSPF process immediately shuts down. It notifies the Usage system that OSPF has performed a graceful shutdown.
OSPF Commands router-id Use this command to specify a router ID for the OSPF process. Use the no parameter with this command to force OSPF to use the previous OSPF router-id behavior. Syntax router-id <ip_address> no router-id Parameter Description <ip_address> Specifies the router ID in IPv4 address format.
OSPF Commands show ip ospf Use this command to display general information about all OSPF routing processes. Include the process ID parameter with this command to display information about specified instances. To modify the lines displayed, use the | (output modifier token) ; to save the output to a file, use the >...
Page 701
OSPF Commands Figure 36-3: Example output from the show ip ospf <process_id> command Routing Process "ospf 100" with ID 10.10.11.146 Process uptime is 0 minute Conforms to RFC2328, and RFC1583Compatibility flag is disabled Supports only single TOS(TOS0) routes Supports opaque LSA SPF schedule delay 5 secs, Hold time between two SPFs 10 secs Refresh timer 10 secs Number of external LSA 0.
OSPF Commands show ip ospf border-routers Use this command to display the ABRs and ASBRs for all OSPF instances. Include the process ID parameter with this command to view data about specified instances. To modify the lines displayed, use the | (output modifier token) ; to save the output to a file, use the >...
OSPF Commands show ip ospf database Use this command to display a database summary for OSPF information. This command displays BGP tags for prefixes. Include the process ID parameter with this command to display information about specified instances. To modify the lines displayed, use the | (output modifier token) ; to save the output to a file, use the >...
OSPF Commands show ip ospf database asbr-summary Use this command to display information about the Autonomous System Boundary Router (ASBR) summary LSAs. To modify the lines displayed, use the | (output modifier token) ; to save the output to a file, use the >...
OSPF Commands show ip ospf database external Use this command to display information about the external LSAs. To modify the lines displayed, use the | (output modifier token) ; to save the output to a file, use the > output redirection token. Syntax show ip ospf database external [<ip-address>] [self-originate|<advrouter>]...
OSPF Commands show ip ospf database network Use this command to display information about the network LSAs. To modify the lines displayed, use the | (output modifier token) ; to save the output to a file, use the > output redirection token. Syntax show ip ospf database network [<ip-address>] [self-originate|<advrouter>]...
Page 707
OSPF Commands Figure 36-9: Example output from the show ip ospf database network command OSPF Router process 200 with ID (192.30.30.2) Net Link States (Area 0.0.0.0) LS age: 1175 Options: 0x2 (*|-|-|-|-|-|E|-) LS Type: network-LSA Link State ID: 192.10.10.9 (address of Designated Router) Advertising Router: 192.30.30.3 LS Seq Number: 80000002 Checksum: 0xdfb1...
OSPF Commands show ip ospf database nssa-external Use this command to display information about the NSSA external LSAs. To modify the lines displayed, use the | (output modifier token) ; to save the output to a file, use the > output redirection token. Syntax show ip ospf database nssa-external [<ip-address>] [self-originate|<advrouter>]...
Page 709
OSPF Commands Examples awplus# show ip ospf database nssa-external 1.2.3.4 self-originate awplus# show ip ospf database nssa-external self-originate awplus# show ip ospf database nssa-external 1.2.3.4 adv-router 2.3.4.5 Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1 36.65...
OSPF Commands show ip ospf database opaque-area Use this command to display information about the area-local (link state type 10) scope LSAs. Type-10 Opaque LSAs are not flooded beyond the borders of their associated area. To modify the lines displayed, use the | (output modifier token) ; to save the output to a file, use the >...
OSPF Commands show ip ospf database opaque-as Use this command to display information about the link-state type 11 LSAs. This type of link- state denotes that the LSA is flooded throughout the Autonomous System (AS). To modify the lines displayed, use the | (output modifier token) ; to save the output to a file, use the >...
OSPF Commands show ip ospf database opaque-link Use this command to display information about the link-state type 9 LSAs. This type denotes a link-local scope. The LSAs are not flooded beyond the local network. To modify the lines displayed, use the | (output modifier token) ; to save the output to a file, use the >...
OSPF Commands show ip ospf database router Use this command to display information only about the router LSAs. To modify the lines displayed, use the | (output modifier token) ; to save the output to a file, use the > output redirection token. Syntax show ip ospf database router [<ip-address>] [self-originate|<advrouter>]...
OSPF Commands show ip ospf database summary Use this command to display information about the summary LSAs. To modify the lines displayed, use the | (output modifier token) ; to save the output to a file, use the > output redirection token. Syntax show ip ospf database summary [<ip-address>] [self-originate|<advrouter>]...
Page 715
OSPF Commands Figure 36-16: Example output from the show ip ospf database summary self-originate command OSPF Router process 100 with ID (10.10.11.50) Summary Link States (Area 0.0.0.0) LS age: 1061 Options: 0x2 (*|-|-|-|-|-|E|-) LS Type: summary-LSA Link State ID: 10.10.11.0 (summary Network Number) Advertising Router: 10.10.11.50 LS Seq Number: 80000001 Checksum: 0x36ac...
Page 716
OSPF Commands Figure 36-17: Example output from the show ip ospf database summary adv-router <ip-address> command OSPF Router process 100 with ID (10.10.11.50) Summary Link States (Area 0.0.0.0) LS age: 989 Options: 0x2 (*|-|-|-|-|-|E|-) LS Type: summary-LSA Link State ID: 10.10.11.0 (summary Network Number) Advertising Router: 10.10.11.50 LS Seq Number: 80000001 Checksum: 0x36ac...
OSPF Commands show ip ospf interface Use this command to display interface information for OSPF. To modify the lines displayed, use the | (output modifier token) ; to save the output to a file, use the > output redirection token. Syntax show ip ospf interface <interface-name>...
OSPF Commands show ip ospf neighbor Use this command to display information on OSPF neighbors. Include the process ID parameter with this command to display information about specified instances. To modify the lines displayed, use the | (output modifier token) ; to save the output to a file, use the >...
Page 719
OSPF Commands Figure 36-21: Example output from the show ip ospf neighbor detail command Neighbor 10.10.10.50, interface address 10.10.10.50 In the area 0.0.0.0 via interface vlan5 Neighbor priority is 1, State is Full, 5 state changes DR is 10.10.10.50, BDR is 10.10.10.10 Options is 0x42 (*|O|-|-|-|-|E|-) Dead timer due in 00:00:38 Neighbor is up for 00:53:07...
OSPF Commands show ip ospf route Use this command to display the OSPF routing table. Include the process ID parameter with this command to display the OSPF routing table for specified instances. To modify the lines displayed, use the | (output modifier token) ; to save the output to a file, use the >...
OSPF Commands show ip ospf virtual-links Use this command to display virtual link information. To modify the lines displayed, use the | (output modifier token) ; to save the output to a file, use the > output redirection token. Syntax show ip ospf virtual-links Exec mode and Privileged Exec mode Mode...
OSPF Commands show ip protocols ospf Use this command to display OSPF process parameters and statistics. To modify the lines displayed, use the | (output modifier token) ; to save the output to a file, use the > output redirection token. Syntax show ip protocols ospf Exec mode and Privileged Exec mode...
Page 723
OSPF Commands summary-address Use this command to suppress external routes that have the specified address range. Use the no summary-address command to allow external routes that have the specified address range. Syntax summary-address <ip-address/m> [not-advertise][tag <0-4294967295>] no summary-address <ip-address/m> [not-advertise][tag <0-4294967295>] Parameter Description <ip-address/m>...
OSPF Commands timers spf Use this command to adjust route-calculation timers. Use the no parameter with this command to return to the default timer values. Syntax timers spf <spf_delay> <spf_holdtime> no timers spf Parameter Description <0-2147483647> Specifies the delay between receiving changed <spf_delay>...
Chapter 37: BGP Configuration Introduction................................37.2 Enabling BGP Peers in the same AS ......................37.2 Enabling BGP between different Autonomous Systems..............37.3 Route-Map................................37.4 Route Reflector..............................37.6 Confederations..............................37.8 Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1 37.1...
BGP Configuration Introduction This chapter contains basic BGP configuration examples. To see details on the commands used in these examples, or to see the outputs of the Validation commands, refer to the separate BGP Commands chapter. Enabling BGP Peers in the same AS This example shows the minimum configuration required for enabling BGP on an interface.
BGP Configuration Enabling BGP between different Autonomous Systems This example shows the minimum configuration required for enabling BGP on an interface when the BGP peers belong to different Autonomous Systems. Peer 1 and Peer 2 are two BGP peers in different autonomous systems, AS200 and AS300 connecting to network 10.10.10.0/24.
BGP Configuration Route-Map Use route-maps to filter incoming updates from a BGP peer. In this example, a prefix-list list1 on Peer 1 is configured to deny entry of any routes with the IP address 1.1.1.0/M (M = 26,27,28). To test the filter, Peer 2 is configured to generate network addresses 1.1.1.0/27 and 1.1.2.0/24.
Page 729
BGP Configuration Peer 2 Define the routing process. The number 11 specifies the awplus(config)#router bgp 11 AS number of Peer 2. Define BGP neighbors. 192.168.10.10 is the IP awplus(config-router)#neighbor 192.168.10.10 remote-as 10 address of the neighbor (Peer 1) and 10 is the neighbor’s AS number.
BGP Configuration Route Reflector Use Route Reflector to reduce the iBGP mesh inside an AS. In this example, Peer 2, Peer 5 and Peer 4 would have to maintain a full mesh among themselves but by making Peer 5 the Route Reflector, Peer 2 (Client1) has an iBGP session with the Route Reflector only and not with Peer 4 (Client 2).
Page 731
BGP Configuration Route Reflector Client 1 (Peer 2) Define the routing process. The number 1 specifies the awplus(config)#router bgp 1 AS number of Peer 2. awplus(config-router)#neighbor 10.10.10.10 Define BGP neighbors. 10.10.10.10 is the IP address remote-as 1 of the neighbor (Peer 5) and 1 is the neighbor’s AS number.
BGP Configuration Confederations In this example, AS1 contains three Confederation Autonomous Systems--AS 1000, AS 1001 and AS 1002. To any outside AS, the Confederation is a single Autonomous System AS1. Confederation eBGP is run between Peer 2 and Peer 5, and between Peer 5 and Peer 7. Peer 2 is configured so that its local AS is 1000.
Page 733
BGP Configuration Peer 5 Define the routing process. The number 1001 specifies the awplus(config)#router bgp 1001 AS number of Peer 5. awplus(config-router)#bgp confederation Specify BGP Confederation Identifier. To routers outside the identifier 1 confederation, the whole confederation will appear as a single AS, and the identifier will appear as its AS number.
Page 734
BGP Configuration Software Reference for SwitchBlade® x908, x900 and x600 Series Switches 37.10 AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
Page 737
BGP Commands show ip bgp community..........................38.106 show ip bgp community-info........................38.106 show ip bgp community-list ........................38.107 show ip bgp dampening ..........................38.107 show ip bgp filter-list ...........................38.109 show ip bgp inconsistent-as ........................38.109 show ip bgp longer-prefixes........................38.110 show ip bgp neighbors ..........................38.111 show ip bgp paths............................38.112 show ip bgp prefix-list ..........................38.113 show ip bgp quote-regexp ........................38.113 show ip bgp regexp .............................38.114...
BGP Commands Introduction This chapter provides an alphabetical reference for each of the BGP commands. address-family This command enters the IPv4 address-family command mode. In this mode you can configure address-family specific parameters. Use the exit-address-family command to leave the address family mode and return to Router mode.
Page 739
BGP Commands aggregate-address This command adds an aggregate route that can be advertised to BGP neighbors. This command creates an aggregate entry in the BGP routing table if the switch learns, by any means, any routes that are within the range configured by the aggregate address/mask. If the summary-only parameter is specified, then only the aggregate address/mask will be advertised, and none of the component addresses that fall within the range of the aggregate address/mask.
BGP Commands bgp aggregate-nexthop-check This command enables the BGP option to perform aggregation only when next-hop matches the specified IP address. By default this is disabled. The no form disable this function. Syntax bgp aggregate-nexthop-check no bgp aggregate-nexthop-check Global Configuration mode Mode Example awplus#...
BGP Commands bgp always-compare-med This command enables BGP to compare the Multi Exit Discriminator (MED) for paths from neighbors in different autonomous systems. By default this feature is disabled. Multi Exit Discriminator (MED) is used in best path selection by BGP. MED is compared after BGP attributes weight, local preference, AS-path and origin have been compared and are equal.
BGP Commands bgp bestpath as-path ignore This command prevents the router from considering as-path as a factor in the algorithm for choosing a route. The no form allows the router to consider as-path in choosing a route. Syntax bgp bestpath as-path ignore no bgp bestpath as-path ignore Router mode Mode...
BGP Commands bgp bestpath compare-routerid By default, when comparing similar routes from peers, BGP does not consider the router ID of neighbors advertising the routes - BGP simply selects the first received route. Use the bgp bestpath compare-routerid command to include router ID in the selection process; similar routes are compared and the route with the lowest router ID is selected.
BGP Commands bgp bestpath med This command controls how the Multi Exit Discriminator (MED) attribute comparison is performed. The bgp bestpath med command features the confed and missing-as-worst parameters relating to MED comparison. The confed parameter enables MED comparison among paths learned from confederation peers.
BGP Commands bgp client-to-client reflection This command restores route reflection from a BGP route reflector to clients. The bgp client-to-client reflection command is used to configure routers as route reflectors. Route reflectors are used when all Interior Border Gateway Protocol (iBGP) speakers are not fully meshed.
BGP Commands bgp cluster-id This command configures the cluster ID if the BGP cluster has more than one route reflector. A cluster includes one or more route reflectors and their clients. Usually, each cluster is identified by the router ID of its single route reflector, but to increase redundancy, a cluster may sometimes have more than one route reflector.
BGP Commands bgp confederation identifier This command specifies a BGP confederation identifier. The no form removes all BGP confederation identifiers. Syntax bgp confederation identifier <1-65535> no bgp confederation identifier Parameter Description Set routing domain confederation AS number. <1-65535> Router mode Mode Note that the no form of this command removes all BGP confederation identifiers.
BGP Commands bgp confederation peers This command configures the Autonomous Systems (AS) that belong to the same confederation as the current switch. A confederation allows an AS to be divided into several sub-ASs. The overall AS is given a confederation identifier. External routers view only the whole confederation as one AS, whose AS number is the confederation identifier.
BGP Commands Example awplus# configure terminal awplus(config)# router bgp 100 awplus(config-router)# bgp confederation peers 1234 bgp confederation identifier Related Commands bgp config-type This command sets the BGP configuration type. By default, the BGP configuration type is extended. Syntax bgp config-type {standard|extended} Parameter Description Specifies the Industry standard style configuration.
BGP Commands bgp dampening This command sets bgp dampening parameters. Route dampening minimizes the instability caused by route flapping. A penalty is added for every flap in a flapping route. As soon as the total penalty reaches the suppress limit the advertisement of the route is suppressed.
BGP Commands Router mode Mode Example awplus# configure terminal awplus(config)# router bgp 11 awplus(config-router)# bgp dampening 20 800 2500 80 25 bgp default ipv4-unicast This command configures BGP defaults and activate ipv4-unicast for a peer by default. This affects the BGP global configuration. This is enabled by default.
BGP Commands bgp default local-preference This command changes the default local preference value. The local preference indicates the preferred path when there are multiple paths to the same destination. The path with the higher preference is preferred. Use this command to define the default local preference value that the switch will advertise for the routes it sends.
BGP Commands bgp deterministic-med Use this command to allow or disallow the switch to compare the Multi Exit Discriminator (MED) variable when choosing among routes advertised by different peers in the same autonomous system (AS). Use the bgp deterministic-med command to enable this feature to allow the comparison of MED variables when choosing among routes advertised by different peers in the same AS.
BGP Commands In the example above, the MED values were not considered when comparing the winners of the two groups (the best routes from the different ASs). To use MED in the comparison of routes from different ASs, use the bgp always-compare-med command. Example awplus# configure terminal...
BGP Commands bgp fast-external-failover Use this command to reset a BGP session immediately, if the interface used for BGP connection goes down. Use the no parameter with this command to disable this feature. Syntax bgp fast-external-failover no bgp fast-external-failover Enabled Default Router mode Mode...
BGP Commands bgp graceful-restart Use this command to enable BGP graceful-restart capabilities for restart and stalepath times. Use the no bgp graceful-restart command to restore restart timers to their default settings. Syntax bgp graceful-restart [restart-time <delay-value>|stalepath-time <delay-value>] no bgp graceful-restart [restart-time|stalepath-time] Parameter Description The maximum time needed for neighbors to restart, in seconds.
Page 757
BGP Commands awplus# configure terminal awplus(config)# router bgp 10 awplus(config-router)# no bgp graceful-restart restart-time 150 Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1 38.23...
BGP Commands bgp log-neighbor-changes Use this command to enable logging of status change messages without turning on debug bgp commands. Use the no parameter with this command to disable this feature. Syntax bgp log-neighbor-changes no bgp log-neighbor-changes Disabled Default Router mode Mode AlliedWare Plus provides other kinds of logging services for neighbor status, for example,...
BGP Commands bgp memory maxallocation This command allocates a maximum percentage of the RAM (Random Access Memory) available on the switch for BGP processes. When this percentage is exceeded, BGP peering terminates and an out of resources error displays. The default setting for bgp memory maxallocation is 100% memory allocation.
BGP Commands bgp multiple-instance Use this command to enable or disable the bgp multiple instance support. Use the no parameter with this command to disable this function. Syntax bgp multiple-instance no bgp multiple-instance No multiple-instance support Default Global Configuration mode Mode Example awplus#...
BGP Commands bgp rfc1771-strict Use this command to set the Strict RFC1771 setting. Use the no parameter with this command to revert this setting. Syntax bgp rfc1771-strict no bgp rfc1771-strict Disabled Default Global Configuration mode Mode Example awplus# configure terminal awplus(config)# bgp rfc1771-strict bgp router-id...
BGP Commands To disable the router ID for a BGP router identifier issue the commands listed below: awplus# configure terminal awplus(config)# router bgp 100 awplus(config-router)# no bgp router-id bgp scan-time Use this command to set the interval for BGP route next-hop scanning. Use the no parameter with this command to disable this function.
BGP Commands bgp update-delay Use this command to specify the update-delay value for a graceful-restart capable router. Use the no parameter with this command to revert to the default update-delay value. Syntax bgp update-delay <1-3600> no bgp update-delay [<1-3600>] Router mode Mode The default update-delay value is 120 seconds.
BGP Commands clear bgp * Use this command to reset the BGP connection for all peers. Syntax clear bgp * [<in>|out|<soft>] Parameter Description Clears all bgp peers <in> in [prefix-filter] Indicates that incoming advertised routes will be cleared. prefix-filter Specifies that a prefix-list will be sent, by the ORF mechanism, to those neighbors with which the ORF capability has been negotiated.
BGP Commands clear bgp (ip address) Use this command to reset the BGP connection for specified peers. Syntax clear bgp <ip-address> [<in>|out|<soft>] Parameter Description Specifies the IPv4 address of the neighbor whose connection is <ip-address> to be reset, entered in the form A.B.C.D. <in>...
BGP Commands clear bgp (ASN) Use this command to reset the BGP connection for peers in the specified Autonomous System Number (ASN). Syntax clear bgp <asn> [<in>|out|<soft>] Parameter Description <1-65535> The AS Number for which all routes will be cleared <asn>...
BGP Commands clear bgp external Use this command to reset the BGP connection for all external peers. Syntax clear bgp external [<in>|out|<soft>] Parameter Description clears all external peers external <in> in [prefix-filter] Indicates that incoming advertised routes will be cleared. prefix-filters Specifies that a prefix-list will be sent, by the ORF mechanism, to those neighbors with which the ORF capability has been negotiated.
BGP Commands clear bgp peer-group Use this command to reset the BGP connection for all members of a peer group. Syntax clear bgp peer-group <word> [<in>|out|<soft>] Parameter Description clears all members of a peer group peer-group <word> Name of the BGP peer group <in>...
BGP Commands clear bgp view Use this command to reset all BGP connections. Syntax clear bgp view <word> * [<soft>] Parameter Description Clears all bgp peers <word> Name of the BGP view <soft> soft [in |out] Soft inbound reset causes the neighbors to resend all their updates to the local switch, without resetting the connection or clearing the entries in the local switch.
BGP Commands clear ip bgp * Use this command to reset all BGP connections - either by fully resetting sessions, or by performing soft resets. Syntax clear ip bgp * [<in>|out|<soft>] Parameter Description Clears connections with all BGP peers <in> in [prefix-filter] Indicates that incoming advertised routes will be cleared Specifies that a prefix-list will be sent, by the ORF mechanism, to...
BGP Commands clear ip bgp (ip address) Use this command to reset the IPv4 BGP connection to the peer specified by the IP address. Syntax clear ip bgp <ip-address> [<in>|out|<soft>] clear ip bgp <ip-address> ipv4 <prefix> <routes> Parameter Description Specifies the IPv4 address of the neighbor whose connection is to be <ip-address>...
BGP Commands clear ip bgp dampening Use this command to clear route dampening information and unsuppress routes that have been suppressed routes. Syntax clear ip bgp dampening [<ip-address>|<ip-address/m>] clear ip bgp ipv4 <prefix> dampening [<ip-address>|<ip-address/m>] Parameter Description Specifies the IPv4 address for which BGP dampening is to be cleared, <ip-address>...
BGP Commands clear ip bgp flap-statistics Use this command to clear the flap count and history duration for the specified prefixes. Syntax clear ip bgp flap-statistics [<ip-address>|<ip-address/m>] clear ip bgp ipv4 <prefix> flap-statistics[<ip-address>|<ip-address/ m>] Parameter Description Specifies the IPv4 address for which BGP flap count and history <ip-address>...
BGP Commands clear ip bgp (ASN) Use this command to reset the BGP connections to all peers in a specified Autonomous System Number (ASN). Syntax clear ip bgp <asn> [<in>|out|<soft>] clear ip bgp <asn> ipv4 <prefix> <routes> Parameter Description <1-65535> Specifies the AS Number for which all routes will be <asn>...
BGP Commands clear ip bgp external Use this command to reset the BGP connections to all external peers. Syntax clear ip bgp external [<in>|out|<soft>] clear ip bgp external ipv4 <prefix> <routes> Parameter Description Clears all external peers external Clears all IPv4 address family peers. Configure parameters relating to the ipv4 BGP exchange of IPv4 prefixes.
BGP Commands clear ip bgp peer-group Use this command to reset the BGP connections to all members of a peer group. Syntax clear ip bgp peer-group <peer-name> [<in>|out|<soft>] clear ip bgp peer-group <peer-name> ipv4 <prefix> <routes> Parameter Description Clears all members of a peer group peer-group Specifies the name of the peer group for which all members will be <peer-name>...
BGP Commands clear ip bgp view Use this command to reset connections with all the neighbors within the specified view. The specified bgp view for this command is created using the router bgp view command. Syntax clear ip bgp view <word> * [<in>|<soft>] clear ip bgp view <word>...
BGP Commands debug bgp Use this command to turn on one or more BGP debug options. Use the no parameter with this command to disable one or more BGP debug options. Syntax debug bgp [all|dampening|events|filters|fsm|keepalives|nsm|<updates>] no debug all bgp no debug bgp [all|dampening|events|filters|fsm|keepalives|nsm| <updates>] Parameter Description...
BGP Commands distance (bgp) This command sets the administrative distance for BGP routes. The switch uses this value to select between two or more routes to the same destination from two different routing protocols. The route with the smallest administrative distance value is added to the Forwarding Information Base (FIB).
Page 780
BGP Commands If the administrative distance is changed, it could create inconsistency in the routing table and obstruct routing. To set the administrative distance to 34 for the route 10.10.0.0/24 in BGP 100, and use the Example access list “mylist” to filter the routes, use the commands: awplus(config)# router bgp 100 awplus(config-router)#...
BGP Commands ip as-path access-list This command defines a BGP Autonomous System (AS) path access list. The named AS path list is a filter based on regular expressions. If the regular expression matches the AS path in a BGP update message, then the permit or deny condition applies to that update.
BGP Commands ip community-list Use this command to add an entry to a standard BGP community-list filter. Use the no parameter with this command to delete the community list entry. Syntax ip community-list <listname> {deny|permit} .<community> no ip community-list <listname> {deny|permit} .<community> Parameter Description Specifies the community listname.
BGP Commands ip community-list expanded Use this command to add an entry to an expanded BGP community-list filter. Use the no parameter with this command to delete the community list entry. Regular expressions listed below can be used with the ip community-list expanded command: Symbol Character Meaning...
Page 784
BGP Commands The standard community-list is compiled into binary format and is directly compared with the BGP communities attribute in the BGP updates. The comparison is faster than the expanded community-list. Any community value that does not match the standard community value is automatically treated as expanded.
BGP Commands ip community-list standard Use this command to add an entry to a standard BGP community-list filter. Use the no parameter with this command to delete the standard community-list entry. Syntax ip community-list <1-99> {deny|permit} [.<community>] no ip community-list <1-99> {deny|permit} [.<community>] ip community-list <standard>...
Page 786
BGP Commands Example awplus# configure terminal awplus(config)# ip community-list standard CLIST permit 7675:80 7675:90 no-export awplus(config)# ip community-list 34 permit 5675:50 no-advertise ip community-list Related Commands ip community-list expanded Software Reference for SwitchBlade® x908, x900 and x600 Series Switches 38.52 AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
BGP Commands neighbor activate Use this command to enable the exchange of routes with a neighboring router, possibly within a specific address-family. Use the no parameter with this command to disable exchange of information with a neighbor. Syntax neighbor <neighborid> activate no neighbor <neighborid>...
BGP Commands neighbor advertisement-interval Use this command to set the minimum interval between sending the BGP routing updates. Use the no parameter with this command to set the interval time to the default (30 seconds). Syntax neighbor <neighborid> advertisement-interval <time> no neighbor <neighborid>...
BGP Commands neighbor allowas-in Use this command to accept an AS-path with the specified Autonomous System (AS) number from inbound updates. Use the no parameter with this command to revert to default. Syntax neighbor <neighborid> allowas-in <occurrences> no neighbor <neighborid> allowas-in Parameter Description <neighborid>...
BGP Commands neighbor as-origination-interval Use this command to enable the sending of AS (Autonomous System) origination routing updates to the specified neighbor. This command can also be used to adjust the rate at which the updates are sent. Use the no negation parameter with this command to disable this feature. Syntax neighbor <neighbor_address>...
BGP Commands neighbor attribute-unchanged Use this command to advertise unchanged BGP attributes to the specified neighbor. Use the no parameter with this command to disable this function. Syntax neighbor <neighborid> attribute-unchanged {as-path|next-hop|med} no neighbor <neighborid> attribute-unchanged {as-path|next-hop|med} Parameter Description <neighborid> {<ip-address>|<tag>} <ip- The address of an IPv4 BGP neighbor, in dotted decimal...
BGP Commands neighbor capability dynamic Use this command to enable the dynamic capability for a specific peer. Use the no parameter with this command to disable the dynamic capability. Syntax neighbor <neighborid> capability dynamic no neighbor <neighborid> capability dynamic Parameter Description <neighborid>...
BGP Commands neighbor capability graceful-restart Use this command to configure the router to advertise the Graceful Restart Capability to the neighbors. Use the no parameter with this command to configure router so it does not advertise the Graceful Restart Capability to its neighbor. Syntax neighbor <neighborid>...
BGP Commands neighbor capability orf prefix-list Use this command to advertise ORF capability to neighbors. Use the no parameter with this command to disable this function. Syntax neighbor <neighborid> capability orf prefix-list {both|receive|send} no neighbor <neighborid> capability orf prefix-list {both|receive|send} Parameter Description <neighborid>...
BGP Commands neighbor capability route-refresh Use this command to advertise route-refresh capability to the specified neighbors. Use the no parameter with this command to disable this function Syntax neighbor <neighborid> capability route-refresh no neighbor <neighborid> capability route-refresh Parameter Description <neighborid> {<ip-address>|<tag>} <ip- The address of an IPv4 BGP neighbor, in dotted decimal...
BGP Commands neighbor collide-established Use this command to specify including a neighbor, already in an 'established' state, for conflict resolution when a TCP connection collision is detected. Use the no neighbor collide-established command to remove a neighbor, already in an ‘established’...
BGP Commands neighbor default-originate Use this command to allow a BGP local router to send the default route 0.0.0.0 to a neighbor. Use the no parameter with this command to send no route as a default. Syntax neighbor {<neighborid>} default-originate [<routemap>] no neighbor {<neighborid>} default-originate [<routemap>] Parameter Description...
BGP Commands neighbor description Use this command to associate a description with a neighbor. Use the no parameter with this command to remove the description. Syntax neighbor <neighborid> description <description> no neighbor <neighborid> description [<description>] Parameter Description <neighborid> {<ip-address>|<tag>} <ip-address> The address of an IPv4 BGP neighbor, in dotted decimal notation A.B.C.D.
BGP Commands neighbor distribute-list This command filters route update from a particular BGP neighbor using an access control list. You can add one incoming and one outgoing distribute-list for each BGP neighbor. The no neighbor distribute-list command removes a previously configured distribute-list. Syntax neighbor <neighborid>...
BGP Commands neighbor dont-capability-negotiate Use this command to disable capability negotiation. The capability negotiation is performed by default. This command is used to allow compatibility with older BGP versions that have no capability parameters used in open messages between peers. Use the no parameter with this command to enable capability negotiation.
BGP Commands neighbor ebgp-multihop Use this command to accept and attempt BGP connections to external peers on indirectly connected networks. The switch will not establish a connection to a multihop neighbor, if the only route to the multihop peer is a default route. Use the no parameter with this command to return to the default.
BGP Commands neighbor enforce-multihop Use this command to enforce the requirement that BGP neighbors form multihop connections. Use the no parameter with this command to turn off this feature. Syntax neighbor <neighborid> enforce-multihop no neighbor <neighborid> enforce-multihop Parameter Description <neighborid> {<ip-address>|<tag>} <ip- The address of an IPv4 BGP neighbor, in dotted decimal...
BGP Commands neighbor filter-list This command creates a BGP filter using an AS (Autonomous System) path list. This command specifies an AS path list, which it then applies to filter updates to and from a BGP neighbor The no form of this command removes the previously specified filter using access control lists. Syntax neighbor <neighborid>...
BGP Commands neighbor interface Use this command to configure the interface name of a BGP-speaking neighbor. Use the no parameter with this command to disable this function Syntax neighbor <ipaddr> interface <ifname> no neighbor <ipaddr> interface <ifname> Parameter Description Specifies the IPv4 address of the BGP neighbor - entered in dotted decimal <ipaddr>...
BGP Commands neighbor maximum-prefix Use this command to control the number of prefixes that can be received from a neighbor. Use the no parameter with this command to disable this function. Do not specify threshold to apply the default threshold of 75% for the maximum number of prefixes before this is applied. Syntax neighbor <neighborid>...
BGP Commands neighbor next-hop-self Use this command to configure the router as the next hop for a BGP-speaking neighbor or peer group. Use the no parameter with this command to disable this feature. Syntax neighbor <neighborid> next-hop-self no neighbor <neighborid> next-hop-self Parameter Description <neighborid>...
BGP Commands neighbor override-capability Use this command to override a capability negotiation result. Use the no parameter with this command to disable this function Syntax neighbor <neighborid> override-capability no neighbor <neighborid> override-capability Parameter Description <neighborid> {<ip-address>|<tag>} <ip- The address of an IPv4 BGP neighbor, in dotted decimal address>...
BGP Commands neighbor passive Use this command to configure the local router to be passive with regard to the specified neighbor. This has the effect that the router will not attempt to initiate connections to this neighbor, but will accept incoming connection attempts from the neighbor. Use the no parameter with this command to disable this function Syntax neighbor <neighborid>...
BGP Commands neighbor peer-group (adding a neighbor) Use this command to add a neighbor to an existing peer-group. Use the no parameter with this command to disable this function. Syntax neighbor <ip-address> peer-group <tag> no neighbor <ip-address> peer-group <tag> Parameter Description Specifies the IPv4 address of the BGP neighbor, entered in the format <ip-address>...
BGP Commands neighbor peer-group (creating a peer-group) Use this command to create a peer-group. Use the no parameter with this command to disable this function Syntax neighbor <tag> peer-group no neighbor <tag> peer-group Parameter Description Name of the peer-group <tag> Router mode and Address Family [ipv4 unicast | ipv4 multicast ] mode Mode Neighbors with the same update policies are grouped into peer groups.
BGP Commands neighbor port Use this command to specify the TCP port to which packets are sent to on a neighbor. Syntax neighbor <neighborid> port <portnum> no neighbor <neighborid> port [<portnum>] Parameter Description <neighborid> {<ip-address>|<tag>} The address of an IPv4 BGP neighbor, in dotted decimal <ip- address>...
BGP Commands neighbor prefix-list Use this command to distribute BGP neighbor information as specified in a prefix list. Use the no parameter with this command to remove an entry. Syntax neighbor <neighborid> prefix-list <listname> {in|out} no neighbor <neighborid> prefix-list <listname> {in|out} Parameter Description <neighborid>...
BGP Commands neighbor remote-as Use this command to configure an internal or external BGP (iBGP or eBGP) peering relationship with another router. Use the no parameter with this command to remove a previously configured BGP peering relationship. Syntax neighbor <neighborid> remote-as <as-number> no neighbor <neighborid>...
BGP Commands neighbor remove-private-AS Use this command to remove the private Autonomous System (AS) number from outbound updates. Use the no parameter with this command to revert to default. Syntax neighbor <neighborid> remove-private-AS no neighbor <neighborid> remove-private-AS Parameter Description <neighborid> {<ip-address>|<tag>} The address of an IPv4 BGP neighbor, in dotted decimal <ip-...
BGP Commands neighbor restart-time Use this command to set a different restart-time other than the global restart-time configured using the bgp graceful-restart command. Use the no parameter with this command to restore the router to its default state. Syntax neighbor <neighborid> restart-time <1-3600> no neighbor <neighborid>...
BGP Commands neighbor route-map Use this command to apply a route map to incoming or outgoing routes. Use the no parameter with this command to a route map. Syntax neighbor <neighborid> route-map <mapname> {in|out} no neighbor <neighborid> route-map <mapname> {in|out} Parameter Description <neighborid>...
BGP Commands neighbor route-reflector-client Use this command to configure the router as a BGP route reflector and configure the specified neighbor as its client. Use the no parameter with this command to indicate that the neighbor is not a client. Syntax neighbor <neighborid>...
BGP Commands neighbor route-server-client Use this command to specify the peer as route server client. Use the no parameter with this command to disable this function Syntax neighbor <neighborid> route-server-client no neighbor <neighborid> route-server-client Parameter Description <neighborid> {<ip-address>|<tag>} The address of an IPv4 BGP neighbor, in dotted decimal <ip- address>...
BGP Commands neighbor send-community Use this command to specify that a community attribute should be sent to a BGP neighbor. Use the no parameter with this command to remove the entry. Use the extended and no parameters to remove extended communities. Specifying no other parameter with no removes standard communities only.
BGP Commands neighbor shutdown Use this command to disable a peering relationship with a neighbor. Use the no parameter with this command to re-enable the neighbor. Syntax neighbor <neighborid> shutdown no neighbor <neighborid> shutdown Parameter Description <neighborid> {<ip-address>|<tag>} The address of an IPv4 BGP neighbor, in dotted decimal <ip- address>...
BGP Commands neighbor soft-reconfiguration inbound Use this command to configure the switch to start storing all updates from the neighbor, without any consideration of any inward route filtering policy that might be applied to the connection with this neighbor. This is so that the full set of the neighbor’s updates are available locally to be used in a soft-reconfiguration event.
BGP Commands neighbor strict-capability-match Use this command to close the BGP connection if the capabilities being advertised by the switch do not exactly match the capabilities being advertised by the neighbor. Use the no parameter with this command to disable this function Syntax neighbor <neighborid>...
BGP Commands neighbor timers Use this command to set the timers for a specific BGP neighbor. Use the no parameter with this command to clear the timers for a specific BGP neighbor Syntax neighbor <neighborid> timers {<keepalive>|<connect>} no neighbor <neighborid> timers [<connect>] Parameter Description <neighborid>...
BGP Commands neighbor transparent-as Use this command to specify not to append your AS path number even if the peer is an eBGP peer. Syntax neighbor <neighborid> transparent-as Parameter Description <neighborid> {<ip-address>|<tag>} The address of an IPv4 BGP neighbor, in dotted decimal <ip- address>...
BGP Commands neighbor transparent-nexthop Use this command to keep the nexthop value of the route even if the peer is an eBGP peer. Syntax neighbor <neighborid> transparent-nexthop Parameter Description <neighborid> {<ip-address>|<tag>} The address of an IPv4 BGP neighbor, in dotted decimal <ip- address>...
BGP Commands neighbor unsuppress-map Use this command to selectively leak more-specific routes to a particular neighbor. Use the no neighbor unsuppress-map command to remove selectively leaked specific routes to a particular neighbor as specified previously with the neighbor unsuppress-map command. Syntax neighbor <neighborid>...
BGP Commands neighbor update-source Use this command to specify that the source IP address of BGP packets sent to the neighbor to be the IP address that is configured on the specified interface. Use the no neighbor update-source command to remove the IP address from the interface as the source IP address of BGP packets sent to the neighbor.
BGP Commands neighbor version Use this command to configure the switch to accept only a particular BGP version. Use the no parameter with this command to use the default BGP version (version 4). Syntax neighbor <neighborid> version <version> no neighbor <neighborid> version Parameter Description <neighborid>...
BGP Commands neighbor weight Use this command to set default weights for routes from this neighbor. Use the no parameter with this command to remove a weight assignment. Syntax neighbor <neighborid> weight <weight> no neighbor <neighborid> weight [<weight>] Parameter Description <neighborid>...
Page 830
BGP Commands network Use this command to specify particular routes to be redistributed into the BGP routing process. A unicast network address without a mask is accepted if it falls into the natural boundary of its class. A class-boundary mask is derived if the address matches its natural class-boundary. Use the no form of this command to remove a network route entry.
BGP Commands The following example illustrates a network address which does not fall into its natural class boundary, and hence, is perceived as a host route, that is, 1.2.3.0/32. awplus(config)# router bgp 1 awplus(config-router)# network 1.2.3.0 awplus(config-router)# exit awplus(config)# exit awplus# show run router bgp 1...
BGP Commands redistribute route-map Use this command to inject routes from one routing process into another. Use the no parameter with this command to disable this function. Syntax redistribute {ospf|rip|connected|static} [<mapname>] no redistribute {ospf|rip|connected|static} [<mapname>] Parameter Description Specifies the redistribution of connected routes. connected ospf Specifies the redistribution of OSFP information.
BGP Commands restart bgp graceful Use this command to force the switch to perform a graceful BGP restart. Syntax restart bgp graceful Privileged Exec mode Mode This command stops the whole BGP process and makes AlliedWare Plus retain the BGP Usage routes and mark them as stale.
BGP Commands router bgp Use this command to configure a BGP routing process. Use the no parameter with this command to disable a routing process. Syntax router bgp ASN no router bgp ASN Parameter Description <1-65525> Specifies the Autonomous System (AS) number. Global Configuration mode Mode The router bgp command enables a BGP routing process so you can setup a route server...
BGP Commands router bgp view Use this command to create a named BGP view. BGP views can have the same or different Autonomous System (AS) number. BGP view is only for exchanging BGP routing information. Use the no parameter with this command to disable a named BGP view. Syntax router bgp ASN view <view_name>...
BGP Commands show bgp memory maxallocation This command displays the maximum percentage of total memory that is allocated to BGP processes. Syntax show bgp memory maxallocation Parameter Description Show running system information show Border Gateway Protocol (BGP) Memory information memory Maximum percentage of RAM allocated to BGP processes maxallocation Privileged Exec Mode...
BGP Commands show ip bgp Use this command to display BGP network information. Syntax show ip bgp [<ipaddr>|<ipaddr/m>] show ip bgp {<prefix> [<ipaddr>]} Parameter Description Specifies the IPv4 address and optional prefix mask length. <ipaddr> <ipaddr/m> {multicast|unicast} <prefix> Specifies a IPv4 unicast address family. This is the default option. unicast Configures parameters relating to the BGP exchange of routes to unicast destinations.
BGP Commands show ip bgp attribute-info Use this command to show internal attribute hash information. Syntax show ip bgp attribute-info Privileged Exec mode and Exec mode Mode Example awplus# show ip bgp attribute-info This is a sample output from the show ip bgp attribute-info command displaying internal Usage attribute information Figure 38-3: Example output from the show ip bgp attribute-info command...
BGP Commands show ip bgp cidr-only Use this command to display routes with non-natural network masks. Syntax show ip bgp cidr-only show ip bgp <prefix> cidr-only Parameter Description {multicast|unicast} <prefix> Specifies a IPv4 unicast address family. This is the default option. unicast Configures parameters relating to the BGP exchange of routes to unicast destinations.
BGP Commands show ip bgp community Use this command to display routes matching the communities. You may use any combination and repetition of parameters listed in the <type> placeholder. Syntax show ip bgp community [<type>] [exact-match] Parameter Description { [AA:NN][local-AS][no-advertise][no-export]} <type>...
BGP Commands show ip bgp community-list Use this command to display routes that match the community-list. Syntax show ip bgp community-list <listname> [exact-match] Parameter Description Specifies the community list name. <listname> exact-match Displays only routes that have exactly the same specified communities. Privileged Exec mode and Exec mode Mode Example...
Page 842
BGP Commands Example awplus# show ip bgp dampening dampened-paths Enable BGP dampening to maintain dampened-path information in memory. Usage The following is sample output displaying all the dampening parameters: Output Figure 38-5: Example output from the show ip bgp dampening parameters command awplus#show ip bgp dampening parameters dampening 15 750 2000 60 15 Reachability Half-Life time...
BGP Commands show ip bgp filter-list Use this command to display routes conforming to the filter-list. Syntax show ip bgp filter-list <listname> show ip bgp <prefix> filter-list <listname> Parameter Description <listname> Specifies the regular-expression access list name. {multicast|unicast} <prefix> unicast Specifies a IPv4 unicast address family.
BGP Commands show ip bgp longer-prefixes Use this command to display the route of the local BGP routing table for a specific prefix with a specific mask or for any prefix having a longer mask than the one specified. Syntax show ip bgp <ip-address/m>...
BGP Commands show ip bgp neighbors Use this command to display detailed information on peering connections to all BGP neighbors. Syntax show ip bgp neighbors [<ipaddr> [advertised-routes|<received>| received-routes|routes]] show ip bgp <prefix> neighbors [<ipaddr> [advertised-routes| <received>|received-routes|routes]] Parameter Description <ipaddr> Specifies the IPv4 address. Displays the routes advertised to a BGP neighbor.
BGP Commands Figure 38-8: Example output from the show ip bgp neighbors command awplus#show ip bgp neighbors BGP neighbor is 192.10.23.67, remote AS 1, local AS 1, internal link BGP version 4, remote router ID 172.22.10.10 BGP state = Established, up for 00:00:22 Last read 00:00:22, hold time is 240, keepalive interval is 60 seconds Neighbor capabilities:...
BGP Commands show ip bgp prefix-list Use this command to display routes matching the prefix-list. Syntax show ip bgp prefix-list <list> show ip bgp <prefix> prefix-list <list> Parameter Description Specifies the name of the IP prefix list. <list> <prefix> {multicast|unicast} Specifies a IPv4 unicast address family.
BGP Commands show ip bgp regexp Use this command to display routes matching the AS path regular expression. Syntax show ip bgp regexp <expression> show ip bgp <prefix> regexp <expression> Parameter Description Displays routes matching the AS path regular expression. regexp expression>...
BGP Commands show ip bgp route-map Use this command to display routes that match the specified route-map. Syntax show ip bgp route-map <route-map> show ip bgp <prefix> route-map <route-map> Parameter Description Specifies a route-map that is matched. <route-map> <prefix> {multicast|unicast} Specifies a IPv4 unicast address family.
BGP Commands show ip bgp scan Use this command to display BGP scan status. Syntax show ip bgp scan Privileged Exec mode and Exec mode Mode Example awplus# show ip bgp scan Figure 38-9: Example output from the show ip bgp scan command Output BGP scan is running...
BGP Commands show ip bgp summary Use this command to display a summary of BGP neighbor status. Syntax show ip bgp summary show ip bgp <prefix> summary Parameter Description <prefix> {multicast|unicast} Specifies a IPv4 unicast address family. This is the default option. unicast Configures parameters relating to the BGP exchange of routes to unicast destinations.
BGP Commands show ip bgp view Use this command to view the neighbors of the given instance. Syntax show ip bgp view <instance> [<ip-address>[/M]] Parameter Description The name of the instance to display data for. <instance> <ip-address> IPv4 address, entered in the form A.B.C.D. The subnet mask length Privileged Exec mode and Exec mode Mode...
Page 853
BGP Commands Figure 38-12: Example output from the show show ip bgp view neighbors command Output awplus#show ip bgp view I2 neighbors BGP neighbor is 10.10.10.52, remote AS 10, local AS 10, internal link BGP version 4, remote router ID 10.10.10.52 BGP state = Established, up for 00:03:22 Last read 00:00:13, hold time is 90, keepalive interval 30 seconds...
BGP Commands show ip bgp view summary Use this command to view the summary data of neighbors of the given instance. Syntax show ip bgp view <instance> summary show ip bgp view <instance> [<prefix>] summary Parameter Description the name of the instance to display data for. <instance>...
BGP Commands show ip community-list Use this command to display routes that match a specified community-list name or number. Syntax show ip community-list [<listnumber>|<listname>] Parameter Description Specifies the community list number in the range <1-199> <listnumber> as specified by a previously issued ip community-list command. Specifies the community list name as specified by a previously issued | <listname>...
Page 856
BGP Commands synchronization Use this command to enable IGP synchronization of Internal BGP (iBGP) learned routes with the Internal Gateway Protocol (IGP) system in the router configuration mode or in the address-family configuration mode. Use the no parameter with this command to disable this function. Syntax synchronization no synchronization...
Page 857
BGP Commands timers Use this command sets the BGP keepalive timer and holdtime timer values. Use the no parameter with this command to reset timers to default value. Syntax timers bgp <keep_alive> <hold_time> no timers bgp Parameter Description <0-65535> The frequency with which the keepalive messages are sent <keep_alive>...
BGP Commands undebug bgp Use this command to disable BGP debugging functions. Syntax undebug bgp [all|dampening|events|filters|fsm|keepalives|nsm|updates] undebug all bgp Parameter Description Disable all debugging for BGP Disable debugging for BGP dampening. dampening Disable debugging for BGP events. events Disable debugging for BGP filters. filters Disable debugging for BGP Finite State Machine (FSM).
Chapter 39: Route Map Commands Introduction................................39.2 match as-path................................39.2 match community...............................39.4 match interface..............................39.5 match ip address ..............................39.6 match ip next-hop..............................39.8 match ipv6 address ............................39.10 match ipv6 next-hop............................39.11 match metric............................... 39.12 match origin ................................ 39.13 match route-type ............................. 39.15 match tag ................................39.16 route-map ................................
Route Map Commands Introduction This chapter provides an alphabetized command reference for route map commands. These commands can be divided into the following categories: ■ route-map command, used to create a route map and/or route map entry, and to put you into route map mode match commands, used to determine which routes or BGP update messages the route ■...
Page 861
Route Map Commands To add entry 34 to the route map called myroute, which will discard update messages if they Examples contain the AS path values that are included in myaccesslist, use the commands: awplus# configure terminal awplus(config)# route-map myroute deny 34 awplus(config-route-map)# match as-path myaccesslist ip as-path access-list...
Route Map Commands match community Use this command to add a community match clause to a route map entry. Specify the community value or values to match by specifying a community list. To create the community list, enter Global Configuration mode and use the ip community-list command. A BGP update message matches the route map if its attributes include community values that match the community list.
Route Map Commands match interface Use this command to add an interface match clause to a route map entry. Specify the interface name to match. A route matches the route map if its interface matches the interface name. Each entry of a route map can only match against one interface in one interface match clause. If the route map entry already has an interface match clause, entering this command replaces that match clause with the new clause.
Route Map Commands match ip address Use this command to add an IP address prefix match clause to a route map entry. You can specify the prefix or prefixes to match by either: ■ specifying the name of an access list. To create the access list, enter Global Configuration mode and use the access-list command.
Page 865
Route Map Commands To add entry 3 to the route map called myroute, which will process routes that match the Examples ACL called List1, use the commands: awplus# configure terminal awplus(config)# route-map myroute permit 3 awplus(config-route-map)# match ip address List1 To add entry 3 to the route map called rmap1, which will process routes that match the prefix list called mylist, use the commands: awplus#...
Route Map Commands match ip next-hop Use this command to add a next-hop match clause to a route map entry. You can specify the next hop to match by either: ■ specifying the name of an access list. To create the access list, enter Global Configuration mode and use the access-list command.
Page 867
Route Map Commands To add entry 3 to the route map called mymap, which will process routes whose next hop matches the prefix list called list1, use the commands: awplus# configure terminal awplus(config)# route-map mymap permit 3 awplus(config-route-map)# match ip next-hop prefix-list list1 access-list (extended) Related Commands access-list (standard)
Route Map Commands match ipv6 address Use this command to specify the match address of route. Use the no parameter with this command to remove the match ipv6 address entry. Syntax match ipv6 address {<access-list-name>|prefix-list <prefix-listname>} no match ipv6 address [<access-list-name>|prefix-list <prefix- listname>] Parameter Description...
Route Map Commands match ipv6 next-hop Use this command to specify a next-hop address to be matched by the route-map. Use the no parameter with this command to disable this function Syntax match ipv6 next-hop {<access-list-name>|<ipv6-address>|prefix-list <prefix-listname>} no match ipv6 next-hop [<access-list-name>|<ipv6-address>|prefix-list [<prefix-listname>]] Parameter Description...
Route Map Commands match metric Use this command to add a metric match clause to a route map entry. Specify the metric value to match. A route matches the route map if its metric matches the route map’s metric. A BGP update message matches the route map if its MED attribute value matches the route map’s metric.
Route Map Commands match origin Use this command to add an origin match clause to a route map entry. Specify the origin attribute value to match. A BGP update message matches the route map if its origin attribute value matches the route map’s origin value.
Page 872
Route Map Commands To add entry 34 to the route map called “rmap1”, which will drop externally-originated routes, Example use the commands: awplus# configure terminal awplus(config)# route-map myroute deny 34 awplus(config-route-map)# match origin egp route-map Related Commands set origin show route-map Software Reference for SwitchBlade®...
Route Map Commands match route-type Use this command to add an external route-type match clause to a route map entry. Specify whether to match OSPF type-1 external routes or OSPF type-2 external routes. An OSPF route matches the route map if its route type matches the route map’s route type. Each entry of a route map can only match against one route type in one match clause.
Route Map Commands match tag Use this command to add a tag match clause to a route map entry. Specify the route tag value to match. An OSPF route matches the route map if it has been tagged with the route map’s tag value. Routes can be tagged through OSPF commands or through another route map’s set clause.
Page 875
Route Map Commands route-map Use this command to configure a route map entry, and to specify whether the device will process or discard matching routes and BGP update messages. The switch uses a name to identify the route map, and a sequence number to identify each entry in the route map.
Page 876
Route Map Commands If it does not find a match, it discards the route or update message. This means that route maps end with an implicit deny entry. To permit all non-matching routes or update messages, end your route map with an entry that has an action of permit and no match clause. To enter route-map mode for entry 1 of the route map called route1, and then add a match Examples and set clause to it, use the commands:...
Route Map Commands set aggregator Use this command to add an aggregator set clause to a route map entry. When a BGP update message matches the route map entry, the device sets the update’s aggregator attribute. The aggregator attribute specifies the AS and IP address of the device that performed the aggregation.
Route Map Commands set as-path Use this command to add an AS path set clause to a route map entry. When a BGP update message matches the route map entry, the device prepends the specified Autonomous System Number (ASN) or ASNs to the update’s AS path attribute. The AS path attribute is a list of the autonomous systems through which the announcement for the prefix has passed.
Route Map Commands set atomic-aggregate Use this command to add an atomic aggregate set clause to a route map entry. When a BGP update message matches the route map entry, the device adds the atomic aggregate attribute to the update. Use the no parameter to remove the set clause.
Route Map Commands set comm-list delete Use this command to delete one or more communities from the community attribute of a BGP update message. Specify the communities to delete by specifying a community list. To create the community list, enter Global Configuration mode and use the ip community-list command.
Route Map Commands set community Use this command to add a community set clause to a route map entry. When a BGP update message matches the route map entry, the device takes one of the following actions: ■ changes the update’s community attribute to the specified value or values, or ■...
Page 882
Route Map Commands To use entry 3 of the route map called rmap1 to put matching routes into the no-advertise Examples community, use the commands: awplus# configure terminal awplus(config)# route-map rmap1 permit 3 awplus(config-route-map)# set community no-advertise To use entry 3 of the route map called rmap1 to put matching routes into several communities, use the commands: awplus# configure terminal...
Route Map Commands set dampening Use this command to add a route flap dampening set clause to a route map entry. Also use the route map by specifying it in the command bgp dampening route-map. When a route matches the route map entry, the device enables route flap dampening for that route.
Page 884
Route Map Commands The suppress value must be greater than or equal to the reuse value. Usage Set the unreachability half-life time to be equal to, or greater than, reachability half-life time. The suppress-limit value must be greater than or equal to the reuse limit value. This command is valid for BGP routes only.
Route Map Commands set extcommunity Use this command to add an extended community set clause to a route map entry. A route map entry can have a route target extended community set clause, a site-of-origin extended community set clause, or both. When a BGP update message matches the route map entry, the device sets the update’s extended community attribute to the specified value or values.
Page 886
Route Map Commands To instead specify the extended community number in dotted decimal notation, use the command: awplus# configure terminal awplus(config-route-map)# route-map rmap1 permit 3 awplus(config-route-map)# set extcommunity soo 0.0.0.6:01 match community Related Commands route-map set comm-list delete set community show route-map Software Reference for SwitchBlade®...
Route Map Commands set ip next-hop Use this command to add a next-hop set clause to a route map entry. When a route or BGP update message matches the route map entry, the device sets the route’s next hop to the specified IP address. Use the no parameter to remove the set clause.
Route Map Commands set ipv6 next-hop Use this command to set a next hop-address. Use the no parameter with this command to delete an entry. Syntax set ipv6 next-hop {<ipv6-address-global>|local <ipv6-address>} no set ipv6 next-hop [<ipv6-address-global>|local [<ipv6-address>]] Parameter Description Specifies the IPv6 global address of next hop, entered in <ipv6-address-global>...
Route Map Commands set local-preference This command changes the default local preference value. The local preference indicates the BGP local preference path attribute when there are multiple paths to the same destination. The path with the higher preference is chosen. Use this command to define the preference of a particular path.
Route Map Commands set metric Use this command to add a metric set clause to a route map entry. When a route or BGP update message matches the route map entry, the device takes one of the following actions: ■ changes the metric (or for BGP, the MED attribute value) to the specified value, or ■...
Route Map Commands set metric-type Use this command to add a metric-type set clause to a route map entry. When a route matches the route map entry, the device sets its route type to the specified value. Use the no parameter to remove the set clause. Syntax set metric-type {type-1|type-2} no set metric-type [type-1|type-2]...
Route Map Commands set origin Use this command to add an origin set clause to a route map entry. When a BGP update message matches the route map entry, the device sets its origin attribute to the specified value. Use the no parameter to remove the set clause. Syntax set origin {egp|igp|incomplete} no set origin [egp|igp|incomplete]...
Route Map Commands set originator-id Use this command to add an originator ID set clause to a route map entry. The originator ID is the router ID of the IBGP peer that first learned this route, either via an EBGP peer or by some other means such as importing it.
Route Map Commands set tag Use this command to add a tag set clause to a route map entry. When a route matches the route map entry, the device sets its tag to the specified value when it redistributes the route into OSPF. Use the no parameter to remove the set clause.
Route Map Commands set weight Use this command to add a weight set clause to a route map entry. The weight value assists in best path selection of BGP routes. It is stored with the route in the BGP routing table, but is not advertised to peers. When there are multiple routes with a common destination, the device uses the route with the highest weight value.
Page 896
Route Map Commands show route-map Use this command to display information about one or all route maps. Syntax show route-map <map-name> Parameter Description A name to identify the route map <map-name> Privileged Exec mode Mode To display information about the route-map named “example-map”, use the command: Examples awplus# show route-map example-map...
Chapter 40: IGMP Snooping Configuration Introduction................................40.2 Configuring Switch 1............................40.3 Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1 40.1...
IGMP Snooping allows switches to monitor network traffic, and determine hosts to receive multicast traffic. This example describes the configuration on an Allied Telesis managed Layer 3 Switch (switch 1). The interface, port1.0.12, is configured as a multicast router port. Host A and Host B are both members of the same multicast group.
IGMP Snooping Configuration Configuring Switch 1 In this example, the ports are all part of the same VLAN and IGMP snooping is enabled. The switch is running RSTP. This is the default behavior of devices running the AlliedWare Plus OS, so this example does not describe how to configure RSTP or add the switch ports to a VLAN.
Page 902
IGMP Snooping Configuration Software Reference for SwitchBlade® x908, x900 and x600 Series Switches 40.4 AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
Chapter 41: IGMP Multicast Commands Introduction................................41.2 clear ip igmp................................41.2 clear ip igmp group ............................41.3 clear ip igmp interface ............................41.4 debug igmp................................41.5 ip igmp..................................41.6 ip igmp access-group ............................41.6 ip igmp immediate-leave..........................41.7 ip igmp last-member-query-count ......................41.8 ip igmp last-member-query-interval ......................41.9 ip igmp limit................................. 41.10 ip igmp mroute-proxy...........................
IGMP Multicast Commands Introduction This chapter lists configuration, clear, and show commands related to Group Management Protocols (GMPs) in alphabetical order. The Internet Group Management Protocol (IGMP) module includes the IGMP Proxy service and IGMP Snooping functionality. Some of the following commands may have commonalities and restrictions: these are described under the Usage section for each command.
IGMP Multicast Commands clear ip igmp group Use this command to clear IGMP group membership records for a specific group, on all interfaces, or for a single interface, or for a range of interfaces. Syntax clear ip igmp * clear ip igmp group <ip-address> <interface> Parameter Description Clears all groups on all interfaces.
IGMP Multicast Commands clear ip igmp interface Use this command to clear IGMP group membership records on a particular interface. Syntax clear ip igmp interface <interface> Parameter Description Specifies the name of the interface; all groups learned on this interface are <interface>...
IGMP Multicast Commands debug igmp Use this command to enable debugging of all IGMP, or a specific component of IGMP. Use the no parameter with this command to disable all IGMP debugging, or debugging of a specific component of IGMP. Syntax debug igmp {all|decode|encode|events|fsm|tib} no debug igmp {all|decode|encode|events|fsm|tib}...
IGMP Multicast Commands ip igmp Use this command to enable IGMP on an interface. The command configures the device as an IGMP querier. Use the no parameter with this command to return all IGMP related configuration to the default on this interface. Syntax ip igmp no ip igmp...
IGMP Multicast Commands ip igmp immediate-leave In IGMP version 2, use this command to minimize the leave latency of IGMP memberships for specified multicast groups. To disable this feature, use the no parameter with this command. Syntax ip igmp immediate-leave group-list <accesslist> no ip igmp immediate-leave Parameter Description...
IGMP Multicast Commands ip igmp last-member-query-count Use this command to set the last-member query-count value. To return to the default value on an interface, use the no parameter with this command. Syntax ip igmp last-member-query-count <2-7> no ip igmp last-member-query-count Parameter Description last member query count value...
Page 911
IGMP Multicast Commands ip igmp last-member-query-interval Use this command to configure the frequency at which the router sends IGMP group-specific host query messages. To set this frequency to the default value, use the no parameter with this command. Syntax ip igmp last-member-query-interval <interval> no ip igmp last-member-query-interval Parameter Description...
IGMP Multicast Commands ip igmp limit Use this command to configure the limit on the maximum number of group membership entries for the device as a whole or for the specified interface (if in interface mode). Once the specified number of group memberships is reached, all further membership reports will be ignored.
IGMP Multicast Commands ip igmp mroute-proxy Use this command to enable IGMP mroute proxy on this downstream interface and associate it with the upstream proxy service interface. Use the no parameter with this command to remove the association with the proxy-service interface.
IGMP Multicast Commands ip igmp proxy-service Use this command to enable the interface to be the upstream IGMP proxy-service interface for the device. All associated downstream IGMP mroute proxy interfaces on this device will have their memberships consolidated on this proxy service interface, according to IGMP host-side functionality.
IGMP Multicast Commands ip igmp querier-timeout Use this command to configure the timeout period before the device takes over as the querier for the interface after the previous querier has stopped querying. To restore the default value, use the no parameter with this command. Syntax ip igmp querier-timeout <timeout>...
IGMP Multicast Commands ip igmp query-interval Use this command to configure the frequency of sending IGMP general query messages. Note: The the IGMP query interval frequency must be greater than the IGMP query maximum response time. To return to the default query interval frequency, use the no parameter with this command. Syntax ip igmp query-interval <interval>...
IGMP Multicast Commands ip igmp query-max-response-time Use this command to configure the maximum response time advertised in IGMP queries. Note: The IGMP query maximum response time must be less than the IGMP query interval frequency. To restore the default value, use the no parameter with this command. Syntax ip igmp query-max-response-time <responsetime>...
IGMP Multicast Commands ip igmp ra-option (Router Alert) With strict Router Alert (RA) option enabled, IGMP packets without RA options are ignored. Use the ip igmp ra-option command to enable strict Router Alert (RA) option validation. User the no igmp ra-option command to disable strict Router Alert (RA) option validation. Syntax ip igmp ra-option no ip igmp ra-option...
IGMP Multicast Commands ip igmp snooping Use this command to enable IGMP Snooping. When this command is given in the Global Config mode, IGMP Snooping is enabled at the switch level. When this command is given at the VLAN interface level, IGMP Snooping is enabled for that VLAN. Use the no parameter with this command to globally disable IGMP Snooping, or for the specified interface.
IGMP Multicast Commands ip igmp snooping mrouter Use this command to statically configure the specified port in the VLAN as a multicast router port for IGMP Snooping in that VLAN. Use the no parameter with this command to remove the static configuration of the port as a multicast router port.
IGMP Multicast Commands ip igmp snooping querier Use this command to enable IGMP querier operation on a VLAN when no multicast routing protocol is configured in the VLAN. When enabled, the IGMP Snooping querier sends out periodic IGMP queries for all interfaces on that VLAN. Use the no parameter with this command to disable IGMP querier configuration.
IGMP Multicast Commands ip igmp snooping report-suppression Use this command to enable report suppression for IGMP versions 1 and 2. Report suppression stops reports being sent to an upstream multicast router port when there are already downstream ports for this group on this interface. Use the no parameter with this command to disable report suppression.
IGMP Multicast Commands ip igmp snooping routermode Use this command to set source IP addresses as router multicast addresses, according to the routermode (all multicast addresses, default multicast addresses, specified multicast addresses). Use the no parameter with this command to reset ip igmp snooping routermode to the default.
IGMP Multicast Commands ip igmp ssm-map enable Use this command to enable Source Specific Mapping (SSM) on the device. Use the no parameter with this command to disable SSM mapping. Syntax ip igmp ssm-map enable no ip igmp ssm-map enable Global Config mode Mode This command applies to interfaces configured for IGMP.
IGMP Multicast Commands ip igmp ssm-map static Use this command to specify the static mode of defining SSM mapping. SSM mapping statically assigns sources to IGMPv1 and IGMPv2 groups to translate such (*,G) groups’ memberships to (S,G) memberships for use with PIM-SSM. Use the no parameter with this command to remove the SSM map association.
IGMP Multicast Commands ip igmp static-group Use this command to statically configure group membership entries on an interface. To statically add only a group membership, do not specify any parameters. Use the no parameter with this command to delete static group membership entries. Syntax ip igmp static-group <ip-address>...
IGMP Multicast Commands ip igmp version Use this command to set the current IGMP version (IGMP version 1, 2 or 3) on an interface. To return to the default version, use the no parameter with this command. Syntax ip igmp version <1-3> no ip igmp version Parameter Description...
IGMP Multicast Commands show debugging igmp Use this command to display the IGMP debugging option set. To modify the lines displayed, use the | (output modifier token) ; to save the output to a file use the > output redirection token. . Syntax show debugging igmp Privileged Exec mode...
IGMP Multicast Commands show ip igmp groups Use this command to display the multicast groups with receivers directly connected to the router, and learned through IGMP. Syntax show ip igmp groups [<ip-address>|<interface> detail] Parameter Description Address of the multicast group, entered in the form A.B.C.D. <ip-address>...
IGMP Multicast Commands show ip igmp interface Use this command to display the state of IGMP, IGMP Proxy service, and IGMP Snooping for a specified interface, or all interfaces. IGMP is shown as Active or Disabled in the show output. Syntax show ip igmp interface [<interface>] Parameter...
IGMP Multicast Commands show ip igmp snooping mrouter Use this command to display the multicast router ports, both static and dynamic, in a VLAN. Syntax show ip igmp snooping mrouter interface <interface> Parameter Description The name of the VLAN interface <interface>...
IGMP Multicast Commands show ip igmp snooping routermode Use this command display the current routermode and the list of IP addresses set as router multicast addresses from the ip igmp snooping routermode command. Syntax show ip igmp snooping routermode Exec mode and Privileged Exec mode Mode To show the routermode and the list of router multicast addresses, use the command: Example...
IGMP Multicast Commands show ip igmp snooping statistics Use this command to display IGMP Snooping statistics data. To modify the lines displayed, use the | (output modifier token); to save the output to a file, use the > output redirection token. Syntax show ip igmp snooping statistics interface <interface-range>...
Page 934
IGMP Multicast Commands Software Reference for SwitchBlade® x908, x900 and x600 Series Switches 41.32 AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
Chapter 42: Common Multicast Commands Introduction................................42.2 clear ip mroute..............................42.2 clear ip mroute statistics ..........................42.2 debug nsm mcast ..............................42.3 ip mroute.................................42.4 ip multicast route-limit .............................42.5 ip multicast-routing.............................42.6 multicast ...................................42.7 show ip mroute ..............................42.8 show ip mvif................................ 42.10 show ip rpf................................42.10 Software Reference for SwitchBlade®...
Common Multicast Commands Introduction This chapter contains common multicast commands. See also Chapter 44, PIM-SM Commands. For IGMP commands, see Chapter 41, IGMP Multicast Commands. clear ip mroute Use this command to delete entries from the IP multicast routing table. Syntax clear ip mroute {*|<group-addr>...
Common Multicast Commands debug nsm mcast Use this command to debug events in the Multicast Routing Information Base (MRIB). Syntax debug nsm mcast {all|fib-msg|mrt|mtrace|mtrace-detail|register|stats|vif} Parameter Description All IPv4 multicast debugging. Forwarding Information Base (FIB) messages. fib-msg Multicast routes. Multicast traceroute. mtrace mtrace-detail Multicast traceroute detailed debugging.
Common Multicast Commands ip mroute Use this command to create a multicast static route. Use the no form of this command to delete the route. Multicast static routes are unicast routes which allow multicast and unicast topologies to be independent. These routes are used by multicast routing protocols to perform reverse-path forwarding (RPF) checks.
Common Multicast Commands ip multicast route-limit Use this command to limit the number of multicast routes that can be added to a multicast routing table. Use the no parameter with this command to return the limit to the default. Syntax ip multicast route-limit <limit>...
Common Multicast Commands ip multicast-routing Use this command to turn on/off multicast routing on the router; when turned off the device does not perform multicast functions. Use the no parameter with this command to disable multicast routing after enabling it. Note the default stated below.
Page 941
Common Multicast Commands multicast Use this command to enable a switch port to route multicast packets that ingress the port. Use the no form of this command to stop the switch port from routing multicast packets that ingress the port. Note that this does not affect layer 2 forwarding of multicast packets. If you enter no multicast on a port, multicast packets received on that port will not be forwarded to other VLANs, but ports in the same VLANs as the receiving port will still receive the multicast packets.
Common Multicast Commands show ip mroute Use this command to display the contents of the IP multicast routing (mroute) table. Syntax show ip mroute [<group-addr>] [<source-addr>] [{dense|sparse}] [{count|summary}] Parameter Description Group IP address. <group-addr> Source IP address. <source-addr> Display dense multicast routes. dense Display sparse multicast routes.
Page 943
Common Multicast Commands Interface State: Interface (TTL) (10.10.1.52, 224.0.1.3), uptime 00:03:24, stat expires 00:01:28 Owner PIM-SM, Flags: TF Incoming interface: vlan2 Outgoing interface list: vlan3 (1) The following is a sample output of this command displaying the packet count from the IP multicast routing table: awplus# show ip mroute count IP Multicast Statistics...
Common Multicast Commands show ip mvif Use this command to display the contents of the Multicast Routing Information Base (MRIB) VIF table. Syntax show ip mvif [<interface>] Parameter Description The interface to display information about. <interface> Exec and Privileged Exec mode Mode The following are sample outputs of this command displaying the contents for the MRIB VIF Usage...
Chapter 43: PIM-SM Configuration Introduction................................43.2 PIM Sparse Mode ............................43.2 Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1 43.1...
PIM-SM Configuration Introduction PIM Sparse Mode PIM Sparse Mode (PIM-SM) provides efficient communication between members of sparsely distributed groups - the type of groups that are most common in wide-area internetworks. It is designed on the principle that several hosts wishing to participate in a multicast conference does not justify flooding the entire internetwork with periodic multicast traffic.
Page 947
PIM-SM Configuration Roles in PIM Sparse Mode A multicast sender does not need to know the addresses of the members of the group in order to send to them, and the members of the group need not know the address of the sender.
Page 948
PIM-SM Configuration Operation of PIM Sparse Mode Once roles are established, multicast routing follows specific phases: Rendezvous point tree Register stop Shortest path tree While multicast routing always begins with phase 1, the designated router for a receiver determines whether and when to move on to phases 2 and 3, depending on the amount of traffic from the source.
Page 949
PIM-SM Configuration Shortest path This phase further optimizes routing by using shortest path trees (SPT). In phase 3 the receiver tree joins the shortest path tree between the source and receiver. This allows a multicast group member to receive multicast data by the shortest path from the sender, instead of from the shared RP tree.
Page 950
PIM-SM Configuration Software Reference for SwitchBlade® x908, x900 and x600 Series Switches 43.6 AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
PIM-SM Commands Introduction This chapter provides an alphabetical reference for each of the PIM-SM Commands. See also Chapter 42, Common Multicast Commands. clear ip pim sparse-mode bsr rp-set * Use this command to clear all Rendezvous Point (RP) sets learned through the PIMv2 Bootstrap Router (BSR).
PIM-SM Commands debug pim sparse-mode timer bsr Use this command to enable the PIM-SM BSR timer’s debugging. Use the no parameter with this command to disable the PIM-SM BSR timer’s debugging. Syntax debug pim sparse-mode timer bsr [bst|crp] no debug pim] sparse-mode timer bsr [bst|crp] Parameter Description Turn on/off Boot-strap debugging timer.
PIM-SM Commands debug pim sparse-mode timer joinprune Use this command to enable the PIM-SM JoinPrune timer’s debugging. Use the no parameter with this command to disable the PIM-SM JoinPrune timer’s debugging. Syntax debug pim sparse-mode timer joinprune [jt|et|ppt|kat|ot] no debug pim sparse-mode timer joinprune [jt|et|ppt|kat|ot] Parameter Description...
PIM-SM Commands ip pim accept-register list Use this command to configure the ability to filter out multicast sources specified by the given access-list at the Rendezvous Point (RP), so that the RP will accept/refuse to perform the register mechanism for the packets sent by the specified sources. By default, the RP accepts register packets from all multicast sources.
PIM-SM Commands ip pim anycast-rp Use the ip pim anycast-rp command to configure Anycast RP (Rendezvous Point) in a RP set. Use the no ip pim anycast-rp command to remove the configuration set with ip pim anycast-rp. Syntax ip pim anycast-rp <anycast_rp_address> <member_rp_address> no ip pim anycast-rp <anycast_rp_address>...
PIM-SM Commands ip pim bsr-border Use the ip pim bsr-border command to prevent bootstrap router (BSR) messages from being sent or received through an interface. The BSR border is the border of the PIM domain. Use the no ip pim bsr-border command to disable the configuration set with ip pim bsr- border.
PIM-SM Commands ip pim bsr-candidate Use the pim bsr-candidate command to give the device the candidate BSR (bootstrap router) status using the specified IP address mask of the the interface. Use the no pim bsr-candidate command to disable this function to remove the BSR candidate.
PIM-SM Commands ip pim cisco-register-checksum group-list Use this command to configure the option to calculate the Register checksum over the whole packet on multicast groups specified by the access-list. This command is used to inter-operate with older Cisco IOS versions. Use the no parameter with this command to revert to default settings.
PIM-SM Commands ip pim dr-priority Use this command to set the designated router priority value. Use the no parameter with this command to disable this function. Syntax ip pim dr-priority <priority> no ip pim dr-priority Parameter Description <0-4294967294> The priority value. A higher value has a higher <priority>...
Page 962
PIM-SM Commands ip pim hello-holdtime Configures a hello-holdtime. You cannot configure a hello-holdtime value that is less than the current hello-interval. Each time the hello interval is updated, the hello holdtime is also updated, according to the following rules: If the hello holdtime is not configured; or if the hello holdtime is configured and less than the current hello-interval value, it is modified to the (3.5 * hello interval).
Page 963
PIM-SM Commands ip pim hello-interval Configures a hello interval. When the hello interval is configured, and the hello holdtime is not configured, or when the configured hello-holdtime value is less than the new hello-interval value; the holdtime value is modified to the (3.5 * hello interval). Otherwise, the hello-holdtime value is the configured value.
PIM-SM Commands ip pim jp-timer Use this command to set the join/prune timer. Syntax ip pim jp-timer <1-65535> Parameter Description Specifies the Join/Prune timer value. <1-65535> Global Configuration mode Mode Example awplus# configure terminal awplus(config)# ip pim jp-timer 234 ip pim neighbor-filter Enables filtering of neighbors on the interface.
PIM-SM Commands ip pim register-rate-limit Use this command to configure the rate of register packets sent by this DR, in units of packets per second. Use the no parameter to remove the limit. Syntax ip pim register-rate-limit <1-65535> no ip pim register-rate-limit Parameter Description <1-65535>...
PIM-SM Commands ip pim register-source Use this command to configure the source address of register packets sent by this DR, overriding the default source address, which is the address of the RPF interface toward the source host. Use the no parameter to un-configure the source address of Register packets sent by this DR, reverting back to use the default source address that is the address of the RPF interface toward the source host.
PIM-SM Commands ip pim register-suppression Use this command to configure the register-suppression time, in seconds, overriding the default value of 60 seconds. Configuring this value modifies register-suppression time at the DR. Configuring this value at the RP modifies the RP-keepalive-period value if the ip pim rp- register-kat command on page 44.21 is not used.
PIM-SM Commands ip pim rp-address Use this command to statically configure RP (Rendezvous-Point) address for multicast groups. Use the no ip pim rp-address command to remove a statically configured RP (Rendezvous- Point) address for multicast groups. Syntax ip pim rp-address <ip-address> [<simplerange>|<expandedrange>...
Page 969
PIM-SM Commands Group mode and RP address mappings learned through BSR take precedence over mappings statistically defined by the ip pim rp-address command with the override keyword. Commands with the override keyword take precedence over dynamically learned mappings. Example awplus# configure terminal awplus(config)# ip pim rp-address 192.168.3.4 4...
PIM-SM Commands ip pim rp-candidate Use this command to give the router the candidate RP (Rendezvous-Point) status using the IP address of the specified interface. Use the no parameter to remove the RP status set using the ip pim rp-candidate command.
PIM-SM Commands ip pim rp-register-kat Use this command to configure the Keep Alive Time (KAT) for (S,G) states at the RP (Rendezvous-Point) to monitor PIM Register packets. Use the no parameter to remove a previously configured KAT time with ip pim rp-register- kat.
PIM-SM Commands ip pim sparse-mode passive Enable/disable passive mode operation for local members on the interface. Passive mode essentially stops PIM transactions on the interface, allowing only IGMP mechanism to be active. To turn off passive mode, use the no ip pim sparse-mode passive or the ip pim sparse-mode command.
PIM-SM Commands ip pim spt-threshold group-list Use this command to turn on/off the ability for the last-hop PIM router to switch to SPT for multicast group addresses specified by the given access-list. The switching to SPT happens either at the receiving of the first data packet, or not at all; it is not rate-based.
PIM-SM Commands ip pim ssm Use this command to define the Source Specific Multicast (SSM) range of IP multicast addresses. The default keyword defines the SSM range as 232/8. To define the SSM range to be other than the default, use the access-list. Use the no variant of this command to disable the SSM range.
PIM-SM Commands show debugging pim sparse-mode This command displays the status of the debugging of the system. Syntax show debugging pim sparse-mode Privileged Exec mode Mode Figure 44-1: output from the show debugging pim sparse-mode command Output Debugging status: PIM event debugging is on PIM Hello THT timer debugging is on PIM event debugging is on PIM MFC debugging is on...
PIM-SM Commands show ip pim sparse-mode interface Use this command to show PIM-SM interface information. Syntax show ip pim sparse-mode interface Privileged Exec and Exec mode Mode Figure 44-3: output from the show ip pim sparse-mode interface command Output Address Interface VIFindex Ver/...
PIM-SM Commands show ip pim sparse-mode mroute This command displays the IP multicast routing table, or the IP multicast routing table based on the specified address or addresses. Two group addresses cannot be used simultaneously; two source addresses cannot be used simultaneously.
PIM-SM Commands show ip pim sparse-mode mroute detail This command displays detailed entries of the IP multicast routing table, or detailed entries of the IP multicast routing table based on the specified address or addresses. Two group addresses cannot be used simultaneously; two source addresses cannot be used simultaneously.
Page 979
PIM-SM Commands Figure 44-6: output from the show ip pim sparse-mode mroute detail command Output IP Multicast Routing Table (*,*,RP) Entries: 0 (*,G) Entries: 4 (S,G) Entries: 0 (S,G,rpt) Entries: 0 FCR Entries: 0 (*, 224.0.1.24) Uptime: 00:06:42 RP: 0.0.0.0, RPF nbr: None, RPF idx: None Upstream: State: JOINED, SPT Switch: Disabled, JT: off Macro state: Join Desired,...
PIM-SM Commands show ip pim sparse-mode neighbor Use this command to show the PIM-SM neighbor information. Syntax show ip pim sparse-mode neighbor [<interface>] [<ip-address>] [detail] Parameter Description <interface> Optional. Interface name (e.g. vlan2). Show neighbors on an interface. Optional. Show neighbors with a particular address on an interface. The IP <ip-address>...
PIM-SM Commands show ip pim sparse-mode nexthop Use this command to see the nexthop information as used by PIM-SM. Syntax show ip pim sparse-mode nexthop Exec and Privileged Exec mode Mode Example awplus# show ip pim sparse-mode nexthop Output Figure 44-9: Output from the show ip pim sparse-mode nexthop command Flags: N = New, R = RP, S = Source, U = Unreachable Destination Type Nexthop Nexthop Nexthop Nexthop...
PIM-SM Commands show ip pim sparse-mode rp-hash Use this command to display the rendezvous point (RP) to be chosen based on the group selected. Syntax show ip pim sparse-mode rp-hash <group-addr> Parameter Description The group address for which to find the RP, entered in the form A.B.C.D. <group-addr>...
PIM-SM Commands undebug all pim sparse-mode Use this command to disable all PIM-SM debugging. Syntax undebug all pim sparse-mode Privileged Exec mode Mode Example awplus# undebug all pim sparse-mode debug pim sparse-mode Related Commands Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1...
Page 984
PIM-SM Commands Software Reference for SwitchBlade® x908, x900 and x600 Series Switches 44.34 AlliedWare Plus Operating System - Software Version 5.3.1 C613-50007-01 REV B...
Chapter 45: PIM-DM Configuration Introduction................................45.2 Characteristics of PIM-DM........................45.2 PIM-DM Terminology..........................45.3 PIM-DM Configuration ............................45.4 Configuration Example..........................45.4 Verifying Configuration ............................45.8 Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1 45.1...
Page 986
PIM-DM Configuration Introduction Protocol Independent Multicast - Dense Mode (PIM-DM) is a data-driven multicast routing protocol, which builds source-based multicast distribution trees that operate on the Flood-and- Prune principle. It requires unicast-reachability information, but does not depend on a specific unicast routing protocol.
PIM-DM Terminology See the below descriptions of the terms and concepts used to describe the PIM-DM protocol: Any Layer 3 routing device that is running PIM, such as an Allied Telesis managed Layer 3 PIM Router switch or Allied Telesis router.
The main requirement is to enable PIM-DM on the desired interfaces. This section provides a PIM-DM configuration example for a relevant scenario. The configuration uses Allied Telesis managed Layer 3 Switches as the PIM Routers. Three PIM Routers are connected in a chain, and a multicast client is attached to the third PIM Router.
Page 989
PIM-DM Configuration The steps involved in the forwarding of the multicast streams for this sample configuration are: When the PIM Routers start, they use the exchange of PIM Hello packets to for PIM Switch A neighbor relationships with each other. Then each PIM Router becomes aware of the location of its PIM neighbors.
Page 990
PIM-DM Configuration See the following configuration output for Switch A: Switch A Configuration hostname Switch A Output vlan database vlan 2 state enable vlan 3 state enable interface vlan2 ip address 10.10.1.9/24 ip igmp ip pim dense-mode interface vlan3 ip address 10.10.3.9/24 ip igmp ip pim dense-mode interface port1.0.1...
Page 991
PIM-DM Configuration switchport access vlan 2 ip multicast-routing See the following configuration output for Switch C: Switch C Configuration hostname Switch C Output vlan database vlan 2 state enable vlan 3 state enable interface vlan2 ip address 172.16.1.10/24 ip igmp ip pim dense-mode interface vlan3 ip address 192.168.1.10/24...
PIM-DM Configuration Verifying Configuration Use the following commands to verify the interface details and multicast routing table. Note: For details on the commands used in the following example, refer to the PIM-DM Command Reference. The show ip pim dense-mode interface command displays the interface details Interface Details for Switch C.
PIM-DM Commands Introduction This chapter provides an alphabetical reference for each of the PIM-DM commands. debug pim dense-mode all debug pim dense-mode all Command vs_531 %flag PIM-DM Commands This command enables or disables PIM-DM debugging. This command enables or disables PIM-DM debugging. Syntax debug pim dense-mode all...
PIM-DM Commands debug pim dense-mode context debug pim dense-mode contextCommand vs_531 %flag PIM-DM Commands Enables or disables debugging of general configuration and Virtual Routing (VR), and Virtual Routing and Forwarding (VRF) context. Enables or disables debugging of general configuration and Virtual Routing (VR), and Virtual Routing and Forwarding (VRF) context.
PIM-DM Commands debug pim dense-mode mrt debug pim dense-mode mrt Command vs_531 %flag PIM-DM Commands Enables or disables debugging of MRT and MRT-VIF entry handling (for example, creation and deletion of). Enables or disables debugging of MRT and MRT-VIF entry handling (for example, creation and deletion of).
PIM-DM Commands debug pim dense-mode vif debug pim dense-mode vif Command vs_531 %flag PIM-DM Commands Enables or disables debugging of VIF handling. Enables or disables debugging of VIF handling. Syntax debug pim dense-mode vif no debug pim dense-mode vif Global Configuration mode and Privileged Exec mode Mode Example awplus#...
PIM-DM Commands ip pim dense-mode ip pim dense-mode Command vs_531 %flag PIM-DM Commands This command enables or disables PIM-DM operation from Interface mode on the current interface. This command also disables passive mode on the interface if passive mode has been enabled using an ip pim dense-mode passive command.
Page 1001
PIM-DM Commands ip pim hello-holdtime ip pim hello-holdtime Command vs_531 %flag PIM-DM Commands This command configures a hello-holdtime. The PIM-DM hello-holdtime on an interface is the period which the router will wait to receive a hello from neighbors on that interface. This command configures a hello-holdtime.
Page 1002
PIM-DM Commands ip pim hello-interval ip pim hello-interval Command vs_531 %flag PIM-DM Commands This command configures a PIM-DM hello-interval value. The PIM-DM hello-interval on an interface is the period at which the router will transmit PIM-DM hello messages on that interface. This command configures a PIM hello-interval value.
Page 1003
PIM-DM Commands ip pim neighbor-filter ip pim neighbor-filter Command vs_531 %flag PIM-DM Commands Enables filtering of neighbors on the interface. When configuring a neighbor filter, PIM-DM will either not establish adjacency with the neighbor, or terminate adjacency with the existing neighbors if denied by the filtering access list.
PIM-DM Commands ip pim propagation-delay ip pim propagation-delay Command vs_531 %flag PIM-DM Commands This command configures the PIM-DM propagation-delay value. The PIM-DM propagation-delay is the expected delay in the transfer of PIM-DM messages on the segment that the interface is attached This command configures the PIM propagation-delay value.
Need help?
Do you have a question about the SwitchBlade x908 Series and is the answer not in the manual?
Questions and answers