Mac OS X Fibre Channel connectivity to the HP StorageWorks Enterprise Virtual Array storage system configuration guide Part number: 5697-0025 Third edition: July 2009
Legal and notice information © Copyright 2007, 2009 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Contents About this guide ................................................................................... 7 Intended audience ...................................................................................................................... Related documentation ................................................................................................................ Document conventions and symbols ...............................................................................................
Resetting LUN statistics ....................................................................................................... 40 Other ATTO Configuration Tool options ....................................................................................... 41 A Multipath configuration .................................................................... 43 Multipath configuration guidelines ..............................................................................................
Figures 1 ATTO Configuration Tool—LUN Paths ........................................................................ 17 2 ATTO Configuration Tool—Welcome window ............................................................. 20 3 Device Listing pane ................................................................................................. 21 4 Adapter—Basic Info tab .......................................................................................... 22 5 Channel—NVRAM tab ........................
Tables 1 Document conventions ............................................................................................... 8 2 Single host zone example ........................................................................................ 14 3 Dual host zone example .......................................................................................... 15 4 Tabs on the Configuration Options pane .................................................................... 21 5 NVRAM configuration ...........
About this guide This guide provides information about: • Apple Mac OS X connectivity • Installing and configuring ATTO Technology's Celerity Fibre Channel Host Adapter (Celerity FC host adapter) • Multipath configurations Intended audience This guide is intended for system administrators who are installing the Celerity FC host adapter for Mac OS X with the HP StorageWorks Enterprise Virtual Array (EVA) storage system.
Document conventions and symbols Table 1 Document conventions Convention Element Blue text: Table 1 Cross-reference links and e-mail addresses Blue, underlined text: http://www.hp.
HP websites For additional information, see the following HP websites: • • • • • http://www.hp.com http://www.hp.com/go/storage http://www.hp.com/service_locator http://www.hp.com/support/manuals http://www.hp.com/support/downloads Documentation feedback HP welcomes your feedback. To make comments and suggestions about product documentation, please send a message to storagedocsFeedback@hp.com. All submissions become the property of HP.
About this guide
1 Mac OS X connectivity overview HP supports Fibre Channel (FC) connectivity of Mac OS X on its Enterprise Virtual Array (EVA) storage systems using ATTO Technology's Celerity Fibre Channel host adapters.
Configuration guidelines Consider the following Celerity FC host adapter guidelines: • • • • • • ATTO 4-Gb and 8-Gb FC cards (PCI-X and PCIe only) are supported. Latest HP-specific ATTO Celerity FC host adapter driver Latest HP-specific ATTO Configuration Tool A maximum of 256 targets per host adapter channel are supported. A maximum of 255 logical unit numbers (LUNs) per host adapter channel are supported. PowerPC- and Intel-based servers are supported.
2 Installing the Celerity FC host adapter This chapter describes installation of the Celerity FC host adapter and host system setup and configuration. Setting up the host system To set up the host system: 1. Install the Celerity FC host adapter using the procedure provided by ATTO Technology. For more information or to download the ATTO Celerity Fibre Channel Host Adapters Installation and Operation Manual, see the ATTO Technology website: http://www.attotech.com/software/manuals.
Configuring Fibre Channel zoning This section describes the procedures to configure zoning. Single-path connectivity To configure zoning on B-Series switches for single-path connectivity: 1. Create a zone that contains: 2. • The host adapter port WWPN • An EVA port WWPN Add the zone to the switch configuration. 3. Enable or re-enable the switch configuration to add the zone to the fabric’s current configuration. Table 2 provides sample values for a single host zone.
NOTE: HP recommends zoning a single host adapter port WWPN with a single EVA port WWPN. The following procedure describes how to zone a host for multipath connectivity using two host adapter ports and two EVA ports: 1. Create a zone that contains: 2. • The first host adapter port WWPN • An EVA port WWPN from the first controller Create another zone that contains: 3. • The second host adapter port WWPN • An EVA port WWPN from the second controller Add the zones to the switch configuration. 4.
5. For a Mac OS X host, select the operating system type. 6. • For XCS 6.100 or later, select Custom from the Operating System Type list, and then enter 00000002024000A8 as the Custom type. • For XCS 09003000 or later, select Apple Mac OS X from the Operating System Type list. Click Add host. Creating a host entry for a multipath Mac OS X host To create an HP Command View EVA host entry for a multipath Mac OS X host: 1. Log on to HP Command View EVA. 2.
Verifying the configuration The HP-specific ATTO Celerity FC host adapter driver automatically determines the number of paths to a LUN. The ATTO Configuration Tool allows you to view path status and statistics. To verify the configuration: 1. Start the ATTO Configuration Tool from the Applications folder. 2. Expand the Channel entry and the HSV entry in the Device Listing pane to display the LUN entries, as shown in Figure 1. Figure 1 ATTO Configuration Tool—LUN Paths 3.
Installing the Celerity FC host adapter
3 ATTO Configuration Tool You use the ATTO Configuration Tool to configure host adapters and monitor host adapters, drivers, and devices.
The Welcome window opens (Figure 2). Figure 2 ATTO Configuration Tool—Welcome window The ATTO Configuration Tool window has three panes: • Device Listing—Lists the devices that are currently connected to the SAN. You can expand the device tree to view more information (Figure 3). • Configuration Options—Displays details about the device you select in the Device Listing pane. Depending on the device type, there are two to five tabs that you can use to navigate the utility.
Figure 3 Device Listing pane Table 4 Tabs on the Configuration Options pane Device Tabs Localhost Basic Info—Displays general information about the host Notifications—Displays notifications about the host See “Localhost device” on page 21 Adapter Basic Info—Displays general information about the adapter Flash—Displays the current revision of the flash code Advanced—Not supported with ATTO Celerity FC Adapters See “Adapter device” on page 22 Channel NVRAM—Displays NVRAM settings, which you can change
Adapter device Select an adapter from the Device Listing to view information about that adapter. You cannot change the information that is displayed. Figure 4 shows an example of a Celerity FC-42ES Basic Info display. NOTE: The Advanced tab is not supported with ATTO Celerity FC Adapters.
Channel device Select a channel (adapter port) from the Device Listing to view information about the ATTO Fibre Channel card (PCI Info tab) or to configure the NVRAM. Figure 5 shows an example of a channel NVRAM display. Figure 5 Channel—NVRAM tab Configuring the NVRAM This section provides guidelines for configuring the NVRAM. After you have NVRAM settings, click Commit to save the changes. You must reboot the system for the changes to take effect. Use care when changing the NVRAM settings.
Table 5 describes NVRAM settings. Table 5 NVRAM configuration Field Description Hard Address Enable Enabled—Allows you to enter a value for the FC-AL address. Disabled—The device selects and configures an available address when the FC loop is initialized. Settings Enabled Disabled Default setting Disabled Hard Address If hard addressing is enabled, allows you to set the FC-AL hard address. 0–125 0 Loop Retry Count Not supported with Mac OS X.
Field Description Settings Default setting Node Name Specifies the node world wide name (WWN) assigned to this channel. N/A N/A Port Name Specifies the port WWN assigned to this channel. N/A N/A Interrupt Coalesce Specifies how long an interrupt is delayed. The adapter chip delays interrupts to allow multiple interrupts to queue up before interrupting the CPU. This provides less overhead to service the interrupts. However, in the case of a single interrupt, the delivery is delayed.
EVA controller Select an EVA controller from the Device Listing to view information about the controller or to modify the configuration. Figure 6 shows an example of an HSV210 Paths display.
EVA controller path information Table 6 describes the information displayed on the EVA controller Paths tab. Table 6 EVA controller path information Information type Description Online—All paths are active and available for I/O transactions. Status Degraded—One or more paths are offline; however, I/O can continue on the remaining active paths. Offline—No paths are available. I/O and disk connectivity is lost. Pressure—The path with the fewest number of bytes being transferred is selected for I/O.
Setting the load balancing policy on the EVA controller To set the load balancing policy at the EVA controller level: 1. Right-click a target port on the Paths tab. The target port option menu appears (Figure 7). Figure 7 Target port option menu 2. Select Load Balancing. A selection window opens (Figure 8). Figure 8 Setting the load balancing policy for an EVA controller 3. Select a load balancing policy from the list, and then click Finish. The new policy takes effect immediately.
EVA controller target information The Target tab displays the EVA controller WWNN and status information for the selected target port (Figure 9).
EVA controller adapter information The Adapter tab displays the EVA controller WWPN and adapter status for the selected target port (Figure 10).
EVA controller statistics The Statistics tab displays throughput rates for the selected target port (Figure 11). Statistics are compiled from the time of system boot or the execution of the Reset Statistics command, whichever occurred later.
Resetting EVA controller statistics To clear the statistics and counters for the selected target port: 1. Right-click a target port on the Paths tab. The target port option menu appears (Figure 12). Figure 12 Target port option menu 2. Select Reset Statistics. A verification window opens. 3. Click Yes. All statistics and counters for the selected target port and its associated LUNs are reset.
LUN device Select a LUN from the Device Listing to view or configure information about the LUN. Figure 13 shows an example of a LUN Basic Info display.
LUN path information Table 7 describes the information displayed on the LUN Paths tab. Table 7 LUN paths information Information type Description Online—All paths are active and available for I/O. Degraded—One or more paths are offline; however, I/O can continue on the remaining active paths. Status Offline—No paths are available. I/O and disk connectivity is lost. Pressure—The path with the fewest number of bytes being transferred is selected for I/O. Pressure load balancing is domain based.
Setting the load balancing policy on the LUN To change the load balancing policy at the LUN target level: 1. Right-click a target port on the Paths tab. The target port option menu appears (Figure 14).
2. Select Load Balancing. A selection window opens (Figure 15). Figure 15 Setting the load balancing policy for a LUN 3. Select a load balancing policy from the list, and then click Finish. The new policy takes effect immediately. NOTE: Setting the load balancing policy at the EVA controller level overrides individual LUN load balancing policy settings.
LUN target information The target tab displays the WWNN and status information for the selected target port (Figure 16).
LUN adapter information The Adapter tab displays the WWPN and adapter status for the selected target port (Figure 17).
LUN statistics The Statistics tab displays throughput rates for the selected target port (Figure 18). The statistics are compiled from the time of the system boot or the execution of the Reset Statistics command, whichever occurred later.
Resetting LUN statistics To clear the statistics and counters for the selected LUN: 1. Right-click a target port on the Paths tab. The target port option menu appears (Figure 19). Figure 19 Target port option menu 2. Select Reset Statistics. A verification window opens. 3. Click Yes. All statistics and counters for the selected EVA controller and its associated LUNs are reset.
Other ATTO Configuration Tool options The ATTO Configuration Tool offers other options that you can use to manage your configuration. You can access the target port option menu (Figure 20) for an EVA controller or LUN by right-clicking a target port on the Paths tab. Table 8 describes the menu options. Figure 20 Target port options menu Table 8 Target port menu options Option Description Load Balancing Configures path utilization.
ATTO Configuration Tool
A Multipath configuration The ATTO Celerity Fibre Channel host adapter driver supports redundant or multiple paths between the host system and the EVA storage system. Proper setup of redundant paths ensures high availability of target disks. In an ideal configuration, each path uses separate Fibre Channel host adapters and infrastructure hardware (such as cables and switches). This ensures no single point of failure (NSPOF).
2. Create another zone that contains: 3. • The second host adapter port WWPN • An EVA port WWPN from the second controller Add the zones to the switch configuration. 4. Enable or re-enable the configuration to add the zones to the fabric’s current configuration. Table 9 provides sample values for a single host zone. Table 9 Single host zone example Zone Host adapter port WWPN EVA port WWPN EVA_Port_1_Zone 21:00...a2:cb 50:00....20:7d EVA_Port_2_Zone 21:00...2a:ca 50:00....
5. For a Mac OS X host, select the operating system type. 6. • For XCS 6.100 or later, select Custom from the Operating System Type list, and then enter 00000002024000A8 as the Custom type. • For XCS 09003000 or later, select Apple Mac OS X from the Operating System Type list. Click Add host. 7. In the Hosts folder, select the host you created in Step 3. 8. Click the Ports tab (Figure 21). 9. Click Add port. 10. Select the second host adapter port WWPN from the Port World Wide Name list. 11.
Figure 22 Host Properties—Presentation tab NOTE: Wait a few minutes to verify that the LUN is visible to the Mac OS X file system. Depending on the version of Mac OS X, a host reboot might be necessary. When the LUN appears to the host you can use Mac OS X disk utilities to perform normal block-level partitioning of the LUN.
Figure 23 One host adapter port connected to multiple EVA controllers NOTE: This configuration supports dual and quad port host adapters. Two host adapter ports connected to multiple EVA controllers The configuration shown in Figure 24 provides active/active path failover between EVA controller ports and I/O load balancing between two host adapter ports. Figure 24 Two host adapter ports connected to multiple EVA controllers NOTE: This configuration supports single and quad port host adapters.
Figure 25 Four host adapter ports connected to multiple EVA controllers NOTE: This configuration supports single and dual port host adapters.
B EVA storage system software HP offers array-based replication and local mirroring software for EVA storage systems. You can make point-in-time copies, or snapshots, of your data for disaster recovery, testing, application development, and reporting.
Figure 26 HP Continuous Access EVA with Mac OS X HP Continuous Access EVA copies data online and in real time to a remote EVA via synchronous or asynchronous replication through a local or extended SAN. Data replication can be bidirectional, meaning that a storage system can be both a source and a destination. A LUN can be replicated between two storage systems in one direction only. Write I/O is sent to the source, and then HP Continuous Access EVA replicates the I/O to the destination.
Overview HP Business Copy EVA shares an integrated management interface with HP Continuous Access EVA. HP Business Copy EVA provides features, replication licenses, and interfaces for local replication of EVAs. Local replication is a licensed feature of HP StorageWorks that allows you to quickly create local copies of your data using the array’s replication engine. These copies are known as mirrorclones, snapclones and snapshots.
EVA storage system software
C Troubleshooting the Celerity FC host adapter This appendix presents troubleshooting techniques that you can use to identify and resolve issues with the Celerity FC host adapter.
Figure 27 Sample ASP output To view ASP output: 1. Click the Apple icon in the top left corner of the screen. 2. Click More info. 3. Select File > Save as and enter the file name and directory in which to save the file. ATTOCelerityFCLog utility The Celerity FC host adapter driver does not use the system log to communicate driver events because it has limited resources and events are easily lost. Instead, the driver logs events internally; you can retrieve them using the ATTOCelerityFCLog utility.
0x01 Log fatal events that prohibit the driver from loading normally 0x02 Log events associated with the Fibre Channel loop 0x04 Log SCSI request errors 0x08 Log events reported by the adapter controller chip 0x10 Log port login/logout events 0x20 Log RSCN events 0x40 Log resource usage failures 0x80 Log informational messages System NVRAM options You can use the system NVRAM environment variable atto-args-celerityfc to configure the Celerity FC host adapter driver.
Enabling debug output To enable debug output from a Terminal session: 1. Enter the sudo nvram atto-args-celerityfc=“-e 0xff” command. If you are not the root user, you will be prompted for an administrator password. 2. Reboot the system for the changes to take effect. 3. Enter the nvram –p command to verify the change. Collecting debug output The Celerity FC host adapter driver does not use the system log to communicate driver events because it has limited resources.
Figure 29 IORegistry report Removing the Celerity FC host adapter driver and utilities To remove the Celerity FC host adapter driver and utilities, use the Uninstall command script in /System/Library/Extensions/ATTOCelerityFCUtils. Troubleshooting examples This section describes problems and provides recommended steps for resolution. Perform the steps in the order presented.
8. If the original configuration still fails, contact HP and report this as a possible interoperability issue between the host adapter and the computer. ASP does not detect any of the Fibre Channel devices Problem: The ASP recognizes the Celerity FC host adapter but does not detect any of the connected Fibre Channel devices. To troubleshoot this problem, perform the following steps: 1. Verify that the Fibre Channel devices are powered on. 2. Verify the cable integrity: 3.
2. Move the host adapter to a different slot. If the problem persists with the host adapter, replace it with a new host adapter. 3. Ensure that the PCIe adapter is installed in a slot configured as x4 or x8. 4. Zap the PRAM (Command+Option+P+R) at boot. Allow it to chime three times. 5. Disconnect all Fibre Channel devices from the host adapter and reboot the computer.
• Save the changes and restart the server with the Fibre Channel device attached. 3. Watch the LED indicators on the Fibre Channel devices before, during, and after startup. • Drive LEDs should flash at startup as the Fibre Channel port is scanned. • If a drive LED remains on when the server freezes, there is a problem with the drive. ATTO Configuration Tool does not show an online status for a device Problem: The ATTO Configuration Tool does not show a device status as online.
1. Use the Terminal command Kextstat | grep ATTO to verify the host adapter driver version and ATTO Configuration Tool version. See Supported hardware and software for the supported versions. 2. Reinstall the host adapter driver or ATTO Configuration Tool, if necessary.
Troubleshooting the Celerity FC host adapter
Index A D Apple System Profiler, 53 ATTO Configuration Tool locate, ATTO Celerity IORegistry, 56 ATTO Configuration Tool, 41 adapter view, 22 availability, 19 Channel view, 23 delete configuration, described, 19 EVA controller view, 26 for configuration verification, 17 in a multipath environment, 46 LUN view, 33 navigation, 21 refresh, 41 reset statistics, 41 save configuration, 41 ATTO Technology partnership with HP, 11 ATTOCelerityFCLog utility, 54 audience, 7 debug, 56 document conventions, 8 related
HP Command View EVA supported version, HP Business Copy EVA, HP Business Copy EVA features supported with Mac OS X, 51 restrictions with Mac OS X, 51 HP Command View EVA host properties, 44 presenting LUNs, 16 presenting vdisk, 45 HP Continuous Access EVA, HSV2x0 statistics, 31 I IORegistry, 56 L load balancing policy setting from the EVA controller level, 28 setting from the LUN level, 35 LUN presenting, 16 statistics, 39 statistics EVA controller, EVA controller, 31 LUN, 39 Subscriber's Choice, HP, 8 s