HP StorageWorks A6826A PCI-X host bus adapter for Itanium Linux systems installation guide Part number: AA–RV12C–TE Third edition: October 2005
Legal and notice information © Copyright 2003–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.
Contents About this guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Contents Intended audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . Document conventions and symbols . . . . . . . . . . . . . . . . . . HP technical support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HP-authorized reseller . . . . . . . . . . . . . . . . . . . . . . . . .
B Building a driver from sources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Building a uniprocessor version of the driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Building a multiprocessor version of the driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 C Regulatory compliance and safety . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 Laser device. . . . . . . . . . . . . . . . .
About this guide This guide provides information about: • Installing, configuring, and troubleshooting the A6826A PCI-X host bus adapter (HBA) for Linux® operating systems.
Document conventions and symbols Document conventions Table 1 Convention Element Medium blue text: Figure 1 Cross-reference links and e-mail addresses Medium blue, underlined text (http://www.hp.
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.
1 HBA features This chapter describes the features of the A6826A PCI-X HBA for Linux includes: • Performance specifications, page 9 • Environmental specifications, page 9 • Physical specifications, page 10 Performance specifications The A6826A HBA is a 2GB, high-performance Direct Memory Access (DMA) bus master host adapter designed for high-end systems.
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 Installing the HBA This chapter describes the procedure for installing the A6826A HBA. This chapter includes: • Installation prerequisites, page 12 • Installing the HBA, page 13 See the host documentation for installing the HBA. CAUTION: 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.
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 HBA. Check the HBA and record its serial number, in the unlikely event that the NVRAM is corrupted. HBA components Figure 1 shows the HBA components that are referenced throughout this chapter.
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. Before you begin installation The HBA is self-configuring. However, some motherboards require manual configuration.
11.Apply the power: a. Verify that the HBA is securely installed in the computer. b. Verify that the correct media is attached. c. Plug in and turn on the computer. d. Observe LEDs for Power On Self Test (POST) results. See ”POST conditions and results” on page 25 for information about the LED indicators.
3 Installing the Linux driver This chapter provides instructions for installing the Linux qla2300 driver for the A6826A HBA on an already installed Red Hat Enterprise Linux (Red Hat EL) or SUSE Linux Enterprise Server (SUSE SLES) for 64-bit Itanium systems. The software kit for this HBA can be obtained from the HP web site: http://h18006.www1.hp.com/storage/saninfrastructure.html.
Installing the driver kit HP recommends installing the complete driver kit for this HBA. The kit contains the HBA driver and the utilities that you need to deploy the A6826A HBA on Linux. NOTE: Using the following procedure installs the RPM and fibreutils. To install the complete HP driver kit: 1. Copy the .gz file to your system. 2. Enter the following commands: # tar -zxvf hp_qla2x00.tar 3. Run the set_parm script to initialize the default HBA settings. # ./set_parm 4.
Using fibreutils RPM HP recommends using the fibreutils utility that is installed by the driver kit. It contains useful utilities for managing fibre-attached storage. To manually install this RPM, enter the following command: # rpm -ivh fibreutils-.rpm For more information about fibreutils, see the file /opt/hp/hp_fibreutils/README. Changing driver parameters To change driver parameters: 1. Run the set_parm script located in the /opt/hp/src… directory. 2. Reboot the system.
Perform the following steps to install the qla2300 driver on the boot drive: 1. Build the driver binary file. To build a driver binary from source files, see ”Building a driver from sources” on page 31. 2. Copy the qla2300.o binary file to the following directory: /lib/modules//kernel/drivers/scsi 3. At the command prompt, enter the following command to update the module dependency: # depmod -a The qla2300 driver is now installed on your boot drive.
4. Build the ramdisk image file: • For a single-processor system, enter the following commands, replacing x.x.xx–x.x with your Linux version number: /sbin/mkinitrd /boot/newinitrd-image x.x.xx-x.x • For a multiprocessor system, enter the following commands, replacing x.x.xx–x.x with your Linux version number. /sbin/mkinitrd /boot/newinitrd-image x.x.xx-x.xsmp 5. Configure the boot loader with the new ramdisk image: a. Modify the elilo.
e. If your system has a previous version of the qla driver, rename the old binary included in the original distribution to ensure that it does not interfere with the updated version as follows: # cd /lib/modules//kernel/ drivers/addon/qla2300 # mv qla2300.o qla2300_rh.o After renaming the older driver version, load the new driver using modprobe after updating the dependency file. 2.
Driver command line parameters Several command line options are available. For example: • Verbose —This option provides detailed debug information. For example: # insmod qla2300.o options = verbose Waiting for LIP to complete.... scsi%d: Topology - %s, Host Loop address 0x%x scsi(%d): LIP occurred scsi(%d): LIP reset occurred • Quiet—This option keeps the driver from displaying. For example: # insmod qla2300.
Installing the Linux driver
4 Troubleshooting This chapter includes the following information to help you determine why the HBA is not functioning properly.
Hardware problem checklist Check the following to determine if there is a hardware problem: • Are all of the circuit cards installed securely in the system? • Are all of the cables securely connected to the correct connectors? Be sure that the FC cables that attach from the HBA connectors to the device are connected correctly. For example, the optical transmit connector on the HBA must be connected to the optical receive connector on the device. Some connectors require a firm push to ensure proper seating.
POST conditions and results Figure 1 on page 12 shows the position of the POST LED indicators. If the LEDs indicate a failure during POST: 1. Make sure the HBA is seated firmly in the PCI slot. 2. Verify that the fiber cable connection to the HBA is secure. 3. Check the POST LED states listed in to determine the HBA status. .
Troubleshooting
A Configuring the HBA This appendix describes how to configure the A6826A HBA on Linux systems using the Configuration protocol Driver Configuration menu. NOTE: This process is for advanced users who want to customize the configuration of the A6826A HBA and the connected devices.
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.
Table 5 describes the Driver Configuration components. Table 5 Driver 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 WWN database in table form. 6.
Table 5 Driver Configuration menu components (continued) Menu Option Description Information 30 10. Abandon Abandons the changes in the current Configuration protocol local buffer and reloads its contents from the HBA’s NVRAM. 11. Write Writes the current Configuration protocol local buffer to the HBA’s NVRAM. Use this function any time you use a menu selection to modify configuration data.
B Building a driver from sources This appendix describes how to build a Linux driver from sources. In some cases, it may be necessary to build the driver in your configuration locally. These instructions for building the driver are required only if the driver was not installed from the driver kit or from the HP driver RPM.
Building a uniprocessor version of the driver Perform the following steps to build a uniprocessor version of the qla2300 driver: 1. If not already installed, extract the kernel-header and kernel-source RPM files from your Linux CD-ROM distribution. For example: # cd /mnt/cdrom/RedHat/RPMS # rpm -iv kernel-headers*.rpm # rpm -iv kernel-source*.rpm 2.
Building a multiprocessor version of the driver Perform the following steps to build an SMP version of the qla2300 driver: 1. If not already installed, extract the kernel-header and kernel-source RPM files from your Linux CD-ROM distribution. For example: # cd /mnt/cdrom/RedHat/RPMS # rpm -iv kernel-headers*.rpm # rpm -iv kernel-source*.rpm 2. Change to the Linux source directory. • For Red Hat, enter: # cd /usr/src/linux-2.4 • For SUSE SLES, enter: # cd /usr/src/linux 3.
Building a driver from sources
C Regulatory compliance and safety Laser device All HP systems equipped with a laser device comply with safety standards, including International Electrotechnical Commission (IEC) 825. With specific regard to the laser, the equipment complies with laser product performance standards set by government agencies as a Class 1 laser product. The product does not emit hazardous light.
Laser product label The optional label in Figure 2 or equivalent may be located on the surface of the HP-supplied laser device. This optional label indicates that the product is classified as a CLASS 1 LASER PRODUCT. This label may appear on the laser device installed in your product.
BSMI notice Japanese notice Korean notices A6826A PCI-X host bus adapter for Itanium Linux systems installation guide 37
Electrostatic discharge To prevent damage to the system, be aware of the precautions you need to follow when setting up the system or handling parts. A discharge of static electricity from a finger or other conductor may damage system boards or other static-sensitive devices. This type of damage may reduce the life expectancy of the device. To prevent electrostatic damage, observe the following precautions: • Avoid hand contact by transporting and storing products in static-safe containers.
Index A European Union, regulatory compliance notice 36 audience 5 authorized reseller, HP 7 F B boot drive, installing drivers on 17 BSMI, regulatory compliance notice 37 C certification and classification information, laser 35 Class A equipment, Canadian compliance statement 36 configuring HBAs on Linux 27 conventions document 6 text symbols 6, 35 D document conventions 6 prerequisites 5 related documentation 5 documentation, HP web site 5 drivers building multiprocessor version 33 building uniproce
J Japan, regulatory compliance notice 37 K Korean, regulatory compliance notice 37 L label, laser 36 laser international certification and classification information 35 product label 36 radiation, warning 35 LED states 25 Linux configuring HBAs 27 installing drivers on boot drive 17 loading drivers 18 qla2300 driver 15 M multiprocessor driver 33 P parameters, changing 17 PCI-X bus slots master 13 slave 13 POST LED states 25 prerequisites 5 preventing electrostatic damage 38 problems configuration 24 Fib
