HP AB479A User manual

HP
PCI-X 2.0 single-port and dual-port 4Gb FC
adapters for Itanium Linux and Windows
installation guide
Part number: AA–RW87B–TE
First edition: June 2006

Legal and notice information
©Copyright 2006 Hewlett-Packard Development Company, L.P.
©Copyright 2006 QLogic Corp.
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. The only warranties for HP products and services are set forth
in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting
an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
Intel and Itanium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other
countries.
Linux is aU.S. registered trademark of Linus Torvalds.
Microsoft and Windows are U.S. registered trademarks of Microsoft Corporation.
RED HAT is atrademark of Red Hat, Inc.
SUSE is aregistered trademarks of Novell, Inc.

Contents
Aboutthisguide .......................... 7
Intendedaudience...................................... 7
Relateddocumentation.................................... 7
Documentconventionsandsymbols .............................. 7
HPtechnicalsupport..................................... 8
Helpfulwebsites .................................... 8
Subscriptionservice ................................... 8
1HBAfeatures........................... 9
Performance specifications .................................. 9
Environmental specifications................................. 10
Physical specifications ................................... 10
2 Installing the HBAs ....................... 11
Installationprerequisites .................................. 11
Installationprocedure ................................... 12
LEDindicators....................................... 13
3 Installing and configuringtheLinuxdriver.............. 15
Prerequisites ....................................... 15
Installingthedriverkit ................................... 15
UsingtheRPM ...................................... 15
Installing the fibreutilsRPM ................................. 16
Changingdriverparameters............................... 16
Proc filesystemsupport................................... 16
ConfiguringtheHBAs ................................... 16
Starting the Configurationprotocol.............................. 17
Using the Driver Configurationmenu ............................. 18
TroubleshootingLinux.................................... 19
4InstallingtheWindowsdrivers................... 21
Prerequisites ....................................... 21
InstallingdriversusingtheSmartComponent.......................... 21
TroubleshootingWindows.................................. 22
UsingtheEventViewer................................. 22
ARegulatorycomplianceandsafety................. 23
DeclarationofconformityforproductsmarkedwiththeFCClogo,UnitedStatesonly......... 23
Laserdevice ....................................... 23
Lasersafetywarning.................................... 23
Certification and classificationinformation........................... 23
Laserproductlabel..................................... 24
Internationalnoticesandstatements ............................. 24
Canadiannotice(avisCanadien) ............................ 24
EuropeanUnionnotice................................. 24
BSMI(Taiwan)..................................... 25
Japanesenotice.................................... 25
Koreannotice..................................... 25
PCI-X 2.0 single-port and dual-port 4Gb FC adapters for Itanium Linux and Windows 3

Electrostaticdischarge ................................... 26
Groundingmethods .................................... 26
Index .............................. 27
4

1
2
3
4
5
Figures
64-bitPCI-X2.0connector.............................. 12
Class1laserproductlabel.............................. 24
BSMI(Taiwan)notice ................................ 25
Japanesenotice .................................. 25
Koreannotice ................................... 25
PCI-X 2.0 single-port and dual-port 4Gb FC adapters for Itanium Linux and Windows 5

Tables
1Documentconventions................................. 7
2 HBA environmental specifications........................... 10
3 HBA specifications ................................. 10
4LEDindicatorsactivity................................ 13
5DriverConfigurationmenucomponents......................... 19
6

About this guide
This guide provides information about:
• Installing and configuring the HP PCI-X 2.0 dual-port 4Gb FC adapter (PCI-X 2.0 dual-port host
bus adapter), product number AB639A, for Itanium®Linux®and Microsoft®Windows®systems.
• Contacting technical support for additional assistance
Intended audience
This guide is intended for system administrators who are familiar with:
• Linux operating systems
• Windows operating systems
• Host bus adapter (HBAs)
Related documentation
In addition to this guide, see the HP StorageWorks QLogic host bus adapters for Itanium Linux and
Windows release notes.
Other HP documents are available on the HP web site: http://www.docs.hp.com.
Document conventions and symbols
Table 1Document conventions
Convention Element
Medium blue text: Related documentation Cross-reference links and e-mail addresses
Medium blue, underlined text
(http://www.hp.com)Web site addresses
Bold font •Key names
•Text typed into aGUI element, such as into abox
•GUI elements that are clicked or selected,
suchasmenuandlistitems,buttons,andcheck
boxes
Italic font Text emphasis
Monospace font •File and directory names
•System output
•User input
•Code
•Text typed at the command line
Monospace, italic font •Code variables
•Command-line variables
WARNING!
Indicates that failure to follow directions could result in bodily harm or death.
PCI-X 2.0 single-port and dual-port 4Gb FC adapters for Itanium Linux and Windows 7

CAUTION:
Indicates that failure to follow directions could result in damage to equipment or data.
IMPORTANT:
Provides clarifying information or specificinstructions.
NOTE:
Provides additional information.
TIP:
Provides helpful hints and shortcuts.
HP technical support
Telephone numbers for worldwide technical support are listed on the HP support web site:
http://www.hp.com/support/.
Collect the following information before calling:
•Technical support registration number (if applicable)
•Product serialnumbers
•Product model names and numbers
•Applicable error messages
•Operating system type and revision level
•Detailed, specificquestions
Helpful web sites
For other product information, see the following HP web sites:
• http://www.hp.com
• http://www.hp.com/go/storage
• http://www.hp.com/support/
• http://www.docs.hp.com
Subscription service
HP strongly recommends that customers register online using the Subscriber’s choice web site:
http://www.hp.com/go/e-updates.
Subscribing to this service provides you with e-mail updates on the latest product enhancements, newest
driver versions, and firmware documentation updates, as well as instant access to numerous other product
resources.
After subscribing, locate your products by selecting Business Support Center and then Storage under
Product Category.
8About this guide

1HBAfeatures
This chapter describes the features of the PCI-X 2.0 single-port HBA (product number AB479A) and the
PCI-X 2.0 dual-port HBA (product number AB379A).
• Performance specifications,page 9
• Environmental specifications,page10
• Physical specifications,page 10
Performance specifications
The PCI-X 2.0 4Gb FC adapters are 4-Gb, high-performance direct memory access (DMA) bus master
HBAs designed for high-end systems.
These HBAs have the following features:
• Combine apowerful reduced instruction set computing (RISC) processor, aFibre Channel protocol
manager (FPM) with 4Gb Fibre Channel transceivers, and aperipheral component interconnect
(PCI) or peripheral component interconnect-extended (PCI-X) local bus interface in asingle-chip
solution
• Support Fabric Loop Attach (FLA) connections
• Support bus master DMA
• Supports SCSI-3 Fibre Channel Protocol (SCSI-FCP), and Fibre Channel-Virtual Interface (FC-VI)
protocols
• Support point-to-point fabric connection (F-PORT FABRIC LOGIN)
• Comply with:
•PCILoca
lBusSpecification revision 2.3
• PCI-X Protocol Addendum to the PCI Local Bus Specification, revision 2.0a
• PCI-X Electrical and Mechanical Addendum (revision 2.0a) to the PCI Local Bus Specification
•PCIBusP
ower Management Interface Specification revision 1.1
•PCIHotPlugSpecification, revision 1.0PCI-X Addendum (revision 1.0) to the PCI Local Bus
Specification
• Third-generation Fibre Channel–Physical and Signaling Interface (FC-PH) standard
•FibreC
hannel-Arbitrated Loop (FC-AL-2) standard
• Fibre Channel Framing and Signaling (FC-FS)
• U.S. and international safety and emissions standards
PCI-X 2.0 single-port and dual-port 4Gb FC adapters for Itanium Linux and Windows 9

Environmental specifications
Table 2lists the HBA environmental specifications.
Table 2HBA environmental specifications
Environment Minimum Maximum
Operating temperature 0°C/32 °F 55 °C/131 °F
Storage temperature -20 °C/-4 °F 70 °C/158 °F
Relative humidity (noncondensing) 10% 90%
Storage humidity (noncondensing) 5% 95%
Physical specifications
Table 3lists the HBA specifications.
Table 3HBA specifications
Type Specification
Bus interface 64-bit, PCI-X 2.0 266-MHz DDR, compatible with 66/33-MHz PCI
and 133/100/66-MHz PCI-X
Conforms to PCI Local Bus Specification, revision 2.3,PCI Bus
Power Management Interface Specification, revision 1.1,PCI Hot
Plug Specification, revision 1.0
Fibre Channel specifications Bus type: fiber optic media
Bus transfer rate: 4Gb/s FC increases aggregate throughput rate
to 800 MB/s in full-duplex mode
Central processing unit (CPU) Single-chip design that includes aRISC processor, Fibre
Channel protocol manager, PCI-XDMA controller, integrated
serializer/deserializer (SEREDES), and electrical transceivers that
canautonegotiateadatarateof4Gb/s
Memory 1-MB SRAM, 1-MB flash (SPI), and 2-KB NVRAM (SPI)
Signal voltage 3.3 V(mode 1), 3.3 V/1.5 V(mode 2)
Data rate 4, 2, 1Gb/s auto-negotiation (4.2480/2.1240/1.0625 Gb/s)
Onboard DMA Five-channel DMA controller: two data and one command, one
auto-DMA request, and one auto-DMA response.
Frame Buffers Integrated 10-KB frame buffer FIFOs (6-KB receive and
4-KB transmit) for each data channel.
Ports Single or dual 4Gb/s
Connectors Small-form-factor fixed (SFF) multimode optic with LC connector
Form factor Low-profile MD2: 16.93 cm ×5.15 cm (6.7 in. ×2.5 in.)
Bracket size Standard: 1.84 cm ×12.08 cm (0.73 in. ×4.76 in.)
Low-profile: 1.84 cm ×8.01 cm (0.73 in. ×3.15 in.)
Power consumption ~11.0 Watts
10 HBA features

2Installing the HBAs
This chapter describes the procedure for installing the HP PCI-X 2.0 single-port and dual-port HBAs,
including:
• Installation prerequisites,page11
•Installation procedure,page 12
Refer to your host documentation for installing the HBA.
WARNING!
DisconnectthehostfromthepowersourcebeforeinstallingtheHBA.Toreducetheriskofpersonalinjury
from hot surfaces, allow the internal server or workstation components to cool before touching.
CAUTION:
Electrostatic discharge (ESD) can damage electronic components. Be sure you are properly grounded
before beginning this procedure as described in "Regulatory compliance and safety"on page 23.
Installation prerequisites
Before you begin, ensure that you have:
• An optical multimode cable with an LC-style duplex connector
• An empty 64-bit PCI-X slot
• The following unique information that is located on the bottom of the HBA:
•Serialnumber
• WorldWide Port Name (WWPN) and Node Name (NN), each of which is derived from the
HBA’s IEEE address. Combined, the WWPN and NN create the WorldWide Name (WWN)
that uniquely identifies an HBA in the Fibre Channel environment.
PCI-X 2.0 single-port and dual-port 4Gb FC adapters for Itanium Linux and Windows 11

Installation procedure
To install the HBA:
1. Check the motherboard and make any necessary configuration changes to accommodate the HBA.
2. Power down the peripherals, and then turn off the computer.
3. Disconnect the power cable.
4. Remove the computer cover and save the screws.
5. Locate the appropriate bus slot. The connector for the slot looks like the connector in Figure 1.
Figure 164-bit PCI-X 2.0 connector
6. RemovetheslotcoverfortheslotinwhichyouwillinstalltheHBA.
7. Place the HBA in the slot and carefully press the board into the slot until it seats firmly.
8. Secure the HBA to the chassis following the server manufacturer’s instructions.
9. Connect the appropriate cable from the devices to the corresponding LC-connector.
10. Close and tighten the computer cover.
11. Plug in the power cable.
12. Power up all external Fibre Channel devices, then power up the server and observe the monitor and
the LED indicators described in "LED indicators "on page 13 to ensure proper operation.
12 Installing the HBAs

LED indicators
Table 4identifies and describes the activity of the LED indicators.
Table 4LED indicators activity
Yellow LED Green LED Amber LED Activity
Off Off Off Power off
On On On Power on before or after
firmware initialization
Flashing Flashing Flashing Power on after firmware
initialization
Alternately flashing Alternately flashing Alternately flashing Firmware fault
Off Off Flashing Activity at 1Gb
Off Flashing Off Activity at 2Gb
Flashing Off Off Activity at 4Gb
Flashing Off Flashing Beacon
PCI-X 2.0 single-port and dual-port 4Gb FC adapters for Itanium Linux and Windows 13

14 Installing the HBAs

3Installing and configuring the
Linux driver
This chapter provides instructions for installing the Linux qla2xxx driver (xxx is the kit date string) for the
PCI-X 2.0 single-port and dual-port HBAs on an already installed Red Hat™Enterprise Linux (Red Hat EL)
or SUSE™Linux Enterprise Server (SUSE SLES) system.
You can obtain the software kit for the driver from the following HP web site:
http://h18006.www1.hp.com/storage/saninfrastructure.html.
To install the driver, you must be familiar with the operating system under which the HBA is to operate,
and have access to standard system documentation.
To install the driver, use the procedures and information in the following sections:
• Prerequisites,page 15
• Installing the driver kit,page 15
•UsingtheRPM,page 15
• Configuring the HBAs,page 16
Prerequisites
Perform the following tasks before you install the drivers:
• Obtain the HP StorageWorks QLogic host bus adapters for x86 and x64 Linux
and Windows, and x86 NetWare release notes,available on the HP web site
http://h18006.www1.hp.com/storage/saninfrastructure.html.
• Be familiar with the operating system under which the HBA is to operate, and have access
to standard system documentation.
Installing the driver kit
HP recommends that you install the complete driver kit for these HBAs. The kit contains the driver and
utilities you need to deploy these HBAs on Linux.
NOTE:
You must install the gcc compiler and the kernel sources or kernel development packages on your
system before installing the driver kit.
To install the complete HP driver kit, copy the .gz file to your system and enter the following commands:
#tar -zxvf hp_qla2x00-xxx.tar.gz
#cd hp_qla2xxx
#./INSTALL
The xxx is the kit date string.
Using the RPM
PCI-X 2.0 single-port and dual-port 4Gb FC adapters for Itanium Linux and Windows 15

The RPM Package Manager (RPM) is apackage management system that lets you easily install Linux
software. Using RPM, you can install software in prebuilt bundles called RPM packages.
This section is included for reference only. See this section for future separate RPM installations you
may need.
For example:
• To install the RPM, copy the RPM package file to your system and enter the following command:
#rpm -ivh package_name.rpm
• To manually install the Linux HBA driver RPM, enter the following command:
#rpm -ivh hp_qla2xxx.rpm
• To upgrade the RPM, copy the RPM package file to your system and enter the following command:
•ForRedHatEL,enter:
#rpm -Uvh --nopostun --nopreun package_name.rpm
• For SUSE SLES:
#rpm -Uvh package_name.rpm
• To uninstall the RPM package, enter the following command:
#rpm -e package_name.rpm
Installing the fibreutils RPM
HP recommends installing the fibreutils RPM found in the driver kit. It contains useful utilities for managing
Fibre-attached storage. To manually install this RPM, enter the following command:
#rpm -ivh fibreutils-version.rpm
Changing driver parameters
To change driver parameters:
1. Run the set_parm script located in the /opt/hp/src… directory.
2. Reboot the server.
NOTE:
You must reboot. Otherwise, the qla2
xxx driver may not unload if there is aprocess or file
system using adevice that is attached to the HBA.
Proc file system support
The /proc file system for the qla2xxx driver can be found in the /proc/scsi/qla2xxx/directory.
This directory contains entries for each SCSI HBA channel in the system. Each entry presents information
about the adapter and transfer statistics for each discovered LUN.
Configuring the HBAs
This section describes how to configure the HBAs on Linux systems using the Configuration protocol
Driver Configuration menu.
NOTE:
Thisprocessisforadvanceduserswhowanttocustomizetheconfiguration of the HBAs and the
connected devices.
16 Installing and configuring the Linux driver

This section includes:
•StartingtheConfiguration protocol,page17
•Using the Driver Configuration menu,page 18
Starting the Configuration protocol
To configure theHBAonLinux,accesstheConfiguration protocol as follows:
1. Use the fibreutils RPM package to obtain efiutil (efiutil.efi)and the auxiliary driver, as
described in "Installing the fibreutils RPM"on page 16.
2. Power on the server to the EFI shell.
3. Start efiutil as follows (the auxiliary driver is automatically loaded if it is needed):
a. Set the driveto the boot device (for example, fs1:).
b. Change to the directory containing efiutil.For example, enter:
cd efi\qla2xxx
c. Run efiutil:
efiutil.efi
Enter Help at any time for information about commands.
d. Select the HBA channel that you want to configure by selecting adapter.
e. Select configure.
4. Configure the HBA’s NVRAM by selecting the menu items for the parameters to be changed, as
described in "Using the Driver Configuration menu"onpage18.
5. Write the new configuration to NVRAM.
6. Exit the utility (select quit).
7. Reboot the system.
PCI-X 2.0 single-port and dual-port 4Gb FC adapters for Itanium Linux and Windows 17

Using the Driver Configuration menu
This section describes the Configuration protocol’s Driver Configuration menu. The menu contains the
following sections and functions:
•NVRAM—Modify settings that are stored in the HBA’s NVRAM.
•Information—View device, HBA, and Help information.
•Operation—Write or discard NVRAM data and exit the Configuration protocol.
The following example shows the Driver Configuration menu.
Main Menu
NVRAM Parameters
1. Edit Adapter Settings
2. Edit Advanced Settings
3. Edit Database
4. Edit Boot Settings
Information
5. Show Database
6. Show Translation
7. Show NVRAM Buffer
8. Info
9. Help
Operation
10. Abandon
11. Write
12. Quit
18 Installing and configuring the Linux driver

Table 5describes the Driver Configuration components.
Table 5Driver Configuration menu components
Menu Option Description
NVRAM Parameters
1. Edit Adapter Settings Displays the Edit Adapter Settings menu.
2. Edit Advanced Settings Displays the Edit Advanced Settings menu.
3. Edit Database Displays the Edit Database screen.
4. Edit Boot Settings Displays the Edit Boot Settings menu.
Information
5. Show Database Displays the contents of the world wide name (WWN) database in table
form.
6. Show Translation Displays the SCSI target ID translation table. This table is alist of SCSI
TID and Fibre Channel loop id mapping pairs. Each entry in the table
consists of the following information about each device:
•SCSI id (TID)
•Fibre channel loop id (LID)
•World wide port name (WWPN)
•Worldwidenodename(WWNN)
All numbers are in hexadecimal.
Tid values from 0x00 to 0x0A are persistent, and TID values greater
than 0x0A are assigned sequentially as devices are discovered. Tid
values greater than 0x80 are fabric-attached while those below 0x7F
are arbitrated-loop-attached.
7. Show NVRAM Buffer Displays the contents of the local NVRAM buffer in hexadecimal. This
is the local buffer containing changes made prior to using the Write
selection to commit them to the HBA’s NVRAM.
8. Info Displaysthe following HBA information:
•EFI device path
•Port WWPN
•Serial number
•SSVID and SSDID from NVRAM
Use the device path to determine which HBA configuration is displayed.
9. Help Displays abrief description of the menu selections.
Operation
10. Abandon Abandons the changes in the current Configuration protocol local buffer
and reloadsitscontentsfromtheHBA’sNVRAM.
11. Write Writes the current Configuration protocol local buffer to the HBA’s
NVRAM. Use this function any time you use amenu selection to modify
configuration data. When the NVRAM has been successfully written, the
Configuration protocol local buffer is reloaded from the HBA’s NVRAM.
12. Quit Quits the Configuration protocol and returns to the EFI shell. You must use
the Write selection to write any changes to the HBA’s NVRAM before
quitting.
Troubleshooting Linux
For troubleshooting Linux driver-related information, check the var/log/messages file. If the qla2xxx
driver detects any fabric or driver events, the information about these events reside in this file.
PCI-X 2.0 single-port and dual-port 4Gb FC adapters for Itanium Linux and Windows 19

20 Installing and configuring the Linux driver