Brocade Communications Systems Switch 53 1001762 01 User Manual

DRAFT: BROCADE CONFIDENTIAL  
53-1001762-01  
30 March 2010  
®
Converged Enhanced  
Ethernet Command  
Reference  
Supporting Fabric OS v6.4.0  
 
DRAFT: BROCADE CONFIDENTIAL  
Contents  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
iii  
 
iv  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
v
 
vi  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
vii  
 
viii  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
ix  
 
x
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
DRAFT: BROCADE CONFIDENTIAL  
About This Document  
In this chapter  
How this document is organized  
This document is organized to help you find the information that you want as quickly and easily as  
possible.  
The document contains the following components:  
Chapter 1, “CLI Basics” describes how to access the switch and the CEE CLI command modes.  
Chapter 2, “Configuration Management Commands”describes the commands to manage the  
configuration files and includes other file management commands.  
Chapter 3, “VLAN Commands” describes the commands to create and manage Virtual LAN  
interfaces.  
Chapter 4, “Interface Commands” describes the commands to configure interfaces.  
Chapter 5, “Link Layer Discovery Protocol Commands” describes the commands that support  
the Link Layer Discovery Protocol (LLDP) implementation.  
counters of all LACP aggregators or a given LACP aggregator.  
Chapter 7, “Layer 2 System Commands” describes the commands to configure Layer 2  
features.  
Chapter 8, “Layer 2 ACL commands” describes the commands to configure, manage, and view  
MAC addresses.  
Chapter 9, “Spanning Tree Protocol Commands” describes the commands to configure the  
Spanning Tree Protocol (STP), Rapid Spanning Tree Protocol (RSTP), and Multiple Spanning  
Tree Protocol (MSTP).  
used to configure and maintain IGMP snooping.  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
xi  
 
     
DRAFT: BROCADE CONFIDENTIAL  
Chapter 11, “RMON Commands” describes the Remote Network Monitoring (RMON)  
commands used to monitor and collect long-term statistics.  
Chapter 12, “QoS Commands” describes the commands used to enable Quality of Service on  
the device.  
Chapter 13, “Port Authentication Commands” describes the 802.1x port authentication  
configuration commands.  
Supported hardware and software  
This document includes updated information specific to Fabric OS 6.4.0. The following hardware  
platforms are supported in this release:  
Brocade 300  
Brocade 4100  
Brocade 4900  
Brocade 5000  
Brocade 5100  
Brocade 5300  
Brocade 5410  
Brocade 5424  
Brocade 5450  
Brocade 5480  
Brocade 7500  
Brocade 7500E  
Brocade 7600  
Brocade 7800  
Brocade 8000  
Brocade Encryption Switch  
Brocade VA-40FC  
Brocade 48000  
Brocade DCX  
Brocade DCX-4S  
Within this manual, any appearance of the term “Brocade FCoE hardware” is referring to:  
Brocade 8000  
Brocade FCOE10-24 port blade  
Although many different software and hardware configurations are tested and supported by  
Brocade Communications Systems, Inc. for Fabric OS 6.4.0, documenting all possible  
configurations and scenarios is beyond the scope of this document.  
To obtain information about an OS version other than 6.4.0, refer to the documentation specific to  
that OS version.  
xii  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
What’s new in this document  
This document has been updated for 6.4.0.  
New commands have been added for:  
Internet Group Management Protocol  
For further information about new features and documentation updates for this release, refer to  
the release notes.  
Document conventions  
This section describes text formatting conventions and important notice formats used in this  
document.  
Text formatting  
The narrative-text formatting conventions that are used are as follows:  
bold text  
italic text  
codetext  
Identifies command names  
Identifies the names of user-manipulated GUI elements  
Identifies keywords and operands  
Identifies text to enter at the GUI or CLI  
Provides emphasis  
Identifies variables  
Identifies paths and Internet addresses  
Identifies document titles  
Identifies CLI output  
Identifies command syntax examples  
For readability, command names in the narrative portions of this guide are presented in mixed  
lettercase: for example, switchShow. In actual examples, command lettercase is all lowercase.  
.
Command syntax conventions  
Command syntax in this manual follows these conventions:  
TABLE 1  
Command syntax conventions  
Description  
Convention  
bold face font  
Commands and keywords.  
italic  
Variables for which you supply values.  
[ ]  
Keywords or arguments that appear within square brackets are  
optional.  
{x | y | z}  
A choice of required keywords appears in braces separated by vertical  
bars. You must select one.  
screen font  
Examples of information displayed on the screen.  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
xiii  
 
       
DRAFT: BROCADE CONFIDENTIAL  
TABLE 1  
Command syntax conventions  
Description  
Convention  
<>  
Nonprinting characters, for example passwords, appear in angle  
brackets  
[ ]  
Default responses to system prompts appear in square brackets.  
Notes, cautions, and warnings  
The following notices and statements are used in this manual. They are listed below in order of  
increasing severity of potential hazards.  
NOTE  
A note provides a tip, guidance, or advice, emphasizes important information, or provides a  
reference to related information.  
ATTENTION  
An Attention statement indicates potential damage to hardware or data.  
CAUTION  
A Caution statement alerts you to situations that can be potentially hazardous to you or cause  
damage to hardware, firmware, software, or data.  
DANGER  
A Danger statement indicates conditions or situations that can be potentially lethal or extremely  
hazardous to you. Safety labels are also attached directly to products to warn of these conditions  
or situations.  
Key terms  
For definitions specific to Brocade and Fibre Channel, see the technical glossaries on Brocade  
Connect. See “Brocade resources” on page xv for instructions on accessing Brocade Connect.  
Notice to the reader  
This document may contain references to the trademarks of the following corporations. These  
trademarks are the properties of their respective companies and corporations.  
These references are made for informational purposes only.  
Corporation  
Referenced Trademarks and Products  
Microsoft Corporation  
Oracle Corporation  
Windows, Windows NT, Internet Explorer  
Oracle, Java  
xiv  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
     
DRAFT: BROCADE CONFIDENTIAL  
Corporation  
Referenced Trademarks and Products  
Netscape Communications Corporation  
Red Hat, Inc.  
Netscape  
Red Hat, Red Hat Network, Maximum RPM, Linux Undercover  
Additional information  
This section lists additional Brocade and industry-specific documentation that you might find  
helpful.  
Brocade resources  
To get up-to-the-minute information, go to http://my.brocade.com and register at no cost for a user  
ID and password.  
White papers, online demonstrations, and data sheets are available through the Brocade website  
at:  
For additional Brocade documentation, visit the Brocade website:  
Release notes are available on the Brocade Connect website and are also bundled with the Fabric  
OS firmware.  
Other industry resources  
White papers, online demonstrations, and data sheets are available through the Brocade website  
Best practice guides, white papers, data sheets, and other documentation is available through  
the Brocade Partner website.  
For additional resource information, visit the Technical Committee T11 website. This website  
provides interface standards for high-performance and mass storage applications for Fibre  
Channel, storage management, and other applications:  
For information about the Fibre Channel industry, visit the Fibre Channel Industry Association  
website:  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
xv  
 
     
DRAFT: BROCADE CONFIDENTIAL  
Getting technical help  
Contact your switch support supplier for hardware, firmware, and software support, including  
product repairs and part ordering. To expedite your call, have the following information available:  
1. General Information  
Switch model  
Switch operating system version  
Error numbers and messages received  
supportSave command output  
Detailed description of the problem, including the switch or fabric behavior immediately  
following the problem, and specific questions  
Description of any troubleshooting steps already performed and the results  
Serial console and Telnet session logs  
syslog message logs  
2. Switch Serial Number  
The switch serial number and corresponding bar code are provided on the serial number label,  
as illustrated below:  
*FT00X0054E9*  
FT00X0054E9  
The serial number label is located as follows:  
Brocade 300, 4100, 4900, 5100, 5300, 7500, 7800, 8000, VA-40FC, and Brocade  
Encryption Switch—On the switch ID pull-out tab located inside the chassis on the port side  
on the left  
Brocade 5000—On the switch ID pull-out tab located on the bottom of the port side of the  
switch  
Brocade 7600—On the bottom of the chassis  
Brocade 48000—Inside the chassis next to the power supply bays  
Brocade DCX—On the bottom right on the port side of the chassis  
Brocade DCX-4S—On the bottom right on the port side of the chassis, directly above the  
cable management comb  
3. World Wide Name (WWN)  
Use the licenseIdShow command to display the WWN of the chassis.  
If you cannot use the licenseIdShow command because the switch is inoperable, you can get  
the WWN from the same place as the serial number, except for the Brocade DCX. For the  
Brocade DCX, access the numbers on the WWN cards by removing the Brocade logo plate at  
the top of the nonport side of the chassis.  
xvi  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
Document feedback  
Quality is our first concern at Brocade and we have made every effort to ensure the accuracy and  
completeness of this document. However, if you find an error or an omission, or you think that a  
topic needs further development, we want to hear from you. Forward your feedback to:  
documentation@brocade.com  
Provide the title and version number of the document and as much detail as possible about your  
comment, including the topic heading and page number and your suggestions for improvement.  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
xvii  
 
 
DRAFT: BROCADE CONFIDENTIAL  
xviii  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
DRAFT: BROCADE CONFIDENTIAL  
Chapter  
CLI Basics  
1
In this chapter  
Accessing the Brocade CEE Switch  
After you log on to the switch, you can access the commands through a serial terminal port or a  
Telnet session. When you Telnet into the switch, you are prompted to enter a login name and  
password. When you log on to a switch supporting CEE, all of the 10 Gbps ports are disabled and  
must be enabled. Refer to the Fibre Channel over Ethernet Administrator’s Guide for information  
regarding feature configuration and management procedures.  
Following is an example of logging in to a switch supporting FCoE and CEE.  
telnet 10.32.152.21  
switch login: admin  
Password:xxxxxx  
switch cmsh – cmsh takes you to the CEE Brocade8000 CLI prompt.  
switch>  
CLI command modes  
Following are the main command modes for the Brocade FCoE hardware:  
EXEC  
Privileged EXEC  
Global configuration  
Interface configuration  
Feature configuration  
CEE map: switch (config-ceemap)  
Standard ACL: switch (conf-macl-std)  
Extended ACL: switch (conf-macl-ext)  
Console and VTY (line) configuration  
Table 2 lists the main command modes, how to access each mode, the prompt you see in that  
mode, and how to exit that mode. The prompts listed use the default name switch.  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
1
 
         
DRAFT: BROCADE CONFIDENTIAL  
CLI command modes  
1
TABLE 2  
Accessing the CEE CLI command modes  
Prompt  
Command  
mode  
How to access the command mode  
Description  
EXEC  
switch>  
switch#  
Enter the cmsh command at the  
Fabric OS prompt after you have  
logged in as an appropriate user.  
Display running system information  
and set terminal line parameters.  
Privileged  
EXEC  
From the EXEC mode, enter the  
enable command.  
This is the administrative mode  
which also includes EXEC mode  
commands and allows you to display  
and change system parameters.  
Global  
switch(config)#  
From the EXEC mode, enter the  
Configure features that affect the  
configuration  
configure terminal EXEC command. entire switch.  
Interface  
configuration  
Port-channel:  
switch (conf-if-po-63)#  
From the global configuration mode, Access and configure individual  
specify an interface by entering one interfaces.  
of the following interface types:  
interface port-channel  
interface tengigabitethernet  
interface vlan  
10-Gigabit Ethernet (CEE port):  
switch (conf-if-te-0/1)#  
VLAN:  
switch (conf-if-vl-1)#  
Protocol  
configuration  
LLDP:  
switch (conf-lldp)#  
From the global configuration mode, Access and configure protocols.  
specify a protocol by entering one of  
the following protocol types:  
protocol lldp  
Spanning-tree:  
protocol spanning-tree mstp  
protocol spanning-tree rstp  
protocol spanning-tree stp  
switch (conf-mstp)#  
switch (conf-rstp)#  
switch (conf-stp)#  
Feature  
configuration  
CEE map:  
switch (config-ceemap)#  
From the global configuration mode, Access and configure CEE features.  
specify a CEE feature by entering  
one of the following feature names:  
cee-map  
mac access-list  
Standard ACL:  
switch (conf-macl-std)#  
Extended ACL:  
switch (conf-macl-ext)#  
Console and switch (config-line)#  
VTY (line)  
configuration  
From the global configuration mode, Configure a terminal connected  
configure a terminal connected through the console port or a  
through the console port by entering terminal connected through a Telnet  
the line console command.  
Configure a terminal connected  
through a Telnet session by entering  
the line vty command.  
session.  
2
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
L2 ACL commands  
1
L2 ACL commands  
Use Layer 2 Media Access Control (MAC) list commands to do the following:  
Identify traffic based on the MAC-addresses, such as VLAN IDs and different encapsulations.  
Configure multiple access-lists or rules and store them in a configuration.  
After you apply the access list either to an interface, a Virtual TeletYpe (VTY), or through a  
command using the access-list keyword, it becomes effective.  
Following are the two types of access list commands:  
Standard Access Control Lists  
Standard Access Control Lists filter the traffic on a source address and block traffic close to a  
destination. There are exceptions when the address in a standard access list is not a source  
address. When using a Telnet session, for outbound VTY access lists, the address in the  
access list entry is used as a destination address instead of a source address.  
Extended Access Control Lists  
Extended Access Lists block traffic based on any given packet attribute. Use Extended access  
control lists to test source and destination addresses and other IP packet data, such as  
protocols, TCP or UDP port numbers, type of service and to provide Reflective access-lists and  
Time-based access-lists.capabilities.  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
3
 
 
DRAFT: BROCADE CONFIDENTIAL  
L2 ACL commands  
1
4
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
DRAFT: BROCADE CONFIDENTIAL  
Chapter  
Configuration Management Commands  
2
copy  
Copies one file to another location.  
Synopsis  
Operands  
copy source-file-url destination-file-url  
source-file-url  
Specifies location of the source file to be copied using one of the following  
formats:  
FLASH  
FTP  
Copies from URL [flash://]filename  
Copies from URL ftp://[username[:password]@server/path]  
Copies from URL scp://[username[:password]@server/path]  
SCP  
destination-file-url Specifies the destination file using one of the following formats:  
FLASH  
Copies to URL [flash://]filename  
FTP  
Copies to URL ftp://[username[:password]@server/path]  
Copies to URL scp://[username[:password]@server/path]  
Copies to the current running configuration.  
Copies to the current startup configuration file.  
SCP  
running-config  
startup--config  
Defaults  
There are no usage guidelines for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to copy a file to another location.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To copy the source file to a remote machine using FTP:  
switch#copy ftp://user@10.10.10.10/file1 file2  
Source password[]?  
To copy the source file from a remote machine using SCP:  
switch#copy scp://user:password@10.10.10.10/file1 file2  
To copy the source file from a local switch:  
switch#copy flash://file1 file2  
See Also  
write erase, copy running-config  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
5
 
     
DRAFT: BROCADE CONFIDENTIAL  
copy startup-config  
2
copy startup-config  
Copies the startup configuration file to a network server or a file URL.  
Synopsis  
Operands  
copy startup-config destination-file-url  
destination-file-url Specifies the destination path to which the startup-config is to be copied  
using the following formats:  
FLASH  
FTP  
Copies to URL [flash://]filename  
Copies to URL ftp://[username[:password]@server/path]  
Copies to URL scp://[username[:password]@server/path]  
SCP  
running-config Copies to the current running configuration.  
Defaults  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to copy the startup configuration file to a network server or a file URL.  
The following guidelines apply when using this command:  
Usage  
Guidelines  
An error displays if there is no startup configuration file, for example:  
switch #copy startup-config file2  
% Error: No Startup-config.  
Use the write memory command to add entries in the startup configuration file.  
Use the write erase command to delete entries from the startup configuration file.  
Examples  
To copy the startup configuration file to the local switch:  
switch#copy startup-config file2  
Building configuration...  
switch#copy startup-config flash://file2  
Building configuration...  
To copy the startup configuration file to a remote server through FTP:  
switch#copy startup-config ftp://admin@10.10.10.10/file2  
Source password[]?  
Building configuration...  
To copy the startup configuration file to a remote server through SCP:  
switch#copy startup-config scp://admin@10.10.10.10/file2  
Source password[]?  
Building configuration...  
See Also  
write erase, copy running-config  
6
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
delete  
2
delete  
Deletes a specified file from the Flash.  
Synopsis  
delete filename  
Operands  
Defaults  
filename  
Specifies the name of the file to be deleted from the Flash of the local switch  
using the following format: [flash://]filename.  
There is no default configuration for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to delete a file from the Flash. After the file is deleted, it cannot be restored.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To delete a file from the Flash:  
switch#delete file1  
% Warning: File will be deleted (from flash:)!  
Continue?(y/n):y  
[or]  
switch#delete flash://file1  
% Warning: File will be deleted (from flash:)!  
Continue?(y/n):y  
See Also  
copy startup-config  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
7
 
 
DRAFT: BROCADE CONFIDENTIAL  
dir  
2
dir  
Lists the contents of the current directory.  
Synopsis  
Operands  
Defaults  
dir  
none  
The default is the current directory.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to list the contents of the current directory.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To list the contents of the current directory:  
switch#dir  
Contents of flash://  
-rw-r-----  
-rw-r-----  
-rw-r-----  
-rw-r-----  
1276 Wed Feb 4 07:08:49 2009  
startup_rmon_config  
rmon_config  
rmon_configuration  
starup-config  
1276  
1276  
1276  
Wed Feb 4 07:10:30 2009  
Wed Feb 4 07:12:33 2009  
Wed Feb 4 10:18:15 2009  
See Also  
delete  
8
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
disable  
2
disable  
Exits the Privileged EXEC mode and returns to the EXEC mode.  
Synopsis  
disable  
Operands  
Defaults  
none  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to exit the Privileged EXEC mode and return to the EXEC mode.  
Usage  
Guidelines  
This is the only command that allows you to return to the EXEC mode. Using the exit or quit  
commands from the Privileged EXEC mode ends the session instead of returning to the EXEC  
mode.  
Examples  
See Also  
To return to the EXEC mode:  
switch#disable  
switch>  
enable, end, exit  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
9
 
 
DRAFT: BROCADE CONFIDENTIAL  
do  
2
do  
Allows you to run commands in EXEC mode from the configuration mode.  
Synopsis  
Operands  
Defaults  
do command  
command  
Specifies the command you want to run.  
There are no default configurations for this command.  
All configuration modes  
Command  
Modes  
Description  
Use this command to save time when you are configuring the switch in any configuration mode and  
you want to run a command in the Privileged EXEC mode.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To run the clear counters all command with the do command:  
switch(config)#do clear counters all  
switch(config)#  
To display the contents from the working directory using the do command:  
switch(config)#do dir  
Contents of flash://  
-rw-r-----  
-rw-r-----  
-rw-r-----  
1276 Wed Feb 4 07:08:49 2009  
startup_rmon_config  
rmon_config  
rmon_configuration  
starup-config  
1276  
1276  
1276  
Wed Feb 4 07:10:30 2009  
Wed Feb 4 07:12:33 2009  
Wed Feb 4 10:48:59 2009  
-rw-r-----  
switch(config)#  
See Also  
none  
10  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
enable  
2
enable  
Enables the Privilege EXEC mode.  
Synopsis  
enable  
Operands  
Defaults  
none  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to enable the Privileged EXEC command mode.  
Usage  
Guidelines  
To return to the EXEC mode from Privileged EXEC mode, use the disable command. Using the exit  
or quit command from the Privileged EXEC mode ends the session.  
Examples  
To enable the Privileged EXEC mode:  
switch> enable  
switch#  
See Also  
disable  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
11  
 
 
DRAFT: BROCADE CONFIDENTIAL  
end  
2
end  
Returns to the Privileged EXEC command mode from all configuration modes.  
Synopsis  
Operands  
Defaults  
end  
none  
There are no default configurations for this command.  
All configuration modes  
Command  
Modes  
Description  
Use this command to return to the Privileged EXEC command mode from any command mode.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
See Also  
To return to the Privileged EXEC mode from interface configuration mode:  
switch(config)#interface tengigabitethernet 0/0  
switch(conf-if-te-0/0)#end  
switch#  
exit, disable, enable  
12  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
erase flash  
2
erase flash  
Erases all the files from the Flash.  
Synopsis  
Operands  
Defaults  
erase flash  
none  
There are no default configurations for this command.  
Configuration mode  
Command  
Modes  
Description  
Use this command to erase the files from the Flash.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To erase the files from the Flash:  
switch#erase flash  
%% Warning: Erasing flash filesystem will remove all files in flash://.  
Continue to erase?(y/n):y  
switch#  
See Also  
dir, delete  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
13  
 
 
DRAFT: BROCADE CONFIDENTIAL  
exec-timeout  
2
exec-timeout  
Sets the interval that the EXEC command interpreter wait for user input.  
exec-timeout minutes seconds  
Synopsis  
no exec-timeout  
Operands  
Defaults  
minutes  
seconds  
Specifies the time interval in minutes. The range is 0-35791.  
Specifies the time interval in seconds. The range is 0-2147483.  
The default is 10 minutes.  
Command  
Modes  
Console and VTY (line) configuration mode  
Description  
Use this command to set the interval; the command interpreter waits for user input detected. Use  
no exec-timeout to disable the wait interval that the command interpreter waits.  
Usage  
Guidelines  
The exec-timeout command is used to set the time the Telnet session waits for an idle VTY session,  
before it time outs. An exec-timeout setting of 0 (zero) causes the Telnet session to wait indefinitely.  
Examples  
To configure the wait interval for the console session:  
switch(config)#line console 0  
switch(conf-line)#exec-timeout 2 30  
switch(config)#line vty 0 9  
switch(conf-line)#exec-timeout 30 30  
See Also  
show line, line vty, line console  
14  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
exit  
2
exit  
Exits the current mode and returns to the previous mode.  
Synopsis  
Operands  
Defaults  
exit  
none  
There are no default configurations for this command.  
All command modes  
Command  
Modes  
Description  
Use this command to exit the current mode, and return to the previous mode. When used in EXEC  
and Privileged EXEC modes, the exit command terminates the session.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To exit the Interface configuration mode, and return to the Configuration mode:  
switch(config)#interface tengigabitethernet 0/0  
switch(conf-if-te-0/0)#exit  
switch(config)#exit  
See Also  
end, enable, disable  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
15  
 
 
DRAFT: BROCADE CONFIDENTIAL  
fos  
2
fos  
Executes Fabric OS commands from the from the cmsh shell.  
Synopsis  
Operands  
Defaults  
fos command  
command  
Specifies the Fabric OS command.  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to execute the following Fabric OS commands from the cmsh shell.  
alishow  
cfgactvshow  
cfgshow  
errclear  
errshow  
fabricshow  
fcoe  
firmwareshow  
ipaddrshow  
nsallshow  
nscamshow  
nsshow  
portcfg  
portcfgshow  
portdisable  
portenable  
porterrshow  
portlogshow  
portperfshow  
portrouteshow  
portstatsclear  
portstatsshow  
slotpoweroff  
slotpoweron  
slotshow  
16  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
fos  
2
supportsave  
switchshow  
zoneshow  
Usage  
Guidelines  
The Fabric OS syntax applies to the listed commands. The fcoelogincfg, fcoelogingroup, and  
fcoelogincfg commands are not supported from cmsh shell. See the Fabric OS Command  
Reference for additional information on these commands.  
Examples  
To run the Fabric OS command switchshow from the Privilege EXEC mode:  
switch#fos switchshow  
switchName:  
switchType:  
switchState:  
switchMode:  
switchRole:  
switchDomain:  
switchId:  
switch  
76.6  
Online  
Native  
Principal  
1
fffc01  
switchWwn:  
zoning:  
switchBeacon:  
10:00:00:05:1e:76:42:00  
OFF  
OFF  
Area Port Media Speed State  
Proto  
=====================================  
0
1
2
3
4
5
6
7
8
9
0
1
2
3
4
5
6
7
8
9
--  
--  
--  
--  
--  
--  
--  
--  
--  
--  
--  
--  
--  
--  
N8  
N8  
N8  
N8  
N8  
N8  
N8  
N8  
10  
10  
10  
10  
10  
10  
No_Module  
No_Module  
No_Module  
No_Module  
No_Module  
No_Module  
No_Module  
No_Module  
Online  
Online  
Online  
Online  
Online  
FC  
FC  
FC  
FC  
FC  
FC  
FC  
FC  
FCoE F-Port 20:08:00:05:1e:76:42:00  
FCoE F-Port 20:09:00:05:1e:76:42:00  
FCoE F-Port 20:0a:00:05:1e:76:42:00  
FCoE F-Port 20:0b:00:05:1e:76:42:00  
FCoE F-Port 20:0c:00:05:1e:76:42:00  
FCoE F-Port 20:0d:00:05:1e:76:42:00  
10 10  
11 11  
12 12  
13 13  
Online  
See Also  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
17  
 
DRAFT: BROCADE CONFIDENTIAL  
line console  
2
line console  
Configures the Line configuration mode.  
Synopsis  
Operands  
Defaults  
line console 0  
none  
There are no default configurations for this command.  
Global configuration mode  
Command  
Modes  
Description  
Use this command to configure the Line configuration mode, which allows you to configure the  
virtual terminal line settings.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To configure the wait interval for the console session:  
switch>enable  
switch#configure terminal  
switch(config)#line console 0  
switch(config-line)#exec-timeout 2 30  
switch(config-line)#exit  
See Also  
show line  
18  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
line vty  
2
line vty  
Configures the virtual terminal line setting to allow you to set the wait time interval for the Telnet  
session to time out.  
Synopsis  
line vty first number last number  
Operands  
first number  
last number  
Specifies the first line number. The range of valid values is 0-31.  
Specifies the last line number. The range of valid values is 0-31.  
Defaults  
There are no default configurations for this command.  
Global configuration mode  
Command  
Modes  
Description  
Use this command to configure the virtual terminal line settings to set the exec-timeout.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To configure the wait interval for the telnet session to time out after 2 minutes, 30 seconds if there  
is no response from the user:  
switch#configure terminal  
switch(config)#line vty 23 31  
switch(conf-line)#exec-timeout 2 30  
See Also  
show line  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
19  
 
 
DRAFT: BROCADE CONFIDENTIAL  
pwd  
2
pwd  
Print Working Directory (pwd); displays the contents of the current working directory.  
Synopsis  
Operands  
Defaults  
pwd  
none  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to view the current working directory.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To view the current working directory:  
switch#pwd  
flash:  
See Also  
none  
20  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
rename  
2
rename  
Renames a file in the Flash.  
rename sourcefile renamedfile  
Synopsis  
Operands  
sourcefile  
Specifies the file name to change.  
Specifies the new name of the file.  
renamedfile  
Defaults  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to rename a file in the Flash.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To rename a file in the Flash:  
switch#rename file1 file2  
switch#dir  
Contents of flash://  
-rw-r-----  
1276  
Wed Feb 4 13:16:00 2009 file2  
See Also  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
21  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show calendar  
2
show calendar  
View the current date and time based on the switch hardware clock.  
Synopsis  
Operands  
Defaults  
show calendar  
none  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to display the current date and time based on the switch hardware clock.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To display calendar information:  
switch#show calendar  
16:33:30 UTC Tue Feb 14 2009  
See Also  
none  
22  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show clock  
2
show clock  
Displays the time and date from the system clock.  
Synopsis  
Operands  
Defaults  
show clock  
none  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to display the time and date from the system clock.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To display the time and date from the system clock:  
switch#show clock  
23:45:55.512800 UTC Wed Feb 18 2009  
See Also  
show calendar  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
23  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show environment  
2
show environment  
Displays fan, temperature, redundant power system (RPS) availability, and power information for  
the switch.  
Synopsis  
Operands  
Defaults  
show environment  
none  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to display fan, temperature, redundant power system (RPS) availability, and  
power information for the switch.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To display both fan and temperature environmental status:  
switch#show environment  
-- Fan Status --  
Fan 1 is Ok  
Fan 2 is Ok  
Fan 3 is Ok  
-- Power Supplies --  
PS0 is OK  
PS1 is faulty  
-- Unit Environment Status  
--  
Sensor State  
ID  
Centigrade  
Fahrenheit  
=================================================  
1
2
3
4
Ok  
Ok  
Ok  
Ok  
44  
40  
47  
32  
111  
104  
116  
89  
See Also  
none  
24  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show file  
2
show file  
Displays the contents of a text file in the local Flash.  
Synopsis  
show file file_name  
Operands  
Defaults  
file_name  
Specifies the file whose contents are to be displayed.  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to display the contents of a text file in the local Flash.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To show the file system for internal flash:  
switch#show file flash://file1  
!
protocol spanning-tree mstp  
instance 1 vlan 100  
!
[or]  
switch#show file file1  
!
protocol spanning-tree mstp  
instance 1 vlan 100  
!
See Also  
dir  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
25  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show line  
2
show line  
Displays line parameters.  
show line [first line number| last line number]  
Synopsis  
Operands  
first line number  
last line number  
Specifies the first line number. The range of valid values is 0-31.  
Specifies the last line number. The range of valid values is 0-31.  
Defaults  
If the line is not specified, it displays all VTY and console information.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to display line parameters.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To display line parameters:  
switch#show line 10 22  
Status  
Idle  
Idle  
Idle  
Idle  
Idle  
Idle  
Idle  
Idle  
Idle  
Idle  
Idle  
Idle  
Idle  
Idle  
Type  
Timeout(m/s)  
10:0  
Length  
24  
console 0  
vty 10  
vty 11  
vty 12  
vty 13  
vty 14  
vty 15  
vty 16  
vty 17  
vty 18  
vty 19  
vty 20  
vty 21  
vty 22  
10:0  
10:0  
10:0  
10:0  
10:0  
10:0  
10:0  
10:0  
10:0  
10:0  
10:0  
10:0  
24  
24  
24  
24  
24  
24  
24  
24  
24  
24  
24  
24  
121:1212  
24  
switch#show line 0  
Status  
Idle  
* Active  
Type  
console 0  
vty 0  
Timeout(m/s)  
10:0  
Length  
24  
10:0  
24  
See Also  
line vty, line console, exec-timeout  
26  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show logging  
2
show logging  
Displays the internal syslog buffer of the switch.  
Synopsis  
Operands  
Defaults  
show logging  
none  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to display the RASlog messages stored in the internal buffer.  
The RASlog messages contain the module name, error code, and message details.  
Usage  
Guidelines  
Examples  
To display the syslog messages stored in the internal buffer:  
switch#show logging  
Fabos OS Version: v6.1.2  
Number of Messages: 1024  
2009/02/03-00:19:43: %NSM-4-1001: Interface TenGigabitEthernet 0/4 is online.  
2009/02/03-00:20:14: %NSM-4-1002: Interface TenGigabitEthernet 0/4 is  
protocol down.  
2009/02/03-00:20:14: %NSM-4-1001: Interface TenGigabitEthernet 0/4 is online.  
2009/02/03-00:21:10: %NSM-4-1003: Interface Port-channel 10 is link down  
See Also  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
27  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show media  
2
show media  
Displays the SFP information for all the interfaces present on a switch.  
Synopsis  
Operands  
Defaults  
show media  
none  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to display a summary of all SFP information for the switch. The output will be  
several pages long.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To display all SFP information:  
switch#show media  
Interface  
Identifier  
Connector  
Transceiver  
Name  
TenGigabitEthernet 0/1  
3
7
SFP  
LC  
0000000000000010 10_GB/s  
id  
Encoding  
Baud Rate  
Length 9u  
Length 9u  
Length 50u  
Length 62.5u  
Length Cu  
Vendor Name  
Vendor OUI  
Vendor PN  
Vendor Rev  
Wavelength  
Options  
6
103 (units 100 megabaud)  
0
0
8
3
0
(units km)  
(units 100 meters)  
(units 10 meters)  
(units 10 meters)  
(units 1 meter)  
BROCADE  
42:52:4f  
57-0000075-01  
A
850 (units nm)  
001a Loss_of_Sig,Tx_Fault,Tx_Disable  
BR Max  
0
BR Min  
0
Serial No  
Date Code  
Temperature  
Voltage  
Current  
TX Power  
RX Power  
AAA108454100431  
081108  
44 Centigrade  
3246.8 (Volts)  
0.002 (mAmps)  
0.1 (uWatts)  
0.1 (uWatts)  
(output truncated)  
See Also  
show media interface, show media linecard  
28  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show media interface  
2
show media interface  
Displays the SFP information for a specific interface.  
show media interface  
Synopsis  
Operands  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
Specifies a valid slot number.  
slot  
port  
Specifies a valid port number.  
Defaults  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to display a summary of the SFP information for the specified interface.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To display SFP information for 10 Gbps Ethernet interface:  
switch#show media interface tengigabitethernet 0/1  
Interface  
Identifier  
Connector  
Transceiver  
Name  
TenGigabitEthernet 0/1  
3
7
SFP  
LC  
0000000000000010 10_GB/s  
id  
Encoding  
Baud Rate  
Length 9u  
Length 9u  
Length 50u  
Length 62.5u  
Length Cu  
Vendor Name  
Vendor OUI  
Vendor PN  
Vendor Rev  
Wavelength  
Options  
6
103 (units 100 megabaud)  
0
0
8
3
0
(units km)  
(units 100 meters)  
(units 10 meters)  
(units 10 meters)  
(units 1 meter)  
BROCADE  
42:52:4f  
57-0000075-01  
A
850 (units nm)  
001a Loss_of_Sig,Tx_Fault,Tx_Disable  
BR Max  
0
BR Min  
0
Serial No  
Date Code  
Temperature  
Voltage  
Current  
TX Power  
RX Power  
AAA108454100431  
081108  
44 Centigrade  
3246.8 (Volts)  
0.002 (mAmps)  
0.1 (uWatts)  
0.1 (uWatts)  
See Also  
show media, show media linecard  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
29  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show media linecard  
2
show media linecard  
Displays the SFP information for all the interfaces of a specific line card.  
Synopsis  
Operands  
Defaults  
show media linecard number  
number  
Linecard number.  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to display a summary of the SFP information for a specific line card. The output  
contains information for each interface on the line card, and is several pages long.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To show the SFP information for line card number 0:  
switch#show media linecard 0  
Interface  
Identifier  
Connector  
Transceiver  
Name  
TenGigabitEthernet 0/1  
3
7
SFP  
LC  
0000000000000010 10_GB/s  
id  
Encoding  
Baud Rate  
Length 9u  
Length 9u  
Length 50u  
Length 62.5u  
Length Cu  
Vendor Name  
Vendor OUI  
Vendor PN  
Vendor Rev  
Wavelength  
Options  
6
103 (units 100 megabaud)  
0
0
8
3
0
(units km)  
(units 100 meters)  
(units 10 meters)  
(units 10 meters)  
(units 1 meter)  
BROCADE  
42:52:4f  
57-0000075-01  
A
850 (units nm)  
001a Loss_of_Sig,Tx_Fault,Tx_Disable  
BR Max  
0
BR Min  
0
Serial No  
Date Code  
Temperature  
Voltage  
Current  
TX Power  
RX Power  
AAA108454100431  
081108  
44 Centigrade  
3246.8 (Volts)  
0.002 (mAmps)  
0.1 (uWatts)  
0.1 (uWatts)  
(output truncated)  
See Also  
show media interface, show media  
30  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show processes cpu  
2
show processes cpu  
Displays information about the active processes in the switch and their corresponding CPU  
utilization statistics.  
Synopsis  
Operands  
Defaults  
show processes cpu summary  
summary  
Shows a summary of CPU usage by all processes.  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to display information about the active processes in the switch and their  
corresponding CPU utilization statistics.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To show the information for all processes:  
switch#show processes cpu summary  
CPU Utilization current: 0.90%; One minute: 0.00%; Five minutes: 0.00%;  
Fifteen minutes: 0.00%  
To show CPU usage information by individual processes:  
switch#show processes cpu  
CPU Utilization current: 0.90%; One minute: 0.00%; Five minutes: 0.00%;  
Fifteen minutes: 0.00%  
PID  
1
Process  
init  
CPU% State  
Started  
0.00  
0.00  
0.00  
0.00  
0.00  
0.00  
0.00  
S
S
S
S
S
S
S
14:18:35 Feb 19, 2009  
14:18:35 Feb 19, 2009  
14:18:35 Feb 19, 2009  
14:18:35 Feb 19, 2009  
14:18:35 Feb 19, 2009  
14:18:35 Feb 19, 2009  
14:18:35 Feb 19, 2009  
2
3
4
5
40  
73  
ksoftirqd/0  
events/0  
khelper  
kthread  
kblockd/0  
pdflush  
See Also  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
31  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show processes memory  
2
show processes memory  
Displays the memory usage information based on processes running in the system.  
show processes memory summary  
Synopsis  
Operands  
Defaults  
summary  
Shows a summary of memory usage by all processes.  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to view memory usage information based on processes running in the system.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To show a summary of memory usage by all processes:  
switch#show processes memory summary  
%Memory Used: 39.463%; TotalMemory: 1028020 KB; Total Used: 405688 KB; Total  
Free: 622332 KB  
To show memory usage information by individual processes:  
switch#show processes memory  
%Memory Used: 39.463%; TotalMemory: 1028020 KB; Total Used: 405688 KB; Total  
Free: 622332 KB  
PID  
1
Process  
init  
ksoftirqd/0  
events/0  
khelper  
kthread  
MEM%  
0.00  
0.00  
0.00  
0.00  
0.00  
Mem Used(bytes) Heap Total Heap Used  
1736704  
-
-
-
-
-
-
-
-
-
-
2
3
4
5
0
0
0
0
See Also  
none  
32  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show running-config  
2
show running-config  
Displays the contents of the configuration file currently running on the system.  
show running-config [access-list |cee-map | interface | lldp | rmon | spanning-tree]  
Synopsis  
Operands  
access-list  
cee-map  
interface  
lldp  
Displays the running configuration of the access-list.  
Displays the QoS Converged Enhanced Ethernet (CEE) maps configuration.  
Displays the interface configuration.  
Displays the LLDP configuration.  
rmon  
Displays the Remote Monitoring Protocol (RMON) configuration.  
Displays the switch configuration.  
spanning-tree  
Defaults  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to display the contents of the configuration file currently running on the system.  
The show running-config command displays only the commands that were successfully executed.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To display the content of the current configuration file:  
switch#show running-config  
!
no protocol spanning-tree  
!
interface Vlan 1  
!
interface TenGigabitEthernet 0/0  
shutdown  
!
interface TenGigabitEthernet 0/1  
shutdown  
!
interface TenGigabitEthernet 0/2  
shutdown  
!
interface TenGigabitEthernet 0/3  
shutdown  
!
interface TenGigabitEthernet 0/4  
shutdown  
!
See Also  
show startup-config  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
33  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show startup-config  
2
show startup-config  
Displays the content of the startup configuration file.  
Synopsis  
Operands  
Defaults  
show startup-config  
none  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to display the contents of the startup configuration file.  
The following guidelines apply when using this command:  
Usage  
Guidelines  
An error displays if there are no entries in the startup configuration file, for example  
switch#show startup-config  
% No Startup-config  
Use the write memory command to add entries to the startup configuration file.  
Using the write erase command to delete entries from startup configuration file.  
Examples  
To show the content of the startup configuration file:  
switch#show startup-config  
!
no protocol spanning-tree  
!
interface Vlan 1  
!
interface TenGigabitEthernet 0/0  
shutdown  
!
interface TenGigabitEthernet 0/1  
shutdown  
!
interface TenGigabitEthernet 0/2  
shutdown  
!
interface TenGigabitEthernet 0/3  
shutdown  
See Also  
write memory, write erase  
34  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show system  
2
show system  
Displays system information.  
Synopsis  
Operands  
Defaults  
show system  
none  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to display system information of hardware and software details.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To display the system information:  
switch#show system  
Stack MAC  
: 00:05:1E:76:42:00  
-- UNIT 0 --  
Unit Name  
Status  
Hardware Rev  
FC Port(s)  
: switch  
: Online  
: 76.6  
: 8  
Tengig Port(s) : 24  
Up Time  
: 18:28:27 up 4:09  
FOS Version  
Jumbo Capable  
Burned In MAC  
Management IP  
Status  
: v6.1.2  
: yes  
: 00:05:1E:76:42:00  
: 10.35.155.204  
: UP  
-- Power Supplies --  
PS0 is OK  
PS1 is OK  
-- Fan Status --  
Fan 1 is Ok  
Fan 2 is Ok  
Fan 3 is Ok  
See Also  
show version, show environment  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
35  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show tech-support  
2
show tech-support  
Displays output for troubleshooting.  
Synopsis  
Operands  
Defaults  
show tech-support  
none  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to run a script that automatically runs a variety of show commands with output  
that is useful to Technical Support for troubleshooting.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To display output for troubleshooting:  
switch#show tech-support  
------------------ date ------------------  
Thu Feb 19 18:30:13 UTC 2009  
--------------show version ------------------  
Fabric Operating System Software  
Fabric Operating System Version: 6.1  
Copyright (c) 1995-2008 Brocade Communications Systems, Inc.  
Build Time: 03:35:17 Feb 18, 2009  
switch uptime: 04:11:09  
Firmware name: v6.1.2  
Switch Model Name: Brocade 8000  
Control Processor: Freescale Semiconductor 8548E with 1016 MB of memory  
4MB of boot flash memory.  
8 FC Port(s)  
24 Ten GigabitEthernet/IEEE 802.3 interface(s)  
------------------ show running-config ------------------  
!
switch#  
See Also  
none  
36  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show users  
2
show users  
Displays information on all users currently logged into the switch.  
Synopsis  
Operands  
Defaults  
show users  
none  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to view information on all users logged into the switch.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To display information on users logged into the switch:  
switch#show users  
Type  
Idle  
Location  
User  
* vty 0  
00:00:00  
172.21.252.244 root  
Type  
Displays the line numbers.  
Idle  
Displays how long the session has been idle.  
Displays the IP address of the user.  
Displays the user name of all users logged in.  
Location  
User  
See Also  
show line  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
37  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show version  
2
show version  
Displays version information for the hardware and software.  
Synopsis  
Operands  
Defaults  
show version  
none  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to display hardware and software version information.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To display version information:  
switch#show version  
Fabric Operating System Software  
Fabric Operating System Version: 6.1  
Copyright (c) 1995-2008 Brocade Communications Systems, Inc.  
Build Time: 03:35:17 Feb 18, 2009  
E209 uptime: 04:14:43  
Firmware name: v6.1.2  
Switch Model Name: Brocade 8000  
Control Processor: Freescale Semiconductor 8548E with 1016 MB of memory  
4MB of boot flash memory.  
8 FC Port(s)  
24 Ten GigabitEthernet/IEEE 802.3 interface(s)  
switch#  
See Also  
show system  
38  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
terminal length  
2
terminal length  
Sets the number of lines to display on a screen.  
terminal length number  
number  
Synopsis  
Operands  
Specifies the number of lines to display on a screen. The range of valid values  
is 0-512.  
Defaults  
The default length is 24.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to set the number of lines to display on the screen.  
If 0 (zero), the switch does not pause between screens of output.  
Usage  
Guidelines  
Examples  
See Also  
To set the number of lines to display on the screen to 30:  
switch#terminal length 30  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
39  
 
 
DRAFT: BROCADE CONFIDENTIAL  
terminal monitor  
2
terminal monitor  
Displays the RASlog and debug outputs on a terminal.  
Synopsis  
terminal monitor  
terminal no monitor  
Operands  
Defaults  
none  
The terminal monitor option is disabled.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to enable or disable the display of the RASlog and debug outputs on a terminal.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To enable the display of the RASlog and the debug outputs on a terminal:  
switch#terminal monitor  
To disable the display of the RASlog and the debug outputs on a terminal:  
switch#terminal no monitor  
See Also  
none  
40  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
write erase  
2
write erase  
Removes the startup configuration from the switch.  
Synopsis  
Operands  
Defaults  
write erase  
none  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to remove a startup configuration.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
See Also  
To clear a startup configuration:  
switch#write erase  
write memory  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
41  
 
 
DRAFT: BROCADE CONFIDENTIAL  
write memory  
2
write memory  
Copies the current running configuration to the startup configuration file.  
Synopsis  
Operands  
Defaults  
write memory  
none  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to copy the current running configuration to the startup configuration file.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
See Also  
To write configuration data to a file:  
switch#write memory  
Overwrite the startup config file (y/n): y  
Building configuration...  
write erase  
42  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
Chapter  
VLAN Commands  
3
fcf forward  
Enables Fibre Channel over Ethernet (FCoE) on a VLAN interface.  
Synopsis  
fcf forward  
no fcf forward  
Operands  
Defaults  
none  
FCF forwarding is disabled.  
Interface VLAN mode  
Command  
Modes  
Description  
Use this command to enable FC forwarding on the VLAN interface in order to carry FCoE traffic. Use  
the no fcf forward command to disable FCoE on a VLAN.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To enable FC forwarding on a VLAN interface:  
switch(config)#interface vlan 777  
switch(conf-if-vl-777)#fcf forward  
See Also  
interface vlan  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
43  
 
     
DRAFT: BROCADE CONFIDENTIAL  
interface vlan  
3
interface vlan  
Configures a VLAN interface.  
Synopsis  
interface vlan vlan_id  
no interface vlan vlan_id  
Operands  
Defaults  
vlan_id  
Specifies the VLAN interface to configure. The range of valid values is  
1-3583.  
VLAN 1 is predefined on the switch.  
Global configuration mode  
Command  
Modes  
Description  
Use this command to configure a VLAN interface. Use the no interface vlan vlan_id command to  
delete a VLAN interface.  
Usage  
All of the ports on the switch are a part of the default VLAN 1.  
Guidelines  
Examples  
To create a VLAN with ID 56:  
switch(config)#interface vlan 56  
switch-cmsh(conf-if-vl-56)#  
See Also  
interface switchport, fcf forward, shutdown  
44  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show interface  
3
show interface  
Displays the configuration and status of an interface.  
Synopsis  
Operands  
show interface [tengigabitethernet slot/port | port-channel number| switchport]  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
slot  
Specifies a valid slot number.  
Specifies a valid port number.  
port  
port-channel number  
Specifies the interface is a port-channel. The range of valid values is 1-63.  
Specifies the Layer 2 interface.  
switchport  
Defaults  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to show the running system status and configuration for a specified interface.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To display information for a 10 Gbps Ethernet interface:  
switch#show interface tengigabitethernet 0/1  
Interface name  
Switchport mode  
Ingress filter  
: TenGigabitEthernet 0/7  
: access  
: enable  
Acceptable frame types : all  
Default Vlan  
Active Vlans  
Inactive Vlans  
: 1  
: 1  
: -  
Interface name  
Switchport mode  
Ingress filter  
: TenGigabitEthernet 0/1  
: access  
: enable  
Acceptable frame types : all  
Default Vlan  
Active Vlans  
Inactive Vlans  
: 5  
: 5  
: -  
See Also  
show interface vlan  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
45  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show vlan  
3
show vlan  
Displays information about a specific VLAN interface.  
show vlan {vlan_id | brief |classifier | fcoe}  
Synopsis  
Operands  
vlan_id  
Specifies the VLAN interface to display. The range of valid values is 1-3583.  
brief  
Specifies to display VLAN information for all interfaces including static and  
dynamic.  
classifier  
fcoe  
Specifies to display all VLAN classification information.  
Specifies to display all FCoe VLAN interfaces.  
Defaults  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to display information about VLAN.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To show information on a VLAN:  
switch#show vlan 1  
VLAN  
Name  
State  
Ports  
(u)-Untagged, (t)-Tagged  
(c)-Converged  
======= ================ ======= ===============================  
1
default  
ACTIVE Te 0/0(t) Te 0/4(t) Te 0/5(t)  
Te 0/8(t) Te 0/10(t) Te 0/11(c)  
Po 1(t) Po 63(t)  
See Also  
none  
46  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show vlan classifier  
3
show vlan classifier  
Displays information about a specific VLAN classifier group.  
Synopsis  
Operands  
show vlan classifier [group number | interface group number | port-channel number | rule  
number | tengigabitethernet slot/port | vlan vlan_id]  
group number  
interface group number  
Specifies the VLAN classifier interface group number. The range of valid  
Specifies the VLAN classifier group number. The range of valid values is 1-16.  
values is 1-16.  
port-channel number  
Specifies the VLAN classifier port-channel number. The range of valid values  
is 1-63.  
rule number  
Specifies the VLAN classifier rule number. The range of valid values is 1-256.  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
Specifies a valid slot number.  
slot  
port  
Specifies a valid port number  
vlan vlan_id  
Specifies the VLAN to display. The range of valid values is 1-3583.  
Defaults  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display information about all configured VLAN classifier groups or a specific  
VLAN interface group.  
Usage  
Guidelines  
If a group ID is not specified, all configured VLAN classifier groups are shown. If a group ID is  
specified, a specific configured VLAN classifier group is shown.  
Examples  
To display the VLAN classifier for group 1:  
switch#show vlan classifier group 1  
vlan classifier group 1 rule 1  
See Also  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
47  
 
 
DRAFT: BROCADE CONFIDENTIAL  
switchport  
3
switchport  
Puts the interface to Layer 2 mode and sets the switching characteristics of the Layer 2 interface to  
the defaults.  
Synopsis  
switchport  
no switchport  
Operands  
Defaults  
none  
By default, all Layer 2 interfaces are mapped to default VLAN 1 and the interface is set to access  
mode.  
Command  
Modes  
Interface configuration mode  
Description  
Use this command to set the switching characteristics of the Layer 2 interface. Use the no  
switchport command to take the switch out of the Layer 2 mode.  
Usage  
Guidelines  
For changing the interface configuration mode to trunk or changing the default VLAN mapping, use  
additional switchport commands.  
Examples  
To put an interface in Layer 2 mode:  
switch(conf-if-te-0/1)#switchport  
To remove an interface from Layer 2 mode:  
switch(conf-if-te-0/1)#no switchport  
See Also  
show vlan brief, show interface switchport, switchport mode, switchport access, switchport trunk  
48  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
switchport access  
3
switchport access  
Sets the Layer 2 interface as access.  
Synopsis  
switchport access vlan vlan_id  
no switchport access vlan  
Operands  
Defaults  
vlan vlan_id  
Sets the port VLAN (PVID) to the specified vlan_id. The range of valid values is  
1-3583.  
By default, all Layer 2 interfaces are in access mode and belong to the VLAN ID 1.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to set the Layer 2 interface as access. In access mode, the interface only allows  
untagged and priority tagged packets. Use the no switchport access vlan command to set the PVID  
to the default VLAN 1.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
To set the Layer 2 interface PVID to 100:  
switch(conf-if-te-0/19)#switchport access vlan 100  
show vlan brief, show interface switchport, switchport mode, switchport trunk  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
49  
 
 
DRAFT: BROCADE CONFIDENTIAL  
switchport converged  
3
switchport converged  
Adds or removes native and tagged VLANs on a Layer 2 interface.  
Synopsis  
Operands  
switchport converged { vlan vlan_id | allowed vlan {add vlan_id | all | except vlan_id | none |  
remove vlan_id} }  
no switchport converged  
vlan vlan_id  
Sets the default native VLAN for the Layer 2 interface.  
allowed vlan  
Sets the VLANs that will transmit and receive through the Layer 2 interface.  
add vlan_id  
Adds a VLAN to transmit and receive through the Layer2 interface. The range  
of valid values is 2-3583.  
all  
Allows all VLANs to transmit and receive through the Layer 2 interface.  
except vlan_id Allows all VLANs except the VLAN ID to transmit and receive through the Layer  
2 interface. The range of valid values is 2-3583.  
none  
Allows no VLANs to transmit and receive through the Layer 2 interface.  
remove vlan_id Removes a VLAN that transmits and receives through the Layer 2 interface.  
The range of valid values is 2-3583.  
Defaults  
The default native VLAN for a converged interface is 1.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to add or remove tagged VLANs on a Layer 2 interface.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To set the native VLAN of 200 on an interface:  
switch(conf-if-te-0/19)#switchport converged vlan 200  
To set the tagged VLAN on an interface to 100:  
switch(conf-if-te-0/19)#switchport converged allowed vlan add 100  
To remove the tagged VLAN 100 from the interface:  
switch(conf-if-te-0/19)#switchport converged allowed vlan remove 100  
See Also  
show vlan brief, show interface switchport, switchport mode, switchport trunk  
50  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
switchport mode  
3
switchport mode  
Sets the mode of the Layer 2 interface.  
switchport mode {access | trunk | converged}  
Synopsis  
Operands  
access  
trunk  
Sets the Layer 2 interface as access.  
Sets the Layer 2 interface as trunk.  
Sets the layer 2 interface as converged.  
converged  
Defaults  
There are no defaults for this command.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to set the mode of the Layer 2 interface.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To set the mode of the interface to access:  
switch(conf-if-te-0/19)#switchport mode access  
To set the mode of the interface to trunk:  
switch(conf-if-te-0/19)#switchport mode trunk  
To set the mode of the interface to converged:  
switch(conf-if-te-0/19)#switchport mode converged  
See Also  
show vlan brief, show interface switchport, switchport trunk  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
51  
 
 
DRAFT: BROCADE CONFIDENTIAL  
switchport trunk  
3
switchport trunk  
Adds or removes tagged VLANs on a Layer 2 interface.  
Synopsis  
Operands  
switchport trunk allowed vlan {add vlan_id | all | except vlan_id | none | remove vlan_id}  
no switchport trunk  
allowed vlan  
Sets the VLANs that will transmit and receive through the Layer 2 interface.  
add vlan_id  
Adds a VLAN to transmit and receive through the Layer2 interface. The range  
of valid values is 2-3583.  
all  
Allows all VLANs to transmit and receive through the Layer 2 interface.  
except vlan_id  
Allows all VLANs except the VLAN ID to transmit and receive through the Layer  
2 interface. The range of valid values is 2-3583.  
none  
Allows no VLANs to transmit and receive through the Layer 2 interface.  
remove vlan_id  
Removes a VLAN that transmits and receives through the Layer 2 interface.  
The range of valid values is 2-3583.  
Defaults  
There are no default configurations for this command.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to add or remove tagged VLANs on a Layer 2 interface.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To set the tagged VLAN on an interface to 100:  
switch(conf-if-te-0/19)#switchport truck allowed vlan add 100  
To remove the tagged VLAN 100 from the interface:  
switch(conf-if-te-0/19)#switchport truck allowed vlan remove 100  
See Also  
show vlan brief, show interface switchport, switchport mode, switchport trunk  
52  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
vlan classifier activate group  
3
vlan classifier activate group  
Activates a VLAN classifier group.  
Synopsis  
Operands  
vlan classifier activate group number vlan vlan_id  
no vlan classifier activate group  
number  
Specifies which VLAN classifier group to activate. The range of valid values is  
1-16.  
vlan vlan_id  
Specifies which VLAN interface to activate. The range of valid values is  
1-3583.  
Defaults  
There are no default configurations for this command.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to activate a VLAN classifier group for a specified VLAN. Use the no vlan  
classifier activate group command to remove the specified group.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
To activate VLAN classifier group 1 for VLAN 5:  
switch-cmsh(conf-if-te-0/10)#vlan classifier activate group 1 vlan 5  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
53  
 
 
DRAFT: BROCADE CONFIDENTIAL  
vlan classifier group  
3
vlan classifier group  
Adds and deletes rules to a VLAN classifier group.  
Synopsis  
Operands  
vlan classifier group number [add rule number| delete rule number]  
no vlan classifier group  
number  
Specifies the VLAN group number for which rules are to be added or deleted.  
The range of valid values is 1-16.  
add rule number  
Specifies a rule is to be added. The range of valid values is 1-256.  
delete rule number Specifies a rule is to be deleted. The range of valid values is 1-256.  
There are no default configurations for this command.  
Global configuration mode  
Defaults  
Command  
Modes  
Description  
Use this command to add and delete rules from VLAN classifier groups.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
See Also  
To add rule 1 to VLAN classifier group 1:  
switch(config)#vlan classifier group 1 add rule 1  
none  
54  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
vlan classifier rule  
3
vlan classifier rule  
Creates a VLAN classifier rule.  
Synopsis  
Operands  
vlan classifier rule rule_id [mac mac_address] [proto |arp| fcoe | fip] [encap ethv2 | nosnapllc |  
snapllc]  
no vlan classifier rule  
rule_id  
Specifies the VLAN identification rule. The range of valid values is 1-255.  
Specifies the Media Access Control (MAC) list.  
mac  
mac_address Specifies the MAC address-based VLAN classifier rule used to map to a  
specific VLAN.  
proto  
Specifies the protocol to use for the VLAN classifier rule.  
Specifies to use the Address Resolution Protocol.  
Specifies to use the Fibre Channel over Ethernet Protocol.  
Specifies to use the FCoE Initialization Protocol.  
arp  
fcoe  
fip  
encap  
Specifies to encapsulate the Ethernet frames sent for the VLAN classifier  
rule.  
ethv2  
Specifies to use the Ethernet version 2 encapsulated frames.  
Specifies to use the Ethernet version 2 non-SNA frames.  
Specifies to use the Ethernet version 2 with SNA frames.  
nosnapllc  
snapllc  
Defaults  
There are no default configurations for this command.  
Global configuration mode  
Command  
Modes  
Description  
Use this command to configure a VLAN classifier rule to dynamically classify Ethernet packets on  
an untagged interface into VLANs. Use the no vlan classifier rule command to delete the VLAN  
classifier rule specified by the rule_id.  
Usage  
Guidelines  
VLAN classifiers can be created individually and can be managed separately. Up to 256 VLAN  
classifiers can be provisioned. One or more VLAN classifiers can be grouped into a classifier group.  
This classifier group can further be applied on an interface.  
Examples  
To create an fcoe VLAN classifier rule:  
switch(config)#vlan classifier rule 2 proto fcoe encap ethv2  
To create a MAC-based VLAN classifier rule:  
switch(config)#vlan classifier rule 2 mac 0000.0000.0100  
See Also  
show vlan interface  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
55  
 
 
DRAFT: BROCADE CONFIDENTIAL  
vlan classifier rule  
3
56  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
DRAFT: BROCADE CONFIDENTIAL  
Chapter  
Interface Commands  
4
clear counters  
Clears statistics on all interfaces on the switch.  
Synopsis  
Operands  
clear counters {all | access-list mac access_list_name | [interface port-channel number |  
tengigabitethernet slot/port | slot-id number] }  
all  
access-list mac access_list_name  
Specifies the name of the MAC access list.  
Use this keyword to specify any of the following interfaces:  
Specifies to clear statistics on all interfaces.  
interface  
port-channel number  
Specifies the port-channel number. The range of valid values is 1-63.  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
slot  
Specifies a valid slot number.  
port  
Specifies a valid port number.  
slot-id number Specifies the slot number of the linecard. For the Brocade 8000 switch, the  
slot number is always 0 (zero).  
Description  
Defaults  
Use this command to clear statistics on one or on all interfaces.  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
User Guidelines  
Example  
The clear counters all command does not clear counters for any of the protocol daemon stats like  
LLDP, LACP, MSTP, and so on.  
To clear the statistics for 10 Gbps Ethernet interface 0/1:  
switch#clear counters interface tengigabitethernet 0/1  
To clear the statistics for MAC access list named “test”:  
switch#clear counters access-list mac test  
To clear the statistics for all the interfaces on the linecard in slot 0 (zero):  
switch#clear counters slot-id 0  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
57  
 
     
DRAFT: BROCADE CONFIDENTIAL  
clear counters  
4
See Also  
show interfaces  
58  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
DRAFT: BROCADE CONFIDENTIAL  
description  
4
description  
Specifies a string that contains the description of the interface.  
Synopsis  
description line  
no description  
Operands  
Defaults  
line  
Specifies characters describing the interface. The maximum number of  
characters is 64.  
There are no default configurations for this command.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to specify a string that contains the description of the interface. Use the no  
description command to remove the description.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
To set the string describing tengigabitethernet interface 0/1:  
switch(conf-if-te-0/1)#description converged_101  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
59  
 
 
DRAFT: BROCADE CONFIDENTIAL  
interface  
4
interface  
Enters the interface configuration mode to configure an interface.  
Synopsis  
interface [port-channel number | tengigabitethernet slot/port | vlan vlan id]  
no interface [port-channel number | vlan vlan id]  
Operands  
tengigabitethernet  
Configures the specified 10 Gbps Ethernet interface.  
Specifies a valid slot number.  
slot  
port  
Specifies a valid port number.  
port-channel number  
Specifies the port-channel number. The range of valid values is 1-63.  
vlan vlan_id  
Specifies the VLAN number. The range of valid values is 1-3583.  
Defaults  
There are no default configurations for this command.  
Global configuration mode  
Command  
Modes  
Description  
Use this command to create or enter the interface configuration mode to configure an interface.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
See Also  
none  
show interface, interface vlan  
60  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
mtu  
4
mtu  
Specifies the MTU on the interface.  
Synopsis  
Operands  
mtu size  
size  
Specifies the size of the maximum transmission unit (MTU) of an interface.  
The allowed MTU size is 1522-9208 bytes.  
Defaults  
By default, all 10 Gbps Ethernet interfaces use a default MTU of 2500 bytes.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to specify the MTU on the interface.  
Creating MTUs under VLAN interfaces is not valid.  
Usage  
Guidelines  
Examples  
See Also  
none  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
61  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show interface  
4
show interface  
Synopsis  
Operands  
show interface [port-channel number | tengigabitethernet slot/port | switchport ]  
port-channel number  
Specifies to display the port-channel number. The range of valid values is  
1-63.  
tengigabitethernet  
Specifies to display a specific 10 Gbps Ethernet interface.  
slot  
port  
Specifies to display a valid slot number.  
Specifies to display a valid port number.  
switchport  
Specifies to display information for Layer 2 interfaces.  
Defaults  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display the detailed interface configuration and capabilities of all interfaces  
or for a specific interface.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To display detailed information for 10 Gbps Ethernet interface 0/1:  
switch#show interface tengigabitethernet 0/1  
TenGigabitEthernet 0/1 is admin down, line protocol is down (admin down)  
Hardware is Ethernet, address is 0005.1e76.1aa5  
Current address is 0005.1e76.1aa5  
Pluggable media present, Media type is sfp  
Wavelength is 850 nm  
Interface index (ifindex) is 67174401  
MTU 2500 bytes  
LineSpeed: 10000 Mbit, Duplex: Full  
Flowcontrol rx: on, tx: on  
Last clearing of show interface counters: 00:02:18  
Queueing strategy: fifo  
Receive Statistics:  
0 packets, 0 bytes  
Unicasts: 0, Multicasts: 0, Broadcasts: 0  
64-byte pkts: 0, Over 64-byte pkts: 0, Over 127-byte pkts: 0  
Over 255-byte pkts: 0, Over 511-byte pkts: 0, Over 1023-byte pkts: 0  
Over 1518-byte pkts(Jumbo): 0  
Runts: 0, Jabbers: 0, CRC: 0, Overruns: 0  
Errors: 0, Discards: 0  
Transmit Statistics:  
0 packets, 0 bytes  
Unicasts: 0, Multicasts: 0, Broadcasts: 0  
Underruns: 0  
Errors: 0, Discards: 0  
Rate info (interval 299 seconds):  
Input 0.000000 Mbits/sec, 0 packets/sec, 0.00% of line-rate  
Output 0.000000 Mbits/sec, 0 packets/sec, 0.00% of line-rate  
62  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show interface  
4
Time since last interface status change: 00:02:17  
To display Layer 2 information for all interfaces:  
switch#show interface switchport  
Interface name  
Switchport mode  
Ingress filter  
: TenGigabitEthernet 0/8  
: access  
: enable  
Acceptable frame types : all  
Default Vlan  
Active Vlans  
Inactive Vlans  
: 1  
: 1  
: -  
Interface name  
Switchport mode  
Ingress filter  
: TenGigabitEthernet 0/19  
: hybrid  
: enable  
Acceptable frame types : all  
Default Vlan  
Active Vlans  
Inactive Vlans  
: 1  
: 1  
: 100  
Interface name  
Switchport mode  
Ingress filter  
: TenGigabitEthernet 0/20  
: trunk  
: enable  
Acceptable frame types : vlan-tagged only  
Default Vlan  
Active Vlans  
Inactive Vlans  
: 0  
: 1  
: -  
See Also  
show ip interface  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
63  
 
DRAFT: BROCADE CONFIDENTIAL  
show ip interface  
4
show ip interface  
Displays the IP interface status and configuration of all interfaces or a specified interface.  
Synopsis  
Operands  
show ip interface {brief | port-channel number brief| tengigabitethernet slot/port brief| vlan  
vlan_id brief}  
brief  
Specifies to display a brief summary of the IP status and configuration.  
port-channel number  
Specifies to display the port-channel number. The range of valid values is  
1-63.  
tengigabitethernet  
Specifies to display a specific 10 Gbps Ethernet interface.  
Specifies to display a valid slot number.  
slot  
port  
Specifies to display a valid port number.  
vlan vlan_id  
Specifies to display a the VLAN number. The range of valid values is  
1-3583.  
Defaults  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display IP interface status and configuration of all interfaces or a specified  
interface.  
Usage  
There are no usage guidelines for the command.  
Guidelines  
Examples  
To display information about all of the interfaces in the summary format:  
switch#show ip interface brief  
Interface  
========  
Port-channel 10  
Port-channel 11  
Port-channel 12  
Port-channel 13  
Port-channel 14  
Port-channel 15  
TenGigabitEthernet 0/0  
TenGigabitEthernet 0/1  
TenGigabitEthernet 0/2  
TenGigabitEthernet 0/3  
TenGigabitEthernet 0/4  
TenGigabitEthernet 0/5  
TenGigabitEthernet 0/6  
TenGigabitEthernet 0/7  
TenGigabitEthernet 0/8  
TenGigabitEthernet 0/9  
TenGigabitEthernet 0/10  
TenGigabitEthernet 0/11  
TenGigabitEthernet 0/12  
IP-Address  
==========  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
Status  
======  
up  
up  
up  
up  
up  
up  
up  
up  
up  
up  
up  
up  
up  
up  
up  
Protocol  
========  
down  
down  
down  
up  
down  
up  
up  
down  
up  
up  
down  
down  
down  
up  
up  
up  
up  
up  
up  
up  
down  
down  
up  
64  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show ip interface  
4
TenGigabitEthernet 0/13  
TenGigabitEthernet 0/14  
TenGigabitEthernet 0/15  
TenGigabitEthernet 0/16  
TenGigabitEthernet 0/17  
TenGigabitEthernet 0/18  
TenGigabitEthernet 0/19  
TenGigabitEthernet 0/20  
TenGigabitEthernet 0/21  
TenGigabitEthernet 0/22  
TenGigabitEthernet 0/23  
Vlan 1  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
unassigned  
up  
up  
up  
up  
up  
up  
up  
up  
up  
up  
up  
up  
down  
up  
down  
up  
down  
up  
up  
up  
up  
up  
administratively down down  
administratively down down  
administratively down down  
Vlan 100  
Vlan 200  
See Also  
show interface  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
65  
 
DRAFT: BROCADE CONFIDENTIAL  
shutdown  
4
shutdown  
Disables the selected interface.  
Synopsis  
shutdown  
no shutdown  
Operands  
Defaults  
none  
The interface is disabled.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to disable an interface.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To disable an interface:  
switch(conf-if-te-0/1)#shutdown  
To enable an interface:  
switch(conf-if-te-0/1)#no shutdown  
See Also  
interface, show ip interface, show interface  
66  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
Chapter  
Link Layer Discovery Protocol Commands  
5
advertise dcbx-fcoe-app-tlv  
Advertises application Type, Length, Values (TLVs) to ensure interoperability of traffic over the Data  
Center Bridging eXchange protocol (DCBX), which runs over LLDP to negotiate an FCoE application  
TLV.  
Synopsis  
advertise dcbx-fcoe-app-tlv  
no advertise dcbx-fcoe-app-tlv  
Operands  
Defaults  
none  
Advertise is disabled.  
Protocol LLDP configuration mode  
Command  
Modes  
Description  
Use this command to advertise application TLVs to ensure interoperability of traffic over DCBX  
packets. Converged Enhanced Ethernet (CEE) parameters related to FCoE must be negotiated  
before FCoE traffic can begin on a CEE link. An FCoE application TLV is exchanged over the LLDP  
protocol, which negotiates information such as FCoE priority, and Priority Flow Control (PFC) pause.  
Use the no advertise dcbx-fcoe-app-tlv command to return to the default setting.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
none  
advertise dot1-tlv, advertise dot3-tlv, advertise optional-tlv  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
67  
 
     
DRAFT: BROCADE CONFIDENTIAL  
advertise dcbx-fcoe-logical-link-tlv  
5
advertise dcbx-fcoe-logical-link-tlv  
Advertises to any attached device the FCoE status of the logical link.  
advertise dcbx-fcoe-logical-link-tlv  
Synopsis  
no advertise dcbx-fcoe-logical-link-tlv  
none  
Operands  
Defaults  
Advertise is disabled.  
Command  
Modes  
Protocol LLDP configuration mode  
Description  
Use this command to advertise to any attached device the FCoE status of the logical link. Use the  
no advertise dcbx-fcoe-logical-link-tlv command to return to the default setting.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
none  
advertise dcbx-fcoe-app-tlv, advertise dcbx fcoe-app-tlv  
68  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
advertise dcbx-tlv  
5
advertise dcbx-tlv  
Advertises to any attached device mandatory Data Center Bridging eXchange protocol (DCBX) Type,  
Length, Values (TLVs).  
Synopsis  
advertise dcbx-tlv  
no advertise dcbx-tlv  
Operands  
Defaults  
none  
Advertise is enabled.  
Protocol LLDP configuration mode  
Command  
Modes  
Description  
Advertises to any attached device mandatory Data Center Bridging eXchange protocol (DCBX) Type,  
Length, Values (TLVs). Use the no advertise dcbx-tlv command to return to the default setting.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
none  
advertise dot1-tlv, advertise dot3-tlv, advertise optional-tlv  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
69  
 
 
DRAFT: BROCADE CONFIDENTIAL  
advertise dot1-tlv  
5
advertise dot1-tlv  
Advertises to any attached device IEEE 802.1 organizationally specific Type, Length, Value (TLV).  
Synopsis  
advertise dot1-tlv  
no advertise dot1-tlv  
Operands  
Defaults  
none  
Advertise is disabled.  
Protocol LLDP configuration mode  
Command  
Modes  
Description  
Use this command to advertise to any attached device IEEE 802.1 organizationally specific Type,  
Length, Value (TLV). Use the no advertise dot1-tlv command to return to the default setting.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
none  
advertise dot3-tlv, advertise dcbx-tlv, advertise optional-tlv  
70  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
advertise dot3-tlv  
5
advertise dot3-tlv  
Advertises to any attached device IEEE 802.3 organizationally specific Type, Length, Value (TLV).  
Synopsis  
advertise dot3-tlv  
no advertise dot3-tlv  
Operands  
Defaults  
none  
Advertise is disabled.  
Protocol LLDP configuration mode  
Command  
Modes  
Description  
Use this command to advertise to any attached device IEEE 802.3 organizationally specific Type,  
Length, Value (TLV). Use the no advertise dot3-tlv command to return to the default setting.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
none  
advertise dot1-tlv, advertise dcbx-tlv, advertise optional-tlv  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
71  
 
 
DRAFT: BROCADE CONFIDENTIAL  
advertise optional-tlv  
5
advertise optional-tlv  
Advertises the optional Type, Length, and Value (TLV)s.  
Synopsis  
Operands  
advertise optional-tlv [management-address | port-description | system-capabilities |  
system-description | system-name]  
no advertise optional-tlv  
management-address  
Specifies the management address of the system.  
port-description  
Describes the user configured port.  
system-capabilities  
Specifies the capabilities of the system.  
system-description  
Describes the system firmware version and the current image running on the  
system.  
system-name  
Specifies the name of the system.  
Defaults  
Advertise is disabled.  
Command  
Modes  
Protocol LLDP configuration mode  
Description  
Use this command to display the following optional TLVs. Use the no advertise optional-tlv  
command to return to the default setting.  
Usage  
Guidelines  
There are no usage guidelines for this command.  
none  
Examples  
72  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
clear lldp neighbors  
5
clear lldp neighbors  
Clears the Link Layer Discovery Protocol (LLDP) neighbor information on all or specified interfaces.  
Synopsis  
Operands  
clear lldp neighbors interface [tengigabitethernet slot/port]  
interface  
Use this keyword to specify the 10 Gbps Ethernet interface using the following  
operand followed by the slot or port number.  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface for which to clear the LLDP  
neighbor information.  
slot  
Specifies a valid slot number.  
Specifies a valid port number.  
port  
Defaults  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to clear the LLDP neighbor information about the devices learned through an  
interface.  
Usage  
Guidelines  
If the interface operand is not specified, this command clears the LLDP neighbor information  
received on all the interfaces.  
Examples  
See Also  
To clear the LLDP information for all interfaces:  
switch#clear lldp neighbors  
show lldp neighbors  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
73  
 
 
DRAFT: BROCADE CONFIDENTIAL  
clear lldp statistics  
5
clear lldp statistics  
Clears LLDP statistics for all interfaces or a specified interface.  
Synopsis  
Operands  
clear lldp statistics interface [tengigabitethernet slot/port]  
interface  
Use this keyword to specify the 10 Gbps Ethernet interface using the following  
operand followed by the slot or port number.  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface for which to clear the LLDP  
statistics.  
slot  
port  
Specifies a valid slot number.  
Specifies a valid port number.  
Defaults  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to clear LLDP statistics for all interfaces or a specified interface.  
Usage  
Guidelines  
If the interface operand is not specified, this command clears all the LLDP statistics on all  
interfaces.  
Examples  
See Also  
To clear all the LLDP statistics for all interfaces:  
switch#clear lldp statistics  
show lldp statistics  
74  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
debug lldp packet  
5
debug lldp packet  
Enables debugging for Link Layer Discovery Protocol (LLDP).  
Synopsis  
Operands  
debug lldp packet {all | interface tengigabitethernet slot/port} [both | detail [both | rx | tx ] | rx |  
tx]  
no debug lldp packet { all | interface tengigabitethernet slot/port }  
all  
interface tengigabitethernet  
Specifies the 10 Gbps Ethernet interface.  
Turns on LLDP packet debugging on all interfaces.  
slot  
Specifies the slot number.  
port  
Specifies the port number.  
both  
Turns on debugging for both transmit and receive packets.  
Turns on debugging with detailed information.  
Turns on debugging for only received LLDP packets.  
Turns on debugging for only transmitted LLDP packets.  
detail  
rx  
tx  
Defaults  
By default, debugging is not turned on.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to enable debugging for Link Layer Discovery Protocol (LLDP). Use the no debug  
lldp packet command to disable debugging.  
Usage  
To display debugging outputs on a particular cmsh session, use the terminal monitor command.  
Guidelines  
Examples  
To enable debugging of LLDP for both received and transmitted packets on 10 Gbps Ethernet  
interface 0/1:  
switch#debug lldp packet interface tengigabitethernet 0/1 both  
switch#show debug lldp  
LLDP debugging status:  
Interface te0/1  
: Transmit Receive  
See Also  
show debug lldp  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
75  
 
 
DRAFT: BROCADE CONFIDENTIAL  
description  
5
description  
Specifies a string that contains the description of the LLDP.  
Synopsis  
description line  
no description  
Operands  
Defaults  
line  
Characters describing the LLDP protocol.  
There are no default configurations for this command.  
Protocol LLDP configuration mode  
Command  
Modes  
Description  
Use this command to specify a string that contains the description of the LLDP. Use the no  
description command to remove the description.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
To set the strings describing LLDP:  
switch(conf-lldp)#description Brocade-LLDP  
none  
76  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
hello  
5
hello  
Sets the Hello transmit interval.  
Synopsis  
hello seconds  
no hello  
Operands  
Defaults  
seconds  
Sets the Hello transmit interval. The range of valid values is 4-180 seconds.  
The default is 30 seconds.  
Command  
Modes  
Protocol LLDP configuration mode  
Description  
Use this command to set the interval between LLDP hello messages. Use the no hello command to  
return to the default setting.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To set the time interval to 10 seconds between the transmissions:  
switch#configure terminal  
switch (config) #protocol lldp  
switch(conf-lldp)#hello 10  
See Also  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
77  
 
 
DRAFT: BROCADE CONFIDENTIAL  
lldp dcbx-version  
5
lldp dcbx-version  
Specifies which version of the Data Center Bridging Exchange (DCBX) protocol to use.  
lldp dcbx-version [auto |cee | pre-cee]  
Synopsis  
Operands  
auto  
Specifies to auto adjust the DCBX protocol version to accommodate the  
difference when a switch interacts with different vendors using a different  
version of the DCBX protocol.  
cee  
Specifies to use the Converged Enhanced Ethernet (CEE) DCBX version.  
pre-cee  
Specifies to use the standard DCBX version, which is the version released  
prior to the CEE DCBX release.  
Defaults  
The default is auto.  
Command  
Modes  
Interface configuration mode  
Description  
Use this command to specify which version of the DCBX protocol to use.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
See Also  
To specify which DCBX version to use:  
switch(conf-if-te-0/1)#lldp dcbx-version cee  
none  
78  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
lldp disable  
5
lldp disable  
Disables LLDP on the interface.  
Synopsis  
lldp disable  
no lldp disable  
Operands  
Defaults  
none  
By default, LLDP is enabled at both the global and interface levels.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to disable LLDP on the interface. Use the no lldp disable command to enable  
LLDP on the interface.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
To disable LLDP on the interface.  
switch(conf-if-te-0/1)#lldp disable  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
79  
 
 
DRAFT: BROCADE CONFIDENTIAL  
lldp fcoe-priority-bits  
5
lldp fcoe-priority-bits  
Sets the priorities on which FCoE traffic will be allowed.  
Synopsis  
lldp fcoe-priority-bits value  
no lldp fcoe-priority-bits  
Operands  
Defaults  
value  
Specifies the bitmap value. The range of valid values is 0x0-0xff.  
The default value is 0x08.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to set the priorities on which FCoE traffic will be allowed. The no lldp  
fcoe-priority-bits command returns to the default setting.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
To set the priorities on which FCoE traffic will be allowed:  
switch(conf-if-te-0/1)#lldp fcoe-priority-bits 0xff  
protocol lldp  
80  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
lldp profile  
5
lldp profile  
Applies a Link Layer Discovery Protocol (LLDP) profile on an interface.  
Synopsis  
lldp profile name  
no lldp profile  
Operands  
Defaults  
name  
Specifies the profile name.  
If the parameters are not defined in the profile, the default values are used.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to apply a Link Layer Discovery Protocol (LLDP) profile on an interface. Use the  
no lldp profile command to delete the profile from the interface.  
Usage  
Guidelines  
You must use the profile command to create an LLDP profile before you can apply the profile to the  
interface. Only one LLDP profile can exist at any time for a particular interface. When this command  
is not present, the parameters defined in the global LLDP configuration are used.  
Examples  
See Also  
To apply an LLDP profile on an interface:  
switch(conf-if-te-0/1)#lldp profile test  
protocol lldp  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
81  
 
 
DRAFT: BROCADE CONFIDENTIAL  
mode  
5
mode  
Sets the LLDP mode on the switch.  
Synopsis  
mode tx | rx  
no mode  
Operands  
Defaults  
tx  
rx  
Specifies to enable only the transmit mode.  
Specifies to enable only the receive mode.  
Both transmit and receive modes are enabled.  
Protocol LLDP configuration mode  
Command  
Modes  
Description  
Use this command to set the LLDP mode on the switch. Use the no mode command to return to the  
default setting.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
To enable only the transmit mode:  
switch(conf-lldp)#mode tx  
show lldp  
82  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
multiplier  
5
multiplier  
Sets the number of consecutive misses of hello messages before LLDP declares the neighbor as  
dead.  
Synopsis  
multiplier value  
no multiplier  
Operands  
Defaults  
value  
Specifies a multiplier value to use. The range of valid values is 1-10.  
The default multiplier value is 4.  
Protocol LLDP configuration mode  
Command  
Modes  
Description  
Use this command to set the number of consecutive misses of hello messages before LLDP  
declares the neighbor as dead. Use the no multiplier command to return to the default setting.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
To set the number of consecutive misses:  
switch(conf-lldp)#multiplier 2  
hello  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
83  
 
 
DRAFT: BROCADE CONFIDENTIAL  
profile  
5
profile  
Creates an LLDP profile.  
Synopsis  
profile name  
no profile name  
Operands  
Defaults  
name  
Assigns a name to the profile. The valid value is a maximum of 32 characters.  
none  
Command  
Modes  
Protocol LLDP configuration mode  
Description  
Use this command to create an LLDP profile.  
Usage  
Guidelines  
When you apply an LLDP profile on an interface using the lldp profile command, it overrides the  
global configuration. If a profile is not present, then the default global profile is used until you  
create a valid profile. Up to 64 profiles can be created.  
Examples  
See Also  
To create a profile named test:  
switch(conf-lldp)#profile test  
To delete a profile named test:  
switch(conf-lldp)#no profile test  
lldp profile  
84  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
protocol lldp  
5
protocol lldp  
Enters the Link Layer Discovery Protocol (LLDP) configuration mode.  
Synopsis  
protocol lldp  
no protocol lldp  
Operands  
Defaults  
none  
The LLDP and DCBX protocols are enabled.  
Global configuration mode  
Command  
Modes  
Description  
Use this command to enter LLDP configuration mode to be able to make changes to the  
parameters. Use the no protocol lldp command to return to the default setting.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
To clear all LLDP configurations:  
switch(config)#no protocol lldp  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
85  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show debug lldp  
5
show debug lldp  
Displays the LLDP debugging status on the switch.  
Synopsis  
Operands  
Defaults  
show debug lldp  
none  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display the LLDP debugging status on the switch.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
See Also  
To display the LLDP debugging status on the switch:  
switch#show debug lldp  
LLDP debugging status:  
Interface te0/0  
: Transmit Receive Detail  
none  
86  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show lldp interface  
5
show lldp interface  
Displays the LLDP status on the specified interface.  
show lldp interface [tengigabitethernet slot/port]  
Synopsis  
Operands  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
Specifies a valid slot number.  
slot  
port  
Specifies a valid port number.  
Defaults  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display the LLDP status on the specified interface.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To display all the LLDP interface information for a selected interface:  
switch#show lldp interface tengigabitethernet 0/0  
LLDP information for Te 0/0  
State:  
Enabled  
Mode:  
Receive/Transmit  
30 seconds  
Advertise Transmitted:  
Hold time for advertise: 120 seconds  
Re-init Delay Timer:  
Tx Delay Timer:  
DCBX Version :  
Auto-Sense :  
2 seconds  
1 seconds  
CEE  
Yes  
Transmit TLVs:  
Chassis ID  
TTL  
Port ID  
IEEE DCBX  
DCBX FCoE App  
Link Prim  
DCBX FCoE Logical Link  
Brocade Link  
DCBX FCoE Priority Bits: 0x8  
See Also  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
87  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show lldp neighbors  
5
show lldp neighbors  
Displays LLDP information for all neighboring devices on the specified interface.  
Synopsis  
Operands  
show lldp neighbors [interface tengigabitethernet slot/port detail]  
interface  
Use this keyword to specify the10 Gbps Ethernet interface using the following  
operand followed by the slot or port number.  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
slot  
Specifies a valid slot number.  
port  
detail  
Specifies a valid port number.  
Displays all the LLDP neighbor information in detail for the specified  
interface.  
Defaults  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display LLDP information for all neighboring devices on the specified  
interface.  
Usage  
If you do not use the interface operand, only the mandatory TLVs are displayed.  
Guidelines  
Examples  
To display detailed LLDP neighbor information on a specific interface:  
switch#show lldp neighbors interface tengigabitethernet 0/8 detail  
Neighbors for Interface Te 0/8  
MANDATORY TLVs  
===============  
Local Interface: Te 0/8  
Remote Interface: Te 0/8 (IF Name)  
Dead Interval: 120 secs Remaining Life : 100 secs Tx: 536 Rx: 535  
Chassis ID: 0005.1e76.1020 (MAC)  
Remote Mac: 0005.1e76.102c  
OPTIONAL TLVs  
==============  
Port Interface Description: Te 0/8  
System Name: sw0  
System Description: Fibre Channel Switch.  
System Capabilities: Switching Routing  
System Capabilities Enabled: Switching  
Link Prim: 257  
Remote Protocols Advertised: Multiple Spanning Tree Protocol  
Remote VLANs Configured: VLAN ID: 1 VLAN Name: default  
AutoNego Support: Supported Not Enabled  
AutoNego Capability: 0  
Operational MAU Type: 0  
Link Aggregation Capability: Capable  
88  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show lldp neighbors  
5
Link Aggregation Status: Disabled  
Port Vlan Id: 1  
Port & Protocol Vlan Flag: Supported Not enabled  
Port & Protocol Vlan Id: 0  
Link Aggregation Port Id: 0  
Max Frame Size: 2500  
Management Address: 10.32.152.21 (IPv4)  
Interface Numbering: 2  
Interface Number: 0x4080100 (67633408)  
OID: 0x100f99b4  
DCBX TLVs  
===========  
DCBX Version : pre-CEE  
DCBX Ctrl OperVersion: 0 MaxVersion: 0 SeqNo: 2 AckNo: 1  
DCBX ETS OperVersion: 0 MaxVersion: 0 EN: 1 Will: 0 Err: 0  
Pri-Map: 15 15 15 15 15 15 15 15  
BWG ID: 00 Percentage: 000  
BWG ID: 01 Percentage: 000  
BWG ID: 02 Percentage: 000  
BWG ID: 03 Percentage: 000  
BWG ID: 04 Percentage: 000  
BWG ID: 05 Percentage: 000  
BWG ID: 06 Percentage: 000  
BWG ID: 07 Percentage: 000  
DCBX PFC OperVersion: 0 MaxVersion: 0 EN: 1 Will: 0 Err: 0  
Admin-Map: 0xf0  
FCoE App OperVersion: 0 MaxVersion: 0 EN: 1 Will: 0 Err: 0  
User-Pri-Map: 0x00  
FCoE LLS OperVersion: 0 MaxVersion: 0 EN: 1 Will: 0 Err: 0  
Logic Link Status: Down  
LAN LLS OperVersion: 0 MaxVersion: 0 EN: 1 Will: 0 Err: 0  
Logic Link Status: Up  
switch#  
See Also  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
89  
 
DRAFT: BROCADE CONFIDENTIAL  
show lldp statistics  
5
show lldp statistics  
Displays the LLDP statistics on all interfaces or a specified interface.  
Synopsis  
Operands  
show lldp statistics [interface tengigabitethernet slot/port]  
interface  
Use this keyword to specify the 10 Gbps Ethernet interface using the following  
operand followed by the slot or port number.  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface for which to display the LLDP  
statistics.  
slot  
Specifies a valid slot number.  
Specifies a valid port number.  
port  
Defaults  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display LLDP statistics on all interfaces or a specified interface.  
Usage  
Guidelines  
If you do not specify the interface tengigabitethernet operand, this command displays the LLDP  
statistics for all interfaces.  
Examples  
To display LLDP statistics on the specified interface:  
switch#show lldp statistics interface tengigabitethernet 0/8  
LLDP Interface statistics for Te 0/8  
Frames transmitted: 555  
Frames Aged out:  
Frames Discarded:  
0
0
Frames with Error: 0  
Frames Recieved:  
TLVs discarded:  
554  
0
TLVs unrecognized: 0  
See Also  
none  
90  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
system-description LINE  
5
system-description LINE  
Sets the global system description specific to LLDP.  
system-description line  
Synopsis  
no system-description  
Operands  
Defaults  
line  
Specifies a description for the LLDP system. The valid value is a maximum of  
50 characters.  
There are no default configurations for this command.  
Protocol LLDP mode.  
Command  
Modes  
Description  
Use this command to set the global system description specific to LLDP. Use no system-description  
command to clear the global LLDP system description.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
To set the global system description specific to LLDP:  
switch(conf-lldp)#system-description Brocade  
system-name  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
91  
 
 
DRAFT: BROCADE CONFIDENTIAL  
system-name  
5
system-name  
Sets the global system name specific to LLDP.  
Synopsis  
Operands  
system-name name  
name  
Specifies a system name for the LLDP. The valid values is a maximum of32  
characters.  
Defaults  
By default, the host name from the switch is used.  
Protocol LLDP configuration mode  
Command  
Modes  
Description  
Use this command to set the global system name specific to LLDP.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
See Also  
To specify a system name for the LLDP:  
switch(conf-lldp)#system-name Brocade  
system-description  
92  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
Chapter  
Link Aggregation Control Protocol Commands  
6
channel-group  
Enables Link Aggregation on an interface.  
Synopsis  
Operands  
channel-group number mode [active | passive | on] [type standard | brocade]  
no channel-group  
number  
Specifies a Link Aggregation Group (LAG) port channel-group number to  
which this link should administratively belong to. The range of valid values is  
1-63.  
mode  
Specifies the mode of Link Aggregation.  
Enables the initiation of LACP negotiation on an interface.  
Disables LACP on an interface.  
active  
passive  
on  
Enables static link aggregation on an interface.  
Specifies the type of LAG.  
type  
standard  
brocade  
Specifies the 802.3ad standard-based LAG.  
Specifies the Brocade proprietary hardware-based trunking.  
Defaults  
By default, the type is set to standard.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to add an interface to a port-channel specified by the channel-group number.  
This command enables link aggregation on an interface, so that it may be selected for aggregation  
by the local system. Use the no channel-group command to remove the port-channel members.  
Usage  
Only a maximum of 24 LAGs can be created. Note the following:  
Guidelines  
A maximum of four link aggregation groups can be created per switch when the type is set to  
brocade.  
A maximum of four links can become part of a single aggregation group when the type is set to  
brocade and they must be on the same port-channel.  
Links 0-7 belong to port-channel 1; links 8-15 belong to port-channel 2, and links 16-23  
belong to port-channel 3.  
For the standard type, a maximum of 16 links can be aggregated per aggregation group and  
they can be members of any port-channel.  
Examples  
To set the channel-group number to 4 and the mode to active:  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
93  
 
     
DRAFT: BROCADE CONFIDENTIAL  
channel-group  
6
switch(conf-if)#channel-group 4 mode active  
See Also  
interface port-channel  
94  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
DRAFT: BROCADE CONFIDENTIAL  
clear lacp  
6
clear lacp  
Clears the Link Aggregation Group Control Protocol (LACP) counters on a specific port-channel.  
Synopsis  
clear lacp number counters  
Operands  
number  
Specifies the port channel-group number. The range of valid values is 1-63.  
counters  
Clears traffic counters.  
Defaults  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to clear the LACP counters per specified channel-group.  
There are no default configurations for this command.  
Usage  
Guidelines  
Examples  
See Also  
To clear the LACP counters for a specific port-channel:  
switch#clear lacp 10 counters  
show lacp counters  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
95  
 
 
DRAFT: BROCADE CONFIDENTIAL  
clear lacp counters  
6
clear lacp counters  
Clears the Link Aggregation Group Control Protocol (LACP) counters on all port-channels.  
Synopsis  
Operands  
Defaults  
clear lacp counters  
none  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to clear the LACP counters for all port-channels.  
There are no default configurations for this command.  
Usage  
Guidelines  
Examples  
See Also  
To clear the counters for all port-channels:  
switch#clear lacp counters  
show lacp  
96  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
debug lacp  
6
debug lacp  
Enables debugging for the Link Aggregation Control Protocol (LACP).  
Synopsis  
debug lacp {all | cli | event | nsm | pdu {rx {all | interface tengigabitethernet slot/port} | tx {all |  
interface tengigabitethernet slot/port} }| sync | timer | trace level number}  
no debug lacp {all | cli | event | nsm | pdu {rx {all | interface tengigabitethernet slot/port} | tx { all  
| interface tengigabitethernet slot/port} }| sync | timer | trace level number}  
Operands  
all  
Turns on all debugging.  
cli  
Turns on command line interface debugging.  
Turns on event debugging.  
event  
nsm  
pdu  
Turns on Network Services Module (NSM) debugging.  
Turns on PDU debugging.  
rx all  
rx interface  
Turns on debugging for received LACP packets on all interfaces.  
Turns on debugging for received LACP packets on the specified  
interface.  
interface tengigabitethernet  
Specifies the 10 Gbps Ethernet interface.  
slot  
Specifies the slot number.  
port  
Specifies the port number.  
tx all  
tx interface  
Turns on debugging for transmitted LACP packets on all interfaces.  
Turns on debugging for transmitted LACP packets on the specified interface.  
interface tengigabitethernet  
Specifies the 10 Gbps Ethernet interface.  
slot  
Specifies the slot number.  
port  
Specifies the port number.  
sync  
Turns on debugging for LACP sync transitions.  
Turns on debugging for LACP timers.  
timer  
trace level number Specifies the trace level number. The range of valid values is 1-7.  
Defaults  
By default, debugging is not turned on.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to enable debugging for Link Aggregation Control Protocol (LACP). Use the no  
debug command to disable debugging.  
Usage  
To display debug outputs on a specific cmsh session, use the terminal monitor command.  
Guidelines  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
97  
 
 
DRAFT: BROCADE CONFIDENTIAL  
debug lacp  
Examples  
6
To enable debugging of LACP PDUs for transmitted and received packets on all interfaces:  
switch#debug lacp pdu tx all  
switch#debug lacp pdu rx all  
switch#show debug lacp  
LACP rx debugging is on  
LACP tx debugging is on  
See Also  
show debug lacp  
98  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
DRAFT: BROCADE CONFIDENTIAL  
lacp system-priority  
6
lacp system-priority  
Sets the Link Aggregation Control Protocol (LACP) system priority.  
Synopsis  
lacp system-priority value  
no lacp system-priority  
Operands  
Defaults  
value  
Specifies the value of the LACP system priority. The range of valid values is  
1-65535.  
The default system-priority value is 32768.  
Global configuration mode  
Command  
Modes  
Description  
Use this command to set the system priority of a local system. This determines which system is  
responsible for resolving conflicts in the choice of aggregation groups. Use the no lacp  
system-priority command to reset the system priority to the default value.  
Note  
Lower numerical values have higher priorities.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To set the LACP system-priority to 68:  
switch(config)#lacp system-priority 68  
To clear the configured LACP system-priority:  
switch(config)#no lacp system-priority  
See Also  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
99  
 
 
DRAFT: BROCADE CONFIDENTIAL  
lacp timeout  
6
lacp timeout  
Sets the timeout value used by LACP to exchange packets on an interface.  
Synopsis  
Operands  
lacp timeout [long | short]  
no lacp timeout  
timeout  
Specifies the number of seconds before invalidating a received Link  
Aggregation Control Protocol (LACP) data unit (DU).  
long  
Specifies a long timeout value.  
Specifies a short timeout value.  
short  
Defaults  
By default, the short timeout value is 3 seconds for Brocade trunks. For standard trunks, the long  
timeout value is 90 seconds.  
Command  
Modes  
Interface configuration mode  
Description  
Use this command to set the short timeout value for Brocade trunks or to set the long timeout  
value for standard trunks. Use the no lacp timeout command to return to the default value.  
Usage  
Guidelines  
If the LACP_timeout bit (encoded in Actor_State and Partner_State fields) is set to 1, the short  
timeout takes effect; if set to 0 (zero), the long timeout takes effect.  
Examples  
See Also  
To set the LACP short timeout value to 5 seconds:  
switch(conf-if-te-0/1)#lacp timeout short 5  
none  
100  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show lacp counter  
6
show lacp counter  
Displays the Link Aggregation Control Protocol (LACP) counters on all port-channels or a specified  
interface.  
Synopsis  
Operands  
show lacp counter number  
number  
Specifies the port-channel number to display. The range of valid values is  
1-63.  
Defaults  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display the LACP packet counters on all interfaces that belong to a  
port-channel or a specific interface.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To show the LACP counters for port-channel 10:  
switch#show lacp counter 10  
% Traffic statistics  
Port  
LACPDUs  
Sent Recv  
% Aggregator Po 10 1000000  
Marker  
Sent  
Pckt err  
Sent Recv  
Recv  
Te 0/1  
Te 0/2  
Te 0/3  
Te 0/4  
switch#  
65  
64  
64  
0
0
0
0
0
0
0
0
0
0
0
0
0
0 0  
0 0  
0 0  
0 0  
See Also  
clear lacp counters  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
101  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show lacp-sys-id  
6
show lacp-sys-id  
Displays the Link Aggregation Control Protocol (LACP) system ID and priority information.  
Synopsis  
Operands  
Defaults  
show lacp sys-id  
none  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display the LACP system ID and priority.  
Usage  
Guidelines  
The system priority and the system Media Access Control (MAC) address make up the system  
identification. The first two bytes are the system priority, and the last six bytes are the globally  
administered individual MAC addresses associated with the system.  
Examples  
See Also  
To display the local system ID:  
switch#show lacp sys-id  
% System 8000,00-05-1e-76-1a-a6  
none  
102  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show port-channel  
6
show port-channel  
Displays the Link Aggregation Group (LAG) information for a port-channel.  
Synopsis  
Operands  
show port-channel [channel-group-number | detail | load-balance | summary]  
channel-group number  
Specifies a LAG port channel-group number to display. The range of valid  
values is 1-63.  
detail  
Displays detailed LAG information for a port-channel.  
load-balance  
Displays the load-balance or frame-distribution scheme among ports in the  
port-channel.  
summary  
Displays the summary information per channel-group.  
Note  
LAG interfaces are called port-channels.  
There are no default configurations for this command.  
EXEC mode  
Defaults  
Command  
Modes  
Description  
Displays the LAGs present on the system with details about the LACP counters on their member  
links.  
Usage  
If you do not specify a port-channel, all port-channels are displayed.  
Guidelines  
Examples  
To display information for port-channel 10:  
switch#show port-channel 10  
% Aggregator Po 10 0 Admin Key: 0010 - Oper Key 0010 Partner System ID:  
0x0000,00-00-00-00-00-00 Partner Oper  
Key 0000  
%
%
Link: Te 0/1 (67174401) sync: 0  
Link: Te 0/2 (67239938) sync: 0  
See Also  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
103  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show port-channel  
6
104  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
DRAFT: BROCADE CONFIDENTIAL  
Chapter  
Layer 2 System Commands  
7
mac-address-table  
Use this command to set the aging time or to add static addresses to the MAC address table.  
Synopsis  
Operands  
mac-address-table {aging-time seconds| static mac-addr forward [port-channel number |  
tengigabitethernet slot/port | vlan vlan_id] }  
no mac-address-table {aging-time | static mac-addr forward [ port-channel number |  
tengigabitethernet slot/port | vlan vlan_id] }  
aging-time seconds  
Specifies the time in seconds that a learned MAC address will persist after  
the last update. If the aging time is set to zero (0), it means that aging is  
disabled. The range of valid values is 10-100000.  
static mac-addr  
Specifies the Media Access Control (MAC) address (unicast or multicast) to  
add to the address table. Packets with this destination address received in  
the specified VLAN are forwarded to the specified interface.  
forward  
Forwards the MAC address to the interface.  
port-channel number  
Specifies the port-channel number. The range of valid values is 1–63.  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
slot  
Specifies a valid slot number.  
port  
Specifies a valid port number.  
vlan vlan_id  
Specifies the VLAN number. The range of valid values is 1-3583.  
Defaults  
The default aging time is 300 seconds.  
Global configuration mode  
Command  
Modes  
Description  
Use this command to set the aging time or to add static addresses to the MAC address table.  
The vlan keyword is mandatory because the switch only supports independent VLAN learning (IVL).  
Usage  
Guidelines  
Examples  
To add the static address 0011.2222.3333 to the MAC address table with a packet received on  
VLAN 100:  
switch(config)#mac-address-table static 0011.2222.3333 forward  
tengigabitethernet 0/1 vlan 100  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
105  
 
     
DRAFT: BROCADE CONFIDENTIAL  
mac-address-table  
7
To set the aging time to 10 minutes:  
switch(config)#mac-address-table aging-time 600  
See Also  
show mac address-table static  
106  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
DRAFT: BROCADE CONFIDENTIAL  
show mac-address-table  
7
show mac-address-table  
Displays a specific MAC address table static and dynamic entry or the MAC address table static and  
dynamic entries for a specific interface or VLAN.  
Synopsis  
Operands  
show mac-address-table [address mac-addr | aging-time | count | dynamic | interface  
{tengigabitethernet slot/port | port-channel number} | linecard interface tengigabitethernet  
slot/port | static | vlan vlan_id ]  
address mac-address  
Specifies a 48-bit MAC address. The valid format is H.H.H (available in EXEC  
mode only).  
aging-time  
count  
Displays the aging time.  
Displays the count of forwarding entries.  
Displays the dynamic MAC addresses.  
Displays the forwarding information of an interface.  
dynamic  
interface  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
slot  
Specifies a valid slot number.  
port  
Specifies a valid port number.  
port-channel number  
Specifies the port-channel number. The range of valid values is 1–63.  
linecard  
Displays the linecard information.  
interface  
Displays the forwarding information of an interface.  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
slot  
port  
Specifies a valid slot number.  
Specifies a valid port number.  
static  
Displays the static MAC addresses.  
vlan vlan_id  
Specifies the VLAN number. The range of valid values is 1-3583.  
Defaults  
No static addresses are configured.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display a specific static or dynamic MAC address entry or all entries for a  
specific interface, a specific VLAN, a specific linecard, or for all interfaces and all VLANs.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To display a specific MAC address in the table:  
switch#show mac-address-table address 0011.2222.3333  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
107  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show mac-address-table  
7
VlanId  
100  
Mac-address  
0011.2222.3333  
Type  
Static  
State  
Inactive  
Ports  
Te 0/1  
Total MAC addresses  
: 1  
To display the aging time for a specific MAC address table:  
switch#show mac-address-table aging-time  
MAC Aging-time : 300 seconds  
To display a dynamic MAC address table:  
switch#show mac-address-table dynamic  
VlanId  
100  
100  
Mac-address  
Type  
State  
Ports  
0011.2222.5555 Dynamic Inactive Te 0/1  
0011.2222.6666 Dynamic Inactive Te 0/1  
: 2  
Total MAC addresses  
See Also  
show mac address-table dynamic, show mac address-table static, show mac address-table  
linecard, show mac address-table count  
108  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
DRAFT: BROCADE CONFIDENTIAL  
Chapter  
Layer 2 ACL commands  
8
clear counters access-list mac  
Clears all the Media Access Control (MAC) ACL counters for all interfaces which have ACL applied  
on them or for a specific interface.  
Synopsis  
clear counters access-list mac name [interface |port-channel number | tengigabitethernet  
slot/port| vlan vlan_id]  
Operands.  
name  
Specifies the name of the MAC ACL.  
interface  
Use this keyword to specify any of the following interfaces:  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
slot  
Specifies a valid slot number.  
port  
Specifies a valid port number.  
port-channel number  
Specifies the port-channel number. The range of valid values is 1-63.  
vlan vlan_id  
Specifies the VLAN number. The range of valid values is 1-3583.  
Defaults  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to clear counters for all or for a specific interface for MAC access list counters.  
Usage  
Guidelines  
If the interface keyword is not specified, then ACL counters on all interfaces which have this ACL  
applied are cleared. There are 255 ACL counters supported per port group.  
Example  
To clear counters for the configured MAC access list named test on an interface:  
switch#clear counters access-list mac test interface tengigabitethernet 0/1  
To clear counters for the configured MAC access list named test on all interfaces on which this ACL  
is applied:  
switch#clear counters access-list mac test  
See Also  
show mac access-list, show statistics access-list  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
109  
 
     
DRAFT: BROCADE CONFIDENTIAL  
deny (extended ACLs)  
8
deny (extended ACLs)  
Configures a MAC address rule to drop traffic based on the source and destination MAC addresses.  
Synopsis  
Operands  
deny {any | host MAC _ACL| MAC_ACL} {any | host MAC _ACL| MAC _ACL} [EtherType |arp |fcoe |  
ipv4] [count]  
no deny {any | host MAC _ACL| MAC_ACL} {any | host MAC _ACL| MAC _ACL} [EtherType |arp  
|fcoe| ipv4]  
any  
Specifies any source MAC address.  
host MAC_ACL  
Specifies the source host MAC address for which to set deny conditions. Use  
the format HHHH.HHHH.HHHH.  
MAC_ACL  
Specifies the source host MAC address for which to set deny conditions. Use  
the format HHHH.HHHH.HHHH.  
any  
Specifies any destination MAC address.  
host MAC_ACL  
Specifies the destination host address for which to set deny conditions. Use  
the format HHHH.HHHH.HHHH.  
MAC_ACL  
Ethertype  
Specifies the destination host address for which to set deny conditions. Use  
the format HHHH.HHHH.HHHH.  
Specifies the protocol number for which to set the deny conditions. The  
range of valid values is 1536-65535.  
arp  
Specifies to deny the Address Resolution Protocol (0x0806).  
Specifies to deny the Fibre Channel over Ethernet Protocol (0x8906).  
Specifies to deny the IPv4 protocol (0x0800).  
fcoe  
ipv4  
count  
Enables counting of the packets matching the rule.  
Defaults  
By default, no MAC ACLs are configured.  
Command  
Modes  
Feature Access Control List Configuration mode  
Description  
Use this command to configure rules to match and drop traffic based on the source and  
destination MAC addresses and the protocol type. You can also enable counters for a specific rule.  
There are 255 ACL counters supported per port group. Use the no deny command to remove a rule  
from the MAC ACL.  
Usage  
Guidelines  
The first set of {any | host MAC_ACL | MAC_ACL} parameters is specific to the source MAC  
address. The second set of {any | host MAC_ACL | MAC_ACL} parameters is specific to the  
destination MAC address.  
Example  
To create a rule in a MAC extended ACL to drop IPv4 traffic from the source MAC address  
0022.3333.4444 to the destination MAC address 0022.3333.5555 and to enable the counting  
of packets:  
switch(conf-macl-ext)#deny 0022.3333.4444 0022.3333.5555 ipv4 count  
To delete a rule from a MAC extended ACL:  
110  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
deny (extended ACLs)  
8
switch(conf-macl-ext)#no deny 0022.3333.4444 0022.3333.5555 ipv4  
See Also  
mac-access-list extended, mac-access-list standard, permit  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
111  
 
DRAFT: BROCADE CONFIDENTIAL  
deny (standard ACLs)  
8
deny (standard ACLs)  
Configures a MAC address rule to drop traffic based on the source MAC address.  
Synopsis  
Operands  
deny {MAC_ACL | any} [count]  
no deny {MAC_ACL | any}  
MAC_ACL  
Specifies the source host MAC address for which to set deny conditions. Use  
the format HHHH.HHHH.HHHH.  
any  
Specifies any source MAC address.  
count  
Enables counting of the packets matching the rule.  
Defaults  
By default, no MAC ACLs are configured.  
Command  
Modes  
Feature Access Control List Configuration mode  
Description  
Use this command to configure rules to match and to drop traffic based on the source MAC  
address. You can also enable counters for a specific rule. There are 255 ACL counters supported  
per port group. Use the no deny command to remove a rule from the MAC ACL.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Example  
To create a rule in a MAC standard ACL to drop traffic from the source MAC address  
0022.3333.4444and to enable the counting of packets:  
switch(conf-macl-std)#deny 0022.3333.4444 count  
To delete a rule from a MAC standard ACL:  
switch(conf-macl-std)#no deny 0022.3333.4444  
See Also  
mac-access-list extended, permit  
112  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
mac access-list extended  
8
mac access-list extended  
Creates and assigns a name to the extended MAC access list.  
Synopsis  
Operands  
mac access-list extended name  
no mac access-list extended name  
name  
Assigns a name to the MAC extended access list. The maximum character  
limit is 64.  
Command  
Modes  
Global configuration mode  
Description  
Use this command to create an extended MAC access list. If the ACL is already created, this  
command puts the switch in the extended MAC access-list configuration mode. Use the no mac  
access-list extended command to remove the access list.  
Extended ACLs allow you to filter traffic based on the following:  
Source MAC address  
Destination MAC address  
EtherType  
You can apply named MAC extended ACLs to VLANs and to Layer 2 interfaces.  
Usage  
Standard and extended MAC ACLs cannot share the same name.  
Guidelines  
Example  
To create a MAC extended ACL named mac1:  
switch(config)#mac access-list extended mac1  
switch(conf-macl-ext)#  
To delete a MAC extended ACL named mac1:  
switch(config)#no mac access-list extended mac1  
See Also  
deny, permit, show access-lists  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
113  
 
 
DRAFT: BROCADE CONFIDENTIAL  
mac access-list standard  
8
mac access-list standard  
Creates and assigns a name to the standard MAC access list.  
Synopsis  
Operands  
mac access-list standard name  
no mac access-list standard name  
name  
Assigns a name to the MAC standard access list. The maximum character  
limit is 64.  
Command  
Modes  
Global configuration mode  
Description  
Use this command to create a standard MAC access list. If ACL is already created, this command  
puts the switch in the standard MAC access-list configuration mode. Use the no mac access-list  
standard command to remove the access list.  
Standard ACLs allow you to filter traffic based on the source MAC address. You can apply named  
MAC standard ACLs to VLANs and to Layer 2 interfaces.  
Usage  
Standard and extended MAC ACLs cannot share the same name.  
Guidelines  
Example  
To create a MAC standard ACL named mac1:  
switch(config)#mac access-list standard mac1  
switch(conf-macl-std)#  
To delete a MAC standard ACL named mac1:  
switch(config)#no mac access-list standard mac1  
See Also  
deny, permit, show access-lists  
114  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
mac access-group  
8
mac access-group  
Applies rules specified in a MAC ACL to traffic entering an interface.  
Synopsis  
Operands  
Default  
mac access-group name in  
no mac access-group name  
name  
Specifies the name of the standard or extended MAC access list.  
Specifies to filter inbound packets only.  
in  
There are no access lists applied to the interface.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to apply a MAC ACL to a Layer 2 or a VLAN interface. You create the MAC ACL by  
using the mac access-list global configuration command. Use the no mac access-group command  
to remove the MAC ACL from the interface.  
Usage  
You can assign one MAC ACL (standard or extended) to an interface.  
Guidelines  
When a packet is received on an interface with a MAC ACL applied, the switch checks the rules in  
the ACL. If any of the rules match, the switch permits or drops the packet, according to the rule. If  
the specified ACL does not exist, the switch permits all the packets.  
Example  
See Also  
To apply a MAC ACL named macacl2 on an interface:  
switch(conf-if)#mac access-group macacl2 in  
To remove a MAC ACL named macacl2 from an interface:  
switch(conf-if)#no mac access-group macacl2  
mac access-list standard, mac access-list extended, show access-lists  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
115  
 
 
DRAFT: BROCADE CONFIDENTIAL  
permit (extended ACLs)  
8
permit (extended ACLs)  
Configures a MAC address rule to permit traffic based on the source and destination MAC  
addresses.  
Synopsis  
Operands  
permit {any | host MAC _ACL| MAC_ACL} {any | host MAC _ACL| MAC _ACL} [EtherType | arp |  
fcoe | ipv4] [count]  
no permit {any | host MAC _ACL| MAC_ACL} {any | host MAC _ACL| MAC _ACL} [EtherType | arp |  
fcoe| ipv4]  
any  
Specifies any source MAC address.  
host MAC_ACL  
Specifies the source host MAC address for which to set permit conditions.  
Use the format HHHH.HHHH.HHHH.  
MAC_ACL  
Specifies the source host MAC address for which to set permit conditions.  
Use the format HHHH.HHHH.HHHH.  
any  
Specifies any destination MAC address.  
host MAC_ACL  
Specifies the destination host address for which to set permit conditions. Use  
the format HHHH.HHHH.HHHH.  
MAC_ACL  
Ethertype  
Specifies the destination host address for which to set permit conditions. Use  
the format HHHH.HHHH.HHHH.  
Specifies the protocol number for which to set the permit conditions. The  
range of valid values is 1536-65535.  
arp  
Specifies to permit the Address Resolution Protocol (0x0806).  
Specifies to permit the Fibre Channel over Ethernet Protocol (0x8906).  
Specifies to permit the IPv4 protocol (0x0800).  
fcoe  
ipv4  
count  
Enables counting of the packets matching the filter rule.  
Defaults  
By default, no MAC ACLs are configured.  
Command  
Modes  
Feature Access Control List Configuration mode  
Description  
Use this command to configure rules to match and to permit traffic based on the source and  
destination MAC addresses, and the protocol type. You can also enable counters for a specific rule.  
There are 255 ACL counters supported per port group. Use the no permit command to remove a  
rule from the MAC ACL.  
Usage  
Guidelines  
The first set of {any | host MAC_ACL | MAC_ACL} parameters is specific to the source MAC  
address. The second set of {any | host MAC_ACL | MAC_ACL} parameters is specific to the  
destination MAC address.  
Example  
To create a rule in a MAC extended ACL to permit IPv4 traffic from the source MAC address  
0022.3333.4444 to the destination MAC address 0022.3333.5555 and to enable the counting of  
packets:  
switch(conf-macl-ext)#permit 0022.3333.4444 0022.3333.5555 ipv4 count  
116  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
permit (extended ACLs)  
8
To delete a filter rule in a MAC extended ACL:  
switch(conf-macl-ext)#no permit 0022.3333.4444 0022.3333.5555 ipv4  
See Also  
mac-access-list extended, mac-access-list standard, no seq  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
117  
 
DRAFT: BROCADE CONFIDENTIAL  
permit (standard ACLs)  
8
permit (standard ACLs)  
Configures a MAC address rule to permit traffic based on the source MAC address.  
Synopsis  
Operands  
permit {MAC_ACL | any} [count]  
no permit {MAC_ACL | any}  
MAC_ACL  
Specifies the source host MAC address for which to set permit conditions.  
Use the format HHHH.HHHH.HHHH.  
any  
Specifies any source MAC address.  
count  
Enables the counting of the packets matching the rule.  
Defaults  
By default, no MAC ACLs are configured.  
Command  
Modes  
Feature Access Control List Configuration mode  
Description  
Use this command to configure rules to match and to permit traffic based on the source MAC  
address. You can also enable counters for a specific rule. There are 255 ACL counters supported  
per port group. Use the no permit command to remove a rule from the MAC ACL.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Example  
To create a rule in a MAC standard ACL to permit traffic from the source MAC address  
0022.3333.4444 and to enable the counting of packets:  
switch(conf-macl-std)#permit 0022.3333.4444 count  
To delete a rule from a MAC standard ACL:  
switch(conf-macl-std)#no permit 0022.3333.4444  
See Also  
mac-access-list extended, no seq  
118  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
resequence access-list mac  
8
resequence access-list mac  
Specifies the renumbering of the rules in a MAC ACL.  
resequence access-list mac {name | seq_num | increment}  
Synopsis  
Operands  
name  
Specifies the name of a standard or an extended MAC ACL.  
seq_num  
Specifies the starting sequence number in the MAC ACL. The range of valid  
values is 1-65535.  
increment  
Specifies a value to increment the sequence number between rules. The  
range of valid values is 1-65535.  
Defaults  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to reassign sequence numbers to entries of an existing MAC access-list.  
Usage  
Guidelines  
Reordering the sequence numbers is useful when you need to insert rules into an existing MAC ACL  
and there are not enough sequence numbers available. When all sequence numbers between  
rules are exhausted, this feature allows the reassigning of new sequence numbers to entries of an  
existing access list.  
Example  
To reorder the rules in a MAC ACL:  
switch#show running-config access-list mac test  
!
mac access-list standard test  
seq 1 permit 0011.2222.3333  
seq 2 permit 0011.2222.4444  
seq 3 permit 0011.2222.5555  
seq 4 deny 0011.2222.6666  
!
switch#resequence access-list mac test 10 10  
switch#show running-config access-list mac test  
!
mac access-list standard test  
seq 10 permit 0011.2222.3333  
seq 20 permit 0011.2222.4444  
seq 30 permit 0011.2222.5555  
seq 40 deny 0011.2222.6666  
!
See Also  
mac-access-list extended, seq  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
119  
 
 
DRAFT: BROCADE CONFIDENTIAL  
seq (extended MAC ACLs)  
8
seq (extended MAC ACLs)  
Inserts a rule anywhere in the MAC ACL.  
Synopsis  
Operands  
seq value {deny | permit} {any | host MAC _ACL| MAC_ACL} {any | host MAC _ACL| MAC _ACL}  
[EtherType |arp |fcoe | ipv4] [count]  
no seq value  
value  
Specifies the sequence number for the rule. The range of valid values is  
0-65535.  
permit or deny  
any  
Specifies rules to permit or deny traffic.  
Specifies any source MAC address.  
host MAC_ACL Specifies the source host MAC address for which to set permit or deny  
conditions. Use the format HHHH.HHHH.HHHH.  
MAC_ACL  
Specifies the source host MAC address for which to set permit or deny  
conditions. Use the format HHHH.HHHH.HHHH.  
any  
Specifies any destination MAC address.  
host MAC_ACL Specifies the destination host address for which to set permit or deny  
conditions. Use the format HHHH.HHHH.HHHH.  
MAC_ACL  
Ethertype  
Specifies the destination host address for which to set permit or deny  
conditions. Use the format HHHH.HHHH.HHHH.  
Specifies the protocol number for which to set the permit or deny conditions.  
The range of valid values is 1536-65535.  
arp  
Specifies to permit or deny the Address Resolution Protocol (0x0806).  
fcoe  
Specifies to permit or deny the Fibre Channel over Ethernet Protocol  
(0x8906).  
ipv4  
Specifies to permit or deny the IPv4 protocol (0x0800).  
Enables the counting of the packets matching the rule.  
count  
Defaults  
By default, no MAC ACLs are configured.  
Command  
Modes  
Feature Access Control List Configuration mode  
Description  
Use this command to insert a rule anywhere in the MAC ACL; it configures rules to match and  
permits or drops traffic based on the source and destination MAC addresses, and the protocol type.  
You can also enable counters for a specific rule. There are 255 ACL counters supported per port  
group. Use the no seq value command to remove a rule from the MAC ACL.  
Usage  
Guidelines  
The first set of {any | host MAC_ACL | MAC_ACL} parameters is specific to the source MAC  
address. The second set of {any | host MAC_ACL | MAC_ACL} parameters is specific to the  
destination MAC address.  
120  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
seq (extended MAC ACLs)  
8
Example  
To create a rule in a MAC extended ACL to permit or drop IPv4 traffic from the source MAC address  
0022.3333.4444 to the destination MAC address 0022.3333.5555and to enable the counting of  
packets:  
switch(conf-macl-ext)#seq 100 deny 0022.3333.4444 0022.3333.5555 ipv4 count  
switch(conf-macl-ext)#seq 1000 permit 0022.3333.4444 0022.3333.5555 ipv4 count  
To delete a rule from a MAC extended ACL:  
switch(conf-macl-ext)#no seq 100  
See Also  
deny, permit, resequence  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
121  
 
DRAFT: BROCADE CONFIDENTIAL  
seq (standard MAC ACLs)  
8
seq (standard MAC ACLs)  
Inserts a rule anywhere in the MAC ACL.  
Synopsis  
Operands  
seq value {deny | permit} {any | host MAC _ACL| MAC_ACL} [count]  
no seq value  
value  
Specifies the sequence number for the rule. The range of valid values is  
0-65535.  
permit or deny  
any  
Specifies rules to permit or deny traffic.  
Specifies any source MAC address.  
host MAC_ACL Specifies the source host MAC address for which to set permit or deny  
conditions. Use the format HHHH.HHHH.HHHH.  
MAC_ACL  
Specifies the source host MAC address for which to set permit or deny  
conditions. Use the format HHHH.HHHH.HHHH.  
count  
Enables the counting of the packets matching the rule.  
Defaults  
By default, no MAC ACLs are configured.  
Command  
Modes  
Feature Access Control List Configuration mode  
Description  
Use this command to configure rules to match and permit or drop traffic based on source and  
destination MAC address and protocol type. You can also enable counters for a specific rule. There  
are 255 ACL counters supported per port group. Use the no seq value command to remove a rule  
from the MAC ACL.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Example  
To create a rule in a MAC standard ACL to permit or to drop traffic from the source MAC address  
0022.3333.4444 and to enable the counting of packets:  
switch(conf-macl-std)#seq 100 deny 0022.3333.4444 count  
switch(conf-macl-std)#seq 1000 permit 0022.3333.4444 count  
To delete a filter rule in a MAC standard ACL:  
switch(conf-macl-std)#no seq 100  
See Also  
deny, permit, resequence  
122  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show mac access-group  
8
show mac access-group  
Displays the current MAC ACL mapping to interfaces.  
Synopsis  
Operands  
show mac access-group [interface port-channel number | tengigabitethernet slot/port | vlan  
vlan_id]  
interface  
Specifies the interface for which to display the MAC ACL mapping.  
port-channel number  
Specifies the port-channel number. The range of valid values is 1–63.  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
slot  
Specifies a valid slot number.  
port  
Specifies a valid port number.  
vlan vlan_id  
Specifies the VLAN number. The range of valid values is 1-3583.  
Defaults  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display the current MAC ACL mapping to interfaces.  
Usage  
If you do not specify an interface, this command shows the mapping of MAC ACL to all interfaces.  
Guidelines  
Examples  
To display the current MAC ACL mapping for 10 Gbps Ethernet interface 0/1:  
switch#show mac access-group interface tengigabitethernet 0/1  
Interface Te 0/1  
Inbound access-list is std_acl  
To display the current MAC ACL mapping for interface VLAN 100:  
switch#show mac access-group interface vlan 100  
Interface Vl 100  
Inbound access-list is ext_acl  
To display the current MAC ACL mapping for 10 Gbps Ethernet interface 0/7 where there is no ACL  
applied:  
switch#show mac access-group interface tengigabitethernet 0/7  
Interface Te 0/7  
Inbound access-list is not set  
See Also  
show running-config, show statistics  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
123  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show statistics access-list mac  
8
show statistics access-list mac  
Shows active ACL rules in the switch and if the rules have counters enabled.  
Synopsis  
Operands  
show statistics access-list mac name [interface port-channel number | tengigabitethernet  
slot/port | vlan vlan_id]  
name  
Specifies a unique name for the MAC ACL.  
interface  
Specifies the interface for which to display the statistics.  
port-channel number  
Specifies the port-channel number. The range of valid values is 1–63.  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
slot  
Specifies a valid slot number.  
port  
Specifies a valid port number.  
vlan vlan_idSpecifies the VLAN number. The range of valid values is 1-3583.  
There are no default configurations for this command.  
EXEC mode  
Defaults  
Command  
Modes  
Description  
Examples  
Use this command to display the active rules on the switch and whether those rules have counters  
enabled.  
To display the statistics for standard and extended MAC ACL applied on two interfaces  
tengigabitethernet 0/1 and VLAN 100:  
switch#show statistics access-list mac std_acl  
mac access-list standard std_acl on interface Te 0/1  
seq 10 deny 0011.2222.3333 count (6312 frames)  
seq 20 deny 0011.2222.4444 count (20 frames)  
seq 30 deny 0011.2222.5555  
seq 40 deny 0011.2222.6666 count (100000 frames)  
switch#show statistics access-list mac ext_acl  
mac access-list extended ext_acl on interface Vl 100  
seq 10 deny 0011.2222.2222 0022.2222.2222 ipv4 count (4350 frames)  
seq 20 deny 0011.2222.2222 0022.2222.2222 fcoe count (0 frames)  
seq 30 deny 0011.2222.2222 0022.2222.2222 arp  
seq 40 deny 0011.2222.2222 0022.2222.2222 10000 count (560 frames)  
If the rule is not written into the hardware the output displays as shown below:  
seq 8 permit 00c0.e000.0080 count (unwritten)  
If the rule is written into the hardware, but the counters are not enabled for that rule, the output  
displays as shown below:  
seq 9 permit 00c0.e000.0090 count (uncounted)  
See Also  
show running-config, show mac access-group  
124  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
Chapter  
Spanning Tree Protocol Commands  
9
bridge-priority  
Specifies the priority of the bridge.  
Synopsis  
bridge-priority priority  
no bridge-priority  
Operands  
Defaults  
priority  
Specifies the bridge priority. The range of valid values is 0-61440.  
The default priority is 32678.  
Protocol Spanning Tree mode  
Command  
Modes  
Description  
Use this command to set the bridge priority for the common instance. Using a lower priority value  
indicates that the bridge might become root. Use the no bridge-priority command to return to the  
default settings.  
Usage  
Guidelines  
This command must be used to specify the priority of the bridge. The priority values can be set only  
in increments of 4096.  
Examples  
To specify the bridge priority:  
switch#configure terminal  
switch(config)#protocol spanning-tree stp  
switch(conf-stp)#bridge-priority 8192  
switch#configure terminal  
switch(config)#protocol spanning-tree rstp  
switch(conf-rstp)#bridge-priority 8192  
switch#configure terminal  
switch(config)#protocol spanning-tree mstp  
switch(conf-mstp)#bridge-priority 8192  
see Also  
protocol spanning-tree  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
125  
 
     
DRAFT: BROCADE CONFIDENTIAL  
cisco-interoperability  
9
cisco-interoperability  
Configures the switch to interoperate with some legacy Cisco switches.  
cisco-interoperability [disable| enable]  
Synopsis  
Operands  
disable  
enable  
Disables Cisco interoperability for the Multiple Spanning Tree Protocol (MSTP)  
switch.  
Enables Cisco interoperability for the MSTP switch.  
Defaults  
Cisco interoperability is disabled.  
Protocol Spanning Tree MSTP mode  
Command  
Modes  
Description  
Use this command to enable or disable the switch to interoperate with some legacy Cisco switches.  
For some switches, the MSTP field Version 3 Length does not adhere to the current standards.  
Usage  
Guidelines  
If Cisco interoperability is required on any switch in the network, then all switches in the network  
must be compatible, and therefore enabled using this command for interoperability with a Cisco  
switch.  
Examples  
To enable Cisco interoperability on a switch:  
switch#configure terminal  
switch(config)#protocol spanning-tree mstp  
switch(conf-mstp)#cisco-interoperability enable  
To disable Cisco interoperability on a switch:  
switch#configure terminal  
switch(config)#protocol spanning-tree mstp  
switch(conf-mstp)#cisco-interoperability disable  
See Also  
none  
126  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
clear spanning-tree counter  
9
clear spanning-tree counter  
Clears all spanning-tree counters on the interface.  
clear spanning-tree counter [interface| port-channel number | tengigabitethernet slot/port]  
Synopsis  
Operands  
interface  
Specifies the interface on which to clear the spanning-tree counters.  
port-channel number  
Specifies the port-channel number. The range of valid values is 1-63.  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
Specifies a valid slot number.  
slot  
port  
Specifies a valid port number.  
Defaults  
There are no default configurations for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to clear the spanning-tree counters on the interface.  
Usage  
If the interface operand is not specified, spanning-tree counters are cleared for all interfaces.  
Guidelines  
Examples  
To clear spanning-tree counters for all interfaces:  
switch#clear spanning-tree counter  
To clear spanning-tree counters for a 10 Gbps Ethernet interface:  
switch#clear spanning-tree counter interface tengigabitethernet 0/1  
To clear spanning-tree counters for port-channel 23:  
switch#clear spanning-tree counter interface port-channel 23  
See Also  
show spanning-tree  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
127  
 
 
DRAFT: BROCADE CONFIDENTIAL  
debug spanning-tree  
9
debug spanning-tree  
Enables debugging for the Spanning Tree Protocol.  
Synopsis  
Operands  
debug spanning-tree {all | bpdu {rx | tx {all | interface port-channel number | tengigabitethernet  
slot/port} }  
no debug spanning-tree {all | bpdu {rx | tx {all | interface port-channel number |  
tengigabitethernet slot/port} }  
all  
Turns on spanning tree packet debugging on all interfaces.  
Turns on Bridge Protocol Data Unit debugging.  
bpdu  
rx  
tx  
Turns on debugging for only received spanning-tree packets.  
Turns on debugging for only transmitted spanning-tree packets.  
interface port-channel number  
Specifies the port-channel interface. The range of valid values is 1-63.  
interface tengigabitethernet  
Specifies the 10 Gbps Ethernet interface.  
slot  
Specifies the slot number.  
Specifies the port number.  
port  
Defaults  
By default debugging is not turned on.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to enable debugging for the Spanning Tree Protocol. Use the no debug  
command to disable debugging.  
Usage  
To display debugging outputs on a particular cmsh session, use the terminal monitor command.  
Guidelines  
Examples  
To enable debugging of spanning-tree for both Rx and Tx on 10 Gbps Ethernet interface 0/1:  
switch#debug spanning-tree bpdu rx interface tengigabitethernet 0/1  
switch#debug spanning-tree bpdu tx interface tengigabitethernet 0/1  
switch#show debug spanning-tree  
MSTP debugging status:  
Spanning-tree rx debugging is off  
Te 0/1 rx is on  
Spanning-tree tx debugging is off  
Te 0/1 tx is on  
See Also  
show debug spanning-tree, show debug  
128  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
error-disable-timeout enable  
9
error-disable-timeout enable  
Enables the timer to bring the interface out of the error-disabled state.  
error-disable-timeout enable  
Synopsis  
Operands  
Defaults  
none  
There are no default configurations for this command.  
Protocol Spanning Tree mode  
Command  
Modes  
Description  
Use this command to enable the timer to bring the interface out of the disabled state.  
Usage  
Guidelines  
When the Spanning Tree Protocol (STP) Bridge Protocol Data Unit (BPDU) guard disables a port, the  
port remains in the disabled state unless the port is enabled manually. This command allows you  
to enable the interface from the disabled state.  
Examples  
See Also  
To bring the interface out of the disabled state:  
switch(conf-rstp)#error-disable-timeout enable  
error-disable-timeout interval  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
129  
 
 
DRAFT: BROCADE CONFIDENTIAL  
error-disable-timeout interval  
9
error-disable-timeout interval  
Synopsis  
Operands  
error-disable-timeout interval seconds  
seconds  
Specifies the range of time in seconds for the interface to time out. The range  
of valid values is 10-1000000.  
Defaults  
The default is 300 seconds. The timeout feature is disabled.  
Protocol Spanning Tree mode  
Command  
Modes  
Description  
Use this command to set the interface to time out when an error occurs.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
See Also  
To set the timeout value to 10 seconds:  
switch(conf-rstp)#error-disable-timeout interval 10  
error-disable-timeout enable  
130  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
forward-delay  
9
forward-delay  
Specifies the time an interface spends in each of the listening and learning states.  
Synopsis  
Operands  
forward-delay seconds  
no forward-delay  
seconds  
Specifies the range of time in seconds that an interface spends in the  
Spanning Tree Protocol (STP) learning and listening states. The range of valid  
values is 4-30.  
Defaults  
The default is 15 seconds.  
Command  
Modes  
Protocol Spanning Tree mode  
Description  
Use this command to specify how long the listening and learning states last before the interface  
begins the forwarding of all spanning-tree instances. Use the no forward-delay command to return  
to the default settings.  
Note  
STP interface states:  
Listening - The interface processes the Bridge Protocol Data Units (BPDUs) and awaits possible  
new information that might cause it to return to the blocking state.  
Learning - The interface does not yet forward frames (packets), instead it learns source  
addresses from frames received and adds them to the filtering database (switching database).  
Forwarding - An interface receiving and sending data, normal operation. STP still monitors  
incoming BPDUs that can indicate it should return to the blocking state to prevent a loop.  
Blocking - An interface that can cause a switching loop, no user data is sent or received, but it  
might go to the forwarding state if the other links in use fail and the STP determines that the  
interface may transition to the forwarding state. BPDU data continues to be received in the  
blocking state.  
Usage  
Guidelines  
When you change the spanning-tree forward-delay time, it affects all spanning-tree instances.  
When configuring the forward-delay, the following relationship should be kept:  
2*(forward-delay - 1)>=max-age>=2*(hello-time + 1)  
Examples  
See Also  
To configure the forward-delay time to 18 seconds:  
switch(conf-mstp)#forward-delay 18  
hello-time, max age  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
131  
 
 
DRAFT: BROCADE CONFIDENTIAL  
hello-time  
9
hello-time  
Sets the interval between the hello Bridge Protocol Data Units (BPDUs) sent on an interface.  
Synopsis  
hello-time seconds  
no hello-time  
Operands  
Defaults  
seconds  
Specifies the time range in seconds for the interval between the hello BPDUs  
sent on an interface. The range of valid values is 1-10.  
The default is 2 seconds.  
Command  
Modes  
Protocol Spanning Tree mode  
Description  
Use this command to configure the spanning-tree bridge hello time, which determines how often  
the device broadcasts hello messages to other devices. Use the no hello-time command to return  
to the default settings.  
Usage  
Guidelines  
When configuring the hello-time, the max-age setting must be greater than the hello-time setting.  
The following relationship should be kept:  
2*(forward-delay - 1)>=max-age>=2*(hello-time + 1)  
Examples  
See Also  
To configure spanning-tree bridge hello time to 5 seconds:  
switch(conf-stp)#hello-time 5  
forward-delay, max-age  
132  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
instance  
9
instance  
Maps a VLAN to a Multiple Spanning Tree Protocol (MSTP) instance.  
Synopsis  
instance instance_id [vlan vlan_id | priority priority_id]  
no instance  
Operands  
instance_id  
vlan vlan_id  
Specifies the MSTP instance. The range of valid values is 1-15.  
Specifies the VLAN to map an MSTP instance. The range of valid values is  
1-3583.  
priority priority_id  
Specifies the priority for the specified instance. The range of valid values is  
0-61440. The priority values can be set only in increments of 4096.  
Defaults  
The default priority value is 32768.  
Protocol Spanning Tree MSTP mode  
Command  
Modes  
Description  
Use this command to map a VLAN to an MTSP instance. You can group a set of VLANs to an  
instance.This command can be used only after the VLAN is defined. Use the no instance command  
to unmap the VLAN from the MSTP instance.  
Usage  
The following rules apply:  
Guidelines  
VLANs must be created before mapping to instances.  
VLAN instance mapping is removed from the configuration if the underlying VLANs are deleted.  
Examples  
See Also  
To map a VLAN to an MTSP instance:  
switch(conf-mstp)#instance 1 vlan 2, 3  
switch(conf-mstp)#instance 2 vlan 4-6  
switch(conf-mstp)#instance 1 priority 4096  
show spanning-tree  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
133  
 
 
DRAFT: BROCADE CONFIDENTIAL  
max-age  
9
max-age  
Sets the interval time in seconds between messages that the spanning tree receives from the  
interface.  
Synopsis  
max-age seconds  
no max-age  
Operands  
Defaults  
seconds  
Configures the Spanning tree Protocol interface maximum-age. The range of  
valid values is 6-40.  
The default is 20 seconds.  
Command  
Modes  
Protocol Spanning Tree mode  
Description  
Use this command to control the maximum length of time that passes before an interface saves its  
configuration Bridge Protocol Data Unit (BPDU) information. Use the no max-age command to  
return to the default configuration.  
Usage  
Guidelines  
When configuring the maximum age, the max-age setting must be greater than the hello-time  
setting. The following relationship should be kept:  
2*(forward-delay - 1)>=max-age>=2*(hello-time + 1)  
Examples  
See Also  
To configure the maximum-age to 10 seconds:  
switch(conf-rstp)#max-age 10  
hello-time, forward delay  
134  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
max-hops  
9
max-hops  
Configures the maximum number of hops for a Bridge Protocol Data Unit (BPDU) in an MSTP  
region.  
Synopsis  
max-hops hop_count  
no max-hops  
Operands  
Defaults  
hop_count  
Specifies the maximum number of hops for which the BPDU will be valid. The  
range of valid values is 1-40.  
The default is 20 hops.  
Command  
Modes  
Protocol Spanning Tree MSTP mode  
Description  
Use this command to configure the maximum number of hops for a BPDU in an MSTP region. This  
parameter is used by all the instances of the MSTP. Use the no max-hops command to return to the  
default value.  
Usage  
Guidelines  
Specifying the maximum hops for a BPDU prevents the messages from looping indefinitely on the  
interface. When you change the number of hops, it affects all spanning-tree instances.  
Examples  
To set the number of maximum hops to 25 for all MSTPs:  
switch(config)#protocol spanning-tree mstp  
switch(conf-mstp)#max-hops 25  
See Also  
show spanning-tree mst  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
135  
 
 
DRAFT: BROCADE CONFIDENTIAL  
port-channel path-cost  
9
port-channel path-cost  
Sets the path-cost behavior.  
port-channel path-cost custom | standard  
Synopsis  
Operands  
custom  
Specifies to use the custom behavior, which sets the path-cost changes  
according to the port-channel’s bandwidth.  
standard  
Specifies to use the standard behavior, which sets that the path-cost does not  
change according to port-channel’s bandwidth.  
Defaults  
The default path-cost is standard.  
Protocol Spanning Tree mode  
Command  
Modes  
Description  
Use this command to set the path-cost behavior for the port-channel.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To set the behavior for the path-cost to custom:  
switch(conf-mstp)#port-channel path-cost custom  
To set the behavior for the path-cost to standard:  
switch(conf-mstp)#port-channel path-cost standard  
See Also  
none  
136  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
protocol spanning-tree  
9
protocol spanning-tree  
Synopsis  
protocol spanning-tree [mstp|rstp|stp]  
no protocol spanning-tree  
Operands  
mstp  
rstp  
stp  
Specifies the Multiple Spanning Tree Protocol (MSTP).  
Specifies the Rapid Spanning Tree (RSTP).  
Specifies the Spanning Tree Protocol (STP).  
Defaults  
By default, STP is not enabled. STP is not required in a loop-free topology.  
Global configuration mode  
Command  
Modes  
Description  
Use this command to create a context for the protocol specified. Use the no protocol spanning-tree  
command to delete the context and all the configurations defined within the context or protocol for  
the interface.  
Usage  
Guidelines  
Consider enabling STP to detect or avoid loops. You must turn off one form of STP before turning on  
another form.  
Packet drops or packet flooding may occur if you do not enable xSTP on all devices connected on  
both sides of parallel links.  
Examples  
See Also  
To enable the Spanning Tree Protocol:  
switch(config)#protocol spanning-tree stp  
show spanning-tree  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
137  
 
 
DRAFT: BROCADE CONFIDENTIAL  
region  
9
region  
Specifies the Multiple Spanning Tree Protocol (MSTP) region.  
Synopsis  
region region-name  
no region  
Operands  
Defaults  
region-name  
Assigns a name to an MSTP region.  
There are no default configurations for this command.  
Protocol Spanning Tree MSTP mode  
Command  
Modes  
Description  
Use this command to assign a name to an MSTP region. Use the no region command to delete the  
name.  
Usage  
The region-name string has a maximum length of 32 characters and is case-sensitive.  
Guidelines  
Examples  
To assign a name to an MSTP region named brocade1:  
switch(config)#protocol spanning-tree mstp  
switch(conf-mstp)#region brocade1  
See Also  
revision, show spanning-tree  
138  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
revision  
9
revision  
Assigns a version number to the Multiple Spanning Tree Protocol (MSTP) configuration.  
Synopsis  
revision number  
no revision  
Operands  
Defaults  
number  
Specifies the revision or version number of the MSTP region. The range of  
valid values is 0-255.  
The default is 0.  
Command  
Modes  
Protocol Spanning Tree MSTP mode  
Description  
Use this command to specify the configuration revision number. Use the no revision command to  
return to the default setting.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To set the configuration revision to 1:  
switch(config)#protocol spanning-tree mstp  
switch(conf-mstp)#revision 1  
See Also  
region, show spanning-tree  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
139  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show spanning-tree  
9
show spanning-tree  
Displays all Spanning Tree Protocol information.  
Synopsis  
Operands  
Defaults  
show spanning-tree  
none  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display all STP information.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To display all STP information:  
switch#show spanning-tree  
Spanning-tree Mode: Multiple Spanning Tree Protocol  
CIST Root Id: 8000.0005.1e76.1aa0 (self)  
CIST Bridge Id: 8000.0005.1e76.1aa0  
CIST Reg Root Id: 8000.0005.1e76.1aa0 (self)  
CIST Root Forward Delay: 15; Hello Time: 2; Max Age: 20; Max-hops: 20  
Configured Forward Delay: 15; Hello Time: 2; Max Age: 20; Max-hops: 20;  
Tx-HoldCount: 6  
Number of topology change(s): 0  
Bpdu-guard errdisable timeout: disabled  
Bpdu-guard errdisable timeout interval: 300 sec  
Migrate Time: 3 sec  
Port Te 0/0 enabled  
IfIndex: 67108864; Id: 8000; Role: Disabled; State: Discarding  
Designated External Path Cost: 0; Internal Path Cost 0  
Configured Path Cost: 2000  
Designated Port Id: 0; CIST Priority: 128  
Designated Bridge: 0000.0000.0000.0000  
CIST Port Hello Time: 2  
Number of forward-transitions: 0  
Version Multiple Spanning Tree Protocol - Received None - Send MSTP  
Edgeport: off; AutoEdge: no; AdminEdge: no; EdgeDelay: 3 sec  
Configured Root guard: off; Operational Root guard: off  
Boundary: yes  
Bpdu-guard: off  
Bpdu-filter: off  
Link-type: point-to-point  
Received BPDUs: 0; Sent BPDUs: 0  
Port Te 0/8 enabled  
IfIndex: 67633408; Id: 8008; Role: Disabled; State: Discarding  
Designated External Path Cost: 0; Internal Path Cost 0  
Configured Path Cost: 2000  
140  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show spanning-tree  
9
Designated Port Id: 0; CIST Priority: 128  
Designated Bridge: 0000.0000.0000.0000  
CIST Port Hello Time: 2  
Number of forward-transitions: 0  
Version Multiple Spanning Tree Protocol - Received None - Send MSTP  
Edgeport: off; AutoEdge: no; AdminEdge: no; EdgeDelay: 3 sec  
Configured Root guard: off; Operational Root guard: off  
Boundary: yes  
Bpdu-guard: off  
Bpdu-filter: off  
Link-type: point-to-point  
Received BPDUs: 0; Sent BPDUs: 0  
Port Te 0/19 enabled  
IfIndex: 68354563; Id: 8013; Role: Disabled; State: Discarding  
Designated External Path Cost: 0; Internal Path Cost 0  
Configured Path Cost: 2000  
Designated Port Id: 0; CIST Priority: 128  
Designated Bridge: 0000.0000.0000.0000  
CIST Port Hello Time: 2  
Number of forward-transitions: 0  
Version Multiple Spanning Tree Protocol - Received None - Send MSTP  
Edgeport: off; AutoEdge: no; AdminEdge: no; EdgeDelay: 3 sec  
Configured Root guard: off; Operational Root guard: off  
Boundary: yes  
Bpdu-guard: off  
Bpdu-filter: off  
Link-type: point-to-point  
Received BPDUs: 0; Sent BPDUs: 0  
Port Te 0/20 enabled  
IfIndex: 68420100; Id: 8014; Role: Disabled; State: Discarding  
Designated External Path Cost: 0; Internal Path Cost 0  
Configured Path Cost: 2000  
Designated Port Id: 0; CIST Priority: 128  
Designated Bridge: 0000.0000.0000.0000  
CIST Port Hello Time: 2  
Number of forward-transitions: 0  
Version Multiple Spanning Tree Protocol - Received None - Send MSTP  
Edgeport: off; AutoEdge: no; AdminEdge: no; EdgeDelay: 3 sec  
Configured Root guard: off; Operational Root guard: off  
Boundary: yes  
Bpdu-guard: off  
Bpdu-filter: off  
Link-type: point-to-point  
Received BPDUs: 0; Sent BPDUs: 0  
See Also  
show spanning-tree interface  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
141  
 
DRAFT: BROCADE CONFIDENTIAL  
show spanning-tree brief  
9
show spanning-tree brief  
Displays the status and parameters of the Spanning Tree Protocol.  
Synopsis  
Operands  
Defaults  
show spanning-tree brief  
none  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display the status and parameters of the Spanning Tree Protocol. It includes  
the port roles and port states. The following describes the port roles and states:  
Port roles—root port, designated port, alternate port and backup port.  
Port states—discarding, learning, and forwarding.  
Port types—edge port (PortFast), point-to-point, and shared port.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To display the status and parameters of the Spanning Tree Protocol:  
switch#show spanning-tree brief  
Spanning-tree Mode: Rapid Spanning Tree Protocol  
Root ID  
Priority 32768  
Address 0005.1e76.1aa0  
Hello Time 2, Max Age 20, Forward Delay 15  
Bridge ID  
Priority 32768  
Address 0005.1e76.1aa0  
Hello Time 2, Max Age 20, Forward Delay 15, Tx-HoldCount 6  
Migrate Time 3 sec  
Interface  
Role Sts Cost  
Prio Link-type  
Boundary Edge  
-------------------------------------------------------------------------  
Te 0/0  
Te 0/1  
Te 0/2  
Te 0/3  
Te 0/8  
Te 0/19  
Te 0/20  
DIS  
ALT  
DSC 2000  
BLK 2000  
128  
128  
128  
128  
128  
128  
128  
P2P  
P2P  
P2P  
P2P  
P2P  
P2P  
P2P  
Yes  
Yes  
Yes  
Yes  
Yes  
Yes  
Yes  
No  
No  
No  
No  
No  
No  
No  
RTPT BLK 2000  
DIS  
DIS  
DIS  
DIS  
BLK 2000  
DSC 2000  
DSC 2000  
DSC 2000  
See Also  
show spanning-tree interface  
142  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show spanning-tree interface  
9
show spanning-tree interface  
Displays the state of the Spanning Tree Protocol for all named port-channels or 10 Gbps Ethernet  
interfaces.  
Synopsis  
Operands  
show spanning-tree interface [port-channel number | tengigabitethernet slot/port]  
port-channel number  
Specifies the port-channel number. The range of valid values is 1-63.  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
slot  
Specifies a valid slot number.  
Specifies a valid port number.  
port  
Defaults  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display the state of the spanning tree for all named port-channels or 10 Gbps  
Ethernet interfaces.  
Usage  
The following describes the port roles, states and types:  
Guidelines  
Port roles—root port, designated port, alternate port and backup port.  
Port states—discarding, learning, and forwarding.  
Port types—edge port (PortFast), point-to-point, and shared port.  
Examples  
To display information on a 10 Gbps Ethernet interface:  
switch#show spanning-tree interface tengigabitethernet 0/0  
Spanning-tree Mode: Rapid Spanning Tree Protocol  
Root Id: 8000.0005.1e76.1aa0 (self)  
Bridge Id: 8000.0005.1e76.1aa0  
Port Te 0/0 enabled  
IfIndex: 67108864; Id: 8000; Role: Disabled; State: Discarding  
Designated Path Cost: 0  
Configured Path Cost: 2000  
Designated Port Id: 0; Port Priority: 128  
Designated Bridge: 0000.0000.0000.0000  
Number of forward-transitions: 0  
Version Rapid Spanning Tree Protocol - Received None - Send RSTP  
Edgeport: off; AutoEdge: no; AdminEdge: no; EdgeDelay: 3 sec  
Configured Root guard: off; Operational Root guard: off  
Boundary: yes  
Bpdu-guard: off  
Bpdu-filter: off  
Link-type: point-to-point  
Received BPDUs: 0; Sent BPDUs: 0  
See Also  
show spanning-tree brief  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
143  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show spanning-tree mst brief  
9
show spanning-tree mst brief  
Displays the status and parameters of the Multiple Spanning Tree Protocol (MSTP) instance  
information in brief.  
Synopsis  
Operands  
Defaults  
show spanning-tree mst brief  
none  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display the status and parameters of the Multiple Spanning Tree Protocol  
(MSTP) instance information. It includes the port roles, port states and port types.  
Usage  
The following describes the port roles, states, and types:  
Guidelines  
Port roles—root port, designated port, alternate port, and backup port.  
Port states—discarding, learning, and forwarding.  
Port types—edge port (PortFast), point-to-point, and shared port.  
Examples  
To display the status and parameters of the MSTP instance information:  
switch#show spanning-tree mst brief  
Spanning-tree Mode: Multiple Spanning Tree Protocol  
CIST Root ID  
Priority 32768  
Address 0005.1e76.1aa0  
Priority 32768  
CIST Bridge ID  
Address 0005.1e76.1aa0  
Priority 32768  
CIST Regional Root ID  
Address 0005.1e76.1aa0  
Configured Hello Time 2, Max Age 20, Forward Delay 15  
Max Hops 20, Tx-HoldCount 6  
CIST Root Hello Time 2, Max Age 20, Forward Delay 15, Max Hops 20  
CIST Root path cost 0  
Interface  
Role Sts Cost  
Prio Link-type  
Boundary Edge  
-------------------------------------------------------------------------  
Te 0/0  
Te 0/1  
Te 0/2  
Te 0/3  
Te 0/8  
Te 0/19  
Te 0/20  
DIS  
ALT  
DSC 2000  
BLK 2000  
128  
128  
128  
128  
128  
128  
128  
P2P  
P2P  
P2P  
P2P  
P2P  
P2P  
P2P  
Yes  
Yes  
Yes  
Yes  
Yes  
Yes  
Yes  
No  
No  
No  
No  
No  
No  
No  
RTPT BLK 2000  
DIS  
DIS  
DIS  
DIS  
BLK 2000  
DSC 2000  
DSC 2000  
DSC 2000  
See Also  
show spanning-tree mst interface, show spanning-tree mst instance  
144  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show spanning-tree mst detail  
9
show spanning-tree mst detail  
Displays details on an interface for the Multiple Spanning Tree Protocol (MSTP) instance running.  
Synopsis  
Operands  
show spanning-tree mst detail [interface port-channel number | interface tengigabitethernet  
slot/port]  
interface  
Specifies the interface for which to display the spanning-tree information.  
port-channel number  
Specifies the port-channel of the interface. The range of valid values is 1-63.  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
Specifies a valid slot number.  
slot  
port  
Specifies a valid port number.  
Defaults  
There are no default configuration for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display details on a specified interface for the MSTP instance running.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To display MSTP information on the switch in detail:  
switch#show spanning-tree mst detail  
Spanning-tree Mode: Multiple Spanning Tree Protocol  
CIST Root Id: 8000.0005.1e76.1aa0 (self)  
CIST Bridge Id: 8000.0005.1e76.1aa0  
CIST Reg Root Id: 8000.0005.1e76.1aa0 (self)  
CIST Root Forward Delay: 15; Hello Time: 2; Max Age: 20; Max-hops: 20  
Configured Forward Delay: 15; Hello Time: 2; Max Age: 20; Max-hops: 20;  
Tx-HoldCount: 6  
Number of topology change(s): 0  
Bpdu-guard errdisable timeout: disabled  
Bpdu-guard errdisable timeout interval: 300 sec  
Migrate Time: 3 sec  
CIST Port Details.  
==================  
Instance: 0; Vlans:1, 100  
Port Te 0/0 enabled  
IfIndex: 67108864; Id: 8000; Role: Disabled; State: Discarding  
Designated External Path Cost: 0; Internal Path Cost 0  
Configured Path Cost: 2000  
Designated Port Id: 0; CIST Priority: 128  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
145  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show spanning-tree mst detail  
9
Designated Bridge: 0000.0000.0000.0000  
CIST Port Hello Time: 2  
Number of forward-transitions: 0  
Version Multiple Spanning Tree Protocol - Received None - Send MSTP  
Edgeport: off; AutoEdge: no; AdminEdge: no; EdgeDelay: 3 sec  
Configured Root guard: off; Operational Root guard: off  
Boundary: yes  
Bpdu-guard: off  
Bpdu-filter: off  
Link-type: point-to-point  
Received BPDUs: 0; Sent BPDUs: 0  
Port Te 0/8 enabled  
IfIndex: 67633408; Id: 8008; Role: Disabled; State: Discarding  
Designated External Path Cost: 0; Internal Path Cost 0  
Configured Path Cost: 2000  
Designated Port Id: 0; CIST Priority: 128  
Designated Bridge: 0000.0000.0000.0000  
CIST Port Hello Time: 2  
Number of forward-transitions: 0  
Version Multiple Spanning Tree Protocol - Received None - Send MSTP  
Edgeport: off; AutoEdge: no; AdminEdge: no; EdgeDelay: 3 sec  
Configured Root guard: off; Operational Root guard: off  
Boundary: yes  
Bpdu-guard: off  
Bpdu-filter: off  
Link-type: point-to-point  
Received BPDUs: 0; Sent BPDUs: 0  
Port Te 0/19 enabled  
IfIndex: 68354563; Id: 8013; Role: Disabled; State: Discarding  
Designated External Path Cost: 0; Internal Path Cost 0  
Configured Path Cost: 2000  
Designated Port Id: 0; CIST Priority: 128  
Designated Bridge: 0000.0000.0000.0000  
CIST Port Hello Time: 2  
Number of forward-transitions: 0  
Version Multiple Spanning Tree Protocol - Received None - Send MSTP  
Edgeport: off; AutoEdge: no; AdminEdge: no; EdgeDelay: 3 sec  
Configured Root guard: off; Operational Root guard: off  
Boundary: yes  
Bpdu-guard: off  
Bpdu-filter: off  
Link-type: point-to-point  
Received BPDUs: 0; Sent BPDUs: 0  
Port Te 0/20 enabled  
IfIndex: 68420100; Id: 8014; Role: Disabled; State: Discarding  
Designated External Path Cost: 0; Internal Path Cost 0  
Configured Path Cost: 2000  
Designated Port Id: 0; CIST Priority: 128  
Designated Bridge: 0000.0000.0000.0000  
CIST Port Hello Time: 2  
Number of forward-transitions: 0  
Version Multiple Spanning Tree Protocol - Received None - Send MSTP  
Edgeport: off; AutoEdge: no; AdminEdge: no; EdgeDelay: 3 sec  
Configured Root guard: off; Operational Root guard: off  
Boundary: yes  
Bpdu-guard: off  
Bpdu-filter: off  
146  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
DRAFT: BROCADE CONFIDENTIAL  
show spanning-tree mst detail  
9
Link-type: point-to-point  
Received BPDUs: 0; Sent BPDUs: 0  
MSTI details.  
==============  
See Also  
show spanning-tree mst interface, show spanning-tree mst instance  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
147  
 
DRAFT: BROCADE CONFIDENTIAL  
show spanning-tree mst instance  
9
show spanning-tree mst instance  
Displays information on a specified Multiple Spanning Tree Protocol (MSTP) instance.  
Synopsis  
Operands  
show spanning-tree mst instance instance_id [interface port-channel number |interface  
tengigabitethernet slot/port]  
instance_id  
Specifies the MSTP instance for which to display information. The range of  
valid values is 1-15.  
interface  
Specifies the interface for which to display the MSTP instance information.  
port-channel number  
Specifies the port-channel of the interface. The range of valid values is 1-63.  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface for which to display the MSTP  
instance information.  
slot  
Specifies a valid slot number for the interface for which to display information  
on the MSPT instance.  
port  
Specifies a valid port number for the interface for which to display  
information on the MSPT instance.  
Defaults  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display information on a specified instance of the MSTP.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To display information on MSTP instance 1:  
switch#show spanning-tree mst instance 1 interface tengigabitethernet 0/0  
Instance: 1; VLANs: 100  
MSTI Root Id: 8001.0005.1e76.1aa0 (self)  
MSTI Bridge Id: 8001.0005.1e76.1aa0  
MSTI Bridge Priority: 32768  
See Also  
show spanning-tree mst brief, show spanning-tree interface  
148  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show spanning-tree mst interface  
9
show spanning-tree mst interface  
Displays information for a specified interface for a Multiple Spanning Tree Protocol (MSTP)  
instance.  
Synopsis  
Operands  
show spanning-tree mst interface [port-channel number| tengigabitethernet slot/port]  
port-channel number  
Specifies the port-channel of the interface. The range of valid values is 1-63.  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
slot  
Specifies a valid slot number for the interface for which to display information  
for the MSTP instance.  
port  
Specifies a valid port number for the interface for which to display  
information for the MSTP instance.  
Defaults  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display MSTP protocol specific information such as Common and Internal  
Spanning Tree (CIST) spanning-tree related information, information to each MSTP instance (MSTI),  
and the state of the port specific to each MSTI.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To display information for the MSTP interface:  
switch#show spanning-tree mst interface tengigabitethernet 0/0  
Spanning-tree Mode: Multiple Spanning Tree Protocol  
CIST Root Id: 8000.0005.1e76.1aa0 (self)  
CIST Bridge Id: 8000.0005.1e76.1aa0  
CIST Reg Root Id: 8000.0005.1e76.1aa0 (self)  
CIST Operational Port Hello Time: 0  
Number of forward-transitions: 0  
Version: Multiple Spanning Tree Protocol - Received None - Send MSTP  
Edgeport: off; AutoEdge: no; AdminEdge: no; EdgeDelay: 3 sec  
Configured Root guard: off; Operational Root guard: off  
Boundary: yes  
Bpdu-guard: off  
Bpdu-filter: off  
Link-type: point-to-point  
Received BPDUs: 0; Sent BPDUs: 0  
Instance  
-----------------------------------------------------------------------  
DIS DSC 2000 128  
Role Sts Cost  
Prio VLANs  
0
1
See Also  
show spanning-tree brief, show spanning-tree mst brief  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
149  
 
 
DRAFT: BROCADE CONFIDENTIAL  
shutdown  
9
shutdown  
Disables the Multiple Spanning Tree Protocol (MSTP), Rapid Spanning Tree (RSTP), or the Spanning  
Tree Protocol (STP) globally.  
Synopsis  
shutdown  
no shutdown  
Operands  
Defaults  
none  
STP is not required in a loop-free topology and is not enabled by default.  
Protocol Spanning Tree mode  
Command  
Modes  
Description  
Use this command to disable the MSTP, RSTP, or STP protocol globally.  
This command has no usage guidelines.  
Usage  
Guidelines  
Examples  
To disable STP globally:  
switch(config)#protocol spanning-tree rstp  
switch(conf-rstp)#shutdown  
To enable STP globally:  
switch(config)#protocol spanning-tree rstp  
switch(conf-rstp)#no shutdown  
See Also  
none  
150  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
spanning-tree autoedge  
9
spanning-tree autoedge  
Enables automatic edge detection.  
spanning-tree autoedge  
Synopsis  
no spanning-tree autoedge  
none  
Operands  
Defaults  
Auto detection is not enabled.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to automatically identify the edge port.  
Usage  
The port can become an edge port if no Bridge Protocol Data Unit (BPDU) is received.  
Guidelines  
Examples  
See Also  
To enable automatic edge detection:  
switch(conf-if-te-0/1)#spanning-tree autoedge  
protocol spanning-tree  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
151  
 
 
DRAFT: BROCADE CONFIDENTIAL  
spanning-tree cost  
9
spanning-tree cost  
Changes an interface's spanning-tree port path cost.  
spanning-tree cost cost  
cost  
.Synopsis  
Operands  
Specifies the path cost for the Spanning Tree Protocol (STP) calculations. The  
range of valid values is 1-200000000.  
Defaults  
The default path cost is 200000000.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to configure the path cost for spanning-tree calculations.  
Lower path cost indicates a greater chance of becoming root.  
Usage  
Guidelines  
Examples  
See Also  
To set the port cost to 128:  
switch(conf-if-te-0/1)#spanning-tree cost 128  
show spanning-tree  
152  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
spanning-tree edgeport  
9
spanning-tree edgeport  
Enables the edge port on an interface to allow the interface to quickly transition to the forwarding  
state.  
Synopsis  
Operands  
spanning-tree edgeport [bpdu-filter | bpdu-guard]  
bpdu-filter  
Sets the edge port Bridge Protocol Data Unit (BPDU) filter for the port.  
Guards the port against the reception of BPDUs.  
bpdu-guard  
Defaults  
Edge port is disabled.  
Command  
Modes  
Interface configuration mode  
Description  
Use this command to enable the edge port feature. This command is only for RSTP and MSTP. Use  
the spanning-tree portfast command for STP.  
Usage  
Note the following details about edge ports and their behavior:  
Guidelines  
A port can become an edge port if no BPDU is received.  
When an edge port receives a BPDU, it becomes a normal spanning-tree port and is no longer  
an edge port.  
Because ports directly connected to end stations cannot create bridging loops in the network,  
edge ports directly transition to the forwarding state, and skip the listening and learning states  
Examples  
To enable a port to quickly transition to the forwarding state:  
switch(conf-if-te-0/1)#spanning-tree edgeport  
To set the edgeport BPDU filter for the port:  
switch(conf-if-te-0/1)#spanning-tree edgeport bpdu-filter  
To guard the port against reception of BPDUs:  
switch(conf-if-te-0/1)#spanning-tree edgeport bpdu-guard  
See Also  
spanning-tree portfast bpdu-guard, spanning-tree autoedge  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
153  
 
 
DRAFT: BROCADE CONFIDENTIAL  
spanning-tree guard root  
9
spanning-tree guard root  
Enables the guard root to restrict which interface is allowed to be the spanning-tree root port or the  
path-to-the root for the switch.  
Synopsis  
spanning-tree guard root  
no spanning-tree guard root  
Operands  
Defaults  
none  
Guard root is disabled.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to enable the guard root on the interface. Use the no spanning-tree guard root  
command to disable guard root on the selected interface.  
Usage  
The root port provides the best path from the switch to the root switch.  
Guidelines  
Note  
Guard root protects the root bridge from malicious attacks and unintentional misconfigurations  
where a bridge device that is not intended to be the root bridge becomes the root bridge. This  
causes severe bottlenecks in the datapath. Guard root ensures that the port on which it is enabled  
is a designated port. If the guard root enabled port receives a superior Bridge Protocol Data Unit  
(BPDU), it goes to a discarding state.  
Examples  
See Also  
To enable guard root:  
switch(conf-if-te-0/1)#spanning-tree guard root  
spanning-tree cost  
154  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
spanning-tree hello-time  
9
spanning-tree hello-time  
Configures the hello-time in seconds on the interface.  
Synopsis  
spanning-tree hello-time seconds  
no spanning-tree hello-time  
Operands  
Defaults  
seconds  
Sets the interval between the hello Bridge Protocol Data Units (BPDUs) sent  
by the root switch configuration messages. The range of valid values 1-10.  
The default is 2 seconds.  
Command  
Modes  
Interface configuration mode  
Description  
Use this command to set the interval time between the BPDUs sent by the root switch. Use the no  
spanning-tree hello-time command to return to the default setting.This command is only for MSTP.  
Usage  
Guidelines  
Changing the hello-time affects all spanning-tree instances. The max-age setting must be greater  
than the hello-time setting.  
Examples  
See Also  
To set the hello time to 5 seconds:  
switch(conf-if-te-0/1)#spanning-tree hello-time 5  
forward-delay, max-age, show spanning-tree  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
155  
 
 
DRAFT: BROCADE CONFIDENTIAL  
spanning-tree instance  
9
spanning-tree instance  
Sets restrictions for the port of particular MSTP instance.  
Synopsis  
Operands  
spanning-tree instance instance_id [cost cost |priority priority|restricted-role |restricted-tcn]  
no spanning-tree instance instance_id [cost cost |priority priority|restricted-role |restricted-tcn]  
instance_id  
cost cost  
Specifies the MSTP instance. The range of valid values is 1-15.  
Specifies the path-cost for a port. The range of valid values is 1-20000000.  
priority priority  
Specifies the port priority for a bridge in increments of 16. The range of valid  
values is 0-240.  
restricted-role  
restricted-tcn  
Specifies to restrict the role of a port.  
Specifies to restrict the propagation of the topology change notifications from  
a port.  
Defaults  
The default path-cost value is 2000 on a 10 Gbps Ethernet interface.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to set restrictions for a port on a particular MSTP instance.  
Use this command for MSTP-specific configurations.  
Usage  
Guidelines  
Examples  
See Also  
To set restrictions for the port of MSTP instance 1 with the cost of 40000:  
switch(conf-if-te-0/1)#spanning-tree instance 1 cost 40000  
instance, show spanning-tree  
156  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
spanning-tree link-type  
9
spanning-tree link-type  
Enables and disables the rapid transition for the Spanning Tree Protocol.  
Synopsis  
Operands  
Defaults  
spanning-tree link-type [point-to-point | shared]  
no spanning-tree link-type  
point-to-point  
shared  
Enables rapid transition.  
Disables rapid transition.  
The default is point-to-point.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to specify a link type for the Spanning Tree Protocol.  
This command overrides the default setting of the link type.  
Usage  
Guidelines  
Examples  
See Also  
To specify the link type as shared:  
switch(conf-if-te-0/0)#spanning-tree link-type shared  
spanning-tree link-type shared, no spanning-tree link-type  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
157  
 
 
DRAFT: BROCADE CONFIDENTIAL  
spanning-tree portfast  
9
spanning-tree portfast  
Enables the Port Fast feature on an interface to allow the interface to quickly transition to  
forwarding state.  
Synopsis  
Operands  
spanning-tree portfast [bpdu-filter | bpdu-guard]  
bpdu-filter  
Sets the Port Fast BPDU filter for the port.  
bpdu-guard  
Guards the port against the reception of BPDUs.  
Defaults  
Port Fast is disabled.  
Command  
Modes  
Interface configuration mode  
Description  
Use this command to enable the Port Fast feature. This command is is the only for the STP. Port  
Fast immediately puts the interface into the forwarding state without having to wait for the  
standard forward time. Use the spanning-tree edgeport command for MSTP and RSTP.  
Usage  
Guidelines  
If you enable portfast bpdu-guard on an interface and the interface receives a BPDU, the software  
disables the interface and puts the interface in the ERR_DISABLE state.  
Examples  
To enable a port to quickly transition to the forwarding state:  
switch(conf-if-te-0/1)#spanning-tree portfast  
To set the Port Fast BPDU filter for the port:  
switch(conf-if-te-0/1)#spanning-tree portfast bpdu-filter  
To guard the port against the reception of BPDUs:  
switch(conf-if-te-0/1)#spanning-tree portfast bpdu-guard  
See Also  
spanning-tree portfast bpdu-guard, spanning-tree autoedge  
158  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
spanning-tree priority  
9
spanning-tree priority  
Changes an interface's spanning-tree port priority.  
Synopsis  
spanning-tree priority priority  
no spanning-tree priority priority  
Operands  
Defaults  
priority  
Specifies the interface priority for the spanning tree. The range of valid values  
is 0-240. Port priority is in increments of 16.  
The default value is 128.  
Command  
Modes  
Interface configuration mode  
Description  
Use this command to change an interface's spanning-tree port priority. Use the no spanning-tree  
priority command to return to the default setting.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
To configure the port priority to 16:  
switch(conf-if-te-0/1)#spanning-tree priority 16  
spanning-tree cost, show spanning-tree  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
159  
 
 
DRAFT: BROCADE CONFIDENTIAL  
spanning-tree restricted-role  
9
spanning-tree restricted-role  
Restricts the role of the port from becoming a root port.  
Synopsis  
spanning-tree restricted-role  
no spanning-tree restricted-role  
Operands  
Defaults  
none  
The restricted role is disabled.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to configure the port from becoming a root port. Use the no spanning-tree  
restricted-role command to return to the default setting.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
To configure the port from becoming a root port:  
switch(conf-if-te-0/1)#spanning-tree restricted-role  
show spanning-tree  
160  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
spanning-tree restricted-tcn  
9
spanning-tree restricted-tcn  
Restricts the topology change notification Bridge Protocol Data Units (BPDUs) sent on the port.  
Synopsis  
spanning-tree restricted-tcn  
no spanning-tree restricted-tcn  
Operands  
Defaults  
none  
The restricted TCN is disabled.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to restrict the topology change notification Bridge Protocol Data Units (BPDUs)  
sent on the port.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
To restrict the TCN on a specific interface:  
switch(conf-if-te-0/1)#spanning-tree restricted-tcn  
show spanning-tree  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
161  
 
 
DRAFT: BROCADE CONFIDENTIAL  
spanning-tree shutdown  
9
spanning-tree shutdown  
Enables or disables spanning tree on the interface.  
spanning-tree shutdown  
Synopsis  
no spanning-tree shutdown  
none  
Operands  
Defaults  
Spanning tree is not enabled.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to disable spanning tree on the interface or VLAN. Use the no spanning-tree  
shutdown command to enable spanning tree on the interface or VLAN.  
Once all of the interface ports have been configured for a VLAN, you can enable spanning tree  
protocol (STP) for all members of the VLAN with a single command. Whichever protocol is currently  
selected is used by the VLAN. Only one type of STP can be active at a time.  
A physical interface port can be a member of multiple VLANs. For example, a physical port can be a  
member of VLAN 1002 and VLAN 55 simultaneously. In addition, VLAN 1002 can have STP enabled  
and VLAN 55 can have STP disabled simultaneously.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To disable spanning tree on a specific interface:  
switch(config)#interface tengigabitethernet 0/1  
switch(conf-if-te-0/1)#spanning-tree shutdown  
To enable spanning tree on VLAN 1002:  
switch(config)#interface vlan 1002  
switch(conf-if-vl-1002)#no spanning-tree shutdown  
See Also  
protocol spanning-tree  
162  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
spanning-tree tc-flush-standard  
9
spanning-tree tc-flush-standard  
Flushes the Media Access Control (MAC) address based on the optimal scheme.  
Synopsis  
spanning-tree tc-flush-standard  
no spanning-tree tc-flush-standard  
Operands  
Defaults  
none  
MAC address flushing is enabled.  
Global configuration mode  
Command  
Modes  
Description  
Use this command to flush the MAC address based on the optimal scheme. Use the no  
spanning-tree tc-flush-standard command to disable the MAC address flushing.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
To disable the MAC address flushing upon receiving any topology change notification:  
switch(config)#no spanning-tree tc-flush-standard  
show spanning-tree brief  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
163  
 
 
DRAFT: BROCADE CONFIDENTIAL  
transmit-holdcount  
9
transmit-holdcount  
Configures the maximum number of Bridge Protocol Data Units (BPDUs) transmitted per second for  
the Multiple Spanning Tree Protocol (MSTP) and the Rapid Spanning Tree Protocol RSTP.  
Synopsis  
transmit-holdcount number  
no transmit-holdcount  
Operands  
Defaults  
number  
Specifies the value in seconds for the number of BPDUs than can be sent  
before pausing for 1 second. The range of valid values is 1-10.  
The default is 6.  
Command  
Modes  
Protocol Spanning Tree MSTP mode  
Description  
Use this command to configure the BPDU burst size by changing the transmit hold count value. Use  
the no transmit-holdcount command to return to the default setting.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
To change the number of BPDUs transmitted to 3 seconds:  
switch(conf-mstp)#transmit-holdcount 3  
show spanning-tree mst detail  
164  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
Chapter  
Internet Group Management Protocol Commands  
10  
clear ip igmp group  
Clears information related to learned groups in the IGMP protocol module.  
Synopsis  
Operands  
clear ip igmp group [A.B.C.D [interface tengigabitethernet slot/port | interface port-channel  
number | interface vlan vlan_id] | interface tengigabitethernet slot/port | interface port-channel  
number | interface vlan vlan_id]  
A.B.C.D  
Specifies the group address, as a subnet number in dotted decimal format  
(for example, 10.0.0.1), as the allowable range of addresses included in the  
multicast group.  
interface  
Use this keyword to specify any of the following interfaces:  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
slot  
port  
Specifies a valid slot number.  
Specifies a valid port number.  
interface  
Use this keyword to specify any of the following interfaces:  
port-channel number  
Specifies the interface is a port-channel. The range of valid values is 1-63.  
interface  
Use this keyword to specify any of the following interfaces:  
vlan vlan_id  
Specifies which VLAN interface to display the snooping configuration related  
information. The range of valid values is 1-3583.  
Defaults  
There are no defaults for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to clear the group information in the IGMP database, including entries for either  
a specific group on all interfaces or specific groups on specific interfaces.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
To clear information for all groups in the IGMP protocol:  
switch#clear ip igmp group  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
165  
 
     
DRAFT: BROCADE CONFIDENTIAL  
clear ip igmp groups  
10  
clear ip igmp groups  
Clears information related to learned groups in the IGMP protocol module.  
Synopsis  
Operands  
Defaults  
clear ip igmp groups  
none  
There are no defaults for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to clear all IGMP group information in the IGMP database.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
See Also  
To clear information for all groups in the IGMP protocol:  
switch#clear ip igmp groups  
none  
166  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
debug ip igmp all  
10  
debug ip igmp all  
Displays all IGMP information.  
Synopsis  
Operands  
debug ip igmp {all | group [A.B.C.D [interface tengigabitethernet slot/port|interface port-channel  
number| interface vlan vlan_id]]}  
all  
Displays all values.  
A.B.C.D  
Specifies the group address, as a subnet number in dotted decimal format  
(for example, 10.0.0.1), as the allowable range of addresses included in the  
multicast group.  
interface  
Use this keyword to specify any of the following interfaces:  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
slot  
Specifies a valid slot number.  
port  
Specifies a valid port number.  
vlan vlan_id  
Specifies which VLAN interface to display the snooping configuration related  
information. The range of valid values is 1-3583.  
port-channel number  
Specifies the interface is a port-channel. The range of valid values is 1-63.  
Description  
Defaults  
Displays all of the IGMP packets received and sent, and IGMP-host related events.  
There are no defaults for this command.  
Command  
Modes  
Privileged EXEC mode  
User Guidelines  
Example  
There are no user guidelines for this command.  
none  
none  
See Also  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
167  
 
 
DRAFT: BROCADE CONFIDENTIAL  
ip igmp last-member-query-interval  
10  
ip igmp last-member-query-interval  
Sets the last member query interval.  
Synopsis  
Operands  
ip igmp last-member-query-interval milliseconds  
milliseconds  
Response time in milliseconds. Valid range is 1000 to 25500 milliseconds.  
Default value is 1000 milliseconds.  
Description  
Defaults  
The last member query interval is the amount of time in seconds that the IGMP router waits to  
receive a response to a group query message.  
There are no defaults for this command.  
Privileged EXEC Mode  
Command  
Modes  
User Guidelines  
Example  
There are no user guidelines for this command.  
none  
none  
See Also  
168  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
ip igmp query-interval  
10  
ip igmp query-interval  
Sets the query interval.  
ip igmp query-interval seconds  
Synopsis  
Operands  
seconds  
Response time in seconds. Valid range is 1 to 18000 seconds. Default value  
is 125 seconds.  
Description  
Defaults  
The query interval is the amount of time in seconds between IGMP query messages sent by the  
switch.  
There are no defaults for this command.  
Privileged EXEC Mode  
Command  
Modes  
User Guidelines  
Example  
There are no user guidelines for this command.  
none  
none  
See Also  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
169  
 
 
DRAFT: BROCADE CONFIDENTIAL  
ip igmp query-max-response-time  
10  
ip igmp query-max-response-time  
Sets the query-max-response-time.  
ip igmp query-max-response-time seconds  
Synopsis  
Operands  
seconds  
Response time in seconds. Valid range is 1 to 25 seconds. Default value is 10  
seconds.  
Description  
When a host receives the query packet, it starts counting to a random value, less that the  
maximum response time. When this timer expires, the switch replies with a report, provided that no  
other host has responded yet.  
Defaults  
There are no defaults for this command.  
Privileged EXEC Mode  
Command  
Modes  
User Guidelines  
Example  
There are no user guidelines for this command.  
none  
none  
See Also  
170  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
ip igmp snooping enable (global version)  
10  
ip igmp snooping enable (global version)  
Enables the Internet Group Management Protocol (IGMP) snooping for all VLAN interfaces.  
Synopsis  
ip igmp snooping enable  
no ip igmp snooping enable  
Operands  
Defaults  
none  
IGMP snooping is globally disabled.  
Global Configuration mode  
Command  
Modes  
Description  
Use this command to enable or disable the Internet Group Management Protocol (IGMP) snooping  
globally. Use the no ip igmp snooping enable command to return to the default setting.  
Usage  
This command performs IGMP snooping at the interface level.  
Guidelines  
Examples  
See Also  
To enable igmp globally:  
switch(config)# ip igmp snooping enable  
show ip igmp snooping, ip igmp snooping enable (VLAN version)  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
171  
 
 
DRAFT: BROCADE CONFIDENTIAL  
ip igmp snooping enable (VLAN version)  
10  
ip igmp snooping enable (VLAN version)  
Enables the Internet Group Management Protocol (IGMP) snooping for a specific VLAN interface.  
ip igmp snooping enable  
Synopsis  
no ip igmp snooping enable  
Operands  
Defaults  
none  
When snooping is enabled globally, IGMP snooping enabled on all VLAN interfaces.  
Privileged EXEC Mode  
Command  
Modes  
Description  
Use this command to enable or disable the Internet Group Management Protocol (IGMP) snooping  
on a specific VLAN interface.  
Usage  
This command performs IGMP snooping at the VLAN interface level.  
Guidelines  
Examples  
To enable igmp for a specific VLAN interface, enter Interface VLAN mode and execute the following  
command:  
switch#ip igmp snooping enable  
See Also  
show ip igmp snooping, ip igmp snooping enable (global version)  
172  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
ip igmp snooping fast-leave  
10  
ip igmp snooping fast-leave  
Enables snooping fast-leave.  
ip igmp snooping fast-leave  
Synopsis  
no ip igmp snooping fast-leave  
none  
Operands  
Description  
IGMP snooping fast-leave processing allows the removal of an interface from the forwarding-table  
without sending out group specific queries to the interface.  
Defaults  
This mode is disabled by default.  
Global Configuration mode  
Command  
Modes  
User Guidelines  
Example  
Use no ip igmp snooping fast-leave to disable this function.  
none  
none  
See Also  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
173  
 
 
DRAFT: BROCADE CONFIDENTIAL  
ip igmp snooping mrouter  
10  
ip igmp snooping mrouter  
Configures a VLAN port member to be a multicast router interface.  
Synopsis  
Operands  
ip igmp snooping mrouter {interface tengigabitethernet slot/port|interface port-channel number}  
no ip igmp snooping mrouter {interface tengigabitethernet slot/port|interface port-channel  
number}  
interface  
Use this keyword to specify any of the following interfaces:  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
slot  
Specifies a valid slot number.  
port  
Specifies a valid port number.  
port-channel number  
Specifies the interface is a port-channel. The range of valid values is 1-63.  
Defaults  
There are no default configurations for this command.  
Privileged EXEC Mode  
Command  
Modes  
Description  
Use this command to configure a VLAN port member to be a multi-router port.  
Usage  
Use the no ip igmp snooping mrouter version of this command to return to the default setting.  
Guidelines  
Examples  
See Also  
To configure a VLAN port member to be a multicast router interface.  
switch#ip igmp snooping mrouter interface tengigabitethernet 0/1  
show ip igmp snooping mrouter  
174  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
ip igmp snooping mrouter-timeout  
10  
ip igmp snooping mrouter-timeout  
Configures the mrouter-time-out  
Synopsis  
Operands  
ip igmp snooping mrouter-timeout seconds  
seconds  
Timeout time in seconds. Valid range is 1 to 60000 seconds. Default value is  
300 seconds.  
Description  
Defaults  
This command sets the timeout range for when multicast router ports are automatically learned.  
There are no defaults for this command.  
Command  
Modes  
Privileged EXEC Mode  
User Guidelines  
Example  
There are no user guidelines for this command.  
none  
none  
See Also  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
175  
 
 
DRAFT: BROCADE CONFIDENTIAL  
ip igmp snooping querier enable  
10  
ip igmp snooping querier enable  
Activates or deactivates the IGMP snooping querier functionality for the VLAN.  
Synopsis  
ip igmp snooping querier enable  
no ip igmp snooping querier enable  
Operands  
Defaults  
none  
This feature is not enabled by default.  
Privileged EXEC Mode  
Command  
Modes  
Description  
Use this command to activate or deactivate the IGMP snooping querier functionality for the VLAN.  
Use the no ip igmp snooping querier enable command to return to the default setting.  
Usage  
Use no ip igmp snooping querier enable to disable this command.  
Guidelines  
Examples  
See Also  
To enable the IGMP snooping querier feature:  
switch(conf-if-vl-1)#ip igmp snooping querier enable  
show ip igmp interface, show ip igmp snooping interface  
176  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
ip igmp static-group  
10  
ip igmp static-group  
Configures the static group membership entries.  
Synopsis  
ip igmp static-group A.B.C.D {interface tengigabitethernet slot/port|interface port-channel  
number}  
no ip igmp static-group A.B.C.D {interface tengigabitethernet slot/port|interface port-channel  
number}  
Operands  
A.B.C.D  
Specifies the group address, as a subnet number in dotted decimal format  
(for example, 10.0.0.1), as the allowable range of addresses included in the  
multicast group.  
interface  
Use this keyword to specify any of the following interfaces:  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
slot  
Specifies a valid slot number.  
port  
Specifies a valid port number.  
port-channel number  
Specifies the interface is a port-channel. The range of valid values is 1-63.  
Description  
Defaults  
Using ip igmp static-group, packets to the group are fast-switched out of the interface, providing  
that the packets were received on the correct reverse path forwarding (RPF) interface. Static group  
membership entries are automatically added to the IGMP cache and mroute table.  
There are no defaults for this command.  
Privileged EXEC Mode  
Command  
Modes  
User Guidelines  
Example  
There are no user guidelines for this command.  
none  
none  
See Also  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
177  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show debug ip igmp  
10  
show debug ip igmp  
Displays the IGMP packets received and transmitted, as well as related events.  
Synopsis  
Operands  
Description  
Defaults  
show debug ip igmp  
none  
This command displays the IGMP packets received and transmitted.  
There are no defaults for this command.  
Privileged EXEC mode  
Command  
Modes  
User Guidelines  
Example  
There are no user guidelines for this command.  
none  
none  
See Also  
178  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show ip igmp groups  
10  
show ip igmp groups  
Displays information related to learned groups in the IGMP protocol module.  
Synopsis  
Operands  
show ip igmp groups [A.B.C.D |detail [[interface tengigabitethernet slot/port |detail]|[interface  
port-channel number |detail]| [interface vlan vlan_id |detail]]]  
A.B.C.D  
Specifies the group address, as a subnet number in dotted decimal format  
(for example, 10.0.0.1), as the allowable range of addresses included in the  
multicast group.  
detail  
Displays the IGMPv3 source information.  
interface  
Use this keyword to specify any of the following interfaces:  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
slot  
port  
Specifies a valid slot number.  
Specifies a valid port number.  
detail  
Displays the IGMPv3 source information.  
Use this keyword to specify any of the following interfaces:  
interface  
vlan vlan_id  
Specifies which VLAN interface to display the snooping configuration related  
information. The range of valid values is 1-3583.  
detail  
Displays the IGMPv3 source information.  
interface  
Use this keyword to specify any of the following interfaces:  
port-channel number  
Specifies the interface is a port-channel. The range of valid values is 1-63.  
detail  
Displays the IGMPv3 source information.  
Defaults  
There are no defaults for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to display the IGMP database, including configured entries for either all groups  
on all interfaces, or all groups on specific interfaces, or specific groups on specific interfaces.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
none  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
179  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show ip igmp snooping  
10  
show ip igmp snooping  
Displays IGMP snooping information.  
Synopsis  
Operands  
show ip igmp snooping {[interface vlan vlan_id | mrouter interface vlan vlan_id | statistics  
interface vlan vlan_id]}  
interface  
vlan vlan_id  
Use this keyword to specify any of the following interfaces:  
Specifies which VLAN interface to display the snooping configuration related  
information. The range of valid values is 1-3583.  
mrouter interface  
Use this keyword to specify any of the following interfaces:  
vlan vlan_id  
Specifies which VLAN interface to display the snooping configuration related  
information. The range of valid values is 1-3583.  
statistics interface Use this keyword to specify any of the following interfaces:  
vlan vlan_id  
Specifies which VLAN interface to display the snooping configuration related  
information. The range of valid values is 1-3583.  
Defaults  
There are no defaults for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to display IGMP snooping information.display multicast router port related  
information for the specified VLAN, or to display snooping statistics for the specified VLAN in the  
IGMP protocol module.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
To display information the IGMP snooping information for VLAN 5:  
switch#show ip igmp snooping interface vlan 5  
none  
180  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show running-config igmp  
10  
show running-config igmp  
Displays the IGMP configuration.  
show running-config igmp  
none  
Synopsis  
Operands  
Description  
This command displays the IGMP contents of the currently running configuration. Note that this  
information may differ from the contents of the actual running-config file.  
Defaults  
There are no defaults for this command.  
Privileged EXEC mode  
Command  
Modes  
User Guidelines  
Example  
There are no user guidelines for this command.  
none  
none  
See Also  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
181  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show running-config igmp  
10  
182  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
DRAFT: BROCADE CONFIDENTIAL  
Chapter  
RMON Commands  
11  
rmon alarm  
Sets alarm conditions.  
Synopsis  
Operands  
rmon alarm index snmp_oid interval seconds {absolute | delta} rising-threshold value event  
number [falling-threshold value event number [owner name] | owner name]  
no rmon alarm index [snmp_oid interval seconds {absolute | delta} rising-threshold value event  
number [falling-threshold value event number [owner name] | owner name]]  
index  
Specifies the alarm index. The range of valid values is 1-65535.  
snmp_oid  
Specifies the MIB object to monitor. The variable must be in the SNMP OID  
format, for example, 1.3.6.1.2.1.16.1.1.1.5.65535. The object type must be a  
counter32.  
interval seconds  
Specifies the alarm sample interval in seconds. The range of valid values is  
1-2147483648.  
absolute  
delta  
Sets the sample type as absolute.  
Sets the sample type as delta.  
rising-threshold value  
Specifies the alarm rising threshold. The range of valid values is  
0-4294967295.  
event number Specifies the event for the rising alarm. The range of valid values is 1-65535.  
falling-threshold value  
Specifies the alarm falling threshold. The range of valid values is  
0-4294967295.  
event number Specifies the event for the rising alarm. The range of valid values is 1-65535.  
owner name  
Specifies the identity of the owner. The maximum number of characters is 32.  
Defaults  
There are no alarms configured.  
Global configuration mode  
Command  
Modes  
Description  
Use this command to set alarm conditions. Use the no rmon alarm command to disable the alarm  
conditions.  
Usage  
Guidelines  
There are no usage guidelines for this command.  
To set alarm conditions:  
Examples  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
183  
 
     
DRAFT: BROCADE CONFIDENTIAL  
rmon alarm  
See Also  
11  
switch(config)#rmon alarm 100 1.3.6.1.2.1.16.1.1.1.5.65535 interval 5 absolute  
rising-threshold 10000 event 100 falling-threshold 1000 event 101 owner admin  
rmon event, show rmon  
184  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
DRAFT: BROCADE CONFIDENTIAL  
rmon collection stats  
11  
rmon collection stats  
Collects Ethernet group statistics on an interface.  
Synopsis  
Operands  
rmon collection stats number [owner name]  
no rmon collection stats number [owner name]  
number  
Specifies the RMON collection control index value. The range of valid values  
is 1-65535.  
owner name  
Specifies the identity of the owner.  
Defaults  
The collection of RMON statistics is not enabled.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to collect Ethernet group statistics on an interface. Use the no rmon collection  
stats command to disable the collection of statistics.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To collect RMON statistics for the owner admin on 10 Gbps Ethernet interface 0/1:  
switch(config)#interface tengigabitethernet 0/1  
switch(conf-if-te-0/1)#rmon collection stats 2 owner admin  
See Also  
show rmon statistics  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
185  
 
 
DRAFT: BROCADE CONFIDENTIAL  
rmon event  
11  
rmon event  
Adds or removes an event in the RMON event table associated to the RMON alarm number.  
Synopsis  
Operands  
rmon event index [description word] [log] [owner name] [trap word]  
no rmon event index [description word] [log] [owner name] [trap word]  
index  
Specifies the RMON event number. The range of valid values is 1-65535.  
Specifies a description of the event.  
description word  
log  
Generates an RMON log when an event is triggered.  
owner name  
trap word  
Specifies the owner of the event. The maximum number of characters is 32.  
Specifies the SNMP community or string name to identify this trap.  
Defaults  
There are no events configured.  
Global configuration mode  
Command  
Modes  
Description  
Use this command to add or remove an event in the RMON event table that is associated with an  
RMON alarm number. Use the no rmon event command to remove the event configuration.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
To configure an RMON event:  
switch(config)#rmon event 2 log description “My Errorstoday” owner gjack  
show rmon events  
186  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show rmon  
11  
show rmon  
Displays the current RMON status on the switch.  
Synopsis  
Operands  
show rmon [alarms [number] [brief] | events [number] [brief]| logs [event_number] | statistics  
[number] [brief] ]  
alarms  
number  
Specifies to display the RMON alarm table.  
Specifies the alarm index identification number. The range of valid values is  
1-65535.  
brief  
events  
Specifies to display a brief summary of the output.  
Specifies to display the RMON events table.  
number  
Specifies the event index identification number. The range of valid values is  
1-65535.  
brief  
Specifies to display a brief summary of the output.  
Specifies to display the RMON log table.  
logs  
event_number Specifies the event index identification number. The range of valid values is  
1-65535.  
statistics  
number  
Specifies to display the statistics identification number.  
Specifies the statistics identification number. The range of valid values is  
1-65535.  
brief  
Specifies a brief summary of the output.  
Defaults  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display the status of the current RMON on the switch.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To display the RMON statistics:  
switch#show rmon statistics  
rmon collection index 4  
Interface index is Id: 67108864 , Name : TenGigabitEthernet 0/0  
Receive Statistics:  
218903 packets, 14015626 bytes, 0 packs dropped  
Multicasts: 218884, Broadcasts: 18  
Under-size : 0, Jabbers: 0, CRC: 0  
Fragments: 0, Collisions: 0  
64 byte pkts: 218722, 65-127 byte pkts: 174  
128-255 byte pkts: 0, 256-511 byte pkts: 6  
512-1023 byte pkts: 0, 1024-1518 byte pkts: 0  
Over 1518-byte pkts(Oversize - Jumbo): 0  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
187  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show rmon  
11  
Owner: RMON_SNMP  
Status: ok(1)  
To display the RMON events:  
switch#show rmon events  
event Index = 4  
Description "My Description"  
Event type Log & SnmpTrap  
Event community name admin  
Last Time Sent = 00:00:00  
Owner admin  
See Also  
rmon alarm, rmon event  
188  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
DRAFT: BROCADE CONFIDENTIAL  
Chapter  
QoS Commands  
12  
cee  
Applies a CEE Provisioning map on an interface.  
cee name  
Synopsis  
no cee  
Operands  
Defaults  
name  
Specifies the name of a previously created CEE map. Any existing CEE map  
must be removed before a new one can be applied.  
There is no CEE Provisioning applied on an interface.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to apply a CEE map on an interface. Use the no cee command to remove the  
CEE Provisioning map.  
Usage  
The CEE map applied on an interface should exist on the switch.  
Guidelines  
Examples  
To apply a CEE map on an interface:  
switch(conf-if-te-0/1)#cee demo  
Because the switch does not allow applying a CEE map that does not exist, the following error  
displays:  
switch(conf-if-te-0/1)#cee test  
% Error: Map does not exist  
See Also  
cee-map  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
189  
 
     
DRAFT: BROCADE CONFIDENTIAL  
cee-map  
12  
cee-map  
Enters the CEE map configuration mode. If the CEE map does not exist, it creates the map.  
Synopsis  
cee-map name [precedence number]  
no cee-map name  
Operands  
name  
Specifies a unique name across all of the CEE maps defined within the  
system. If the specified CEE map does not exist, then it is created. If the  
specified CEE map already exists, then it is updated and the new mapping  
automatically propagates to all interfaces bound to the CEE map.  
precedence number  
Sets the precedence value for controlling the global scheduler policy when  
there is conflict between multiple CEE maps and non-CEE QoS configurations.  
The range of valid values is 1-100.  
Defaults  
The default CEE map precedence value is 1.  
Global configuration mode  
Command  
Modes  
Description  
Use this command create a CEE Map, and then enter the CEE-Map CLI configuration submode for  
defining the CEE Provisioning Priority Group Table and Priority-to-Priority Group Table.  
The CEE Map model allows different CEE Provisioning on different interfaces. There is only a single  
scheduler policy supported across the entire system. For the system to behave to your  
expectations, all CEE Map and any non-CEE configuration must specify identical scheduler policies,  
such as the number of Strict Priority queues and Deficit Weighted Round Robin (DWRR) weights. In  
deployment scenarios where different CEE Map or non-CEE configurations specify conflicting  
scheduler policies, then the precedence number parameter can be used to select the CEE Map  
controlling the setting of the global scheduler policy. The global scheduler policy is based on the  
CEE Map with the highest precedence value.  
Use the no cee-map name command to delete the specified CEE map. A CEE map can only be  
deleted if it is not bound to any interface.  
Usage  
All CEE maps take precedence over the non-CEE scheduler policy.  
Guidelines  
Examples  
To create a CEE map:  
switch(config)#cee-map test  
To delete a CEE map:  
switch(config)#no cee-map test  
If a CEE map is currently applied on an interface, you cannot delete that CEE map:  
switch(config)#no cee-map demo  
% Error: Map is still activated  
See Also  
cee, priority-group-table, priority-table  
190  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
priority-group-table  
12  
priority-group-table  
Configures the bandwidth for each Priority Group.  
Synopsis  
Operands  
priority-group-table pgid [weight weight] [pfc]  
no priority-group-table pgid  
pgid  
Specifies the Priority Group ID (PGID) assigned to a priority group. The range  
of valid values is 15.0-15.7 for the eight reserved Strict Priority PGIDs.  
weight weight  
Maps a weight to a Deficit Weighted Round Robin (DWRR) scheduler queue.  
This parameter is only valid for the DWRR Priority Group. The sum of all DWRR  
Priority Group weight values must equal 100 percent. The range of valid  
values is 1-100.  
pfc  
Enables the Priority-based Flow Control (PFC) for each priority that gets  
mapped to the Priority Group.  
Defaults  
There is no default value for the weight. The PFC is disabled.  
CEE map configuration mode  
Command  
Modes  
Description  
Use this command to configure the bandwidth for each Priority Group, to associate a weight to a  
DWRR scheduler queue, and to enable the PFC.  
You can define up to eight additional DWRR Priority Groups with the PGID values in the range of  
0-7. Strict Priority Groups take priority in order from the lowest PGID value to the highest PGID  
value, for example, a PGID of 15.0 is a higher priority than a PGID of 15.1 and PGID of 15.1 is  
higher priority than PGID 15.2.  
Use the no priority-group-table pgid command to return the Priority Group to the default values. For  
the Strict Priority Group, the PGID is still valid, but the PFC is disabled. For the DWRR Priority Group,  
the PGID is no longer valid and is deleted; the PGID can only be deleted when it is not bound to any  
Priority-to-Priority Group Table entry.  
Usage  
Guidelines  
A PGID value of 15 is a special value, which allows you to configure priorities with no bandwidth  
limit. The priority groups 15.0-5.7 are pre-defined in the switch.  
Examples  
To define the CEE map and configure the bandwidth with the Priority Group, use the values in  
TABLE 3  
Bandwidth allocation to user priority groups  
PGID  
PG%  
PFC  
Description  
0
1
50  
50  
Y
SAN  
LAN  
N
switch(config)#cee-map test  
switch(conf-ceemap)#priority-group-table 0 weight 50 pfc  
switch(conf-ceemap)#priority-group-table 1 weight 50  
See Also  
cee-map, priority-table, show qos  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
191  
 
   
DRAFT: BROCADE CONFIDENTIAL  
priority-table  
12  
priority-table  
Provisions the CEE Priority-to-Priority Group Table, this table maps each of the eight ingress CoS  
into a Priority Group.  
Synopsis  
Operands  
priority-table pgid0 pgid1 pgid2 pgid3 pgid4 pgid5 pgid6 pgid7  
no priority-table  
pgid0  
pgid1  
pgid2  
pgid3  
pgid4  
pgid5  
pgid6  
pgid7  
Sets the Priority Group ID for all packets with CoS 0.  
Sets the Priority Group ID for all packets with CoS 1.  
Sets the Priority Group ID for all packets with CoS 2.  
Sets the Priority Group ID for all packets with CoS 3.  
Sets the Priority Group ID for all packets with CoS 4.  
Sets the Priority Group ID for all packets with CoS 5.  
Sets the Priority Group ID for all packets with CoS 6.  
Sets the Priority Group ID for all packets with CoS 7.  
Defaults  
The default CEE Priority mapping table matches the IEEE 802.1Q recommendation for systems  
supporting eight traffic classes. The 802.1Q maps CoS 0 (best effort) to Strict Priority Traffic Class  
1 (PGID 15.6) and CoS 1 to below best effort Traffic Class 0 (PGID 15.7). All other CoS values go  
through unchanged, for example CoS 2 maps to Traffic Class 2 (PGID 15.5), up to CoS 7 and Traffic  
Class 7 (PGID 15.0).  
Command  
Modes  
CEE Map Configuration mode  
Description  
Use this command to provision the CEE Priority-to-Priority Group Table. This table maps each of the  
eight ingress CoS into a Priority Group. Use the no priority-table command to return the Priority  
mapping table to the default values.  
Usage  
Guidelines  
Only a single CoS can be mapped to a PFC-enabled priority queue. The CoS number must be  
identical to the priority queue number. If your configuration violates this restriction an error  
message displays and the Priority Group Table is set back to the default values.  
When the CEE map is applied, and the interface is connected to the CNA, only one strict priority  
PGID (PGID 15.0 to PGID 15.7) is allowed.  
Examples  
To define a CEE map of the incoming Priority-to-Priority Groups, use the values in Table 4.  
TABLE 4  
Mapping of incoming Priority-to-Priority Groups  
PGID  
Priority  
0
1
2
3
4
1
1
0
1
1
192  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
   
DRAFT: BROCADE CONFIDENTIAL  
priority-table  
12  
TABLE 4  
Mapping of incoming Priority-to-Priority Groups  
PGID  
Priority  
5
6
7
1
1
15.0  
switch(config)#ceemap test  
switch(conf-ceemap)#priority-table 1 1 0 1 1 1 1 15.0  
See Also  
cee, cee-map, priority-group-table  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
193  
 
DRAFT: BROCADE CONFIDENTIAL  
qos cos  
12  
qos cos  
Specifies the interface Class of Service (CoS) value.  
Synopsis  
qos cos value  
no qos cos  
Operands  
Defaults  
value  
Specifies the CoS value. The range of valid values is 0-7.  
The default CoS value is 0 (zero).  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to specify the interface Default CoS value. When Interface ingress QoS Trust is  
in the untrusted mode, then the Interface Default CoS value is applied to all ingress traffic for user  
priority mapping. When the interface ingress QoS Trust is in the CoS mode, then the Interface  
Default CoS value is applied to all non-priority tagged ingress traffic for user priority mapping. Use  
the no qos cos command to return the CoS value to the default.  
Usage  
Guidelines  
If the interface is QoS trusted, the CoS value of the interface is used to assign a CoS value to all  
untagged packets entering the interface.  
Examples  
To set the interface CoS value to 2:  
switch(conf-if-te-0/2)#qos cos 2  
To return the interface CoS value to the default:  
switch(conf-if-te-0/2)#no qos cos  
See Also  
show qos, qos map, qos trust  
194  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
qos cos-mutation  
12  
qos cos-mutation  
Applies a CoS-to-CoS (COS) mutation QoS map on an interface.  
Synopsis  
qos cos-mutation name  
no qos cos-mutation  
Operands  
Defaults  
name  
Specifies the name of the CoS mutation map.  
There is no explicit CoS-to-CoS mutation QoS map applied; by default the inbound CoS equals the  
outbound CoS.  
Command  
Modes  
Interface configuration mode  
Description  
Use this command to apply a CoS-to-CoS mutation QoS map on an interface.  
Usage  
Guidelines  
This command applies a CoS-to-CoS mutation map on an interface. The qos cos-mutation  
command is not available if the interface is in CEE Provisioning mode. Use the no qos cos-mutation  
command to remove the CoS-to-CoS mutation map.  
Examples  
See Also  
To activate the CoS-to-CoS mutation QoS map on the interface:  
switch(conf-if-te-0/1)#qos cos-mutation test  
To remove the CoS-to-CoS mutation QoS map on the interface:  
switch(conf-if-te-0/1)#no qos cos-mutation  
qos map cos-mutation, show qos maps  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
195  
 
 
DRAFT: BROCADE CONFIDENTIAL  
qos cos-traffic-class  
12  
qos cos-traffic-class  
Applies a CoS-to-Traffic Class QoS map on an interface.  
qos cos-traffic-class name  
Synopsis  
Operands  
no qos cos-traffic-class  
name  
Specifies the name of a previously created CoS-to-Traffic Class QoS map. Only  
one CoS-to-Traffic Class QoS map can exist at a time. An existing  
CoS-to-Traffic Class QoS map must be removed before a new one can be  
applied.  
Defaults  
There is no explicit CoS-to-Traffic Class QoS map applied; the implicit behavior is to match the IEEE  
802.1Q recommendations for systems supporting eight Traffic Classes.  
Command  
Modes  
Interface configuration mode  
Description  
Use this command to apply a CoS-to-Traffic Class QoS map to an interface. Use the no qos  
cos-traffic-class command to remove the CoS-to-Traffic Class mapping.  
Usage  
This command is not available when the interface is in the CEE Provisioning mode.  
Guidelines  
Examples  
See Also  
To apply a CoS-to-Traffic Class QoS map to an interface:  
switch(conf-if-te-0/1)#qos cos-traffic-class test  
qos map cos-traffic-class, qos trust, qos cos-mutation, show qos maps  
196  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
qos map cos-mutation  
12  
qos map cos-mutation  
Creates a QoS map for performing CoS-to-CoS mutation.  
Synopsis  
Operands  
qos map cos-mutation name cos0 cos1 cos2 cos3 cos4 cos5 cos6 cos7  
no qos map cos-mutation name  
name  
Specifies a unique name across all CoS-to-CoS mutation QoS maps defined  
within the system. If the named CoS-to-CoS mutation QoS map does not exist,  
then it is created. If the named CoS-to-CoS mutation QoS map already exists  
then, it is updated and new mapping is automatically propagated to all  
interfaces bound to the QoS map.  
cos0  
cos1  
cos2  
cos3  
cos4  
cos5  
cos6  
cos7  
Sets the outbound CoS value for all packets with inbound CoS 0.  
Sets the outbound CoS value for all packets with inbound CoS 1.  
Sets the outbound CoS value for all packets with inbound CoS 2  
Sets the outbound CoS value for all packets with inbound CoS 3.  
Sets the outbound CoS value for all packets with inbound CoS 4.  
Sets the outbound CoS value for all packets with inbound CoS 5.  
Sets the outbound CoS value for all packets with inbound CoS 6.  
Sets the outbound CoS value for all packets with inbound CoS 7.  
Defaults  
There are no CoS-to-CoS mutation QoS maps defined.  
Global configuration mode  
Command  
Modes  
Description  
Use this command to create a QoS map for performing CoS-to-CoS Mutation. A CoS-to-CoS  
mutation takes an inbound CoS value and maps it to an outbound CoS value. The inbound CoS  
value is the user priority after any interface ingress QoS trust and Interface default CoS policy have  
been applied. The outbound CoS value is used in selecting Traffic Class and egress packet  
marking. The default is no CoS-to-CoS Mutation QoS maps defined. Use the no qos map  
cos-mutation name command to delete the named CoS-to-CoS mutation QoS map. A QoS map can  
only be deleted if it is not bound to any interface.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To create a CoS-to-CoS mutation QoS map to swap CoS 4 and CoS 5 and apply it on an interface,  
for example inbound CoS 4 is mapped to outbound CoS 5 and inbound CoS 5 is mapped to  
outbound CoS 4; all other CoS values go through unchanged:  
switch(config)#qos map cos-mutation test 0 1 2 3 5 4 6 7  
switch(config)#interface tengigabitethernet 0/1  
switch(conf-if-te-0/1)#qos cos-mutation test  
To delete a CoS-to-CoS mutation QoS map:  
switch(config)#no qos map cos-mutation test  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
197  
 
 
DRAFT: BROCADE CONFIDENTIAL  
qos map cos-mutation  
12  
See Also  
qos cos-mutation, show qos maps  
198  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
DRAFT: BROCADE CONFIDENTIAL  
qos map cos-traffic-class  
12  
qos map cos-traffic-class  
Creates a QoS map for performing CoS-to-Traffic Class mapping.  
Synopsis  
qos map cos-traffic-class name tc0 tc1 tc2 tc3 tc4 tc5 tc6 tc7  
no qos map cos-traffic-class  
Operands.  
name  
Specifies the CoS-to-Traffic Class QoS map name. If the named CoS-to-Traffic  
Class QoS map does not exist, then it is created. If the named CoS-to-Traffic  
Class QoS map already exists, then it is updated and new mappings are  
automatically propagated to all interfaces bound to the QoS map.  
tc0  
tc1  
tc2  
tc3  
tc4  
tc5  
tc6  
tc7  
Sets the Traffic Class value for all packets with outbound CoS 0.  
Sets the Traffic Class value for all packets with outbound CoS 1.  
Sets the Traffic Class value for all packets with outbound CoS 2.  
Sets the Traffic Class value for all packets with outbound CoS 3.  
Sets the Traffic Class value for all packets with outbound CoS 4.  
Sets the Traffic Class value for all packets with outbound CoS 5.  
Sets the Traffic Class value for all packets with outbound CoS 6.  
Sets the Traffic Class value for all packets with outbound CoS 7.  
Defaults  
There are no CoS-to-Traffic Class QoS maps defined.  
Global configuration mode  
Command  
Modes  
Description  
Use this command to create a QoS map for performing CoS-to-Traffic Class mapping. A  
CoS-to-Traffic Class QoS map takes an outbound CoS value and maps it to a Traffic Class. The  
outbound CoS value is used as the packet user priority after applying the configured interface QoS  
trust, interface default CoS, and CoS-to-CoS mutation policies. Traffic Class is a reference to a  
scheduler queue and packet servicing policy. Use the no qos map cos-traffic-class name  
command to delete the CoS-to-Traffic Class QoS map specified by the name. The CoS-to-Traffic  
Class QoS map can only be deleted when it is not bound to any interface. All other CoS values go  
through unchanged. This mapping matches the default behavior recommended in IEEE 802.1Q for  
systems supporting eight Traffic Classes.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To create a CoS-to-Traffic Class QoS map to map CoS 0 to Traffic Class 1 and CoS 1 to Traffic Class  
0:  
switch(config)#qos map cos-traffic-class test 1 0 2 3 4 5 6 7  
To delete a CoS-to-Traffic Class QoS map:  
switch(config)#no qos map cos-traffic-class test  
See Also  
qos trust, qos map cos-mutation  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
199  
 
 
DRAFT: BROCADE CONFIDENTIAL  
qos map cos-traffic-class  
12  
mTC0_WEIGHTmTC1_WEIGHTmTC2_WEIGHT mTC3_WEIGHT mTC4_WEIGHT mTC5_WEIGHT  
mTC6_WEIGHT  
mTC7_WEIGHTmTC0_WEIGHTmTC1_WEIGHTmTC2_WEIGHTmTC3_WEIGHTmTC4_WEIGHTmTC5_  
WEIGHTmTC6_WEIGHTmTC7_WEIGHT  
200  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
DRAFT: BROCADE CONFIDENTIAL  
qos queue multicast scheduler  
12  
qos queue multicast scheduler  
Configures the multicast Traffic Class packet expansion scheduler policy. All multicast Traffic Class  
packet expansion queues are serviced Deficit Weighted Round Robin (DWRR).  
Synopsis  
Operands  
qos queue multicast scheduler dwrr weight0 weight1 weight2 weight3  
no qos queue multicast scheduler  
dwrr  
Configures the DWRR multicast Traffic Class packet expansion policy.  
weight0  
weight1  
weight2  
weight3  
Sets the DWRR weight for multicast Traffic Class 0 packet expansion in units  
of bandwidth percentage. The sum of all weight values must equal 100  
percent. The range of valid values is 0-100.  
Sets the DWRR weight for multicast Traffic Class 1 packet expansion in units  
of bandwidth percentage. The sum of all weight values must equal 100  
percent. The range of valid values is 0-100.  
Sets the DWRR weight for multicast Traffic Class 2 packet expansion in units  
of bandwidth percentage. The sum of all weight values must equal 100  
percent. The range of valid values is 0-100.  
Sets the DWRR weight for multicast Traffic Class 3 packet expansion in units  
of bandwidth percentage. The sum of all weight values must equal 100  
percent. The range of valid values is 0-100.  
.Defaults  
The default weight value is 25 percent bandwidth for each multicast Traffic Class.  
Global configuration mode  
Command  
Modes  
Description  
Use this command to configure the multicast Traffic Class packet expansion scheduler policy. All  
multicast Traffic Class packet expansion queues are serviced Deficit Weighted Round Robin  
(DWRR). This multicast Traffic Class packet expansion scheduler policy is applied uniformly across  
the entire system. Use the no qos queue multicast scheduler command to return the multicast  
Traffic Class packet expansion scheduler to the default value.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To set the multicast Traffic Class packet expansion scheduler for Traffic Class 0 getting 10 percent  
bandwidth, Traffic Class 1 getting 20 percent bandwidth, Traffic Class 2 getting 30 percent  
bandwidth, and Traffic Class 3 getting 40 percent bandwidth:  
switch(config)#qos queue multicast scheduler dwrr 10 20 30 40  
To return the system to the default multicast Traffic Class packet expansion scheduler policy:  
switch(config)#no qos queue multicast scheduler  
See Also  
qos rcv-queue multicast  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
201  
 
 
DRAFT: BROCADE CONFIDENTIAL  
qos queue scheduler  
12  
qos queue scheduler  
Configures the Traffic Class packet scheduler policy.  
Synopsis  
qos queue scheduler strict-priority strict-priority number dwrr weight0 weight1 weight2 weight3  
weight4 weight5 weight6 weight7  
no qos queue scheduler  
strict-priority  
Configures the Strict Priority Traffic Class policy. All Strict Priority Traffic  
Classes are serviced before any DWRR Traffic Classes.  
strict-priority number  
Sets the number of the Strict Priority Traffic Class. These are the strict priority  
number highest Traffic Class, for example if the strict-priority number is 3,  
then the Strict Priority Traffic Class are Traffic Classes 7, 6, and 5. The range  
of valid values is 0-8.  
dwrr  
Configures the DWRR Traffic Class policy. There are a variable number of  
DWRR weight values accepted that are dependent on the setting of strict  
priority number. The strict priority number plus the number of DWRR weight  
values must always sum to 8 Traffic Classes.  
Operands  
weight0  
Sets the DWRR weight for Traffic Class 0 in units of bandwidth percentage left  
over after servicing all of the Strict Priority Traffic Classes. The sum of all  
weight values must equal 100 percent. The weight0 value is only valid when  
the strict priority number is less than 8. The range of valid values is 0-100  
percent.  
weight1  
weight2  
weight3  
weight4  
Sets the DWRR weight for Traffic Class 1 in units of bandwidth percentage left  
over after servicing all of the Strict Priority Traffic Classes. The sum of all  
weight values must equal 100 percent. The weight0 value is only valid when  
the strict priority number is less than 7. The range of valid values is 0-100  
percent.  
Sets the DWRR weight for Traffic Class 2 in units of bandwidth percentage left  
over after servicing all of the Strict Priority Traffic Classes. The sum of all  
weight values must equal 100 percent. The weight0 value is only valid when  
the strict priority number is less than 6. The range of valid values is 0-100  
percent.  
Sets the DWRR weight for Traffic Class 3 in units of bandwidth percentage left  
over after servicing all of the Strict Priority Traffic Classes. The sum of all  
weight values must equal 100 percent. The weight 0 value is only valid when  
the strict priority number is less than 5. The range of valid values is 0-100  
percent.  
Sets the DWRR weight for Traffic Class 4 in units of bandwidth percentage left  
over after servicing all of the Strict Priority Traffic Classes. The sum of all  
weight values must equal 100 percent. The weight0 value is only valid when  
the strict priority number is less than 4. The range of valid values is 0-100  
percent.  
202  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
qos queue scheduler  
12  
weight5  
weight6  
weight7  
Sets the DWRR weight for Traffic Class 6 in units of bandwidth percentage left  
over after servicing all of the Strict Priority Traffic Classes. The sum of all  
weight values must equal 100 percent. The weight0 value is only valid when  
the strict priority number is less than 3. The range of valid values is 0-100  
percent.  
Sets the DWRR weight for Traffic Class 6 in units of bandwidth percentage left  
over after servicing all of the Strict Priority Traffic Classes. The sum of all  
weight values must equal 100 percent. The weight0 value is only valid when  
the strict priority number is less than 2. The range of valid values is 0-100  
percent.  
Sets the DWRR weight for Traffic Class 7 in units of bandwidth percentage left  
over after servicing all of the Strict Priority Traffic Classes. The sum of all  
weight values must equal 100 percent. The weight0 value is only valid when  
the strict priority number is less than 1. The range of valid values is 0-100  
percent.  
Defaults  
The default strict priority value is 8. There is no default value for each weight value.  
Global configuration mode  
Command  
Modes  
Description  
Use this command to configure the Traffic Class packet scheduler policy. Eight Traffic Classes are  
supported with a configurable number of them being Strict Priority and any remaining ones being  
serviced DWRR. This Traffic Class packet scheduler policy is applied uniformly across the entire  
system. Actual Traffic Class packet scheduling is performed independently by each switch. Use the  
no qos queue scheduler command to return the Traffic Class packet scheduler to the default value.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To set the Traffic Class packet scheduler for 4 Strict Priority Traffic Class and 4 DWRR Traffic Class  
with Traffic Class 0 getting 10 percent bandwidth, Traffic Class 1 getting 20 percent bandwidth,  
Traffic Class 2 getting 30 percent bandwidth, and Traffic Class 3 getting 40 percent bandwidth:  
switch(config)#qos queue scheduler strict-priority 4 dwrr 10 20 30 40  
To return the system to the default Traffic Class packet scheduler policy:  
switch(config)#no qos queue scheduler  
See Also  
qos rcv-queue multicast  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
203  
 
DRAFT: BROCADE CONFIDENTIAL  
qos rcv-queue multicast rate-limit  
12  
qos rcv-queue multicast rate-limit  
Configures a cap on the maximum rate for multicast packet expansion.  
Synopsis  
Operands  
qos rcv-queue multicast rate-limit rate [burst burst-size]  
no qos rcv-queue multicast rate-limit  
rate  
Specifies the maximum rate for multicast packet expansion in units of  
packets per second (pkt/s). This places a cap on the sum of the first level  
expansion, for example the ingress packets replicated for each egress switch  
plus the second level expansion, for example packets replicated for egress  
interfaces on the switch. The range of valid values is 5500-90000000 pkt/s.  
burst burst-size  
Configures a cap on the maximum burst size for multicast packet expansion,  
for example packet replication. The burst size represents the maximum  
number of multicast packet expansion that can be performed back-to-back  
as a single burst in units of packets (pkt). The range of valid values is  
50-65535 pkt.  
Defaults  
The default burst size is 4096 packets. The default rate value is 3000000pkt/s.  
Global configuration mode  
Command  
Modes  
Description  
Use this command to configures a cap on the maximum rate for multicast packet expansion, for  
example packet replication. This rate limit is applied uniformly across the entire system. This rate  
limit is enforced independently by each switch. Use the no qos rcv-queue multicast rate-limit  
command to return the multicast packet expansion rate limit to the default settings.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To lower the maximum multicast packet expansion rate to 10000pkt/s:  
switch(config)#qos rcv-queue multicast rate-limit 10000  
To return the system to the default multicast packet expansion rate limit values:  
switch(config)#no qos rcv-queue multicast rate-limit  
See Also  
qos rcv-queue multicast  
204  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
qos rcv-queue multicast threshold  
12  
qos rcv-queue multicast threshold  
Configures a cap on the maximum queue depth for multicast packet expansion queues.  
Synopsis  
Operands  
qos rcv-queue multicast threshold tdt0 tdt1 tdt2 tdt3  
no qos rcv-queue multicast threshold  
tdto  
tdt1  
tdt2  
tdt3  
Sets the Tail Drop Threshold for multicast Traffic Class 0 packet expansion  
queue in units of packets (pkt). The range of valid values is 0-2047 packets.  
Sets the Tail Drop Threshold for multicast Traffic Class 1 packet expansion  
queue in units of packets (pkt). The range of valid values is 0-2047 packets.  
Sets the Tail Drop Threshold for multicast Traffic Class 2 packet expansion  
queue in units of packets (pkt). The range of valid values is 0-2047 packets.  
Sets the Tail Drop Threshold for multicast Traffic Class 3 packet expansion  
queue in units of packets (pkt). The range of valid values is 0-2047 packets.  
.Defaults  
The default is 64 packets for each multicast Traffic Class.  
Global configuration mode  
Command  
Modes  
Description  
Use this command to configure a cap on the maximum queue depth for multicast packet expansion  
queues. The individual Tail Drop Threshold is specified for each of the four multicast traffic classes.  
These Tail Drop Thresholds are applied uniformly across the entire system. These queue depths are  
enforced independently by each switch. Use the no qos rcv-queue multicast threshold command to  
return the multicast expansion queques to the default value.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To increase multicast packet expansion Tail Drop Threshold to 1000pkt for each multicast Traffic  
Class:  
switch(config)#qos rcv-queue multicast threshold 1000 1000 1000 1000  
To return the system to the default multicast packet expansion Tail Drop Threshold value:  
switch(config)#no qos rcv-queue multicast threshold  
See Also  
qos rcv-queue multicast  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
205  
 
 
DRAFT: BROCADE CONFIDENTIAL  
qos trust cos  
12  
qos trust cos  
Specifies the interface QoS trust mode for incoming traffic.  
Synopsis  
qos trust cos  
no qos trust  
Operands  
Defaults  
none  
The QoS trust CoS mode set to the untrusted state.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to specify the interface ingress QoS trust mode, which controls user priority  
mapping of incoming traffic. The untrusted mode overrides all incoming priority markings with the  
Interface Default CoS. The CoS mode sets the user priority based on the incoming CoS value, if the  
incoming packet is not priority tagged, then fallback is to the Interface Default CoS value. Use the  
no qos trust command to return to the default.  
Usage  
Guidelines  
When a CEE map is applied on an interface, the qos trust command is not allowed. The CEE map  
always puts the interface in the CoS trust mode. This command is not applicable for port-channel  
interfaces.  
Examples  
To set the interface QoS to the trust mode:  
switch(conf-if-te-0/1)#qos trust cos  
To return the interface QoS to the default value or to the untrusted state:  
switch(conf-if-te-0/1)#no qos trust  
When a CEE map is applied, the switch does not allow the qos trust cos command and displays the  
following error:  
switch(conf-if-te-0/1)#cee demo  
switch(conf-if-te-0/1)#qos trust cos  
% Error: QoS is not in non-CEE Provisioning mode  
See Also  
qos cos, show qos  
206  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show cee maps  
12  
show cee maps  
Displays information on the defined CEE maps.  
Synopsis  
Operands  
Defaults  
show cee maps name  
name  
Restricts the output to report on only the named CEE map.  
The default behavior without the optional operand is to report on all defined CEE maps.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display information on a specified defined CEE map or on all of the defined  
CEE maps. For each CEE map, the configuration state is displayed with a list of all of the Layer 2  
interfaces bound to the CEE map.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To display information on all of the defined CEE maps:  
switch#show cee maps  
CEE Map test  
Precedence 1  
Priority Group Table  
0: Weight 50, PFC Enabled, TrafficClass 4, BW% 50  
1: Weight 50, PFC Disabled, TrafficClass 2, BW% 50  
15.0: PFC Disabled, TrafficClass 6  
15.1: PFC Disabled  
15.2: PFC Disabled  
15.3: PFC Disabled  
15.4: PFC Disabled  
15.5: PFC Disabled  
15.6: PFC Disabled  
15.7: PFC Disabled  
Priority Table  
CoS:  
---------------------------------------------  
PGID: 1 15.0  
FCoE CoS: 3  
0
1
2
3
4
5
6
7
1
1
0
0
1
1
Enabled on the following interfaces  
te0/4  
See Also  
cee, cee-map  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
207  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show qos flowcontrol interface  
12  
show qos flowcontrol interface  
Displays all of the configured flow control information for an interface.  
Synopsis  
Operands  
show qos flowcontrol interface {tengigabitethernet slot/port | linecard slot | portset chip | all}  
tengigabitethernet  
Reports QoS flow control statistics for a single 10 Gbps Ethernet interface.  
slot  
Specifies the 10 Gbps Ethernet linecard slot number within the chassis.  
Specifies the 10 Gbps Ethernet port number within the linecard.  
port  
linecard portset  
Reports the QoS flow control statistics for all 10 Gbps Ethernet interfaces  
within an ASIC.  
slot  
chip  
Specifies the ASIC linecard slot number within the chassis.  
Specifies the ASIC number within the linecard.  
all  
Reports QoS flow control statistics for all interfaces within the system.  
Command  
Modes  
EXEC mode  
Description  
Use this command to display all of the configured flow control information for a specific interface.  
Usage  
Guidelines  
Use this command to display the runtime state retrieved from the dataplane reflecting the  
operation of 802.3x pause or Priority Flow Control (PFC) on an interface. The administrative state  
for pause generation and reception or processing is presented for the interface (802.3x mode) or  
for each CoS (PFC mode). TX_Pause frame generation statistics are always presented for the  
interface. The RX_Pause BitTimes is presented for the interface (802.3x mode) or for each CoS  
(PFC mode). When PFC is deployed under the CEE Provisioning model, then the command reports  
whether the Data Center Bridging eXchange protocol (DCBX) has overridden the user configuration,  
for example when the DCBX detects a mis-configuration between CEE peers, it disables PFC  
operationally.  
Examples  
To display all of the configured flow control information for a 10 Gbps Ethernet interface:  
switch#show qos flowcontrol interface tengigabitethernet 0/1  
Interface TenGigabitEthernet 0/1  
Mode PFC  
DCBX enabled for PFC negotiation  
TX 0 frames  
TX  
TX  
RX  
RX Output Paused  
CoS Admin Oper Admin Oper 512 BitTimes  
---------------------------------------  
0
1
2
3
4
5
6
7
Off Off  
Off Off  
On Off  
Off Off  
Off Off  
Off Off  
Off Off  
Off Off  
Off Off  
Off Off  
On Off  
Off Off  
Off Off  
Off Off  
Off Off  
Off Off  
0
0
0
0
0
0
0
0
See Also  
show qos interface, show cee maps  
208  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show qos interface  
12  
show qos interface  
Displays a summary of all QoS configurations applied on an interface.  
Synopsis  
Operands  
show qos interface {tengigabitethernet slot/port | linecard slot portset chip | all}  
tengigabitethernet  
Reports QoS configuration for a single 10 Gbps Ethernet interface.  
slot  
Specifies the 10 Gbps Ethernet linecard slot number within the chassis.  
port  
Specifies the 10 Gbps Ethernet port number within the linecard.  
linecard portset  
Reports the QoS configuration for all 10 Gbps Ethernet interfaces within an  
ASIC.  
slot  
chip  
Specifies the ASIC linecard slot number within the chassis.  
Specifies the ASIC number within the linecard.  
all  
Reports QoS configurations for all interfaces within the system.  
Defaults  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display a summary of all QoS configuration applied on an interface, including  
QoS Provisioning mode, CEE map, Layer 2 priority, Traffic Class mapping, congestion control, and  
the scheduler policy.  
Usage  
If no interface is specified, QoS information about all interfaces is displayed.  
Guidelines  
Examples  
To display all of the configured QoS information for a 10 Gbps Ethernet interface:  
switch#show qos interface tengigabitethernet 0/1  
Interface TenGigabitEthernet 0/1  
Provisioning mode cee  
CEE Map demo  
Default CoS 0  
Interface trust cos  
CoS-to-CoS Mutation map 'default'  
In-CoS:  
0
1
2
3
4
5
6
7
-----------------------------------------------------  
Out-CoS/TrafficClass: 0/4 1/4 2/6 3/4 4/4 5/4 6/4 7/4  
Tail Drop Threshold 1081344 bytes  
Per-CoS Tail Drop Threshold (bytes)  
CoS:  
0
1
2
3
4
5
6
7
------------------------------------------------------------------  
Threshold: 129761 129761 129761 129761 129761 129761 129761 129761  
Flow control mode PFC  
CoS2 TX on, RX on  
Multicast Packet Expansion Rate Limit 3000000 pkt/s, max burst 4096 pkts  
Multicast Packet Expansion Tail Drop Threshold (packets)  
TrafficClass:  
----------------------------  
Threshold: 64 64 64 64  
0
1
2
3
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
209  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show qos interface  
12  
Traffic Class Scheduler configured for 0 Strict Priority queues  
TrafficClass:  
---------------------------------------------  
DWRRWeight: 0 60 0 40  
Multicast Packet Expansion Traffic Class Scheduler  
TrafficClass:  
----------------------------  
DWRRWeight: 25 25 25 25  
0
1
2
3
4
5
6
7
0
0
0
0
0
1
2
3
See Also  
cee-map, priority table  
210  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
DRAFT: BROCADE CONFIDENTIAL  
show qos maps  
12  
show qos maps  
Displays information on the defined QoS maps.  
Synopsis  
Operands  
show qos maps [{cos-mutation [name] | cos-traffic-class [name]} ]  
cos-mutation name  
Specifies to report on only the named CoS-to-CoS mutation QoS map.  
cos-traffic-class name  
Specifies to report on only the named CoS-to-Traffic Class QoS maps.  
Defaults  
The default behavior without any specified operands is to report on all defined QoS maps.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display information on the QoS defined maps. For each QoS map, the  
configuration state is displayed with a list of all interfaces bound to the QoS map.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To display information on the defined QoS maps:  
switch#show qos maps  
CoS-to-CoS Mutation map 'test'  
In-CoS: 0 1 2 3 4 5 6 7  
--------------------------------  
Out-CoS: 0 1 2 3 5 4 6 7  
Enabled on the following interfaces:  
Te 0/5  
CoS-to-Traffic Class map 'test'  
Out-CoS: 0 1 2 3 4 5 6 7  
-------------------------------------  
TrafficClass: 0 1 2 3 5 4 6 7  
Enabled on the following interfaces:  
Te 0/5  
See Also  
qos maps, show qos interface  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
211  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show qos queue interface  
12  
show qos queue interface  
Displays the runtime state retrieved from the interface reflecting the number of packets and bytes  
sent and received for each priority.  
Synopsis  
Operands  
show qos queue interface {tengigabitethernet slot/port | all}  
tengigabitethernet  
Specifies the 10 Gbps Ethernet interface.  
slot  
Specifies the 10 Gbps Ethernet interface linecard slot number.  
Specifies the 10 Gbps Ethernet interface port number within the linecard.  
Reports QoS statistics for all 10 Gbps interfaces within the system.  
port  
all  
EXEC mode  
Command  
Modes  
Description  
Use this command to display the runtime state retrieved from the interface reflecting the number of  
packets and bytes sent and received for each priority.  
Usage  
For a stand-alone switch, all ASICs are considered as slot number zero (0).  
Guidelines  
Examples  
To display the queueing information for a 10 Gbps Ethernet interface:  
switch#show qos queue interface tengigabitethernet 0/2  
Interface TenGigabitEthernet 0/2  
RX  
RX  
TX  
TX  
CoS  
Packets  
Bytes  
TC  
Packets  
Bytes  
-------------------------------  
-------------------------------  
0
1
2
3
4
5
6
7
680458  
87098624  
0
1
2
3
4
5
6
7
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
32318  
0
0
0
0
0
0
See Also  
qos maps, cee-map  
212  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show qos rcv-queue interface  
12  
show qos rcv-queue interface  
Displays a summary of all QoS configurations applied to a Layer 2 Interface.  
Synopsis  
Operands  
show qos rcv-queue interface {tengigabitethernet slot/port | all}  
tengigabitethernet  
Specifies the 10 Gbps Ethernet interface.  
slot  
Specifies the 10 Gbps Ethernet interface linecard slot number.  
port  
Specifies the 10 Gbps Ethernet interface port number within the linecard.  
all  
Reports QoS configurations for all 10 Gbps Ethernet interfaces within the  
system.  
Command  
Modes  
EXEC mode  
Description  
Use this command to display a summary of all QoS configurations applied to an Layer 2 Interface.  
This includes the QoS Provisioning mode, CEE Map, Layer 2 Priority, Traffic Class Mapping,  
Congestion Control, and the Scheduler policy.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To display the runtime ingress queue state information retrieved from the dataplane for a 10 Gbps  
Ethernet interface:  
switch#show qos rcv-queue interface tengigabitethernet 0/2  
Interface TenGigabitEthernet 0/2  
In-use 404019 bytes, Total buffer 1081344 bytes  
0 packets dropped  
In-use  
Bytes  
Max  
Bytes  
CoS  
-------------------------  
0
1
2
3
4
5
6
7
0
0
1081344  
1081344  
1081344  
1081344  
1081344  
1081344  
1081344  
1081344  
404019  
0
0
0
0
0
See Also  
show qos rcv-queue multicast  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
213  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show qos rcv-queue multicast  
12  
show qos rcv-queue multicast  
Displays the runtime state retrieved from the dataplane reflecting any multicast packet expansion  
packet drops resulting from a queue crossing the maximum queue depth.  
Synopsis  
Operands  
show qos rcv-queue multicast {tengigabitethernet slot/port | all}  
tengigabitethernet  
Specifies the 10 Gbps Ethernet interface.  
slot  
Specifies the 10 Gbps Ethernet interface linecard slot number.  
port  
Specifies the 10 Gbps Ethernet interface port number within the linecard.  
all  
Reports QoS multicast packet expansion receive queueing statistics for all  
ASICs within the system.  
Defaults  
There are no default configurations for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display the runtime state information retrieved from the interface reflecting  
any multicast packet expansion packet drops resulting from a queue crossing the maximum queue  
depth.  
Usage  
For a stand-alone switch, all ASICs are considered as slot number zero (0).  
Guidelines  
Examples  
To display the queueing information:  
switch#show qos rcv-queue multicast tengigabitethernet 0/2  
Dropped Counts  
Linecard/Portset  
TC 0  
TC 1  
TC 2  
TC 3  
-----------------------------------------------------------------------------  
0/0  
0
0
0
0
See Also  
show qos rcv-queue interface  
214  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
Chapter  
Port Authentication Commands  
13  
clear dot1x statistics  
Clears all dot1x statistics.  
Synopsis  
Operands  
Defaults  
clear dot1x statistics  
none  
There are no defaults for this command.  
Privileged access mode  
Command  
Modes  
Description  
Use this command to clear all accumulated port authentication statistics on all ports.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
See Also  
To clear dot1x statistics:  
switch#clear dot1x statistics  
clear dot1x statistics interface  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
215  
 
     
DRAFT: BROCADE CONFIDENTIAL  
clear dot1x statistics interface  
13  
clear dot1x statistics interface  
Clears the dot1x statistics for a port  
Synopsis  
Operands  
clear dot1x statistics interface [tengigabitethernet slot/port]  
tengigabitethernet  
Specifies a valid 10 Gbps Ethernet interface.  
slot  
Specifies a valid slot number.  
Specifies a valid port number.  
port  
Defaults  
There are no defaults for this command.  
Privileged access mode  
Command  
Modes  
Description  
Use this command to clear all of the dot1x statistics for a specific interface port.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
See Also  
To clear dot1x statistics on a port:  
switch#clear dot1x statistics interface tengigabitethernet 0/1  
clear dot1x statistics  
216  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
dot1x authentication  
13  
dot1x authentication  
Enables dot1x on a port.  
dot1x authentication  
Synopsis  
no dot1x authentication  
none  
Operands  
Defaults  
There are no defaults for this command.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to enable dot1x on a port. Use the no dot1x authentication command to disable  
dot1x on the port and remove the configuration from 802.1X management.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To enable dot1x on a port:  
switch(config)#interface tengigabitethernet 0/1  
switch(conf-if-te-0/1)#dot1x authentication  
See Also  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
217  
 
 
DRAFT: BROCADE CONFIDENTIAL  
dot1x enable  
13  
dot1x enable  
Enables 802.1X authentication globally.  
Synopsis  
dot1x enable  
no dot1x enable  
Operands  
Defaults  
none  
By default, authentication is disabled globally.  
Global configuration mode  
Command  
Modes  
Description  
Use this command to globally enable 802.1X authentication. Use the no dot1x enable command to  
disable 802.1X authentication globally.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
See Also  
To enable 802.1X authentication globally:  
switch(config)#dot1x enable  
none  
218  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
dot1x port-control  
13  
dot1x port-control  
Controls the authorization of a port state.  
Synopsis  
Operands  
dot1x port-control auto | force-authorized | force-unauthorized  
no dot1x port-control  
auto  
Enables authentication on port.  
forced-authorized  
force-unauthorized  
Forces a port to remain in an authorized state.  
Forces a port to remain in an unauthorized state.  
Defaults  
The default port state is auto.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to control the authorization of a port state. Use the no dot1x port-control  
command to return to the default setting.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To enable the port state to auto:  
switch(config)#interface tengigabitethernet 0/1  
switch(conf-if-te-0/1)#dot1x port-control auto  
See Also  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
219  
 
 
DRAFT: BROCADE CONFIDENTIAL  
dot1x quiet-period  
13  
dot1x quiet-period  
Sets the number of seconds that a switch remains quiet between a failed authentication and an  
attempt to retry authentication.  
Synopsis  
dot1x quiet-period interval seconds  
no dot1x quiet-period  
Operands  
Defaults  
interval seconds  
Specifies the time in seconds between attempts at authentication. The range  
of valid values is 1-65535.  
The default time is 60 seconds.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to set the time in seconds after which a switch attempts to perform  
authentication after a failed authentication. Use the no dot1x quiet-period command to return to  
the default setting. When a switch cannot authenticate a client, the switch remains idle for a  
quiet-period interval of time, then attempts the operation again.  
Usage  
Guidelines  
Changing the quiet-period interval time to a number lower than the default can result in a faster  
response time.  
Examples  
To change the interval time to 200 seconds:  
switch(config)#interface tengigabiethernet 0/1  
switch(conf-if-te-0/1)#dot1x quiet-period 200  
See Also  
none  
220  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
dot1x reauthenticate interface  
13  
dot1x reauthenticate interface  
Initiates reauthentication on a specified interface.  
dot1x reauthenticate interface name  
Synopsis  
Operands  
Defaults  
name  
Specifies the name of the interface.  
There are no defaults for this command.  
Privileged EXEC mode  
Command  
Modes  
Description  
Use this command to initiate the reauthentication on a specified interface.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
See Also  
To initiate reauthentication on interface tengigabitethernet 0/1:  
switch#dot1x reauthenticate interface tengigabitethernet 0/1  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
221  
 
 
DRAFT: BROCADE CONFIDENTIAL  
dot1x reauthentication  
13  
dot1x reauthentication  
Enables reauthentication on a port.  
dot1x reauthentication  
Synopsis  
Operands  
Defaults  
none  
There are no defaults for this command.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to enable reauthentication on a port.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To enable reauthentication on a port:  
switch(config)#interface tengigabitethernet 0/1  
switch(conf-if-te-0/1)#dot1x reauthentication  
See Also  
none  
222  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
dot1x reauthMax  
13  
dot1x reauthMax  
Sets the maximum number of times that a port attempts to reauthenticate.  
Synopsis  
dot1x reauthMax number  
no dot1x reauthMax  
Operands  
Defaults  
number  
Specifies the maximum number of reauthentication attempts before the port  
goes to the unauthorized state. The range of valid values is 1-10.  
The default number of times that a port attempts authentication is two.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to set the maximum number of times that a port attempts to reauthenticate  
before a port changes to the unauthorized state. Use the no dot1x reauthMax command to return  
to the default setting.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To set the maximum number of reauthentication attempts to 5:  
switch(config)#interface tengigabitethernet 0/1  
switch(conf-if-te-0/1)#dot1x reauthMax 5  
To set the reauthentication maximum to the default value:  
switch(config)#interface tengigabitethernet 0/1  
switch(conf-if-te-0/1)#no dot1x reauthMax  
See Also  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
223  
 
 
DRAFT: BROCADE CONFIDENTIAL  
dot1x timeout re-authperiod  
13  
dot1x timeout re-authperiod  
Sets the number of seconds between reauthorization attempts.  
Synopsis  
Operands  
dot1x timeout re-authperiod seconds  
seconds  
Specifies the seconds between reauthorization attempts. The range of valid  
values is 1-4294967295.  
Defaults  
The default time is 3600 seconds.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to set the number of seconds between reauthorization attempts.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To set 25 seconds as the amount of time between reauthorization attempts:  
switch(config)#interface tengigabitethernet 0/1  
switch(conf-if-te-0/1)#dot1x timeout re-authperiod 25  
See Also  
none  
224  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
dot1x timeout server-timeout  
13  
dot1x timeout server-timeout  
Sets the authentication sever response timeout.  
dot1x timeout server-timeout seconds  
Synopsis  
Operands  
seconds  
Specifies the number of seconds that a switch waits for the transmission of  
packets by the switch to the authentication server. The range of valid values  
is 1-65535.  
Defaults  
The default timeout is 30 seconds.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to set the authentication sever response timeout.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To set 40 seconds as the switch-to-authentication server transmission time:  
switch(config)#interface tengigabitethernet 0/1  
switch(config-if)#dot1x timeout server-timeout 40  
See Also  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
225  
 
 
DRAFT: BROCADE CONFIDENTIAL  
dot1x timeout supp-timeout  
13  
dot1x timeout supp-timeout  
Sets the time in seconds that a switch waits for a response to an Extensible Authentication Protocol  
(EAP) request frame from the client before resending the request.  
Synopsis  
Operands  
dot1x timeout supp-timeout seconds  
seconds  
Specifies the number of seconds that the switch waits for a response to the  
EAP frame. The range of valid values is 1-65535.  
Defaults  
The default timeout is 30 seconds.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to specify the EAP response timeout.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
See Also  
To set 45 seconds as the switch-to-client retransmission time for the EAP request frame:  
switch(conf-if-te-0/1)#dot1x timeout supp-timeout 40  
none  
226  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
dot1x timeout tx-period  
13  
dot1x timeout tx-period  
Sets the number of seconds that the switch waits for a response to an Extensible Authentication  
Protocol (EAP) request or identity frame from the client before retransmitting the request.  
Synopsis  
Operands  
dot1x timeout tx-period seconds  
seconds  
Specifies the time in seconds between successive request ID attempts. The  
range of valid values is 1-65535.  
Defaults  
The default timeout is 30 seconds.  
Interface configuration mode  
Command  
Modes  
Description  
Use this command to set the interval between successive attempts to request an ID (EAP ID Req).  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
See Also  
To set 34 as the number of seconds to wait for a response to an EAP-request or identity frame from  
the client before retransmitting the request:  
switch(config)#interface tengigabitethernet 0/1  
switch(config-if)#dot1x timeout tx-period 34  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
227  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show dot1x  
13  
show dot1x  
Displays the overall state of dot1x on the system.  
Synopsis  
Operands  
Defaults  
show dot1x  
none  
There are no defaults for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display the overall state of dot1x on the system.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To display the state of the system:  
switch#show dot1x  
802.1X Port-Based Authentication Enabled  
PAE Capability:  
Protocol Version:  
Auth Server:  
Authenticator Only  
2
RADIUS  
RADIUS Configuration  
--------------------  
Position:  
1
Server Address:  
Port:  
172.21.162.51  
1812  
Secret:  
Position:  
sharedsecret  
2
Server Address:  
Port:  
10.32.154.113  
1812  
Secret:  
sharedsecret  
See Also  
none  
228  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show dot1x all  
13  
show dot1x all  
Displays detailed information for all of the ports.  
Synopsis  
Operands  
Defaults  
show dot1x all  
none  
There are no defaults for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display detailed information for all of the ports.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To display detailed information for all of the ports:  
switch#show dot1x all  
802.1X Port-Based Authentication Enabled  
PAE Capability:  
Protocol Version:  
Auth Server:  
Authenticator Only  
2
RADIUS  
RADIUS Configuration  
--------------------  
Position:  
1
Server Address:  
Port:  
172.21.162.51  
1812  
Secret:  
sharedsecret  
Position:  
Server Address:  
Port:  
2
10.32.154.113  
1812  
Secret:  
sharedsecret  
802.1X info for interface te0/1  
-----------------------------------  
Port Control:  
Auto  
Port Auth Status:  
Protocol Version:  
ReAuthentication:  
Auth Fail Max Attempts:  
ReAuth Max:  
Unauthorized  
2
Disabled  
0
2
Tx Period:  
Quiet Period:  
Supplicant Timeout:  
Server Timeout:  
Re-Auth Interval:  
PAE State:  
30 seconds  
60 seconds  
30 seconds  
30 seconds  
3600 seconds  
Connected  
Invalid  
--  
BE State:  
Supplicant Name:  
Supplicant Address:  
Current Id:  
0000.0000.0000  
1
Id From Server:  
0
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
229  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show dot1x all  
13  
See Also  
none  
230  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
DRAFT: BROCADE CONFIDENTIAL  
show dot1x diagnostics interface  
13  
show dot1x diagnostics interface  
Displays all diagnostics information for the authenticator associated with a port.  
Synopsis  
Operands  
Defaults  
show dot1x diagnostics interface name  
name  
Specifies the name of the interface.  
There are no defaults for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display all diagnostics information for the authenticator associated with a  
port.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To display all diagnostics information for the authenticator associated with a port:  
switch#show dot1x diagnostics interface tengigabitethernet 0/1  
802.1X Diagnostics for interface te0/1  
authEnterConnecting: 0  
authEaplogoffWhileConnecting: 1  
authEnterAuthenticating: 0  
authSuccessWhileAuthenticating: 0  
authTimeoutWhileAuthenticating: 0  
authFailWhileAuthenticating: 0  
authEapstartWhileAuthenticating: 0  
authEaplogoggWhileAuthenticating: 0  
authReauthsWhileAuthenticated: 0  
authEapstartWhileAuthenticated: 0  
authEaplogoffWhileAuthenticated: 0  
BackendResponses: 0  
BackendAccessChallenges: 0  
BackendOtherrequestToSupplicant: 0  
BackendAuthSuccess: 0  
BackendAuthFails: 0  
See Also  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
231  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show dot1x interface  
13  
show dot1x interface  
Displays the state of a specified interface.  
show dot1x interface name  
name Specifies the name of the interface.  
Synopsis  
Operands  
Defaults  
There are no defaults for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display the state of a specified interface.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To display the state of 10 Gbps Ethernet interface 0/1:  
switch#show dot1x interface tengigabitethernet 0/1  
Dot1x Global Status:  
Enabled  
802.1X info for interface te0/1  
-----------------------------------  
Port Control:  
Auto  
Port Auth Status:  
Protocol Version:  
ReAuthentication:  
Auth Fail Max Attempts:  
ReAuth Max:  
Unauthorized  
2
Disabled  
0
2
Tx Period:  
Quiet Period:  
Supplicant Timeout:  
Server Timeout:  
Re-Auth Interval:  
PAE State:  
30 seconds  
60 seconds  
30 seconds  
30 seconds  
3600 seconds  
Connected  
Invalid  
--  
BE State:  
Supplicant Name:  
Supplicant Address:  
Current Id:  
0000.0000.0000  
1
Id From Server:  
0
See Also  
none  
232  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show dot1x session-info interface  
13  
show dot1x session-info interface  
Displays all statistical information of an established session.  
Synopsis  
Operands  
Defaults  
show dot1x session-info interface name  
name  
Specifies the name of the interface.  
There are no defaults for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display all statistical information of the established session for a specified  
interface.  
Usage  
There are no usage guidelines for this command.  
Guidelines  
Examples  
To display all statistical information of the established session:  
switch#show dot1x session-info interface tengigabitethernet 0/1  
802.1X Session info for te0/1  
-------------------------------  
User Name:  
testuser  
Session Time:  
Terminate Cause:  
3 mins 34 secs  
Not terminated yet  
See Also  
none  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
233  
 
 
DRAFT: BROCADE CONFIDENTIAL  
show dot1x statistics interface  
13  
show dot1x statistics interface  
Displays the statistics of a specified interface.  
show dot1x statistics interface name  
Synopsis  
Operands  
Defaults  
name  
Specifies the name of the interface for which to display information.  
There are no defaults for this command.  
EXEC mode  
Command  
Modes  
Description  
Use this command to display the statistics of a specified interface.  
There are no usage guidelines for this command.  
Usage  
Guidelines  
Examples  
To display the statistics for 10 Gbps Ethernet interface 0/1:  
switch#show dot1x statistics interface tengigabitethernet 0/1  
802.1X statistics for interface te0/1  
EAPOL Frames Rx: 0 - EAPOL Frames Tx: 0  
EAPOL Start Frames Rx: 0 - EAPOL Logoff Frames Rx: 0  
EAP Rsp/Id Frames Rx: 2 - EAP Response Frames Rx: 10  
EAP Req/Id Frames Tx: 35 - EAP Request Frames Tx: 0  
Invalid EAPOL Frames Rx: 0 - EAP Length Error Frames Rx: 0  
EAPOL Last Frame Version Rx: 0 - EAPOL Last Frame Src: 0000.0000.0000  
See Also  
none  
234  
Converged Enhanced Ethernet Command Reference  
53-1001762-01  
 
 

Black Box Computer Accessories ACU5051A User Manual
Black Box Network Card IC171C User Manual
Black Decker Vacuum Cleaner 90515256 User Manual
Blodgett Hot Beverage Maker KLS E 100 User Manual
Bodum Gas Grill 11450P User Manual
Bosch Power Tools Router PR10E User Manual
Brother Printer 5470DW User Manual
Brother Printer PT 1400 User Manual
Capcom Video Games 13388340088 User Manual
Chromalox Switch HVS 02 User Manual