Summary of Contents for Allied Telesis SBx908 GEN2
Page 1
® SwitchBlade x908 Generation 2 HIGH CAPACITY STACKABLE LAYER 3+ MODULAR SWITCH SBx908 GEN2 Command Reference for AlliedWare Plus™ Version 5.4.7B-1.x C613-50188-01 Rev B...
Page 2
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 check for US$15 to cover production and shipping costs and a CD with the GPL code will be mailed to you.
Part 1: Setup and Troubleshooting C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
CLI Navigation Commands Introduction Overview This chapter provides an alphabetical 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. Command List •...
CLI N AVIGATION OMMANDS CONFIGURE TERMINAL configure terminal Overview This command enters the Global Configuration command mode. configure terminal Syntax Mode Privileged Exec Example To enter the Global Configuration command mode (note the change in the command prompt), enter the command: awplus# configure terminal awplus(config)#...
CLI N AVIGATION OMMANDS DISABLE RIVILEGED XEC MODE disable (Privileged Exec mode) Overview This command exits the Privileged Exec mode, returning the prompt to the User Exec mode. To end a session, use the exit command. disable Syntax Mode Privileged Exec Example To exit the Privileged Exec mode, enter the command: awplus#...
Page 106
CLI N AVIGATION OMMANDS Overview This command lets you to run User Exec and Privileged Exec mode commands when you are in any configuration mode. do <command> Syntax Parameter Description <command> Specify the command and its parameters. Mode Any configuration mode awplus# configure terminal Example...
CLI N AVIGATION OMMANDS ENABLE RIVILEGED XEC MODE enable (Privileged Exec mode) Overview This command enters the Privileged Exec mode and optionally changes the privilege level for a session. If a privilege level is not specified then the maximum privilege level (15) is applied to the session. If the optional privilege level is omitted then only users with the maximum privilege level can access Privileged Exec mode without providing the password as specified by the enable password...
Page 108
CLI N AVIGATION OMMANDS ENABLE RIVILEGED XEC MODE Privilege Exec mode. Use the enable password command or the enable secret commands to set the password to enable access to Privileged Exec mode. awplus> enable 7 awplus# Related disable (Privileged Exec mode) Commands enable password enable secret...
Page 109
CLI N AVIGATION OMMANDS Overview This command returns the prompt to the Privileged Exec command mode from any other advanced command mode. Syntax Mode All advanced command modes, including Global Configuration and Interface Configuration modes. Example The following example shows the use of the end command to return to the Privileged Exec mode directly from Interface mode.
CLI N AVIGATION OMMANDS EXIT exit Overview This command exits the current mode, and returns the prompt to the mode at the previous level. When used in User Exec mode, the exit command terminates the session. exit Syntax Mode All command modes, including Global Configuration and Interface Configuration modes.
CLI N AVIGATION OMMANDS HELP help Overview This command displays a description of the AlliedWare Plus™ OS help system. help Syntax Mode All command modes Example To display a description on how to use the system help, use the command: awplus# help Output...
CLI N AVIGATION OMMANDS LOGOUT logout Overview This command exits the User Exec or Privileged Exec modes and ends the session. logout Syntax Mode User Exec and Privileged Exec Example To exit the User Exec mode, use the command: awplus# logout C613-50188-01 Rev B Command Reference for SwitchBlade®...
CLI N AVIGATION OMMANDS SHOW HISTORY show history Overview This command lists the commands entered in the current session. The history buffer is cleared automatically upon reboot. The output lists all command line entries, including commands that returned an error. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
File and Configuration Management Commands Introduction Overview This chapter provides an alphabetical reference of AlliedWare Plus™ OS file and configuration management commands. Filename Syntax Many of the commands in this chapter use the placeholder “filename” to represent and Keyword the name and location of the file that you want to act on. The following table Usage explains the syntax of the filename for each different type of file location.
Page 115
ILE AND ONFIGURATION ANAGEMENT OMMANDS Valid characters The filename and path can include characters from up to four categories. The categories are: uppercase letters: A to Z lowercase letters: a to z digits: 0 to 9 special symbols: most printable ASCII characters not included in the previous three categories, including the following characters: •...
Page 116
ILE AND ONFIGURATION ANAGEMENT OMMANDS • “boot system backup” on page 122 • “cd” on page 123 • “copy (filename)” on page 124 • “copy current-software” on page 126 • “copy debug” on page 127 • “copy running-config” on page 128 •...
ILE AND ONFIGURATION ANAGEMENT OMMANDS AUTOBOOT ENABLE autoboot enable Overview This command enables the device to restore a release file and/or a configuration file from a USB storage device. When the Autoboot feature is enabled, the device looks for a special file called autoboot.txt on the external media.
ILE AND ONFIGURATION ANAGEMENT OMMANDS BOOT CONFIG FILE boot config-file Overview Use this command to set the configuration file to use during the next boot cycle. Use the no variant of this command to remove the configuration file. Syntax boot config-file <filepath-filename> no boot config-file Parameter Description...
Page 119
ILE AND ONFIGURATION ANAGEMENT OMMANDS BOOT CONFIG FILE To stop running the configuration file “branch.cfg” when the device boots up, when “branch.cfg” is stored on a USB storage device, use the commands: awplus# configure terminal awplus(config)# no boot config-file usb:/branch.cfg Related boot config-file backup Commands...
ILE AND ONFIGURATION ANAGEMENT OMMANDS BOOT CONFIG FILE BACKUP boot config-file backup Overview Use this command to set a backup configuration file to use if the main configuration file cannot be accessed. Use the no variant of this command to remove the backup configuration file. Syntax boot config-file backup <filepath-filename>...
ILE AND ONFIGURATION ANAGEMENT OMMANDS BOOT SYSTEM boot system Overview Use this command to set the release file to load during the next boot cycle. Use the no variant of this command to stop specifying a primary release file to boot from.
ILE AND ONFIGURATION ANAGEMENT OMMANDS BOOT SYSTEM BACKUP boot system backup Overview Use this command to set a backup release file to load if the main release file cannot be loaded. Use the no variant of this command to stop specifying a backup release file. Syntax boot system backup <filepath-filename>...
Page 123
ILE AND ONFIGURATION ANAGEMENT OMMANDS Overview This command changes the current working directory. cd <directory-name> Syntax Parameter Description <directory-name> Name and path of the directory. Mode Privileged Exec To change to the directory called images, use the command: Example awplus# cd images Related Commands...
ILE AND ONFIGURATION ANAGEMENT OMMANDS COPY FILENAME copy (filename) Overview 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 a USB storage device •...
Page 125
ILE AND ONFIGURATION ANAGEMENT OMMANDS COPY FILENAME To copy the file “config.cfg” into the current directory from a USB storage device, and rename it to “configtest.cfg”, use the command: awplus# copy usb:/config.cfg configtest.cfg To copy the file “config.cfg” into the current directory from a remote file server, and rename it to “configtest.cfg”, use the command: awplus# copy fserver:/config.cfg configtest.cfg...
ILE AND ONFIGURATION ANAGEMENT OMMANDS COPY CURRENT SOFTWARE copy current-software Overview 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 filesystem. copy current-software <destination-name>...
ILE AND ONFIGURATION ANAGEMENT OMMANDS COPY DEBUG copy debug Overview This command copies a specified debug file to a destination file. copy debug {<destination-name>|debug|flash|nvs|scp|tftp|usb} Syntax {<source-name>|debug|flash|nvs|scp|tftp|usb} Parameter Description <destination-name> The filename and path where you would like the debug output saved. See Introduction on page 114 for valid syntax.
ILE AND ONFIGURATION ANAGEMENT OMMANDS COPY RUNNING CONFIG copy running-config Overview 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. copy <source-name>...
ILE AND ONFIGURATION ANAGEMENT OMMANDS COPY STARTUP CONFIG copy startup-config Overview 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 filesystem.
ILE AND ONFIGURATION ANAGEMENT OMMANDS COPY ZMODEM copy zmodem Overview 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. copy <source-name> zmodem Syntax copy zmodem Parameter...
ILE AND ONFIGURATION ANAGEMENT OMMANDS CREATE AUTOBOOT create autoboot Overview Use this command to create an autoboot.txt file on an external storage device. This command will automatically ensure that the keys and values that are expected in this file are correct. After the file is created the create autoboot command will copy the current release and configuration files across to the external storage device.
ILE AND ONFIGURATION ANAGEMENT OMMANDS DELETE delete Overview This command deletes files or directories. delete [force] [recursive] <filename> Syntax Parameter Description force Ignore nonexistent filenames and never prompt before deletion. recursive Remove the contents of directories recursively. <filename> The filename and path of the file to delete. See Introduction on page 114 for valid syntax.
ILE AND ONFIGURATION ANAGEMENT OMMANDS DELETE DEBUG delete debug Overview Use this command to delete a specified debug output file. delete debug <source-name> Syntax Parameter Description <source-name> The filename and path where the debug output originates. Introduction on page 114 for valid URL syntax. Mode Privileged Exec Example...
Page 134
ILE AND ONFIGURATION ANAGEMENT OMMANDS Overview 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. dir [all] [recursive] [sort [reverse] [name|size|time] Syntax [<filename>|debug|flash|nvs|usb] Parameter Description List all files.
Page 135
ILE AND ONFIGURATION ANAGEMENT OMMANDS To list the files by size, smallest to largest, use the command: awplus# dir sort reverse size To sort the files by modification time, oldest to newest, use the command: awplus# dir sort reverse time Output Figure 2-4: Example output from the dir command...
ILE AND ONFIGURATION ANAGEMENT OMMANDS EDIT edit Overview 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.
ILE AND ONFIGURATION ANAGEMENT OMMANDS EDIT FILENAME edit (filename) Overview 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.
ILE AND ONFIGURATION ANAGEMENT OMMANDS ERASE FACTORY DEFAULT erase factory-default Overview This command erases all data from NVS and all data from Flash excluding the following: • the current release file • the backup release file • license files The device is then rebooted and returned to its factory default condition. The device can then be used for AMF automatic node recovery.
ILE AND ONFIGURATION ANAGEMENT OMMANDS ERASE STARTUP CONFIG erase startup-config Overview This command deletes the file that is set as the startup-config file, which is the configuration file that the system runs when it boots up. At the next restart, the device loads the default configuration file, default.cfg. If default.cfg no longer exists, then the device loads with the factory default configuration.
ILE AND ONFIGURATION ANAGEMENT OMMANDS IP TFTP SOURCE INTERFACE ip tftp source-interface Overview Use this command to manually specify the IP address that all TFTP requests originate from. This is useful in network configurations where TFTP servers only accept requests from certain devices, or where the server cannot dynamically determine the source of the request.
ILE AND ONFIGURATION ANAGEMENT OMMANDS TFTP SOURCE INTERFACE ipv6 tftp source-interface Overview Use this command to manually specify the IPv6 address that all TFTP requests originate from. This is useful in network configurations where TFTP servers only accept requests from certain devices, or where the server cannot dynamically determine the source of the request.
ILE AND ONFIGURATION ANAGEMENT OMMANDS MKDIR mkdir Overview This command makes a new directory. mkdir <name> Syntax Parameter Description <name> The name and path of the directory that you are creating. Mode Privileged Exec Usage You cannot name a directory or subdirectory flash, nvs, usb, card, tftp, scp, sftp or http.
ILE AND ONFIGURATION ANAGEMENT OMMANDS MOVE move Overview This command renames or moves a file. move <source-name> <destination-name> Syntax Parameter Description <source-name> The filename and path of the source file. See Introduction on page 114 for valid syntax. <destination-name> The filename and path of the destination file. See Introduction on page 114 for valid syntax.
ILE AND ONFIGURATION ANAGEMENT OMMANDS MOVE DEBUG move debug Overview This command moves a specified debug file to a destination debug file. move debug {<destination-name>|debug|nvs|flash|usb} Syntax Parameter Description <destination-name> The filename and path where you would like the debug output moved to. See Introduction on page 114 for valid syntax.
Page 145
ILE AND ONFIGURATION ANAGEMENT OMMANDS Overview This command prints the current working directory. Syntax Mode Privileged Exec Example To print the current working directory, use the command: awplus# Related Commands C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™...
ILE AND ONFIGURATION ANAGEMENT OMMANDS RMDIR rmdir Overview This command removes a directory. This command only works on empty directories, unless you specify the optional force keyword. rmdir [force] <name> Syntax Parameter Description force Optional keyword that allows you to delete directories that are not empty and contain files or subdirectories.
ILE AND ONFIGURATION ANAGEMENT OMMANDS SHOW AUTOBOOT show autoboot Overview This command displays the Autoboot configuration and status. show autoboot Syntax Mode Privileged Exec Example To show the Autoboot configuration and status, use the command: awplus# show autoboot Output Figure 2-6: Example output from the show autoboot command awplus#show autoboot...
ILE AND ONFIGURATION ANAGEMENT OMMANDS SHOW BOOT show boot Overview This command displays the current boot configuration. We recommend that the currently running release is set as the current boot image. show boot Syntax Mode Privileged Exec Example To show the current boot configuration, use the command: awplus# show boot Output...
Page 149
ILE AND ONFIGURATION ANAGEMENT OMMANDS SHOW BOOT Table 2-1: Parameters in the output from show boot (cont.) Parameter Description Backup boot config The configuration file to use during the next boot cycle if the main configuration file cannot be loaded. Autoboot status The status of the Autoboot feature;...
ILE AND ONFIGURATION ANAGEMENT OMMANDS SHOW FILE show file Overview This command displays the contents of a specified file. show file <filename> Syntax Parameter Description <filename> Name of a file on the local Flash filesystem, or name and directory path of a file. Mode Privileged Exec To display the contents of the file oldconfig.cfg, which is in the current...
ILE AND ONFIGURATION ANAGEMENT OMMANDS SHOW FILE SYSTEMS show file systems Overview This command lists the filesystems and their utilization information where appropriate. show file systems Syntax Mode Privileged Exec Examples To display the filesystems, use the command: awplus# show file systems Output Figure 2-9: Example output from the show file systems command...
Page 152
ILE AND ONFIGURATION ANAGEMENT OMMANDS SHOW FILE SYSTEMS Table 3: Parameters in the output of the show file systems command (cont.) Parameter Description Flags The file setting options: rw (read write), ro (read only). Prefixes The prefixes used when entering commands to access the filesystems;...
Antivirus configuration application Application configuration as-path Autonomous system path filter configuration as-path access-list Configuration of ACLs for AS path filtering atmf Allied Telesis Management Framework configuration Border Gateway Protocol (BGP) configuration community-list Community-list configuration crypto Security-specific configuration dhcp DHCP configuration...
Page 154
ILE AND ONFIGURATION ANAGEMENT OMMANDS SHOW RUNNING CONFIG Parameter Description Internet Protocol (IP) configuration ip pim dense-mode PIM-DM configuration ip pim sparse-mode PIM-SM configuration ip route IP static route configuration ip-reputation IP Reputation configuration IPS configuration ipsec Internet Protocol Security (IPSec) configuration ipv6 Internet Protocol version 6 (IPv6)
Page 155
ILE AND ONFIGURATION ANAGEMENT OMMANDS SHOW RUNNING CONFIG Parameter Description switch Switch configuration web-control Web Control configuration Mode Privileged Exec and Global Configuration Example To display the current configuration of your device, use the command: awplus# show running-config Output Figure 2-10: Example output from show running-config ...
ILE AND ONFIGURATION ANAGEMENT OMMANDS SHOW RUNNING CONFIG INTERFACE show running-config interface Overview This command displays the current configuration of one or more interfaces on the device. show running-config interface [<interface-list>] [dot1x|ip Syntax igmp|ip multicast|ip pim dense-mode|ip pim sparse-mode|ipv6 rip|lacp|mstp|ospf|rip|rstp|stp] Parameter Description <interface-list>...
Page 157
ILE AND ONFIGURATION ANAGEMENT OMMANDS SHOW RUNNING CONFIG INTERFACE Parameter Description rstp Displays running configuration for RSTP (Rapid Spanning Tree Protocol) for the specified interfaces. Displays running configuration for STP (Spanning Tree Protocol) for the specified interfaces. Mode Privileged Exec and Global Configuration Default Displays information for all protocols on all interfaces Examples...
ILE AND ONFIGURATION ANAGEMENT OMMANDS SHOW STARTUP CONFIG show startup-config Overview 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 filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
ILE AND ONFIGURATION ANAGEMENT OMMANDS SHOW VERSION show version Overview This command displays the version number and copyright details of the current AlliedWare Plus™ OS your device is running. show version Syntax Mode User Exec and Privileged Exec Example To display the version details of your currently installed software, use the command: awplus# show version...
Page 160
ILE AND ONFIGURATION ANAGEMENT OMMANDS SHOW VERSION Corosync Cluster Engine Copyright (c) 2002-2004 MontaVista Software, Inc. All rights reserved. Copyright (c) 2005-2010 Red Hat, Inc. File Utility Library Copyright (c) Ian F. Darwin 1986-1987, 1989-1992, 1994-1995. Software written by Ian F.
ILE AND ONFIGURATION ANAGEMENT OMMANDS UNMOUNT unmount Overview Use this command to unmount an external storage device. We recommend you unmount storage devices before removing them, to avoid file corruption. This is especially important if files may be automatically written to the storage device, such as external log files or AMF backup files.
ILE AND ONFIGURATION ANAGEMENT OMMANDS WRITE FILE write file Overview 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. write [file] Syntax Mode...
ILE AND ONFIGURATION ANAGEMENT OMMANDS WRITE MEMORY write memory Overview 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 file and copy running-config startup-config commands. write [memory] Syntax Mode...
ILE AND ONFIGURATION ANAGEMENT OMMANDS WRITE TERMINAL write terminal Overview This command displays the current configuration of the device. This command is a synonym of the show running-config command. write terminal Syntax Mode Privileged Exec Example To display the current configuration of your device, use the command: awplus# write terminal Related...
User Access Commands Introduction Overview This chapter provides an alphabetical reference of commands used to configure user access. Command List • “clear line console” on page 167 • “clear line vty” on page 168 • “enable password” on page 169 •...
Page 166
CCESS OMMANDS • “service terminal-length (deleted)” on page 194 • “show privilege” on page 195 • “show security-password configuration” on page 196 • “show security-password user” on page 197 • “show telnet” on page 198 • “show users” on page 199 •...
CCESS OMMANDS CLEAR LINE CONSOLE clear line console Overview This command resets a console line. If a terminal session exists on the line then the terminal session is terminated. If console line settings have changed then the new settings are applied. clear line console 0 Syntax Mode...
CCESS OMMANDS CLEAR LINE VTY clear line vty Overview This command resets a VTY line. If a session exists on the line then it is closed. clear line vty <0-32> Syntax Parameter Description <0-32> Line number Mode Privileged Exec Example To reset the first VTY line, use the command: awplus# clear line vty 1...
CCESS OMMANDS ENABLE PASSWORD enable password Overview 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.
Page 170
CCESS OMMANDS ENABLE PASSWORD the commands in User Exec mode, but not any configuration commands in Privileged Exec mode. Note that the enable password command is an alias for the enable secret command and one password per privilege level is allowed using these commands. Do not assign one password to a privilege level with enable password and another...
Page 171
CCESS OMMANDS ENABLE PASSWORD password. It is not required to use the service password-encryption command for this method. The output in the configuration file will show only the encrypted string, and not the text string. awplus# configure terminal awplus(config)# enable password 8 fU7zHzuutY2SA awplus(config)# This results in the following show output: awplus#show run...
CCESS OMMANDS ENABLE SECRET enable secret Overview To set a local password to control access to various privilege levels, use the enable secret Global Configuration command. Use the enable secret command to modify or create a password to be used, and use the no enable secret command to remove the password.
Page 173
CCESS OMMANDS ENABLE SECRET the commands in User Exec mode, but not any configuration commands in Privileged Exec mode. Note that the enable secret command is an alias for the enable password command and one password per privilege level is allowed using these commands. Do not assign one password to a privilege level with enable password and another...
Page 174
CCESS OMMANDS ENABLE SECRET is not required to use the service password-encryption command for this method. The output in the configuration file will show only the encrypted string, and not the text string: awplus# configure terminal awplus(config)# enable secret 8 fU7zHzuutY2SA awplus(config)# This results in the following show output: awplus#show run...
CCESS OMMANDS EXEC TIMEOUT exec-timeout Overview 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.
Page 176
CCESS OMMANDS EXEC TIMEOUT Related line Commands service telnet C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
CCESS OMMANDS FLOWCONTROL HARDWARE ASYN CONSOLE flowcontrol hardware (asyn/console) Overview Use this command to enable RTS/CTS (Ready To Send/Clear To Send) hardware flow control on a terminal console line (asyn port) between the DTE (Data Terminal Equipment) and the DCE (Data Communications Equipment). flowcontrol hardware Syntax no flowcontrol hardware...
Page 178
CCESS OMMANDS FLOWCONTROL HARDWARE ASYN CONSOLE Examples To enable hardware flow control on terminal console line asyn0, use the commands: awplus# configure terminal awplus(config)# line console 0 awplus(config-line)# flowcontrol hardware To disable hardware flow control on terminal console line asyn0, use the commands: awplus# configure terminal...
CCESS OMMANDS LENGTH ASYN length (asyn) Overview 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. The no variant of this command restores the length of a line (terminal session) attached to a console port or to a VTY to its default length of 22 rows.
CCESS OMMANDS LINE line Overview Use this command to enter line configuration mode for the specified VTYs or the console. The command prompt changes to show that the device is in Line Configuration mode. line vty <first-line> [<last-line>] Syntax line console 0 Parameter Description <first-line>...
Page 181
CCESS OMMANDS LINE To enter Line Configuration mode to configure the console (asyn 0) port terminal line, use the commands: awplus# configure terminal awplus(config)# line console 0 awplus(config-line)# Related accounting login Commands clear line console clear line vty flowcontrol hardware (asyn/console) length (asyn) login authentication privilege level...
CCESS OMMANDS PRIVILEGE LEVEL privilege level Overview This command sets a privilege level for VTY or console connections. The configured privilege level from this command overrides a specific user’s initial privilege level at the console login. privilege level <1-15> Syntax Mode Line Configuration Usage...
CCESS OMMANDS SECURITY PASSWORD HISTORY security-password history Overview This command specifies the number of previous passwords that are unable to be reused. A new password is invalid if it matches a password retained in the password history. The no variant of the command disables this feature. Syntax security-password history <0-15>...
CCESS OMMANDS SECURITY PASSWORD FORCED CHANGE security-password forced-change Overview This command specifies whether or not a user is forced to change an expired password at the next login. If this feature is enabled, users whose passwords have expired are forced to change to a password that must comply with the current password security rules at the next login.
CCESS OMMANDS SECURITY PASSWORD LIFETIME security-password lifetime Overview This command enables password expiry by specifying a password lifetime in days. Note that when the password lifetime feature is disabled, it also disables the security-password forced-change command and the security-password warning command.
CCESS OMMANDS SECURITY PASSWORD MIN LIFETIME ENFORCE security-password min-lifetime-enforce Overview Use this command to configure a minimum number of days before a password can be changed by a user. With this feature enabled, once a user sets the password, the user cannot change it again until the minimum lifetime has passed.
CCESS OMMANDS SECURITY PASSWORD MINIMUM CATEGORIES security-password minimum-categories Overview This command specifies the minimum number of categories that the password must contain in order to be considered valid. The password categories are: • uppercase letters: A to Z • lowercase letters: a to z •...
CCESS OMMANDS SECURITY PASSWORD MINIMUM LENGTH security-password minimum-length Overview This command specifies the minimum allowable password length. This value is checked against when there is a password change or a user account is created. security-password minimum-length <1-23> Syntax Parameter Description <1-23>...
CCESS OMMANDS SECURITY PASSWORD REJECT EXPIRED security-password reject-expired-pwd Overview This command specifies whether or not a user is allowed to login with an expired password. Users with expired passwords are rejected at login if this functionality is enabled. Users then have to contact the Network Administrator to change their password.
CCESS OMMANDS SECURITY PASSWORD WARNING security-password warning Overview This command specifies the number of days before the password expires that the user will receive a warning message specifying the remaining lifetime of the password. Note that the warning period cannot be set unless the lifetime feature is enabled with the security-password lifetime command.
CCESS OMMANDS SERVICE ADVANCED service advanced-vty Overview This command enables the advanced-vty help feature. This allows you to use TAB completion for commands. Where multiple options are possible, the help feature displays the possible options. The no service advanced-vty command disables the advanced-vty help feature. Syntax service advanced-vty no service advanced-vty...
CCESS OMMANDS SERVICE PASSWORD ENCRYPTION service password-encryption Overview 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 service password-encryption command to stop the device from displaying newly-entered passwords in encrypted form.
CCESS OMMANDS SERVICE TELNET service telnet Overview Use this command to enable the telnet server. The server is enabled by default. Enabling the telnet server starts the device 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.
CCESS OMMANDS SERVICE TERMINAL LENGTH DELETED service terminal-length (deleted) Overview This command has been deleted in Software Version 5.4.5-0.1 and later. C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
CCESS OMMANDS SHOW PRIVILEGE show privilege Overview This command displays the current user privilege level, which can be any privilege level in the range <1-15>. Privilege levels <1-6> allow limited user access (all User Exec commands), privilege levels <7-14> allow restricted user access (all User Exec commands plus Privileged Exec show commands).
CCESS OMMANDS SHOW SECURITY PASSWORD CONFIGURATION show security-password configuration Overview This command displays the configuration settings for the various security password rules. show security-password configuration Syntax Mode Privileged Exec Example To display the current security-password rule configuration settings, use the command: awplus# show security-password configuration...
CCESS OMMANDS SHOW SECURITY PASSWORD USER show security-password user Overview This command displays user account and password information for all users. show security-password user Syntax Mode Privileged Exec Example To display the system users’ remaining lifetime or last password change, use the command: awplus# show security-password user...
CCESS OMMANDS SHOW TELNET show telnet Overview This command shows the Telnet server settings. show telnet Syntax Mode User Exec and Privileged Exec Example To show the Telnet server settings, use the command: awplus# show telnet Output Figure 3-4: Example output from the show telnet command Telnet Server Configuration...
CCESS OMMANDS SHOW USERS show users Overview This command shows information about the users who are currently logged into the device. show users Syntax Mode User Exec and Privileged Exec Example To show the users currently connected to the device, use the command: awplus# show users Output...
CCESS OMMANDS TELNET telnet Overview Use this command to open a telnet session to a remote device. telnet {<hostname>|[ip] <ipv4-addr>|[ipv6] <ipv6-addr>} Syntax [<port>] telnet [vrf <vrf-name>] {<hostname>|[ip] <ipv4-addr>|[ipv6] Syntax (VRF-lite) <ipv6-addr>} [<port>] Parameter Description Apply this command to a VRF instance. <vrf-name>...
CCESS OMMANDS TELNET SERVER telnet server Overview 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. telnet server {<1-65535>|default} Syntax Parameter...
CCESS OMMANDS TERMINAL LENGTH terminal length Overview 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.
CCESS OMMANDS TERMINAL RESIZE terminal resize Overview Use this command to automatically adjust the number of rows of output on the console, which the device will display before pausing, to the number of rows configured on the user’s terminal. terminal resize Syntax Mode User Exec and Privileged Exec...
CCESS OMMANDS USERNAME username Overview This command creates or modifies a user to assign a privilege level and a password. : The default username privilege level of 1 is not shown in running-config output. NOTE Any username privilege level that has been modified from the default is shown. Syntax username <name>...
Page 205
CCESS OMMANDS USERNAME Usage An intermediate CLI security level (privilege level 7 to privilege level 14) allows a CLI user access to the majority of show commands, including the platform show commands that are available at privilege level 1 to privilege level 6. Note that some show commands, such as show running-configuration and show startup-configuration, are only available at privilege level 15.
Feature and Release Licensing Commands Introduction Overview This chapter provides an alphabetical reference for each of the Feature Licensing commands. Feature Licensing enables you to use advanced features such as Layer 3 routing. To see which Feature Licenses are available for your device, see the AlliedWare Plus Datasheet.
EATURE AND ELEASE ICENSING OMMANDS LICENSE license Overview This command activates the licensed software feature set on a standalone switch, or a stack of switches. Use the no variant of this command to deactivate the licensed software feature set on a standalone switch, or a stack of switches. For feature licenses, contact your authorized distributor or reseller.
Page 208
EATURE AND ELEASE ICENSING OMMANDS LICENSE Examples To activate the license called “IPv6” that has the key 12345678ABCDE123456789ABCDE, use the command: awplus# license IPv6 12345678ABCDE123456789ABCDE To deactivate the license called “IPv6”, use the command: awplus# no license ipv6 Related show license Commands C613-50188-01 Rev B Command Reference for SwitchBlade®...
EATURE AND ELEASE ICENSING OMMANDS SHOW LICENSE show license Overview This command displays information about a specific software feature license, or all enabled software feature licenses on the device. show license [feature] [<label>|index <index-number>] Syntax Parameter Description feature Only display license information for any applied feature licenses. <label>...
EATURE AND ELEASE ICENSING OMMANDS SHOW LICENSE Related license Commands show license brief C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
EATURE AND ELEASE ICENSING OMMANDS SHOW LICENSE BRIEF show license brief Overview This command displays information about a specific software feature license, or all enabled software feature licenses on the device. show license [feature] [<label>|index <index-number>] brief Syntax Parameter Description feature Only display license information for any applied feature licenses.
Page 212
EATURE AND ELEASE ICENSING OMMANDS SHOW LICENSE BRIEF Table 4-2: Parameters in the output of show license brief (cont.) Parameter Description License name Name of the license key bundle (case-sensitive). Quantity Quantity of licensed installations. Customer name Customer name. Type Full or Trial.
This chapter provides an alphabetical reference for each of the Subscription Licensing commands. Subscription Licensing enables you to use Allied Telesis Management Framework (AMF). You need to purchase an AMF subscription for each AMF master or controller node in your AMF network. To see the AMF subscriptions for your device,...
Use this command to load a license, after you have manually copied the license file onto the device. Only use this command if you cannot directly access the Allied Telesis Download Center from this device. Otherwise, use the command license update online instead.
LICENSE UPDATE ONLINE license update online Overview Use this command to add or update subscription licenses from the Allied Telesis Download Center, to subscribe to features such as AMF master. When you enter this command, the device will: Connect to the Download Center Check if new or changed licenses are available for the device, keyed to the device’s serial number...
UBSCRIPTION ICENSING OMMANDS SHOW LICENSE EXTERNAL show license external Overview Use this command to show information about subscription (external) licenses. show license external Syntax Parameter Description stored Display all licenses that are on all stack members, including licenses that are not currently in use. Without this parameter, the output only displays licenses that are in use.
GUI Commands Introduction Overview This chapter provides an alphabetical reference of commands used to configure the GUI. For more information, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide Command List • “atmf topology-gui enable” on page 218 •...
GUI C OMMANDS ATMF TOPOLOGY GUI ENABLE atmf topology-gui enable Overview Use this command to enable the operation of Vista Manager EX on the Master device. Vista Manager EX delivers state-of-the-art monitoring and management for your Autonomous Management Framework™ (AMF) network, by automatically creating a complete topology map of switches, firewalls and wireless access points (APs).
GUI C OMMANDS TIMEOUT gui-timeout Overview Use this command to configure an idle timeout period for a GUI session. The time can be set in minutes and/or seconds. Use the no variant of this command to disable the GUI session idle timeout. Syntax gui-timeout <minutes>...
Page 220
GUI C OMMANDS TIMEOUT Related show running-config Commands C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
GUI C OMMANDS LOG EVENT HOST log event-host Overview Use this command to set up an external host to log AMF topology events through Vista Manager. This command is run on the Master device. Use the no variant of this command to disable log events through Vista Manager. Syntax log event-host [<ipv4-addr>|<ipv6-addr>] atmf-topology-event no log event-host [<ipv4-addr>|<ipv6-addr>] atmf-topology-event...
GUI C OMMANDS SERVICE HTTP service http Overview Use this command to enable the HTTP (Hypertext Transfer Protocol) service. This service is required to support Vista Manager EX™ and the AlliedWare Plus™ GUI Java applet. Use the no variant of this command to disable the HTTP feature. service http Syntax no service http...
GUI C OMMANDS SHOW HTTP show http Overview This command shows the HTTP server settings. show http Syntax Mode User Exec and Privileged Exec Example To show the HTTP server settings, use the command: awplus# show http Output Figure 6-2: Example output from the show http command awplus#show http...
Page 224
System Configuration and Monitoring Commands Introduction Overview This chapter provides an alphabetical reference of commands for configuring and monitoring the system. Command List • “banner exec” on page 226 • “banner login (system)” on page 228 • “banner motd” on page 230 •...
Page 225
YSTEM ONFIGURATION AND ONITORING OMMANDS • “show continuous-reboot-prevention” on page 260 • “show cpu” on page 261 • “show cpu history” on page 264 • “show debugging” on page 266 • “show diagnostic monitor pcsping” on page 267 • “show ecofriendly”...
YSTEM ONFIGURATION AND ONITORING OMMANDS BANNER EXEC banner exec Overview This command configures the User Exec mode banner that is displayed on the console after you login. The banner exec default command restores the User Exec banner to the default banner. Use the no banner exec command to disable the User Exec banner and remove the default User Exec banner.
Page 227
YSTEM ONFIGURATION AND ONITORING OMMANDS BANNER EXEC To remove the User Exec mode banner after login, enter the following commands: awplus#configure terminal awplus(config)#no banner exec awplus(config)#exit awplus#exit awplus login: manager Password: awplus> Related banner login (system) Commands banner motd C613-50188-01 Rev B Command Reference for SwitchBlade®...
YSTEM ONFIGURATION AND ONITORING OMMANDS BANNER LOGIN SYSTEM banner login (system) Overview 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.
YSTEM ONFIGURATION AND ONITORING OMMANDS BANNER LOGIN SYSTEM Related banner exec Commands banner motd C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
YSTEM ONFIGURATION AND ONITORING OMMANDS BANNER MOTD banner motd Overview Use this command to create or edit the text MotD (Message-of-the-Day) banner displayed before 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.
Page 231
YSTEM ONFIGURATION AND ONITORING OMMANDS BANNER MOTD awplus>enable awplus#configure terminal Enter configuration commands, one per line. End with CNTL/Z. awplus(config)#no banner motd awplus(config)#exit awplus#exit awplus login: manager Password: AlliedWare Plus (TM) 5.4.7 01/03/17 12:00:00 awplus> Related banner exec Commands banner login (system) C613-50188-01 Rev B...
YSTEM ONFIGURATION AND ONITORING OMMANDS CLOCK SET clock set Overview This command sets the time and date for the system clock. clock set <hh:mm:ss> <day> <month> <year> Syntax Parameter Description <hh:mm:ss> Local time in 24-hour format <day> Day of the current month, from 1 to 31 <month>...
YSTEM ONFIGURATION AND ONITORING OMMANDS CLOCK SUMMER TIME DATE clock summer-time date Overview 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 variant of this command removes the device’s summertime setting. This clears both specific summertime dates and recurring dates (set with the clock summer-time recurring...
Page 234
YSTEM ONFIGURATION AND ONITORING OMMANDS CLOCK SUMMER TIME DATE Related clock summer-time recurring Commands clock timezone C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
YSTEM ONFIGURATION AND ONITORING OMMANDS CLOCK SUMMER TIME RECURRING clock summer-time recurring Overview This command defines the start and end of summertime for every year, and specifies summertime’s offset value to Standard Time. The no variant of this command removes the device’s summertime setting. This clears both specific summertime dates (set with the clock summer-time date command) and recurring dates.
Page 236
YSTEM ONFIGURATION AND ONITORING OMMANDS CLOCK SUMMER TIME RECURRING Mode Global Configuration Examples To set a summertime definition for New Zealand using NZST (UTC+12:00) as the standard time, and NZDT (UTC+13:00) as summertime, with summertime set to start on the last Sunday in September, and end on the 1st Sunday in April, use the command: awplus(config)# clock summer-time NZDT recurring 5 sun sep 2:00...
YSTEM ONFIGURATION AND ONITORING OMMANDS CLOCK TIMEZONE clock timezone Overview This command defines the device’s clock timezone. The timezone is set as a offset to the UTC. The no variant of this command resets the system time to UTC. By default, the system time is set to UTC. clock timezone <timezone-name>...
YSTEM ONFIGURATION AND ONITORING OMMANDS CONTINUOUS REBOOT PREVENTION continuous-reboot-prevention Overview Use this command to enable and to configure the continuous reboot prevention feature. Continuous reboot prevention allows the user to configure the time period during which reboot events are counted, the maximum number of times the switch can reboot within the specified time period, referred to as the threshold, and the action to take if the threshold is exceeded.
Page 239
YSTEM ONFIGURATION AND ONITORING OMMANDS CONTINUOUS REBOOT PREVENTION Examples To enable continuous reboot prevention, use the commands: awplus# configure terminal awplus(config)# continuous-reboot-prevention enable To set the period to 500 and action to stopreboot, use the commands: awplus# configure terminal awplus(config)# continuous-reboot-prevention period 500 action stopreboot To return the period and action to the defaults and keep the continuous reboot...
YSTEM ONFIGURATION AND ONITORING OMMANDS DIAGNOSTIC MONITOR PCSPING diagnostic monitor pcsping Overview Use this command to disable or configure the background PCS (Physical Coding Sublayer) ping monitoring feature to either output a log message or to power off a XEM when a background PCS ping check fails. Use the no variant of this command to re-enable the PCS ping monitoring feature, or restore default behavior to output a log message and not power off a XEM.
Page 241
YSTEM ONFIGURATION AND ONITORING OMMANDS DIAGNOSTIC MONITOR PCSPING Examples To disable the background PCS ping monitoring feature, use the following commands: awplus# configure terminal awplus(config)# diagnostic monitor pcsping disable Output Figure 7-1: Example output from a show diagnostic monitor pcspingcommand after issuing a diagnostic monitor pcsping disable command to disable the feature awplus# configure terminal...
Page 242
YSTEM ONFIGURATION AND ONITORING OMMANDS DIAGNOSTIC MONITOR PCSPING Output Figure 7-3: Example output from a show diagnostic monitor pcspingcommand after issuing adiagnostic monitor pcsping power-off command to configure XEM power- off awplus# configure terminal awplus(config)# diagnostic monitor pcsping power-off awplus(config)# exit awplus# show diagnostic monitor pcsping...
YSTEM ONFIGURATION AND ONITORING OMMANDS ECOFRIENDLY LED ecofriendly led Overview Use this command to enable the eco-friendly LED (Light Emitting Diode) feature which turns off power to the port LEDs, except the eth0 port. On the switch, power to the fault, SD and PSU LEDs is not disabled, and in addition, only the middle segment of the seven segment LED is lit.
YSTEM ONFIGURATION AND ONITORING OMMANDS ECOFRIENDLY LPI ecofriendly lpi Use this command to conserve power by enabling the eco-friendly LPI (Low Power Idle) feature. This feature reduces the power supplied to the ports on XEM2s installed in the switch, whenever ports are idle and are connected to IEEE802.3az Energy Efficient Ethernet compliant host devices.
YSTEM ONFIGURATION AND ONITORING OMMANDS ECOFRIENDLY LPI Related duplex Commands ecofriendly led show ecofriendly show interface speed C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
YSTEM ONFIGURATION AND ONITORING OMMANDS FINDME findme Overview Use this command to physically locate a specific device from a group of similar devices. Activating the command causes a selected number of port LEDs to alternately flash green then amber (if that device has amber LEDs) at a rate of 1 Hz. Use the no variant of this command to deactivate the Find Me feature prior to the timeout expiring.
Page 247
YSTEM ONFIGURATION AND ONITORING OMMANDS FINDME To deactivate the Find Me feature, use the following command: awplus# no findme C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
YSTEM ONFIGURATION AND ONITORING OMMANDS FINDME TRIGGER findme trigger Overview When this command is enabled, the LED flashing functionality of the find-me command is applied whenever any or all of the selected parameter conditions is detected. Use the no variant to remove the findme trigger function for the selected parameter.
YSTEM ONFIGURATION AND ONITORING OMMANDS HOSTNAME hostname Overview 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 •...
Page 250
YSTEM ONFIGURATION AND ONITORING OMMANDS HOSTNAME : When AMF is configured, running the no hostname command will apply a NOTE hostname that is based on the MAC address of the device node, for example, node_0000_5e00_5301. Related show system Commands C613-50188-01 Rev B Command Reference for SwitchBlade®...
YSTEM ONFIGURATION AND ONITORING OMMANDS ROUTES max-fib-routes Overview This command enables you to control the maximum number of FIB routes configured. It operates by providing parameters that enable you to configure preset maximums and warning message thresholds. : When using VRF-lite, this command applies to the Global VRF instance; to set NOTE the max-fib-routes for a user-defined VRF instance use the max-fib-routes (VRF)
Page 252
YSTEM ONFIGURATION AND ONITORING OMMANDS ROUTES Related max-fib-routes (VRF) Commands C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
YSTEM ONFIGURATION AND ONITORING OMMANDS STATIC ROUTES max-static-routes Overview Use this command to set the maximum number of static routes, excluding FIB (Forwarding Information Base) routes. : When using VRF-lite, this command applies to the Global VRF instance; to set NOTE the max-static-routes for a user-defined VRF instance use the max-static-routes (VRF)
YSTEM ONFIGURATION AND ONITORING OMMANDS NO DEBUG ALL no debug all Overview 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 [bgp|ipv6|dot1x|nsm|ospf|pim dense-mode|pim sparse-mode|rip|vrrp]...
Page 255
YSTEM ONFIGURATION AND ONITORING OMMANDS NO DEBUG ALL To disable all PIM Dense Mode debugging, use the command: awplus# no debug all pim dense-mode To disable all PIM Sparse Mode debugging, use the command: awplus# no debug all pim sparse-mode To disable all RIP debugging, use the command: awplus# no debug all rip...
YSTEM ONFIGURATION AND ONITORING OMMANDS REBOOT reboot Overview This command halts the device and performs a cold restart (also known as reload). It displays a confirmation request before restarting. reboot Syntax reload Mode Privileged Exec Usage The reboot and reload commands perform the same action. Examples To restart the device, use the command: awplus#...
YSTEM ONFIGURATION AND ONITORING OMMANDS RELOAD reload Overview This command performs the same function as the reboot command. C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW CLOCK show clock Overview 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. show clock Syntax Mode User Exec and Privileged Exec Example To display the system’s current local time, use the command: awplus#...
Page 259
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW CLOCK Related clock set Commands clock summer-time date clock summer-time recurring clock timezone C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW CONTINUOUS REBOOT PREVENTION show continuous-reboot-prevention Overview This command displays the current continuous reboot prevention configuration. show continuous-reboot-prevention Syntax Mode User Exec and Privileged Exec Examples To show the current continuous reboot prevention configuration, use the command: awplus# show continuous-reboot-prevention...
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW CPU show cpu Overview This command displays a list of running processes with their CPU utilization. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
Page 262
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW CPU Output Figure 7-7: Example output from show cpu 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%...
Page 263
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW CPU Table 2: Parameters in the output of the show cpu command (cont.) Parameter Description sleep% Percentage of time that the process is in the sleep state. runtime The time that the process has been running for, measured in jiffies.
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW CPU HISTORY show cpu history Overview This command prints a graph showing the historical CPU utilization. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
Page 265
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW CPU HISTORY Per minute CPU load history 100 90 80 70 + 50 40 30 20 ++ +++++++++ +++++++ ++++ + ++++++ ++++ +++ +++++ +++++++++ 10 ************************************************************ |..|..|..|..|..|..|..|..|..|..|..|.. Oldest Newest CPU load% per minute (last 60 minutes) * = average CPU load%, + = maximum...
User Exec and Privileged Exec Usage This command displays all debugging information, similar to the way the show tech-support command displays all show output for use by Allied Telesis authorized service personnel only. Example To display all debugging information, use the command: awplus#...
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW DIAGNOSTIC MONITOR PCSPING show diagnostic monitor pcsping Overview Use this command to show the status of the background PCS (Physical Coding Sublayer) ping feature used to check the link status between a XEM and the switch. See the diagnostic monitor pcsping command for further information about the...
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW ECOFRIENDLY show ecofriendly Overview This command displays the switch’s eco-friendly configuration status. The ecofriendly led ecofriendly lpi configuration status are shown in the show ecofriendly output. show ecofriendly Syntax Mode Privileged Exec and Global Configuration Example To display the switch’s eco-friendly configuration status, use the following command:...
Page 269
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW ECOFRIENDLY Table 3: Parameters in the output of the show ecofriendly command (cont.) Parameter Description Configured The eco-friendly LPI feature is configured on the port. Either LPI or off is displayed. Status The eco-friendly LPI feature is active on the port. Either LPI or off is displayed.
This command displays the shared memory used by either all interfaces, or the specified interface or interfaces. The output is useful for diagnostic purposes by Allied Telesis authorized service personnel. For information on filtering and saving command output, see the “Getting Started...
Page 271
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW INTERFACE MEMORY Output Figure 7-14: Example output from the show interface memory command awplus#show interface memory Vlan blocking state shared memory usage --------------------------------------------- Interface shmid Bytes Used nattch Status port1.1.1 491535 1 port1.1.2 393228 1...
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW MEMORY show memory Overview This command displays the memory used by each process that is currently running For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
Page 273
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW MEMORY Table 4: Parameters in the output of the show memory command (cont.) Parameter Description data Amount of memory used for data. The stack size. Related show memory allocations Commands show memory history show memory pools show memory shared C613-50188-01 Rev B Command Reference for SwitchBlade®...
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW MEMORY ALLOCATIONS show memory allocations Overview This command displays the memory allocations used by processes. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW MEMORY ALLOCATIONS Related show memory Commands show memory history show memory pools show memory shared show tech-support C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW MEMORY HISTORY show memory history Overview This command prints a graph showing the historical memory usage. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW MEMORY POOLS show memory pools Overview This command shows the memory pools used by processes. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
Overview This command displays shared memory allocation information. The output is useful for diagnostic purposes by Allied Telesis authorized service personnel. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW PROCESS show process Overview This command lists a summary of the current running processes. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide. Syntax show process [sort {cpu|mem}] Parameter...
Page 280
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW PROCESS Table 5: Parameters in the output from the show process command Parameter Description CPU averages Average CPU utilization for the periods stated. System load The average number of processes waiting for CPU time for the averages periods stated.
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW REBOOT HISTORY show reboot history Overview Use this command to display the device’s reboot history. show reboot history Syntax Mode User Exec and Privileged Exec Example To show the reboot history, use the command: awplus# show reboot history Output...
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW ROUTER show router-id Overview Use this command to show the Router ID of the current system. show router-id Syntax Mode User Exec and Privileged Exec Example To display the Router ID of the current system, use the command: awplus# show router-id Output...
Figure 7-24: Example output from show system System Status Wed Sep 27 04:59:37 2017 Stack member 1 Board Board Name Serial number -------------------------------------------------------------------------------- Base Base AT-SBx908 GEN2 X6-0 A10064A172100008 Expansion Bay1 AT-XEM2-12XT X4-0 A05385A171600021 Expansion Bay7 AT-XEM2-4QS X3-0 A05383A171600001...
Page 284
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW SYSTEM Environment Status : Normal Uptime : 0 days 02:29:21 Bootloader version : 6.2.5 Current software : SBx908NG-5.4.7B-1.1.rel Software version : 5.4.7B-1.1 Build date : Tue Sep 10 12:00:00 UTC 2017 Current boot config: flash:/default.cfg (file exists)...
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW SYSTEM INTERRUPTS show system interrupts Overview 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 device. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW SYSTEM MAC show system mac Overview This command displays the physical MAC address of the device. show system mac Syntax Mode User Exec and Privileged Exec Example To display the physical MAC address enter the following command: awplus# show system mac Output...
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW SYSTEM PCI DEVICE show system pci device Overview Use this command to display the PCI devices on your device. show system pci device Syntax Mode User Exec and Privileged Exec Example To display information about the PCI devices on your device, use the command: awplus# show system pci device Output...
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW SYSTEM PCI TREE show system pci tree Overview Use this command to display the PCI tree on your device. show system pci tree Syntax Mode User Exec and Privileged Exec Example To display information about the PCI tree on your device, use the command: awplus# show system pci tree Output...
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW SYSTEM PSU show system psu Overview This command shows the PSU (Power Supply Unit) status information. show system psu Syntax Mode User Exec and Privileged Exec Example To display the PSU status information, use the command: awplus# show system psu Output...
Page 292
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW SYSTEM PSU Device Ratings: Output rail 1 : 12000 mV, 51000 mA Output rail 2 : 12000 mV, 500 mA Ouput Power : 600 W Min AC input : 85 V Max AC input : 264 V...
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW SYSTEM SERIALNUMBER show system serialnumber Overview This command shows the serial number information for the device. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW TECH SUPPORT show tech-support Overview This command generates system and debugging information for the device and saves it to a file. This command is useful for collecting a large amount of information so that it can then be analyzed for troubleshooting purposes.
Page 295
YSTEM ONFIGURATION AND ONITORING OMMANDS SHOW TECH SUPPORT Parameter Description tacacs+ Display TACACS+ information update Display resource update specific information Output modifier > Output redirection >> Output redirection (append) outfile Output file name <filename> Specifies a name for the output file. If no name is specified, this file will be saved as: tech-support.txt.gz.
YSTEM ONFIGURATION AND ONITORING OMMANDS SPEED ASYN speed (asyn) Overview This command changes the console speed from the device. Note that a change in console speed is applied for subsequent console sessions. Exit the current session to enable the console speed change using the clear line console command.
Page 297
YSTEM ONFIGURATION AND ONITORING OMMANDS SPEED ASYN Related clear line console Commands line show running-config show startup-config speed C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
YSTEM ONFIGURATION AND ONITORING OMMANDS SYSTEM TERRITORY DEPRECATED system territory (deprecated) Overview This command has been deprecated in Software Version 5.4.4-0.1 and later. It now has no effect. It is no longer useful to specify a system territory, so there is no alternative command.
YSTEM ONFIGURATION AND ONITORING OMMANDS TERMINAL MONITOR terminal monitor Overview Use this command to display debugging output on a terminal. To display the cursor after a line of debugging output, press the Enter key. Use the command terminal no monitor to stop displaying debugging output on the terminal, or use the timeout option to stop displaying debugging output on the terminal after a set time.
YSTEM ONFIGURATION AND ONITORING OMMANDS UNDEBUG ALL undebug all Overview This command applies the functionality of the no debug all command. C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
Pluggables and Cabling Commands Introduction Overview This chapter provides an alphabetical reference of commands used to configure and monitor Pluggables and Cabling, including: • Cable Fault Locator for finding faults in copper cabling • Optical Digital Diagnostic Monitoring (DDM) to help find fiber issues when links go down •...
LUGGABLES AND ABLING OMMANDS CLEAR TEST CABLE DIAGNOSTICS TDR clear test cable-diagnostics tdr Overview Use this command to clear the results of the last cable test that was run. clear test cable-diagnostics tdr Syntax Mode Privileged Exec Examples To clear the results of a previous cable-diagnostics test use the following commands: awplus# clear test cable-diagnostics tdr...
LUGGABLES AND ABLING OMMANDS DEBUG FIBER MONITORING debug fiber-monitoring Overview Use this command to enable debugging of active fiber monitoring on the specified ports. Use the no variant of this command to disable debugging on all ports or the specified ports. Syntax debug fiber-monitoring interface <port-list>...
Page 304
LUGGABLES AND ABLING OMMANDS DEBUG FIBER MONITORING Related show system fiber-monitoring Commands C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
LUGGABLES AND ABLING OMMANDS FIBER MONITORING ACTION fiber-monitoring action Overview Use this command to specify an action to be taken if the optical power received on the port changes from the baseline by the amount specified in the fiber-monitoring sensitivity command. Use the no variant of this command to remove the specified action or all actions from the port.
LUGGABLES AND ABLING OMMANDS FIBER MONITORING BASELINE fiber-monitoring baseline Overview Use this command to configure how the baseline value for comparison is calculated for active fiber monitoring on the port. Note that alarm generation will not commence until the link has been up for a full averaging period.
Page 307
LUGGABLES AND ABLING OMMANDS FIBER MONITORING BASELINE Related fiber-monitoring interval Commands fiber-monitoring sensitivity C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
LUGGABLES AND ABLING OMMANDS FIBER MONITORING ENABLE fiber-monitoring enable Overview Use this command to enable active fiber monitoring on a fiber port. If the port can support fiber monitoring but does not have the correct SFP or fiber type installed, the configuration will be saved, and monitoring will commence when a supported SFP is inserted.
LUGGABLES AND ABLING OMMANDS FIBER MONITORING INTERVAL fiber-monitoring interval Overview Use this command to configure the fiber monitoring polling interval in seconds for the port. The optical power will be read every <interval> seconds and compared against the calculated threshold values to see if a log message or other action is required.
LUGGABLES AND ABLING OMMANDS FIBER MONITORING SENSITIVITY fiber-monitoring sensitivity Overview Use this command to configure the sensitivity of the alarm thresholds on the port for active fiber monitoring. Use the no variant of this command to reset the sensitivity to the default. Syntax fiber-monitoring sensitivity (low|medium|high|highest|fixed <25-65535>)|relative <0.01-10.0>...
Page 311
LUGGABLES AND ABLING OMMANDS FIBER MONITORING SENSITIVITY Related fiber-monitoring action Commands fiber-monitoring baseline show system fiber-monitoring C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
LUGGABLES AND ABLING OMMANDS SHOW SYSTEM FIBER MONITORING show system fiber-monitoring Overview Use this command to display settings and current status for Active Fiber Monitoring. show system fiber-monitoring Syntax Mode User Exec/Privileged Exec Example To display configuration and status for active fiber monitoring on ports, use the command: awplus# show system fiber-monitoring...
Page 313
LUGGABLES AND ABLING OMMANDS SHOW SYSTEM FIBER MONITORING Table 8-1: Parameters in the output from show system fiber-monitoring Parameter Description Reading units The units for optical power readings in the rest of the display, e.g. 0.0001mW. Status Whether active fiber monitoring is enabled or disabled for this port.
Page 314
LUGGABLES AND ABLING OMMANDS SHOW SYSTEM FIBER MONITORING fiber-monitoring interval fiber-monitoring sensitivity C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
Different types of pluggable transceivers are supported in different models of device. See your Allied Telesis dealer for more information about the models of pluggables that your device supports.
LUGGABLES AND ABLING OMMANDS SHOW SYSTEM PLUGGABLE Output Figure 8-4: Example output from show system pluggable port1.12.1-1.12.2 System Pluggable Information Port Vendor Device Serial Number Datecode Type -------------------------------------------------------------------------------- 1.12.1 ATI AT-XPSR A03885R092500040 09061801 10GBASE-SR 1.12.2 ATI AT-XPSR A03885R081600015 08041400 10GBASE-SR -------------------------------------------------------------------------------- Table 9: Parameters in the output from the show system pluggable command Parameter...
Different types of pluggable transceivers are supported in different models of device. See your Allied Telesis dealer for more information about the models of pluggables that your device supports.
Page 318
LUGGABLES AND ABLING OMMANDS SHOW SYSTEM PLUGGABLE DETAIL • Power Monitoring: Displays the received power measurement type, which can be either OMA(Optical Module Amplitude) or Avg(Average Power) measured in μW. • TX power monitor support: For QSFP+ modules, this indicates whether the module supports monitoring of the transmitted optical power level (Yes or No).
Page 319
LUGGABLES AND ABLING OMMANDS SHOW SYSTEM PLUGGABLE DETAIL Output Figure 8-6: Example output from show system pluggable detail for a QSFP+ module awplus#show sys pluggable detail System Pluggable Information Detail Port1.1.1 ========== Vendor Name: ATI Device Name: AT-QSFPSR Device Revision: A...
Page 320
LUGGABLES AND ABLING OMMANDS SHOW SYSTEM PLUGGABLE DETAIL Table 8-1: Parameters in the output from show system pluggable detail (cont.) Parameter Description Device Type Specifies the device type for the installed pluggable transceiver. Serial Number Specifies the serial number for the installed pluggable transceiver.
LUGGABLES AND ABLING OMMANDS SHOW SYSTEM PLUGGABLE DIAGNOSTICS show system pluggable diagnostics Overview This command displays diagnostic information about SFP and SFP+ pluggable transceivers that support Digital Diagnostic Monitoring (DDM). Different types of pluggable transceivers are supported in different models of device.
Page 322
LUGGABLES AND ABLING OMMANDS SHOW SYSTEM PLUGGABLE DIAGNOSTICS Output Figure 8-8: Example output from the show system pluggable diagnostics command on a device awplus#show system pluggable diagnostics System Pluggable Information Diagnostics Stack member 1: Port1.5.1 Status Alarms Warnings Reading Alarm Warning...
Page 323
LUGGABLES AND ABLING OMMANDS SHOW SYSTEM PLUGGABLE DIAGNOSTICS module in port 1.1.2. Note that the output displays each internal channel separately. awplus#show sys pluggable diagnostics System Pluggable Information Diagnostics Port1.1.1 Diagnostics information is not supported by device DM-317-100 ...
Page 324
LUGGABLES AND ABLING OMMANDS SHOW SYSTEM PLUGGABLE DIAGNOSTICS Related show system environment Commands show system pluggable show system pluggable detail C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
LUGGABLES AND ABLING OMMANDS SHOW TEST CABLE DIAGNOSTICS TDR show test cable-diagnostics tdr Overview Use this command to display the results of the last cable-diagnostics test that was run using the TDR (Time Domain Reflectometer) on a fixed copper cable port. The displayed status of the cable can be either: •...
LUGGABLES AND ABLING OMMANDS TEST CABLE DIAGNOSTICS TDR INTERFACE test cable-diagnostics tdr interface Overview Use this command to apply the Cable Fault Locator’s cable-diagnostics tests to twisted pair data cables for a selected port. The tests will detect either correct, short circuit, or open, circuit terminations.
Logging Commands Introduction Overview This chapter provides an alphabetical reference of commands used to configure logging. See the Logging Feature Overview and Configuration Guide for more information about the different types of log and how to filter log messages. Command List •...
Page 328
OGGING OMMANDS • “log console (filter)” on page 352 • “log console exclude” on page 355 • “log email” on page 358 • “log email (filter)” on page 359 • “log email exclude” on page 362 • “log email time” on page 365 •...
OGGING OMMANDS CLEAR EXCEPTION LOG clear exception log Overview This command resets the contents of the exception log, but does not remove the associated core files. clear exception log Syntax Mode Privileged Exec awplus# clear exception log Example C613-50188-01 Rev B Command Reference for SwitchBlade®...
OGGING OMMANDS CLEAR LOG clear log Overview This command removes the contents of the buffered and permanent logs. clear log Syntax Mode Privileged Exec Example To delete the contents of the buffered and permanent log use the command: awplus# clear log Related clear log buffered Commands...
OGGING OMMANDS CLEAR LOG BUFFERED clear log buffered Overview This command removes the contents of the buffered log. clear log buffered Syntax Mode Privileged Exec Example To delete the contents of the buffered log use the following commands: awplus# clear log buffered Related default log buffered Commands...
OGGING OMMANDS CLEAR LOG EXTERNAL clear log external Overview Use this command to delete the external log file from the USB storage device it is stored on. If the external log is rotating between multiple files, this command deletes all those files, not just the most recent one.
OGGING OMMANDS CLEAR LOG PERMANENT clear log permanent Overview This command removes the contents of the permanent log. clear log permanent Syntax Mode Privileged Exec Example To delete the contents of the permanent log use the following commands: awplus# clear log permanent Related default log permanent Commands...
OGGING OMMANDS COPY BUFFERED copy buffered-log Overview Use this command to copy the buffered log to an internal or external destination. copy buffered-log <destination-name> Syntax Parameter Description <destination-name> The filename and path for the destination file. See Introduction on page 114 for valid syntax. Mode Privileged Exec Example...
OGGING OMMANDS COPY PERMANENT copy permanent-log Overview Use this command to copy the permanent log to an internal or external destination. copy permanent-log <destination-name> Syntax Parameter Description <destination-name> The filename and path for the destination file. See Introduction on page 114 for valid syntax. Mode Privileged Exec Example...
OGGING OMMANDS DEFAULT LOG BUFFERED default log buffered Overview This command 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. default log buffered Syntax Default...
OGGING OMMANDS DEFAULT LOG CONSOLE default log console Overview This command 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. default log console Syntax Mode...
OGGING OMMANDS DEFAULT LOG EMAIL default log email Overview This command restores the default settings for log messages sent to an email address. By default no filters are defined for email addresses. Filters must be defined before messages will be sent. This command also restores the remote syslog server time offset value to local (no offset).
OGGING OMMANDS DEFAULT LOG EXTERNAL default log external Overview Use this command to restore the default settings for the external log. By default, the size of the external log is 50 kB, it rotates through 1 additional file, and it accepts messages with a severity level of notices and above.
OGGING OMMANDS DEFAULT LOG HOST default log host Overview This command 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. This command also restores the remote syslog server time offset value to local (no offset).
OGGING OMMANDS DEFAULT LOG MONITOR default log monitor Overview This command restores the default settings for log messages sent to the terminal when a terminal monitor command is used. default log monitor Syntax Default All messages are sent to the terminal when a terminal monitor command is used.
OGGING OMMANDS DEFAULT LOG PERMANENT default log permanent Overview This command restores the default settings for the permanent log stored in NVS. By default, the size of the permanent log is 50 kB and it accepts messages with the severity level of warnings and above. default log permanent Syntax Default...
OGGING OMMANDS LOG BUFFERED log buffered Overview This command 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.
OGGING OMMANDS LOG BUFFERED FILTER log buffered (filter) Overview 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 345
OGGING OMMANDS LOG BUFFERED FILTER Parameter Description pim-sm Protocol Independent Multicast - Sparse Mode (PIM-SM) pim-smv6 PIM-SM version 6 (PIM-SMv6) dot1x IEEE 802.1X Port-Based Access Control lacp Link Aggregation Control Protocol (LACP) Spanning Tree Protocol (STP) rstp Rapid Spanning Tree Protocol (RSTP) mstp Multiple Spanning Tree Protocol (MSTP) Integrated Management Interface (IMI)
Page 346
OGGING OMMANDS LOG BUFFERED FILTER Mode Global Configuration Examples To add a filter to send all messages generated by EPSR that have a severity of notices or higher to the buffered log, use the following commands: awplus# configure terminal awplus(config)# log buffered level notices program epsr To add a filter to send all messages containing the text “Bridging initialization”...
OGGING OMMANDS LOG BUFFERED EXCLUDE log buffered exclude Overview Use this command to exclude specified log messages from the buffered log. You can exclude messages on the basis of: • the priority/severity of the message • the program that generated the message •...
Page 348
OGGING OMMANDS LOG BUFFERED EXCLUDE Parameter Description pim-dm Protocol Independent Multicast - Dense Mode (PIM-DM) pim-sm Protocol Independent Multicast - Sparse Mode (PIM-SM) pim-smv6 PIM-SM version 6 (PIM-SMv6) dot1x IEEE 802.1X Port-Based Access Control lacp Link Aggregation Control Protocol (LACP) Spanning Tree Protocol (STP) rstp Rapid Spanning Tree Protocol (RSTP)
Page 349
OGGING OMMANDS LOG BUFFERED EXCLUDE Mode Global configuration Example To remove messages that contain the string “example of irrelevant message”, use the following commands: awplus# configure terminal awplus(config)# log buffered exclude msgtext example of irrelevant message Related clear log buffered Commands default log buffered log buffered...
OGGING OMMANDS LOG BUFFERED SIZE log buffered size Overview This command configures the amount of memory that the buffered log is permitted to use. Once this memory allocation has been filled old messages will be deleted to make room for new messages. log buffered size <50-250>...
OGGING OMMANDS LOG CONSOLE log console Overview This command configures the device to send log messages to consoles. The console log is configured by default to send messages to the device’s main console port. Use the no variant of this command to configure the device not to send log messages to consoles.
OGGING OMMANDS LOG CONSOLE FILTER log console (filter) Overview This command 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 354
OGGING OMMANDS LOG CONSOLE FILTER Examples To create a filter to send all messages containing the text “Bridging initialization” to console instances where the log console command has been entered, use the following commands: awplus# configure terminal awplus(config)# log console msgtext "Bridging initialization" To remove a filter that sends all messages generated by EPSR that have a severity of notices or higher to consoles, use the following commands: awplus#...
OGGING OMMANDS LOG CONSOLE EXCLUDE log console exclude Overview Use this command to prevent specified log messages from being sent to the console, when console logging is turned on. You can exclude messages on the basis of: • the priority/severity of the message •...
Page 357
OGGING OMMANDS LOG CONSOLE EXCLUDE Default No log messages are excluded Mode Global configuration Example To remove messages that contain the string “example of irrelevant message”, use the following commands: awplus# configure terminal awplus(config)# log console exclude msgtext example of irrelevant message Related default log console...
OGGING OMMANDS LOG EMAIL log email Overview This command configures the device to send log messages to an email address. The email address is specified in this command. log email <email-address> Syntax Parameter Description <email-address> The email address to send log messages to Default By default no filters are defined for email log targets.
OGGING OMMANDS LOG EMAIL FILTER log email (filter) Overview This command 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.
Page 360
OGGING OMMANDS LOG EMAIL FILTER Parameter Description pim-dm Protocol Independent Multicast - Dense Mode (PIM-DM) pim-sm Protocol Independent Multicast - Sparse Mode (PIM-SM) pim-smv6 PIM-SM version 6 (PIM-SMv6) dot1x IEEE 802.1X Port-Based Access Control lacp Link Aggregation Control Protocol (LACP) Spanning Tree Protocol (STP) rstp Rapid Spanning Tree Protocol (RSTP)
Page 361
OGGING OMMANDS LOG EMAIL FILTER Examples To create a filter to send all messages generated by EPSR that have a severity of notices or higher to the email address admin@homebase.com, use the following commands: awplus# configure terminal awplus(config)# log email admin@homebase.com level notices program epsr To create a filter to send all messages containing the text “Bridging initialization”, to the email address admin@homebase.com, use the following commands:...
OGGING OMMANDS LOG EMAIL EXCLUDE log email exclude Overview Use this command to prevent specified log messages from being emailed, when the device is configured to send log messages to an email address. You can exclude messages on the basis of: •...
Page 364
OGGING OMMANDS LOG EMAIL EXCLUDE Default No log messages are excluded Mode Global configuration Example To remove messages that contain the string “example of irrelevant message”, use the following commands: awplus# configure terminal awplus(config)# log email exclude msgtext example of irrelevant message Related default log email...
OGGING OMMANDS LOG EMAIL TIME log email time Overview This command configures the time used in messages sent to an email address. If the syslog server is in a different time zone to your device then the time offset can be configured using either the utc-offset parameter option keyword or the local-offset parameter option keyword, where utc-offset is the time difference from UTC (Universal Time, Coordinated) and local-offset is the difference from...
Page 366
OGGING OMMANDS LOG EMAIL TIME To send messages to the email address test@home.com in the same time zone Examples as the device’s local time zone, use the following commands: awplus# configure terminal awplus(config)# log email admin@base.com time local 0 To send messages to the email address admin@base.com with the time information converted to the time zone of the email recipient, which is 3 hours ahead of the device’s local time zone, use the following commands: awplus#...
OGGING OMMANDS LOG EXTERNAL log external Overview Use this command to enable external logging. External logging sends syslog messages to a file on a USB storage device. If the file does not already exist on the storage device, it (and any specified subdirectory) will be automatically created.
Page 368
OGGING OMMANDS LOG EXTERNAL Command Version 5.4.7-1.1: command added changes C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
OGGING OMMANDS LOG EXTERNAL FILTER log external (filter) Overview Use this command to create a filter to select messages to be sent to the external log. You can include messages based on: • the priority/severity of the message • the program that generated the message •...
Page 371
OGGING OMMANDS LOG EXTERNAL FILTER Parameter Description msgtext Select messages containing a certain text string. <text- A text string to match (maximum 128 characters). This is case sensitive, and must be the last string> text on the command line. Default By default the external log has a filter to select messages whose severity level is “notices (5)”...
OGGING OMMANDS LOG EXTERNAL EXCLUDE log external exclude Overview Use this command to exclude specified log messages from the external log. You can exclude messages on the basis of: • the priority/severity of the message • the program that generated the message •...
Page 373
OGGING OMMANDS LOG EXTERNAL EXCLUDE Parameter Description pim-dm Protocol Independent Multicast - Dense Mode (PIM-DM) pim-sm Protocol Independent Multicast - Sparse Mode (PIM-SM) pim-smv6 PIM-SM version 6 (PIM-SMv6) dot1x IEEE 802.1X Port-Based Access Control lacp Link Aggregation Control Protocol (LACP) Spanning Tree Protocol (STP) rstp Rapid Spanning Tree Protocol (RSTP)
Page 374
OGGING OMMANDS LOG EXTERNAL EXCLUDE Mode Global Configuration Example To remove messages that contain the string “example of irrelevant message”, use the following commands: awplus# configure terminal awplus(config)# log external exclude msgtext example of irrelevant message Related clear log external Commands default log external log external...
OGGING OMMANDS LOG EXTERNAL ROTATE log external rotate Overview Use this command to configure the number of files that the external log can rotate through. Use the no variant of this command to return to the default. Syntax log external rotate <0-255> no log external rotate Parameter Description...
Page 376
OGGING OMMANDS LOG EXTERNAL ROTATE Related clear log external Commands default log external log external log external (filter) log external exclude log external size show log config show log external unmount Command Version 5.4.7-1.1: command added changes C613-50188-01 Rev B Command Reference for SwitchBlade®...
OGGING OMMANDS LOG EXTERNAL SIZE log external size Overview Use this command to configure the total amount of size that the external log is permitted to use, in kilobytes. The maximum possible depends on the storage device’s file system. Note that if you are rotating between multiple files, this is the maximum size of all files, not of each individual file.
OGGING OMMANDS LOG FACILITY log facility Overview Use this command to assign a facility to all log messages generated on this device. This facility overrides any facility that is automatically generated as part of the log message. Use the no variant of this command to remove the configured facility. Syntax log facility {kern|user|mail|daemon|auth|syslog|lpr|news|uucp|...
Page 379
OGGING OMMANDS LOG FACILITY Table 9-1: Ordinary meanings of the facility parameter in log messages (cont.) Facility Description FTP daemon local<0..7> The facility labels above have specific meanings, while the local facility labels are intended to be put to local use. In AlliedWare Plus, some of these local facility labels are used in log messages.
OGGING OMMANDS LOG HOST log host Overview This command 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.
OGGING OMMANDS LOG HOST FILTER log host (filter) Overview This command 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.
Page 383
OGGING OMMANDS LOG HOST FILTER Parameter Description pim-sm Protocol Independent Multicast - Sparse Mode (PIM-SM) pim-smv6 PIM-SM version 6 (PIM-SMv6) dot1x IEEE 802.1X Port-Based Access Control lacp Link Aggregation Control Protocol (LACP) Spanning Tree Protocol (STP) rstp Rapid Spanning Tree Protocol (RSTP) mstp Multiple Spanning Tree Protocol (MSTP) Integrated Management Interface (IMI)
Page 384
OGGING OMMANDS LOG HOST FILTER Examples To create a filter to send all messages generated by EPSR that have a severity of notices or higher to a remote syslog server with IP address 10.32.16.21, use the following commands: awplus# configure terminal awplus(config)# log host 10.32.16.21 level notices program epsr To create a filter to send all messages containing the text “Bridging initialization”,...
OGGING OMMANDS LOG HOST EXCLUDE log host exclude Overview Use this command to prevent specified log messages from being sent to the remote syslog server, when log host is enabled. You can exclude messages on the basis of: • the priority/severity of the message •...
Page 387
OGGING OMMANDS LOG HOST EXCLUDE Default No log messages are excluded Mode Global configuration Example To remove messages that contain the string “example of irrelevant message”, use the following commands: awplus# configure terminal awplus(config)# log host exclude msgtext example of irrelevant message Related default log host...
OGGING OMMANDS LOG HOST SOURCE log host source Overview Use this command to specify a source interface or IP address for the device to send syslog messages from. You can specify any one of an interface name, an IPv4 address or an IPv6 address. This is useful if the device can reach the syslog server via multiple interfaces or addresses and you want to control which interface/address the device uses.
OGGING OMMANDS LOG HOST TIME log host time Overview This command configures the time used in messages sent to a remote syslog server. If the syslog server is in a different time zone to your device then the time offset can be configured using either the utc-offset parameter option keyword or the local-offset parameter option keyword, where utc-offset is the time difference from UTC (Universal Time, Coordinated) and local-offset is the difference from local time.
Page 390
OGGING OMMANDS LOG HOST TIME To send messages to the remote syslog server with the IP address 10.32.16.12 with the time information converted to the time zone of the remote syslog server, which is 3 hours ahead of the device’s local time zone, use the following commands: awplus# configure terminal...
OGGING OMMANDS LOG MONITOR FILTER log monitor (filter) Overview This command creates a filter to select messages to be sent to the terminal when 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 392
OGGING OMMANDS LOG MONITOR FILTER Parameter Description dot1x IEEE 802.1X Port-Based Access Control lacp Link Aggregation Control Protocol (LACP) Spanning Tree Protocol (STP) rstp Rapid Spanning Tree Protocol (RSTP) mstp Multiple Spanning Tree Protocol (MSTP) Integrated Management Interface (IMI) imish Integrated Management Interface Shell (IMISH) epsr Ethernet Protection Switched Rings (EPSR)
Page 393
OGGING OMMANDS LOG MONITOR FILTER Examples To create a filter to send all messages that are generated by authentication and have a severity of info or higher to terminal instances where the terminal monitor command has been given, use the following commands: awplus# configure terminal awplus(config)#...
OGGING OMMANDS LOG MONITOR EXCLUDE log monitor exclude Overview Use this command to prevent specified log messages from being displayed on a terminal, when terminal monitor is enabled. You can exclude messages on the basis of: • the priority/severity of the message •...
Page 396
OGGING OMMANDS LOG MONITOR EXCLUDE Default No log messages are excluded Mode Global configuration Example To remove messages that contain the string “example of irrelevant message”, use the following commands: awplus# configure terminal awplus(config)# log monitor exclude msgtext example of irrelevant message Related default log monitor...
OGGING OMMANDS LOG PERMANENT log permanent Overview This command configures the device to send permanent log messages to non-volatile storage (NVS) on the device. The content of the permanent log is retained over a reboot. Once the permanent log reaches its configured maximum allowable size old messages will be deleted to make way for new messages.
OGGING OMMANDS LOG PERMANENT FILTER log permanent (filter) Overview 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 399
OGGING OMMANDS LOG PERMANENT FILTER Parameter Description pim-smv6 PIM-SM version 6 (PIM-SMv6) dot1x IEEE 802.1X Port-Based Access Control lacp Link Aggregation Control Protocol (LACP) Spanning Tree Protocol (STP) rstp Rapid Spanning Tree Protocol (RSTP) mstp Multiple Spanning Tree Protocol (MSTP) Integrated Management Interface (IMI) imish Integrated Management Interface Shell (IMISH)
Page 400
OGGING OMMANDS LOG PERMANENT FILTER Examples To create a filter to send all messages generated by EPSR that have a severity of notices or higher to the permanent log use the following commands: awplus# configure terminal awplus(config)# log permanent level notices program epsr To create a filter to send all messages containing the text “Bridging initialization”, to the permanent log use the following commands: awplus#...
OGGING OMMANDS LOG PERMANENT EXCLUDE log permanent exclude Overview Use this command to prevent specified log messages from being sent to the permanent log. You can exclude messages on the basis of: • the priority/severity of the message • the program that generated the message •...
Page 402
OGGING OMMANDS LOG PERMANENT EXCLUDE Parameter Description pim-dm Protocol Independent Multicast - Dense Mode (PIM-DM) pim-sm Protocol Independent Multicast - Sparse Mode (PIM-SM) pim-smv6 PIM-SM version 6 (PIM-SMv6) dot1x IEEE 802.1X Port-Based Access Control lacp Link Aggregation Control Protocol (LACP) Spanning Tree Protocol (STP) rstp Rapid Spanning Tree Protocol (RSTP)
Page 403
OGGING OMMANDS LOG PERMANENT EXCLUDE Mode Global configuration Example To remove messages that contain the string “example of irrelevant message”, use the following commands: awplus# configure terminal awplus(config)# log permanent exclude msgtext example of irrelevant message Related clear log permanent Commands default log permanent log permanent...
OGGING OMMANDS LOG PERMANENT SIZE log permanent size Overview This command 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. log permanent size <50-250>...
OGGING OMMANDS RATE LIMIT NSM log-rate-limit nsm Overview This command limits the number of log messages generated by the device for a given interval. Use the no variant of this command to revert to the default number of log messages generated by the device of up to 200 log messages per second. Syntax log-rate-limit nsm messages <message-limit>...
OGGING OMMANDS LOG TRUSTPOINT log trustpoint Overview This command adds one or more trustpoints to be used with the syslog application. Multiple trustpoints may be specified, or the command may be executed multiple times, to add multiple trustpoints to the application. The no version of this command removes one or more trustpoints from the list of trustpoints associated with the application.
OGGING OMMANDS SHOW COUNTER LOG show counter log Overview This command displays log counter information. show counter log Syntax Mode User Exec and Privileged Exec Example To display the log counter information, use the command: awplus# show counter log Output Figure 9-1: Example output from the show counter log command Log counters...
OGGING OMMANDS SHOW EXCEPTION LOG show exception log Overview This command displays the contents of the exception log. show exception log Syntax Mode User Exec and Privileged Exec Example To display the exception log, use the command: awplus# show exception log Output Figure 9-2: Example output from the show exception log command on a...
OGGING OMMANDS SHOW LOG show log Overview This command displays the contents of the buffered log. For information on filtering and saving command output, see the “Getting Started with AlliedWare_Plus” Feature Overview and Configuration Guide. Syntax show log [tail [<10-250>]] Parameter Description tail...
Page 410
OGGING OMMANDS SHOW LOG Output Figure 9-3: Example output from show log awplus#show log <date> <time> <facility>.<severity> <program[<pid>]>: <message> ------------------------------------------------------------------------- 2017 Sep 27 05:05:33 syslog.notice awplus syslog-ng[540]: syslog-ng starting up; version='3.10.1' 2017 Sep 27 05:05:33 kern.notice awplus kernel: Linux version 4.4.6-at1 (maker@maker17-build) (gcc version 4.9.3 (crosstool-NG crosstool-ng-1.22.0) ) #1 SMP PREEMPT Tue Sep 26 03:08:22 UTC 2017...
OGGING OMMANDS SHOW LOG CONFIG show log config Overview This command displays information about the logging system. This includes the configuration of the various log destinations, such as buffered, permanent, syslog servers (hosts) and email addresses. This also displays the latest status information for each log destination.
Page 412
OGGING OMMANDS SHOW LOG CONFIG Host 10.32.16.21: Time offset ..+2:00 Offset type ..UTC Source ..- Secured ..enabled Filters: 1 Level ..critical Program ..any Facility ..any Message text . any Statistics ..1327 messages received, 1 accepted by filter (2016 Oct 11 10:36:16) Email admin@alliedtelesis.com:...
OGGING OMMANDS SHOW LOG EXTERNAL show log external Overview Use this command to display the contents of the external log, which is stored on a USB storage device. show log external [tail [<10-250>]] Syntax Parameter Description tail Display only the latest log entries. <10-250>...
OGGING OMMANDS SHOW LOG PERMANENT show log permanent Overview This command displays the contents of the permanent log. Syntax Parameter Description tail Display only the latest log entries. <10-250> Specify the number of log entries to display. Usage If the optional tail parameter is specified only, the latest 10 messages in the permanent log are displayed.
Page 415
OGGING OMMANDS SHOW LOG PERMANENT show log config C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
OGGING OMMANDS SHOW RUNNING CONFIG LOG show running-config log Overview This command displays the current running configuration of the Log utility. show running-config log Syntax Mode Privileged Exec and Global Configuration Example To display the current configuration of the log utility, use the command: awplus# show running-config log Related...
Page 417
OGGING OMMANDS UNMOUNT unmount Overview Use this command to unmount an external storage device. We recommend you unmount storage devices before removing them, to avoid file corruption. This is especially important if files may be automatically written to the storage device, such as external log files or AMF backup files.
Scripting Commands Introduction Overview This chapter provides commands used for command scripts. Command List • “activate” on page 419 • “echo” on page 421 • “wait” on page 422 C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™...
CRIPTING OMMANDS ACTIVATE activate Overview This command activates a script file. activate [background] <script> Syntax Parameter Description 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 420
CRIPTING OMMANDS ACTIVATE Related configure terminal Commands echo enable (Privileged Exec mode) wait C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
CRIPTING OMMANDS ECHO echo Overview This command echoes a string to the terminal, followed by a blank line. echo <line> Syntax Parameter Description <line> The string to echo Mode User Exec and Privileged Exec Usage This command may be useful in CLI scripts, to make the script print user-visible comments.
CRIPTING OMMANDS WAIT wait Overview This command pauses execution of the active script for the specified period of time. wait <delay> Syntax Parameter Description <delay> <1-65335> Specify the time delay in seconds Default No wait delay is specified by default to pause script execution. Mode Privileged Exec (when executed from a script not directly from the command line) Usage...
Interface Commands Introduction Overview This chapter provides an alphabetical reference of commands used to configure and display interfaces. Command List • “description (interface)” on page 424 • “interface (to configure)” on page 425 • “mru” on page 427 • “mtu” on page 429 •...
NTERFACE OMMANDS DESCRIPTION INTERFACE description (interface) Overview Use this command to add a description to a specific port or interface. description <description> Syntax Parameter Description <description> Text describing the specific interface. Descriptions can contain any printable ASCII characters (ASCII 32-126). Mode Interface Configuration Example...
NTERFACE OMMANDS INTERFACE TO CONFIGURE interface (to configure) Overview Use this command to select one or more interfaces to configure. interface <interface-list> Syntax interface lo Parameter Description <interface-list> The interfaces or ports to configure. An interface-list can be: • an interface such as a VLAN(e.g. vlan2), a switch port (e.g. port1.1.12), a static channel group (e.g.
Page 426
NTERFACE OMMANDS INTERFACE TO CONFIGURE The following example shows how to enter Interface mode to configure the local loopback interface. awplus# configure terminal awplus(config)# interface lo awplus(config-if)# Related ip address (IP Addressing and Protocol) Commands show interface show interface brief C613-50188-01 Rev B Command Reference for SwitchBlade®...
Page 427
NTERFACE OMMANDS Overview Use the no variant of this command to remove a previously specified Maximum Receive Unit (MRU) size for switch ports, and restore the default MRU size (1500 bytes) for switch ports. : The figure of 1500 bytes specifies the payload only. For an IEEE 802.1q frame, NOTE provision is made (internally) for the following additional components: •...
NTERFACE OMMANDS Related show interface Commands C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
Page 429
NTERFACE OMMANDS Overview Use this command to set the Maximum Transmission Unit (MTU) size for VLANs, where MTU is the maximum packet size that VLANs can transmit. The MTU size setting is applied to both IPv4 and IPv6 packet transmission. Use the no variant of this command to remove a previously specified Maximum Transmission Unit (MTU) size for VLANs, and restore the default MTU size (1500 bytes) for VLANs.
Page 430
NTERFACE OMMANDS Related show interface Commands C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
NTERFACE OMMANDS SHOW INTERFACE show interface Overview Use this command to display interface configuration and status. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide. Syntax show interface [<interface-list>] show interface lo Parameter Description...
Page 432
NTERFACE OMMANDS SHOW INTERFACE Figure 11-1: Example output from the show interface command awplus#show interface Interface port1.1.1 Scope: both Link is DOWN, administrative state is UP Thrash-limiting Status Not Detected, Action learn-disable, Timeout 1(s) Hardware is Ethernet, address is eccd.6d03.1123 index 5001 metric 1 mru 1522...
Page 433
NTERFACE OMMANDS SHOW INTERFACE Figure 11-3: Example output from the show interface vlan1,vlan2 command awplus#show interface vlan1,vlan2 Interface vlan1 Scope: both Link is UP, administrative state is UP Hardware is VLAN, address is 0015.77e9.5c50 IPv4 address 192.168.1.1/24 broadcast 192.168.1.255 index 201 metric 1 mtu 1500...
NTERFACE OMMANDS SHOW INTERFACE BRIEF show interface brief Overview Use this command to display brief interface, configuration, and status information, including provisioning information. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
Page 435
This command displays the shared memory used by either all interfaces, or the specified interface or interfaces. The output is useful for diagnostic purposes by Allied Telesis authorized service personnel. For information on filtering and saving command output, see the “Getting Started...
Page 436
NTERFACE OMMANDS SHOW INTERFACE MEMORY Output Figure 11-5: Example output from the show interface memory command awplus#show interface memory Vlan blocking state shared memory usage --------------------------------------------- Interface shmid Bytes Used nattch Status port1.1.1 491535 1 port1.1.2 393228 1 port1.1.3 557073 1...
NTERFACE OMMANDS SHOW INTERFACE STATUS show interface status Overview Use this command to display the status of the specified interface or interfaces. Note that when no interface or interfaces are specified then the status of all interfaces on the device are shown. show interface [<port-list>] status Syntax Parameter...
Page 438
NTERFACE OMMANDS SHOW INTERFACE STATUS Table 13: Example output from the show interface status command awplus#sho int status Port Name Status Vlan Duplex Speed Type port1.1.1 notconnect 1 auto auto port1.1.2 notconnect 1 auto auto port1.1.3 notconnect 1 auto auto port1.1.4 notconnect 1 auto...
Page 439
NTERFACE OMMANDS SHOW INTERFACE STATUS Table 14: Parameters in the output from the show interface status command Parameter Description Duplex The actual duplex mode of the interface, preceded by a- if it has autonegotiated this duplex mode. If the port is disabled or not connected, it displays the configured duplex setting.
NTERFACE OMMANDS SHUTDOWN shutdown Overview 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 variant of this command to disable this function and therefore to bring the link back up again.
Port Mirroring Commands Introduction Overview This chapter provides an alphabetical reference of commands used to configure Port Mirroring. For more information, see the Mirroring Feature Overview and Configuration Guide. Command List • “mirror interface” on page 442 • “show mirror” on page 444 •...
IRRORING OMMANDS MIRROR INTERFACE mirror interface Overview 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.
Page 443
IRRORING OMMANDS MIRROR INTERFACE Mode Interface Configuration Usage Use this command to send traffic to another device connected to the mirror port for monitoring. For more information, see the Mirroring Feature Overview and Configuration Guide. A mirror port cannot be associated with a VLAN. If a switch port is configured to be a mirror port, it is automatically removed from any VLAN it was associated with.
IRRORING OMMANDS SHOW MIRROR show mirror Overview Use this command to display the status of all mirrored ports. show mirror Syntax Mode User Exec and Privileged Exec Example To display the status of all mirrored ports, use the following command: awplus# show mirror Output...
IRRORING OMMANDS SHOW MIRROR INTERFACE show mirror interface Overview Use this command to display port mirroring configuration for a mirrored (monitored) switch port. show mirror interface <port> Syntax Parameter Description <port> The monitored switch port to display information about. Mode User Exec, Privileged Exec and Interface Configuration To display port mirroring configuration for the port1.1.4, use the following Example...
Page 446
Interface Testing Commands Introduction Overview This chapter provides an alphabetical reference of commands used for testing interfaces. Command List • “clear test interface” on page 447 • “service test” on page 448 • “test interface” on page 449 C613-50188-01 Rev B Command Reference for SwitchBlade®...
NTERFACE ESTING OMMANDS CLEAR TEST INTERFACE clear test interface Overview This command clears test results and counters after issuing the test interface command. Test results and counters must be cleared before executing subsequent test interface commands. clear test interface {<port-list>|all} Syntax Parameter Description...
NTERFACE ESTING OMMANDS SERVICE TEST service test Overview 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.
NTERFACE ESTING OMMANDS TEST INTERFACE test interface Overview This command starts a test on a port or all ports or a selected range or list of ports. Use the no variant of this command to disable this function. The test duration can be configured by specifying the time in minutes after specifying a port or ports to test.
Page 450
NTERFACE ESTING OMMANDS TEST INTERFACE Example To test the switch ports in VLAN 1, install loopbacks in the ports, and enter the following commands: awplus(config)# service test awplus(config)# no spanning-tree rstp enable bridge-forward awplus(config)# interface vlan1 awplus(config-if)# shutdown awplus(config-if)# awplus# test interface all To see the output, use the commands: awplus#...
Part 2: Interfaces and Layer 2 C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
Switching Commands Introduction Overview This chapter provides an alphabetical reference of commands used to configure switching. For more information, see the Switching Feature Overview and Configuration Guide. Command List • “clear loop-protection counters” on page 454 • “clear mac address-table dynamic”...
Page 453
WITCHING OMMANDS • “mac address-table thrash-limit” on page 476 • “platform hwfilter-size” on page 477 • “platform load-balancing” on page 478 • “platform stop-unreg-mc-flooding” on page 480 • “platform vlan-stacking-tpid” on page 482 • “polarity” on page 483 • “show debugging loopprot”...
WITCHING OMMANDS CLEAR LOOP PROTECTION COUNTERS clear loop-protection counters Overview Use this command to clear the counters for the Loop Protection counters. clear loop-protection [interface <port-list>] counters Syntax Parameters Description interface The interface whose counters are to be cleared. <port-list> A port, a port range, or an aggregated link.
WITCHING OMMANDS CLEAR MAC ADDRESS TABLE DYNAMIC clear mac address-table dynamic Overview Use this command to clear the filtering database of all entries learned for a selected MAC address, an MSTP instance, a switch port interface or a VLAN interface. clear mac address-table dynamic [address Syntax <mac-address>|interface <port>...
Page 456
WITCHING OMMANDS CLEAR MAC ADDRESS TABLE DYNAMIC This example shows how to clear all dynamically learned filtering database entries when learned through switch operation for a given MSTP instance 1 on switch port interface port1.1.2. awplus# clear mac address-table dynamic interface port1.1.2 instance 1 Related clear mac address-table static...
WITCHING OMMANDS CLEAR MAC ADDRESS TABLE STATIC clear mac address-table static Overview Use this command to clear the filtering database of all statically configured entries for a selected MAC address, interface, or VLAN. clear mac address-table static [address <mac-address>|interface Syntax <port>|vlan <vid>] Parameter Description...
WITCHING OMMANDS CLEAR PORT COUNTER clear port counter Overview Use this command to clear the packet counters of the port. clear port counter [<port>] Syntax Parameter Description <port> The port number or range Mode Privileged Exec To clear the packet counter for port1.1.1, use the command: Example awplus# clear port counter port1.1.1...
WITCHING OMMANDS CLEAR PORT SECURITY INTRUSION clear port-security intrusion Overview Use this command to clear the history of the port-security intrusion list on all ports, or an individual port. If a port is not specified, the intrusion lists of all ports are cleared.
Page 460
WITCHING OMMANDS CLEAR PORT SECURITY INTRUSION Table 14-2: Example output from show port-security intrusion awplus#show port-security intrusion interface port1.1.1 Port Security Intrusion List ------------------------------------------------------------ Interface: port1.1.1 - 1 intrusion(s) detected 801f.0200.19da To clear the history of port-security intrusion list on port1.1.1, use the following command: awplus# clear port-security intrusion interface port1.1.1...
Page 461
WITCHING OMMANDS CLEAR PORT SECURITY INTRUSION Related show port-security interface Commands show port-security intrusion switchport port-security switchport port-security aging switchport port-security maximum switchport port-security violation C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
WITCHING OMMANDS DEBUG LOOPPROT debug loopprot Overview This command enables Loop Protection debugging. The no variant of this command disables Loop Protection debugging. Syntax debug loopprot {info|msg|pkt|state|nsm|all} no debug loopprot {info|msg|pkt|state|nsm|all} Parameter Description info General Loop Protection information. Received and transmitted Loop Detection Frames (LDFs). Echo raw ASCII display of received and transmitted LDF packets to the console.
WITCHING OMMANDS DEBUG PLATFORM PACKET debug platform packet Overview This command enables platform to CPU level packet debug functionality on the device. Use the no variant of this command to disable platform to CPU level packet debug. If the result means both send and receive packet debug are disabled, then any active timeout will be canceled.
Page 464
WITCHING OMMANDS DEBUG PLATFORM PACKET To enable packet debug for sFlow packets only for the default timeout of 5 minutes, enter: awplus# debug platform packet sflow To enable send packet debug with no timeout, enter: awplus# debug platform packet send timeout 0 To enable VLAN packet debug for VLAN 2 with a timeout duration of 3 minutes, enter: awplus#...
WITCHING OMMANDS DUPLEX duplex Overview This command changes the duplex mode for the specified port. To see the currently-negotiated duplex mode for ports whose links are up, use the command show interface. To see the configured duplex mode (when different from the default), use the command show running-config.
WITCHING OMMANDS FLOWCONTROL SWITCH PORT flowcontrol (switch port) Overview Use this command to enable flow control, and configure the flow control mode for the switch port. Use the no variant of this command to disable flow control for the specified switch port.
WITCHING OMMANDS LINKFLAP ACTION linkflap action Overview Use this command to detect flapping on all ports. If more than 15 flaps occur in less than 15 seconds the flapping port will shut down. Use the no variant of this command to disable flapping detection at this rate. Syntax linkflap action [shutdown] no linkflap action...
WITCHING OMMANDS LOOP PROTECTION LOOP DETECT loop-protection loop-detect Overview Use this command to enable the loop-protection loop-detect feature and configure its parameters. Use the no variant of this command to disable the loop-protection loop-detect feature. Syntax loop-protection loop-detect [ldf-interval <period>] [ldf-rx-window <frames>] [fast-block] no loop-protection loop-detect Parameter...
WITCHING OMMANDS LOOP PROTECTION ACTION loop-protection action Overview Use this command to specify the protective action to apply when a network loop is detected on an interface. Use the no variant of this command to reset the loop protection actions to the default action, vlan-disable, on an interface.
WITCHING OMMANDS LOOP PROTECTION ACTION DELAY TIME loop-protection action-delay-time Overview Use this command to sets the loop protection action delay time for an interface to specified values in seconds. The action delay time specifies the waiting period for the action. Use the no variant of this command to reset the loop protection action delay time for an interface to default.
WITCHING OMMANDS LOOP PROTECTION TIMEOUT loop-protection timeout Overview Use this command to specify the Loop Protection recovery action duration on an interface. Use the no variant of this command to set the loop protection timeout to the default. Syntax loop-protection timeout <duration> no loop-protection timeout Parameter Description...
WITCHING OMMANDS MAC ADDRESS TABLE ACQUIRE mac address-table acquire Overview Use this command to enable MAC address learning on the device. Use the no variant of this command to disable learning. Syntax mac address-table acquire no mac address-table acquire Default Learning is enabled by default for all instances.
WITCHING OMMANDS MAC ADDRESS TABLE AGEING TIME mac address-table ageing-time Overview 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. The no variant of this command will reset the ageing-out time back to the default of 300 seconds (5 minutes).
WITCHING OMMANDS MAC ADDRESS TABLE LOGGING mac address-table logging Overview Use this command to create log entries when the content of the FDB (forwarding database) changes. Log messages are produced when a MAC address is added to or removed from the FDB. : MAC address table logging may impact the performance of the switch.
WITCHING OMMANDS MAC ADDRESS TABLE STATIC mac address-table static Overview Use this command to statically configure the MAC address-table to forward or discard frames with a matching destination MAC address. mac address-table static <mac-addr> {forward|discard} interface Syntax <port> [vlan <vid>] no mac address-table static <mac-addr>...
WITCHING OMMANDS MAC ADDRESS TABLE THRASH LIMIT mac address-table thrash-limit Overview Use this command to set the thrash limit on the device. 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. Use the no variant of this command to disable thrash limiting.
WITCHING OMMANDS PLATFORM HWFILTER SIZE platform hwfilter-size Overview You can use this command to control the configuration of hardware Access Control Lists (ACLs), which determines the total available number and functionality of hardware ACLs. For this command to take effect, you need to reboot the affected service. You cannot attach an IPv6 ACL to a port if the ACL contains a specified source or destination IPv6 address or both and the hw-filter size setting is ipv4-limited-ipv6.
WITCHING OMMANDS PLATFORM LOAD BALANCING platform load-balancing Overview This command selects which address fields are used as inputs into the load balancing algorithm for aggregated links. The output from this algorithm is used to select which individual path a given packet will traverse within an aggregated link.
Page 479
WITCHING OMMANDS PLATFORM LOAD BALANCING Examples To use all four inputs, you do not have to enter any commands, because this is the default. Note that this setting is not displayed in the show running-config output. Use the show platform command to verify this setting.
WITCHING OMMANDS PLATFORM STOP UNREG FLOODING platform stop-unreg-mc-flooding Overview If a multicast stream is arriving at a network device, and that network device has received no IGMP reports that request the receipt of the stream, then that stream is referred to as "unregistered". IGMP snooping actively prevents the flooding of unregistered streams to all ports in the VLAN on which the stream is received.
Page 481
WITCHING OMMANDS PLATFORM STOP UNREG FLOODING Examples To enable this feature and stop multicast packet flooding, use the following commands: awplus# configure terminal awplus(config)# platform stop-unreg-mc-flooding To disable this feature and allow multicast packet flooding, use the following commands: awplus# configure terminal awplus(config)# no platform stop-unreg-mc-flooding...
WITCHING OMMANDS PLATFORM VLAN STACKING TPID platform vlan-stacking-tpid Overview 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.) Use the no variant of this command to revert to the default TPID value (0x8100).
WITCHING OMMANDS POLARITY polarity Overview This command sets the MDI/MDIX polarity on a copper-based switch port. polarity {auto|mdi|mdix} Syntax Parameter Description Sets the polarity to MDI (medium dependent interface). mdix Sets the polarity to MDI-X (medium dependent interface crossover). auto The switch port sets the polarity automatically.
WITCHING OMMANDS SHOW DEBUGGING LOOPPROT show debugging loopprot Overview This command shows Loop Protection debugging information. show debugging loopprot Syntax Mode User Exec and Privileged Exec Example To display the enabled Loop Protection debugging modes, use the command: awplus# show debugging loopprot Related debug loopprot Commands...
WITCHING OMMANDS SHOW DEBUGGING PLATFORM PACKET show debugging platform packet Overview This command shows platform to CPU level packet debugging information. show debugging platform packet Syntax Mode User Exec and Privileged Exec Example To display the platform packet debugging information, use the command: awplus# show debugging platform packet Related...
WITCHING OMMANDS SHOW FLOWCONTROL INTERFACE show flowcontrol interface Overview Use this command to display flow control information. show flowcontrol interface <port> Syntax Parameter Description <port> Specifies the name of the port to be displayed. Mode User Exec and Privileged Exec To display the flow control for the port1.1.5, use the command: Example awplus#...
WITCHING OMMANDS SHOW INTERFACE ERR DISABLED show interface err-disabled Overview Use this command to show the ports which have been dynamically shut down by protocols running on the device and the protocols responsible for the shutdown. show interface [<interface-range> err-disabled] Syntax Parameter Description...
WITCHING OMMANDS SHOW INTERFACE SWITCHPORT show interface switchport Overview Use this command to show VLAN information about each switch port. show interface switchport Syntax Mode User Exec and Privileged Exec Example To display VLAN information about each switch port, enter the command: awplus# show interface switchport Output...
WITCHING OMMANDS SHOW LOOP PROTECTION show loop-protection Overview Use this command to display the current loop protection setup for the device. show loop-protection [interface <port-list>] [counters] Syntax Parameter Description interface The interface selected for display. <port-list> A port, a port range, or an aggregated link. counters Displays counter information for loop protection.
Page 490
WITCHING OMMANDS SHOW LOOP PROTECTION awplus#show loop-protection counters Switch Loop Detection Counter Interface Rx Invalid Last LDF Rx ------------------------------------------------------------------------- port1.1.1 vlan1 - port1.1.2 vlan1 - port1.1.3 vlan1 - C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™...
WITCHING OMMANDS SHOW MAC ADDRESS TABLE show mac address-table Overview Use this command to display the mac address-table for all configured VLANs. show mac address-table Syntax Mode User Exec and Privileged Exec Usage The show mac address-table command is only applicable to view a mac address-table for Layer 2 switched traffic within VLANs.
Page 492
WITCHING OMMANDS SHOW MAC ADDRESS TABLE awplus(config)#mac address-table static 0000.1111.2222 for int port1.1.11 vlan 2 awplus(config)#end awplus# awplus#show mac address-table VLAN port type unknown 0000.cd28.0752 forward static port1.1.9 0030.846e.bac7 forward dynamic port1.1.11 0000.1111.2222 forward static unknown 0000.cd28.0752 forward static...
WITCHING OMMANDS SHOW MAC ADDRESS TABLE THRASH LIMIT show mac address-table thrash-limit Overview Use this command to display the current thrash limit set for all interfaces on the device. show mac address-table thrash-limit Syntax Mode User Exec and Privileged Exec Example To display the current, use the following command: awplus#...
WITCHING OMMANDS SHOW PLATFORM show platform Overview This command displays the settings configured by using the platform commands. show platform Syntax Mode Privileged Exec Usage This command displays the settings in the running config. For changes in some of these settings to take effect, the device must be rebooted with the new settings in the startup config.
WITCHING OMMANDS SHOW PLATFORM CLASSIFIER STATISTICS UTILIZATION BRIEF show platform classifier statistics utilization brief Overview This command displays the number of used entries available for various platform functions, and the percentage that number of entries represents of the total available. Syntax show platform classifier statistics utilization brief Mode...
Page 496
User Defined Bytes (UDB), which are a limited resource of bytes that can be used to implement additional arbitrary matching on packet bytes. The software manages the use and allocation of these bytes automatically. The output of this table is intended for use by Allied Telesis Customer Support only. Related show platform...
WITCHING OMMANDS SHOW PLATFORM PORT show platform port Overview This command displays the various port registers or platform counters for specified switchports. show platform port [<port-list>|counters] Syntax Parameter Description <port-list> The ports to display information about. A port-list can be: •...
Page 498
WITCHING OMMANDS SHOW PLATFORM PORT Table 17: Parameters in the output from the show platform port command Parameter Description Ethernet MAC counters Combined receive/ Number of packets in each size range received and transmit packets by transmitted. size (octets) counters Number of 64 octet packets received and transmitted.
Page 499
WITCHING OMMANDS SHOW PLATFORM PORT Table 17: Parameters in the output from the show platform port command Parameter Description BroadcastPkts Number of broadcast packets received. PauseMACCtlFrms Number of Pause MAC Control Frames received. OversizePkts Number of oversize packets received. Fragments Number of fragments received.
Page 500
WITCHING OMMANDS SHOW PLATFORM PORT Table 17: Parameters in the output from the show platform port command Parameter Description ifInUcastPkts Inbound interface Unicast counter. ifInDiscards Inbound interface Discarded Packets counter. ipInHdrErrors Inbound interface Header Errors counter. ifOutUcastPkts Outbound interface Unicast counter. ifOutErrors Outbound interface Error counter.
WITCHING OMMANDS SHOW PORT SECURITY INTERFACE show port-security interface Overview Use this command to show the current port-security configuration and the switch port status. show port-security interface <port> Syntax Parameter Description <port> The port to display information about. The port may be a switch port (e.g.
WITCHING OMMANDS SHOW PORT SECURITY INTRUSION show port-security intrusion Overview Use this command to show the intrusion list. If the port is not specified, the entire intrusion table is shown. show port-security intrusion [interface <port>] Syntax Parameter Description interface Specify a port <port>...
WITCHING OMMANDS SHOW PROVISIONING show provisioning (xem) Overview This command shows the provisioning status of all installed or provisioned hardware. Provisioning is the preconfiguration necessary to accommodate future connection of hardware items such as a XEM bay. show provisioning Syntax Mode User Exec and Privileged Exec Example...
WITCHING OMMANDS SHOW STORM CONTROL show storm-control Overview Use this command to display storm-control information for all interfaces or a particular interface. show storm-control [<port>] Syntax Parameter Description <port> The port to display information about. The port may be a switch port (e.g.
WITCHING OMMANDS SPEED speed Overview This command changes the speed of the specified port. You can optionally specify the speed or speeds that get autonegotiated, so autonegotiation is only attempted at the specified speeds. To see the currently-negotiated speed for ports whose links are up, use the show interface command.
WITCHING OMMANDS SPEED To return the port to auto-negotiating its speed, enter the following commands: awplus# configure terminal awplus(config)# interface port1.1.2 awplus(config-if)# speed auto To set the port to auto-negotiate its speed at 10000Mbps only, enter the following commands: awplus# configure terminal awplus(config)# interface port1.1.2...
WITCHING OMMANDS STORM CONTROL LEVEL storm-control level Overview Use this command to specify the speed limiting level for broadcasting, multicast, or destination lookup failure (DLF) traffic for the port. Storm-control limits the selected traffic type to the specified percentage of the maximum port speed. Use the no variant of this command to disable storm-control for broadcast, multicast or DLF traffic.
WITCHING OMMANDS SWITCH BAY PROVISION switch bay provision (xem) Overview This command enables you to pre-configure a specific empty bay within a switch ready for inserting a particular XEM type. To run this command, the bay position must be vacant and the selected XEM type must be one that is currently supported. Use the no variant of this command to remove an existing switch provision.
WITCHING OMMANDS SWITCHPORT PORT SECURITY switchport port-security Overview Use this command to enable the port-security feature. This feature is also known as the port-based learn limit. It allows the user to set the maximum number of MAC addresses that each port can learn. Use the no variant of this command to disable the port-security feature.
WITCHING OMMANDS SWITCHPORT PORT SECURITY AGING switchport port-security aging Overview Use this command to set MAC addresses that have been learned by port security to age out. Use the no variant of this command to set the MAC addresses to not age out. Syntax switchport port-security aging no switchport port-security aging...
WITCHING OMMANDS SWITCHPORT PORT SECURITY MAXIMUM switchport port-security maximum Overview Use this command to set the maximum number of MAC addresses that each port can learn. Use the no variant of this command to unset the maximum number of MAC addresses that each port can learn.
WITCHING OMMANDS SWITCHPORT PORT SECURITY VIOLATION switchport port-security violation Overview Use this command to set the action taken on a switch port when the port exceeds the learning limits. The port action can be either shutdown, restrict or protect. If shutdown is set, the physical link will be disabled and “shutdown”...
WITCHING OMMANDS THRASH LIMITING thrash-limiting Overview Sets and configures the thrash limit action that will be applied to any port on the device when a thrashing condition is detected. The thrash-limiting timeout specifies the time, in seconds, for which the thrash action is employed. thrash-limiting {[action Syntax {learn-disable|link-down|port-disable|vlan-disable|none}]...
Page 514
WITCHING OMMANDS THRASH LIMITING To set the thrash limiting action to its default, use the following command: awplus(config-if)# no thrash-limiting action To set the thrash limiting timeout to its default, use the following command: awplus(config-if)# no thrash-limiting timeout Related loop-protection loop-detect Commands loop-protection action loop-protection timeout...
WITCHING OMMANDS UNDEBUG LOOPPROT undebug loopprot Overview This command applies the functionality of the no debug loopprot command. C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
WITCHING OMMANDS UNDEBUG PLATFORM PACKET undebug platform packet Overview This command applies the functionality of the no debug platform packet command. C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
VLAN Commands Introduction Overview This chapter provides an alphabetical reference of commands used to configure VLANs. For more information see the VLAN Feature Overview and Configuration Guide. Command List • “clear vlan statistics” on page 519 • “port-vlan-forwarding-priority” on page 520 •...
Page 518
VLAN C OMMANDS • “switchport mode private-vlan trunk secondary” on page 541 • “switchport mode trunk” on page 543 • “switchport private-vlan host-association” on page 544 • “switchport private-vlan mapping” on page 545 • “switchport trunk allowed vlan” on page 546 •...
VLAN C OMMANDS CLEAR VLAN STATISTICS clear vlan statistics Overview This command resets the counters for either a specific VLAN statistics instance or (by not specifying an instance) resets the counters for all instances. The terms frame and packet are used interchangeably. Syntax clear vlan statistics [name <instance-name>] Parameter...
VLAN C OMMANDS PORT VLAN FORWARDING PRIORITY port-vlan-forwarding-priority Overview Use this command to specify which protocol has the highest priority for controlling transitions from blocking to forwarding traffic, when more than one of EPSR, Loop Protection, and MAC thrashing protection are used on the switch. These protocols use the same mechanism to block or forward traffic.
Page 521
VLAN C OMMANDS PORT VLAN FORWARDING PRIORITY each protocol could set a port to forwarding for a VLAN, sometimes overriding the previous setting by another protocol to block the port. This could sometimes lead to unexpected broadcast storms. This command means that, when a protocol is set to have the highest priority over a data VLAN on a port, it will not allow other protocols to put that port-vlan into a forwarding state if the highest priority protocol blocked it.
Page 522
VLAN C OMMANDS PORT VLAN FORWARDING PRIORITY To prioritize Loop Protection over EPSR or MAC Thrashing protection settings, so that EPSR or MAC Thrashing protection cannot set a port to the forwarding state for a VLAN if Loop Protection has set it to the blocking state, use the commands: awplus# configure terminal awplus(config)#...
VLAN C OMMANDS PRIVATE VLAN private-vlan Overview 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 variant of this command to remove the specified private VLAN. For more information, see the VLAN Feature Overview and Configuration Guide.
VLAN C OMMANDS PRIVATE VLAN ASSOCIATION private-vlan association Overview 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 variant of this command to remove association of all the secondary VLANs to a primary VLAN.
VLAN C OMMANDS SHOW PORT VLAN FORWARDING PRIORITY show port-vlan-forwarding-priority Overview Use this command to display the highest priority protocol that controls port-vlan forwarding or blocking traffic. This command displays whether EPSR or Loop Protection is set as the highest priority for determining whether a port forwards a VLAN, as set by the port-vlan-forwarding-priority command.
VLAN C OMMANDS SHOW VLAN show vlan Overview Use this command to display information about a particular VLAN by specifying its VLAN ID. Selecting all will display information for all the VLANs configured. show vlan Syntax {all|brief|dynamic|static|auto|static-ports|<1-4094>} Parameter Description <1-4094> Display information about the VLAN specified by the VLAN ID.
VLAN C OMMANDS SHOW VLAN ACCESS show vlan access-map Overview Use this command to display information about the configured VLAN access-maps. VLAN access-maps contain a series of ACLs and enable you to filter traffic ingressing specified VLANs. show vlan access-map [<name>] Syntax Parameter Description...
VLAN C OMMANDS SHOW VLAN CLASSIFIER GROUP show vlan classifier group Overview Use this command to display information about all configured VLAN classifier groups or a specific group. show vlan classifier group [<1-16>] Syntax Parameter Description <1-16> VLAN classifier group identifier Mode User Exec and Privileged Exec Usage...
VLAN C OMMANDS SHOW VLAN CLASSIFIER GROUP INTERFACE show vlan classifier group interface Overview Use this command to display information about a single switch port interface for all configured VLAN classifier groups. show vlan classifier group interface <switch-port> Syntax Parameter Description <switch-port>...
VLAN C OMMANDS SHOW VLAN CLASSIFIER INTERFACE GROUP show vlan classifier interface group Overview Use this command to display information about all interfaces configured for a VLAN group or all the groups. show vlan classifier interface group [<1-16>] Syntax Parameter Description <1-16>...
VLAN C OMMANDS SHOW VLAN CLASSIFIER RULE show vlan classifier rule Overview Use this command to display information about all configured VLAN classifier rules or a specific rule. show vlan classifier rule [<1-256>] Syntax Parameter Description <1-256> VLAN classifier rule identifier Mode User Exec and Privileged Exec Usage...
VLAN C OMMANDS SHOW VLAN FILTER show vlan filter Overview Use this command to display information about the configured VLAN filters. VLAN filters apply access-maps (and therefore ACLs) to VLANs. This enables you to filter traffic ingressing specified VLANs. show vlan filter [<access-map-name>] Syntax Parameter Description...
VLAN C OMMANDS SHOW VLAN PRIVATE VLAN show vlan private-vlan Overview Use this command to display the private VLAN configuration and associations. show vlan private-vlan Syntax Mode User Exec and Privileged Exec Example To display the private VLAN configuration and associations, enter the command: awplus# show vlan private-vlan Output...
VLAN C OMMANDS SHOW VLAN STATISTICS show vlan statistics Overview Use this command to display the current configuration for either a specific VLAN statistics instance, or (by not specifying an instance) display all VLAN packet counter instances. show vlan statistics [name <instance-name>] Syntax Parameter Description...
VLAN C OMMANDS SWITCHPORT ACCESS VLAN switchport access vlan Overview Use this command to change the port-based VLAN of the current port. Use the no variant of this command to change the port-based VLAN of this port to the default VLAN, vlan1. Syntax switchport access vlan <vlan-id>...
VLAN C OMMANDS SWITCHPORT ENABLE VLAN switchport enable vlan Overview This command enables the VLAN on the port manually once disabled by certain actions, such as QSP (QoS Storm Protection) or EPSR (Ethernet Protection Switching Ring). Note that if the VID is not given, all disabled VLANs are re-enabled. switchport enable vlan [<1-4094>] Syntax Parameter...
VLAN C OMMANDS SWITCHPORT MODE ACCESS switchport mode access Overview 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. switchport mode access [ingress-filter {enable|disable}] Syntax Parameter...
VLAN C OMMANDS SWITCHPORT MODE PRIVATE VLAN switchport mode private-vlan Overview Use this command to make a Layer 2 port a private VLAN host port or a promiscuous port. Use the no variant of this command to remove the configuration. Syntax switchport mode private-vlan {host|promiscuous} no switchport mode private-vlan {host|promiscuous}...
VLAN C OMMANDS SWITCHPORT MODE PRIVATE VLAN TRUNK PROMISCUOUS switchport mode private-vlan trunk promiscuous Overview Use this command to enable a port in trunk mode to be promiscuous port for isolated VLANs. : Private VLAN trunk ports are not supported by the current AlliedWare Plus GVRP NOTE implementation.
Page 540
VLAN C OMMANDS SWITCHPORT MODE PRIVATE VLAN TRUNK PROMISCUOUS To create the isolated VLANs 2, 3 and 4 and then enable port1.1.2 in trunk Examples mode as a promiscuous port for these VLANs with the group ID of 3, use the following commands: awplus# configure terminal...
VLAN C OMMANDS SWITCHPORT MODE PRIVATE VLAN TRUNK SECONDARY switchport mode private-vlan trunk secondary Overview Use this command to enable a port in trunk mode to be a secondary port for isolated VLANs. : Private VLAN trunk ports are not supported by the current AlliedWare Plus GVRP NOTE implementation.
Page 542
VLAN C OMMANDS SWITCHPORT MODE PRIVATE VLAN TRUNK SECONDARY To create isolated private VLAN 2 and then enable port1.1.3 in trunk mode as Examples a secondary port for the this VLAN with the group ID of 3, use the following commands: awplus# configure terminal...
VLAN C OMMANDS SWITCHPORT MODE TRUNK switchport mode trunk Overview 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. switchport mode trunk [ingress-filter {enable|disable}] Syntax Parameter...
VLAN C OMMANDS SWITCHPORT PRIVATE VLAN HOST ASSOCIATION switchport private-vlan host-association Overview 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 variant of this command to remove the association.
VLAN C OMMANDS SWITCHPORT PRIVATE VLAN MAPPING switchport private-vlan mapping Overview Use this command to associate a primary VLAN and a set of secondary VLANs to a promiscuous port. Use the no variant of this to remove all the association of secondary VLANs to primary VLANs for a promiscuous port.
VLAN C OMMANDS SWITCHPORT TRUNK ALLOWED VLAN switchport trunk allowed vlan Overview 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. Use the no variant of this command to reset switching characteristics of a specified interface to negate a trunked configuration specified with switchport trunk allowed vlan command.
Page 547
VLAN C OMMANDS SWITCHPORT TRUNK ALLOWED VLAN Usage The all parameter sets the port to be a tagged member of all the VLANs configured on the device. The none parameter removes all VLANs from the port’s tagged member set. The add and remove parameters will add and remove VLANs to and from the port’s member set.
Page 548
VLAN C OMMANDS SWITCHPORT TRUNK ALLOWED VLAN Examples The following shows adding a single VLAN to the port’s member set. awplus# configure terminal awplus(config)# interface port1.1.2 awplus(config-if)# switchport trunk allowed vlan add 2 The following shows adding a range of VLANs to the port’s member set. awplus# configure terminal awplus(config)#...
VLAN C OMMANDS SWITCHPORT TRUNK NATIVE VLAN switchport trunk native vlan Overview Use this command to configure the native VLAN for this port. The native VLAN is used for classifying the incoming untagged packets. Use the none parameter with this command to remove the native VLAN from the port and set the acceptable frame types to vlan-tagged only.
VLAN C OMMANDS SWITCHPORT VLAN STACKING DOUBLE TAGGING switchport vlan-stacking (double tagging) Overview 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 Q in Q. Use no parameter with this command to disable VLAN stacking on an interface.
VLAN C OMMANDS SWITCHPORT VOICE DSCP switchport voice dscp Overview Use this command for a specific port to configure the Layer 3 DSCP value advertised when the transmission of LLDP-MED Network Policy TLVs for voice devices is enabled. When LLDP-MED capable IP phones receive this network policy information, they transmit voice data with the specified DSCP value.
VLAN C OMMANDS SWITCHPORT VOICE VLAN switchport voice vlan Overview Use this command to configure the Voice VLAN tagging advertised when the transmission of LLDP-MED Network Policy TLVs for voice endpoint devices is enabled. When LLDP-MED capable IP phones receive this network policy information, they transmit voice data with the specified tagging.
Page 553
VLAN C OMMANDS SWITCHPORT VOICE VLAN If the Voice VLAN details are to be assigned by RADIUS, then the RADIUS server must be configured to send the attribute “Egress-VLANID (56)” or “Egress-VLAN-Name (58)” in the RADIUS Accept message when authenticating a phone attached to this port.
Page 554
VLAN C OMMANDS SWITCHPORT VOICE VLAN Related egress-vlan-id Commands egress-vlan-name lldp med-tlv-select spanning-tree edgeport (RSTP and MSTP) switchport voice dscp switchport voice vlan priority show lldp C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
VLAN C OMMANDS SWITCHPORT VOICE VLAN PRIORITY switchport voice vlan priority Overview Use this command to configure the Layer 2 user priority advertised when the transmission of LLDP-MED Network Policy TLVs for voice devices is enabled. This is the priority in the User Priority field of the IEEE 802.1Q VLAN tag, also known as the Class of Service (CoS), or 802.1p priority.
VLAN C OMMANDS VLAN vlan Overview This command creates VLANs, assigns names to them, and enables or disables them. Disabling the VLAN causes all forwarding over the specified VLAN ID to cease. Enabling the VLAN allows forwarding of frames on the specified VLAN. The no variant of this command destroys the specified VLANs or returns their MTU to the default.
VLAN C OMMANDS VLAN ACCESS vlan access-map Overview Use this command to create a VLAN access-map and enter into VLAN access-map mode, so you can add ACLs to the map. You can use any IPv4 or IPv6 hardware ACLs. VLAN access-maps are used to attach ACLs to VLANs, and therefore to filter traffic as it ingresses VLANs.
VLAN C OMMANDS VLAN CLASSIFIER ACTIVATE vlan classifier activate Overview Use this command in Interface Configuration mode to associate a VLAN classifier group with the switch port. Use the no variant of this command to remove the VLAN classifier group from the switch port.
VLAN C OMMANDS VLAN CLASSIFIER GROUP vlan classifier group Overview Use this command to create a group of VLAN classifier rules. The rules must already have been created. Use the no variant of this command to delete a group of VLAN classifier rules. Syntax vlan classifier group <1-16>...
VLAN C OMMANDS VLAN CLASSIFIER RULE IPV vlan classifier rule ipv4 Overview Use this command to create an IPv4 subnet-based VLAN classifier rule and map it to a specific VLAN. Use the no variant of this command to delete the VLAN classifier rule.
VLAN C OMMANDS VLAN CLASSIFIER RULE PROTO vlan classifier rule proto Overview Use this command to create a protocol type-based VLAN classifier rule, and map it to a specific VLAN. See the published IANA EtherType IEEE 802 numbers here: www.iana.org/assignments/ieee-802-numbers/ieee-802-numbers.txt. Instead of a protocol name the decimal value of the protocol's EtherType can be entered.
Page 563
VLAN C OMMANDS VLAN CLASSIFIER RULE PROTO Parameter Description [decsyscomm|24583] DEC Systems Comms Arch protocol [g8bpqx25|2303] G8BPQ AX.25 protocol [ieeeaddrtrans|2561] Xerox IEEE802.3 PUP Address [ieeepup|2560] Xerox IEEE802.3 PUP protocol [ip|2048] IP protocol [ipv6|34525] IPv6 protocol [ipx|33079] IPX protocol [netbeui|61680] IBM NETBIOS/NETBEUI protocol [netbeui|61681] IBM NETBIOS/NETBEUI...
Page 564
VLAN C OMMANDS VLAN CLASSIFIER RULE PROTO awplus# configure terminal Example awplus(config)# vlan classifier rule 1 proto x25 encap ethv2 vlan 2 awplus(config)# vlan classifier rule 2 proto 512 encap ethv2 vlan 2 awplus(config)# vlan classifier rule 3 proto 2056 encap ethv2 vlan 2 awplus(config)# vlan classifier rule 4 proto 2054 encap ethv2...
VLAN C OMMANDS VLAN DATABASE vlan database Overview Use this command to enter the VLAN Configuration mode. vlan database Syntax Mode Global Configuration Usage Use this command to enter the VLAN configuration mode. You can then add or delete a VLAN, or modify its values. Example In the following example, note the change to VLAN configuration mode from Configure mode:...
VLAN C OMMANDS VLAN FILTER vlan filter Overview Use this command to apply a VLAN access-map to a list of VLANs. The switch uses the ACLs in the access-map to filter traffic ingressing those VLANs. See the ACL Feature Overview and Configuration Guide for more information, including information about the number of rules consumed by per-VLAN ACLs, and ACL processing order.
VLAN C OMMANDS VLAN STATISTICS vlan statistics Overview This command creates a VLAN packet counter instance, and enables you to add one or more ports to a defined counter instance. This command can only be applied to switch ports. You cannot apply it to aggregated links or eth ports. The no variant of this command enables the deletion of VLAN packet counter instances, or for removing one or more ports that are currently mapped to a counter instance.
Page 568
VLAN C OMMANDS VLAN STATISTICS To remove port1.1.4 from the packet counter instance named vlan2-data, use the commands: awplus(config)# interface port1.1.4 awplus(config-if)# no vlan statistics name vlan2-data To remove the remaining ports port1.1.1 to port1.1.3 from the packet counter instance named vlan2-data, use the following commands. Note that because there will then be no ports associated with the vlan2-data, this instance will be removed.
Spanning Tree Commands Introduction Overview This chapter provides an alphabetical reference for commands used to configure RSTP, STP or MSTP. For information about spanning trees, including configuration procedures, see the STP Feature Overview and Configuration Guide. Command List • “clear spanning-tree statistics”...
Page 570
PANNING OMMANDS • “show spanning-tree statistics instance” on page 601 • “show spanning-tree statistics instance interface” on page 602 • “show spanning-tree statistics interface” on page 604 • “show spanning-tree vlan range-index” on page 606 • “spanning-tree autoedge (RSTP and MSTP)”...
PANNING OMMANDS (RSTP MSTP) CLEAR SPANNING TREE DETECTED PROTOCOLS clear spanning-tree detected protocols (RSTP and MSTP) Overview Use this command to clear the detected protocols for a specific port, or all ports. Use this command in RSTP or MSTP mode only. clear spanning-tree detected protocols [interface <port>] Syntax Parameter...
PANNING OMMANDS (RSTP STP) DEBUG MSTP debug mstp (RSTP and STP) Overview 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.
Page 574
PANNING OMMANDS (RSTP STP) DEBUG MSTP command. The default terminal monitor filter will select and display these messages. Alternatively, the messages can be directed to any of the other log outputs by adding a filter for the MSTP application using log buffered (filter) command: awplus#...
PANNING OMMANDS (MSTP) INSTANCE PRIORITY instance priority (MSTP) Overview Use this command to set the priority for this device to become the root bridge for the specified MSTI (Multiple Spanning Tree Instance). Use this command for MSTP only. Use the no variant of this command to restore the root bridge priority of the device for the instance to the default.
Page 578
PANNING OMMANDS (MSTP) INSTANCE PRIORITY Related region (MSTP) Commands revision (MSTP) show spanning-tree mst config spanning-tree mst instance spanning-tree mst instance priority C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
PANNING OMMANDS (MSTP) INSTANCE VLAN instance vlan (MSTP) Overview 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). 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 580
PANNING OMMANDS (MSTP) INSTANCE VLAN Related region (MSTP) Commands revision (MSTP) show spanning-tree mst config spanning-tree mst instance vlan C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
PANNING OMMANDS (MSTP) REGION region (MSTP) Overview 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 variant of this command to remove this region name and reset it to the default.
PANNING OMMANDS (MSTP) REVISION revision (MSTP) Overview 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 <revision-number> <0-65535> Revision number. Default The default of revision number is 0. Mode MST Configuration Usage...
PANNING OMMANDS SHOW DEBUGGING MSTP show debugging mstp Overview Use this command to show the MSTP debugging options set. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide. Syntax show debugging mstp Mode User Exec and Privileged Exec mode...
PANNING OMMANDS SHOW SPANNING TREE show spanning-tree Overview 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. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
Page 585
PANNING OMMANDS SHOW SPANNING TREE Output Figure 16-2: Example output from show spanning-tree in RSTP mode 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...
Page 586
PANNING OMMANDS SHOW SPANNING TREE awplus#show spanning-tree 13:03:34 awplus IMISH[13974]: show spanning-tree % Default: Bridge up - Spanning Tree Enabled - topology change detected % Default: Root Path Cost 0 - Root Port 0 - Bridge Priority 32768 % Default: Forward Delay 15 - Hello Time 2 - Max Age 20 - Transmit Hold Count 6 % Default: Root Id 8000eccd6d031123...
PANNING OMMANDS SHOW SPANNING TREE BRIEF show spanning-tree brief Overview Use this command to display a summary of spanning tree status information on all ports. Use this command for RSTP, MSTP or STP. show spanning-tree brief Syntax Parameter Description brief A brief summary of spanning tree information.
PANNING OMMANDS SHOW SPANNING TREE MST show spanning-tree mst Overview This command displays bridge-level information about the CIST and VLAN to MSTI mappings. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
PANNING OMMANDS SHOW SPANNING TREE MST CONFIG show spanning-tree mst config Overview Use this command to display MSTP configuration identifier for the device. show spanning-tree mst config Syntax Mode User Exec, Privileged Exec and Interface Configuration Usage The region name, the revision number, and the digest of the VLAN to MSTI configuration table must be the same on all devices that are intended to be in the same MST region.
PANNING OMMANDS SHOW SPANNING TREE MST DETAIL show spanning-tree mst detail Overview This command displays detailed information about each instance, and all interfaces associated with that particular instance. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
Page 591
PANNING OMMANDS SHOW SPANNING TREE MST DETAIL port1.1.3: Port 5003 - Id 838b - Role Disabled - State Discarding port1.1.3: Designated External Path Cost 0 -Internal Path Cost 0 port1.1.3: Configured Path Cost 20000000 - Add type Explicit ref count 1 port1.1.3: Designated Port Id 838b - CIST Priority 128 -...
PANNING OMMANDS SHOW SPANNING TREE MST DETAIL INTERFACE show spanning-tree mst detail interface Overview This command displays detailed information about the specified switch port, and the MST instances associated with it. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
Page 593
PANNING OMMANDS SHOW SPANNING TREE MST DETAIL INTERFACE port1.1.2: No portfast configured - Current portfast off port1.1.2: portfast bpdu-guard default - Current portfast bpdu-guard off port1.1.2: portfast bpdu-filter default - Current portfast bpdu-filter off port1.1.2: no root guard configured - Current root guard off port1.1.2: Configured Link Type point-to-point - Current shared...
PANNING OMMANDS SHOW SPANNING TREE MST INSTANCE show spanning-tree mst instance Overview 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.
PANNING OMMANDS SHOW SPANNING TREE MST INSTANCE INTERFACE show spanning-tree mst instance interface Overview This command displays detailed information for the specified MST (Multiple Spanning Tree) instance, and the specified switch port associated with that MST instance. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
PANNING OMMANDS SHOW SPANNING TREE MST INTERFACE show spanning-tree mst interface Overview This command displays the number of instances created, and VLANs associated with it for the specified switch port. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
Page 597
PANNING OMMANDS SHOW SPANNING TREE MST DETAIL INTERFACE show spanning-tree mst detail interface Overview This command displays detailed information about the specified switch port, and the MST instances associated with it. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
Page 598
PANNING OMMANDS SHOW SPANNING TREE MST DETAIL INTERFACE port1.1.2: No portfast configured - Current portfast off port1.1.2: portfast bpdu-guard default - Current portfast bpdu-guard off port1.1.2: portfast bpdu-filter default - Current portfast bpdu-filter off port1.1.2: no root guard configured - Current root guard off port1.1.2: Configured Link Type point-to-point - Current shared...
PANNING OMMANDS SHOW SPANNING TREE STATISTICS show spanning-tree statistics Overview This command displays BPDU (Bridge Protocol Data Unit) statistics for all spanning-tree instances, and all switch ports associated with all spanning-tree instances. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
Page 600
PANNING OMMANDS SHOW SPANNING TREE STATISTICS % STATUS of Port Timers % --------------------- % Hello Time Configured : 2 % Hello timer : INACTIVE % Hello Time Value : 0 % Forward Delay Timer : INACTIVE % Forward Delay Timer Value : 0...
PANNING OMMANDS SHOW SPANNING TREE STATISTICS INSTANCE show spanning-tree statistics instance Overview This command displays BPDU (Bridge Protocol Data Unit) statistics for the specified MST (Multiple Spanning Tree) instance, and all switch ports associated with that MST instance. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
PANNING OMMANDS SHOW SPANNING TREE STATISTICS INSTANCE INTERFACE show spanning-tree statistics instance interface Overview This command displays BPDU (Bridge Protocol Data Unit) statistics for the specified MST (Multiple Spanning Tree) instance and the specified switch port associated with that MST instance. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
Page 603
PANNING OMMANDS SHOW SPANNING TREE STATISTICS INSTANCE INTERFACE Output Figure 16-15: Example output from show spanning-tree statistics instance interface awplus#sh spanning-tree statistics interface port1.1.2 instance 1 Spanning Tree Enabled for Instance : 1 ================================== % INST_PORT port1.1.2 Information & Statistics % ----------------------------------------...
PANNING OMMANDS SHOW SPANNING TREE STATISTICS INTERFACE show spanning-tree statistics interface Overview This command displays BPDU (Bridge Protocol Data Unit) statistics for the specified switch port, and all MST instances associated with that switch port. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
Page 605
PANNING OMMANDS SHOW SPANNING TREE STATISTICS INTERFACE % PORT Based Information & Statistics % ----------------------------------- % Config Bpdu's xmitted : 0 % Config Bpdu's received : 0 % TCN Bpdu's xmitted : 0 % TCN Bpdu's received : 0 % Forward Trans Count : 0...
PANNING OMMANDS SHOW SPANNING TREE VLAN RANGE INDEX show spanning-tree vlan range-index Overview Use this command to display information about MST (Multiple Spanning Tree) instances and the VLANs associated with them including the VLAN range-index value for the device. show spanning-tree vlan range-index Syntax Mode Privileged Exec...
PANNING OMMANDS (RSTP MSTP) SPANNING TREE AUTOEDGE spanning-tree autoedge (RSTP and MSTP) Overview 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.
PANNING OMMANDS SPANNING TREE BPDU spanning-tree bpdu Overview Use this command to configure BPDU (Bridge Protocol Data Unit) discarding or forwarding, when STP is disabled on the switch. This may be needed for correct STP operation in complex networks. There is no no variant for this command. Instead, apply the discard parameter to reset it back to the default then re-enable STP with the command spanning-tree enable.
Page 609
PANNING OMMANDS SPANNING TREE BPDU Examples To enable STP BPDU discard in Global Configuration mode with STP disabled, which discards all ingress STP BPDU frames, enter the commands: awplus# configure terminal awplus(config)# no spanning-tree rstp enable awplus(config)# spanning-tree bpdu discard To enable STP BPDU forward in Global Configuration mode with STP disabled, which forwards any ingress STP BPDU frames to all ports regardless of any VLAN membership, enter the commands:...
PANNING OMMANDS (MSTP) SPANNING TREE CISCO INTEROPERABILITY spanning-tree cisco-interoperability (MSTP) Overview Use this command to enable/disable Cisco-interoperability for MSTP. Use this command for MSTP only. Syntax spanning-tree cisco-interoperability {enable|disable} Parameter Description enable Enable Cisco interoperability for MSTP. disable Disable Cisco interoperability for MSTP. Default If this command is not used, Cisco interoperability is disabled.
PANNING OMMANDS (RSTP MSTP) SPANNING TREE EDGEPORT spanning-tree edgeport (RSTP and MSTP) Overview 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 (STP) command, but the configuration displays differently in the output of some show commands.
PANNING OMMANDS SPANNING TREE ENABLE spanning-tree enable Overview Use this command in Global Configuration mode to enable the specified spanning tree protocol for all switch ports. Note that this must be the spanning tree protocol that is configured on the device by the spanning-tree mode command.
Page 613
PANNING OMMANDS SPANNING TREE ENABLE To disable RSTP in Global Configuration mode, enter the below commands: awplus# configure terminal awplus(config)# no spanning-tree rstp enable Related spanning-tree mode Commands C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
PANNING OMMANDS SPANNING TREE ERRDISABLE TIMEOUT ENABLE spanning-tree errdisable-timeout enable Overview 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. Use the no variant of this command to disable the errdisable-timeout facility.
PANNING OMMANDS SPANNING TREE ERRDISABLE TIMEOUT INTERVAL spanning-tree errdisable-timeout interval Overview 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>...
PANNING OMMANDS SPANNING TREE FORCE VERSION spanning-tree force-version Overview Use this command in Interface Configuration mode for a switch port interface only to force the protocol version for the switch port. Use this command for RSTP or MSTP only. spanning-tree force-version <version> Syntax no spanning-tree force-version Parameter...
PANNING OMMANDS SPANNING TREE FORWARD TIME spanning-tree forward-time Overview Use this command to set the forward delay value. Use the no variant of this command to reset the forward delay value to the default setting of 15 seconds. 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.
PANNING OMMANDS SPANNING TREE GUARD ROOT spanning-tree guard root Overview Use this command in Interface Configuration mode for a switch port only to enable the Root Guard feature for the switch port. The root guard feature disables reception of superior BPDUs. You can use this command for RSTP, STP or MSTP. Use the no variant of this command to disable the root guard feature for the port.
PANNING OMMANDS SPANNING TREE HELLO TIME spanning-tree hello-time Overview Use this command to set the hello-time. This sets the time in seconds between the transmission of device spanning tree configuration information when the device is the Root Bridge of the spanning tree or is trying to become the Root Bridge. Use this command for RSTP, STP or MSTP.
PANNING OMMANDS SPANNING TREE LINK TYPE spanning-tree link-type Overview Use this command in Interface Configuration mode for a switch port interface only 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 variant of this command to return the port to the default link type.
PANNING OMMANDS SPANNING TREE MAX spanning-tree max-age Overview 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 device before it is discarded. Use this command for RSTP, STP or MSTP. Use the no variant of this command to restore the default of max-age.
PANNING OMMANDS (MSTP) SPANNING TREE MAX HOPS spanning-tree max-hops (MSTP) Overview 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. Use the no variant of this command to restore the default. Use this command for MSTP only.
PANNING OMMANDS SPANNING TREE MODE spanning-tree mode Overview Use this command to change the spanning tree protocol mode on the device. The spanning tree protocol mode on the device can be configured to either STP, RSTP or MSTP. spanning-tree mode {stp|rstp|mstp} Syntax Default The default spanning tree protocol mode on the device is RSTP.
PANNING OMMANDS SPANNING TREE MST CONFIGURATION spanning-tree mst configuration Overview Use this command to enter the MST Configuration mode to configure the Multiple Spanning-Tree Protocol. spanning-tree mst configuration Syntax Mode Global Configuration Examples The following example uses this command to enter MST Configuration mode. Note the change in the command prompt.
PANNING OMMANDS SPANNING TREE MST INSTANCE spanning-tree mst instance Overview 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 (MSTP) command.
PANNING OMMANDS SPANNING TREE MST INSTANCE PATH COST spanning-tree mst instance path-cost Overview Use this command to set the cost of a path associated with a switch port, for the specified MSTI. This specifies the switch port’s contribution to the cost of a path to the MSTI regional root via that port.
Page 627
PANNING OMMANDS SPANNING TREE MST INSTANCE PATH COST To return the path cost to its default value on instance 3, use the commands: awplus# configure terminal awplus(config)# interface port1.1.2 awplus(config-if)# no spanning-tree mst instance 3 path-cost Related instance vlan (MSTP) Commands spanning-tree mst instance spanning-tree mst instance priority...
PANNING OMMANDS SPANNING TREE MST INSTANCE PRIORITY spanning-tree mst instance priority Overview Use this command in Interface Configuration mode for a switch port interface only to set the port priority for an MST instance (MSTI). Use the no variant of this command to restore the default priority value (128). Syntax spanning-tree mst instance <instance-id>...
PANNING OMMANDS SPANNING TREE MST INSTANCE RESTRICTED ROLE spanning-tree mst instance restricted-role Overview Use this command in Interface Configuration mode for a switch port interface only to enable the restricted role for an MSTI (Multiple Spanning Tree Instance) on a switch port.
Page 630
PANNING OMMANDS SPANNING TREE MST INSTANCE RESTRICTED ROLE Related instance vlan (MSTP) Commands spanning-tree priority (port priority) spanning-tree mst instance spanning-tree mst instance path-cost spanning-tree mst instance restricted-tcn C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
PANNING OMMANDS SPANNING TREE MST INSTANCE RESTRICTED spanning-tree mst instance restricted-tcn Overview Use this command to prevent a switch port from propagating received topology change notifications and topology changes to other switch ports. This is named restricted TCN (Topology Change Notification). A TCN is a simple Bridge Protocol Data Unit (BPDU) that a bridge sends out to its root port to signal a topology change.
PANNING OMMANDS SPANNING TREE PATH COST spanning-tree path-cost Overview Use this command in Interface Configuration mode for a switch port interface only 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.
PANNING OMMANDS (STP) SPANNING TREE PORTFAST spanning-tree portfast (STP) Overview Use this command in Interface Configuration mode for a switch port interface only to set a port as an edge-port. The portfast feature enables a port to rapidly move to the forwarding state, without having first to pass through the intermediate spanning tree states.
Page 634
PANNING OMMANDS (STP) SPANNING TREE PORTFAST awplus# configure terminal Example awplus(config)# interface port1.1.2 awplus(config-if)# spanning-tree portfast Related spanning-tree edgeport (RSTP and MSTP) Commands show spanning-tree spanning-tree portfast bpdu-filter spanning-tree portfast bpdu-guard C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™...
PANNING OMMANDS SPANNING TREE PORTFAST BPDU FILTER spanning-tree portfast bpdu-filter Overview This command sets the bpdu-filter feature and applies a filter to any BPDUs (Bridge Protocol Data Units) received. Enabling this feature ensures that configured ports will not transmit any BPDUs and will ignore (filter out) any BPDUs received. BPDU Filter is not enabled on a port by default.
Page 636
PANNING OMMANDS SPANNING TREE PORTFAST BPDU FILTER To enable STP BPDU filtering in Interface Configuration mode, enter the commands: awplus# configure terminal awplus(config)# interface port1.1.2 awplus(config-if)# spanning-tree portfast bpdu-filter enable Related spanning-tree edgeport (RSTP and MSTP) Commands show spanning-tree spanning-tree portfast (STP) spanning-tree portfast bpdu-guard C613-50188-01 Rev B Command Reference for SwitchBlade®...
PANNING OMMANDS SPANNING TREE PORTFAST BPDU GUARD spanning-tree portfast bpdu-guard Overview This command applies a BPDU (Bridge Protocol Data Unit) guard to the port. A port with the bpdu-guard feature enabled will block all traffic (BPDUs and user data), if it starts receiving BPDUs.
Page 638
PANNING OMMANDS SPANNING TREE PORTFAST BPDU GUARD Use the show spanning-tree command to display the device and port configurations for the BPDU Guard feature. It shows both the administratively configured and currently running values of bpdu-guard. Example To enable STP BPDU guard in Global Configuration mode, enter the below commands: awplus# configure terminal...
PANNING OMMANDS SPANNING TREE PRIORITY BRIDGE PRIORITY spanning-tree priority (bridge priority) Overview Use this command to set the bridge priority for the device. A lower priority value indicates a greater likelihood of the device becoming the root bridge. Use this command for RSTP, STP or MSTP. When MSTP mode is configured, this will apply to the CIST.
PANNING OMMANDS SPANNING TREE PRIORITY PORT PRIORITY spanning-tree priority (port priority) Overview Use this command in Interface Configuration mode for a switch port interface only to set the port priority for port. A lower priority value indicates a greater likelihood of the port becoming part of the active topology.
PANNING OMMANDS SPANNING TREE RESTRICTED ROLE spanning-tree restricted-role Overview Use this command in Interface Configuration mode for a switch port interface only to restrict the port from becoming a root port. Use the no variant of this command to disable the restricted role functionality. Syntax spanning-tree restricted-role no spanning-tree restricted-role...
PANNING OMMANDS SPANNING TREE RESTRICTED spanning-tree restricted-tcn Overview Use this command in Interface Configuration mode for a switch port interface only to prevent TCN (Topology Change Notification) BPDUs (Bridge Protocol Data Units) from being sent on a port. If this command is enabled, after a topology change a bridge is prevented from sending a TCN to its designated bridge.
PANNING OMMANDS SPANNING TREE TRANSMIT HOLDCOUNT spanning-tree transmit-holdcount Overview Use this command to set the maximum number of BPDU transmissions that are held back. Use the no variant of this command to restore the default transmit hold-count value. Syntax spanning-tree transmit-holdcount no spanning-tree transmit-holdcount Default Transmit hold-count default is 3.
PANNING OMMANDS UNDEBUG MSTP undebug mstp Overview This command applies the functionality of the no debug mstp (RSTP and STP) command. C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
Page 645
Link Aggregation Commands Introduction Overview This chapter provides an alphabetical reference of commands used to configure a static channel group (static aggregator) and dynamic channel group (LACP channel group, etherchannel or LACP aggregator). Link aggregation is also sometimes referred to as channeling. : AlliedWare Plus™...
Page 646
GGREGATION OMMANDS • “lacp port-priority” on page 652 • “lacp system-priority” on page 653 • “lacp timeout” on page 654 • “platform load-balancing” on page 656 • “show debugging lacp” on page 657 • “show diagnostic channel-group” on page 658 •...
GGREGATION OMMANDS CHANNEL GROUP channel-group Overview Use this command to either create a new dynamic channel group while at the same time adding a port to it, or to add a port to an existing dynamic channel group. Note that you must also set the LACP mode to be either active or passive. You can create up to 32 dynamic (LACP) channel groups (and up to 96 static channel groups).
Page 648
GGREGATION OMMANDS CHANNEL GROUP Examples To add port1.1.8 to a newly created LACP channel group 2, use the following commands: awplus# configure terminal awplus(config)# interface port1.1.8 awplus(config-if)# channel-group 2 mode active To remove device port1.1.8 from any created LACP channel groups, use the following commands: awplus# configure terminal...
GGREGATION OMMANDS DEBUG LACP debug lacp Overview Use this command to enable all LACP troubleshooting functions. Use the no variant of 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.
GGREGATION OMMANDS LACP GLOBAL PASSIVE MODE ENABLE lacp global-passive-mode enable Overview Use this command to enable LACP channel-groups to dynamically self-configure when they are connected to another device that has LACP channel-groups configured with Active Mode. lacp global-passive-mode enable Syntax no lacp global-passive-mode enable Default Enabled...
GGREGATION OMMANDS LACP PORT PRIORITY lacp port-priority Overview Use this command to set the priority of a device port. Ports are selected for aggregation based on their priority, with the higher priority (numerically lower) ports selected first. Use the no variant of this command to reset the priority of port to the default. Syntax lacp port-priority <1-65535>...
GGREGATION OMMANDS LACP SYSTEM PRIORITY lacp system-priority Overview Use this command to set the system priority of a local system. This is used in determining the system responsible for resolving conflicts in the choice of aggregation groups. Use the no variant of this command to reset the system priority of the local system to the default.
GGREGATION OMMANDS LACP TIMEOUT lacp timeout Overview 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. lacp timeout {short|long} Syntax Parameter Description timeout Number of seconds before invalidating a received LACP data unit (DU).
Page 655
GGREGATION OMMANDS LACP TIMEOUT The following commands set the LACP short timeout for 1 second on port 1.1.2. awplus# configure terminal awplus(config)# interface port1.1.2 awplus(config-if)# lacp timeout short C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
Page 656
GGREGATION OMMANDS PLATFORM LOAD BALANCING platform load-balancing Overview This command selects which address fields are used as inputs into the load balancing algorithm for aggregated links. The output from this algorithm is used to select which individual path a given packet will traverse within an aggregated link.
GGREGATION OMMANDS SHOW DEBUGGING LACP show debugging lacp Overview Use this command to display the LACP debugging option set. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide. Syntax show debugging lacp Mode User Exec and Privileged Exec...
Overview This command displays dynamic and static channel group interface status information. The output of this command is useful for Allied Telesis authorized service personnel for diagnostic purposes. For information on filtering and saving command output, see the “Getting Started...
Page 659
GGREGATION OMMANDS SHOW DIAGNOSTIC CHANNEL GROUP Channel Group Info based on HW: Note: Pos - position in hardware table Only entries from first device are displayed. ------------------------------------------------------------- Interface IfIndex Member port IfIndex Active Pos ------------------------------------------------------------- 4503 N/a 4601 N/a ...
GGREGATION OMMANDS SHOW ETHERCHANNEL show etherchannel Overview Use this command to display information about a LACP channel specified by the channel group number. The command output also shows the thrash limiting status. If thrash limiting is detected and the action parameter of the thrash-limiting command is set to vlan-disable, the output will also show the VLANs on which thrashing is detected.
GGREGATION OMMANDS SHOW ETHERCHANNEL DETAIL show etherchannel detail Overview Use this command to display detailed information about all LACP channels. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide, which is available on our website at alliedtelesis.com.
GGREGATION OMMANDS SHOW ETHERCHANNEL SUMMARY show etherchannel summary Overview Use this command to display a summary of all LACP channels. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide, which is available on our website at alliedtelesis.com.
GGREGATION OMMANDS SHOW LACP SYS show lacp sys-id Overview Use this command to display the LACP system ID and priority. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide, which is available on our website at alliedtelesis.com.
GGREGATION OMMANDS SHOW LACP COUNTER show lacp-counter Overview Use this command to display the packet traffic on all ports of all present LACP aggregators, or a given LACP aggregator. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
GGREGATION OMMANDS SHOW PORT ETHERCHANNEL show port etherchannel Overview Use this command to show LACP details of the device port specified. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide, which is available on our website at alliedtelesis.com.
GGREGATION OMMANDS SHOW STATIC CHANNEL GROUP show static-channel-group Overview 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 action parameter of the thrash-limiting command is set to...
GGREGATION OMMANDS STATIC CHANNEL GROUP static-channel-group Overview Use this command to create a static channel group, or add a member port to an existing static channel group. Static channel groups are also known as static aggregators. You can create up to 96 static channel groups (and up to 32 dynamic channel groups).
Page 668
GGREGATION OMMANDS STATIC CHANNEL GROUP To reference static channel group 2 as an interface, use the commands: awplus# configure terminal awplus(config)# interface sa2 awplus(config-if)# To make it possible to use QoS Storm Protection on static channel group 2 on port1.1.8, with an ACL named “test-acl”, use the commands: awplus# configure terminal awplus(config)#...
GGREGATION OMMANDS UNDEBUG LACP undebug lacp Overview This command applies the functionality of the no debug lacp command. C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
GVRP Commands Introduction Overview With GVRP enabled the switch can exchange VLAN configuration information with other GVRP enabled switches. VLANs can be dynamically created and managed through trunk ports. • There is a limit of 400 VLANs supported by the AlliedWare Plus GVRP implementation.
Page 671
GVRP C OMMANDS • “show gvrp timer” on page 685 C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
GVRP C OMMANDS CLEAR GVRP STATISTICS clear gvrp statistics Overview Use this command to clear the GVRP statistics for all switchports, or for a specific switchport. clear gvrp statistics {all|<interface>} Syntax Parameter Description Specify all switchports to clear GVRP statistics. <interface>...
GVRP C OMMANDS DEBUG GVRP debug gvrp Overview Use this command to debug GVRP packets and commands, sending output to the console. Use the no variant of this command to turn off debugging for GVRP packets and commands. Syntax debug gvrp {all|cli|event|packet} no debug gvrp {all|cli|event|packet} Parameter Description...
GVRP C OMMANDS DEBUG GVRP Related show debugging gvrp Commands terminal monitor C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
GVRP C OMMANDS GVRP INTERFACE gvrp (interface) Overview Use this command to enable GVRP for switchport interfaces. Use the no variant of this command to disable GVRP for switchport interfaces. Syntax gvrp no gvrp Mode Interface Configuration (for switchport interfaces). Default Disabled by default.
GVRP C OMMANDS GVRP DYNAMIC VLAN CREATION gvrp dynamic-vlan-creation Overview Use this command to enable dynamic VLAN creation globally for the switch. Use the no variant of this command to disable dynamic VLAN creation globally for the switch. Syntax gvrp dynamic-vlan-creation no gvrp dynamic-vlan-creation Mode Global Configuration...
GVRP C OMMANDS GVRP ENABLE GLOBAL gvrp enable (global) Overview Use this command to enable GVRP globally for the switch. Use the no variant of this command to disable GVRP globally for the switch. Syntax gvrp enable no gvrp enable Mode Global Configuration Default...
GVRP C OMMANDS GVRP REGISTRATION gvrp registration Overview Use this command to set GVRP registration to normal, fixed, and forbidden registration modes. Use the no variant of this command to disable GVRP registration. Syntax gvrp registration {normal|fixed|forbidden} no gvrp registration {normal|fixed|forbidden} Parameter Description normal...
GVRP C OMMANDS GVRP TIMER gvrp timer Overview Use this command to set GVRP timers in Interface Configuration mode for a given interface. Use the no variant of this command to reset the GVRP timers to the defaults specified in the table below. Syntax gvrp timer {join <timer-value>|leave <timer-value>|leaveall <timer-value>}...
GVRP C OMMANDS GVRP TIMER To reset the GVRP join timer to its default of 20 hundredths of a second for interface port1.1.1, enter the commands: awplus# configure terminal awplus(config)# interface port1.1.1 awplus(config-if)# no gvrp timer join Related show gvrp timer Commands C613-50188-01 Rev B Command Reference for SwitchBlade®...
GVRP C OMMANDS SHOW DEBUGGING GVRP show debugging gvrp Overview Use this command to display the GVRP debugging option set. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide. Syntax show debugging gvrp Mode...
GVRP C OMMANDS SHOW GVRP CONFIGURATION show gvrp configuration Overview Use this command to display GVRP configuration data for a switch. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
GVRP C OMMANDS SHOW GVRP MACHINE show gvrp machine Overview Use this command to display the state machine for GVRP. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide. Syntax show gvrp machine Mode...
GVRP C OMMANDS SHOW GVRP STATISTICS show gvrp statistics Overview Use this command to display a statistical summary of GVRP information for the switch. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
GVRP C OMMANDS SHOW GVRP TIMER show gvrp timer Overview Use this command to display data for the GVRP timers set with the gvrp timer command. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
Part 3: Layer 3 Switching C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
IP Addressing and Protocol Commands Introduction Overview This chapter provides an alphabetical reference of commands used to configure various IP features, including the following protocols: • Address Resolution Protocol (ARP) • ICMP Router Discovery Advertisements (IRDP) For more information, see the IP Feature Overview and Configuration Guide.
Page 688
IP A DDRESSING AND ROTOCOL OMMANDS • “ip irdp broadcast” on page 719 • “ip irdp holdtime” on page 720 • “ip irdp lifetime” on page 721 • “ip irdp maxadvertinterval” on page 722 • “ip irdp minadvertinterval” on page 724 •...
IP A DDRESSING AND ROTOCOL OMMANDS AGING TIMEOUT arp-aging-timeout Overview This command sets a timeout period on dynamic ARP entries associated with a specific interface. If your device stops receiving traffic for the host specified in a dynamic ARP entry, it deletes the ARP entry from the ARP cache after this timeout is reached.
IP A DDRESSING AND ROTOCOL OMMANDS DISPARITY arp-mac-disparity Overview Use this command to enable the switch to support services like Microsoft Network Load Balancing (MS-NLB). Such services use ARP with disparate MAC addresses to ensure that packets destined for a server cluster virtual address are sent to all servers in the cluster. Disparate MAC addresses mean that the MAC address in the “sender hardware address”...
Page 691
IP A DDRESSING AND ROTOCOL OMMANDS DISPARITY For example, to flood only port1.1.1 to port1.1.3, use the commands: awplus# configure terminal awplus(config)# interface vlan2 awplus(config-if)# arp 10.10.1.100 010e.11ff.2222 port1.1.1-port1.1.3 Usage, multicast Multicast-IGMP mode is enabled by using the command arp-mac-disparity igmp mode multicast-igmp.
Page 692
IP A DDRESSING AND ROTOCOL OMMANDS DISPARITY To disable support for MS-NLB in unicast mode on interface vlan2, use the following commands: awplus# configure terminal awplus(config)# interface vlan2 awplus(config-if)# no arp-mac-disparity unicast Related arp (IP address MAC) Commands clear arp-cache show arp C613-50188-01 Rev B Command Reference for SwitchBlade®...
IP A DDRESSING AND ROTOCOL OMMANDS MAC) ADDRESS arp (IP address MAC) Overview 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.
Page 694
IP A DDRESSING AND ROTOCOL OMMANDS MAC) ADDRESS Usage One use of this command is to limit packet flooding when using services like Microsoft Network Load Balancing (MS-NLB). With such services, packets destined for server cluster virtual address must be sent to all servers in the cluster. The server cluster can operate in multicast mode, in which it uses a multicast MAC address.
IP A DDRESSING AND ROTOCOL OMMANDS ARP LOG arp log Overview This command enables the logging of dynamic and static ARP entries in the ARP cache. The ARP cache contains mappings of device ports, VLAN IDs, and IP addresses to physical MAC addresses for hosts. This command can display the MAC addresses in the ARP log either using the notation HHHH.HHHH.HHHH, or using the IEEE standard hexadecimal notation (HH-HH-HH-HH-HH-HH).
Page 696
IP A DDRESSING AND ROTOCOL OMMANDS ARP LOG To enable ARP logging and specify that the MAC address in the log message is displayed in the standard IEEE format hexadecimal notation (HH-HH-HH-HH-HH-HH), use the following commands: awplus# configure terminal awplus(config)# arp log mac-address-format ieee To leave ARP logging enabled, but stop using HH-HH-HH-HH-HH-HH format and use HHHH.HHHH.HHHH format instead, use the following commands:...
Page 697
IP A DDRESSING AND ROTOCOL OMMANDS ARP LOG The following table lists the parameters in output of the show log | include ARP_LOG command. The ARP log message format is: <date> <time> <severity> <hostname> <program-name> ARP_LOG <port-number> <vid> <operation> <MAC> <IP> Table 19-1: Parameters in the output from show log | include ARP_LOG Parameter Description...
IP A DDRESSING AND ROTOCOL OMMANDS ARP OPPORTUNISTIC arp opportunistic-nd Overview Use this command to enable opportunistic neighbor discovery for the global ARP cache. This command changes the behavior for unsolicited ARP packet forwarding on the device. When using VRF-lite, you can use this command to enable opportunistic neighbor discovery for a named VRF instance.
Page 699
IP A DDRESSING AND ROTOCOL OMMANDS ARP OPPORTUNISTIC Example To enable opportunistic neighbor discovery for the VRF instance ‘blue’, enter: (VRF-lite) awplus# configure terminal awplus(config)# arp opportunistic-nd vrf blue To disable opportunistic neighbor discovery for the VRF instance ‘blue’, enter: awplus# configure terminal awplus(config)#...
IP A DDRESSING AND ROTOCOL OMMANDS REPLY DMAC arp-reply-bc-dmac Overview Use this command to allow processing of ARP replies that arrive with a broadcast destination MAC (ffff.ffff.ffff). This makes neighbors reachable if they send ARP responses that contain a broadcast destination MAC. Use the no variant of this command to turn off processing of ARP replies that arrive with a broadcast destination MAC.
IP A DDRESSING AND ROTOCOL OMMANDS CLEAR ARP CACHE clear arp-cache Overview This command deletes dynamic ARP entries from the ARP cache. You can optionally specify the IPv4 address of an ARP entry to be cleared from the ARP cache. When running VRF-lite, this command deletes dynamic ARP entries either from the ARP cache of a specific VRF instance, or from the ARP cache of the Global VRF instance.
IP A DDRESSING AND ROTOCOL OMMANDS CLEAR ARP CACHE When running VRF-lite, to clear the dynamic ARP entries from the global VRF-lite and all VRF instances, use the command: awplus# clear arp-cache Related arp-mac-disparity Commands arp (IP address MAC) show arp C613-50188-01 Rev B Command Reference for SwitchBlade®...
IP A DDRESSING AND ROTOCOL OMMANDS DEBUG IP PACKET INTERFACE debug ip packet interface Overview The debug ip packet interface command enables IP packet debug and is controlled by the terminal monitor command. If the optional icmp keyword is specified then ICMP packets are shown in the output.
Page 704
IP A DDRESSING AND ROTOCOL OMMANDS DEBUG IP PACKET INTERFACE To turn on ARP packet debugging on vlan1, use the command: Examples awplus# debug ip packet interface vlan1 arp To turn on all packet debugging on all interfaces on the device, use the command: awplus# debug ip packet interface all To turn on TCP packet debugging on vlan1 and IP address 192.168.2.4, use...
IP A DDRESSING AND ROTOCOL OMMANDS DEBUG IP IRDP debug ip irdp Overview This command enables debugging of ICMP Router Discovery Protocol (IRDP) events and messages on your device. IRDP debugging is disabled by default. The no variant of this command disables IRDP debugging. Negating any packet debug mode will switch detail off.
IP A DDRESSING AND ROTOCOL OMMANDS (IP A IP ADDRESS DDRESSING AND ROTOCOL ip address (IP Addressing and Protocol) Overview This command sets a static IP address on an interface. The no variant of this command removes the IP address from the interface. You cannot remove the primary address when a secondary address is present.
Page 707
IP A DDRESSING AND ROTOCOL OMMANDS (IP A IP ADDRESS DDRESSING AND ROTOCOL To add the IP address 10.10.11.50/24 to the local loopback interface lo, use the following commands: awplus# configure terminal awplus(config)# interface lo awplus(config-if)# ip address 10.10.11.50/24 Related interface (to configure) Commands show ip interface...
IP A DDRESSING AND ROTOCOL OMMANDS IP DIRECTED BROADCAST ip directed-broadcast Overview Use this command to enable flooding of directed broadcast packets into a directly connected subnet. If this command is configured on a VLAN interface, then directed broadcasts received on other VLAN interfaces, destined for the subnet on this VLAN, will be flooded to the subnet broadcast address of this VLAN.
Page 709
IP A DDRESSING AND ROTOCOL OMMANDS IP DIRECTED BROADCAST Related ip forward-protocol udp Commands ip helper-address show running-config C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
IP A DDRESSING AND ROTOCOL OMMANDS IP FORWARDING ip forwarding Overview This command enables IP forwarding on your device. When enabled, your device routes IP packets. The no variant of this command disables IP forwarding on your device. Even when IP forwarding is not enabled, the device can still work as an IP host;...
IP A DDRESSING AND ROTOCOL OMMANDS IP FORWARD PROTOCOL UDP ip forward-protocol udp Overview This command enables you to control which UDP broadcasts will be forwarded to the helper address(es). A UDP broadcast will only be forwarded if the destination UDP port number in the packet matches one of the port numbers specified using this command.
Page 712
IP A DDRESSING AND ROTOCOL OMMANDS IP FORWARD PROTOCOL UDP To delete a UDP port from the UDP ports that the device forwards, use the following commands: awplus# configure terminal awplus(config)# no ip forward-protocol udp <port> Related ip helper-address Commands ip directed-broadcast show running-config C613-50188-01 Rev B...
IP A DDRESSING AND ROTOCOL OMMANDS IP GRATUITOUS LINK ip gratuitous-arp-link Overview This command sets the Gratuitous ARP time limit for all switchports. The time limit restricts the sending of Gratuitous ARP packets to one Gratuitous ARP packet within the time in seconds. : This command specifies time between sequences of Gratuitous ARP packets, NOTE and time between individual Gratuitous ARP packets occurring in a sequence, to allow...
Page 714
IP A DDRESSING AND ROTOCOL OMMANDS IP GRATUITOUS LINK To restrict the sending of Gratuitous ARP packets to one every 20 seconds, use the commands: awplus# configure terminal awplus(config)# ip gratuitous-arp-link 20 Validation show running-config Commands C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™...
IP A DDRESSING AND ROTOCOL OMMANDS IP HELPER ADDRESS ip helper-address Overview This command adds a forwarding destination address for IP Helper to enable forwarding of User Datagram Protocol (UDP) broadcasts on an interface. Use the no variant of this command to disable the forwarding of broadcast packets to specific addresses.
Page 716
IP A DDRESSING AND ROTOCOL OMMANDS IP HELPER ADDRESS The following example removes IPv4 address 192.168.1.100 as an IP Helper destination address to which to forward UDP broadcasts received on vlan2: awplus# configure terminal awplus(config)# interface vlan2 awplus(config-if)# no ip helper-address 192.168.1.100 Related ip forward-protocol udp Commands...
Page 717
IP A DDRESSING AND ROTOCOL OMMANDS IP IRDP ip irdp Overview 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 (IP Addressing and Protocol) command.
IP A DDRESSING AND ROTOCOL OMMANDS IP IRDP ADDRESS PREFERENCE ip irdp address preference Overview 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.
IP A DDRESSING AND ROTOCOL OMMANDS IP IRDP BROADCAST ip irdp broadcast Overview 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 variant of this command configures multicast Router Discovery advertisements on an interface.
IP A DDRESSING AND ROTOCOL OMMANDS IP IRDP HOLDTIME ip irdp holdtime Overview This command sets the maximum length of time that the advertised addresses are to be considered as valid router addresses by hosts. The no variant of this command resets the holdtime back to the default of 1800 seconds.
IP A DDRESSING AND ROTOCOL OMMANDS IP IRDP LIFETIME ip irdp lifetime Overview 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: This command is synonymous with the ip irdp hostname<0-9000>...
IP A DDRESSING AND ROTOCOL OMMANDS IP IRDP MAXADVERTINTERVAL ip irdp maxadvertinterval Overview 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...
IP A DDRESSING AND ROTOCOL OMMANDS IP IRDP MAXADVERTINTERVAL Related ip irdp Commands ip irdp lifetime ip irdp minadvertinterval show ip irdp interface C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
IP A DDRESSING AND ROTOCOL OMMANDS IP IRDP MINADVERTINTERVAL ip irdp minadvertinterval Overview 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...
IP A DDRESSING AND ROTOCOL OMMANDS IP IRDP MINADVERTINTERVAL Related ip irdp Commands ip irdp lifetime ip irdp maxadvertinterval show ip irdp interface C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
IP A DDRESSING AND ROTOCOL OMMANDS IP IRDP MULTICAST ip irdp multicast Overview 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 variant of this command configures broadcast Router Discovery advertisements on an interface.
IP A DDRESSING AND ROTOCOL OMMANDS IP IRDP PREFERENCE ip irdp preference Overview 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.
IP A DDRESSING AND ROTOCOL OMMANDS IP LIMITED LOCAL PROXY ip limited-local-proxy-arp Overview Use this command to enable local proxy ARP, but only for a specified set of IP addresses. This makes the device respond to ARP requests for those IP addresses when the addresses are reachable via the interface you are configuring.
IP A DDRESSING AND ROTOCOL OMMANDS IP LOCAL PROXY ip local-proxy-arp Overview This command allows you to stop MAC address resolution between hosts within a private VLAN edge interface. Local Proxy ARP works by intercepting ARP requests between hosts within a subnet and responding with your device’s own MAC address details instead of the destination host’s details.
IP A DDRESSING AND ROTOCOL OMMANDS IP PROXY ip proxy-arp Overview 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.
IP A DDRESSING AND ROTOCOL OMMANDS IP REDIRECTS ip redirects Overview This command enables the device to send ICMP redirects on one or more interfaces. Use the no variant of this command to stop the device from sending ICMP redirects on one or more interfaces.
IP A DDRESSING AND ROTOCOL OMMANDS IP TCP SYNACK RETRIES ip tcp synack-retries Overview Use this command to specify how many times the switch will retry sending a SYN ACK for a TCP connection for which it has received a SYN but not an ACK. Such connections are called half-open TCP connections.
IP A DDRESSING AND ROTOCOL OMMANDS IP UNREACHABLES ip unreachables Overview Use this command to enable ICMP (Internet Control Message Protocol) type 3, destination unreachable, messages. Use the no variant of this command to disable destination unreachable messages. This prevents an attacker from using these messages to discover the topology of a network.
Page 734
IP A DDRESSING AND ROTOCOL OMMANDS IP UNREACHABLES Table 19-2: ICMP type 3 reason codes and description (cont.) Code Description [RFC] Host Precedence Violation [RFC1812] Precedence cutoff in effect [RFC1812] Example To disable destination unreachable messages, use the commands awplus# configure terminal awplus(config)# no ip unreachables...
IP A DDRESSING AND ROTOCOL OMMANDS LOCAL PROXY local-proxy-arp Overview Use this command to specify an IP subnet for use with limited local proxy ARP. When limited local proxy ARP is enabled with the command limited-local-proxy-arp, the device will respond to ARP requests for addresses in that subnet.
IP A DDRESSING AND ROTOCOL OMMANDS OPTIMISTIC optimistic-nd Overview Use this command to enable the optimistic neighbor discovery feature for both IPv4 and IPv6. Use the no variant of this command to disable the optimistic neighbor discovery feature. Syntax optimistic-nd no optimistic-nd Default The optimistic neighbor discovery feature is enabled by default.
IP A DDRESSING AND ROTOCOL OMMANDS PING ping Overview This command sends a query to another IPv4 host (send Echo Request messages). ping [ip] <host> [broadcast] [df-bit {yes|no}] [interval Syntax <0-128>] [pattern <hex-data-pattern>] [repeat {<1-2147483647>|continuous}] [size <36-18024>] [source <ip-addr>] [timeout <1-65535>] [tos <0-255>] ping [vrf <vrf-name>] [ip] <host>...
Page 738
IP A DDRESSING AND ROTOCOL OMMANDS PING Example To ping the IP address 10.10.0.5 from VRF instance ‘red’, use the following (VRF-lite) command: awplus# ping vrf red 10.10.0.5 : Unless a cross-domain static or leaked route exists to the destination IP address, NOTE you must run this command from within the same routing domain as the address being pinged.
IP A DDRESSING AND ROTOCOL OMMANDS ROUTER IP IRDP router ip irdp Overview This command globally enables ICMP Router Discovery (IRDP) advertisements on your device. However, your device does not send or process IRDP messages until at least one interface is configured to use IP and has had IRDP enabled on the interface with the ip irdp command.
IP A DDRESSING AND ROTOCOL OMMANDS SHOW ARP show arp Overview Use this command to display entries in the ARP routing and forwarding table—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.
Page 741
IP A DDRESSING AND ROTOCOL OMMANDS SHOW ARP Output Figure 19-3: Example output from the show arp command awplus#show arp Type IP Address MAC Address Interface Port dynamic 192.168.10.2 0015.77ad.fad8 vlan1 port1.1.1 dynamic 192.168.20.2 0015.77ad.fa48 vlan2 port1.1.2 192.168.1.100 00d0.6b04.2a42...
Page 742
IP A DDRESSING AND ROTOCOL OMMANDS SHOW ARP Related arp (IP address MAC) Commands clear arp-cache C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
IP A DDRESSING AND ROTOCOL OMMANDS SHOW DEBUGGING IP PACKET show debugging ip packet Overview Use this command to show the IP interface debugging status. IP interface debugging is set using the debug ip packet interface command. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
Page 744
IP A DDRESSING AND ROTOCOL OMMANDS SHOW DEBUGGING IP PACKET Related debug ip packet interface Commands terminal monitor C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
IP A DDRESSING AND ROTOCOL OMMANDS SHOW IP FORWARDING show ip forwarding Overview Use this command to display the IP forwarding status. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
IP A DDRESSING AND ROTOCOL OMMANDS SHOW IP INTERFACE show ip interface Overview Use this command to display information about interfaces and the IP addresses assigned to them. To display information about a specific interface, specify the interface name with the command. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
IP A DDRESSING AND ROTOCOL OMMANDS SHOW IP INTERFACE VRF show ip interface vrf Overview Use this command to display protocol and status information about configured interfaces and their assigned IP addresses in VRF instances. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
Page 748
IP A DDRESSING AND ROTOCOL OMMANDS SHOW IP INTERFACE VRF Output Figure 19-11: Example output from the show ip interface with VRF-lite configured Interface IP-Address Status Protocol eth0 unassigned admin up down unassigned admin up running vlan1 192.168.1.1/24 admin up running...
IP A DDRESSING AND ROTOCOL OMMANDS SHOW IP IRDP show ip irdp Overview This command displays whether IRDP is globally enabled on your device, and the status of the debugging modes. If the debug ip irdp command has been set with the detail parameter then the both parameter is also set and the output will show “packet debugging mode is all”.
IP A DDRESSING AND ROTOCOL OMMANDS SHOW IP IRDP INTERFACE show ip irdp interface Overview This command displays the configuration of IRDP on all interfaces, or for a specified interface. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
Page 751
IP A DDRESSING AND ROTOCOL OMMANDS SHOW IP IRDP INTERFACE Table 21: Parameters in the output of the show ip irdp interface command Parameter Description Sending mode Whether this interface is sending broadcast or multicast router advertisements. This means the destination IP address of router advertisements will be either the multicast address 224.0.0.1, or the broadcast address 255.255.255.255.
IP A DDRESSING AND ROTOCOL OMMANDS SHOW IP SOCKETS show ip sockets Overview Use this command to display information about the IP or TCP sockets that are present on the device. It includes TCP and UDP listen sockets, and displays the associated IP address and port.
Page 753
IP A DDRESSING AND ROTOCOL OMMANDS SHOW IP SOCKETS Table 19-1: Parameters in the output from show ip sockets Parameter Description Not showing This field refers to established sessions between processes internal <number> to the device, that are used in its operation and management. local These sessions are not displayed as they are not useful to the user.
Page 754
IP A DDRESSING AND ROTOCOL OMMANDS SHOW IP SOCKETS Table 19-1: Parameters in the output from show ip sockets (cont.) Parameter Description Remote For TCP and UDP listening sockets this shows the source IP address Address (either IPv4 or IPv6) and source TCP or UDP port number for which the socket will accept packets.
IP A DDRESSING AND ROTOCOL OMMANDS SHOW IP TRAFFIC show ip traffic Overview Use this command to display statistics regarding IP traffic sent and received by all interfaces on the device, showing totals for IP and IPv6 and then broken down into sub-categories such as TCP, UDP, ICMP and their IPv6 equivalents when appropriate.
Page 756
IP A DDRESSING AND ROTOCOL OMMANDS SHOW IP TRAFFIC 155 delayed acks sent 21187 headers predicted 736 pure ACKs 80497 pure ACKs predicted UDP: 139468 datagrams received 139468 datagrams sent UDPLite: C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™...
IP A DDRESSING AND ROTOCOL OMMANDS TCPDUMP tcpdump Overview Use this command to start a tcpdump, which gives the same output as the Unix-like tcpdump command to display TCP/IP traffic. Press <ctrl> + c to stop a running tcpdump. tcpdump <line> Syntax tcpdump [vrf <vrf-name>] <line>...
IP A DDRESSING AND ROTOCOL OMMANDS TRACEROUTE traceroute Overview Use this command to trace the route to the specified IPv4 host. traceroute {<ip-addr>|<hostname>} Syntax traceroute [vrf <vrf-name>] {<ip-addr>|<hostname>} Syntax (VRF-lite) Parameter Description <ip-addr> The destination IPv4 address. The IPv4 address uses the format A.B.C.D.
IP A DDRESSING AND ROTOCOL OMMANDS UNDEBUG IP PACKET INTERFACE undebug ip packet interface Overview This command applies the functionality of the no debug ip packet interface command. C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
IP A DDRESSING AND ROTOCOL OMMANDS UNDEBUG IP IRDP undebug ip irdp Overview This command applies the functionality of the no debug ip irdp command. C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
Domain Name Service (DNS) Commands Introduction Overview This chapter provides an alphabetical reference of commands used to configure Domain Name Service (DNS) features, including the following: • DNS client • DNS forwarding (DNS relay) For more information about DNS for Switches, see the Domain Name System (DNS) for AlliedWare Plus Switches Feature Overview and Configuration Guide Command List...
Page 762
(DNS) C OMAIN ERVICE OMMANDS • “show ip dns forwarding server” on page 781 • “show ip domain-list” on page 783 • “show ip domain-name” on page 784 • “show ip name-server” on page 785 C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™...
(DNS) C OMAIN ERVICE OMMANDS CLEAR IP DNS FORWARDING CACHE clear ip dns forwarding cache Overview Use this command to clear the DNS Relay name resolver cache. When using VRF-lite, use this command to clear the DNS Relay name resolver cache for either the whole device or for a specific VRF instance.
(DNS) C OMAIN ERVICE OMMANDS DEBUG IP DNS FORWARDING debug ip dns forwarding Overview Use this command to enable DNS Relay debugging. Use the no variant of this command to disable DNS Relay debugging. Syntax debug ip dns forwarding no debug ip dns forwarding Default DNS Relay debugging is disabled by default.
(DNS) C OMAIN ERVICE OMMANDS IP DNS FORWARDING ip dns forwarding Overview Use this command to enable DNS Relay, the forwarding of incoming DNS queries for IP hostname-to-address translation. Use the no variant of this command to disable the forwarding of incoming DNS queries for IP hostname-to-address translation.
(DNS) C OMAIN ERVICE OMMANDS IP DNS FORWARDING CACHE ip dns forwarding cache Overview Use this command to set the DNS Relay name resolver cache size and cache entry lifetime period. The DNS Relay name resolver cache stores the mappings between domain names and IP addresses.
(DNS) C OMAIN ERVICE OMMANDS IP DNS FORWARDING DEAD TIME ip dns forwarding dead-time Overview Use this command to set the time period in seconds when the device stops sending any DNS requests to an unresponsive server and all retries set using ip dns forwarding retry are used.
(DNS) C OMAIN ERVICE OMMANDS IP DNS FORWARDING RETRY ip dns forwarding retry Overview Use this command to set the number of times DNS Relay will retry to forward DNS queries. The device stops sending DNS requests to an unresponsive server at the time set using the ip dns forwarding dead-time command and when all of the...
(DNS) C OMAIN ERVICE OMMANDS IP DNS FORWARDING SOURCE INTERFACE ip dns forwarding source-interface Overview Use this command to set the interface to use for forwarding and receiving DNS queries. Use the no variant of this command to unset the interface used for forwarding and receiving DNS queries.
(DNS) C OMAIN ERVICE OMMANDS IP DNS FORWARDING TIMEOUT ip dns forwarding timeout Overview Use this command to set the time period for the DNS Relay to wait for a DNS response. Use the no variant of this command to set the time period to wait for a DNS response to the default of 3 seconds.
(DNS) C OMAIN ERVICE OMMANDS IP DOMAIN LIST ip domain-list Overview This command adds a domain to the DNS list. Domains are appended to incomplete host names in DNS requests. Each domain in this list is tried in turn in DNS lookups.
(DNS) C OMAIN ERVICE OMMANDS IP DOMAIN LOOKUP ip domain-lookup Overview 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 inquiry to a DNS server, specified with the ip name-server command.
(DNS) C OMAIN ERVICE OMMANDS IP DOMAIN NAME ip domain-name Overview This command sets a default domain for the DNS. The DNS client appends this domain to incomplete host-names in DNS requests. The no variant of this command removes the domain-name previously set by this command.
(DNS) C OMAIN ERVICE OMMANDS IP NAME SERVER ip name-server Overview This command adds IPv4 or IPv6 DNS server addresses. The DNS client on your device sends DNS queries to IP addresses in this list when trying to resolve a host name.
Page 775
(DNS) C OMAIN ERVICE OMMANDS IP NAME SERVER To enable your device to send DNS queries to a DNS server with the IPv6 address 2001:0db8:010d::1, use the commands: awplus# configure terminal awplus(config)# ip name-server 2001:0db8:010d::1 Example To enable your switch to send DNS queries (on VRF instance RED) to a DNS server with the IPv4 address 10.10.10.5 use the commands: (VRF-lite) awplus#...
(DNS) C OMAIN ERVICE OMMANDS SHOW DEBUGGING IP DNS FORWARDING show debugging ip dns forwarding Overview Use this command to display the DNS Relay debugging status. DNS Relay debugging is set using the debug ip dns forwarding command. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
(DNS) C OMAIN ERVICE OMMANDS SHOW HOSTS show hosts Overview This command shows the default domain, domain list, and name servers configured on your device. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
(DNS) C OMAIN ERVICE OMMANDS SHOW IP DNS FORWARDING show ip dns forwarding Overview Use this command to display the DNS Relay status. show ip dns forwarding Syntax Mode User Exec and Privileged Exec Examples To display the DNS Relay status, use the command: awplus# show ip dns forwarding Output...
(DNS) C OMAIN ERVICE OMMANDS SHOW IP DNS FORWARDING CACHE show ip dns forwarding cache Overview Use this command to display the DNS Relay name resolver cache. show ip dns forwarding cache Syntax show ip dns [vrf <name>|global] forwarding cache Syntax (VRF-lite) Parameter Description...
Page 780
(DNS) C OMAIN ERVICE OMMANDS SHOW IP DNS FORWARDING CACHE Output Figure 20-5: Example output from the show ip dns forwarding cache command that includes output for VRF instance RED. awplus#show ip dns vrf RED forwarding cache Host Address Expires Flags...
(DNS) C OMAIN ERVICE OMMANDS SHOW IP DNS FORWARDING SERVER show ip dns forwarding server Overview Use this command to display the status of DNS forwarding name servers. If you are running VRF, you can also use this command to display the status for DNS forwarding name servers operating on a specific VRF instance.
Page 782
(DNS) C OMAIN ERVICE OMMANDS SHOW IP DNS FORWARDING SERVER Related ip dns forwarding Commands ip dns forwarding dead-time C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
(DNS) C OMAIN ERVICE OMMANDS SHOW IP DOMAIN LIST show ip domain-list Overview This command shows the domains configured in the domain list. The DNS client uses the domains in this list to append incomplete hostnames when sending a DNS inquiry to a DNS server. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
(DNS) C OMAIN ERVICE OMMANDS SHOW IP DOMAIN NAME show ip domain-name Overview 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 inquiry to a DNS server.
(DNS) C OMAIN ERVICE OMMANDS SHOW IP NAME SERVER show ip name-server Overview This command displays a list of IPv4 and IPv6 DNS server addresses that your device will send DNS requests to. This is a static list configured using the name-server command.
IPv6 Commands Introduction Overview This chapter provides an alphabetical reference of commands used to configure IPv6. For more information, see the IPv6 Feature Overview and Configuration Guide. Command List • “clear ipv6 neighbors” on page 788 • “ipv6 address” on page 789 •...
Page 787
OMMANDS • “ipv6 neighbor” on page 812 • “ipv6 opportunistic-nd” on page 813 • “ipv6 route” on page 814 • “ipv6 unreachables” on page 815 • “ping ipv6” on page 816 • “show ipv6 forwarding” on page 817 • “show ipv6 interface brief”...
OMMANDS ADDRESS ipv6 address Overview Use this command to set the IPv6 address of an interface. The command also enables IPv6 on the interface, which creates an EUI-64 link-local address as well as enabling RA processing and SLAAC. To stop the device from processing prefix information (routes and addresses from the received Router Advertisements) use the command no ipv6 nd accept-ra-pinfo.
Page 790
OMMANDS ADDRESS Related ipv6 address autoconfig Commands ipv6 address dhcp ipv6 dhcp server ipv6 enable ipv6 eui64-linklocal show running-config show ipv6 interface brief show ipv6 route C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
OMMANDS ADDRESS AUTOCONFIG ipv6 address autoconfig Overview Use this command to enable IPv6 stateless address autoconfiguration (SLAAC) for an interface. This configures an IPv6 address on an interface derived from the MAC address on the interface. Use the no variant of this command to disable IPv6 SLAAC on an interface. Note that if no global addresses are left after removing all IPv6 autoconfigured addresses then IPv6 is disabled.
Page 792
OMMANDS ADDRESS AUTOCONFIG To disable SLAAC on the VLAN interface vlan2, use the following commands: awplus# configure terminal awplus(config)# interface vlan2 awplus(config-if)# no ipv6 address autoconfig Related ipv6 address Commands ipv6 enable show ipv6 interface brief show ipv6 route show running-config C613-50188-01 Rev B Command Reference for SwitchBlade®...
OMMANDS ENABLE ipv6 enable Overview Use this command to enable automatic configuration of a link-local IPv6 address on an interface using Stateless Automatic Address Configuration (SLAAC). By default, the EUI-64 method is used to generate the link-local address. Use the no variant of this command to disable IPv6 on an interface without a global address.
Page 794
OMMANDS ENABLE Related ipv6 address Commands ipv6 address autoconfig ipv6 address dhcp ipv6 address (DHCPv6 PD) ipv6 dhcp client pd ipv6 nd prefix show ipv6 interface brief show ipv6 route show running-config C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™...
OMMANDS LINKLOCAL ipv6 eui64-linklocal Overview When IPv6 is enabled on an interface, an EUI link-local address is generated and installed on the interface. In other words, ipv6 eui64-linklocal is enabled by default on any IPv6 enabled interface. Use the no variant of this command to disallow the automatic generation of the EUI-64 link-local address on an IPv6 enabled interface.
OMMANDS FORWARDING ipv6 forwarding Overview Use this command to turn on IPv6 unicast routing for IPv6 packet forwarding. Execute this command globally on your device prior to issuing ipv6 enable individual interfaces. Use this no variant of this command to turn off IPv6 unicast routing. Note IPv6 unicast routing is disabled by default.
OMMANDS MULTICAST FORWARD SLOW PATH PACKET ipv6 multicast forward-slow-path-packet Overview Use this command to enable multicast packets to be forwarded to the CPU. Enabling this command will ensure that the layer L3 MTU is set correctly for each IP multicast group and will apply the value of the smallest MTU among the outgoing interfaces for the multicast group.
OMMANDS ND ACCEPT PINFO ipv6 nd accept-ra-pinfo Overview Use this command to allow the processing of the prefix information included in a received RA (Router Advertisement) on an IPv6 enabled interface. Use the no variant of this command to disable an IPv6 interface from using the prefix information within a received RA.
OMMANDS ND CURRENT HOPLIMIT ipv6 nd current-hoplimit Overview Use this command to specify the advertised current hop limit used between IPv6 Routers. Use the no variant of this command to reset the current advertised hop limit to its default “0”. Syntax ipv6 nd current-hoplimit <hoplimit>...
OMMANDS ND MANAGED CONFIG FLAG ipv6 nd managed-config-flag Overview Use this command to set the managed address configuration flag, contained within the router advertisement field. Setting this flag indicates the operation of a stateful autoconfiguration protocol such as DHCPv6 for address autoconfiguration, and that address information (i.e. the network prefix) and other (non-address) information can be requested from the device.
OMMANDS ND MINIMUM INTERVAL ipv6 nd minimum-ra-interval Overview Use this command in Interface Configuration mode to set a minimum Router Advertisement (RA) interval for a VLAN interface. Use the no variant of this command in Interface Configuration mode to remove the minimum RA interval for a VLAN interface.
OMMANDS ND OTHER CONFIG FLAG ipv6 nd other-config-flag Overview Use this command to set the other stateful configuration flag (contained within the router advertisement field) to be used for IPv6 address auto-configuration. This flag is used to request the router to provide information in addition to providing addresses.
OMMANDS ND PREFIX ipv6 nd prefix Overview Use this command in Interface Configuration mode for a VLAN interface to specify the IPv6 prefix information that is advertised by the router advertisement for IPv6 address auto-configuration. Use the no parameter with this command to reset the IPv6 prefix for a VLAN interface in Interface Configuration mode.
Page 804
OMMANDS ND PREFIX Usage This command specifies the IPv6 prefix flags that are advertised by the router advertisement message. Examples The following example configures the device to issue router advertisements on the VLAN interface vlan4, and advertises the address prefix of 2001:0db8::/64. awplus# configure terminal awplus(config)#...
OMMANDS ND RA INTERVAL ipv6 nd ra-interval Overview Use this command to specify the interval between IPv6 Router Advertisements (RA) transmissions. Use no parameter with this command to reset the value to the default value (600 seconds). Syntax ipv6 nd ra-interval <seconds> no ipv6 nd ra-interval Parameter Description...
OMMANDS ND RA LIFETIME ipv6 nd ra-lifetime Overview Use this command to specify the time period that this router can usefully act as a default gateway for the network. Each router advertisement resets this time period. Use no parameter with this command to reset the value to default. Syntax ipv6 nd ra-lifetime <seconds>...
OMMANDS ND RAGUARD ipv6 nd raguard Overview Use this command to apply the Router Advertisements (RA) Guard feature from the Interface Configuration mode for a device port. This blocks all RA messages received on a device port. For more information about RA Guard, see the IPv6 Feature Overview and Configuration Guide.
Page 808
OMMANDS ND RAGUARD Output Example output from using show running-config interface port1.1.2 to verify RA Guard: ! interface port1.1.2 switchport mode access ipv6 nd raguard ! Related show running-config interface Commands C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™...
OMMANDS ND REACHABLE TIME ipv6 nd reachable-time Overview Use this command to specify the reachable time in the router advertisement to be used for detecting reachability of the IPv6 neighbor. Use the no variant of this command to reset the value to default. Syntax ipv6 nd reachable-time <milliseconds>...
OMMANDS ND RETRANSMISSION TIME ipv6 nd retransmission-time Overview Use this command to specify the advertised retransmission interval for Neighbor Solicitation in milliseconds between IPv6 Routers. Use the no variant of this command to reset the retransmission time to the default (1 second).
OMMANDS ND SUPPRESS ipv6 nd suppress-ra Overview Use this command to inhibit IPv6 Router Advertisement (RA) transmission for the current interface. Router advertisements are used when applying IPv6 stateless auto-configuration. Use no parameter with this command to enable Router Advertisement transmission.
OMMANDS NEIGHBOR ipv6 neighbor Overview Use this command to add a static IPv6 neighbor entry. Use the no variant of this command to remove a specific IPv6 neighbor entry. Syntax ipv6 neighbor <ipv6-address> <vlan-name> <mac-address> <port-list> no ipv6 neighbor <ipv6-address> <vlan-name> <port-list> Parameter Description <ipv6-address>...
OMMANDS OPPORTUNISTIC ipv6 opportunistic-nd Overview Use this command to enable opportunistic neighbor discovery for the global IPv6 ND cache. Opportunistic neighbor discovery changes the behavior for unsolicited ICMPv6 ND packet forwarding on the device. Use the no variant of this command to disable opportunistic neighbor discovery for the global IPv6 ND cache.
OMMANDS ROUTE ipv6 route Overview This command adds a static IPv6 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). Your device uses the FIB to advertise routes to neighbors and forward packets.
OMMANDS UNREACHABLES ipv6 unreachables Overview Use this command to enable ICMPv6 (Internet Control Message Protocol version 6) type 1, destination unreachable, messages. Use the no variant of this command to disable destination unreachable messages. This prevents an attacker from using these messages to discover the topology of a network.
OMMANDS SHOW IPV FORWARDING show ipv6 forwarding Overview Use this command to display IPv6 forwarding status. show ipv6 forwarding Syntax Mode User Exec and Privileged Exec awplus# show ipv6 forwarding Example Output Figure 21-1: Example output from the show ipv6 forwarding command ...
OMMANDS SHOW IPV INTERFACE BRIEF show ipv6 interface brief Overview Use this command to display brief information about interfaces and the IPv6 address assigned to them. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
OMMANDS SHOW IPV NEIGHBORS show ipv6 neighbors Overview Use this command to display all IPv6 neighbors. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide. Syntax show ipv6 neighbors Mode User Exec and Privileged Exec C613-50188-01 Rev B...
OMMANDS SHOW IPV ROUTE show ipv6 route Overview Use this command to display the IPv6 routing table for a protocol or from a particular table. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
Page 821
OMMANDS SHOW IPV ROUTE Output Figure 21-3: Example output of the show ipv6 route command IPv6 Routing Table Codes: C - connected, S - static, R - RIP, O - OSPF, B - BGP ::/0 [1/0] via 2001::a:0:0:c0a8:a6, vlan10 2001:db8::a:0:0:0:0/64 via ::, vlan10...
OMMANDS SHOW IPV ROUTE SUMMARY show ipv6 route summary Overview Use this command to display the summary of the current NSM RIB entries. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
OMMANDS TRACEROUTE IPV traceroute ipv6 Overview Use this command to trace the route to the specified IPv6 host. traceroute ipv6 {<ipv6-addr>|<hostname>} Syntax Parameter Description <ipv6-addr> The destination IPv6 address. The IPv6 address uses the format X:X::X:X. <hostname> The destination hostname. Mode User Exec and Privileged Exec Example...
Routing Commands Introduction Overview This chapter provides an alphabetical reference of routing commands that are common across the routing IP protocols. For more information, see the Route Selection Feature Overview and Configuration Guide. Command List • “ip route” on page 825 •...
OUTING OMMANDS IP ROUTE ip route Overview 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). Your device uses the FIB to advertise routes to neighbors and forward packets.
Page 826
OUTING OMMANDS IP ROUTE Parameter Description Applies the command to the specified VRF instance. <vrf-name> The name of the VRF instance to enter IPv4 Address-Family mode for. Mode Global Configuration Default The default administrative distance for a static route is 1 for priority over non-static routes.
Page 827
OUTING OMMANDS IP ROUTE To remove a static route from source VRF red, to the subnet 192.168.50.0/24 with a next hop of 192.168.20.6, use the following commands for static intra-VRF routing configuration: awplus# configure terminal awplus(config)# no ip route vrf red 192.168.50.0/24 192.168.20.6 To create a static route from source VRF red, to the subnet 192.168.50.0/24 with a next hop of 192.168.20.6 via vlan10, use the following commands for static...
Page 828
OUTING OMMANDS ROUTE ipv6 route Overview This command adds a static IPv6 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). Your device uses the FIB to advertise routes to neighbors and forward packets.
Page 829
OUTING OMMANDS ROUTES max-fib-routes Overview This command enables you to control the maximum number of FIB routes configured. It operates by providing parameters that enable you to configure preset maximums and warning message thresholds. : When using VRF-lite, this command applies to the Global VRF instance; to set NOTE the max-fib-routes for a user-defined VRF instance use the max-fib-routes (VRF)
Page 830
OUTING OMMANDS ROUTES Related max-fib-routes (VRF) Commands C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
Page 831
OUTING OMMANDS STATIC ROUTES max-static-routes Overview Use this command to set the maximum number of static routes, excluding FIB (Forwarding Information Base) routes. : When using VRF-lite, this command applies to the Global VRF instance; to set NOTE the max-static-routes for a user-defined VRF instance use the max-static-routes (VRF) command.
OUTING OMMANDS MAXIMUM PATHS maximum-paths Overview 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 variant of this command sets the maximum paths to the default of 4. Syntax maximum-paths <1-8>...
OUTING OMMANDS SHOW IP ROUTE show ip route Overview Use this command to display routing entries in the FIB (Forwarding Information Base). The FIB contains the best routes to a destination, and your device uses these routes when forwarding traffic. You can display a subset of the entries in the FIB based on protocol.
Page 834
OUTING OMMANDS SHOW IP ROUTE To display all routing entries in the FIB associated with a VRF instance red, use the Example (VRF-lite) command: awplus# show ip route vrf red Output Each entry in the output from this command has a code preceding it, indicating the source of the routing entry.
Page 835
OUTING OMMANDS SHOW IP ROUTE This route entry denotes: This route in the network 10.10.37.0/24 was added by OSPF. • • This route has an administrative distance of 110 and metric/cost of 11. This route is reachable via next hop 10.10.31.16. •...
OUTING OMMANDS SHOW IP ROUTE DATABASE show ip route database Overview This command displays the routing entries in the RIB (Routing Information Base). 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 (Forwarding Information Base).
Page 837
OUTING OMMANDS SHOW IP ROUTE DATABASE Output Figure 22-2: Example output from the show ip route database 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...
Page 838
OUTING OMMANDS SHOW IP ROUTE DATABASE • Since this static route has a lower administrative distance than the OSPF route (110), the static route (1) is selected and installed in the FIB. If the static route becomes unavailable, then the device automatically selects the OSPF route and installs it in the FIB.
OUTING OMMANDS SHOW IP ROUTE SUMMARY show ip route summary Overview This command displays a summary of the current RIB (Routing Information Base) entries. 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 route summary show ip route summary [vrf <vrf-name>|global]...
Page 840
OUTING OMMANDS SHOW IP ROUTE SUMMARY Output Figure 22-5: Example output from the show ip route summary vrf red command IP routing table name is Default-IP-Routing-Table(0) IP routing table maximum-paths is 4 Route Source Networks connected 1 Total 1 0 ...
Page 841
OUTING OMMANDS SHOW IPV ROUTE show ipv6 route Overview Use this command to display the IPv6 routing table for a protocol or from a particular table. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
Page 842
OUTING OMMANDS SHOW IPV ROUTE Output Figure 22-6: Example output of the show ipv6 route command IPv6 Routing Table Codes: C - connected, S - static, R - RIP, O - OSPF, B - BGP ::/0 [1/0] via 2001::a:0:0:c0a8:a6, vlan10 2001:db8::a:0:0:0:0/64 via ::, vlan10...
Page 843
OUTING OMMANDS SHOW IPV ROUTE SUMMARY show ipv6 route summary Overview Use this command to display the summary of the current NSM RIB entries. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
RIP Commands Introduction Overview This chapter provides an alphabetical reference of commands used to configure RIP. For information about configuring RIP, see the RIP Feature Overview and Configuration Guide. Command List • “accept-lifetime” on page 846 • “address-family ipv4 (RIP)” on page 848 •...
Page 845
RIP C OMMANDS • “ip rip send version 1-compatible” on page 872 • “ip rip split-horizon” on page 874 • “key” on page 875 • “key chain” on page 876 • “key-string” on page 877 • “maximum-prefix” on page 878 •...
RIP C OMMANDS ACCEPT LIFETIME accept-lifetime Overview Use this command to specify the time period during which the authentication key on a key chain is received as valid. Use the no variant of this command to remove a specified time period for an authentication key on a key chain as set previously with the accept-lifetime command.
Page 847
RIP C OMMANDS ACCEPT LIFETIME awplus# configure terminal awplus(config)# key chain mychain awplus(config-keychain)# key 1 awplus(config-keychain-key)# accept-lifetime 03:03:01 3 Sep 2016 04:04:02 6 Oct 2016 Related Commands key-string key chain send-lifetime C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™...
RIP C OMMANDS 4 (RIP) ADDRESS FAMILY IPV address-family ipv4 (RIP) Overview This command enters the IPv4 address-family command mode. In this mode you can configure address-family specific parameters for a specific VRF (RIP) instance. address-family ipv4 vrf <vrf-name> Syntax no address-family ipv4 vrf <vrf-name>...
RIP C OMMANDS ALLIEDWARE BEHAVIOR alliedware-behavior Overview This command configures your device to exhibit AlliedWare behavior when sending RIPv1 response/update messages. Configuring for this behavior may be necessary if you are replacing an AlliedWare device with an AlliedWare Plus device and wish to ensure consistent RIPv1 behavior.
Page 850
RIP C OMMANDS ALLIEDWARE BEHAVIOR To return your device to AlliedWare Plus-like behavior when sending and receiving RIPv1 update messages, enter the commands: awplus# configure terminal awplus(config)# router rip awplus(config-router)# no alliedware-behavior rip1-send awplus(config-router)# no alliedware-behavior rip1-recv Validation show ip protocols rip Commands show running-config Related...
RIP C OMMANDS (RIP) CISCO METRIC BEHAVIOR cisco-metric-behavior (RIP) Overview Use this command to enable or disable the RIP routing metric update to conform to Cisco’s implementation. This command is provided to allow inter-operation with older Cisco devices that do not conform to the RFC standard for RIP route metrics.
RIP C OMMANDS CLEAR IP RIP ROUTE clear ip rip route Overview Use this command to clear specific data from the RIP routing table. clear ip rip route {<ip-dest-network/prefix-length>| Syntax static|connected|rip|ospf|bgp|invalid-routes|all} clear ip rip [vrf <vrf-name>] route Syntax (VRF-lite) {<ip-dest-network/prefix-length> |static|connected|rip|ospf|bgp|invalid-routes|all} Parameter Description...
RIP C OMMANDS DEBUG RIP debug rip Overview Use this command to specify the options for the displayed debugging information for RIP events and RIP packets. Use the no variant of this command to disable the specified debug option. Syntax debug rip {events|nsm|<packet>|all} no debug rip {events|nsm|<packet>|all} Parameter...
RIP C OMMANDS (RIP) DEFAULT INFORMATION ORIGINATE default-information originate (RIP) Overview Use this command to generate a default route into the Routing Information Protocol (RIP). Use the no variant of this command to disable this feature. Syntax default-information originate no default-information originate Default Disabled Mode...
RIP C OMMANDS (RIP) DEFAULT METRIC default-metric (RIP) Overview Use this command to specify the metrics to be assigned to redistributed RIP routes. Use the no variant of this command to reset the RIP metric back to its default (1). Syntax default-metric <metric>...
RIP C OMMANDS (RIP) DISTANCE distance (RIP) Overview 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 obtained from two different routing protocols. The route with the smallest administrative distance value is added to the Forwarding Information Base (FIB).
RIP C OMMANDS (RIP) DISTRIBUTE LIST distribute-list (RIP) Overview Use this command to filter incoming or outgoing route updates using the access-list or the prefix-list. When running VRF-lite, this command can be applied to a specific VRF instance. Use the no variant of this command to disable this feature. distribute-list {<access-list>...
Page 858
RIP C OMMANDS (RIP) DISTRIBUTE LIST Related access-list extended (named) Commands ip prefix-list C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
RIP C OMMANDS (RIP) FULLUPDATE fullupdate (RIP) Overview Use this command to specify which routes RIP should advertise when performing a triggered update. By default, when a triggered update is sent, RIP will only advertise those routes that have changed since the last update. When fullupdate is configured, the device advertises the full RIP route table in outgoing triggered updates, including routes that have not changed.
RIP C OMMANDS IP RIP AUTHENTICATION KEY CHAIN ip rip authentication key-chain Overview Use this command to enable RIPv2 authentication on an interface and specify the name of the key chain to be used. Use the no variant of this command to disable this function. Syntax ip rip authentication key-chain <key-chain-name>...
Page 861
RIP C OMMANDS IP RIP AUTHENTICATION KEY CHAIN Specify the mode of authentication for the given interface (text or MD5), using the following command: awplus(config-if)# ip rip authentication mode {md5|text} Example In the following example of a configuration for multiple keys authentication, a password “toyota”...
RIP C OMMANDS IP RIP AUTHENTICATION MODE ip rip authentication mode Overview Use this command to specify the type of authentication mode used for RIP v2 packets. Use the no variant of this command to restore clear text authentication. Syntax ip rip authentication mode {md5|text} no ip rip authentication mode Parameter...
Page 863
RIP C OMMANDS IP RIP AUTHENTICATION MODE Usage: multiple For multiple keys authentication, use the following steps to configure a route to enable RIPv2 authentication using multiple keys at different times: Define a key chain with a key chain name, using the following commands: awplus# configure terminal awplus(config)#...
Page 864
RIP C OMMANDS IP RIP AUTHENTICATION MODE Example 3 The following example specifies “mykey” as the authentication string with MD5 authentication, for the VLAN interface vlan2: awplus# configure terminal awplus(config)# interface vlan2 awplus(config-if)# ip rip authentication string mykey awplus(config-if)# ip rip authentication mode md5 Related ip rip authentication string Commands...
RIP C OMMANDS IP RIP AUTHENTICATION STRING ip rip authentication string Overview Use this command to specify the authentication string or password used by a key. Use the no variant of this command to remove the authentication string. Syntax ip rip authentication string <auth-string> no ip rip authentication string Parameter Description...
Page 866
RIP C OMMANDS IP RIP AUTHENTICATION STRING In the following example, the VLAN interface vlan2 is configured to have an Example authentication string as guest. Any received RIP packet in that interface should have the same string as password. awplus# configure terminal awplus(config)# interface vlan2...
RIP C OMMANDS IP RIP RECEIVE PACKET ip rip receive-packet Overview Use this command to configure the interface to enable the reception of RIP packets. Use the no variant of this command to disable this feature. Syntax ip rip receive-packet no ip rip receive-packet Default Receive-packet is enabled...
RIP C OMMANDS IP RIP RECEIVE VERSION ip rip receive version Overview 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 variant of this command to use the setting specified by the version (RIP) command.
RIP C OMMANDS IP RIP SEND PACKET ip rip send-packet Overview Use this command to enable sending RIP packets through the current interface. Use the no variant of this command to disable this feature. Syntax ip rip send-packet no ip rip send-packet Default Send packet is enabled Mode...
RIP C OMMANDS IP RIP SEND VERSION ip rip send version Overview Use this command in Interface Configuration mode to specify the version of RIP packets sent on an interface and override the setting of the version (RIP) command. This mechanism causes RIP version 2 interfaces to send multicast packets instead of broadcasting packets.
Page 871
RIP C OMMANDS IP RIP SEND VERSION In the following example, the VLAN interface vlan4 is configured to send both RIP version 2 and 1 packets. awplus# configure terminal awplus(config)# interface vlan4 awplus(config-if)# ip rip send version 2 1 In the following example, the VLAN interface vlan4 is configured to send RIP version 1 packets only.
RIP C OMMANDS IP RIP SEND VERSION COMPATIBLE ip rip send version 1-compatible Overview Use this command in Interface Configuration mode to send RIP version 1 compatible packets from a RIP version 2 interfaces to other RIP Interfaces. This mechanism causes RIP version 2 interfaces to send broadcast packets instead of multicasting packets, and is used in environments where multicast is not enabled or where hosts do not listen to multicast.
Page 873
RIP C OMMANDS IP RIP SEND VERSION COMPATIBLE Related ip rip send version Commands version (RIP) C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
RIP C OMMANDS IP RIP SPLIT HORIZON ip rip split-horizon Overview Use this command to turn on the split-horizon mechanism on the interface. Use the no variant of this command to disable this mechanism. Syntax ip rip split-horizon [poisoned] no ip rip split-horizon Parameter Description poisoned...
Page 875
RIP C OMMANDS Overview Use this command to manage, add and delete authentication keys in a key-chain. Use the no variant of this command to delete the authentication key. Syntax key <keyid> no key <keyid> Parameter Description <keyid> <0-2147483647> Key identifier number. Mode Keychain Configuration Usage...
RIP C OMMANDS KEY CHAIN key chain Overview Use this command to enter the key chain management mode and to configure a key chain with a key chain name. Use the no variant of this command to remove the key chain and all configured keys.
RIP C OMMANDS STRING key-string Overview Use this command to define the password to be used by a key. Use the no variant of this command to remove a password. Syntax key-string <key-password> no key-string Parameter Description <key-password> A string of characters to be used as a password by the key. Mode Keychain-key Configuration Usage...
RIP C OMMANDS MAXIMUM PREFIX maximum-prefix Overview Use this command to configure the maximum number of RIP routes stored in the routing table. Use the no variant of this command to disable all limiting of the number of RIP routes stored in the routing table. Syntax maximum-prefix <maxprefix>...
RIP C OMMANDS (RIP) NEIGHBOR neighbor (RIP) Overview 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 variant of this command to stop sending unicast updates to the specific router.
RIP C OMMANDS (RIP) NETWORK network (RIP) Overview Use this command to activate the transmission of RIP routing information on the defined network. Use the no variant of this command to remove the specified network or VLAN as one that runs RIP. Syntax network {<network-address>[/<subnet-mask>]|<vlan-name>} no network {<network-address>[/<subnet-mask>]|<vlan-name>}...
Page 881
RIP C OMMANDS (RIP) NETWORK Related show ip rip Commands show running-config clear ip rip route C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
RIP C OMMANDS (RIP) OFFSET LIST offset-list (RIP) Overview Use this command to add an offset to the in and out metrics of routes learned through RIP. Use the no variant of this command to remove the offset list. Syntax offset-list <access-list>...
Page 883
RIP C OMMANDS (RIP) OFFSET LIST Related access-list (extended numbered) Commands C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
RIP C OMMANDS (RIP) PASSIVE INTERFACE passive-interface (RIP) Overview Use this command to block RIP broadcasts on the interface. Use the no variant of this command to disable this function. Syntax passive-interface <interface> no passive-interface <interface> Parameter Description <interface> Specifies the interface name. Default Disabled Mode...
RIP C OMMANDS (RIP) RECV BUFFER SIZE recv-buffer-size (RIP) Overview Use this command to run-time configure the RIP UDP (User Datagram Protocol) receive-buffer size to improve UDP reliability by avoiding UDP receive buffer overrun. Use the no variant of this command to reset the configured RIP UDP receive-buffer size to the system default (196608 bits).
RIP C OMMANDS (RIP) REDISTRIBUTE redistribute (RIP) Overview Use this command to redistribute information from other routing protocols into RIP. When using VRF-lite, you can apply this command to a specific VRF instance. Use the no variant of this command to disable the specified redistribution. The parameters metric and routemap may be used on this command, but have no effect.
Page 887
RIP C OMMANDS (RIP) REDISTRIBUTE Example To apply the metric value 15 to static routes in address-family ipv4 VRF instance blue being redistributed into RIP, use the following commands: (VRF-lite) awplus# configure terminal awplus(config)# router rip awplus(config-router)# address-family ipv4 vrf blue awplus(config-router-af)# redistribute static metric 15 Related...
RIP C OMMANDS RESTART RIP GRACEFUL restart rip graceful Overview Use this command to force the RIP process to restart, and optionally set the grace-period. restart rip graceful [grace-period <1-65535>] Syntax Mode Privileged Exec Default The default RIP grace-period is 60 seconds. Usage After this command is executed, the RIP process immediately shuts down.
RIP C OMMANDS RIP RESTART GRACE PERIOD rip restart grace-period Overview Use this command to change the grace period of RIP graceful restart. Use the no variant of this command to disable this function. Syntax rip restart grace-period <1-65535> no rip restart grace-period <1-65535> Mode Global Configuration Default...
RIP C OMMANDS (RIP) ROUTE route (RIP) Overview Use this command to add a static RIP route. Use the no variant of this command to remove a static RIP route. Syntax route <ip-addr/prefix-length> no route <ip-addr/prefix-length> Parameter Description <ip-addr/prefix-length> The IPv4 address and prefix length. Default No static RIP route is added by default.
RIP C OMMANDS ROUTER RIP router rip Overview Use this global command to enter Router Configuration mode to enable the RIP routing process. Use the no variant of this command to disable the RIP routing process. Syntax router rip no router rip Mode Global Configuration Example...
RIP C OMMANDS SEND LIFETIME send-lifetime Overview Use this command to specify the time period during which the authentication key on a key chain can be sent. send-lifetime <start-date> {<end-date>| Syntax duration <seconds>|infinite} no send-lifetime Parameter Description Specifies the start time and date in the format: <start-date>...
Page 893
RIP C OMMANDS SEND LIFETIME Related Commands key-string key chain accept-lifetime C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
RIP C OMMANDS SHOW DEBUGGING RIP show debugging rip Overview 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. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
RIP C OMMANDS SHOW IP PROTOCOLS RIP show ip protocols rip Overview Use this command to display RIP process parameters and statistics. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
Page 896
RIP C OMMANDS SHOW IP RIP show ip rip Overview Use this command to show RIP routes. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide. Syntax show ip rip Mode User Exec and Privileged Exec awplus#...
RIP C OMMANDS SHOW IP RIP DATABASE show ip rip database Overview Use this command to display information about the RIP database. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
RIP C OMMANDS SHOW IP RIP INTERFACE show ip rip interface Overview Use this command to display information about the RIP interfaces. You can specify an interface name to display information about a specific interface. show ip rip interface [<interface>] Syntax Parameter Description...
RIP C OMMANDS SHOW IP RIP VRF DATABASE show ip rip vrf database Overview Use this command to display information about the RIP database that is associated with a specific VRF instance. Entering this command with the full option included, will display information about the full RIP database (including sub-optimal routes) associated with a specific VRF instance.
RIP C OMMANDS SHOW IP RIP VRF INTERFACE show ip rip vrf interface Overview Use this command to display information about the RIP interfaces that are associated with a specific VRF instance. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
RIP C OMMANDS (RIP) TIMERS timers (RIP) Overview Use this command to adjust routing network timers. Use the no variant of this command to restore the defaults. Syntax timers basic <update> <timeout> <garbage> no timers basic Parameter Description <update> <5-2147483647> Specifies the period at which RIP route update packets are transmitted.
Page 902
RIP C OMMANDS (RIP) TIMERS To set the update timer to 30, the routing information timeout timer to 180, and the routing garbage collection timer to 120 with VRF, use the following command: awplus# configure terminal awplus(config)# router rip awplus(config-router)# address-family ipv4 vrf blue awplus(config-router-af)# timers basic 30 180 120...
RIP C OMMANDS UNDEBUG RIP undebug rip Overview 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...
RIP C OMMANDS (RIP) VERSION version (RIP) Overview Use this command to specify a RIP version used globally by the router. If VRF-lite is configured, you can specify a RIP version either globally, or for a particular VRF instance. Use the no variant of this command to restore the default version. version {1|2} Syntax no version...
RIPng for IPv6 Commands Introduction Overview This chapter contains RIPng commands. RIPng (Routing Information Protocol next generation) is an extension of RIPv2 to support IPv6. RFC 2080 specifies RIPng. The differences between RIPv2 and RIPng are: • RIPng does not support RIP updates authentication •...
Page 906
NG FOR OMMANDS • “router ipv6 rip” on page 923 • “show debugging ipv6 rip” on page 924 • “show ipv6 protocols rip” on page 925 • “show ipv6 rip” on page 926 • “show ipv6 rip database” on page 927 •...
NG FOR OMMANDS 6 RIP AGGREGATE ADDRESS aggregate-address (IPv6 RIPng) Overview Use this command to add an aggregate route to RIPng. Use the no variant of this command to remove the aggregate route from RIPng. Syntax aggregate-address <ipv6-addr/prefix-length> no aggregate-address <ipv6-addr/prefix-length> Parameter Description <ipv6-addr/prefix-length>...
NG FOR OMMANDS CLEAR IPV RIP ROUTE clear ipv6 rip route Overview Use this command to clear specific data from the RIPng routing table. clear ipv6 rip route Syntax {<ipv6-addr/prefix-length>|all|connected|rip|static|ospf} Parameter Description <ipv6-addr/ Specify the IPv6 Address in format X:X::X:X/Prefix-Length. prefix-length>...
NG FOR OMMANDS DEBUG IPV debug ipv6 rip Overview Use this command to enable RIPng debugging and specify debugging for RIPng events, RIPng packets, or RIPng communication with NSM processes. Use the no variant of this command to disable RIPng debugging. Syntax debug ipv6 rip [all|events|nsm|packet [detail]|recv [detail]|send [detail]]...
NG FOR OMMANDS 6 RIP DEFAULT INFORMATION ORIGINATE default-information originate (IPv6 RIPng) Overview Use this command to generate a default route into RIPng. Use the no variant of this command to disable this feature. Syntax default-information originate no default-information originate Default Disabled Mode...
NG FOR OMMANDS 6 RIP DEFAULT METRIC default-metric (IPv6 RIPng) Overview Use this command to specify the metrics to be assigned to redistributed RIPng routes. Use the no variant of this command to reset the RIPng metric back to its default (1). Syntax default-metric <1-16>...
NG FOR OMMANDS 6 RIP DISTRIBUTE LIST distribute-list (IPv6 RIPng) Overview Use this command to filter incoming or outgoing route updates using the access-list or the prefix-list. Use the no variant of this command to disable this feature. Syntax distribute-list [<access-list>|prefix <prefix-list-name>] [in|out] [<interface>] no distribute-list [<access-list>|prefix <prefix-list-name>] [in|out] [<interface>]...
NG FOR OMMANDS RIP METRIC OFFSET ipv6 rip metric-offset Overview Use this command to increment the metric value on incoming routes for a specified interface. This command can be used to artificially inflate the metric value for routes learned on the specified interface. Routes learned on the specified interface are only used if the routes to the same destination with a lower metric value in the routing table are down.
Page 914
NG FOR OMMANDS RIP METRIC OFFSET Examples To increment the metric-offset on the VLAN interface vlan2, enter the below commands: awplus# configure terminal awplus(config)# router ipv6 rip awplus(config-router)# exit awplus(config)# interface vlan2 awplus(config-if)# ipv6 rip metric-offset 1 To reset the metric-offset on the VLAN interface vlan2 to the default value, enter the below commands: awplus# configure terminal...
NG FOR OMMANDS RIP SPLIT HORIZON ipv6 rip split-horizon Overview Use this command to perform the split-horizon action on the interface. The default is split-horizon with poisoned reverse. Use the no variant of this command to disable this function. Syntax ipv6 rip split-horizon [poisoned] no ipv6 rip split-horizon Parameter...
NG FOR OMMANDS ROUTER RIP ipv6 router rip Overview Use this command to enable RIPng routing on an interface. Use the no variant of this command to disable RIPng routing on an interface. Syntax ipv6 router rip no ipv6 router rip Default RIPng routing is disabled by default.
NG FOR OMMANDS 6 RIP NEIGHBOR neighbor (IPv6 RIPng) Overview Use this command to specify a neighbor router. Use the no variant of this command to disable the specific router. Syntax neighbor <ipv6-link-local-addr> <interface> no neighbor <ipv6-link-local-addr> <interface> Parameter Description <ipv6-link-local-addr>...
NG FOR OMMANDS 6 RIP OFFSET LIST offset-list (IPv6 RIPng) Overview Use this command to add an offset to in and out metrics to routes learned through RIPng. Use the no variant of this command to remove an offset list. Syntax offset-list {<access-list-number>|<access-list-name>} {in|out} <offset>...
NG FOR OMMANDS 6 RIP PASSIVE INTERFACE passive-interface (IPv6 RIPng) Overview Use this command to enable suppression of routing updates on an interface. Use the no variant of this command to disable this function. Syntax passive-interface <interface> no passive-interface <interface> Parameter Description <interface>...
NG FOR OMMANDS 6 RIP RECV BUFFER SIZE recv-buffer-size (IPv6 RIPng) Overview Use this command to configure the RIPng UDP (User Datagram Protocol) receive-buffer size. This should improve UDP reliability by avoiding UDP receive buffer overruns. Use the no variant of this command to unset the configured RIPng UDP receive-buffer size and set it back to the system default of 196608 bits.
NG FOR OMMANDS 6 RIP REDISTRIBUTE redistribute (IPv6 RIPng) Overview Use this command to redistribute information from other routing protocols into RIPng. Use the no variant of this command to disable the specified redistribution. The parameters metric and routemap may be used on this command, but have no effect.
NG FOR OMMANDS 6 RIP ROUTE route (IPv6 RIPng) Overview Use this command to configure static RIPng routes. Use the no variant of this command to disable this function. Syntax route <ipv6-addr/prefix-length> no route <ipv6-addr/prefix-length> Parameter Description <ipv6-addr/prefix-length> Specify the IPv6 Address in format X:X::X:X/Prefix- Length.
NG FOR OMMANDS ROUTER IPV router ipv6 rip Overview Use this global command to enter Router Configuration mode to enable a RIPng routing process. Use the no variant of this command to disable the RIPng routing process. Syntax router ipv6 rip no router ipv6 rip Mode Global Configuration...
NG FOR OMMANDS SHOW DEBUGGING IPV show debugging ipv6 rip Overview Use this command to display the RIPng debugging status for the debugging options of: nsm debugging, RIPng event debugging, RIPng packet debugging, and RIPng nsm debugging. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
NG FOR OMMANDS SHOW IPV PROTOCOLS RIP show ipv6 protocols rip Overview Use this command to display RIPng process parameters and statistics. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
NG FOR OMMANDS SHOW IPV show ipv6 rip Overview Use this command to show RIPng routes. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide. Syntax show ipv6 rip Mode User Exec and Privileged Exec Example...
NG FOR OMMANDS SHOW IPV RIP DATABASE show ipv6 rip database Overview Use this command to display information about the RIPng database. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus” Feature Overview and Configuration Guide.
NG FOR OMMANDS SHOW IPV RIP INTERFACE show ipv6 rip interface Overview Use this command to display information about the RIPng interfaces. You can specify an interface name to display information about a specific interface. For information on filtering and saving command output, see the “Getting Started with AlliedWare Plus”...
NG FOR OMMANDS 6 RIP TIMERS timers (IPv6 RIPng) Overview Use this command to adjust the RIPng routing network timers. Use the no variant of this command to restore the defaults. Syntax timers basic <update> <timeout> <garbage> no timers basic Parameter Description <update>...
NG FOR OMMANDS UNDEBUG IPV undebug ipv6 rip Overview Use this command to disable debugging options of RIPng events, RIPng packets, and communication between RIPng and NSM processes. undebug ipv6 rip [all|events|nsm|packet [recv|send][detail]] Syntax Parameter Description Disables all RIPng debugging. events Disable the display of RIPng events information.
OSPF Commands Introduction Overview This chapter provides an alphabetical reference of commands used to configure OSPF. For more information, see the OSPF Feature Overview and Configuration Guide. Command List • “area default-cost” on page 934 • “area authentication” on page 935 •...
Page 932
OSPF C OMMANDS • “debug ospf route” on page 958 • “default-information originate” on page 959 • “default-metric (OSPF)” on page 960 • “distance (OSPF)” on page 961 • “distribute-list (OSPF)” on page 963 • “enable db-summary-opt” on page 966 •...
Page 933
OSPF C OMMANDS • “router ospf” on page 1000 • “router-id” on page 1002 • “show debugging ospf” on page 1003 • “show ip ospf” on page 1004 • “show ip ospf border-routers” on page 1007 • “show ip ospf database”...
OSPF C OMMANDS AREA DEFAULT COST area default-cost Overview This command specifies a cost for the default summary route sent into a stub or NSSA area. The no variant of this command removes the assigned default-route cost. Syntax area <area-id> default-cost <0-16777215> no area <area-id>...
OSPF C OMMANDS AREA AUTHENTICATION area authentication Overview Use this command to enable authentication for an OSPF area. Specifying the area authentication sets the authentication to Type 1 authentication or the Simple Text password authentication (details in RFC 2328). The no variant of this command removes the authentication specification for an area.
OSPF C OMMANDS AREA FILTER LIST area filter-list Overview 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 the prefix-list command.
OSPF C OMMANDS AREA NSSA area nssa Overview 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 938
OSPF C OMMANDS AREA NSSA Parameter Description <role> The role type. Specify one of the following keywords: always Router always translate NSSA- LSA to Type-5 LSA. candidate Router may translate NSSA-LSA to Type-5 LSA if it is elected. never Router never translate NSSA- LSA.
OSPF C OMMANDS AREA RANGE area range Overview Use this command to summarize OSPF routes at an area boundary, configuring an IPv4 address range which consolidates OSPF routes. By default, this feature is not enabled. A summary route created by this command is then advertised to other areas by the Area Border Routers (ABRs).
Page 940
OSPF C OMMANDS AREA RANGE Ensure OSPF IPv4 routes exist in the area range for advertisement before using this command. awplus# configure terminal Example awplus(config)# router ospf 100 awplus(config-router)# area 1 range 192.16.0.0/16 awplus(config-router)# area 1 range 203.18.0.0/16 C613-50188-01 Rev B Command Reference for SwitchBlade®...
OSPF C OMMANDS AREA STUB area stub Overview This command defines an OSPF area as a stub area. By default, no stub area is defined. Use this command when routers in the area do not require learning about summary LSAs from other areas. You can define the area as a totally stubby area by configuring the Area Border Router of that area using the area stub no-summary command.
OSPF C OMMANDS AREA VIRTUAL LINK area virtual-link Overview This command configures a link between two backbone areas that are physically separated through other non-backbone 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.
Page 943
OSPF C OMMANDS AREA VIRTUAL LINK Parameter Description message-digest Use message-digest authentication. null Use null authentication to override password or message digest. dead-interval If no packets are received from a particular neighbor for dead-interval seconds, the router considers that neighboring router as being off-line.
OSPF C OMMANDS AREA VIRTUAL LINK Related area authentication Commands show ip ospf show ip ospf virtual-links C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
OSPF C OMMANDS AUTO COST REFERENCE BANDWIDTH auto-cost reference bandwidth Overview This command controls how OSPF calculates default metrics for the interface. Use the no variant of this command to assign cost based only on the interface bandwidth. Syntax auto-cost reference-bandwidth <1-4294967> no auto-cost reference-bandwidth Parameter Description...
Page 946
OSPF C OMMANDS AUTO COST REFERENCE BANDWIDTH Calculation result = 0.1 Result after rounding up to the nearest integer = 1 (Interface cost is 1) The auto-cost reference bandwidth value should be consistent across all OSPF routers in the OSPF process. Note that using the ip ospf cost command on a layer 3 interface will override the...
OSPF C OMMANDS BANDWIDTH bandwidth Overview Use this command to specify the maximum bandwidth to be used for each VLAN interface. The bandwidth value is in bits per second. OSPF uses this to calculate metrics for the VLAN interface. The no variant of this command removes any applied bandwidth value and replaces it with a value equal to the lowest port speed within that VLAN.
OSPF C OMMANDS CAPABILITY OPAQUE capability opaque Overview This command enables opaque-LSAs. Opaque-LSAs are Type 9, 10 and 11 LSAs that deliver information used by external applications. Use the no variant of this command to disable opaque-LSAs. Syntax capability opaque no capability opaque Default By default, opaque-LSAs are enabled.
OSPF C OMMANDS CAPABILITY RESTART capability restart Overview This command enables OSPF Graceful Restart or restart signaling features. By default, this is enabled. Use the no variant of this command to disable OSPF Graceful Restart and restart signaling features. Syntax capability restart [graceful|signaling] no capability restart Parameter...
OSPF C OMMANDS CLEAR IP OSPF PROCESS clear ip ospf process Overview This command clears and restarts the OSPF routing process. Specify the Process ID to clear one particular OSPF process. When no Process ID is specified, this command clears all running OSPF processes. clear ip ospf [<0-65535>] process Syntax Parameter...
OSPF C OMMANDS 1583 COMPATIBLE RFC compatible rfc1583 Overview This command changes the method used to calculate summary route to the that specified in RFC 1583. By default, OSPF uses the method specified in RFC 2328. RFC 1583 specifies a method for calculating the metric for summary routes based on the minimum metric of the component paths available.
OSPF C OMMANDS DEBUG OSPF EVENTS debug ospf events Overview 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 variant of this command disable OSPF debugging. Use this command without parameters to disable all the options.
OSPF C OMMANDS DEBUG OSPF IFSM debug ospf ifsm Overview 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 variant of this command disable OSPF IFSM debugging. Use this command without parameters to disable all the options.
OSPF C OMMANDS DEBUG OSPF LSA debug ospf lsa Overview 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.
OSPF C OMMANDS DEBUG OSPF NFSM debug ospf nfsm Overview 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 variant of this command disable OSPF NFSM debugging. Use this command without parameters to disable all the options.
OSPF C OMMANDS DEBUG OSPF NSM debug ospf nsm Overview 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 variant of this command disable OSPF NSM debugging. Use this command without parameters to disable both options.
OSPF C OMMANDS DEBUG OSPF PACKET debug ospf packet Overview 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 variant of this command disable OSPF packet debugging. Use this command without parameters to disable all options.
OSPF C OMMANDS DEBUG OSPF ROUTE debug ospf route Overview 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 route with no additional parameters.
OSPF C OMMANDS DEFAULT INFORMATION ORIGINATE default-information originate Overview 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).
OSPF C OMMANDS (OSPF) DEFAULT METRIC default-metric (OSPF) Overview This command sets default metric values for the OSPF routing protocol. The no variant of this command returns OSPF to using built-in, automatic metric translations, as appropriate for each routing protocol. Syntax default-metric <1-16777214>...
OSPF C OMMANDS (OSPF) DISTANCE distance (OSPF) Overview 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).
OSPF C OMMANDS (OSPF) DISTANCE • 10 for intra-area routes • 40 for external routes use the commands: awplus(config)# router ospf 100 awplus(config-router)# distance ospf inter-area 20 intra-area 10 external 40 To set the administrative distance for all routes in OSPF 100 back to the default of 110, use the commands: awplus(config)# router ospf 100...
OSPF C OMMANDS (OSPF) DISTRIBUTE LIST distribute-list (OSPF) Overview Use this command to apply filtering to the transfer of routing information between OSPF and the IP route table. You can apply filtering in either direction, from OSPF to the IP route table using an in distribute-list, or from the IP route table to OSPF using an out distribute-list.
Page 964
OSPF C OMMANDS (OSPF) DISTRIBUTE LIST Usage There are in and out distribute-lists, which carry out different route filtering activities: • The in distribute list is applied to the process of installing OSPF routes into the IP route table. The SPF calculation generate a set of routes calculated from the LSA database.
OSPF C OMMANDS (OSPF) DISTRIBUTE LIST Related match interface Commands redistribute (OSPF) route-map C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
OSPF C OMMANDS ENABLE DB SUMMARY enable db-summary-opt Overview This command enables OSPF database summary list optimization. The no variant of this command disables database summary list optimization. Syntax enable db-summary-opt no enable db-summary-opt Default The default setting is disabled. Mode Router Configuration Usage...
OSPF C OMMANDS HOST AREA host area Overview 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. The no variant of this command removes the host area configuration.
OSPF C OMMANDS IP OSPF AUTHENTICATION ip ospf authentication Overview This command sets the authentication method used when sending and receiving OSPF packets on the current VLAN interface. The default is to use no authentication. If no authentication method is specified in this command, then plain text authentication will be used.
OSPF C OMMANDS IP OSPF AUTHENTICATION ip ospf authentication-key Overview This command specifies an OSPF authentication password for the neighboring routers. The no variant of this command removes the OSPF authentication password. Syntax ip ospf [<ip-address>] authentication-key <pswd-long> no ip ospf [<ip-address>] authentication-key Parameter Description <ip-address>...
OSPF C OMMANDS IP OSPF COST ip ospf cost Overview This command explicitly specifies the cost of the link-state metric in a router-LSA. The no variant of this command resets the VLAN interface cost to the default. Syntax ip ospf [<ip-address>] cost <1-65535> no ip ospf [<ip-address>] cost Parameter Description...
OSPF C OMMANDS IP OSPF DATABASE FILTER ip ospf database-filter Overview This command turns on the LSA database-filter for a particular VLAN interface. The no variant of this command turns off the LSA database-filter. Syntax ip ospf [<ip-address>] database-filter all out no ip ospf [<ip-address>] database-filter Parameter Description...
OSPF C OMMANDS IP OSPF DEAD INTERVAL ip ospf dead-interval Overview This command sets the interval during which no hello packets are received and after which a neighbor is declared dead. 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.
OSPF C OMMANDS IP OSPF DISABLE ALL ip ospf disable all Overview This command completely disables OSPF packet processing on a VLAN interface. It overrides the network area command and disables the processing of packets on the specific interface. Use the no variant of this command to restore OSPF packet processing on a selected interface.
OSPF C OMMANDS IP OSPF HELLO INTERVAL ip ospf hello-interval Overview This command specifies the interval between hello packets. The hello-interval is advertised in the hello packets. Configure the same hello-interval for all routers on a specific network. A shorter hello interval ensures faster detection of topological changes, but results in more routing traffic.
OSPF C OMMANDS IP OSPF MESSAGE DIGEST ip ospf message-digest-key Overview 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 976
OSPF C OMMANDS IP OSPF MESSAGE DIGEST Examples The following example shows OSPF authentication on the VLAN interface vlan5 when IP address has not been specified. awplus# configure terminal awplus(config)# interface vlan5 awplus(config-if)# ip ospf authentication message-digest awplus(config-if)# ip ospf message-digest-key 1 md5 yourpass The following example shows configuring OSPF authentication on the VLAN interface vlan2 for the IP address 1.1.1.1.
OSPF C OMMANDS IP OSPF MTU ip ospf mtu Overview This command sets the MTU size for OSPF. Whenever OSPF constructs packets, it uses VLAN interface MTU size as Maximum IP packet size. This command forces OSPF to use the specified value, overriding the actual VLAN interface MTU size. Use the no variant of this command to return the MTU size to the default.
OSPF C OMMANDS IP OSPF MTU IGNORE ip ospf mtu-ignore Overview Use this command to configure OSPF so that OSPF does not check the MTU size during DD (Database Description) exchange. Use the no variant of this command to make sure that OSPF checks the MTU size during DD exchange.
OSPF C OMMANDS IP OSPF NETWORK ip ospf network Overview This command configures the OSPF network type to a type different from the default for the particular VLAN interface. The no variant of this command returns the network type to the default for the particular VLAN interface.
OSPF C OMMANDS IP OSPF PRIORITY ip ospf priority Overview This command sets the router priority, which is a parameter used in the election of the designated router for the network. The no variant of this command returns the router priority to the default of 1. Syntax ip ospf [<ip-address>] priority <priority>...
OSPF C OMMANDS IP OSPF RESYNC TIMEOUT ip ospf resync-timeout Overview 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 variant of this command to return to the default.
OSPF C OMMANDS IP OSPF RETRANSMIT INTERVAL ip ospf retransmit-interval Overview Use this command to specify the time between link-state advertisement (LSA) retransmissions for adjacencies belonging to the interface. Use the no variant of this command to return to the default of 5 seconds. Syntax ip ospf [<ip-address>] retransmit-interval <1-65535>...
OSPF C OMMANDS IP OSPF TRANSMIT DELAY ip ospf transmit-delay Overview Use this command to set the estimated time it takes to transmit a link-state-update packet on the VLAN interface. Use the no variant of this command to return to the default of 1 second. Syntax ip ospf [<ip-address>] transmit-delay <1-65535>...
OSPF C OMMANDS CONCURRENT max-concurrent-dd Overview Use this command to set the limit for the number of Database Descriptors (DD) that can be processed concurrently. Use the no variant of this command to reset the limit for the number of Database Descriptors (DD) that can be processed concurrently.
OSPF C OMMANDS MAXIMUM AREA maximum-area Overview Use this command to set the maximum number of OSPF areas. Use the no variant of this command to set the maximum number of OSPF areas to the default. Syntax maximum-area <1-4294967294> no maximum-area Parameter Description <1-4294967294>...
OSPF C OMMANDS (OSPF) NEIGHBOR neighbor (OSPF) Overview Use this command to inform the router of other neighboring routers that are connected to the same NBMA network. Use the no variant of this command to remove a configuration. Syntax neighbor <ip-address> [<cost>]{<priority>|<poll-interval>} no neighbor <ip-address>...
OSPF C OMMANDS NETWORK AREA network area Overview Use this command to enable OSPF routing with a specified Area ID on any interfaces with IP addresses that match the specified network address. Use the no variant of this command to disable OSPF routing on the interfaces. Syntax network <network-address>...
Page 988
OSPF C OMMANDS NETWORK AREA The following commands disable OSPF routing with Area ID 3 on all interfaces: awplus# configure terminal awplus(config)# router ospf 100 awplus(config-router)# no network 10.0.0.0/8 area3 C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™...
OSPF C OMMANDS OSPF ABR TYPE ospf abr-type Overview Use this command to set an OSPF Area Border Router (ABR) type. Use the no variant of 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...
OSPF C OMMANDS OSPF RESTART GRACE PERIOD ospf restart grace-period Overview Use this command to configure the grace-period for restarting OSPF routing. Use the no variant of this command to revert to the default grace-period. Syntax ospf restart grace-period <1-1800> no ospf restart grace-period Parameter Description...
OSPF C OMMANDS OSPF RESTART HELPER ospf restart helper Overview Use this command to configure the helper behavior for the OSPF Graceful Restart feature. Use the no variant of this command to revert to the default grace-period. Syntax ospf restart helper {max-grace-period <grace-period>|only-reload|only-upgrade} ospf restart helper {never router-id <router-id>} no ospf restart helper [max-grace-period]...
OSPF C OMMANDS OSPF RESTART HELPER Related ospf restart grace-period Commands restart ospf graceful C613-50188-01 Rev B Command Reference for SwitchBlade® x908 Generation 2 Series AlliedWare Plus™ Operating System - Version 5.4.7B-1.x...
OSPF C OMMANDS OSPF ROUTER ospf router-id Overview Use this command to specify a router ID for the OSPF process. Use the no variant of this command to disable this function. Syntax ospf router-id <ip-address> no ospf router-id Parameter Description <ip-address>...
OSPF C OMMANDS OVERFLOW DATABASE overflow database Overview 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 variant of this command to have no limit on the maximum number of LSAs.
OSPF C OMMANDS OVERFLOW DATABASE EXTERNAL overflow database external Overview 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 variant of this command to revert to default. Syntax overflow database external <max-lsas>...
OSPF C OMMANDS (OSPF) PASSIVE INTERFACE passive-interface (OSPF) Overview Use this command to suppress the sending of Hello packets on all interfaces, or on a specified interface. If you use the passive-interface command without the optional parameters then all interfaces are put into passive mode. Use the no variant of this command to allow the sending of Hello packets on all interfaces, or on the specified interface.
OSPF C OMMANDS (OSPF) REDISTRIBUTE redistribute (OSPF) Overview Use this command to redistribute routes from other routing protocols, static routes and connected routes into an OSPF routing table. Use the no variant of this command to disable this function. Syntax redistribute {bgp|connected|rip|static} {metric <0-16777214>|metric-type {1|2}|route-map <name>|tag <0-4294967295>}...
Page 998
OSPF C OMMANDS (OSPF) REDISTRIBUTE Example The following example shows redistribution of BGP routes into OSPF routing table 100, with metric 12. awplus# configure terminal awplus(config)# router ospf 100 awplus(config-router)# redistribute bgp metric 12 The following example shows the configuration of a route-map named rmap2, which is then applied using the redistribute route-map command, so routes learned via interface vlan1 can be redistributed as type-1 external LSAs: awplus#...
OSPF C OMMANDS RESTART OSPF GRACEFUL restart ospf graceful Overview Use this command to force the OSPF process to restart, and optionally set the grace-period. restart ospf graceful [grace-period <1-1800>] Syntax Parameter Description grace-period Specify the grace period. <1-1800> The grace period in seconds. Default In the AlliedWare Plus™...
OSPF C OMMANDS ROUTER OSPF router ospf Overview Use this command to enter Router Configuration mode to configure an OSPF routing process. You must specify the process ID with this command for multiple OSPF routing processes on the device. Use the no variant of this command to terminate an OSPF routing process. Use the no parameter with the process-id parameter, to terminate and delete a specific OSPF routing process.
Need help?
Do you have a question about the SBx908 GEN2 and is the answer not in the manual?
Questions and answers