HP StorageWorks Q2300 User manual

HP StorageWorks
Q2300 PCI-X host bus adapter for
Itanium Linux systems installation
guide
Part number: AA–RW7HA–TE
First edition: March 2005

Legal and notice information
© Copyright 2005 Hewlett-Packard Development Company, L.P.
Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but not limited to, the implied
warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or
for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
This document contains proprietary information, which is protected by copyright. No part of this document may be photocopied,
reproduced, or translated into another language without the prior written consent of Hewlett-Packard. The information is provided
“as is” without warranty of any kind and 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.
Itanium™is a trademark or registered trademark of Intel Corporation or its subsidiaries in the United States and other countries.
Linux® is a U.S. registered trademark of Linus Torvalds.
Q2300 PCI-X host bus adapter for Itanium Linux systems installation guide

Q2300 PCI-X host bus adapter for Itanium Linux systems installation guide 3
Contents
About this guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Intended audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Related documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Document conventions and symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
HP technical support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
HP-authorized reseller . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Helpful web sites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1 Q2300 HBA features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Performance specifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Environmental specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Physical specifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2 Installing the HBA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Installation prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
HBA components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
LED indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Jumpers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Before you begin installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Installing the HBA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
3 Upgrading the HBA EFI driver and RISC firmware on Linux systems . . . . . . . . . . . 17
Upgrading the HBA on Linux systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4 Installing the Linux driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Installing the driver kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Using the RPM to install drivers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Installing the RPM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Upgrading the RPM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Uninstalling the RPM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Installing the fibreutils RPM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Changing driver parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Building a driver from the sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Building a uniprocessor version of the driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Building a multiprocessor version of the driver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Installing the driver on the boot drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Loading the driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Building a ramdisk image to load the qla2300 driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Loading and unloading the qla2300 driver manually. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Additional driver information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
System driver parameter max_scsi_luns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Driver command line parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Proc file system support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Contents

4
A Configuring the HBA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Starting the Configuration protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Using the Driver Configuration menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
B Regulatory compliance and safety . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Laser device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Laser safety warning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Certification and classification information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Laser product label . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
International notices and statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Canadian notice (avis Canadien) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Class A equipment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
European Union notice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
BSMI notice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Japanese notice. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Korean notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Safety . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Electrostatic discharge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Preventing electrostatic damage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Grounding methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Figures
1 Q2300 HBA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2 Class 1 laser product label . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Tables
1 Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2 HBA environmental specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
3 HBA specifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
4 LED indicators activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
5 Driver Configuration menu components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Q2300 PCI-X host bus adapter for Itanium Linux systems installation guide 5
About this guide
This guide describes how to install, configure, and troubleshoot the HP StorageWorks Q2300
PCI-X host bus adapter (Q2300 HBA), part number A7538A, for Itanium™ Linux® operating
systems.
For the latest version of this document and other HBA documentation, access the HP storage web
site http://h18006.www1.hp.com/storage/saninfrastructure.html.
Intended audience
This guide is intended for system administrators who are experienced with the following:
•Linux operating system
•Host bus adapters (HBAs)
Related documentation
In addition to this guide, please refer to the HP StorageWorks Q2300 PCI–X host bus adapter for
Itanium Linux systems release notes.
These and other HP documents can be found on the HP web site http://www.docs.hp.com.

6
Document conventions and symbols
WARNING! Indicates that failure to follow directions could result in bodily harm or death.
CAUTION: Indicates that failure to follow directions could result in damage to equipment or data.
IMPORTANT: Provides clarifying information or specific instructions.
NOTE: Provides additional information.
Table 1 Document conventions
Convention Element
Medium blue text: Figure 1 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 a GUI element, such as into a box
•GUI elements that are clicked or selected, such as menu
and list items, buttons, and check boxes
Italics font Text emphasis
Monospace font •File and directory names
•System output
•Code
•Text typed at the command-line
Monospace, italic font •Code variables
•Command-line variables
Monospace, bold font Emphasis of file and directory names, system output, code,
and text typed at the command-line
!

Q2300 PCI-X host bus adapter for Itanium Linux systems installation guide 7
TIP: Provides helpful hints and shortcuts.
HP technical support
Telephone numbers for worldwide technical support are listed on the HP web site:
http://www.hp.com/support.
Collect the following information before calling:
•Technical support registration number (if applicable)
•Product serial numbers
•Product model names and numbers
•Applicable error messages
•Operating system type and revision level
•Detailed, specific questions
For continuous quality improvement, calls may be recorded or monitored.
HP strongly recommends that customers sign up 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 versions of drivers, and firmware documentation updates as well as
instant access to numerous other product resources.
•After signing up, you can quickly locate your products by selecting Business support and then
Storage under Product Category.
HP-authorized reseller
For the name of your nearest HP-authorized reseller:
•In the United States, call 1-800-345-1518.
•Elsewhere, visit http://www.hp.com and click Contact HP to find locations and telephone
numbers.
Helpful web sites
For product information, see the following web sites:
•http://www.hp.com
•http://www.hp.com/go/storage
•http://www.hp.com/support/
•http://www.docs.hp.com

8

Q2300 PCI-X host bus adapter for Itanium Linux systems installation guide 9
1 Q2300 HBA features
This chapter describes the features of the Q2300 HBA (part number A7538A), including:
•Performance specifications, page 10
•Environmental specifications, page 10
•Physical specifications, page 11

Q2300 HBA features10
Performance specifications
The Q2300 HBA is a 2-Gb, high-performance Direct Memory Access (DMA) bus master host
adapter designed for high-end systems.
This HBA has the following features:
•Unique, single-integrated Fibre Channel controller for added reliability and optimum
performance.
•Autonegotiation of Fibre Channel speed bit rate (1 Gbps or 2 Gbps).
•Combines a powerful Reduced Instruction Set Computing (RISC) processor, a Fibre Channel
protocol manager (FPM) with 2-Gb Fibre Channel transceivers, and a peripheral component
interconnect (PCI) or peripheral component interconnect-extended (PCI-X) local bus interface in
a single-chip solution.
•Supports Private Loop Direct Attach (PLDA) and Fabric Loop Attach (FLA) connections.
•Supports bus master DMA.
•Supports Fibre Channel protocol-SCSI (FCP-SCSI), IP, and Fibre Channel-Virtual Interface (FC-VI)
protocols.
•Supports point-to-point fabric connection (F-PORT FABRIC LOGIN).
•Complies with:
• PCI Local Bus Specification revision 2.2.
• PCI-X Addendum (revision 1.0) to the PCI Local Bus Specification.
• Third-generation Fibre Channel–Physical and Signaling Interface (FC-PH-3) standard.
• Fibre Channel-Arbitrated Loop (FC-AL-2) standard.
• U.S. and international safety and emissions standards.
Environmental specifications
Table 2 lists the HBA environmental specifications.
Table 2 HBA environmental specifications
Environment Minimum Maximum
Operating temperature 0°C/32°F55°C/131°F
Storage temperature –2°C/-4°F70°C/158°F
Relative humidity (non-condensing) 10% 90%
Storage humidity (non-condensing) 5% 95%

Q2300 PCI-X host bus adapter for Itanium Linux systems installation guide 11
Physical specifications
Table 3 lists the HBA specifications.
Table 3 HBA specifications
Type Specification
Host bus Conforms to PCI Local Bus Specification, Revision 2.2
Fibre Channel
specifications
Bus type: fiber optic media
Bus transfer rate:
200 Mb/s maximum at half duplex
400 Mb/s maximum at full duplex
Interface chip: ISP2312
Central processing unit
(CPU)
Single-chip design that includes a RISC processor, Fibre Channel
protocol manager, PCI-XDMA controller, integrated
serializer/deserializer (SEREDES), and electrical transceivers that
can auto-negotiate a data rate of 1 Gb/s or 2 Gb/s
RAM 256 KB per Fiber Channel controller; scalable to 4 MB
NVRAM 256 KB, field programmable
Flash 128 KB of flash ROM in two 64 KB, software selectable banks,
field programmable
Onboard DMA Five-channel DMA controller: two data and one command, one
auto-DMA request, and one auto-DMA response
Distance 1 Gbps: 500 meters 50/125 µm fiber, 300 meters 62.5/125 µm
fiber
2 Gbps: 300 meters 50/125 µm fiber, 150 meters 62.5/125 µm
fiber
Cable 50/125µm multimode fiber, 62.5/125 µm multimode fiber
Frame Buffers Integrated 10 KB frame buffer FIFOs (6 KB receive and
4KB transmit) for each data channel
Connectors LC-style connector that supports non-OFC, multimode fiber optic
cabling using a small form factor optical transceiver module.
Form factor 17.78 cm x 10.67 cm (7.0 in x 4.2 in)
Power Consumption
(66MHz PCI-X Optic)
~4.75 watts

Q2300 HBA features12

Q2300 PCI-X host bus adapter for Itanium Linux systems installation guide 13
2 Installing the HBA
This chapter describes the procedure for installing the Q2300 HBA, including:
•Installation prerequisites, page 13
•Installing the HBA, page 16
Refer to your host documentation for installing the HBA.
WARNING! Disconnect the host from the power source before installing the HBA. To reduce the
risk of personal injury from hot surfaces, allow the internal server or workstation components to cool
before touching.
WARNING! 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 33
Installation prerequisites
Before you begin, make sure you have the following:
•A screwdriver (Phillips #1).
•An optical multimode cable with an LC-style duplex connector.
•Each HBA has a unique serial number that is located on the bottom of the adapter. Check the
HBA and record its serial number, in the unlikely event that the NVRAM is corrupted.

Installing the HBA14
HBA components
Figure 1 shows the Q2300 HBA LEDs that are referenced in this chapter.
Figure 1 Q2300 HBA
LED indicators

Q2300 PCI-X host bus adapter for Itanium Linux systems installation guide 15
LED indicators
Table 4 identifies and describes the activity of the LED indicators.
Jumpers
The jumpers on the HBA are set to the default state of the laser and are set at the factory with a
jumper plug on pins 1-2 of the J3 jumper and on pins 1-2 of the J4 jumper.
CAUTION: Changing the jumper settings can result in the HBA being inoperable.
Table 4 LED indicators activity
Green LED
(2Gb)
Amber LED
(1 Gb)
Comments Activity
Off Off Power off
On On Power on before
firmware initialization
1 Flash 1 Flash Both flashing at the
same time like a heart
beat
Power on after firmware
initialization
2 Flashes 2 Flashes Alternate flashing.This
state changes to not-
initialized state in 2 to 3
seconds. Both LEDs are
On steadily
Firmware fault
Off On 1 Gb Link up
On Off 2 Gb Link up
Off 5 Flashes Activity at 1Gb
5 Flashes Off Activity at 2 Gb

Installing the HBA16
Before you begin installation
The HBA is self-configuring. However, some motherboards require manual configuration. See the
documentation supplied with your computer, or contact your computer dealer to determine if your
motherboard requires configuration.
Some motherboards have two kinds of PCI bus slots: master and slave. The Q2300 HBA must be in
a PCI bus master slot. (Some motherboards have PCI bus master slots that are shared with onboard
devices. The Q2300 HBA does not work in shared slots.)
PCI connectors vary among system adapter manufacturers. The Q2300 HBA is a 64-bit PCI device
that can function in a 32-bit PCI slot; the slot conforms to the PCI specification. The rear edge of the
PCI slot is notched.
CAUTION: If you try to install the adapter in a PCI slot that does not conform to the PCI
specification, you may damage the device.
PCI and PCI-X slots look the same. If the server contains both PCI and PCI-X slots, refer to the server
manufacturer’s instructions to determine the slot type.
The Q2300 HBA is designed and tested to operate at PCI bus speeds of up to 133 MHz.
Installing the HBA
To install the HBA:
1. Check the motherboard and make any necessary configuration changes to accommodate the
HBA.
2. Power down the peripherals, then turn off the computer.
3. Remove the computer cover and save the screws.
4. Choose any PCI bus slot that supports bus mastering.
5. Most motherboards automatically assign an IRQ level and interrupt line; if your motherboard
does not, you must assign the IRQ level and use interrupt line A for the selected slot.
6. Remove the slot cover for the slot in which you will install the HBA.
7. Place the HBA in the slot. 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.Carefully reinstall the computer cover. Insert and tighten the computer cover screws.
11.Power up all external FC devices, then power up the server and observe the monitor to ensure
proper operation.

Q2300 PCI-X host bus adapter for Itanium Linux systems installation guide 17
3 Upgrading the HBA EFI driver and RISC firmware on
Linux systems
This chapter describes the procedure for upgrading the Extensible Firmware Interface (EFI) driver
and RISC firmware for the Q2300 HBA.

Upgrading the HBA EFI driver and RISC firmware on Linux systems18
Upgrading the HBA on Linux systems
Use the following procedure to upgrade the Q2300 HBA on Linux:
1. Place the Q2300 HBA in a Linux server with a local boot disk.
2. Boot to Linux.
3. Load the fibreutils RPM.
4. Reboot the server to the EFI shell.
5. Set the drive to the boot device. For example, fs1:
6. Change to the directory containing EFIUTIL. For example:
cd \efi\qla2x00
7. Enter efiutil.efi to run EFIUTIL.
8. Enter the adapter command to select the first adapter channel.
9. Enter the risc_fw_write command to write the risc firmware. Use the default firmware file.
10.Enter the efi_write command to write the EFI driver. Use the default driver file.
11.Repeat step 8 through step 10 for other adapter channels.
12.Choose quit to exit EFIUTIL.
13.Enter the reset command to reboot.

Q2300 PCI-X host bus adapter for Itanium Linux systems installation guide 19
4 Installing the Linux driver
This chapter provides instructions for installing the Linux qla2x00 drivers for the Q2300 HBA on an
already installed Red Hat Enterprise Linux (Red Hat EL), kernel 2.4x, or SUSE Linux Enterprise
Server (SUSE SLES) for 64-bit Itanium system.
The software kit for this HBA can be obtained from the following HP web site
http://h18006.www1.hp.com/storage/saninfrastructure.html.
This section provides instructions for installing the qla2300 driver into a Linux operating system.
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:
•Installing the driver kit, page 20
•Building a driver from the sources, page 21
•Installing the driver on the boot drive, page 24
•Loading the driver, page 24
•System driver parameter max_scsi_luns, page 27
•Driver command line parameters, page 28
•Proc file system support, page 28

Installing the Linux driver20
Installing the driver kit
HP recommends that you install the complete driver kit for this HBA. The kit contains the driver and
utilities you need to deploy this HBA on Linux.
NOTE: You must install the gcc compiler and the kernel sources 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:
# gunzip hp_qla2x00version_info.tar.gz
# tar -xvf hp_qla2x00version_info.tar
# cd hp_qla2x00
# ./INSTALL
Refer to the README file included with the driver kit for more information.
Using the RPM to install drivers
The RPM Package Manager (RPM) is a package management system that lets you easily install
Linux software. Using RPM, you can install software in prebuilt bundles called RPM packages. The
driver RPM packages have the driver source code and driver utilities.
Installing the RPM
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_qla2x00-version_info.rpm
Upgrading the RPM
To upgrade the RPM, copy the RPM package file to your system and enter the following command:
•For Red Hat EL, enter:
# rpm -Uvh --nopostun --nopreun package_name.rpm
•For SUSE SLES:
# rpm -Uvh package_name.rpm
Uninstalling the RPM
To uninstall the RPM package, enter the following command:
# rpm -e package_name.rpm