53-1000633-01 15 Jun 2007 Access Gateway Administrator’s Guide Supporting Fabric OS v5.3.
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.
Contents About This Document Supported hardware and software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v How this document is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v What’s new in this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi Text formatting . . . . . . . . . . .
Chapter 3 Disabling Access Gateway Mode In this chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Before you begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Backing up the Switch Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Disabling Access Gateway mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
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. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v • What’s new in this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
• 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 failover and failback policies. • 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 failover and failback policies. • Appendix A, “Default Port Mapping” provides the default N_Port mappings for the different switches while in Access Gateway mode.
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.
mapping On Brocade Access Gateway, the configuration of F_Port to N_Port routes. Additional information This section lists additional Brocade and industry-specific documentation that you might find helpful. BROCADE RESOURCES The most recent version of documentation is provided on the Brocade Web site, through Brocade Connect. NOTE Go to http://www.brocade.com and CLIck Brocade Connect to register at no cost for a user ID and password.
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.
- Brocade 4018—On the top of the blade - Brocade 4016—Top of the switch module - SilkWorm Multiprotocol Router Model AP7420—On the bottom of the chassis and on the back of the chassis.
Chapter 1 Introduction to the Brocade Access Gateway This chapter describes the functions of Brocade Access Gateway. The Brocade 200E switch and the Brocade 4012, 4016, 4020, and 4024 embedded switches running Fabric OS 5.3.0 or higher support Access Gateway (AG). In this chapter • Overview of Brocade Access Gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • Access Gateway port types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • Port mapping . . .
1 Overview of Brocade Access Gateway Figure 1 compares a configuration that connects eight hosts to the fabric using Brocade Access Gateway to the same configuration with standard fabric switches.
Access Gateway port types 1 Access Gateway port types Brocade Access Gateway differs from a typical fabric switch because it connects to the fabric using node ports (N_Ports). Typically fabric switches connect to the enterprise fabric using ISL (InterSwitch Link) ports, such as an E_Port. The following defines the Fibre Channel (FC) port terms used in this manual: - F_Port, fabric port. A switch port that connects a host, HBA, or storage device to the SAN. N_Port, node port.
1 Port mapping Table 1 Compares port configuration between Access Gateway with a typical fabric switch. TABLE 1 Port Configurations Port Type Access Gateway Fabric switch F_Port Yes Connects hosts to Brocade Access Gateway. Yes Connects devices, such as hosts, HBAs, and storage to the fabric. N_Port Yes Connects Access Gateway to a fabric switch. NA N_Ports are not supported. E_Port NA ISL is not supported.1 Yes Connects the switch to other switches to form a fabric. 1.
Port initialization 1 Table 2 describes the mapping and fabric connection shown in Figure 3. TABLE 2 Example port mapping Access Gateway Fabric N_Port F_Port Edge switch F_Port N_1 F_1, F_2 Switch_A F_A1 N_2 F_3, F_4 Switch_A F_A2 N_3 F_5, F_6 Switch_B F_B1 N_4 F_7, F_8 Switch_B F_B2 Port initialization To ensure that all hosts are brought online when Brocade Access Gateway starts up, the ports are initialized in the following manner: 1. All N_Ports are initialized.
1 Failover policy After ports are initialized, Access Gateway becomes logically transparent to the host and the fabric, as shown in Figure 4. a b c d e FIGURE 4 Host log in request Failover policy The Brocade Access Gateway N_Port failover policy allows hosts to automatically remap to an online N_Port if the N_Port they are connected to goes offline. The failover policy evenly distributes the F_Ports that are mapped to an offline N_Port among all the online N_Ports.
1 Failback policy Example: Failover Policy This example shows the failover behavior in a scenario where two fabric ports go offline, one after the other. • First the edge switch F_A1 port goes offline, as shown in Figure 5 on page 7 Example 1 (left), causing the corresponding Access Gateway N_1 port to be disabled. The ports mapped to N_1 fail over; F_1 fails over to N_2 and F_2 fails over to N_3.
1 Failback policy Only the originally mapped F_Ports fail back. In the case of multiple N_Port failures, only F_Ports that were mapped to the recovered N_Port experience failback. The remaining F_Ports are not redistributed among the online N_Ports during the failback. NOTE The failback policy is an N_Port parameter. The failback policy is enabled by default. The following sequence describes how a failback event occurs: 1.
Chapter Configuring Access Gateway 2 This chapter describes the initial set up required to deploy Brocade Access Gateway. NOTE Refer to the Web Tools Administrator’s Guide to enable Access Gateway using Web Tools. In this chapter • Verifying the fabric and edge switch settings . . . . . . . . . . . . . . . . . . . . . . . . . 9 • Enabling Access Gateway mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2 Enabling Access Gateway mode Enabling Access Gateway mode This sections explains how to change the switch mode from Fabric OS native mode to Access Gateway mode using the command line interface. Converting a switch to a Brocade Access Gateway allows you to use the switch as a device management tool that transparently connects hosts to the fabric. NOTE On the 200E, you must enable all ports using POD licensing before enabling Access Gateway mode.
Enabling Access Gateway mode switchState: switchMode: switchRole: switchDomain: switchId: switchWwn: zoning: switchBeacon: 2 Online Native Principal 1 fffc01 10:00:00:05:1e:03:4b:e7 OFF OFF Area Port Media Speed State Proto ===================================== 0 0 -N4 No_Module 1 1 cu N4 Online 2 2 cu N4 Online 3 3 cu AN No_Sync 4 4 cu AN No_Sync 5 5 cu N4 Online 6 6 cu N4 Online 7 7 cu AN No_Sync 8 8 cu AN No_Sync 9 9 cu AN No_Sync 10 10 cu AN No_Sync 11 11 cu AN No_Sync 12 12 cu AN No_Sync 13 13 cu A
2 Enabling Access Gateway mode 7. Enter the ag --mapshow command without any options to display all the mapped ports. The following example shows a mapping that has been reconfigured, three N_Ports 17, 19 and 20 have no mappings and are not connected to the fabric.
Chapter Disabling Access Gateway Mode 3 This chapter describes how to disable Access Gateway mode. Disabling Access Gateway mode is disruptive; the switch is disabled and rebooted. In this chapter • Before you begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 • Disabling Access Gateway mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3 Notes on joining the switch to a fabric USING THE CLI TO DISABLE ACCESS GATEWAY MODE After you disable Access Gateway mode, use the instructions in the Fabric OS Administrator’s Guide to reconfigure the switch and join it to the fabric. NOTE Disabling Access Gateway mode clears the current Access Gateway mode configuration and reboots the switch. To disable Access Gateway mode 1. Connect and log in to the switch. 2. Enter the ag --modeshow command to verify that the switch is in Access Gateway mode.
Notes on joining the switch to a fabric 3 To use a previous configuration 1. Enter the switchDisable command to disable the switch. 2. Enter the configDownload command to revert to the previous configuration. 3. Enter the switchEnable command to bring the switch back online. The switch automatically joins the fabric. To allow the switch to merge with the fabric NOTE Only connect the switch to the fabrics which you want it to join. 1. Enter the switchDisable command to disable the switch. 2.
3 16 Notes on joining the switch to a fabric Access Gateway Administrator’s Guide 53-1000633-01
Chapter 4 Managing Ports in Access Gateway mode This chapter explains how to use the CLI to manage the ports on Brocade Access Gateway. NOTE Refer to the Web Tools Admin Guide for information on setting up Access Gateway using Web Tools. In this chapter • Determining the mapping and port status . . . . . . . . . . . . . . . . . . . . . . . . . . • Configuring port maps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . • Managing the failover and failback policies . .
4 Determining the mapping and port status switch:admin> ag --mapshow N_Port Configured_F_Ports Current_F_Ports Failover Failback ------------------------------------------------------------------------0 9;10 None 1 1 17 None None 1 1 18 3;4 None 1 1 19 None None 1 1 20 None None 1 1 21 1;2;11;12 1;2 1 1 22 5;13;14 5;9 1 1 23 6;15;16 6;10 1 1 ------------------------------------------------------------------------- To display an N_Port map 1. Connect and log in to the switch. 2.
4 Configuring port maps 2. Enter the switchShow command without any options to display the status of all ports. switch:admin> switchshow switchName: switch switchType: 43.
4 Configuring port maps An F_Port can be assigned to only one N_Port at a time. If the F_Port has been assigned to another N_Port, you must remove it from the N_Port before you can add it in this procedure. To add F_Ports to an N_Port 1. Connect and log in to the switch. Enter the ag command with the --mapdel “” operand to remove the F_Port from the N_Port. Where the f_portlist can contain multiple F_Port numbers separated by semicolons, for example “17;18”.
Managing the failover and failback policies 4 4. Enter the ag --mapshow command with the n_portnumber operand to display a list of mapped F_Ports. Verify that the F_Ports you added appear in the list. switch:admin> ag --mapshow 13 N_Port Failover(1=enabled/0=disabled) Failback(1=enabled/0=disabled) Current F_Ports Configured F_Ports : : : : : 13 1 1 None 6;7 REMOVING F_PORTS Removing an F_Port from an N_Port unassigns the F_Port. The F_Port status changes to Disabled (No mapping for F-Port).
4 Managing the failover and failback policies ENABLING THE FAILOVER POLICY A switch in Access Gateway mode supports automatic N_Port failover to other N_Ports connected to the same fabric. When a port is first configured as an N_Port, the failover policy is enabled by default. If the N_Port goes offline, the F_Ports mapped to that N_Port are automatically failed over to other online N_Ports connected to the same fabric.
Configuring additional F_Ports 4 switch:admin> ag --failbackenable 13 Failback policy is enabled for port 13 To disable failback 1. Connect and log in to the switch. 2. Enter the ag --failbackshow command with the n_portnumber operand to display the failover setting. switch:admin> ag --failbackshow 13 Failback on N_Port 13 is supported 3. Enter the ag --failbackdisable command with the n_portnumber operand to disable failover.
4 Configuring additional F_Ports Figure 7 shows a diagram of a host connected to an embedded switch’s external F_Port when Brocade Access Gateway is enabled. Note that the newly configured F_Port was mapped to an N_Port. FIGURE 7 Example of adding an external F_Port (F9) on an embedded switch UNLOCKING N_PORT MODE By default on embedded switches, all external ports are locked in N_Port mode when Access Gateway is enabled.
Configuring additional F_Ports 4 3. Enter the portCfgNport command with 0 operand to unlock N_Port mode. switch:admin> portcfgnport 10 0 Alternatively, to lock a port in N_Port mode, enter the portCfgNport 1 command. switch:admin> portcfgnport 10 1 4. Enter the portCfgNport command to display the N_Port lock settings and verify that the port is no longer locked in N_Port mode.
4 26 Configuring additional F_Ports Access Gateway Administrator’s Guide 53-1000633-01
Appendix A Default Port Mapping The following table shows the default F_Port to N_Port maps that are automatically configured when Access Gateway mode is enabled. All N_Ports have failover and failback enabled.
A 28 Default Port Mapping Access Gateway Administrator’s Guide 53-1000633-01
Appendix B Compatibility In Access Gateway mode, the switch can connect to a fabric that supports NPIV. Fabric OS supports NPIV in v5.0.1 and later. This section describes the supported Access Gateway configurations. Access Gateway Mode Switches The following switches support Access Gateway mode: • • • • • Brocade 200E Brocade 4012 Brocade 4016 Brocade 4020 Brocade 4024 NOTE Connecting Access Gateway devices one to another, daisy chaining, is not supported.
B Compatibility Interoperability with McDATA and Cisco The following instructions will allow you to connect your McDATA and Cisco edge fabrics to the Access Gateway enabled switch by enabling NPIV functionality. How to configure McDATA switch 1. Login as admin on the McDATA switch. 2. Enable MS services on the McDATA switch by typing in the following command: config OpenSysMs setState 3. Enable NPIV functionality on the edge fabric ports so that multiple logins are allowed for each port.
Appendix C Troubleshooting This appendix provides trouble shooting instructions. TABLE 5 Troubleshooting Problem Cause Solution Switch is not in Access Gateway mode Switch is in Native switch mode Disable switch using the switchDisable command. Enable Access Gateway mode using the ag --modeenable command. Answer yes when prompted; the switch reboots. Log in to the switch. Display the switch settings using the switchShow command. Verify that the field switchMode displays Access Gateway Mode.
C TABLE 5 Troubleshooting Troubleshooting (Continued) Problem Cause Solution Failover is not working Failover disabled on N_Port. Verify that failover and failback policies are enabled, as follows: Enter the ag --failoverShow command with the operand. Enter the ag --failbackShow command with the operand. Command returns “Failback (or Failover) on N_port is supported.” If it returns, “Failback (or Failover) on N_Port is not supported.
Appendix Access Gateway Commands D This appendix contains the commands for Access Gateway mode in the Fabric OS 5.3.0 release. System messages can be found in the Fabric OS Message Reference.This appendix uses the same conventions as the Fabric OS Command References. Access Gateway commands ag Enables and manages Access Gateway mode to perform AG specific operations.
D ag Displays the F_Ports that are mapped to a given N_Port. N_Port is optional and if used, it displays the F_Ports that are mapped to the specified N_Port only. --mapset “” 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 “” Adds F_Ports to existing N_Port.
D 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.
D 36 Access Gateway Administrator’s Guide 53-1000633-01
Index A Access Gateway mode commands, 33 comparison, 2 configuration, 9 disable, 13, 14 enable, 10, 14 enable, CLI, 10 introduction, 1 manage ports, 17 messages, 35 overview, 1 port types, 3 switches, 29 terms, vii ACL policies settings, 9 B behavior failover policy, 8 Brocade resources, viii C code, vii commands ag, 14 ag --failbackDisable, 23 ag --failbackEnable, 22 ag --failbackShow, 22, 23, 32 ag --failoverDisable, 22 ag --failoverEnable, 22 ag --failoverShow, 22, 32 ag --mapAdd, 20 ag --mapDel, 20,
display mapping, 17, 18 status, port, 18 E edge switch compatibility, 29 FLOGI, 9 long distance mode setting, 9 NPIV, 9 settings, 9 enable Access Gateway mode, 10, 14 failback policy, 22 failover policy, 22 N_Port mode, 25 F F_Port add to an N_Port, 20 configuration, 23 mapping, example, 4 mapping, show, 17 remove, 21 settings, edge switch, 9 status, 18 fabric compatibility, 9 inband queries, 9 join, 14 logins, 9 Management Server Platform, 9 merge switch, 15 settings, 9 zoning scheme, 9 Fabric OS Managem
NPIV edge switch, 9 T terms, vii O optional features, ix P policy failback, enable, 22, 23 failover, enable, 22 port comparison, 3 initialization, 5 management, 17 mapping, 4 requirements, 29 types, 3 U unlock N_Port, 23, 24 Z zoning merge, 15 schemes, 9 setting, 14 R requirements edge switch settings, 9 fabric settings, 9 ports, 29 resources, viii, ix S settings ACL policies, 9 FLOGI, 9 inband queries, 9 Management Server Platform, 9 zone, no access, 14 status port, display, 18 show, 18 supported ha
40 Access Gateway Administrator’s Guide 53-1000633-01, Rev B