Installation Guide hp StorageWorks FCA2214/FCA2214DC PCI-X Host Bus Adapters for Linux, NetWare, and Windows Third Edition (July 2004) Part Number: AA–RSBMC–TE This guide describes how to install, configure, and troubleshoot the HP StorageWorks FCA2214/FCA2214DC PCI-X host bus adapters for Linux and Microsoft Windows and the FCA2214 PCI-X host bus adapter for Novell NetWare.
© Copyright 2003–2004 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 3 Installing the Linux Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23 Installing the Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Building a Driver from the Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 Building a Uniprocessor Version of the Driver. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents B Regulatory Compliance Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51 Federal Communications Commission Notice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 Class A Equipment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 Declaration of Conformity for Products Marked with the FCC Logo—United States Only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents 6 FCA2214/FCA2214DC PCI-X Host Bus Adapters for Linux, NetWare, and Windows Installation Guide
about this guide About this Guide This installation guide provides information to help you: ■ Install the FCA2214/FCA2214DC About this GuideHBA. ■ Contact technical support for additional assistance.
About this Guide Overview This section covers the following topics: ■ Intended Audience ■ Related Documentation ■ Related Documentation Intended Audience This book is intended for use by system administrators who are experienced with the following: ■ Linux operating system ■ NetWare operating system ■ Windows 2000 and Windows 2003 Server operating systems ■ Host bus adapters Related Documentation In addition to this guide, HP provides the HP StorageWorks FCA2214/FCA2214DC PCI–X Host Bus Adapt
About this Guide Conventions Conventions consist of the following: ■ Document conventions ■ Text symbols ■ Equipment symbols Document conventions This document follows the conventions in Table 1.
About this Guide Tip: Text in a tip provides additional help to readers by providing nonessential or optional techniques, procedures, or shortcuts. 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.
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 Getting help If you still have a question after reading this guide, contact an HP authorized service provider or access our web site: http://www.hp.com. HP technical support Telephone numbers for worldwide technical support are listed on the following HP web site: http://www.hp.com/support/. From this web site, select the country of origin. Note: For continuous quality improvement, calls may be recorded or monitored.
Adapter Features 1 This chapter describes the features of the FCA2214/FCA2214DC Fibre Channel Host Bus Adapters (HBAs) for Linux and Windows and the FCA2214 HBA for NetWare. Note: The FCA2214DC HBA is not supported on NetWare.
Adapter Features Adapter Features The FCA2214/FCA2214DC HBAs are 2-Gb, high-performance Direct Memory Access (DMA) bus master host adapters designed for high-end systems. The performance is derived from the ISP2312 chips.
Adapter Features Environmental 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% Adapter Specifications Table 3 lists the HBA specifications.
Adapter Features Table 3: HBA Specifications (Continued) Type Specification 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) 16 Single Channel ~4.75 Watts Dual Channel ~10.
Installing the Adapter 2 This chapter describes the procedure for installing the FCA2214/FCA2214 DC Host Bus Adapters (HBAs). This chapter includes: ■ Installation Prerequisites, page 18 ■ Installing the Adapter, page 21 ■ Installation Considerations, page 22 Refer to your host documentation for installing the HBA. WARNING: Disconnect the host from the power source before installing the HBA.
Installing the Adapter 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. Adapter Components Figure 1 shows the HBA components that are referenced throughout this chapter. 3 1 2 1. 2.
Installing the Adapter LED Indicators Figure 2 identifies the location of the HBA LEDs and the J1 connector. 1 2 3 1. 2. Amber LED Green LED 3. J1 Connector Figure 2: LED Indicators and Connectors Table 4 identifies and describes the activity of the LED indicators.
Installing the Adapter 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 2–3 of the J3 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. See the documentation supplied with your computer, or contact your computer dealer to determine if your motherboard requires configuration.
Installing the Adapter Installing the Adapter To install the HBAs: 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 Adapter Installation Considerations If your system has an IDE hard disk, it may be assigned device number 80, which is the boot device. If your system does not have an IDE hard disk, a parallel SCSI HBA, or a RAID HBA, the first bootable FC hard disk configured (the one with the lowest ID) is assigned device number 80 and becomes the boot device. This HBA BIOS must be enabled if the boot device is connected to it.
Installing the Linux Driver 3 This chapter provides instructions for installing the Linux driver for the FCA2214/FCA2214DC on an already installed Linux Red Hat and SuSE SLES 7 operating system. The software kit that is included with the HBA contains the latest version of the software files at the time of shipment. Software files are updated periodically and can be obtained from the HP web sitee: http://www.hp.com/country/us/eng/prodserv/storage.html.
Installing the Linux Driver Installing the Driver 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.
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 Installing the Driver on the Boot Drive Note: The FCA2214/FCA2214DC HBA must be installed in the system before installing the qla2300 driver. 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 section Building a Driver from the Sources in this chapter. 2. Copy the qla2300.o binary file to the /lib/modules/ /kernel/drivers/scsi directory. 3.
Installing the Linux Driver 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//drivers/scsi. Note: The is the Linux kernel, release, and version of your system. 3. Add the dependency for the qla2300 driver and build the ramdisk image: You can either run depmod -a or make sure the following line is in the /lib/modules//modules.
Installing the Linux Driver For the GRand Unified Bootloader (GRUB), perform these steps: a. Add the following line to one of the kernel entry sections in the /etc/grub.conf file to use the ramdisk image: initrd /boot/ 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. For Redhat 7.2 with kernel 2.4.9-21 or later, 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 2. Enter the following command: #lilo 3. Reboot the system. For GRUB, perform the following steps: 1. Append the max_scsi_luns parameters to each of the kernel images listed in the /etc/grub.conf file. For example: kernel /vmlinux-2.4.7-10 ro root=/dev/hda2 max_scsi_luns=128 2. Reboot the system. Driver Command Line Parameters The following command line options are available: ■ Verbose —This option provides detailed debug information. For example: # insmod qla2300.
Installing the Windows Driver 4 This chapter provides instructions for installing the Windows driver for the FCA2214/FCA2214DC adapter’s HP2300.SYS driver on an already installed Windows 2000 or Windows 2003 Server operating system. The software kit that is included with the HBA contains the latest version of the software files at the time of shipment. Software files are updated periodically and can be obtained from the HP website: http://www.hp.com/country/us/eng/prodserv/storage.html.
Installing the Windows Driver Installing a New Windows Driver The FCA2214/FCA2214DC HBAs are plug-and-play devices that are automatically detected by Windows operating systems. Note: For the FCA2214DC, the Windows Device Manager detects and displays two instances of the HBA. You must install the driver for each instance. Therefore, for the FCA2214DC, you must perform the following steps twice, once for each instance of the HBA displayed by the Device Manager.
Installing the Windows Driver If you are adding additional HBAs to the system, or if you are installing the FCA2214DC, Windows detects another device when the system reboots. The Found New Hardware with FCA2214 PCI Fibre Channel Adapter message displays. Perform the following steps to complete the driver installation: 1. When the Insert Disk message displays, make sure the CD-ROM is inserted and click OK. 2. Click Finish in the Found New Hardware Wizard/Completing the Found New Hardware Wizard screen. 3.
Installing the Windows Driver Updating an Existing Windows Driver Note: For the FCA2214DC, the Windows Device Manager detects and displays two instances of the HBA. You must install the driver for each instance. Therefore, for the FCA2214DC, you must perform the following steps twice, once for each instance of the HBA displayed by the Device Manager. Perform the following steps to update the Windows driver: 1. Choose Start >Settings > Control Panel >System. 2.
Installing the NetWare Driver 5 This chapter provides instructions for installing the NetWare driver in an already installed NetWare system.
Installing the NetWare Driver NetWare Driver Files and Parameters For this adapter to function properly with the Modular Smart Array 1000 (MSA1000), cpqshd.cdm version 0.200 or later has to be loaded on the server. When loading the QL2300.HAM driver, the driver switches listed in Table 5 are required. They are added automatically if you install your driver with the NWCONFIG utility.
Installing the NetWare Driver Installing the Driver Note: The QL2300.HAM driver may not be compatible with NetWare versions earlier than v4.2. This section provides instructions for installing the QLA2300 driver into a NetWare operating system. To install the driver, you must be familiar with the NetWare operating system and have access to standard system documentation. To install the NetWare driver in a previously installed NetWare 5.1 or 6.
Installing the NetWare Driver 12. Choose Select/Modify Driver Parameters and enter the slot number. If you have only one HBA in your server, this parameter is ignored. However, you must specify a valid number during installation. Other driver parameters can be changed at this point. For the MSA1000, you should not change any of the parameters listed in Table 5, except the values for PORTDOWN and MAXLUNS to fit your environment. Please refer to the README.
Troubleshooting 6 Three basic types of installation problems can cause your FCA2214/FCA2214DC HBA to function incorrectly: hardware problems, system configuration problems, or Fibre Channel problems. The following section provides checklists to help you determine why your HBA is not functioning.
Troubleshooting Hardware Problem Checklist 40 ■ 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.
Troubleshooting System Configuration Problems If you have problems with the motherboard connection, your 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.
Troubleshooting 42 FCA2214/FCA2214DC PCI-X Host Bus Adapters for Linux, NetWare, and Windows Installation Guide
A Fast!UTIL This appendix provides detailed configuration information for advanced users who want to customize the configuration of the FCA2214/FCA2214DC HBA and the connected devices. This HBA can be configured using Fast!UTIL, HP’s BIOS-resident configuration tool. Access Fast!UTIL by pressing ALT+Q during the HBA BIOS initialization (it may take a few seconds for the Fast!UTILOptions menu to display). If you have more than one HBA, Fast!UTIL asks you to select the HBA you want to configure.
Fast!UTIL Configuration Settings The first selection on the Fast!UTIL Options menu is Configuration Settings. These settings configure the Fibre Channel devices and the HBA to which they are attached. Host Adapter Settings From the Configuration Settings menu in Fast!UTIL, select Host Adapter Settings.
Fast!UTIL Selectable Boot Settings This option enables you to select the node name from which you want to boot. Once enabled, this option forces the system to boot on the selected FC hard disk, ignoring any IDE hard disks attached to your system. If you disable this option, the system looks for a boot device (as selected in the system BIOS). In disabled mode, the Boot ID and Boot LUN parameters have no effect.
Fast!UTIL Table 7: Advanced Adapter Settings (Continued) Setting Options Default Login Retry Count 0–255 8 Port Down Retry Count 0–255 16 Drivers Load RISC Code Enabled, Disabled Enabled Enable Database Updates Yes, No No Disable Database Load Yes, No No IOCB Allocation 1–512 buffers 256 buffers Extended Error Logging Enabled, Disabled Disabled The following section describes the settings: 46 ■ Execution Throttle—This setting specifies the maximum number of commands executing on
Fast!UTIL ■ Port Down Retry Count—This setting specifies the number of times the software retries a command to a port returning port down status. The default is 8 retries. ■ Drivers Load RISC Code—When this setting is Enabled, the HBA uses the RISC firmware that is embedded in the software driver. When this setting is Disabled, the software driver loads the RISC firmware that is stored in the HBA BIOS. The default is Enabled. — The driver being loaded must support this setting.
Fast!UTIL Extended Firmware Settings From the Configuration Settings menu in Fast!UTIL, select Extended Firmware Settings.
Fast!UTIL The following section describes the settings: ■ Extended Control Block—This setting enables all other extended firmware settings. The default is Enabled. ■ RIO Operation Mode—This setting specifies the reduced interrupt operation (RIO) modes, if supported by the software driver. RIO modes allow posting multiple command completions in a single interrupt (see step 9). The default is 0.
Fast!UTIL ■ Command Reference Number—This setting is reserved. The default is Disabled. ■ Read Transfer Ready—This setting is reserved. The default is Disabled. ■ Response Timer—This setting contains the value (in 100-microsecond increments) used by a timer to limit the time waiting accumulating multiple responses. For example, if this field is 8, the time limit is 800 microseconds. The default is 0.
Regulatory Compliance Notices B This appendix covers the following topics: ■ Federal Communications Commission Notice, page 52 ■ Declaration of Conformity for Products Marked with the FCC Logo—United States Only, page 53 ■ Class A Equipment, page 54 ■ Laser Devices, page 55 FCA2214/FCA2214DC PCI-X Host Bus Adapters for Linux, NetWare, and Windows Installation Guide 51
Regulatory Compliance Notices Federal Communications Commission Notice Part 15 of the Federal Communications Commission (FCC) Rules and Regulations has established Radio Frequency (RF) emission limits to provide an interference-free radio frequency spectrum. Many electronic devices, including computers, generate RF energy incidental to their intended function and are, therefore, covered by these rules.
Regulatory Compliance Notices Declaration of Conformity for Products Marked with the FCC Logo—United States Only This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) this device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation. For questions regarding your product, contact: Hewlett-Packard Company 3000 Hanover St.
Regulatory Compliance Notices Class A Equipment This Class A digital apparatus meets all requirements of the Canadian Interference-Causing Equipment Regulations. Cet appareil numérique de la classe A respecte toutes les exigences du Règlement sur le matériel brouilleur du Canada.
Regulatory Compliance Notices Laser Devices 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; the beam is totally enclosed during all modes of customer operation and maintenance.
Regulatory Compliance Notices 56 FCA2214/FCA2214DC PCI-X Host Bus Adapters for Linux, NetWare, and Windows Installation Guide
Electrostatic Discharge 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 adapters components 18 installing 21 before you begin 20 BIOS 21 considerations 22 prerequisites 18 specifications 15 audience 8 authorized reseller, HP 12 document conventions 9 related documentation 8 drivers HP2300.SYS 32 QL2300.
Index features complies with 14 Fabric Loop Attach (FLA) 14 Fast!UTIL 14 Fibre Channel Protocol Manager (FPM) 14 Fibre Channel Protocol-SCSI 14 Private Loop Direct Attach (PLDA) 14 safety warnings 55 Linux installing driver 24 building a driver from the sources 24 installing the driver on the boot drive 26 loading the driver 26 qla2300 driver 24 G M getting help 12 grounding methods 58 modifications, FCC compliance statement 53 H NetWare installing the driver 37 NWCONFIG utility 36 help, obtaining
Index S specifications adapters 15 environmental 15 symbols in text 9 on equipment 10 T technical support, HP 12 text symbols 9 troubleshooting configuration problems 41 fibre channel problems 41 hardware problems 40 U updating Windows driver 34 W warning symbols on equipment 10 web sites, HP storage 12 Windows installing new drivers 32 updating drivers 34 FCA2214/FCA2214DC PCI-X Host Bus Adapters for Linux, NetWare, and Windows Installation Guide 61
Index 62 FCA2214/FCA2214DC PCI-X Host Bus Adapters for Linux, NetWare, and Windows Installation Guide
