Mac OS X Fibre Channel connectivity to the HP StorageWorks Enterprise Virtual Array storage system configuration guide Part number: 5697-7272 First edition: December 2007
Legal and notice information © Copyright 2007 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 . . . . . . . . . . . . . . . . . . . . . . . . . . Intended audience . . . . . . . Related documentation . . . . . Document conventions and symbols HP technical support . . . . . . Subscription service . . . . . . HP websites . . . . . . . . . . Documentation feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ATTO Configuration Tool does not display paths . . . . . . . . . . . . . . . . . . . . . . Escalation checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figures 1 ATTO Configuration Tool—Channel 4 . . . . . . . . . . . . . . . . . . . . . . . 16 2 ATTO Configuration Tool—HSV status . . . . . . . . . . . . . . . . . . . . . . . 16 3 One host adapter port connected to multiple EVA controllers . . . . . . . . . . . . . 19 4 Two host adapter ports connected to multiple EVA controllers . . . . . . . . . . . . . 20 5 Four host adapter ports connected to multiple EVA controllers . . . . . . . . . . . . . 20 6 Sample ASP output . . . . . . . . . . . . . .
Tables 1 Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Supported hardware 6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 11 3 Supported software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 4 Single host zone example . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 5 Dual host zone example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 6 Multipathing status icons . . . . . . . . . . . . . . . . .
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, and who have knowledge of: • HP StorageWorks 4x00/6x00/8x00 Enterprise Virtual Array (EVA4
Document conventions and symbols Table 1 Document conventions Convention Element Blue text: Table 1 Cross-reference links and email addresses Blue, underlined text: http://www.hp.
• 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 connectivity of Mac OS X on its Enterprise Virtual Array (EVA) storage systems using ATTO Technology’s Celerity Fibre Channel Host Adapters.
Table 3 lists the supported software. Table 3 Supported software Product Version Mac OS X Tiger: 10.4.7 (minimum) Leopard: 10.5 (minimum) HP B-Series Fibre Channel switches 5.2.1b (minimum) HP EVA extensible controller software (XCS) 6.100 (minimum) ATTO Celerity 4-Gb FC host adapter 3.10MP1 ATTO Configuration Tool 3.13 HP Command View EVA 6.02 (minimum) 1Multipath software embedded in the host adapter driver was developed specifically for HP EVA storage systems.
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 2-Gb and 4-Gb Host Adapter Installation & Operation Manual, see the ATTO Technology website: http://www.attotech.com/software/manuals.html. 2.
Table 4 Single host zone example Zone Host adapter port WWPN EVA port WWPN EVA_Port_1_Zone 21:00...3e:ea 50:00....20:7d EVA_Port_2_Zone 21:00...3e:eb 50:00....20:78 NOTE: You can add hosts to each zone. You do not need to create separate zones for each host. Multipath connectivity Using the Celerity FC host adapter driver and the HP EVA active/active port technology, you can configure multiple paths for automatic I/O failover and multiple paths for concurrent I/O.
2. In the Hosts folder on the Storage System pane, click Add host. By default, the host type is Fibre Channel. 3. Enter the name of the host in the Name box. Command View EVA displays this name in the Hosts folder. 4. Select the host adapter port WWPN from the Port World Wide Name list. 5. For a Mac host, select Linux from the Operating System list. 6. Click Add host. Creating a host entry for a multipath Mac host To create a Command View EVA host entry for a multipath Mac host: 1.
To verify the configuration: 1. Start the ATTO Configuration Tool from the Applications folder. 2. Expand the Channel entry in the Device Listing pane to display the HSV controller entry, as shown in Figure 1. Figure 1 ATTO Configuration Tool—Channel 4 3. Click the HSV controller to display path, target, and adapter status (Figure 2). Figure 2 ATTO Configuration Tool—HSV status 4. Verify that: • Path Status is Online. • Path Errors displays No. • Each Path Target WWPN State is Active.
ATTO Configuration Tool The ATTO Configuration Tool is a utility program that you can use to view information about installed adapters, drivers, and devices. It also provides a mechanism to configure adapters. For more information, see the ATTO Utilities Installation and Operation Manual, available at http://www.attotech.com/software/manuals.html.
• • • • Read Count—Number of read bytes on this path Write Count—Number of write bytes on this path Command Count—Number of commands travelled on this path Error Count—Number of errors on this path Adapter information includes: • WWNN (Celerity FC host adapter) • WWPN • Port ID (Fibre Channel port ID of the Celerity FC host adapter) • Topology (Fibre Channel topology; PTP or PTP Preferred) • Link Speed • Domain ID (host adapter domain ID on the Fibre Channel fabric) • PCI Location (Location of the host ad
A Multipath configuration examples Regardless of the complexity of your configuration, you can configure paths between the Mac server and the EVA in multiple ways, depending on system and SAN resources. This appendix describes typical multipath configurations that follow the installation and setup guidelines. One host adapter port to multiple EVA controllers The configuration shown in Figure 3 provides active/passive path failover between EVA controller ports only.
Controller 1 FP1 FP2 FP1 FP2 Active Passive Fibre Channel Zone 1 Fibre Channel Zone 2 Controller 2 Passive Active 25341a Figure 4 Two host adapter ports connected to multiple EVA controllers NOTE: Single- and quad-port host adapters are supported in this configuration. Four host adapter ports to multiple EVA controllers The configuration shown in Figure 5 provides active/active path failover between EVA controller ports and I/O load balancing between host adapter ports.
B 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 6 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.
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. To ensure that you can view events, the driver logs them internally.
Figure 8 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.
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: • Check the cable connections. • Inspect the SFPs for physical damage. • Replace the SFPs if necessary. • Inspect the cable ends for dirt or abrasions, which can affect communication. 3.
5. Disconnect all Fibre Channel devices from the host adapter and reboot the computer. • If this corrects the problem, check the Fibre Channel cable, SFPs, or Fibre Channel target devices as described in “Fibre Channel device is faulty” on page 26. • If the computer does not boot, install the host adapter in a different computer. • If the host adapter works in the new computer, contact HP and report this as a possible interoperability issue between the host adapter and the computer.
2. Use the ATTO Configuration Tool to identify inactive paths. • The Celerity FC host adapter and target WWPNs identify the endpoints of the path. • If you have intermediate devices, such as a Fibre Channel switch, you may need to use the management software for those devices to find the problem. 3. Use the ATTO Configuration Tool to identify the host adapter channel. a. In the multipathing window, select the path that you want to identify. b.
• • • • • Is this a new error or is this an error that has occurred since the configuration was installed? How often does the error occur? Can you duplicate the error? Does the error occur sporadically, randomly, or consistently? Collect and include: • ASP output • IORegistry output • Dump of ATTOCelerityFCLog utility at the time of the error • Terminal output from the Kextstat | grep ATTO command • Terminal output from the Java – version command Mac OS X Fibre Channel connectivity to the HP StorageWorks E
