Page 1
Linux installation guide Part Number: AA-RTD1B-TE Second Edition: November 2002 This guide describes how to install, configure, and use the diagnostic utilities for the HP StorageWorks A7298A host bus adapter for Windows Advanced Server Limited Edition v1.2 and Linux platforms.
About this Guide This user guide provides information to help you: • Install, configure, and use the diagnostic utilities for the HP StorageWorks A7298A host bus adapter for Windows and Linux platforms. • Contact technical support for additional assistance Intended Audience...
Variables Monospace, italic font Website addresses Sans serif font (http://thenew.hp.com) Symbols in Text These 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 loss of life.
About this Guide Symbols on Equipment Any enclosed surface or area of the equipment marked with these symbols indicates the presence of electrical shock hazards. Enclosed area contains no operator serviceable parts. WARNING: To reduce the risk of injury from electrical shock hazards, do not open this enclosure.
Only one rack component is extended at any time. A rack may become unstable if more than one rack component is extended for any reason. Getting Help If you still have a question after reading this guide, contact an HP authorized service provider or access our website: http://thenew.hp.com.
Operating system type and revision level • Detailed, specific questions HP Website The HP website has the latest information on this product, as well as the latest drivers. http://thenew.hp.com/country/us/eng/prodserv/storage.html. Access storage at: From this website, select the appropriate product or solution.
Introduction Overview This introduction to the Host Bus Adapter (HBA) includes: • Product Description • Performance Specifications • Boot BIOS Specifications • Standards • Agency Approvals Product Description The HBA has the following characteristics: • Robust suite of software supporting Windows Advanced Server Limited Edition v1.2 and Linux Red Hat Advanced Workstation v2.1.
Introduction Figure 1–1: Host Bus Adapter Table 1–1: Host Bus Adapter Diagram Description Figure Legend Description Fibre Channel (LC) connectors. POST LEDs indicators Note: See Table 2–1 Table 4–1 for detailed descriptions. Performance Specifications The PCI-X host bus adapter offers a highly integrated 2Gbps Fibre Channel HBA for use in servers based on either PCI or the latest PCI-X expansion bus.
Introduction • Simultaneous full duplex 2 Gbps PCI bus speed data transfers of 400 MBps • Full fabric support using F_PORT and FL_Port connections • Full fabric boot support in x86 environments to multiple LUNs • FC-Tape (FC-2) devices • Point-to-point arbitrated-loop, and switch fabric FC connections •...
Attaching HBAs in a supported configuration • Enabling external boot for supported configurations In addition, the HP website has the latest information on Boot BIOS upgrades. Access the HP website at: http://www.hp.com/support/itaniumservers. Standards The HBA conforms to the following standards: •...
Introduction Agency Approvals The HBA has the following agency approvals: • CFR Title 21, Laser AEL Class 1, FDA/CDRH • UL recognized to UL1950 • CUR recognized to CSA22.2, No.950 • IEC 950 (1991) + Amendments 1, 2, 3, 4, and 11 •...
Installation Installation Overview This chapter provides step-by-step instructions for installing the HP StorageWorks A7298A Host Bus Adapter (HBA) including: • Hardware Requirements • Recording Reference Numbers • Installing the HBA into a Computer • Verifying the Installation • Configuration Guidelines This chapter also provides information on installation guidelines and supported configurations for the operating systems.
Installation Recording Reference Numbers Each HBA ships with a unique address identifier that is stored in flash memory. Fibre Channel industry standards issue two unique identifiers: WorldWide Port Name (WWPN) and Node Name (NN), each of which is derived from the HBA’s IEEE address.
Installation 8. Insert the HBA into the empty PCI or PCI-X bus slot; press firmly until it is seated securely. 9. Secure the HBA mounting bracket to the computer panel with the panel screws. 10. Replace the computer cover and secure it using the previously removed screws. 11.
Consult the following sources for any restriction and for information on supported configurations specific to your operating system and topology. • Release Notes HP Website at: http://www.hp.com/support/itaniumservers. • 2–4 host bus adapter for Windows and Linux installation guide...
• Installed HBA • Ensure the HP Setup and Configuration CD for Itanium(R) 2-based servers is in the server or the driver has been downloaded from the web and copied to the server hard drive. host bus adapter for Windows and Linux installation guide...
Installing the SCSI Miniport Driver • StorageWorks Fibre Channel Storage subsystem (interconnect device and storage device) Installing the Windows Advanced Server Limited Edition v1.2 SCSI Miniport Driver This section contains the steps for installing the Windows Advanced Server Limited Edition v1.2 SCSI Miniport device driver on a Windows Advanced Server Limited Edition v1.2 server.
Installing the SCSI Miniport Driver 2. Double-click the System icon. 3. Click Device Manager. 4. Open the SCSI and RAID controllers item in the list. 5. Click Remove. 6. Choose Yes to confirm. 7. Click OK. 8. Reboot the computer to restart Windows Advanced Server Limited Edition v1.2. Linux Device Driver Installation This section describes the instructions for installing the Linux SCSI Miniport driver.
Installing the SCSI Miniport Driver 4. Enter the following command if the file is in the format filename.rpm.Z: # tar xvzf filename.tar.Z or else untar the driver file. # tar xvf filename.tar The package unzips to one SourceBuild directory. 5. Enter the following command to change directory to the SourceBuild directory. # cd SourceBuild This becomes the driver_installation_directory.
Installing the SCSI Miniport Driver 7. Enter the following command to verify that the RPM installation was successful: # rpm -a -q | grep lpfc 8. Enter the following command to remove the RPM type: # rpm -e rpm_name 9. Enter the following command to change directory to driver_installation_directory. # cd /usr/src/<kernelsource>/drivers/scsi/lpfc Building the Driver as a Module Once you have installed the source file, you can build the driver as a module.
Installing the SCSI Miniport Driver 5. Enter the following command to verify the kernel type (SMP or non-SMP): # uname -r 6. Only for non-SMP kernel module (i386 platform only), edit the Makefile and delete the following text: -D__SMP__=1 \ The edited text should now display as follows: # For 32-bit environment # If this is not a SMP environment remove the -D__SMP__=1 from CFLAGSCFLAGS =...
Installing the SCSI Miniport Driver 2. Enter the following command to bring up the interface: Edit /etc/sysconfig/network-scripts/ifcfg-lpfnX. 3. On SuSE, run the ifconfig command (all on one line) to configure the interface: insmod lpfndd ifconfig lpfn X inet 172.16.0.1 netmask 255.255.255.0 broadcast 199.199.255.255 Where X is the interface number, 0 through 7.
Page 30
Installing the SCSI Miniport Driver 2. Run the following command to update your system with the information you added to /etc/conf.modules: # depmod -a Edit /etc/sysconfig/network-scripts/ifcfg-lpfnX. Where X is the interface number, 0 through 7. This file should be created if you wish to configure IP.
Installing the SCSI Miniport Driver 5. Add the following line to get multiple LUN support: append=”max_scsi_luns=LUNs” Where LUNs is the number of LUNs per SCSI device. Adding this line is optional. 6. Run these commands to build the boot image. The boot image new_image_name must match the name specified in the /etc/lilo.conf file: # rm -f /boot/new_image_filename # /sbin/mkinitrd /boot/new_image_filename kernel_version...
Page 32
Installing the SCSI Miniport Driver 4. Edit Rules.make and remove “$(sort and the matching closing parenthesis from this line: subdir-list = $(sort $(patsubst %,_subdir_%,$(SUB_DIRS))) The edited line should now display as follows: subdir-list = $(patsubst %,_subdir_%,$(SUB_DIRS)) NOTE: For some 2.4 based kernels, this will allow the scsi/lpfc Makefile to be invoked BEFORE the scsi Makefile.
Installing the SCSI Miniport Driver The edited lines should now display as follows. dep_tristate 'EATA-PIO [old DPT PM2001, PM2012A] support' CONFIG_SCSI_EATA_PIO $CONFIG_SCSI dep_tristate 'Emulex LightPulse Fibre Channel support' CONFIG_SCSI_LPFC $CONFIG_SCSI dep_tristate 'Future Domain 16xx sCSI/AHA-2920A support' CONFIG_SCSI_FUTURE_DOMAIN $CONFIG_SCSI 10. Edit Makefile and add (with other CONFIG_SCSI_devices) a check for $(CONFIG_SCSI_LPFC), if defined.
Page 34
Installing the SCSI Miniport Driver 2. Edit Config.in. Edit the following lines: bool 'Fibre Channel driver support' CONFIG_NET_FC if [“$CONFIG_NET_FC” = “y”]; then dep_tristate' Interphase 5526 Tachyon chipset based adapter support' CONFIG_IPHASE5526 $CONFIG_SCSI$CONFIG_PCI 3. Add the following line (all one line): dep_tristate ' Emulex LightPulse Fibre Channel support' CONFIG_NET_LPFC $CONFIG_SCSI $CONFIG_PCI The edited lines should now display as follows:...
Page 35
Installing the SCSI Miniport Driver The edited lines should now display as follows: #ifdef CONFIG_NET_FC static int lpfnif_probe(struct net_device *dev) #ifdef CONFIG_LPFC_SCSI lpfn_probe(); #endif return 0; static int fcif_probe(struct net_device *dev) if (dev->base_addr == -1) return 1; if (1 #ifdef CONFIG_IPHASE5526 &&...
Installing the SCSI Miniport Driver Installing the Latest Version of HBA API and Utilities 1. Enter the following command to install the latest version of HBA API and utilities: # sh Install.sh host bus adapter for Windows and Linux installation guide 3–15...
Troubleshooting Introduction The Power-On Self Test (POST) and the Windows Event Viewer are troubleshooting utilities you can use for the Host Bus Adapter (HBA). This chapter explains the use of these utilities in the event of an HBA problem. POST Conditions and Results Table 4–1 lists the HBA LED states with descriptions of each.The position of the POST LED indicators is defined in...
Troubleshooting Using The Event Viewer The Windows SCSI driver verifies the condition of the HBA POST. If there is a failure or a suspected failure, an error log entry is issued to the Windows Event log. Following is the procedure for viewing the event log. From the Main menu: 3.
Troubleshooting Table 4–2 describes the SCSI port error log codes Table 4–2: SCSI Port Error Log Codes 0x10 Offset Explanation 0x11 to 0x13 Further Information 0xC0 Invalid Link Speed Selection (Windows NT) 0xD0 SNS_REQ (XMIT_SEQ failed) 0x11 = cmdstat, 12 = parm err 0xD1 SNS_RSP (RCV_SEQ failed) 0x11 = cmdstat, 12 = parm err...
Page 42
Troubleshooting Table 4–2: SCSI Port Error Log Codes (Continued) 0x10 Offset Explanation 0x11 to 0x13 Further Information 0xEC Uncached extension alloc. Error 0xED Link down @ boot time (30 sec) 0xEF Too many interrupts at initial boot 0xF0 Rcv ELS request (possible logout) 0x11 = ELS type, 12-13 = X_ID (Windows NT) 0xF1...
Troubleshooting Private Loop Device Mapping for Windows Platforms In a private loop environment (FC-AL, no switch), devices are initially created based on a fixed address ordering. Once created (at boot), the devices continue to be tracked based on: –WWPN:HardAddress=0;MapNodeName=0 –NodeName:HardAddress=0;MapNodeName=1 –D_ID:HardAddress=1;...
Diagnostic and Configuration Utilities This chapter contains instructions for installing and using the following Windows NT and Windows 2000 utilities: • DOS Diagnostic utility, x86DNLD, a DOS-based diagnostic and firmware download utility. This utility is used exclusively in standalone environments. •...
Diagnostic and Configuration Utilities Installing the DOS Diagnostic Utility You must load the software and start the diagnostic utility from the DOS command line. You can run the program directly from the supplied software kit or you can load onto your hard drive and run it from there. NOTE: The diagnostic utility does not operate in the DOS shell under Windows.
Diagnostic and Configuration Utilities Using the DOS Diagnostic Utility for Preliminary Testing The diagnostic program performs preliminary analysis of the HBA before displaying the main menu. If no HBA is found, the program exits. Error messages are displayed on failure conditions. During startup, the diagnostic and firmware download utility program: 1.
Page 58
Diagnostic and Configuration Utilities Adapter 1 PASSED PRELIMINARY TESTS Resetting Host Adapter 1 Host Adapter 1: POST Done. Host Adapter 1 is READY. Functional Firmware Loaded. Diagnostic Firmware Version x.x Functional Firmware Version x.x Hit RETURN or ENTER key to continue HOST ADAPTER 1 Resources Info pci_bus_num = 0 pci_dev_num = 0xA0 slim_base_adr = 0x000D0000 reg_mem_base_adr = 0x000D1000...
Diagnostic and Configuration Utilities DOS Diagnostic Utility Main Menu After the diagnostic and firmware download utility goes through its start-up procedure, the Main menu displays and handles user requests. If the program detects two or more HBAs in the system, you are prompted to choose which HBAs is to be tested.
Diagnostic and Configuration Utilities The features and commands for the configuration utility for Windows Advanced Server Limited Edition v 1.2 (LPutil64.exe) are similar to those of the Windows NT and Windows 2000 configuration utility (lputilnt.exe). These differences will be pointed out in this document where appropriate. You can run the utility from the CD or copy and run it from your local hard drive.
Diagnostic and Configuration Utilities Maintaining HBA Firmware Revision Levels 1. Choose the desired HBA. 2. Expand the category list and choose Firmware Maintenance. 3. Click Download. 4. Locate the new upgrade file. 5. Click Open. NOTE: The new software is transferred to the HBA. 6.
Page 62
Diagnostic and Configuration Utilities • Choose Permanent to cause the new value to be written to the system registry. If Permanent is not selected, the parameter reverts to its default value when the driver is reset. • Choose Global to change the global registry entry. Otherwise, the change is made to the HBA-specific registry entry.
Page 63
Diagnostic and Configuration Utilities Table 5–3: Driver Parameters (Continued) NodeTimeOut = n Values are in seconds from 1–255. Default = 10. Controls the time-out at which a formerly logged-in node will issue SELECTION_TIMEOUT error status to an I/O request. QueueDepth = n Values from 1–64 (decimal).
Diagnostic and Configuration Utilities Table 5–3: Driver Parameters (Continued) SilFlags = n Values from 0-2. Default = 0. Controls which driver interface to use. 0 = automode; attempt SLI-2 first. If that fails, uses SLI-1. 1 = always use SLI-1. 2 = always use SLI-2. SimulateDevice = n Values 0 or 1.
Diagnostic and Configuration Utilities Test Host Bus Adapters (For lputilnt Only) Choose this option to run host-based internal and external loopback tests on the HBAs. From the LightPulse Utility/NT Main menu screen: 1. Choose Test Host Bus Adapters. 2. Enable or disable the external loopback tests: a.
Diagnostic and Configuration Utilities Input/Output Choose this option to open or close input and output files. The contents of the Input file are interpreted and executed by the program. The output file contains a log of all messages. Note that nesting of input files is not supported. Show Host Bus Adapter Info (For lputilnt Only) Choose this option to display HBA data in these areas: •...
Regulatory Compliance Notices FCC Compliance Information Statement 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.
Regulatory Compliance Notices Japanese Notice Canadian Notice This Class A digital apparatus meets all requirements of the Canadian Interference-Causing Equipment Regulations. Avis Canadien Cet appareil numérique de la classe A respecte toutes les exigences du Règlement sur le matériel brouilleur du Canada. Federal Communications Commission Notice This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to Part 15 of the FCC rules.
Regulatory Compliance Notices If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following measures: •...
Glossary This glossary defines terms used in this guide or related to this product and is not a comprehensive glossary of computer terms. AL-PA Arbitrated Loop Physical Address. The address of a Fibre Channel node in an arbitrated loop. Arbitration The process of selecting one respondent from a collection of several candidates that request service at the same time.
Page 72
Glossary Boot BIOS Software coded into the chips on the HBA. A special program used to boot and control the computer. Broadband In data transmission, it denotes transmission facilities capable of handling frequencies greater than those required for high-grade voice communications. The higher frequency allows the carrying of several simultaneous channels.
Page 73
Glossary Duplex Transmission Transmission in both directions, either one direction at a time (half duplex) or both directions simultaneously (full duplex). Fabric A Fibre Channel interconnection method that allows multiple simultaneous and concurrent data transfers between multiple hosts and/or storage devices connected with a multi-port hub. FC-AL Abbreviation for Fibre Channel Arbitrated Loop, an interconnection scheme that supports from 1 to 126 ports on a loop in a shared medium topology.
Page 74
Glossary GB/s Gigabytes per second or 1,073,741,824 bytes per second. A reference to processing speed. Gigabit Link Module. A transmitter and receiver that provides high-speed serial links, enabling continuous throughput in each direction simultaneously. Host Adapter Module (HAM) A HAM is the driver component used to drive specific HBA hardware in the NetWare Peripheral Architecture (NPA).
Page 75
Glossary Light Emitting Diode (LED) A device used in a transmitter to convert information from electrical to optical form. It typically has a large spectral width. Lightwaves Electromagnetic waves in the region of optical frequencies. The term “light” was originally restricted to radiation visible to the human eye, with wavelengths between 400 and 700 nanometers (nm).
Page 76
Glossary Mode A term used to describe a light path through a fiber, as in multi-mode or single-mode. Multi-initiators Two different Fibre Channel HBAs in one arbitrated loop sharing the same storage devices, but not communicating with each other. Multi-Mode Fiber An optical waveguide in which light travels in multiple modes.
Page 77
Glossary Optical Waveguide Dielectric waveguide with a core consisting of optically transparent material or low attenuation (usually silica glass) and with cladding consisting of optically transparent material of lower refractive index than that of the core. It is used for the transmission of signals with lightwaves and is frequently referred to as fiber.
Page 78
Glossary Simplex Transmission Transmission in one direction only. Single-Mode Fiber An optical waveguide (or fiber) with a small core diameter in which only a single mode is capable of propagation. This type of fiber is particularly suitable for wideband transmission over large distances, since its bandwidth is limited only by chromatic dispersion.
Index A7298A host bus adapter See HBAs equipment symbols ix agency approvals 1–5 Al_PA addresses, table of 5–10 fabric device mapping 4–7 audience vii FCC Compliance notice A–1 Federal Communications Commission notice Boot BIOS A–2 definition 1–3 getting help x CmdStat values 4–5 Compaq HBAs...
Page 80
Index showing HBA information 5–12 standards, for HBAs 1–4 LightPulse Utility/NT symbols input and output files 5–12 in text viii modifying driver parameters 5–7 5–11 on equipment ix modifying test options 5–11 system requirements overview 5–5 HBA installation 2–1 restarting HBAs 5–11 showing HBA information 5–12 viewing HBA parameters 5–6 technical support, Compaq x...
Page 81
Index x86DNLD, See DOS Diagnostic utility 5–1 host bus adapter for Windows and Linux installation guide Index–3...