Brocade Communications Systems A7533A - Brocade 4Gb SAN Switch Base User manual

Publication Number: 53-1000429-01-HP
Publication Date: 01/29/2007
Fabric OS
Documentation Addendum
Supporting Fabric OS v5.2.X

Copyright © 2007, Brocade Communications Systems, Incorporated.
ALL RIGHTS RESERVED.
Brocade, the Brocade B weave logo, Fabric OS, File Lifecycle Manager, MyView, Secure Fabric OS, SilkWorm, and
StorageX are registered trademarks and Tapestry is a trademark of Brocade Communications Systems, Inc., in the
United States and/or in other countries. All other brands, products, or service names are or may be trademarks or service
marks of, and are used to identify, products or services of their respective owners.
FICON, IBM BladeCenter are registered trademarks of IBM Corporation in the U.S. and other countries.
Notice: The information in this document is provided “AS IS,” without warranty of any kind, including, without
limitation, any implied warranty of merchantability, noninfringement or fitness for a particular purpose. Disclosure of
information in this material in no way grants a recipient any rights under Brocade's patents, copyrights, trade secrets or
other intellectual property rights. Brocade reserves the right to make changes to this document at any time, without
notice, and assumes no responsibility for its use.
The authors and Brocade Communications Systems, Inc. shall have no liability or responsibility to any person or entity
with respect to any loss, cost, liability, or damages arising from the information contained in this book or the computer
programs that accompany it.
Notice: The product described by this document may contain “open source” software covered by the GNU General
Public License or other open source license agreements. To find-out which open source software is included in Brocade
products, view the licensing terms applicable to the open source software, and obtain a copy of the programming source
code, please visit http://www.brocade.com/support/oscd.
Export of technical data contained in this document may require an export license from the United States Government.
Brocade Communications Systems, Incorporated
Document History
The following table lists all versions of the Fabric OS v5.2.X Documentation Addendum.
Corporate Headquarters
Brocade Communications Systems, Inc.
1745 Technology Drive
San Jose, CA 95110
Tel: [phone]
Fax: [phone]
E-mail: [email protected]
Asia-Pacific Headquarters
Brocade Communications Singapore Pte. Ltd.
9 Raffles Place
#59-02 Republic Plaza 1
Singapore 048619
Tel: [phone]
Fax: [phone]
Email: [email protected]
European and Latin American Headquarters
Brocade Communications Switzerland Sàrl
Centre Swissair
Tour A - 2ème étage
29, Route de l'Aéroport
Case Postale 105
CH-1215 Genève 15
Switzerland
Tel: [phone]
Fax: [phone]
Email: [email protected]
Document Title Publication
Number Summary of Changes Publication Date
Fabric OS v5.2.X
Documentation Addendum 53-1000429-01 First version January 2007

Fabric OS v5.2.X Documentation Addendum iii
Publication Number: 53-1000429-01-HP
Contents
About This Document
Chapter 1 Fabric OS Command Reference
New Commands in v5.2.1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
ag. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
licensePort. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6
portcfgnport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8
Commands Updated in v5.2.1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
agshow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-10
configure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12
fwConfigure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-23
fwShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-28
ipAddrSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-31
ipaddrshow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-33
portCfgShow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-35
portshow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-39
supportSave. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-47
switchBeacon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-52
switchshow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-53
Commands Deprecated. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-59
Updates for 5.2.0. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-59
Update the slTest command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-59
Chapter 2 Fabric OS Message Reference
Updates to the Introduction Chapter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
New Chapter, AG System Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
AG-1001 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

iv Fabric OS v5.2.X Documentation Addendum
Publication Number: 53-1000429-01-HP
AG-1002 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
AG-1003 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
AG-1004 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
AG-1005 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
AG-1006 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
AG-1007 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
AG-1008 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4
AG-1009 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
AG-1010 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
AG-1011 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
AG-1012 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
AG-1013 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
AG-1014 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6
Chapter 3 Fabric OS MIB Reference
Updates to the Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Using Access Gateway with Brocade MIBs. . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
Updates to the MIB-II (RFC1213-MIB). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
sysDescr 1.3.6.1.2.1.1.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
sysObjectID 1.3.6.1.2.1.1.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
Updates to the FibreAlliance MIB Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
connUnitType 1.3.6.1.3.94.1.6.1.3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
connUnitProduct 1.3.6.1.3.94.1.6.1.7. . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
connUnitDomainId 1.3.6.1.3.94.1.6.1.11 . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
connUnitPrincipal 1.3.6.1.3.94.1.6.1.13. . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
connUnitInfo 1.3.6.1.3.94.1.6.1.21. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
connUnitPortIndex 1.3.6.1.3.94.1.10.1.2 . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
connUnitPortType 1.3.6.1.3.94.1.10.1.3. . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
connUnitPortFCClassCap 1.3.6.1.3.94.1.10.1.4. . . . . . . . . . . . . . . . . . . . 3-6
connUnitPortFCClassOp 1.3.6.1.3.94.1.10.1.5 . . . . . . . . . . . . . . . . . . . . 3-7
connUnitPortFCId 1.3.6.1.3.94.1.10.1.11. . . . . . . . . . . . . . . . . . . . . . . . . 3-7
connUnitPortNodeWwn 1.3.6.1.3.94.1.10.1.22 . . . . . . . . . . . . . . . . . . . . 3-7

Fabric OS Administrator’s Guide v
Publication Number: 53-1000429-01-HP
connUnitLinkTable 1.3.6.1.3.94.1.12. . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-7
connUnitSnsTable 1.3.6.1.3.94.5.2.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8
Chapter 4 Web Tools Administrator’s Guide
Global Changes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
Updates for the Brocade 5000 Switch . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
Updates for SilkWorm 4012, 4016, 4018, 4020, and 4024 Switches. . . . 4-1
Add Using WebTools on a Brocade Access Gateway . . . . . . . . . . . . . . . . . . 4-2
Using Web Tools on a Brocade Access Gateway . . . . . . . . . . . . . . . . . . . 4-2
Replace the Activating Ports Section . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
Activating Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
Chapter 5 iSCSI Administrator’s Guide
Replace iSCSI Target Gateway Scalability Guidelines Table . . . . . . . . . . . . 5-1

vi Fabric OS v5.2.X Documentation Addendum
Publication Number: 53-1000429-01-HP

Fabric OS v5.2.X Documentation Addendum v
Publication Number: 53-1000429-01-HP
About This Document
This document is a procedural guide to help SAN administrators configure and manage a storage area
network (SAN) using the Brocade Fabric OS Command Line Interface (CLI).
How This Document Is Organized
The document contains updates to the following Fabric OS manuals:
•“Fabric OS Command Reference” on page 1-1
•“Fabric OS Message Reference” on page 2-1
•“Fabric OS MIB Reference” on page 3-1
•“Web Tools Administrator’s Guide” on page 4-1
•“iSCSI Administrator’s Guide” on page 5-1
Supported Hardware and Software
This document is specific to Fabric OS v5.2.1 running on the following Brocade SilkWorm
product models:
•Brocade 5000
•Brocade SilkWorm 200E switch
•Brocade SilkWorm 3250 switch
•Brocade SilkWorm 3850 switch
•Brocade SilkWorm 3900 switch
•Brocade SilkWorm 4012 embedded switch
•Brocade SilkWorm 4016 embedded switch
•Brocade SilkWorm 4018 embedded switch
•Brocade SilkWorm 4020 embedded switch
•Brocade SilkWorm 4024 embedded switch
•Brocade SilkWorm 4100 switch
•Brocade SilkWorm 4900 switch
•Brocade SilkWorm 7500 switch
•Brocade SilkWorm 24000 director
•Brocade SilkWorm 48000 director

vi Fabric OS v5.2.X Documentation Addendum
Publication Number: 53-1000429-01-HP
When procedures or parts of procedures documented here apply to some switches but not to others, this
guide identifies which switches are supported and which are not.
This document sometimes mentions other Fabric OS releases to highlight the changes in the latest
release or to point out interoperability issues with other SilkWorm models. It also specifies when
procedures or steps of procedures apply only to specific SilkWorm models.
Although many different software and hardware configurations are tested and supported by Brocade
Communications Systems, Inc. for this Brocade Fabric OS release, documenting all possible
configurations and scenarios is beyond the scope of this document.
Document Conventions
This section describes text formatting conventions and important notices formats.
Text Formatting
The narrative-text formatting conventions that are used in this document are as follows:
bold text Identifies command names
Identifies the names of user-manipulated GUI elements
Identifies keywords and operands
Identifies text to enter at the GUI or CLI
italic text Provides emphasis
Identifies variables
Identifies paths and Internet addresses
Identifies document titles
code text Identifies CLI output
Identifies 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 often all lowercase.
Otherwise, this manual specifically notes those cases in which a command is case sensitive. The
ficonCupSet and ficonCupShow commands are an exception to this convention.
Notes, Cautions, and Warnings
The following notices appear in this document.
Note
A note provides a tip, emphasizes important information, or provides a reference to related information.
Caution
A caution alerts you to potential damage to hardware, firmware, software, or data.
Warning
A warning alerts you to potential danger to personnel.

Fabric OS v5.2.X Documentation Addendum vii
Publication Number: 53-1000429-01-HP
Key Terms
For definitions specific to Brocade and Fibre Channel, see the Brocade Glossary.
For definitions of SAN-specific terms, visit the Storage Networking Industry Association online
dictionary at:
http://www.snia.org/education/dictionary.
Additional Information
This section lists additional Brocade and industry-specific documentation that you might find helpful.
Brocade Resources
The following related documentation is provided on the Brocade Documentation CD-ROM and on the
Brocade Web site, through Brocade Connect.
Fabric OS
•Fabric OS Administrator’s Guide
•Fabric OS Command Reference
•Fabric OS MIB Reference
•Fabric OS Message Reference
•Fabric OS iSCSI Gateway Service Administrator’s Guide
•Brocade Master Glossary
Optional Applications
•Fabric Watch Administrator’s Guide
•Fabric Manager Administrator’s Guide
•Secure Fabric OS Administrator’s Guide
•Web Tools Administrator’s Guide
•EZSwitchSetup Administrator’s Guide
Brocade 5000
•Brocade 5000 Hardware Reference Manual
•Brocade 5000 QuickStart Guide
SilkWorm 48000
•SilkWorm 48000 Hardware Reference Manual
Note
Go to http://www.brocade.com and click Brocade Connect to register at no cost for a user ID and
password.

viii Fabric OS v5.2.X Documentation Addendum
Publication Number: 53-1000429-01-HP
•SilkWorm 48000 QuickStart Guide
•FR4-18i Hardware Reference Manual
•FR4-18i QuickStart Guide
•FC4-16IP Hardware Reference Manual
•FC4-16IP QuickStart Guide
SilkWorm 24000
•SilkWorm 24000 Hardware Reference Manual
•SilkWorm 24000 QuickStart Guide
SilkWorm 24000/48000
•Port Blade and Filler Panel Replacement Procedure
•Control Processor Blade Replacement Procedure
•Blower Assembly Replacement Procedure
•Cable Management Tray and Guide Replacement Procedure
•Chassis Door Replacement Procedure
•WWN Bezel and Card Replacement Procedure
•Power Supply and Filler Panel Replacement Procedure
•14U Rack Mount Kit Installation Procedure
•Mid-Mount Rack Kit Installation Procedure
SilkWorm 7500
•SilkWorm 7500 Hardware Reference Manual
•SilkWorm 7500 QuickStart Guide
•SilkWorm 7500 Fan Assembly Replacement Procedure
•SilkWorm Mid Sized Power Supply Replacement Procedure
SilkWorm 4900
•SilkWorm 4900 Hardware Reference Manual
•SilkWorm 4900 QuickStart Guide
•SilkWorm 4900 Fan Assembly Replacement Procedure
•SilkWorm Mid Sized Power Supply Replacement Procedure
SilkWorm 4100
•SilkWorm 4100 Hardware Reference Manual
•SilkWorm 4100 QuickStart Guide
SilkWorm 3900
•SilkWorm 3900 Hardware Reference Manual (for v4.x software)
•SilkWorm 3900 QuickStart Guide (for v4.x software)
•SilkWorm 3900 Fan Assembly Replacement Procedure
•SilkWorm 3900 Motherboard Assembly Replacement Procedure