Installation Guide hp StorageWorks A6826A PCI-X Host Bus Adapter for Linux 64-bit Systems Second Edition (November 2003) Part Number: AA–RV12A–TE This guide describes how to install, configure, and troubleshoot the HP StorageWorks A6826A PCI-X host bus adapter for Linux 64-bit Itanium operating systems. For the latest version of these Release Notes and other host bus adapter documentation, access the HP storage website at http://h18006.www1.hp.com/storage/saninfrastructure.html.
© Copyright 2003 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 Contents About this Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7 Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Changing Driver Parameters for HP StorageWorks XP Systems . . . . . . . . . . . . . . . . . . Changing Parameters with a Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Changing Parameters Manually. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Building a Driver from the Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Building a Uniprocessor Version of the Driver . . . . . . . . . .
Contents C Electrostatic Discharge. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47 Grounding Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49 Figures 1 A6826A components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents 6 A6826A PCI-X Host Bus Adapter for Linux 64-bit Systems Installation Guide
about this guide About this Guide This installation guide provides information to help you: ■ Install the A6826A PCI–X About to thisFibre Guide Channel Host Bus Adapter for Linux. ■ Contact technical support for additional assistance.
About this Guide Overview This section covers the following topics: ■ Intended Audience ■ Related Documentation Intended Audience This book is intended for use by system administrators who are experienced with the following: ■ Linux operating system ■ Host bus adapters Related Documentation In addition to this guide, HP provides HP StorageWorks A6826A PCI–X Host Bus Adapter for Linux Release Notes.
About this Guide Conventions Conventions consist of the following: ■ Document Conventions ■ Text Symbols ■ Equipment Symbols Document Conventions The document conventions included in Table 1 apply in most cases.
About this Guide Caution: Text set off in this manner indicates that failure to follow directions could result in damage to equipment or data. Note: Text set off in this manner presents commentary, sidelights, or interesting points of information. Equipment Symbols The following equipment symbols may be found on hardware for which this guide pertains. They have the following meanings.
About this Guide Power supplies or systems marked with these symbols indicate the presence of multiple sources of power. WARNING: To reduce the risk of personal injury from electrical shock, remove all power cords to completely disconnect power from the power supplies and systems. Any product or assembly marked with these symbols indicates that the component exceeds the recommended weight for one individual to handle safely.
About this Guide Be sure to have the following information available 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 HP Storage Website The HP website has the latest information on this product, as well as the latest drivers. Access storage at: http://www.hp.com/country/us/eng/prodserv/storage.html.
Adapter Features 1 This chapter describes the features of the A6826A Fibre Channel Host Bus Adapters (HBAs) for Linux and includes: ■ Performance Specifications, page 14 ■ Environmental Specifications, page 15 ■ Physical Specifications, page 16 A6826A PCI-X Host Bus Adapter for Linux 64-bit Systems Installation Guide 13
Adapter Features Performance Specifications The A6826A HBA is a 2-Gb, high-performance Direct Memory Access (DMA) bus master host adapter designed for high-end systems. The performance is derived from the ISP2312 chips.
Adapter Features Environmental Specifications Table 2 lists the HBA environmental specifications.
Adapter Features Physical Specifications Table 3 lists the HBA specifications. Table 3: HBA Specifications Type Specification Host bus Conforms to PCI Local Bus Specification, Revision 2.
Installing the Adapter 2 This chapter describes the procedure for installing the A6826A Host Bus Adapter (HBA). This chapter includes: ■ Installation Prerequisites, page 18 ■ Installing the Adapter, page 22 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.
Installing the Adapter Installation Prerequisites Before you begin, make sure you have the following: 18 ■ 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 Adapter Adapter Components Figure 1 shows the HBA components that are referenced throughout this chapter.
Installing the Adapter LED Indicators Table 4 identifies and describes the activity of the LED indicators. Table 4: LED Indicators Activity Green LED Amber LED (2Gb) (1Gb) Comments Activity Off Off Power Off On On Power On (before firmware initialization) 1 Flash/s 1 Flash/s Both flashing at the same time like a heart beat. Power ON (after firmware initialization) 2 Flash/s 2 Flash/s Alternate flashing. This state changes to not-initialized state in 2-3s. Both LEDs are ON steadily.
Installing the Adapter Some motherboards have two kinds of PCI bus slots: master and slave. The AB68A6A must be in a PCI bus master slot. (Some motherboards have PCI bus master slots that are shared with onboard devices. The AB68A6A does not work in shared slots.) PCI connectors vary among system adapter manufacturers. The AB68A6A 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.
Installing the Adapter Installing the Adapter 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 this slot. 6.
Installing the Linux Driver 3 This chapter provides instructions for installing the Linux driver for the A6826A 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 HP website: http://h18006.www1.hp.com/storage/saninfrastructure.html. This section provides instructions for installing the qla2300 driver into a Linux operating system.
Installing the Linux Driver Installing the Driver RPM 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 prebuilt driver binaries, source code, and driver startup utilities. They are available for Red Hat ELAS and SUSE SLES. To install a RPM, copy the RPM package file to your system and enter the following command: # rpm -ivh < package_name>.
Installing the Linux Driver Changing Driver Parameters for HP StorageWorks XP Systems If you are using the failover functionality built into the qla2x00 driver for HP XP storage arrays, you must change certain driver parameters. To do so, you can either run a script or manually make the changes. Changing Parameters with a Script 1. Enter the following command: # hp_fccfg.sh 2. Choose option 6. 3. Enter Y when prompted if you want to enable failover functionality 4.
Installing the Linux Driver Building a Driver from the Sources If your Linux kernel version does not match the prebuilt driver binaries, you need to build the driver in your configuration locally. To build a single-processor version of the qla2300 driver, see the section Building a Uniprocessor Version of the Driver on page 26. To build a symmetric multiprocessor (SMP) version of the qla2300 driver, see the section Building a Multiprocessor Version of the Driver on page 27.
Installing the Linux Driver 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.
Installing the Linux Driver 6.
Installing the Linux Driver Installing the Driver on the Boot Drive Note: The following instructions for installing the driver and loading and unloading the driver are required only if the driver has been built from source. If the driver binary was installed from the RPM, the driver loads at boot time. Before installing the driver, note the following: ■ The A6826A HBA must be installed in the system before installing the qla2300 driver.
Installing the Linux Driver Loading the Driver The qla2300 driver must be loaded before the system can access the devices attached to the A6826A HBA. To build a ramdisk image to automatically load the qla2300 driver at boot time, see the section Building a Ramdisk Image to Load the qla2300 Driver on page 30. To load the qla2300 driver manually, see the section Loading and Unloading the qla2300 Driver Manually on page 31.
Installing the Linux Driver 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.conf file to load the new ramdisk image by changing the following line: initrd=/boot/initrd_file_name For example: initrd=/boot/newinitrd-image b. Reboot the system. Select the kernel with the new ramdisk image.
Installing the Linux Driver Note: HP recommends loading the driver using the modprobe command so that any driver parameter value specified in the /etc/modules.conf file takes effect. 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.
Installing the Linux Driver System Driver Parameter max_scsi_luns Support for multiple LUNs can be configured in one of three ways. Currently, the maximum number of LUNs that can be scanned for each device is 128. Note: If you have multiple HBAs, set max_scsi_luns to the largest number of LUNs supported by any one of these HBAs.
Installing the Linux Driver Driver Command Line Parameters The following command line options are available: ■ 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 Proc Filesystem Support The /proc file system for the QLA2300 driver can be found in the /proc/scsi/qla2300/ directory. This directory contains an entry for each SCSI HBA in the system. Each entry presents information about the adapter and transfer statistics for each discovered LUN.
Installing the Linux Driver 36 A6826A PCI-X Host Bus Adapter for Linux 64-bit Systems Installation Guide
Troubleshooting 4 Three basic types of installation problems can cause the A6826A HBA to function incorrectly. This chapter includes: ■ Hardware Problem Checklist, page 37 ■ System Configuration Problems, page 38 ■ Fibre Channel Problem Checklist, page 38 The following sections provides checklists to help you determine why the HBA is not functioning properly.
Troubleshooting System Configuration Problems If you have problems with the motherboard connection, the adapter may not function properly. All PCI-compliant and PCI-X–compliant systems automatically detect 32-bit or 64-bit adapters and set the appropriate bus speed (for example, 33 MHz or 133 MHz). Check the motherboard for proper configuration. See the documentation supplied with your computer, or contact your computer dealer to determine if your motherboard requires special configuration.
Configuring Adapters A This appendix describes how to configure the A6826A HBA. The A6826A functions correctly on Linux Itanium systems using the factory default configuration settings. If you are an advanced user, you may change the configuration using the efiutil utility.
Configuring Adapters Using the efiutil Utility To configure the HBA, use the efiutil utility as follows: 1. Use the fibreutils RPM package to obtain efiutil (efiutil.efi) and the auxiliary driver, efiaux.drv as described in “Installing the fibreutils RPM” on page 24. 2. Power on the server to the EFI shell. 3. Start efiutil as follows (efiaux.drv is automatically loaded if it is needed): a. Set the drive to the boot device ( for example, fs1:). b. Change to the directory containing efiutil.
Configuration Commands B This appendix describes the efiutil commands for advanced users who want to customize the configuration of the A6826A HBA and the connected devices. Note: As described in Using the efiutil Utility, page 40 use efiutil menu to configure the HBA.
Configuration Commands NVRAM Parameter Commands Use the following parameters to change NVRAM. edit_adapter_settings Used to display and modify the adapter settings.
Configuration Commands edit_advanced_settings Used to display and modify the advanced adapter settings.
Configuration Commands Information Commands help This command displays a brief list of available commands. info Displays the following adapter information: ■ efi device path (Use to determine which adapter configuration is being displayed.) ■ port wwn (wwpn) ■ serial number ■ ssvid and ssdid from nvram show_database Displays the contents of the WWN database in table form. show_translation Displays the scsi target id translation table.
Configuration Commands show_buffer Displays the contents of the local NVRAM buffer in hexadecimal for the local buffer containing changes made prior to using the write command to commit them to the adapter NVRAM.
Configuration Commands Operation Commands abandon Abandons the changes in the current configuration protocol local buffer and reloads its contents from the adapter NVRAM. write Writes the current configuration protocol local buffer to the adapter NVRAM. Use this command any time a command has been used to modify configuration data. When the NVRAM has been successfully written, the configuration protocol local buffer is reloaded from the adapter NVRAM.
Electrostatic Discharge C C To prevent damaging the system, you must take precautions when setting up the system or when handling parts. A discharge of static electricity from a finger or other conductor may damage system adapters or other static-sensitive devices. This type of damage can 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.
Electrostatic Discharge Grounding Methods There are several methods for grounding. Use one or more of the following methods when handling or installing electrostatic-sensitive parts: ■ Use a wrist strap connected by a ground cord to a grounded workstation or computer chassis. Wrist straps are flexible straps with a minimum of 1 megohm ± 10 percent resistance in the ground cords. To provide proper grounding, wear the strap snug against the skin.
index A D abandon command 46 adapters components 20 configuring 40 environmental specifications 15 installation prerequisites 18 installing 20, 22 performance specifications 14 physical specifications 16 audience 8 authorized reseller, HP 12 document, conventions 9 drivers changing parameters on XP systems 25 efiaux.
Index G Q getting help 11 grounding methods 48 qla2300 driver 23 quit command 46 H R help command 44 help, obtaining 11 HP authorized reseller 12 storage website 12 technical support 11 Red Hat building drivers 27 builiding a Ramdisk image 30 ELAS RPM packages 24 related documentation 8 RPM packages building a multiprocessor driver 27 building a uniprocessor driver 26 fibreutils 24, 40 installing 24 I installing adapters 20, 22 prerequisites 18 RPM packages 24 S L Linux installing driver building
Index W X warning, symbols on equipment 10 write command 46 WWN, editing 43 XP systems, changing driver parameters 25 A6826A PCI-X Host Bus Adapter for Linux 64-bit Systems Installation Guide 51
Index 52 A6826A PCI-X Host Bus Adapter for Linux 64-bit Systems Installation Guide