Allied Telesis SwitchBlade x908 Series Software Reference Manual
Allied Telesis SwitchBlade x908 Series Software Reference Manual

Allied Telesis SwitchBlade x908 Series Software Reference Manual

Switchblade x908/x900 series alliedware plus operating system software reference for version 5.3.1
Hide thumbs Also See for SwitchBlade x908 Series:
Table of Contents

Advertisement

®
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

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the SwitchBlade x908 Series and is the answer not in the manual?

Questions and answers

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®...
  • Page 5: Table Of Contents

    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 6 Chapter 2. Command Syntax Conventions in this Software Reference ......2.1 Chapter 3. Start-up Sequence .....................3.1 AlliedWare Plus™ Start-up..................................3.2 Diagnostic menu......................................3.2 Bootloader menu......................................3.4 Start-up sequence......................................3.8 Chapter 4. CLI Navigation Commands ................4.1 Introduction........................................4.2 Chapter 5. User Access Commands ...................5.1 Introduction........................................
  • 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 10 Chapter 31. RIP Configuration ..................31.1 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 Chapter 32. RIP Commands ....................32.1 Introduction........................................32.2 Chapter 33. RIPng Configuration ..................33.1 Introduction........................................33.2 Enabling RIPng......................................33.2 Troubleshooting RIPng Adjacency ..............................33.4...
  • Page 11 Part 4 Multicast Applications Chapter 40. IGMP Snooping Configuration ..............40.1 Introduction........................................40.2 Configuring Switch 1 ....................................40.3 Chapter 41. IGMP Multicast Commands................41.1 Introduction........................................41.2 Chapter 42. Common Multicast Commands ..............42.1 Introduction........................................42.2 Chapter 43. PIM-SM Configuration...................43.1 Introduction........................................43.2 PIM Sparse Mode ..................................43.2 Chapter 44. PIM-SM Commands..................44.1 Introduction........................................44.2 Chapter 45.
  • 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 13: Introduction And Configuration

    Chapter 55. Authentication Commands ................55.1 Chapter 56. AAA Introduction and Configuration............56.1 AAA Introduction......................................56.2 Available functions and server types ..........................56.2 Server Groups and Method Lists ...........................56.2 Configuring AAA Login Authentication............................56.4 AAA Configuration Tasks..............................56.4 Chapter 57. AAA Commands....................57.1 Chapter 58. RADIUS Commands..................58.1 Chapter 59.
  • Page 14 Chapter 63. Secure Shell Commands ................63.1 Part 6 Network Availability VRRP Introduction 1 Introduction........................................64.2 Virtual Router Redundancy Protocol .............................64.3 VRRP Configuration....................................64.4 VRRP Election and Pre-empt............................64.5 VRRP Authentication................................64.6 VRRP Debugging..................................64.6 Configuration Examples ...............................64.7 VRRP Commands 1 Introduction........................................65.2 Typical command sequences ................................65.2 VRRP Commands......................................65.3 EPSR Introduction 1 Introduction........................................66.2...
  • Page 15 Chapter 73. SNMP Commands ..................73.1 Chapter 74. SNMP MIBs.....................74.1 Introduction........................................74.2 About MIBs ....................................74.2 About SNMP....................................74.2 Obtaining MIBs..................................74.2 Loading MIBs ....................................74.3 Allied Telesis Enterprise MIB................................74.5 AT-SMI-MIB ....................................74.6 AT-PRODUCT-MIB................................74.9 AT-BOARDS-MIB ................................74.10 AT-SYSINFO-MIB ................................74.12 AT-XEM-MIB ..................................74.14 Software Reference for SwitchBlade® x908 and x900 Series Switches...
  • Page 16 AT-ENVMONv2-MIB ................................74.15 AT-VCSTACK-MIB................................74.22 AT-USER-MIB..................................74.26 AT-RESOURCE-MIB ................................74.27 AT-LICENSE-MIB .................................74.28 AT-TRIGGER-MIB................................74.31 AT-LOOPPROTECT-MIB...............................74.33 AT-SETUP-MIB ..................................74.35 AT-DNS-CLIENT-MIB...............................74.41 AT-NTP-MIB ...................................74.42 AT-EPSRv2-MIB..................................74.45 AT-FILEv2-MIB ..................................74.48 AT-LOG-MIB ..................................74.55 AT-IP-MIB ....................................74.57 Public MIBs........................................74.59 Chapter 75. SMTP Commands..................75.1 Chapter 76. RMON Commands ..................76.1 Introduction........................................76.2 Chapter 77. Triggers Introduction ..................77.1 Introduction........................................77.2 Configuring a Trigger ....................................77.2 Troubleshooting Triggers ..................................77.4 Chapter 78.
  • 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 ■...
  • Page 21: Introduction

    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...
  • Page 22: Chapter 1. Getting Started

    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.
  • Page 23: Viewing A List Of Valid Parameters

    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...
  • Page 26: Completing Keywords

    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...
  • Page 28: Viewing Command Error Messages

    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.
  • Page 29: How To Work With Command Modes

    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.
  • Page 33: How To See The Current Configuration

    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>...
  • Page 34: Default Settings

    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 ■...
  • Page 35: The Default Configuration Script

    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.
  • Page 36: How To Change The Password

    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.
  • Page 37: How To Save And Boot From The Current Configuration

    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#...
  • Page 39: How To Return To The Factory Defaults

    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.
  • Page 40: How To See System Information

    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...
  • Page 41: Viewing Temperature, Voltage, And Fan Status

    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.
  • Page 42: Viewing The Serial Number

    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:...
  • Page 43: How To Name The Switch

    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.
  • Page 44: How To Set The Time And Date

    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)#...
  • Page 45: How To Set The Time And Date

    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) ■...
  • Page 46: How To Add And Remove Users

    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...
  • Page 47: Pre-Encrypted Passwords

    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:...
  • Page 48: How To Undo Settings

    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.
  • Page 49: How To Upgrade The Firmware

    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.
  • Page 50: Controlling "Show" Command Output

    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...
  • Page 52: Commands Available In Each Mode

    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>...
  • Page 53: Privileged Exec Mode

    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...
  • Page 54: Global Configuration Mode

    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...
  • Page 56: Alliedware Plus Gui

    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.
  • Page 57: Chapter 2. Command Syntax Conventions In This Software 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...
  • Page 59: Diagnostic Menu

    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...
  • Page 60: Chapter 3. Start-Up Sequence

    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”...
  • Page 62: Bootloader Menu

    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.
  • Page 65: Start-Up Sequence

    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 66: Start-Up Sequence

    \ \_ __/ /| ______ | | ______ | \ ____ / /______/\____\ \/ /____________/ Allied Telesis Inc. AlliedWare Plus (TM) v5.3.1 Original release filename: r1-main-20081114-2.rel Built: Fri Nov 14 13:03:59 NZDT 2008 by: maker@awpmaker06-dl Mounting virtual filesystems... Mounting static filesystems...
  • 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...
  • Page 70: Chapter 4. Cli Navigation Commands

    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.
  • Page 71: Enable

    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)#...
  • Page 72: End

    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.
  • Page 73: Help

    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.
  • Page 74: Show Cli

    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...
  • Page 75: Show List

    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...
  • Page 78: Chapter 5. User Access Commands

    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:...
  • Page 79: Enable Password

    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...
  • Page 81: Exec-Timeout

    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).
  • Page 82: Length

    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–’...
  • Page 83: Line

    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...
  • Page 84: Privilege Level

    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...
  • Page 85: Service Password-Encryption

    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.
  • Page 86: Service Telnet

    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...
  • Page 87: Service Terminal-Length

    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...
  • Page 88: Show Telnet

    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...
  • Page 89: 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.
  • Page 90: Telnet Server

    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...
  • Page 91: Terminal Length

    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.
  • Page 92: Username

    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...
  • Page 94: Chapter 6. Creating And Managing Files

    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: ■...
  • Page 95 Creating and Managing Files The output looks like this: drwx 0 Jul 12 2008 17:16:32 -rw- 401 Jul 12 2008 17:16:32 example.cfg -rw- 534 Jul 12 2008 17:52:50 stp.cfg -rw- 12429011 Jul 12 2008 16:26:06 r1-5.2.2-rc3.rel drwx 216 Jul 9 2008 11:31:18 drwx 0 Jun 13 2008 04:31:51 .configs/...
  • Page 96: Displaying The Contents Of Configuration And Text Files

    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”...
  • Page 98: Using The Editor

    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.
  • Page 99: Creating And Using Configuration Files

    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.
  • Page 100: Working With Configuration Files

    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.
  • Page 101: Copying Files To And From Your Device

    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”...
  • Page 104: Copying From A Server To Running Configuration

    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 105: Chapter 7. File Management Commands

    Chapter 7: File Management Commands Introduction..................................7.3 boot backup..................................7.4 boot config-file...................................7.4 boot system ..................................7.5 cd.......................................7.5 copy current-software..............................7.6 copy debug..................................7.6 copy LOCAL ..................................7.7 copy running-config ................................7.8 copy startup-config................................7.9 copy URL................................... 7.10 copy zmodem ................................. 7.11 delete ....................................7.12 delete debug..................................7.12 dir ......................................7.13 edit......................................
  • 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...
  • Page 107: Introduction

    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.
  • Page 108: Boot Backup

    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.
  • Page 109: Boot System

    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.
  • Page 110: Copy Current-Software

    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>...
  • Page 111: Copy Local

    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.
  • Page 112: Copy Running-Config

    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>...
  • Page 113: Copy Startup-Config

    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>...
  • Page 114: Copy 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 ■...
  • Page 115: Copy Zmodem

    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>...
  • Page 116: Delete

    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”...
  • Page 117: Dir

    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.
  • Page 118: Edit

    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.
  • Page 119: Edit Url

    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.
  • Page 120: License

    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.
  • Page 121: Move

    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>...
  • Page 122: Move Debug

    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.
  • Page 123: Rmdir

    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...
  • Page 124: Show Boot

    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...
  • Page 125: Show File

    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#...
  • Page 126: Show File Systems

    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.
  • Page 128: Show License

    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...
  • Page 130: Show Running-Config

    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 ■...
  • Page 131: Show Running-Config Access-List

    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”...
  • Page 132: Show Running-Config Bgp

    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”...
  • Page 133: Show Running-Config Community-List

    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”...
  • Page 134: Show Running-Config Full

    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”...
  • Page 135: Show Running-Config Interface

    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...
  • Page 137: Show Running-Config Ip Pim Dense-Mode

    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”...
  • Page 138: Show Running-Config Ip Route

    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”...
  • Page 139: Show Running-Config Ipv6 Mroute

    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”...
  • Page 140: Show Running-Config Ipv6 Route

    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”...
  • Page 141: Show Running-Config Prefix-List

    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”...
  • Page 142: Show Running-Config Route-Map

    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”...
  • Page 143: Show Running-Config Router

    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.
  • Page 144: Show Running-Config Router-Id

    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”...
  • Page 145: Show Running-Config Switch

    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.
  • Page 146: Show Running-Config Switch Lacp

    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”...
  • Page 147: Show Running-Config Switch Vlan

    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”...
  • Page 148: Show Startup-Config

    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...
  • Page 149: Show Version

    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...
  • Page 150: Write File

    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...
  • Page 152: Chapter 8. System Configuration And Monitoring Commands

    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...
  • Page 154: Banner Login

    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.
  • Page 155: Banner Motd

    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.
  • Page 156: Clock Set

    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.
  • Page 157: Clock Summer-Time Date

    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...
  • Page 158: Clock Summer-Time Recurring

    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...
  • Page 159: Clock Timezone

    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.
  • Page 160: Debug Nsm

    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]...
  • Page 161: Hostname

    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 ■...
  • Page 162: No Debug All

    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.
  • Page 163: Max-Static-Routes

    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.
  • Page 164: Show Clock

    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#...
  • Page 165: Show Cpu

    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.
  • Page 169: Show Cpu History

    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 **************************************************** |..|..|..|..|..|..|..|..|..|..|..|..
  • Page 171: Show Debugging Nsm

    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...
  • Page 172: Show Memory

    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.
  • Page 174: Show Memory Allocations

    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.
  • Page 175: Show Memory History

    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...
  • Page 177: Show Memory Pools

    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...
  • Page 178: Show Nsm Client

    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.
  • Page 179: Show Router-Id

    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.
  • Page 180: Show System

    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...
  • Page 182: Show System Environment

    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.
  • Page 183: Show System Interrupts

    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...
  • Page 184: Show System Pci Device

    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:...
  • Page 185: Show System Pci Tree

    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:...
  • Page 186: Show System Pluggable

    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.
  • Page 187: Show Tech-Support

    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...
  • Page 190: System Territory

    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...
  • Page 191: Undebug Nsm

    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...
  • Page 193: Introduction

    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...
  • Page 194: Chapter 9. Debugging And Logging

    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.
  • Page 195: Logging

    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.
  • Page 199 Chapter 10: Logging Commands clear exception log.............................10.2 clear log ..................................10.2 clear log buffered ..............................10.3 clear log permanent............................10.4 default log buffered............................10.5 default log console .............................10.6 default log email..............................10.6 default log host..............................10.7 default log monitor ............................10.8 default log permanent ............................10.8 exception coredump size..........................10.9 log buffered .................................
  • Page 200: Chapter 10. Logging Commands

    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...
  • Page 201: Clear Log Buffered

    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...
  • Page 202: Clear Log Permanent

    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...
  • Page 203: Default Log Buffered

    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...
  • Page 204: Default Log Console

    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...
  • Page 205: Default Log Host

    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>...
  • Page 206: Default Log Monitor

    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...
  • Page 207: Exception Coredump Size

    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.
  • Page 208: Log Buffered

    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.
  • Page 209: Log Buffered (Filter)

    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.
  • Page 211: Log Buffered Size

    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...
  • Page 212: Log Console

    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.
  • Page 213: Log Console (Filter)

    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.
  • Page 215: Log Email

    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...
  • Page 216: Log Email (Filter)

    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...
  • Page 219: Log Email Time

    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.
  • Page 220: Log Host

    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>...
  • Page 221: Log Host (Filter)

    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...
  • Page 224: Log Host Time

    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.
  • Page 225: Log Monitor (Filter)

    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.
  • Page 227: Log Permanent

    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...
  • Page 228: Log Permanent (Filter)

    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®...
  • Page 231: Log Permanent Size

    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...
  • Page 232: Show Log

    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.
  • Page 233: Show Log Config

    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.
  • Page 235: Show Log Permanent

    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.
  • Page 236: Show Running-Config Log

    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-...
  • Page 237: Chapter 11. Scripting Commands

    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...
  • Page 242: Chapter 12. Interface Commands

    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...
  • Page 243: Interface

    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, ■...
  • Page 244: Mtu

    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>...
  • Page 245: Show Interface

    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, ■...
  • Page 246: Show Interface Brief

    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...
  • Page 247: Shutdown

    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...
  • Page 250: Chapter 13. Interface Testing Commands

    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...
  • Page 251: Service Test

    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.
  • Page 252: Test Interface

    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...
  • Page 255: Part 2 Layer Two Switching

    Part 2: Layer Two Switching Chapter 14 Switching Introduction ■ Chapter 15 Switching Commands ■ Chapter 16 VLAN Introduction ■ Chapter 17 VLAN Commands ■ Chapter 18 Spanning Tree Introduction: ■ STP, RSTP, and MSTP Chapter 19 Spanning Tree Commands ■...
  • Page 257 Chapter 14: Switching Introduction 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 The Learning Process..........................14.8 The Forwarding Process.........................14.9...
  • Page 258: Chapter 14. Switching Introduction

    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.
  • Page 259: Physical Layer Information

    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: ■...
  • Page 260: Activating And Deactivating Switch Ports

    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.
  • Page 261: Configuring The Port Speed

    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...
  • Page 263: The Layer 2 Switching Process

    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.
  • Page 264: The Learning Process

    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.
  • Page 265: The Forwarding Process

    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.
  • Page 266: Layer 2 Filtering

    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.
  • Page 267: Channel Groups (Link Aggregation)

    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.
  • Page 269: Storm Control

    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.
  • Page 270: Loop Protection

    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: ■...
  • Page 271: Thrash Limiting

    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.
  • Page 272: Support For Jumbo Frames

    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: ■...
  • Page 273: Port Mirroring

    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.
  • Page 274: Quality Of Service

    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.
  • Page 275: Igmp Snooping

    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 ..........................
  • Page 278: Chapter 15. Switching Commands

    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...
  • Page 279: Clear Mac Address-Table Static

    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.
  • Page 280: Clear Mac Address-Table Dynamic

    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.
  • Page 281: Clear Port Counter

    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...
  • Page 282: Debug Platform Packet

    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.
  • Page 283: Duplex

    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.
  • Page 284: Flowcontrol

    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.
  • Page 285: Loop-Protection

    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.
  • Page 286: Loop-Protection Action

    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}...
  • Page 287: Loop-Protection Timeout

    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>...
  • Page 288: Mac Address-Table Ageing-Time

    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>...
  • Page 289: Mac Address-Table Static

    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>...
  • Page 290: Mac Address-Table Thrash-Limit

    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>...
  • Page 291: Mirror Interface

    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.
  • Page 292: Platform Bist

    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>...
  • Page 293: Platform Control-Plane-Prioritization Rate

    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...
  • Page 295: Platform Enhancedmode

    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.
  • Page 296: Platform Jumboframe

    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: ■...
  • Page 297: Platform Load-Balancing

    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.
  • Page 298: Platform Routingratio

    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.
  • Page 299: Platform Vlan-Stacking-Tpid

    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.
  • Page 300: Show Flowcontrol Interface

    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...
  • Page 301: Show Interface Switchport

    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...
  • Page 302: Show Loop-Protection

    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.
  • Page 303: Show Mac Address-Table

    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...
  • Page 305: Show Mac Address-Table Thrash-Limit

    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...
  • Page 306: Show Mirror Interface

    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...
  • Page 307: Show Platform

    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...
  • Page 308: Show Platform Bist

    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...
  • Page 309: Show Platform Table Port

    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.
  • Page 310 Switching Commands Figure 15-7: Example output after using the show platform table port command PHY Registers for ifx 5001 (lport 0x00000004) 00 1140 1 7949 2 0141 3 0CD4 4 01E1 5 0000 6 0004 7 2001 08 0000 9 0F00 10 4000 11 0000 12 0000 13 0000 14 0000 15 3000 16 0078 17 8100 18 0000 19 0040 20 0CEA 21 0000 22 0000 23 0000 24 4101 25 0FEB 26 400C 27 848B 28 0000 29 0000 30 0000 31 0000 Port configurations:...
  • Page 311: Show Port-Security Interface

    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>...
  • Page 312: Show Port-Security Intrusion

    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.
  • Page 313: Show Storm-Control

    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).
  • Page 314: Speed

    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.
  • Page 315: Storm-Control Level

    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.
  • Page 316: Switchport Enable Vlan

    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...
  • Page 317: Switchport Port-Security Aging

    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...
  • Page 318: Switchport Port-Security Maximum

    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.
  • Page 319: Switchport Port-Security Violation

    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.
  • Page 320: Thrash-Limiting

    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........................
  • Page 322: Chapter 16. Vlan Introduction

    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.
  • Page 323: Configuring Vlans

    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.
  • Page 325: Vlan Double Tagging (Vlan Stacking)

    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.
  • Page 326: Restrictions When Using Double-Tagged Vlans

    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)#...
  • Page 328: Private Vlans

    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.
  • Page 329: Promiscuous Ports

    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 ■...
  • Page 330: Private Vlan Operation

    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...
  • Page 331: Example Configuration

    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........................
  • Page 334: Chapter 17. Vlan Commands

    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.
  • Page 335: Private-Vlan Association

    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.
  • Page 336: Show 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>...
  • Page 337: Show Vlan Classifier Group

    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.
  • Page 338: Show Vlan Classifier Rule

    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.
  • Page 339: Switchport Access Vlan

    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>...
  • Page 340: Switchport Enable Vlan

    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...
  • Page 341: Switchport Mode Access

    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.
  • Page 342: Switchport Mode Private-Vlan

    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...
  • Page 343: Switchport Mode Trunk

    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.
  • Page 344: Switchport Private-Vlan Host-Association

    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>...
  • Page 345: Switchport Private-Vlan Mapping

    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.
  • Page 346: Switchport Trunk Allowed Vlan

    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.
  • Page 347: Switchport Trunk Native Vlan

    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)#...
  • Page 348: Switchport Vlan-Stacking (Double Tagging)

    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...
  • Page 349: Vlan

    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.
  • Page 350: Vlan Classifier Activate

    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).
  • Page 351: Vlan Classifier Group

    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>...
  • Page 352: Vlan Classifier Rule Ipv4

    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...
  • Page 354: Vlan Classifier Rule Proto

    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>...
  • Page 355 VLAN Commands Parameter Description PPPoE discovery protocol [pppdiscovery|34915] PPPoE session protocol [pppsession|34916] Reverse Address Resolution [rarp|32821] protocol CCITT .25 protocol [x25|2056] Xerox PUP Address Translation [xeroxaddrtrans|513] protocol Xerox PUP protocol [xeroxpup|512] ethv2 Ethernet Version 2 encapsulation LLC without SNAP encapsulation nosnapllc snapllc LLC SNAP encapsulation...
  • Page 356: Vlan Database

    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#...
  • Page 357: Chapter 18. Spanning Tree Introduction: Stp, Rstp, And Mstp18.1

    Chapter 18: Spanning Tree Introduction: STP, RSTP, and MSTP 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 Multiple Spanning Tree Instances (MSTI) ..................
  • Page 358: Introduction

    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.
  • Page 360: Spanning Tree Modes

    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.
  • Page 361: Spanning Tree Protocol (Stp)

    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.
  • Page 362: Rapid Spanning Tree Protocol (Rstp)

    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.
  • Page 364: Configuring Rstp

    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.
  • Page 366: Multiple Spanning Tree Protocol (Mstp)

    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).
  • Page 367: Multiple Spanning Tree Instances (Msti)

    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.
  • Page 368: Mstp Regions

    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.
  • Page 370: Common And Internal Spanning Tree (Cist)

    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.
  • Page 372: Mstp Bridge Protocol Data Units (Bpdus)

    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...
  • Page 374: Configuring Mstp

    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”...
  • Page 375: Introduction

    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............................
  • Page 378: Chapter 19. Spanning Tree Commands

    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.
  • Page 379: Clear Spanning-Tree Detected Protocols (Rstp And Mstp)

    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.
  • Page 380: Debug Mstp (Rstp And Stp)

    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...
  • Page 382 Spanning Tree Commands In STP mode receiving an STP BPDU: awplus#terminal monitor awplus#debug mstp packet rx decode interface port1.0.19 17:31:36 awplus MSTP[1417]: port1.0.19 xSTP BPDU rx - start 17:31:36 awplus MSTP[1417]: Protocol version: STP, BPDU type: Config 17:31:36 awplus MSTP[1417]: Flags: role=none 17:31:36 awplus MSTP[1417]: Root id : 8000:0000cd1000fe...
  • Page 383: Instance Priority (Mstp)

    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.
  • Page 384: Instance Vlan (Mstp)

    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.
  • Page 385: Region (Mstp)

    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>...
  • Page 386: Revision (Mstp)

    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.
  • Page 387: Show Debugging Mstp

    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...
  • Page 388: Show Spanning-Tree

    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...
  • Page 391: Show Spanning-Tree Mst

    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.
  • Page 392: Show Spanning-Tree Mst Config

    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.
  • Page 393: Show Spanning-Tree Mst Detail

    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...
  • Page 395: Show Spanning-Tree Mst Detail Interface

    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).
  • Page 396: Show Spanning-Tree Mst Instance

    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.
  • Page 397: Show Spanning-Tree Mst Instance Interface

    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>...
  • Page 398: Show Spanning-Tree Mst Interface

    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>...
  • Page 399: Spanning-Tree Autoedge (Rstp And Mstp)

    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.
  • Page 400: Spanning-Tree Edgeport (Rstp And Mstp)

    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).
  • Page 401: Spanning-Tree Enable

    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...
  • Page 402: Spanning-Tree Errdisable-Timeout Enable

    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...
  • Page 403: Spanning-Tree Errdisable-Timeout Interval

    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>...
  • Page 404: Spanning-Tree Force-Version

    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.
  • Page 405: Spanning-Tree Forward-Time

    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.
  • Page 406: Spanning-Tree Guard Root

    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...
  • Page 407: Spanning-Tree Hello-Time

    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.
  • Page 408: Spanning-Tree Link-Type

    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...
  • Page 409: Spanning-Tree Max-Age

    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.
  • Page 410: Spanning-Tree Max-Hops (Mstp)

    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.
  • Page 411: Spanning-Tree Mode

    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.
  • Page 412: Spanning-Tree Mst Instance

    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.
  • Page 413: Spanning-Tree Mst Instance Path-Cost

    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.
  • Page 414: Spanning-Tree Mst Instance Priority

    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.
  • Page 415: Spanning-Tree Path-Cost

    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.
  • Page 416: Spanning-Tree Portfast

    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.
  • Page 417: Spanning-Tree Portfast Bpdu-Filter

    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.
  • Page 418: Spanning-Tree Portfast Bpdu-Guard

    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.
  • Page 419: Spanning-Tree Priority (Bridge Priority)

    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.
  • Page 420: Spanning-Tree Priority (Port Priority)

    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.
  • Page 421: Chapter 20. Link Aggregation Configuration

    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...
  • Page 422: Configuring Lacp

    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 ..............................
  • Page 426: Chapter 21. Link Aggregation Commands

    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)”...
  • Page 427: Channel-Group Mode

    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...
  • Page 429: Debug Lacp

    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.
  • Page 430: Lacp Port-Priority

    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).
  • Page 431: Lacp Timeout

    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...
  • Page 432: Show Debugging Lacp

    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...
  • Page 433: Show Etherchannel

    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.
  • Page 434: Show Etherchannel Detail

    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...
  • Page 435: Show Etherchannel Summary

    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...
  • Page 436: Show Lacp-Counter

    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 >...
  • Page 437: Show Port Etherchannel

    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>...
  • Page 438: Show Static-Channel-Group

    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...
  • Page 439: Static-Channel-Group

    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...
  • Page 441: Part 3 Layer Three, Switching And Routing

    Part 3: Layer Three, Switching and Routing Chapter 22 Internet Protocol (IP) Addressing and Protocols ■ Chapter 23 IP Addressing and Protocol Commands ■ Chapter 24 IPv6 Introduction ■ Chapter 25 IPv6 Commands ■ Chapter 26 IPv6to4 Tunneling Configuration ■ Chapter 27 IPv6to4 Tunneling Commands ■...
  • Page 443: Chapter 22. Internet Protocol (Ip) Addressing And Protocols

    Chapter 22: Internet Protocol (IP) Addressing and Protocols Introduction................................22.2 Address Resolution Protocol (ARP)......................22.3 Static ARP Entries............................22.3 Timing Out ARP Entries.........................22.3 Deleting ARP Entries..........................22.4 Proxy ARP..............................22.4 Domain Name System (DNS)........................22.7 Internet Control Message Protocol (ICMP)..................22.9 ICMP Router Discovery Protocol (IRDP)..................22.10 Checking IP Connections ..........................
  • Page 444: Introduction

    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.
  • Page 445: Address Resolution Protocol (Arp)

    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.
  • Page 446: Deleting Arp Entries

    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.
  • Page 449: Domain Name System (Dns)

    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>...
  • Page 451: Internet Control Message Protocol (Icmp)

    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)
  • Page 452: Icmp Router Discovery Protocol (Irdp)

    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.
  • Page 455: Checking Ip Connections

    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”...
  • Page 456: Ip Helper

    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.
  • Page 457: Chapter 23. Ip Addressing And Protocol Commands

    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...
  • Page 458: Introduction

    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.
  • Page 459: Arp (Ip Address Mac Address)

    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.
  • Page 460: Clear Arp-Cache

    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.
  • Page 461: Debug Ip Packet Interface

    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...
  • Page 463: Debug Ip Irdp

    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. ■...
  • Page 464: Ip Address

    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.
  • Page 465: Ip Domain-List

    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.
  • Page 466: Ip Domain-Lookup

    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.
  • Page 467: Ip Domain-Name

    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.
  • Page 468: Ip Directed-Broadcast

    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.
  • Page 469: Ip Forwarding

    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.
  • Page 470: Ip Gratuitous-Arp-Link

    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>...
  • Page 472: Ip Helper-Address

    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.
  • Page 473: Ip Irdp

    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.
  • Page 474: Ip Irdp Address Preference

    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.
  • Page 475: Ip Irdp Broadcast

    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.
  • Page 476: Ip Irdp Holdtime

    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>...
  • Page 477: Ip Irdp Lifetime

    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...
  • Page 478: Ip Irdp Maxadvertinterval

    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.
  • Page 479: Ip Irdp Minadvertinterval

    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.
  • Page 480: Ip Irdp Multicast

    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.
  • Page 481: Ip Irdp Preference

    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.
  • Page 482: Ip Local-Proxy-Arp

    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.
  • Page 483: Ip Name-Server

    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.
  • Page 484: Ip Proxy-Arp

    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.
  • Page 486: Router Ip Irdp

    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.
  • Page 487: Show Arp

    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);...
  • Page 488: Show Debugging Ip Packet

    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 >...
  • Page 489: Show Hosts

    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 >...
  • Page 490: Show Ip Domain-Name

    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);...
  • Page 491: Show Ip Interface Brief

    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 >...
  • Page 492: Show Ip Irdp

    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".
  • Page 493: Show Ip Irdp Interface

    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.
  • Page 495: Show Ip Name-Server

    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>...
  • Page 497: Chapter 24. Ipv6 Introduction

    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 ..........................
  • Page 498: Introduction

    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. ■...
  • Page 499: Ipv6 Addresses And Prefixes

    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: ■...
  • Page 500: Ipv6 Headers

    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).
  • Page 503: The Internet Control Message Protocol (Icmpv6)

    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.
  • Page 505: Ipv6 Routing

    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.
  • Page 506: Integration Of Ipv4 And Ipv6

    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.
  • Page 507: Chapter 25. Ipv6 Commands

    Chapter 25: IPv6 Commands Introduction................................25.2 clear ipv6 neighbors............................25.2 ipv6 address ................................25.2 ipv6 forwarding ..............................25.3 ipv6 nd managed-config-flag .........................25.4 ipv6 nd other-config-flag..........................25.5 ipv6 nd prefix ................................25.6 ipv6 nd ra-interval...............................25.7 ipv6 nd ra-lifetime...............................25.8 ipv6 nd reachable-time ............................25.9 ipv6 nd suppress-ra............................25.10 ipv6 neighbor..............................25.11 ipv6 route................................
  • Page 508: Introduction

    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...
  • Page 509: Ipv6 Forwarding

    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...
  • Page 510: Ipv6 Nd Managed-Config-Flag

    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.
  • Page 511: Ipv6 Nd Other-Config-Flag

    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.
  • Page 512: Ipv6 Nd Prefix

    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.
  • Page 513: Ipv6 Nd Ra-Interval

    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...
  • Page 514: Ipv6 Nd Ra-Lifetime

    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.
  • Page 515: Ipv6 Nd Reachable-Time

    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.
  • Page 516: Ipv6 Nd Suppress-Ra

    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.
  • Page 517: Ipv6 Neighbor

    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.
  • Page 518: Ipv6 Route

    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.
  • Page 519: Show Ipv6 Neighbors

    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.
  • Page 520: Show Ipv6 Route

    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);...
  • Page 521: Show Ipv6 Route Summary

    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...
  • Page 523: Chapter 26. Ipv6To4 Tunneling Configuration

    Chapter 26: IPv6to4 Tunneling Configuration Introduction................................26.2 6to4 Automatic Tunnel Configuration ....................26.2 Tunneling Operation ..........................26.2 6to4 tunnels operation and configuration summary..............26.3 Sample 6to4 configuration ........................26.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 26.1...
  • Page 524: Introduction

    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.
  • Page 525: 6To4 Tunnels Operation And Configuration Summary

    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.
  • Page 526: Sample 6To4 Configuration

    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...
  • Page 529: Chapter 27. Ipv6To4 Tunneling Commands

    Chapter 27: IPv6to4 Tunneling Commands Introduction................................27.2 interface tunnel..............................27.2 tunnel dscp ................................27.3 tunnel mode ipv6ip............................27.4 tunnel source.................................27.5 tunnel ttl ...................................27.6 Software Reference for SwitchBlade® x908, x900 and x600 Series Switches C613-50007-01 REV B AlliedWare Plus Operating System - Software Version 5.3.1 27.1...
  • Page 530: Introduction

    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).
  • Page 531: Tunnel Dscp

    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.
  • Page 532: Tunnel Mode Ipv6Ip

    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.
  • Page 533: Tunnel Source

    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.
  • Page 535: Chapter 28. Routing Protocol Overview

    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...
  • Page 536: Introduction

    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;...
  • Page 537: Bgp

    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.
  • Page 538: Vrrp

    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.
  • Page 539: Chapter 29. Route Selection

    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®...
  • Page 540: Introduction

    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) ■...
  • Page 542: Rib And Fib Routing Tables

    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.
  • Page 543: Equal Cost Multipath Routing

    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.
  • Page 545: How The Alliedware Plus Tm Os Adds Routes

    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...
  • Page 546: How The Alliedware Plus Tm Os Deletes Routes

    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.
  • Page 547: Chapter 30. Routing Commands

    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...
  • Page 548: Introduction

    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>...
  • Page 550: Show Ip Route

    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...
  • Page 552: Show Ip Route Database

    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.
  • Page 553: Show Ip Route Summary

    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...
  • Page 555: Chapter 31. Rip Configuration

    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...
  • Page 556: Introduction

    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.
  • Page 557: Specifying The Rip Version

    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.
  • Page 558: Ripv2 Authentication (Single Key)

    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...
  • Page 560: Ripv2 Text Authentication (Multiple Keys)

    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.
  • Page 563: Ripv2 Md5 Authentication (Multiple Keys)

    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...
  • Page 567: Chapter 32. Rip Commands

    Chapter 32: RIP Commands Introduction................................32.2 accept-lifetime...............................32.2 clear ip rip route..............................32.3 debug rip..................................32.4 default-information originate ........................32.4 default-metric ................................32.5 distance (rip)................................32.6 distribute-list................................32.7 ip rip authentication key-chain........................32.8 ip rip authentication mode ......................... 32.11 ip rip authentication string .......................... 32.14 ip rip receive-packet............................32.15 ip rip receive version............................
  • Page 568: Introduction

    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}...
  • Page 570: Debug Rip

    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>...
  • Page 572: Distance (Rip)

    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>...
  • Page 574: Ip Rip Authentication Key-Chain

    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)#...
  • Page 577: Ip Rip Authentication Mode

    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.
  • Page 580: Ip Rip Authentication String

    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.
  • Page 581: Ip Rip Receive-Packet

    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...
  • Page 582: Ip Rip Receive Version

    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...
  • Page 583: Ip Rip Send-Packet

    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...
  • Page 584: Ip Rip Send Version 1-Compatible

    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...
  • Page 586: Key Chain

    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>]...
  • Page 594: Restart Rip Graceful

    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.
  • Page 596: Router Rip

    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>...
  • Page 598: Show Debugging Rip

    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 >...
  • Page 599: Show Ip Rip Database

    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...
  • Page 600: Show Ip Rip Interface

    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>...
  • Page 602: Undebug Rip

    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...
  • Page 605: Chapter 33. Ripng Configuration

    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®...
  • Page 606: Introduction

    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.
  • Page 608: Troubleshooting Ripng Adjacency

    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...
  • Page 609: Step 3. Check The Interface Is Not A Passive Interface

    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...
  • Page 611: Chapter 34. Ripng Commands

    Chapter 34: RIPng Commands Introduction..................................34.2 aggregate-address ................................. 34.2 clear ipv6 rip route............................... 34.3 debug ipv6 rip ................................. 34.4 default-information originate (IPv6) ........................34.5 default-metric (IPv6)..............................34.5 distribute-list (IPv6)..............................34.6 ipv6 rip split-horizon ..............................34.7 ipv6 router rip................................. 34.8 neighbor (IPv6)................................34.9 offset-list (IPv6) ................................
  • Page 612: Introduction

    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: ■...
  • Page 613: Clear Ipv6 Rip Route

    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...
  • Page 614: Debug Ipv6 Rip

    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.
  • Page 615: Default-Information Originate (Ipv)

    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...
  • Page 616: Distribute-List (Ipv)

    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.
  • Page 617: Ipv6 Rip Split-Horizon

    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.
  • Page 618: Ipv6 Router Rip

    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...
  • Page 619: Neighbor (Ipv)

    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>...
  • Page 620: Offset-List (Ipv)

    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.
  • Page 621: Passive-Interface (Ipv)

    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>...
  • Page 622: Redistribute (Ipv)

    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.
  • Page 623: Route (Ipv)

    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>...
  • Page 624: Router Ipv6 Rip

    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...
  • Page 625: Show Ipv6 Protocols 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 >...
  • Page 626: Show Ipv6 Rip

    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 >...
  • Page 627: Show Ipv6 Rip Database

    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 >...
  • Page 628: Show Ipv6 Rip Interface

    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);...
  • Page 629: Timers (Ipv)

    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>...
  • Page 630: Undebug Ipv6 Rip

    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.
  • Page 631: Chapter 35. Ospf Configuration

    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...
  • Page 632: Introduction

    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.
  • Page 633: Enabling Ospf On An Interface

    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.
  • Page 634: Setting Priority

    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.
  • Page 636: Configuring An Area Border Router

    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.
  • Page 637: Redistributing Routes Into Ospf

    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.
  • Page 638: Ospf Cost

    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).
  • Page 640: Configuring Virtual Links

    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.
  • Page 641: Ospf Authentication

    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...
  • Page 645: Chapter 36. Ospf Commands

    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...
  • Page 647: Introduction

    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).
  • Page 648: Area Default-Cost

    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.
  • Page 649: Area Filter-List

    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.
  • Page 650: Area Nssa

    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...
  • Page 652: Area Range

    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).
  • Page 653: Area Stub

    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.
  • Page 654: Area Virtual-Link

    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.
  • Page 656: Auto-Cost Reference Bandwidth

    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.
  • Page 657: Capability Opaque

    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>...
  • Page 658: Capability Restart

    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...
  • Page 659: Compatible Rfc

    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.
  • Page 660: Debug Ospf Events

    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.
  • Page 661: Debug Ospf Ifsm

    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.
  • Page 662: Debug Ospf Lsa

    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.
  • Page 663: Debug Ospf Nfsm

    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.
  • Page 664: Debug Ospf Nsm

    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.
  • Page 665: Debug Ospf Packet

    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]...
  • Page 666: Debug Ospf Route

    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.
  • Page 669: Distance (Ospf)

    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>...
  • Page 671: Host Area

    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.
  • Page 672: Ip Ospf Authentication

    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.
  • Page 673: Ip Ospf Authentication-Key

    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.
  • Page 674: Ip Ospf Cost

    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.
  • Page 675: Ip Ospf Database-Filter

    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.
  • Page 676: Ip Ospf Dead-Interval

    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.
  • Page 677: Ip Ospf Hello-Interval

    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.
  • Page 678: Ip Ospf Message-Digest-Key

    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.
  • Page 679: Ip Ospf Mtu

    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)#...
  • Page 680: Ip Ospf Mtu-Ignore

    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.
  • Page 681: Ip Ospf Network

    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.
  • Page 682: Ip Ospf Priority

    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>...
  • Page 683: Ip Ospf Resync-Timeout

    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>...
  • Page 684: Ip Ospf Retransmit-Interval

    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>...
  • Page 685: Ip Ospf Transmit-Delay

    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>...
  • Page 689: Network Area

    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>...
  • Page 690: Ospf Abr-Type

    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...
  • Page 691: Ospf Restart Grace-Period

    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>...
  • Page 692: Ospf Restart Helper

    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...
  • Page 693: Ospf Router-Id

    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>...
  • Page 694: Overflow Database

    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>...
  • Page 695: Overflow Database External

    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>...
  • Page 698: Restart Ospf Graceful

    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.
  • Page 699: Show Debugging Ospf

    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.
  • Page 700: Show Ip Ospf

    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.
  • Page 702: Show Ip Ospf Border-Routers

    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 >...
  • Page 703: Show Ip Ospf Database

    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 >...
  • Page 704: Show Ip Ospf Database Asbr-Summary

    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 >...
  • Page 705: Show Ip Ospf Database External

    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>]...
  • Page 706: Show Ip Ospf Database Network

    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...
  • Page 708: Show Ip Ospf Database Nssa-External

    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...
  • Page 710: Show Ip Ospf Database Opaque-Area

    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 >...
  • Page 711: Show Ip Ospf Database Opaque-As

    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 >...
  • Page 712: Show Ip Ospf Database Opaque-Link

    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 >...
  • Page 713: Show Ip Ospf Database Router

    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>]...
  • Page 714: Show Ip Ospf Database Summary

    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...
  • Page 717: Show Ip Ospf Interface

    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>...
  • Page 718: Show Ip Ospf Neighbor

    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...
  • Page 720: Show Ip Ospf Route

    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 >...
  • Page 721: Show Ip Ospf Virtual-Links

    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...
  • Page 722: Show Ip Protocols Ospf

    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>...
  • Page 724: Timers Spf

    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>...
  • Page 725: Chapter 37. Bgp Configuration

    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...
  • Page 726: Introduction

    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.
  • Page 727: Enabling Bgp Between Different Autonomous Systems

    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.
  • Page 728: Route-Map

    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.
  • Page 730: Route Reflector

    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.
  • Page 732: Confederations

    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 735: Chapter 38. Bgp Commands

    Chapter 38: BGP Commands Introduction................................38.4 address-family................................38.4 aggregate-address ...............................38.5 bgp aggregate-nexthop-check ........................38.6 bgp always-compare-med..........................38.7 bgp bestpath as-path ignore .........................38.8 bgp bestpath compare-confed-aspath....................38.8 bgp bestpath compare-routerid .........................38.9 bgp bestpath med............................38.10 bgp client-to-client reflection ........................38.11 bgp cluster-id..............................38.12 bgp confederation identifier........................38.13 bgp confederation peers..........................
  • Page 736 BGP Commands ip community-list ..............................38.48 ip community-list expanded........................38.49 ip community-list standard..........................38.51 neighbor activate ..............................38.53 neighbor advertisement-interval ......................38.54 neighbor allowas-in............................38.55 neighbor as-origination-interval........................38.56 neighbor attribute-unchanged........................38.57 neighbor capability dynamic ........................38.58 neighbor capability graceful-restart ......................38.59 neighbor capability orf prefix-list ......................38.60 neighbor capability route-refresh ......................38.61 neighbor collide-established........................38.62 neighbor default-originate ...........................38.63 neighbor description............................38.64...
  • 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...
  • Page 738: Introduction

    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.
  • Page 740: Bgp Aggregate-Nexthop-Check

    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#...
  • Page 741: Bgp Always-Compare-Med

    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.
  • Page 742: Bgp Bestpath As-Path Ignore

    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...
  • Page 743: Bgp Bestpath Compare-Routerid

    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.
  • Page 744: Bgp Bestpath Med

    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.
  • Page 745: Bgp Client-To-Client Reflection

    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.
  • Page 746: Bgp Cluster-Id

    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.
  • Page 747: Bgp Confederation Identifier

    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.
  • Page 748: Bgp Confederation Peers

    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.
  • Page 749: Bgp Config-Type

    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.
  • Page 750: Bgp Dampening

    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.
  • Page 751: Bgp Default Ipv4-Unicast

    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.
  • Page 752: Bgp Default Local-Preference

    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.
  • Page 753: Bgp Deterministic-Med

    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.
  • Page 754: Bgp Enforce-First-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...
  • Page 755: Bgp Fast-External-Failover

    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...
  • Page 756: Bgp Graceful-Restart

    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...
  • Page 758: Bgp Log-Neighbor-Changes

    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,...
  • Page 759: Bgp Memory Maxallocation

    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.
  • Page 760: Bgp Multiple-Instance

    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#...
  • Page 761: Bgp Rfc1771-Strict

    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...
  • Page 762: Bgp Scan-Time

    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.
  • Page 763: Bgp Update-Delay

    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.
  • Page 764: Clear Bgp

    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.
  • Page 765: Clear Bgp (Ip Address)

    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>...
  • Page 766: Clear Bgp (Asn)

    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>...
  • Page 767: Clear Bgp External

    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.
  • Page 768: Clear Bgp Peer-Group

    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>...
  • Page 769: Clear Bgp View

    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.
  • Page 770: Clear Ip Bgp

    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...
  • Page 771: Clear Ip Bgp (Ip Address)

    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>...
  • Page 772: Clear Ip Bgp Dampening

    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>...
  • Page 773: Clear Ip Bgp Flap-Statistics

    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>...
  • Page 774: Clear Ip Bgp (Asn)

    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>...
  • Page 775: Clear Ip Bgp External

    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.
  • Page 776: Clear Ip Bgp Peer-Group

    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>...
  • Page 777: Clear Ip Bgp View

    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>...
  • Page 778: Debug Bgp

    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...
  • Page 779: Distance (Bgp)

    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)#...
  • Page 781: Ip As-Path Access-List

    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.
  • Page 782: Ip Community-List

    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.
  • Page 783: Ip Community-List Expanded

    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.
  • Page 785: Ip Community-List Standard

    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...
  • Page 787: Neighbor Activate

    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>...
  • Page 788: Neighbor Advertisement-Interval

    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>...
  • Page 789: Neighbor Allowas-In

    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>...
  • Page 790: Neighbor As-Origination-Interval

    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>...
  • Page 791: Neighbor Attribute-Unchanged

    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...
  • Page 792: Neighbor Capability Dynamic

    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>...
  • Page 793: Neighbor Capability Graceful-Restart

    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>...
  • Page 794: Neighbor Capability Orf Prefix-List

    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>...
  • Page 795: Neighbor Capability Route-Refresh

    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...
  • Page 796: Neighbor Collide-Established

    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’...
  • Page 797: Neighbor Default-Originate

    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...
  • Page 798: Neighbor 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.
  • Page 799: Neighbor Distribute-List

    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>...
  • Page 800: Neighbor Dont-Capability-Negotiate

    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.
  • Page 801: Neighbor Ebgp-Multihop

    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.
  • Page 802: Neighbor Enforce-Multihop

    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...
  • Page 803: Neighbor Filter-List

    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>...
  • Page 804: Neighbor Interface

    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>...
  • Page 805: Neighbor Maximum-Prefix

    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>...
  • Page 806: Neighbor Next-Hop-Self

    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>...
  • Page 807: Neighbor Override-Capability

    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>...
  • Page 808: Neighbor Passive

    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>...
  • Page 809: Neighbor Peer-Group (Adding A Neighbor)

    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>...
  • Page 810: Neighbor Peer-Group (Creating A Peer-Group)

    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.
  • Page 811: Neighbor Port

    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>...
  • Page 812: Neighbor Prefix-List

    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>...
  • Page 813: Neighbor Remote-As

    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>...
  • Page 814: Neighbor Remove-Private-As

    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-...
  • Page 815: Neighbor Restart-Time

    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>...
  • Page 816: Neighbor Route-Map

    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>...
  • Page 817: Neighbor Route-Reflector-Client

    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>...
  • Page 818: Neighbor Route-Server-Client

    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>...
  • Page 819: Neighbor Send-Community

    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.
  • Page 820: Neighbor Shutdown

    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>...
  • Page 821: Neighbor Soft-Reconfiguration Inbound

    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.
  • Page 822: Neighbor Strict-Capability-Match

    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>...
  • Page 823: Neighbor Timers

    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>...
  • Page 824: Neighbor Transparent-As

    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>...
  • Page 825: Neighbor Transparent-Nexthop

    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>...
  • Page 826: Neighbor Unsuppress-Map

    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>...
  • Page 827: Neighbor Update-Source

    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.
  • Page 828: Neighbor Version

    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>...
  • Page 829: Neighbor Weight

    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.
  • Page 831: Network Synchronization

    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...
  • Page 832: Redistribute Route-Map

    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.
  • Page 833: Restart Bgp Graceful

    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.
  • Page 834: Router Bgp

    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...
  • Page 835: Router Bgp View

    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>...
  • Page 836: Show Bgp Memory Maxallocation

    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...
  • Page 837: Show Ip Bgp

    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.
  • Page 838: Show Ip Bgp Attribute-Info

    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...
  • Page 839: Show Ip Bgp Cidr-Only

    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.
  • Page 840: Show Ip Bgp Community

    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>...
  • Page 841: Show Ip Bgp Community-List

    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...
  • Page 843: Show Ip Bgp Filter-List

    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.
  • Page 844: Show Ip Bgp Longer-Prefixes

    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>...
  • Page 845: Show Ip Bgp Neighbors

    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.
  • Page 846: Show Ip Bgp Paths

    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:...
  • Page 847: Show Ip Bgp Prefix-List

    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.
  • Page 848: Show Ip Bgp Regexp

    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>...
  • Page 849: Show Ip Bgp Route-Map

    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.
  • Page 850: Show Ip Bgp Scan

    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...
  • Page 851: Show Ip Bgp Summary

    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.
  • Page 852: Show Ip Bgp View

    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...
  • Page 854: Show Ip Bgp View Summary

    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>...
  • Page 855: Show Ip Community-List

    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>...
  • Page 858: Undebug Bgp

    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).
  • Page 859: Chapter 39. Route Map Commands

    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 ................................
  • Page 860: Introduction

    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...
  • Page 862: Match Community

    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.
  • Page 863: Match Interface

    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.
  • Page 864: Match Ip Address

    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#...
  • Page 866: Match Ip Next-Hop

    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)
  • Page 868: Match Ipv6 Address

    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...
  • Page 869: Match Ipv6 Next-Hop

    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...
  • Page 870: Match Metric

    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.
  • Page 871: Match Origin

    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®...
  • Page 873: Match Route-Type

    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.
  • Page 874: Match Tag

    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:...
  • Page 877: Set Aggregator

    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.
  • Page 878: Set As-Path

    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.
  • Page 879: Set Atomic-Aggregate

    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.
  • Page 880: Set Comm-List Delete

    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.
  • Page 881: Set Community

    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...
  • Page 883: Set Dampening

    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.
  • Page 885: Set Extcommunity

    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®...
  • Page 887: Set Ip Next-Hop

    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.
  • Page 888: Set Ipv6 Next-Hop

    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>...
  • Page 889: Set Local-Preference

    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.
  • Page 890: Set Metric

    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 ■...
  • Page 891: Set Metric-Type

    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]...
  • Page 892: Set Origin

    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]...
  • Page 893: Set Originator-Id

    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.
  • Page 894: Set Tag

    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.
  • Page 895: Set Weight

    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...
  • Page 897: Part 4 Multicast Applications

    Part 4: Multicast Applications Chapter 40 IGMP Snooping Configuration ■ Chapter 41 IGMP Multicast Commands ■ Chapter 42 Common Multicast Commands ■ Chapter 43 PIM-SM Configuration ■ Chapter 44 PIM-SM Commands ■ Chapter 45 PIM-DM Configuration ■ Chapter 46 PIM-DM Commands ■...
  • Page 899: Chapter 40. Igmp Snooping Configuration

    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...
  • Page 900: Introduction

    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.
  • Page 901: Configuring Switch 1

    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...
  • Page 903: Chapter 41. Igmp Multicast Commands

    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...........................
  • Page 904: Introduction

    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.
  • Page 905: Clear Ip Igmp Group

    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.
  • Page 906: Clear Ip Igmp Interface

    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>...
  • Page 907: Debug Igmp

    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}...
  • Page 908: Ip Igmp

    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...
  • Page 909: Ip Igmp Immediate-Leave

    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...
  • Page 910: Ip Igmp Last-Member-Query-Count

    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...
  • Page 912: Ip Igmp Limit

    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.
  • Page 913: Ip Igmp Mroute-Proxy

    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.
  • Page 914: Ip Igmp Proxy-Service

    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.
  • Page 915: Ip Igmp Querier-Timeout

    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>...
  • Page 916: Ip Igmp Query-Interval

    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>...
  • Page 917: Ip Igmp Query-Max-Response-Time

    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>...
  • Page 918: Ip Igmp Ra-Option (Router Alert)

    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...
  • Page 919: Ip Igmp Snooping

    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.
  • Page 920: Ip Igmp Snooping Mrouter

    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.
  • Page 921: Ip Igmp Snooping Querier

    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.
  • Page 922: Ip Igmp Snooping Report-Suppression

    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.
  • Page 923: Ip Igmp Snooping Routermode

    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.
  • Page 924: Ip Igmp Ssm-Map Enable

    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.
  • Page 925: Ip Igmp Ssm-Map Static

    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.
  • Page 926: Ip Igmp Static-Group

    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>...
  • Page 927: Ip Igmp Version

    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...
  • Page 928: Show Debugging Igmp

    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...
  • Page 929: Show Ip Igmp Groups

    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>...
  • Page 930: Show Ip Igmp Interface

    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...
  • Page 931: Show Ip Igmp Snooping Mrouter

    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>...
  • Page 932: Show Ip Igmp Snooping Routermode

    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...
  • Page 933: Show Ip Igmp Snooping Statistics

    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...
  • Page 935: Chapter 42. Common Multicast Commands

    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®...
  • Page 936: Introduction

    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>...
  • Page 937: Debug Nsm Mcast

    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.
  • Page 938: Ip Mroute

    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.
  • Page 939: Ip Multicast Route-Limit

    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>...
  • Page 940: Ip Multicast-Routing

    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.
  • Page 942: Show Ip Mroute

    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...
  • Page 944: Show Ip Mvif

    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...
  • Page 945: Chapter 43. Pim-Sm Configuration

    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...
  • Page 946: Introduction

    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...
  • Page 951: Chapter 44. Pim-Sm Commands

    Chapter 44: PIM-SM Commands Introduction................................44.2 clear ip pim sparse-mode bsr rp-set *....................44.2 debug pim sparse-mode ..........................44.3 debug pim sparse-mode timer bsr......................44.4 debug pim sparse-mode timer hello......................44.4 debug pim sparse-mode timer joinprune .....................44.5 debug pim sparse-mode timer register....................44.5 ip pim accept-register list..........................44.6 ip pim anycast-rp..............................44.7 ip pim bsr-border..............................44.8 ip pim bsr-candidate............................44.9...
  • Page 952: Introduction

    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).
  • Page 953: Debug Pim Sparse-Mode

    PIM-SM Commands debug pim sparse-mode Use this command to activate/de-activate all PIM-SM debugging. Syntax debug pim sparse-mode [all] [events] [mfc] [mib] [nexthop] [nsm] [packet] [state] [mtrace] no debug pim sparse-mode [all] [events] [mfc] [mib] [nexthop] [nsm] [packet] [state] [mtrace] Parameter Description activates/deactivates all PIM-SM debugging activates debug printing of events...
  • Page 954: Debug Pim Sparse-Mode Timer 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.
  • Page 955: Debug Pim Sparse-Mode Timer Joinprune

    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...
  • Page 956: Ip Pim Accept-Register List

    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.
  • Page 957: Ip Pim Anycast-Rp

    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>...
  • Page 958: Ip Pim Bsr-Border

    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.
  • Page 959: Ip Pim Bsr-Candidate

    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.
  • Page 960: Ip Pim Cisco-Register-Checksum Group-List

    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.
  • Page 961: Ip Pim Dr-Priority

    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.
  • Page 964: Ip Pim Jp-Timer

    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.
  • Page 965: Ip Pim Register-Rate-Limit

    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>...
  • Page 966: Ip Pim Register-Source

    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.
  • Page 967: Ip Pim Register-Suppression

    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.
  • Page 968: Ip Pim Rp-Address

    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...
  • Page 970: Ip Pim Rp-Candidate

    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.
  • Page 971: Ip Pim Rp-Register-Kat

    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.
  • Page 972: Ip Pim Sparse-Mode Passive

    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.
  • Page 973: Ip Pim Spt-Threshold Group-List

    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.
  • Page 974: Ip Pim Ssm

    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.
  • Page 975: Show Debugging Pim Sparse-Mode

    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...
  • Page 976: Show Ip Pim Sparse-Mode Interface

    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/...
  • Page 977: Show Ip Pim Sparse-Mode Mroute

    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.
  • Page 978: Show Ip Pim Sparse-Mode Mroute Detail

    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,...
  • Page 980: Show Ip Pim Sparse-Mode Neighbor

    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>...
  • Page 981: Show Ip Pim Sparse-Mode Nexthop

    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...
  • Page 982: Show Ip Pim Sparse-Mode Rp-Hash

    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>...
  • Page 983: Undebug All Pim Sparse-Mode

    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...
  • Page 985: Chapter 45. Pim-Dm Configuration

    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.
  • Page 987: Pim-Dm Terminology

    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.
  • Page 988: Pim-Dm Configuration

    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...
  • Page 992: Verifying Configuration

    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.
  • Page 993: Chapter 46. Pim-Dm Commands

    Chapter 46: PIM-DM Commands Introduction................................46.2 debug pim dense-mode all..........................46.2 debug pim dense-mode context .......................46.3 debug pim dense-mode decode........................46.3 debug pim dense-mode encode........................46.4 debug pim dense-mode fsm.........................46.4 debug pim dense-mode mrt ........................46.5 debug pim dense-mode nexthop......................46.5 debug pim dense-mode nsm ........................46.6 debug pim dense-mode vif..........................46.7 ip pim dense-mode............................46.8 ip pim dense-mode passive...........................46.8...
  • Page 994: Introduction

    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...
  • Page 995: Debug Pim Dense-Mode Context

    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.
  • Page 996: Debug Pim Dense-Mode Encode

    PIM-DM Commands debug pim dense-mode encode debug pim dense-mode encodeCommand vs_531 %flag PIM-DM Commands Enables or disables debugging of the PIM-DM message encoder. Enables or disables debugging of the PIM-DM message encoder. Syntax debug pim dense-mode encode no debug pim dense-mode encode Global Configuration mode and Privileged Exec mode Mode...
  • Page 997: Debug Pim Dense-Mode Mrt

    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).
  • Page 998: Debug Pim Dense-Mode Nsm

    PIM-DM Commands debug pim dense-mode nsm debug pim dense-mode nsm Command vs_531 %flag PIM-DM Commands Enables or disables debugging of PIM-DM interface with NSM. Enables or disables debugging of PIM-DM interface with NSM. Syntax debug pim dense-mode nsm no debug pim dense-mode nsm Global Configuration mode and Privileged Exec mode Mode...
  • Page 999: Debug Pim Dense-Mode Vif

    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#...
  • Page 1000: Ip Pim Dense-Mode

    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.
  • Page 1004: Ip Pim Propagation-Delay

    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.

Table of Contents