background image

Installing the Linux Driver

26

A6826A PCI-X Host Bus Adapter for Linux 64-bit Systems Installation Guide

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.

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. Locate the driver source files:

If you have installed the driver RPM, the driver source files reside in 

/opt/hp/storage_drivers/…

If you have copied your drivers from other media, copy the 
qla2x00src-xx.xx.tgz file to the 

/home/qla2x00 

directory. For 

example, if you have copied the driver source file on to a CD-ROM, 
enter:

# cd /home
# mkdir qla2x00
# cd /home/qla2x00
# cp /mnt/cdrom/qla* . 

(The period [.] at the end is required.)

# tar -xvzf qla*.tgz

3. Build the qla2300 driver from the sources:

For RedHat, enter:

# make

For SUSE, enter:

# make OSVER=linux

Summary of Contents for A6826A

Page 1: ...12A 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 ...

Page 2: ...ed into another language without the prior written consent of Hewlett Packard The information contained in this document is subject to change without notice Hewlett Packard Company shall not be liable for technical or editorial errors or omissions contained herein The information is provided as is without warranty of any kind and is subject to change without notice The warranties for Hewlett Packa...

Page 3: ...ical Support 11 HP Storage Website 12 HP Authorized Reseller 12 1 Adapter Features 13 Performance Specifications 14 Environmental Specifications 15 Physical Specifications 16 2 Installing the Adapter 17 Installation Prerequisites 18 Adapter Components 19 LED Indicators 20 Jumpers 20 Before You Begin Installation 20 Installing the Adapter 22 3 Installing the Linux Driver 23 Installing the Driver RP...

Page 4: ...age to Load the qla2300 Driver 30 Loading and Unloading the qla2300 Driver Manually 31 System Driver Parameter max_scsi_luns 33 Driver Command Line Parameters 34 Proc Filesystem Support 35 4 Troubleshooting 37 Hardware Problem Checklist 37 System Configuration Problems 38 Fibre Channel Problem Checklist 38 A Configuring Adapters 39 Using the efiutil Utility 40 B Configuration Commands 41 NVRAM Par...

Page 5: ...ux 64 bit Systems Installation Guide C Electrostatic Discharge 47 Grounding Methods 48 Index 49 Figures 1 A6826A components 19 Tables 1 Document Conventions 9 2 HBA Environmental Specifications 15 3 HBA Specifications 16 4 LED Indicators Activity 20 ...

Page 6: ...Contents 6 A6826A PCI X Host Bus Adapter for Linux 64 bit Systems Installation Guide ...

Page 7: ...s guide About this Guide About this Guide This installation guide provides information to help you Install the A6826A PCI X to Fibre Channel Host Bus Adapter for Linux Contact technical support for additional assistance About this Guide topics include Overview page 8 Conventions page 9 ...

Page 8: ...ing 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 ...

Page 9: ... set off in this manner indicates that failure to follow directions in the warning could result in bodily harm or death Table 1 Document Conventions Element Convention Cross reference links Blue text Figure 1 Key and field names menu items buttons and dialog box titles Bold File names application names and text emphasis Italics User input command and directory names and system responses output and...

Page 10: ...s indicates the presence of electrical shock hazards Enclosed area contains no operator serviceable parts WARNING To reduce the risk of personal injury from electrical shock hazards do not open this enclosure Any RJ 45 receptacle marked with these symbols indicates a network interface connection WARNING To reduce the risk of electrical shock fire or damage to the equipment do not plug telephone or...

Page 11: ... reduce the risk of personal injury or damage to the equipment observe local occupational health and safety requirements and guidelines for manually handling material Getting Help If you still have a question after reading this guide contact an HP authorized service provider or access our website http www hp com HP Technical Support In North America call technical support at 1 800 652 6672 availab...

Page 12: ...pe 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 From this website select the appropriate product or solution HP Authorized Reseller For the name of your nearest HP authorized reseller In the United States call 1 800 345 ...

Page 13: ...ems Installation Guide 1 Adapter Features 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 ...

Page 14: ...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...

Page 15: ...onmental Specifications Table 2 lists the HBA environmental specifications Table 2 HBA 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 non condensing 10 90 Storage humidity non condensing 5 95 ...

Page 16: ...ializer deserializer SEREDES and electrical transceivers that can auto negotiate a data rate of 1 Gbps or 2 Gbps 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 Fr...

Page 17: ...dapter 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 WARNING Electrostatic discharge ESD can damage electronic components Be sure you are properly grounded before beginning t...

Page 18: ...equisites 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 ...

Page 19: ...pter 19 A6826A PCI X Host Bus Adapter for Linux 64 bit Systems Installation Guide Adapter Components Figure 1 shows the HBA components that are referenced throughout this chapter Figure 1 A6826A components LED Indicators ...

Page 20: ...elf 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 Table 4 LED Indicators Activity Green LED 2Gb Amber LED 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 tim...

Page 21: ...mong 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 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 slo...

Page 22: ...ssign 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 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 Follow the server manufacturer s instructions 9 Connect the appropriate...

Page 23: ...ww1 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 you must perform the following Installing the Driver RPM page 24 Building a Driver fr...

Page 24: ...file to your system and enter the following command rpm ivh package_name rpm Upgrading To upgrade a RPM package copy the RPM package file to your system and enter the following command s For Red Hat ELAS enter rpm Uvh nopostun nopreun package_name rpm For SUSE SLES rpm Uvh package_name rpm Uninstalling To uninstall a RPM package enter the following command rpm e qla2x00 Installing the fibreutils R...

Page 25: ...oot or choose option 5 to reload the driver Note You may not be able to unload the qla2200 and or qla2300 modules if there is a process or file system using a device that is attached to the A6826A adapter Changing Parameters Manually 1 Edit the etc hp_qla2x00 conf file using a text editor 2 Change the failover 0 line to failover 1 3 Change the port_down_retry_count xx line to port_down_retry_count...

Page 26: ...rm 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 Locate the driver source files If you have installed the driver RPM the driver source files reside in opt hp storage...

Page 27: ... make menuconfig a Choose Processor type and features then press Enter The Processor Type and Features menu displays b Choose Symmetric Multiprocessor then press Spacebar c Click Exit The system prompts Do you wish to save your new kernel configuration d Click Yes The system saves a new config file in the current directory 4 At the command prompt enter the following make dep 5 Locate the source fi...

Page 28: ...g the Linux Driver 28 A6826A PCI X Host Bus Adapter for Linux 64 bit Systems Installation Guide 6 Build the qla2300 driver from the sources For RedHat enter make SMP 1 For SUSE SLES enter make SMP 1 OSVER linux ...

Page 29: ...n is the Linux kernel release version of your system In the following examples the path to your driver may be lib modules kernel_release_version kernel drivers addon 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 the section Building a Driver from the Sources on page 26 2 Copy the qla2300 o b...

Page 30: ...f there are other SCSI host adapter boards installed on your system and the scsi_hostadapter alias is used define a different alias for example scsi_hostadaptern n is a number in the range 1 9 2 Build a new ramdisk image that contains the qla2300 o object file The driver binary file qla2300 o must be copied to lib modules kernel_release_version drivers scsi Note The kernel_release_version is the L...

Page 31: ...ion of the Driver on page 26 or the section Building a Multiprocessor Version of the Driver on page 27 After manually loading the qla2300 driver you can access the devices and unload the driver manually without rebooting the system The driver is also unloaded each time the system is rebooted To load the qla2300 driver 1 Manually install the driver binary a Copy qla2300 o to the following directory...

Page 32: ... 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_release_version 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 To manually unload the qla...

Page 33: ...ure multiple LUN support during boot time enter the following command at the boot prompt boot linux max_scsi_luns 128 If the SCSI Mid Layer is compiled as a module add the following line to the etc modules conf file to scan for multiple LUNs at each boot options scsi_mod max_scsi_luns 128 If the SCSI Mid Layer is not compiled as a module the boot loader can be configured to scan for multiple LUNs ...

Page 34: ...ng 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 o ql2xopts quiet ...

Page 35: ...llation Guide 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 ...

Page 36: ...Installing the Linux Driver 36 A6826A PCI X Host Bus Adapter for Linux 64 bit Systems Installation Guide ...

Page 37: ...ct 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 An easy way to check for correct seating is to switch the connectors on either the HBA or the device then...

Page 38: ...xample 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 Fibre Channel Problem Checklist Were all of the FC devices powered up before you powered up the server Check that all cables are properly connected Have you configured the RAID contr...

Page 39: ...ide A Configuring Adapters 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 ...

Page 40: ...cally loaded if it is needed a Set the drive to the boot device for example fs1 b Change to the directory containing efiutil For example enter cd efi qla2x00 c Enter the file name efiutil efi Enter help at any time for information about commands d Select the adapter that you want to configure by choosing adapter e Choose configure 4 Configure the HBA s NVRAM by selecting the menu items for the par...

Page 41: ... Guide B Configuration Commands 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 ...

Page 42: ...edit_adapter_settings Used to display and modify the adapter settings This parameter produces the following sequence Adapter Settings Enable Hard Loop Id Hard Loop Id Loop Reset delay Enable Fibre Channel Tape Support Frame Size 512 1024 2048 Connection Option 0 Loop Only 1 Point To Point Only 2 Loop Preferred Otherwise Point to Point Data Rate 0 1 Gb s 1 2 Gb s 2 Auto ...

Page 43: ...ires or no activity Interrupt Delay Timer 100 ms Execution Throttle Login Retry Count Port Down Retry Count Link Down Timeout seconds LUNs per Target Enable Extended Error Logging Enable LIP Reset Enable LIP Full Login Enable Target Reset edit_database Used to display and modify entries in the WWN world wide name database edit_efi Used to display and modify the efi parameters This command produces...

Page 44: ...e contents of the WWN database in table form show_translation Displays the scsi target id translation table This table is a list of scsi tid and fibre channel loop id mapping pairs Each entry in the table consists of the following information for each device scsi id tid fc loop id lid world wide port name wwpn world wide node name wwnn All numbers are in hexadecimal The tid values from 0x00 to 0x0...

Page 45: ... Bus Adapter for Linux 64 bit Systems Installation Guide 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 ...

Page 46: ...ter 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 quit Quits the configuration and returns to the efi shell You must use the write command to commit any change...

Page 47: ...evices 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 Keep electrostatic sensitive parts in their containers until they arrive at static free workstations Place parts on a grounded surface before removing them from their containers Av...

Page 48: ...rcent resistance in the ground cords To provide proper grounding wear the strap snug against the skin Use heel straps toe straps or boot straps at standing workstations Wear the straps on both feet when standing on conductive floors or dissipating floor mats Use conductive field service tools Use a portable field service kit with a folding static dissipating work mat If you do not have any of the ...

Page 49: ...advanced_settings 43 edit_database 43 edit_efi 43 Operation abandon command 46 quit command 46 write command 46 D document conventions 9 drivers changing parameters on XP systems 25 efiaux drv 40 installing from RPM packages 24 qla2300 23 E edit_adapter_settings command 42 edit_advanced_settings command 43 edit_database command 43 edit_efi command 43 efiaux drv 40 efiutil utility configuring adapt...

Page 50: ...us slots master 21 slave 21 problems configuration 38 Fibre Channel 38 hardware 37 Q qla2300 driver 23 quit command 46 R 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 S show_buffer command 45 show_database command 44 show_translat...

Page 51: ...Index A6826A PCI X Host Bus Adapter for Linux 64 bit Systems Installation Guide 51 W warning symbols on equipment 10 write command 46 WWN editing 43 X XP systems changing driver parameters 25 ...

Page 52: ...Index 52 A6826A PCI X Host Bus Adapter for Linux 64 bit Systems Installation Guide ...

Reviews: