HP StorageWorks A6826A Installation Manual

HP StorageWorks A6826A Installation Manual

Pci-x host bus adapter for linux 64-bit systems
Hide thumbs Also See for StorageWorks A6826A:
Table of Contents

Advertisement

Quick Links

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.

Advertisement

Table of Contents
loading

Summary of Contents for HP StorageWorks A6826A

  • Page 1 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...
  • Page 2 © 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.
  • Page 3: Table Of Contents

    HP Authorized Reseller ........
  • Page 4 Contents Changing Driver Parameters for HP StorageWorks XP Systems ....25 Changing Parameters with a Script ........25 Changing Parameters Manually.
  • Page 5 Contents C Electrostatic Discharge..........47 Grounding Methods .
  • Page 6 Contents A6826A PCI-X Host Bus Adapter for Linux 64-bit Systems Installation Guide...
  • Page 7: About This 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. About this Guide Contact technical support for additional assistance. About this Guide topics include: Overview, page 8 Conventions, page 9 A6826A PCI-X Host Bus Adapter for Linux 64-bit Systems Installation Guide...
  • Page 8: Overview

    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. A6826A PCI-X Host Bus Adapter for Linux 64-bit Systems Installation Guide...
  • Page 9: Conventions

    Variables <monospace, italic font> Website addresses Blue, underlin ed sans serif font text: http://www.hp.com Text Symbols The following symbols may be found in the text of this guide. They have the following meanings. WARNING: Text set off in this manner indicates that failure to follow directions in the warning could result in bodily harm or death.
  • Page 10: Equipment Symbols

    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.
  • Page 11: Getting Help

    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, available 24 hours a day, 7 days a week.
  • Page 12: Hp Storage Website

    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. From this website, select the appropriate product or solution.
  • Page 13: Adapter Features

    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 A6826A PCI-X Host Bus Adapter for Linux 64-bit Systems Installation Guide...
  • Page 14: Performance Specifications

    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. This HBA has the following features: Combines a powerful Reduced Instruction Set Computing (RISC) processor, a Fibre Channel protocol manager (FPM) with 2-Gb Fibre Channel transceivers, and a peripheral component interconnect (PCI) or peripheral component interconnect-extended (PCI-X) local bus interface in a single-chip...
  • Page 15: Environmental Specifications

    Adapter Features Environmental Specifications Table 2 lists the HBA environmental specifications. Table 2: HBA Environmental Specifications Environment Minimum Maximum 0 °C/32 °F 55 °C/131 °F Operating temperature -20 °C/-4 °F 70 °C/158 °F Storage temperature Relative humidity (non-condensing) Storage humidity (non-condensing) A6826A PCI-X Host Bus Adapter for Linux 64-bit Systems Installation Guide...
  • Page 16: Physical 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.2 Fibre Channel Bus type: fiber optic media specifications Bus transfer rate: 200 MBps maximum at half duplex 400 MBps maximum at full duplex Interface chip: ISP2312 Central processing...
  • Page 17: Installing The Adapter

    Installing the Adapter 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.
  • Page 18: Installation Prerequisites

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

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

    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 Power Off Power On (before firmware initialization) 1 Flash/s 1 Flash/s Both flashing at the same Power ON (after firmware time like a heart beat.
  • Page 21 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.
  • Page 22: Installing The Adapter

    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.
  • Page 23: Installing The Linux Driver

    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.
  • Page 24: Installing The Driver Rpm

    To uninstall a RPM package, enter the following command: # rpm -e qla2x00 Installing the fibreutils RPM HP recommends installing the fibreutils RPM. It contains useful utilities, such as hp_fccfg.sh, for managing fibre-attached storage. To install this RPM, enter the following command: version # rpm -ivh fibreutils-<...
  • Page 25: Changing Driver Parameters For Hp Storageworks Xp Systems

    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.
  • Page 26: Building A Driver From The Sources

    # 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...
  • Page 27: Building A Multiprocessor Version Of The Driver

    # make dep 5. Locate the 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-vx.xx.tgz file to the home/qla2x00 directory. For...
  • Page 28 Installing the Linux Driver 6. Build the qla2300 driver from the sources: For RedHat, enter: # make SMP=1 For SUSE SLES, enter: # make SMP=1 OSVER=linux A6826A PCI-X Host Bus Adapter for Linux 64-bit Systems Installation Guide...
  • Page 29: Installing The Driver On The Boot Drive

    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.
  • Page 30: Loading The 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.
  • Page 31: Loading And Unloading The Qla2300 Driver Manually

    Installing the Linux Driver For a multiprocessor system, enter the following commands, replacing x.x.xx–x.x with your Linux version number. x.x.xx-x.xsmp /sbin/mkinitrd /boot/newinitrd-image 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:...
  • Page 32 Installing the Linux Driver Note: HP recommends loading the driver using the modprobe command so that any /etc/modules.conf driver parameter value specified in the file takes effect. e. If your system has a previous version of the qla driver, rename the old...
  • Page 33: System Driver Parameter Max_Scsi_Luns

    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. If you have multiple HBAs, set max_scsi_luns to the largest number of LUNs Note: supported by any one of these HBAs.
  • Page 34: Driver Command Line Parameters

    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.
  • Page 35: Proc Filesystem Support

    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.
  • Page 36 Installing the Linux Driver A6826A PCI-X Host Bus Adapter for Linux 64-bit Systems Installation Guide...
  • Page 37: Troubleshooting

    Troubleshooting 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.
  • Page 38: System Configuration Problems

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

    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. A6826A PCI-X Host Bus Adapter for Linux 64-bit Systems Installation Guide...
  • Page 40: 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.
  • Page 41: Configuration Commands

    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. efiutil Note: As described in Using the efiutil Utility, page 40 use menu to configure the HBA.
  • Page 42: Nvram Parameter Commands

    Configuration Commands NVRAM Parameter Commands Use the following parameters to change NVRAM. 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: 1024 2048...
  • Page 43: Edit_Advanced_Settings

    Configuration Commands edit_advanced_settings Used to display and modify the advanced adapter settings. This parameter produces the following sequence: Advanced Adapter Settings: Operation Mode: 0 - Interrupt for every I/O completion 5 - Interrupt when Interrupt Delay Timer expires 6 - Interrupt when Interrupt Delay Timer expires or no activity Interrupt Delay Timer(100 ms) Execution Throttle Login Retry Count...
  • Page 44: Information Commands

    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.
  • Page 45: Show_Buffer

    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. A6826A PCI-X Host Bus Adapter for Linux 64-bit Systems Installation Guide...
  • Page 46: Operation Commands

    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.
  • Page 47: C Electrostatic Discharge

    Electrostatic Discharge 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.
  • Page 48: Grounding Methods

    Use a portable field service kit with a folding static-dissipating work mat. If you do not have any of the suggested equipment for proper grounding, have an HP authorized reseller install the part. Note: For more information on static electricity, or for assistance with product installation, contact your HP authorized reseller.
  • Page 49: Index

    RPM packages installation prerequisites qla2300 installing 20, performance specifications physical specifications edit_adapter_settings command audience edit_advanced_settings command authorized reseller, HP edit_database command edit_efi command efiaux.drv components efiutil utility adapters configuring adapters jumpers parameters configuration commands efiutil.efi...
  • Page 50 SUSE SLES qla2300 driver building drivers RPM packages symbols NVRAM configuration parameters in text on equipment parameters efiutil utility technical support, HP PCI-X bus slots text symbols master troubleshooting slave configuration problems problems Fibre Channel problems configuration hardware problems...
  • Page 51 Index warning, symbols on equipment XP systems, changing driver parameters write command WWN, editing A6826A PCI-X Host Bus Adapter for Linux 64-bit Systems Installation Guide...
  • Page 52 Index A6826A PCI-X Host Bus Adapter for Linux 64-bit Systems Installation Guide...

Table of Contents