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

Fabric OS v5.2.X Documentation Addendum ix
Publication Number: 53-1000429-01-HP
•SilkWorm 3900 Power Supply Replacement Procedure
SilkWorm 3250/3850
•SilkWorm 3250/3850 Hardware Reference Manual (for v4.x software)
•SilkWorm 3250/3850 QuickStart Guide (for v4.x software)
SilkWorm 200E
•SilkWorm 200E Hardware Reference Manual (for v5.x software)
For practical discussions about SAN design, implementation, and maintenance, you can obtain Building
SANs with Brocade Fabric Switches through:
http://www.amazon.com
For information about how to use Fabric OS features in a SAN solution, refer to the Principles of SAN
Design (ISBN 0-7414-2824-5), available from the SAN Administrator’s Bookshelf. You can order the
book and view a sneak preview at:
http://www.brocade.com/products/sanadmin_bookshelf/index.jsp
For additional Brocade documentation, visit the Brocade SAN Info Center and click the Resource
Library location:
http://www.brocade.com
Release Notes are available on the Brocade Connect Web site and are also bundled with the Fabric OS
firmware.
Optional Brocade Features
Optional Brocade features include:
Advanced Performance Monitoring
Enables more effective end-to-end SAN performance analysis to enhance
performance tuning, increase productivity, optimize resource utilization, and
reduce costs.
Extended Fabrics Supports the reliable, high-speed connectivity of SilkWorm switches over dark
fiber or Dense Wave Division Multiplexing (DWDM) equipment at distances up
to 500 kilometers to enhance business continuance operations.
Fabric Watch Continuously monitors SAN fabrics for potential faults based on thresholds set
for a variety of SAN fabric elements and events—automatically alerting
administrators to potential problems before they become costly failures.
ISL Trunking Optimizes the performance and availability of SAN fabrics while simplifying
ISL management. Two 4 Gbit/sec SilkWorm switches can automatically group
up to eight ISLs into a single logical “trunk” with a total throughput of up to 32
Gbit/sec.
Advanced Zoning Automatically groups SAN fabric-connected devices into logical zones that
restrict access to “member” devices in the zone. Advanced Zoning uses hardware
enforcement at both the port and WWN level to provide more robust data
protection.

xFabric OS v5.2.X Documentation Addendum
Publication Number: 53-1000429-01-HP
Secure Fabric OS Provides a comprehensive security solutions to help protect mission-critical data.
Key features include centralized policy-based security management, encryption
of management data, and authentication to create a fabric-wide trusted
environment with control over all levels of fabric access and communication.
FICON CUP Enables IBM host-based management programs to manage FICON fabric
switches in-band by sending commands to the Fabric OS emulated control
device.
Other Industry Resources
For additional resource information, visit the Technical Committee T11 Web site. This Web site
provides interface standards for high-performance and mass storage applications for Fibre Channel,
storage management, as well as other applications:
http://www.t11.org
For information about the Fibre Channel industry, visit the Fibre Channel Industry Association Web
site:
http://www.fibrechannel.org

Fabric OS v5.2.X Documentation Addendum xi
Publication Number: 53-1000429-01-HP
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
•Technical Support contract number, if applicable
•Switch model
•Switch operating system version
•Error numbers and messages received
•supportSave command output
•Detailed description of the problem and specific questions
•Description of any troubleshooting steps already performed and 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.
:
The serial number label is located as follows:
•SilkWorm 3014—On the top of the chassis, under the insertion arm
•SilkWorm 3016 and 4012—On the bottom of the switch module
•SilkWorm 4018—On the top of the blade
•SilkWorm 200E, 3200, 3250 and 3850—On the bottom of the chassis
•SilkWorm 3800 and 3900— Nonport side of the chassis
•Brocade 5000, SilkWorm 4100, 4900, and 7500—On the switch ID pull-out tab located inside
the chassis on the port side on the left
•SilkWorm 4016—Top of the switch module
•SilkWorm 4024—Bottom of the switch module
•SilkWorm 12000, 24000, and 48000—Inside the chassis next to the power supply bays
•SilkWorm Multiprotocol Router Model AP7420—On the bottom of the chassis and on the back
of the chassis.
*FT00X0054E9*
FT00X0054E9

xii Fabric OS v5.2.X Documentation Addendum
Publication Number: 53-1000429-01-HP
3. World Wide Name (WWN)
•Brocade 5000, SilkWorm 200E, 3014, 3016, 3250, 3800, 3850, 3900, 4012, 4016, 4018, 4020,
4024, 4100, 4900, 7500 switches and SilkWorm 24000, and 48000 directors: Provide the
license ID. Use the licenseIdShow command to display the license ID.
•SilkWorm Multiprotocol Router Model AP7420: Provide the switch WWN. Use the
switchShow command to display the switch WWN.
•All other SilkWorm switches: Provide the switch WWN. Use the wwn command to display the
switch WWN.
Document Feedback
Because quality is our first concern at Brocade, 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:
[email protected]
Provide the title and version number and as much detail as possible about your issue, including the topic
heading and page number and your suggestions for improvement.

Fabric OS Documentation Addendum 1-1
Publication Number: 53-1000429-01-HP
Chapter
1
Fabric OS Command Reference
The following updates in this chapter are for the Fabric OS Command Reference,
part number: 53-1000240-01:
•“New Commands in v5.2.1” on page 1-2
•“Commands Updated in v5.2.1” on page 1-9
•“Commands Deprecated” on page 1-59
•“Updates for 5.2.0” on page 1-59

1-2 Fabric OS Documentation Addendum
Publication Number: 53-1000429-01-HP
New Commands in v5.2.1 Note: Enter commands in lowercase only; mixed case is for
1
New Commands in v5.2.1
Add the following commands that are new in Fabric OS v5.2.1 to the Fabric OS Command Reference as
indicated below:
•Add the “ag” command after ad on page 2-14.
•Add the “licensePort” after licenseIDRemove on page 2-334.
•Add “portcfgnport” after portcfgLPort on page 2-465.

Fabric OS Documentation Addendum 1-3
Publication Number: 53-1000429-01-HP
ag 1
ag
Enables and manages the Access Gateway mode to perform AG specific operations.
Synopsis ag --show
ag --modeshow
ag --modeenable
ag --modedisable
ag --mapshow [N_Port]
ag --mapset <N_Port> <F_Ports>
ag --mapadd <N_Port> <F_Ports>
ag --mapdel <N_Port> <F_Ports>
ag --failovershow [N_Port]
ag --failoverdisable <N_Port>
ag --failoverenable <N_Port>
ag --failbackshow [N_Port]
ag --failbackdisable <N_Port>
ag --failbackenable <N_Port>
Description Use this command to enable and disable Access Gateway mode, to display the current configuration and
state, to configure and display the F_Port to N_Port mapping, and to configure N_Port failover and
failback policies. AG only supports embedded switch platforms that use the Goldneye ASIC.
Operands This command has the following operands:
--show Displays the N_Ports and F_Ports that are currently online, whether
they have failover enabled, and displays their mapping.
--modeshow Displays current mode of the switch, either an Access Gateway
mode or a native Fibre channel switch (FOS) mode.
--modeenable Enables the Access Gateway mode for a switch.
--modedisable Disables the Access Gateway mode for a switch.
--mapshow [N_Port] Displays the F_Ports that are mapped to a given N_Port. Current
F_PortsarethelistsofF_Portsonlinethroughthe specified N_Port.
N_Port is optional and if used, it displays the F_Ports that are
mapped to the specified N_Port only.
--mapset <N_Port F_Ports> Maps F_Ports to a specific N_Port to the fabric. Any F_Port can be
mapped to only one N_Port. F_Ports are enabled only if the N_Port
is online and NPIV is enabled on the fabric port that is connected to
Access Gateway.
--mapadd <N_Port> <F_Ports> Adds F_Ports to existing N_Port. The traffic for the configured
F_Ports to be routed to the fabric through the specified N_Port
when the F_Port comes online. An F_Port can be mapped to only
one N_Port. Specify the N_Port number to which the F_Ports are to

1-4 Fabric OS Documentation Addendum
Publication Number: 53-1000429-01-HP
ag Note: Enter commands in lowercase only; mixed case is for readability
1
be mapped. This command overwrites the existing mapping for the
N_Port. Specify the list of F_Port numbers to add to the existing
specified F_Port to N_Port mapping. The F_Port numbers must be
separated my semicolons.
--mapdel <N_Port> <F_Ports> Removes the specified F_Ports from the N_Port mapping. Specify
the N_Port number to which the F_Ports are currently mapped.
Specify the list of F_Port numbers to remove from the specified
F_Portsto N_Port mapping.The F_Port numbers must be separated
by semicolons.
--failovershow [N_Port] Displays the failover policy for the N_Port. Use this command with
the N_Port parameter to see if the failover for this N_Port is
enabled or not. If an N_Port failure occurs when the failover policy
is enabled, all F_Ports mapped to the failed N_Port will failover to
another N_Port connected to the same fabric, and then those
F_Ports are re-enabled.
--failoverdisable <N_Port> Disables the failover policy for an N_Port.
--failoverenable <N_Port> Enables the failover policy for an N_Port. When the failover policy
is enabled for an N_Port and failure occurs on that port, all F_Ports
mapped to the failed N_Port will failover to another N_Port
connected to the same fabric, and then those F_Ports are re-
enabled.
--failbackshow [N_Port] Displays the failover policy for the N_Port (s).
--failbackdisable <N_Port> Disables the failback policy for an N_Port.
--failbackenable <N_Port> Enables the failback policy for an N_Port.
Examples To display Access Gateway information:
switch:admin> ag --show
Name : switch
NodeName : 10:00:00:05:1e:35:10:57
Number of Ports : 16
IP Address(es) : 10.115.74.54
Firmware Version : v5.2.1.v5.2.x_maint_061106_2
N_Ports : 3
F_Ports : 8
Attached N_Port information:
Port PortID PortWWN FO FB IP Addr F_Ports
---------------------------------------------------------------------
2 0x020600 20:06:00:05:1e:34:15:c6 1 1 10.115.74.200 0;1;
3 0x020500 20:05:00:05:1e:34:15:c6 1 1 10.115.74.200 5;6;
15 0x060700 20:07:00:05:le:34:15:c6 1 1 10.115.74.59 9;10;11;12;
---------------------------------------------------------------------
Attached F_Port information:
Port PortID Port WWN N_Port
0 0x429c02 10:00:00:00:c9:3f:7d:4a 2
1 0x429c01 21:00:00:e0:8b:a8:68:58 2
5 0x429B01 21:00:00:e0:8b:88:92:e8 3
6 0x429B02 21:00:00:e0:8b:88:68:58 3
---------------------------------------------
Note: ag --show always shows the current online information.

Fabric OS Documentation Addendum 1-5
Publication Number: 53-1000429-01-HP
ag 1
To display all the F_Ports that are mapped to a given N_Port:
See Also portcfgnport, portcfgnpivport
ST2:admin> ag --mapshow
N_Port Configured_F_Ports Current_F_Ports Failover Failback
---------------------------------------------------------------------
2 0;1; 0;1; 1 1
3 5;6; 5;6; 1 1
15 9;10;11;12; 9;10;11;12; 1 1
---------------------------------------------------------------------
ST2: admin> ag --mapshow 15
---------------------------------------------------------------------
N_Port2 : 15
Failover (1=enabled/0=disabled : 1
Failback (1=enabled/0=disabled) : 1
Current F_Ports : 9;10;11;12;
Configured F_Ports : 9;10;11;12;
---------------------------------------------------------------------

1-6 Fabric OS Documentation Addendum
Publication Number: 53-1000429-01-HP
licensePort Note: Enter commands in lowercase only; mixed case is for readability
1
licensePort
Manages the Dynamic Ports on Demand (POD) license assignment.
Synopsis licensePort --release portnum
licensePort --reserve portnum
licensePort --show
lcensePort --method selection
Description Use this command to manage the Dynamic Ports on Demand license assignments. In the Dynamic POD
method, the ports are assigned to a POD license in order to come online until they equal the number of
online licensed ports. This command provides the mechanism to make adjustments to the dynamic
assignments to adjust to specific site requirements. These options are used in the case where there are
more online ports than the purchased POD licenses can support.
Operands This command has the following operands:
--release portnumber Releases a license assignment from a port when the switch is using
the Dynamic Ports on Demand method. This option can only be
applied to a port that is offline.
--reserve portnumber Use this option to reserve a license assignment for a port when the
switch is using the Dynamic Ports on Demand method. This option
can only be applied to a port that is offline. The portnumber is the
number of the port to assign or remove from a POD license.
--show Use this option to display the Ports on Demand license
assignments.
--method selection Use this option to select the method for Ports on Demand. Use the
selection option to select the method as dynamic or static.
Examples
To release and reserve a port from a Dynamic POD license assignment:
To reserve a Dynamic POD license assignment for a port:
To change the POD license method to the Dynamic method:
sw5:admin> licensePort -release 5
sw5:admin> licensePort -reserve 5
sw5:admin> licensePort -method dynamic