background image

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

Summary of Contents for StorageWorks Q2300

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

Page 2: ...tocopied 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...

Page 3: ...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 mu...

Page 4: ...es 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...

Page 5: ...ument 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 Lin...

Page 6: ...um 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 comma...

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

Page 8: ...8 ...

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

Page 10: ...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 C...

Page 11: ...a 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 meter...

Page 12: ...Q2300 HBA features 12 ...

Page 13: ...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 multimo...

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

Page 15: ...nging 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 ...

Page 16: ...r 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...

Page 17: ...nium 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 ...

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

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

Page 20: ...ivers 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 manu...

Page 21: ...OTE You must reboot Otherwise you may not be able to unload the qla2200 and or qla2300 drivers if there is a process or file system using a device that is attached to the Q2300 HBA Building a driver from the sources IMPORTANT The following instructions are for reference only Use these instructions only if the driver was not installed from the driver kit or from the HP driver RPM To build a single ...

Page 22: ... 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 Red Hat EL enter make For SUSE SLES enter make OSVER linux 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 ...

Page 23: ...urce files If you installed the driver RPM the driver source files reside in opt hp If you copied your drivers from other media copy the qla2x00src vx xx tgz file to the home qla2x00 directory For example if you 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 6 Build the qla2300 driver from...

Page 24: ...eps 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 21 2 Copy the qla2300 o binary file to the following directory lib modules kernel_release_version kernel drivers scsi 3 At the command prompt enter the following command to update the module dependency depmod a The ...

Page 25: ...ifferent alias for example scsi_hostadapter n The n is a number in the range 1 to 9 2 Build a new ramdisk image that contains the qla2300 o object file You must copy the driver binary file qla2300 o to lib modules kernel_release_version drivers scsi NOTE The kernel_release_version is the Linux kernel release version of your system 3 Add the dependency for the qla2300 driver and build the ramdisk i...

Page 26: ...ding the qla2300 driver manually Before loading the driver manually first build the driver from sources as described in Building a uniprocessor version of the driver on page 22 or in Building a multiprocessor version of the driver on page 22 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 e...

Page 27: ...iver enter the following command as shown in the following example modprobe r qla2300 Additional driver information System driver parameter max_scsi_luns You can configure support for multiple LUNs 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 o...

Page 28: ...gy 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 Proc file system support The proc file system for the qla2300 driver can be found in the proc scsi qla2300 directory This directory contains entries for each SCSI HBA channel in the system Each entry presents information about the ...

Page 29: ... 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 For example enter cd efi qla2300 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 ...

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

Page 31: ...ing pairs Each entry in the table consists of the following for each device SCSI id tid Fibre channel loop id lid World wide port name WWPN World wide node name 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 ar...

Page 32: ...NVRAM Use this function any time you use a menu 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 Table 5 Driver Configuration menu co...

Page 33: ... to repair the laser device Certification and classification information This product contains a laser internal to the fiber optic FO transceiver for connection to the Fibre Channel communications port In the USA the FO transceiver is certified as a Class 1 laser product conforming to the requirements contained in the Department of Health and Human Services DHHS regulation 21 CFR Subchapter J A la...

Page 34: ...roducts bearing the CE marking comply with the EMC Directive 89 336 EEC and the Low Voltage Directive 73 23 EEC issued by the Commission of the European Community and if this product has telecommunication functionality the R TTE Directive 1999 5 EC Compliance with these directives implies conformity to the following European Norms in parentheses are the equivalent international standards and regul...

Page 35: ...n guide 35 Power Quality EN61000 3 2 IEC61000 3 2 Power Line Harmonics EN61000 3 3 IEC61000 3 3 Power Line Flicker EN60950 IEC60950 Product Safety Also approved under UL 60950 CSA C22 2 No 60950 00 Safety of Information Technology Equipment BSMI notice Japanese notice ...

Page 36: ...y reduce the life expectancy of the device Preventing electrostatic damage 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...

Page 37: ...istance in the ground cords To provide proper ground 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 suggested eq...

Page 38: ...Regulatory compliance and safety 38 ...

Page 39: ...4 manually loading on Linux 26 qla2x00 19 E EFI driver updating on Linux 17 efiaux drv 29 EFIUTIL 18 efiutil efi 29 electrostatic damage prevention 36 environmental specifications 10 ESD electrostatic discharge 36 European Union regulatory compliance notice 34 F features complies with 10 Fabric Loop Attach FLA 10 Fibre Channel Protocol Manager FPM 10 Fibre Channel Protocol SCSI 10 Private Loop Dir...

Page 40: ...ly loading drivers 26 RISC firmware 17 RPM 20 set_parm script 21 starting the Configuration protocol 29 N noise declaration German 36 P parameters Linux drivers 21 PCI X bus slots master 16 slave 16 preventing electrostatic damage 36 Q qla2x00 drivers 19 R Red Hat building a Ramdisk image 25 building drivers 22 regulatory compliance notices BSMI 35 European Union 34 IEC EMC statement worldwide 34 ...

Page 41: ...l type 41 T technical support HP 7 text symbols 6 U uninstalling the RPM 20 updating Linux EFI driver 17 upgrading RISC firmware 17 RPM 20 W warnings lasers radiation 33 web sites HP documentation 5 HP storage 7 HP Subscriber s choice 7 ...

Page 42: ...42 ...

Reviews: