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

53-1000605-01
19 Oct 2007
Access Gateway
Administrator’s Guide
Supporting Fabric OS v6.0.0

Copyright © 2006-2007 Brocade Communications Systems, Inc. All Rights Reserved.
Brocade, the Brocade B-weave logo, Fabric OS, File Lifecycle Manager, MyView, SilkWorm, and StorageX are registered
trademarks and the Brocade B-wing symbol, SAN Health, and Tapestry are trademarks of Brocade Communications Systems,
Inc., in the United States and/or in other countries. FICON is a registered trademark of IBM Corporation in the U.S. and 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.
Notice: This document is for informational purposes only and does not set forth any warranty, expressed or implied, concerning
any equipment, equipment feature, or service offered or to be offered by Brocade. Brocade reserves the right to make changes to
this document at any time, without notice, and assumes no responsibility for its use. This informational document describes
features that may not be currently available. Contact a Brocade sales office for information on feature and product availability.
Export of technical data contained in this document may require an export license from the United States government.
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.
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.
Brocade Communications Systems, Incorporated
Document History
The following table lists all versions of the Access Gateway Administrator’s Guide.
Corporate Headquarters
Brocade Communications Systems, Inc.
1745 Technology Drive
San Jose, CA 95110
Tel: [phone]
Fax: [phone]
E-mail: inf[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
Access Gateway Administrator’s Guide 53-1000430-01 First version January 2007
Access Gateway Administrator’s Guide 53-1000633-01 Added support for the 200E 15 Jun 2007
Access Gateway Administrator’s Guide 53-1000605-01 Added support for new policies
and changes to N_Port
mappings.
19 Oct 2007

Access Gateway Administrator’s Guide iii
53-1000605-01
Contents
About This Document
How this document is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Supported hardware and software . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
What’s new in this document. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Text formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Notes, cautions, and warnings . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Key terms. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Additional information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Brocade resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Other industry resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Optional Brocade features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Getting technical help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Document feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
Chapter 1 Introduction to the Brocade Access Gateway
In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Overview of Brocade Access Gateway . . . . . . . . . . . . . . . . . . . . . . . . . 1
Brocade features in Access Gateway mode . . . . . . . . . . . . . . . . . 2
Access Gateway port types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Comparing FC port configurations . . . . . . . . . . . . . . . . . . . . . . . . 3
Port mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Preferred Secondary N_Port mapping . . . . . . . . . . . . . . . . . . . . . 5
Failover and Failback policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Cold Failover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Port initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Access Gateway policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Path Failover policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Failback policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Port Grouping policy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Automatic port configuration (APC) . . . . . . . . . . . . . . . . . . . . . . 12
Chapter 2 Configuring Access Gateway
In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Verifying the fabric and edge switch settings . . . . . . . . . . . . . . . . . . 15

iv Access Gateway Administrator’s Guide
53-1000605-01
Enabling Access Gateway mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Using the CLI to enable Access Gateway mode . . . . . . . . . . . . . 16
Chapter 3 Disabling Access Gateway Mode
In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Before you begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Backing up the Switch Configuration . . . . . . . . . . . . . . . . . . . . . 21
Disabling Access Gateway mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Using the CLI to disable Access Gateway mode. . . . . . . . . . . . .22
Notes on joining the switch to a fabric . . . . . . . . . . . . . . . . . . . . . . . 22
Chapter 4 Managing Ports in Access Gateway mode
In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Determining the mapping and port status . . . . . . . . . . . . . . . . . . . .25
Displaying the port mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Displaying the port status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Configuring port maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Adding F_Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Removing F_Ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
Specifying Preferred Secondary N_Ports . . . . . . . . . . . . . . . . . .29
Configuring additional F_Ports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Unlocking N_Port mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Managing policies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Path Failover and Failback policies . . . . . . . . . . . . . . . . . . . . . .32
Port Group policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
Automatic Port Configuration (APC) . . . . . . . . . . . . . . . . . . . . . . 35
Appendix A Default Port Mapping
Appendix B Compatibility
Appendix C Troubleshooting
Appendix D Access Gateway Commands
Access Gateway commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Index

Access Gateway Administrator’s Guide v
53-1000605-01
About This Document
This document is a procedural guide to help SAN administrators configure and manage Brocade
Access Gateway.
This preface contains the following sections:
•How this document is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
•Supported hardware and software. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
•What’s new in this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
•Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
•Key terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
•Additional information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
•Getting technical help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
•Document feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
How this document is organized
The document contains the following topics:
•Chapter 1, “Introduction to the Brocade Access Gateway” describes the Access Gateway
operation.
•Chapter 2, “Configuring Access Gateway” provides the initial setup procedures and fabric
requirement to deploy an Access Gateway solution.
•Chapter 3, “Disabling Access Gateway Mode” provides instructions on disabling Access
Gateway mode so that the switch can be used as a fabric switch.
•Chapter 4, “Managing Ports in Access Gateway mode” provides instructions on changing
N_Ports to F_Ports, mapping F_Ports to N_Ports, and changing various Access Gateway
policies.
•Appendix A, “Default Port Mapping” provides the default N_Port mappings for the different
switches while in Access Gateway mode.
•Appendix B, “Compatibility” provides compatibility information between different devices while
running a switch in Access Gateway mode.
•Appendix C, “Troubleshooting” provides symptoms and troubleshooting tips to resolve issues.
•Appendix D, “Access Gateway Commands” provides the commands for Access Gateway.
The appendixes provide the default mappings, compatibility guidelines, and troubleshooting
assistance.

vi Access Gateway Administrator’s Guide
53-1000605-01
Supported hardware and software
In those instances in which procedures or parts of procedures documented here apply to some
switches but not to others, this guide identifies exactly which switches are supported and which are
not.
Although many different software and hardware configurations are tested and supported by
Brocade Communications Systems, Inc. for 6.0.0, documenting all possible configurations and
scenarios is beyond the scope of this document.
The following hardware platforms are supported by this release of Fabric OS v6.0.0 Access
Gateway Administrator’s Guide:
•Brocade 200E switch
•Brocade 4012 switch
•Brocade 4016 switch
•Brocade 4018 switch
•Brocade 4020 switch
•Brocade 4024 switch
What’s new in this document
The following changes have been made since this document was last released:
•Information that was added:
•Support for the 4018 embedded switch
•N_Port grouping policy
•Automatic Port Configuration (APC)
•Preferred Secondary N_Port mapping is an optional secondary failover path for an N_Port
•Information that was changed:
•Path Failback and Failover policies have been enabled to incorporate:
Preferred Secondary N_Port
N_Port grouping
Automatic Port Configuration (APC)
•Enhancements to the Command Line Interface (CLI)
•Information that was deleted:
•none
For further information, refer to the release notes.
Document conventions
This section describes text formatting conventions and important notices formats.

Access Gateway Administrator’s Guide vii
53-1000605-01
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.
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.
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 of SAN-specific terms, visit the Storage Networking Industry Association online
dictionary at: http://www.snia.org/education/dictionary.

viii Access Gateway Administrator’s Guide
53-1000605-01
For definitions specific to Brocade and Fibre Channel, see the Brocade Glossary.
The following terms are used in this manual to describe Access Gateway mode and its
components.
Access Gateway (AG) Fabric OS mode for embedded switches that reduces SAN (storage area
network) deployment complexity by leveraging NPIV (N_Port ID virtualization).
E_Port An ISL (Interswitch link) port. A switch port that connects switches together to
form a fabric.
Edge switch A fabric switch that connects host, storage, or other devices, such as Brocade
Access Gateway, to the fabric.
F_Port A fabric port. A switch port that connects a host, HBA (host bus adaptor), or
storage device to the SAN. On Brocade Access Gateway, the F_Port connects
to a host only.
Mapping On the Brocade Access Gateway, the configuration of F_Port to N_Port routes.
N_Port A node port. A Fibre Channel host or storage port in a fabric or point-to-point
connection. On Brocade Access Gateway, the N_Port connects to the edge
switch.
NPIV N_Port ID virtualization. Allows a single Fibre Channel port to appear as
multiple, distinct ports providing separate port identification and security
zoning within the fabric for each operating system image as if each operating
system image had its own unique physical port.
Preferred Secondary N_Port
On the Brocade Access Gateway, the preferred secondary N_Port refers to
the secondary path that and F_Port failovers to if the primary N_Port goes
offline.
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, join Brocade Connect. It’s free! Go to
http://www.brocade.com and click Brocade Connect to register at no cost for a user ID and
password.
For practical discussions about SAN design, implementation, and maintenance, you can obtain
Building SANs with Brocade Fabric Switches through:
http://www.amazon.com
For additional Brocade documentation, visit the Brocade SAN Info Center and click the Resource
Library location:
http://www.brocade.com

Access Gateway Administrator’s Guide ix
53-1000605-01
Release notes are available on the Brocade Connect Web site and are also bundled with the Fabric
OS firmware.
Other industry resources
•White papers, online demos, and data sheets are available through the Brocade Web site at
http://www.brocade.com/products/software.jhtml.
•Best practice guides, white papers, data sheets, and other documentation is available through
the Brocade Partner Web site.
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, and 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
Optional Brocade features
For a list of optional Brocade features and descriptions, see the Fabric OS Administrator’s Guide.
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, 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 shown here.

xAccess Gateway Administrator’s Guide
53-1000605-01
:
The serial number label is located as follows:
•Brocade 200E—On the nonport side of the chassis
•Brocade 4100, 4900, and 7500—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
3. World Wide Name (WWN)
•Use the wwn command to display the switch WWN.
•If you cannot use the wwn command because the switch is inoperable, you can get the
WWN from the same place as the serial number.
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:
[e-mail]
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.
*FT00X0054E9*
FT00X0054E9