[ User s Guide] QLA 200 Family. User s Guide FIBRE CHANNEL HBA INSTALLATION

Transcription

1 [ User s Guide] User s Guide FIBRE CHANNEL HBA INSTALLATION P QLA 200 Family Covers the following operating systems: Windows 2000 Windows Server 2003 Red Hat Linux SuSE Linux NetWare

2 Technical Support Customers should contact their authorized maintenance provider for technical support of their QLogic products. QLogic-direct customers may contact QLogic Technical Support; others will be redirected to their authorized maintenance provider. Availability Training Contact Information Visit the QLogic support Web site listed in Contact Information section for the latest firmware and software updates. QLogic Technical Support is available from 7:00 AM to 7:00 PM Central Standard Time, Monday through Friday, excluding QLogic-observed holidays. QLogic offers certification training for the technical professional for both the SANblade HBAs and the SANbox switches. From the training link at you may choose Electronic-Based Training or schedule an intensive "hands-on" Certification course. Technical Certification courses include installation, maintenance and troubleshooting QLogic SAN products. Upon demonstrating knowledge using live equipment, QLogic awards a certificate identifying the student as a Certified Professional. The training professionals at QLogic may be reached by at tech.training@qlogic.com. Address: QLogic Corporation 6321 Bury Drive Eden Prairie, Minnesota USA Telephone: Fax: Technical Support Technical Training HBA support web site: support@qlogic.com tech.training@qlogic.com support.qlogic.com Use the following table to write down the serial numbers of your QLA200 HBAs. This information is useful for QLogic technical support and for your HBA warranty. HBA Serial Number HBA Serial Number

3 QLA200 User s Guide 2-Gbps Fibre Channel to PCI-X Host Bus Adapter FL B Page i

4 QLA200 User s Guide 2-Gb Fibre Channel to PCI-X Host Bus Adapter Information furnished in this manual is believed to be accurate and reliable. However, QLogic Corporation assumes no responsibility for its use; nor for any infringements of patents or other rights of third parties which may result from its use. QLogic Corporation reserves the right to change product specifications at any time without notice. Applications described in this document for any of these products are for illustrative purposes only. QLogic Corporation makes no representation nor warranty that such applications are suitable for the specified use without further testing or modification. QLogic Corporation assumes no responsibility for any errors that may appear in this document. No part of this document may be copied nor reproduced by any means, nor translated nor transmitted to any magnetic medium without the express written consent of QLogic Corporation. Linux is a registered trademark of Linus Torvalds. Microsoft, Windows NT, Windows Server, Windows 2000, and Windows Server 2003, are trademarks or registered trademarks of Microsoft Corporation. QLA, QLogic, and the QLogic logo are registered trademarks of QLogic Corporation. Red Hat and all Red Hat-based trademarks are trademarks or registered trademarks of Red Hat, Inc. Solaris is a registered trademark of Sun Microsystems, Inc. SuSE is a registered trademark of SuSE Linux AG. WinZip is a registered trademark of WinZip Computing, Inc. All other brand and product names are trademarks or registered trademarks of their respective owners. Document Revision History Rev A release, 1/20/04 Rev B update, 4/9/04 Changes Document Sections Affected Re-format/re-design guide All Updated QLA200 information. 1 Updated HBA installation instructions 2 Updated instructions for driver installation in Windows operating systems 3 Updated instructions for driver installation in Red Hat/SuSE Linux operating 4 systems Added instructions for driver installation in NetWare operating systems 5 Revised hardware troubleshooting information Updated Fast!UTIL information QLogic Corporation. All rights reserved worldwide. First Printed: November 2003 Printed in U.S.A. QLogic Corporation, Aliso Viejo Parkway, Aliso Viejo, CA 92656, (800) or (949) Page ii FL B

5 Table of Contents Section 1 Introducing the QLA QLA200 HBA Highlights What s in the Box? QLA200 HBA Components System Requirements Installing the QLA200 HBA and Driver Section 2 HBA Installation 2.1 Installing the QLA200 HBA Section 3 SANsurfer HBA Install Wizard (Windows 2000/Server 2003) 3.1 Introduction Installing the Driver Updating the Driver Removing the Driver Performing Diagnostics Section 4 Red Hat/SuSE Linux Driver Installation 4.1 Introduction Installing and Uninstalling the Driver with the Source RPM Package Installing the Source RPM Package Installing Only the Driver Source from the Source RPM Package Uninstalling the Source RPM Package System Driver Parameter max_scsi_luns Multiple LUN Support Through the Kernel Multiple LUN Support when the SCSI Mid-Layer is Compiled in the Kernel Multiple LUN Support when the SCSI Mid-Layer is Compiled as a Module Proc Filesystem Support Section 5 NetWare Driver Installation 5.1 Introduction Finding the Driver Files FL B Page iii

6 QLA200 User s Guide 2-Gbps Fibre Channel to PCI-X Host Bus Adapter 5.3 Installing the Driver Installing the Driver During Installation of the NetWare Operating System Installing the Driver on an Existing NetWare Server Updating the Existing Driver on a NetWare Server Removing the Driver Removing the QLA200 HBA and the NetWare Driver Removing the NetWare Driver Driver Parameters System Parameters NVRAM Parameters Section 6 Troubleshooting 6.1 Problems After Installation Hardware Problems System Configuration Problems Fibre Channel Problems Section 7 Software Applications and Utilities 7.1 Introduction Configuration Settings Adapter Settings Selectable Boot Settings Restore Default Settings Scan Fibre Channel Devices Fibre Disk Utility Loopback Data Test Select Host Adapter Appendix A Compliance, Specifications, and Agency Certification A.1 Compliance A-1 A.2 Specifications A-1 A.3 Transceiver Label A-2 A.4 Agency Certification A-3 A.4.1 EMI and EMC Requirements (Preliminary) A-3 A.4.2 Product Safety Requirements (Preliminary) A-3 Page iv FL B

7 QLA200 User s Guide 2-Gbps Fibre Channel to PCI-X Host Bus Adapter Figure Figures Page 1-1 QLA200 HBA Kit QLA200 HBA Layout Low-Profile Bracket Installation QLA200 HBA Installation Connecting the Cable Found New Hardware Wizard Dialog Box SANsurfer Fibre Channel HBA Software Screen SANsurfer HBA Software Screen SANblade Fibre Channel HBA Management Software and Drivers Screen File Download Dialog Box (Sample) Initial Driver Installation Dialog Box Select Driver Dialog Box Driver Server Proxy Settings Dialog Box Driver Update Screen Install Status (Successful) Dialog Box Install Status (Unsuccessful) Dialog Box Driver Install Completed Dialog Box Driver Update Completed Dialog Box Select HBAs to Test Dialog Box Diagnostic Test Results Diagnostic Test Results, Detailed Table Tables Page 3-1 Driver Versions that Do Not Require a Loopback Connector QL2300.HAM Driver Parameters NVRAM Parameters Adapter Settings A-1 QLA200 Board Specifications A-1 A-2 QLA200 Board Operating Environment A-2 FL B Page v

8 QLA200 User s Guide 2-Gbps Fibre Channel to PCI-X Host Bus Adapter Notes Page vi FL B

9 Section 1 Introducing the QLA QLA200 HBA Highlights The following QLogic host bus adapter (HBA) is supported in this document: QLA 200 (single channel, full-height bracket, optical media) The QLA200 is 32-bit, 133-MHz PCI-X 1.0 to Fibre Channel optical media. The QLA200 HBA is a robust, dependable addition to your storage area network (SAN). The features and performance are optimized for small and medium enterprise (SME) markets. With auto-install software, plug-and-play features, and an enhanced level of technical support, the QLA200 HBA makes expanding your SAN easy and affordable. The QLA200 HBA has the following features: 2-Gbps Fibre Channel 133 MHz, 32-bit PCI-X support Integrated single-chip solution Enhanced reliability Support for bus master DMA Fast!UTIL BIOS utility to enable the BIOS, set the spinup delay, and enable extended error logging on the QLA200 HBA and attached drives Supports Fibre Channel protocol-scsi (FCP-SCSI) Supports point-to-point fabric connection (F-PORT FABRIC LOGIN) FL B 1-1

10 1 Introducing the QLA200 What s in the Box? 1.2 What s in the Box? Make sure you have everything you need to install the QLA200 HBA (see figure 1-1). SYSTEM SERVICE AND WARRANTY BROCHURE QUICK START GUIDE AND USER S GUIDE SANsurfer Fibre Channel HBA Software CD Not all of these items are included in a bulk box. SANblade QLA200 HBA LOW PROFILE BRACKET (NOT AVAILABLE IN ALL MODELS) Figure 1-1. QLA200 HBA Kit 1-2 FL B

11 1 Introducing the QLA200 QLA200 HBA Components 1.3 QLA200 HBA Components CAUTION! The QLA200 HBA contains parts that can be damaged by electrostatic discharge (ESD). Before handling the QLA200 HBA, use standard methods to discharge static electricity. Keep the QLA200 HBA in the antistatic bag until you are ready to install it. Place the board on the bag when you examine or configure it. Retain the bag for future use. Figure 1-2 identifies the QLA200 HBA components referenced throughout this section. Each QLA200 HBA has a unique serial number; its location on the HBA is noted in figure 1-2. Take a minute to write down the serial number of the QLA200 HBA on the inside cover of this document. The serial number is required for QLogic technical support and for your HBA warranty. Green LED Yellow LED Power off Power Online Link established Flashing twice per second Loss of synchronization Green and Yellow LEDs flashing alternately twice per second Activity SERIAL NUMBER Firmware error LEDs TRANSCEIVER Figure 1-2. QLA200 HBA Layout FL B 1-3

12 1 Introducing the QLA200 System Requirements 1.4 System Requirements Your system must have the following functionality to support the QLA200 HBA: One of the following: PCI 32-bit data and 33/66 MHz clock frequency PCI-X and 66/100/133 MHz clock frequency 3.3-volt signaling (5-volt tolerant) The correct media (short wave 50µm fiber or 62.5µm fiber) and connectors (LC duplex) 1.5 Installing the QLA200 HBA and Driver Installing your QLA200 HBA is quick and easy: First, install the QLA200 HBA according to the directions in section 2. Second, install the software driver according to the directions in the section that corresponds to your computer s operating system: Operating System Section Windows 2000/Windows Server Red Hat /SuSE Linux 4 Novell NetWare FL B

13 Section 2 HBA Installation 2.1 Installing the QLA200 HBA Perform the following steps to install the QLA200 HBA in your PC: Step 1. Prepare the system for the QLA200 HBA. Power down the peripherals, then the computer. Remove the computer cover and save the screws. Check the motherboard and make any configuration changes necessary to accommodate the QLA200 HBA. The QLA200 HBA is self-configuring; however, some motherboards require manual configuration. For example, some systems have a PCI Device Configuration menu in the motherboard setup BIOS where you must enable HBAs, bus master slots, and IRQ levels. If the motherboard supports triggering, use level triggering for the QLA200 HBA. See the documentation supplied with your computer, or contact your computer dealer to determine if your motherboard requires configuration. Choose any PCI bus slot that supports bus mastering. 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. Remove the slot cover for the slot in which you will install the QLA200 HBA. FL B 2-1

14 2 HBA Installation Installing the QLA200 HBA Step 2. Install the low-profile bracket (optional). Remove the two screws that attach the current bracket to the HBA. Retain the screws to re-attach the new bracket (see figure 2-1). BRACKET SCREW SCREW Figure 2-1. Low-Profile Bracket Installation Remove the current bracket by sliding it off the transceiver housings. Set the bracket aside. Position the new bracket over the transceiver housings. Gently press the bracket into position. Make sure the mounting tabs with the threaded holes are positioned on the far side (the side opposite the transceiver) of the QLA200 HBA. Align the screw holes of the QLA200 HBA and the bracket, then insert and tighten the screws. Correct torque is 3.6-in/lbs. 2-2 FL B

15 2 HBA Installation Installing the QLA200 HBA Step 3. Install the QLA200 HBA (see figure 2-2). LEVER SCREW HBA RETAINING BRACKET QLA200 HBA 64-BIT PCI BUS OR 32-BIT PCI BUS SLOT COVERS SYSTEM CHASSIS Figure 2-2. QLA200 HBA Installation Place the QLA200 HBA into the slot. Carefully press the HBA into the slot until it seats firmly. Secure the QLA200 HBA to the chassis. Follow the PC manufacturer s instructions. Connect the Fibre Channel connectors to the QLA200 HBA; follow the instructions provided by your storage vendor (RAID box) (see figure 2-3). Cable Type Max. Length Min. Length 62.5/125 µm (LC, multimode) 50/125 µm (LC, multimode) 150 meters at Gpbs 2 meters 300 meters at Gpbs 2 meters Figure 2-3. Connecting the Cable Carefully reinstall the computer cover. Insert and tighten the computer cover screws. FL B 2-3

16 2 HBA Installation Installing the QLA200 HBA Step 4. Power up all external FC devices, then power up the PC and observe the monitor. By default, the BIOS is disabled. Therefore, the devices attached to the QLA200 HBA are not displayed when the PC is powered up. For example: QLogic Corporation QLA200 PCI Fibre Channel ROM BIOS Version x.xx Copyright (C) QLogic Corporation 2004 All rights reserved. Press <CNTRL-Q> for Fast!UTIL BIOS for Adapter 0 is disabled ROM BIOS not installed Enable the BIOS only if the boot device is attached to the QLA200 HBA. This allows the system to boot faster. NOTE For more information about enabling the QLA200 HBA BIOS, see section 7. Congratulations! You have successfully installed your QLogic HBA! You are now ready to install the HBA driver. See the appropriate section for detailed instructions on how to install the software drivers. Operating System Section Windows 2000/Windows Server Red Hat /SuSE Linux 4 Novell NetWare 5 If the information displayed is not correct and you have checked the QLA200 HBA s configuration, see section 6 for troubleshooting information. See section 7 for detailed instructions on how to customize the QLA200 HBA and its attached devices using the Fast!UTIL BIOS utility. 2-4 FL B

17 Section 3 SANsurfer HBA Install Wizard (Windows 2000/Server 2003) 3.1 Introduction 3.2 Installing the Driver The SANsurfer HBA Install Wizard does the following: Installs the QLA200 HBA driver for Windows 2000/Server 2003 operating systems (see section 3.2) Updates the QLA200 HBA driver for Windows 2000/Server 2003 operating systems (see section 3.3). (To remove the driver, see section 3.4.) Performs diagnostics on the QLA200 HBA and its attached devices (see section 3.5) The SANsurfer HBA Install Wizard is on the SANsurfer Fibre Channel HBA Software CD-ROM (CD), and can be run from the CD at any time. To run the wizard from the server (optional), see the instructions in section 3.2. If you have installed the QLA200 HBA in a Windows 2000/Server 2003 operating system, follow these instructions to launch the SANsurfer HBA Install Wizard, which installs the HBA driver automatically. When the system is powered on, the Microsoft Found New Hardware Wizard dialog box (plug-and-play installation process) may display (see figure 3-1). Click Cancel. You may have multiple NOTE dialog boxes if more than one QLA200 HBA is installed in the system. Click Cancel in each dialog box. Figure 3-1. Found New Hardware Wizard Dialog Box FL B 3-1

18 3 SANsurfer HBA Install Wizard (Windows 2000/Server 2003) Installing the Driver Step 1. Insert the SANsurfer Fibre Channel HBA Software CD in an appropriate drive. The SANsurfer Fibre Channel HBA Software screen displays (see figure 3-2). Figure 3-2. SANsurfer Fibre Channel HBA Software Screen If the SANsurfer Fibre Channel HBA Software screen does not display, do the following: Select the drive where the SANsurfer Fibre Channel HBA Software CD is located. Locate and double-click the Start_Here.htm file. Step 2. Click Drivers and Application. The SANsurfer HBA Software screen displays (see figure 3-3). Figure 3-3. SANsurfer HBA Software Screen 3-2 FL B

19 3 SANsurfer HBA Install Wizard (Windows 2000/Server 2003) Installing the Driver Step 3. In the table titled 2Gb FC - QLA200 Series, click the appropriate operating system: Windows 2000 or Windows Server The SANblade Fibre Channel HBA Management Software and Drivers screen displays (see figure 3-4). Figure 3-4. SANblade Fibre Channel HBA Management Software and Drivers Screen Step 4. In the table titled 2Gb FC - QLA200 Series, click Click Here to Install. The File Download dialog box displays (see figure 3-5). Figure 3-5. File Download Dialog Box (Sample) Step 5. You can run the SANsurfer HBA Install Wizard from the CD. Optionally, you can download the wizard to the server and run it from there. Do one of the following: Click Open or Run to run the SANsurfer HBA Install Wizard from the CD. Click Save to download the application to the computer s hard disk. The Save As dialog box displays. Specify a location on the hard disk, then click Save. From that location, double-click the installation file qlflzip.exe. The SANsurfer HBA Install Wizard starts automatically. If the wizard does not start and you are running the wizard from the CD, do the following: Select the drive where the SANsurfer Fibre Channel HBA Software CD is located. In the \data\files\windows directory, double-click the installation file qlflinst.exe. FL B 3-3

20 3 SANsurfer HBA Install Wizard (Windows 2000/Server 2003) Installing the Driver Step 6. The Initial Driver Installation dialog box displays (see figure 3-6). Click Install Driver to continue with the driver installation. Figure 3-6. Initial Driver Installation Dialog Box Step 7. The Select Driver dialog box displays (see figure 3-7). Figure 3-7. Select Driver Dialog Box Select the driver location by selecting one the following radio buttons: Default Driver (provided with wizard), From the Qlogic website, or Browse. If your system has internet access, QLogic recommends selecting the From the QLogic website radio button. NOTE Select Browse if you previously downloaded the driver to your hard disk. 3-4 FL B

21 3 SANsurfer HBA Install Wizard (Windows 2000/Server 2003) Installing the Driver If you select the From the QLogic website button and your system has a proxy server, select the Specify Proxy Settings check box. The Server Proxy Settings dialog box displays (see figure 3-8). Figure 3-8. Driver Server Proxy Settings Dialog Box Select the Use the following HTTP proxy setting check box. Enter the server name and address in the Address box. For example: proxy.mylan.com or Enter the port number where the server software is monitoring. Valid values are in the range Click Continue to proceed with the driver installation. The Driver Update screen displays while the system installs the driver (see figure 3-9). Figure 3-9. Driver Update Screen Step 8. One of the following dialog boxes displays: If the driver is installed successfully, the following Update Status dialog box displays (see figure 3-10). Click OK. Figure Install Status (Successful) Dialog Box FL B 3-5

22 3 SANsurfer HBA Install Wizard (Windows 2000/Server 2003) Installing the Driver If the driver does not install successfully, the following Install Status dialog box displays (see figure 3-11). Click OK. Figure Install Status (Unsuccessful) Dialog Box There are three reasons why the driver installation can fail: The OS cannot find the QLA200 HBA. Make sure that the QLA200 HBA is seated properly (be sure to power down the computer before checking the HBA). Next, use the Device Manager to verify that the OS sees the QLA200 HBA. If the HBA does not display, use the Scan for Hardware wizard from the Device Manager. Internet problems. If you selected the From the Qlogic website radio button in the Select Driver dialog box and the your PC did not connect to the QLogic web site, the problem may be with the internet connection. Install the default driver (select the Default Driver (provided with wizard) radio button in the Select Driver dialog box). If this installation works, the internet connection is not working. If this installation does not work, the problem could be a software bug (see the next paragraph). Software problems. If the driver cannot install successfully, there may be a problem with the driver or the SANsurfer HBA Install Wizard. Contact QLogic Technical Support. Step 9. If the operating system determines that a reboot is necessary, the Driver Install Completed dialog box displays (see figure 3-12). Wait for the system to reboot in 30 seconds, or click Reboot now. Figure Driver Install Completed Dialog Box Step 10.After the driver is installed, the SANsurfer HBA Install Wizard automatically exits. 3-6 FL B

23 3 SANsurfer HBA Install Wizard (Windows 2000/Server 2003) Updating the Driver 3.3 Updating the Driver Perform the following steps if a Windows 2000/Server 2003 driver is already installed and you want to install an updated version of the driver: You must have internet access if you want to update the driver from the QLogic web site. NOTE Step 1. Insert the SANsurfer Fibre Channel HBA Software CD in an appropriate drive. The SANsurfer Fibre Channel HBA Software screen displays. Step 2. Click Drivers and Application. The SANsurfer HBA Software screen displays. Step 3. In the table titled 2Gb FC - QLA200 Series, click the appropriate operating system: Windows 2000 or Windows Server The SANblade Fibre Channel HBA Management Software and Drivers screen displays. Step 4. In the table titled 2Gb FC - QLA200 Series, click Click Here to Install. The File Download dialog box displays. Step 5. You can run the SANsurfer HBA Install Wizard from the CD. Optionally, you can download the wizard to the server and run it from there. Do one of the following: Click Open or Run to run the SANsurfer HBA Install Wizard from the CD. Click Save to download the application to the computer s hard disk. The Save As dialog box displays. Specify a location on the hard disk, then click Save. From that location, double-click the installation file qlflzip.exe. The SANsurfer HBA Install Wizard starts automatically. If the wizard does not start and you are running the wizard from the CD, do the following: Select the drive where the SANsurfer Fibre Channel HBA Software CD is located. In the \data\files\windows directory, double-click the installation file qlflinst.exe. Step 6. The HBA Configuration Update dialog box displays. Step 7. Click Update Driver. Continue with step 7 in section 3.2. FL B 3-7

24 3 SANsurfer HBA Install Wizard (Windows 2000/Server 2003) Removing the Driver After the driver is updated, you may need to reboot the system. If so, the Driver Update Completed dialog box displays (see figure 3-13). Wait for the system to reboot in 30 seconds, or click Reboot now. If the PC has applications running in the background and you want to close them, click Cancel Reboot. However, the installation will not be complete until the system is rebooted. Figure Driver Update Completed Dialog Box 3.4 Removing the Driver Power down your computer and remove the HBA from your computer according to the manufacturer s instructions; the HBA removal also removes the driver. You do not have to use the Device Manager, Hardware Wizard, or SANsurfer HBA Install Wizard to uninstall the QLA200 HBA. After you have removed the HBA and restarted your computer, Windows NOTE 2000/Server 2003 recognizes that the HBA has been removed. Alternately, you can use the Device Manager to remove the driver, which disconnects the QLA200 HBA from its attached devices. However, this procedure is not recommended for other QLogic HBAs, because the Windows 2000/Server 2003 OS will substitute its own driver when the system is powered up. The OS driver may not be the latest version of the driver. 3.5 Performing Diagnostics The SANsurfer HBA Install Wizard performs the following diagnostic tests on the QLA200 HBA and its attached devices: Loopback. This test uses the Diagnostic Loopback mailbox command to send and receive data. Before running this test, the loop in the Fibre Channel port must be up or a loopback connector must be installed. The test evaluates the ports (transmit and receive transceivers) on the QLA200 HBA. More specifically, the loopback test transmits and receives (loopback) the data and checks for the frame CRC, disparity, and length errors. 3-8 FL B

25 3 SANsurfer HBA Install Wizard (Windows 2000/Server 2003) Performing Diagnostics A loopback connector is not required if your operating system has one of the driver versions listed in table 3-1. Table 3-1. Driver Versions that Do Not Require a Loopback Connector Operating System Driver Version a Windows 2000/Server 2003 with SCSI miniport driver Windows Server 2003 with STORport miniport driver Table Notes a All subsequent versions also apply. Read/Write Buffer. The read/write buffer test sends specified data through the SCSI Write Buffer command to a target device or tape. It then reads the data back through the SCSI Read Buffer command and compares the data for errors. The test also compares the link status of the device or tape before and after the read/write buffer test. If errors occur, the test indicates a broken or unreliable link between the adapter and the device/tape. Perform the following steps to run a loopback test and a read/write buffer test on the QLA200 HBA and its attached devices: Step 1. Insert the SANsurfer Fibre Channel HBA Software CD in an appropriate drive. The SANsurfer Fibre Channel HBA Software screen displays. Step 2. Click Drivers and Application. The SANsurfer HBA Software screen displays. Step 3. In the table titled 2Gb FC - QLA200 Series, click the appropriate operating system: Windows 2000 or Windows Server The SANblade Fibre Channel HBA Management Software and Drivers screen displays. Step 4. In the table titled 2Gb FC - QLA200 Series, click Click Here to Install. The File Download dialog box displays. Step 5. You can run the SANsurfer HBA Install Wizard from the CD. Optionally, you can download the wizard to the server and run it from there. Do one of the following: Click Open or Run to run the SANsurfer HBA Install Wizard from the CD. Click Save to download the application to the computer s hard disk. The Save As dialog box displays. Specify a location on the hard disk, then click Save. From that location, double-click the installation file qlflzip.exe. FL B 3-9

26 3 SANsurfer HBA Install Wizard (Windows 2000/Server 2003) Performing Diagnostics The SANsurfer HBA Install Wizard starts automatically. If the wizard does not start and you are running the wizard from the CD, do the following: Select the drive where the SANsurfer Fibre Channel HBA Software CD is located. In the \data\files\windows directory, double-click the installation file qlflinst.exe. Step 6. The HBA Configuration Update dialog box displays. Step 7. Click Diagnostics. The select HBAs to test dialog box displays (see figure 3-14). The QLA200 HBAs are listed by port number. Figure Select HBAs to Test Dialog Box Step 8. Choose the HBAs you want to test by clicking the appropriate box in the Select column. Click Next. Step 9. A loopback test and a read/write buffer test are run on the selected HBAs. The results are displayed (see figure 3-15). Figure Diagnostic Test Results 3-10 FL B

27 3 SANsurfer HBA Install Wizard (Windows 2000/Server 2003) Performing Diagnostics For more information, right-click the port number in the Adapter column. More detailed diagnostic results are displayed (see figure 3-16). Figure Diagnostic Test Results, Detailed NOTE Click Close. Be sure to remove the loopback connector when you are done running diagnostic tests. FL B 3-11

28 3 SANsurfer HBA Install Wizard (Windows 2000/Server 2003) Performing Diagnostics Notes 3-12 FL B

29 Section 4 Red Hat/SuSE Linux Driver Installation 4.1 Introduction This section provides instructions for installing QLogic drivers on the following Linux operating systems: Red Hat Linux Advanced Server 2.1 and Enterprise Linux 3.0. Earlier or later versions of Red Hat Linux are not currently supported. SuSE Linux enterprise server (SLES) (version 8). Earlier or later SuSE SLES versions are not supported. The latest version of the software drivers and documentation for Red Hat Linux are available on the SANsurfer Fibre Channel HBA Software CD and the QLogic Web site, support.qlogic.com. Be sure to review the README.qla2x00 and release.txt files for both new and changed information. To install the Red Hat/SuSE Linux driver, first mount the source RPM package, then build the driver from the package, as described in the following sections. 4.2 Installing and Uninstalling the Driver with the Source RPM Package Install and build the QLogic Linux driver from the source RPM package. The only requirement for the RPM is the kernel-source, which is usually installed when the kernel is installed on the system. The driver source is installed in the /usr/src/qla2x00 path when the source RPM is installed. NOTE If the kernel-source is missing, see the instructions in the README.qla2x00 file. FL B 4-1

30 4 Red Hat/SuSE Linux Driver Installation System Driver Parameter max_scsi_luns Installing the Source RPM Package Perform the following steps to mount the source RPM package and install the driver source: Step 1. Insert the SANsurfer Fibre Channel HBA Software CD in an appropriate drive. Step 2. Type the following command to mount the SANsurfer Fibre Channel HBA Software CD: # mount /dev/cdrom Step 3. Type the following command: For RedHat Linux: # cd /mnt/cdrom/data/files/linux # ls For SuSE Linux: # cd /media/cdrom/data/files/linux # ls Step 4. To install the source RPM package, type the following command: # rpm -i qla2x00-vx.xx.xxbxx-y.zzzz.rpm Installing Only the Driver Source from the Source RPM Package Type the following command to install only the driver source from the source RPM package: # rpm -i --noscripts qla2x00-vx.xx.xxbxx-y.zzz.rpm Uninstalling the Source RPM Package Uninstall the source RPM package by typing the following command: # rpm -e qla2x00-vx.xx.xxbxx-y 4.3 System Driver Parameter max_scsi_luns Support for multiple LUNs can be configured as follows: Through the kernel (see section 4.3.1) When the SCSI Mid-Layer is compiled in the kernel (see section 4.3.2) When the SCSI Mid-Layer is compiled as a module (see section 4.3.3) Currently, the maximum number of LUNs that can be scanned for each device is FL B

31 4 Red Hat/SuSE Linux Driver Installation System Driver Parameter max_scsi_luns Multiple LUN Support Through the Kernel The kernel must be configured to enable multiple LUN support so that nonzero LUNs can be configured and accessible. Use the make menuconfig command to build a kernel that has the option under SCSI Support enabled to probe all LUNs on SCSI devices. If you have multiple HBAs, set max_scsi_luns to the largest number of LUNs supported by any one of these HBAs. NOTE Multiple LUN Support when the SCSI Mid-Layer is Compiled in the Kernel If the SCSI Mid-Layer is compiled in the kernel, the boot loader can be configured to scan for multiple LUNs each time the system boots. For LILO IA-32 systems, perform the following steps: Step 1. Add the following line to each of the kernel images listed in the /etc/lilo.conf file: append="max_scsi_luns=128" Step 2. Type the following command: # lilo Step 3. Reboot the system. For GRUB IA-32 Red Hat systems, perform the following steps: Step 1. Append the max_scsi_luns parameter to each of the kernel images listed in the /etc/grub.conf file. For example: kernel /vmlinux ro root=/dev/hda2 max_scsi_luns=128 Step 2. Reboot the system. For GRUB IA-32 SuSE systems, perform the following steps: Step 1. Append the max_scsi_luns parameter to each of the kernel images listed in the /boot/grub/menu.lst file. For example: kernel (hd0,1)/boot/vmlinuz root=/dev/hda2 max_scsi_luns=128 Step 2. Reboot the system. FL B 4-3

32 4 Red Hat/SuSE Linux Driver Installation Proc Filesystem Support For an IA-64 Red Hat system, perform the following steps: Step 1. Add the following line to each of the kernel images listed in the /boot/efi/efi/redhat/elilo.conf file: append="max_scsi_luns=128" Step 2. Reboot the system. For an IA-64 SuSE system, perform the following steps: Step 1. Add the following line to each of the kernel images listed in the /boot/efi/suse/elilo.conf file: append="max_scsi_luns=128" Step 2. Reboot the system Multiple LUN Support when the SCSI Mid-Layer is Compiled as a Module If the SCSI Mid-Layer is compiled as a module, perform the following steps: Step 1. Add the following line to the /etc/modules.conf file to scan for multiple LUNs when the system boots: options scsi_mod max_scsi_luns=128 Step 2. Rebuild the RAMDISK image. 4.4 Proc Filesystem Support The /proc filesystem for the driver can be found in the /proc/scsi/qla2300/ directory. This directory contains a file for each QLogic Fibre Channel HBA in the system. Each file presents information about the adapter and transfer statistics for each discovered LUN. 4-4 FL B

33 5.1 Introduction Section 5 NetWare Driver Installation This section provides instructions for installing QLogic drivers on a NetWare 5.x or 6.x operating system (OS). 5.2 Finding the Driver Files The NetWare driver files are located on the SANsurfer QLA200 (CD) and on the QLogic web site. Be sure to check the QLogic web site for the most up-to-date version of the driver. This section describes how to download the driver from the QLogic web page or the SANsurfer Fibre Channel HBA Software CD to a floppy disk (disk). During Netware OS installation, the driver must be on a disk, since you cannot swap CDs during the installation. NOTE Follow these steps to download the driver from the QLogic web page or the SANsurfer Fibre Channel HBA Software CD to a disk for installation: Step 1. Do one of the following: Locate the driver you want on the QLogic web site (support.qlogic.com) and click Download. From the SANsurfer Fibre Channel HBA Software CD home page, click Driver and Application. In the table titled 2Gb FC - QLA200 Series, locate the Operating System column. Click NetWare. The SANblade Fibre Channel HBA Software and Drivers screen displays. Click Download. Step 2. If prompted Would you like to open the file or save it to your computer?, click Save. Specify a temporary location on the hard drive and download the self-extracting file. Step 3. Insert a disk in an appropriate drive. Step 4. Run the self-extracting file you just downloaded. Extract the files to the following directory on the disk: A:\NWUPDATE\DRIVERS After the file has extracted, verify that the QL2300.HAM and QL2300.DDI files are in the \NWUPDATE\DRIVERS directory. Step 5. Remove the disk and take it to the NetWare server. FL B 5-1

34 5 NetWare Driver Installation Installing the Driver 5.3 Installing the Driver This section describes four NetWare driver installation options: Installing the driver during installation of the NetWare operating system (see section 5.3.1) Installing the driver on an existing NetWare server (see section 5.3.2) Updating the existing driver on a NetWare server (see section 5.3.3) Installing the Driver During Installation of the NetWare Operating System Perform the following steps to initially install the NetWare OS and the NetWare driver: Step 1. If you have not already done so, install the QLA200 HBA (see section 2). Step 2. Insert the driver disk (created in section 5.2) and the NetWare OS install CD into the NetWare server. Power up the server. Step 3. Follow the standard NetWare instructions to begin the installation. Step 4. Do one of the following: If the server will be booting from a device attached to the QLA200 HBA, perform the following steps to enable the BIOS and specify the boot device: a. Start Fast!UTIl (see section 7.1). b. Enable the BIOS (see section 7.2.1). c. Specify the boot device (see section 7.2.2). d. Exit Fast!UTIL. If the server is booting from a device that is not attached to the QLA200 HBA, perform the following steps to disable the BIOS: a. Start Fast!UTIl (see section 7.1). b. Disable the BIOS (see section 7.2.1). c. Exit Fast!UTIL. Step 5. After the Netware OS installation is complete, restart the server. 5-2 FL B

35 5 NetWare Driver Installation Installing the Driver Installing the Driver on an Existing NetWare Server Perform the following steps to add the NetWare driver to the existing NetWare system: Step 1. If you have not already done so, install the QLA200 HBA (see section 2). Step 2. Insert the driver disk (created in section 5.2) into the NetWare server. Power up the server. The HWDETECT or NWCONFIG program automatically detects the QLA200 HBA, and locates and loads the driver. If the programs do not find the driver (the QL2300.HAM file is missing from the Storage adapters: field of the drivers page), follow the instructions in section to manually install the driver files Updating the Existing Driver on a NetWare Server The HWDETECT or NWCONFIG program should find and prompt you to install the updated driver. If the programs do not find the driver (the QL2300.HAM file is missing from the Storage adapters: field of the drivers page), perform the following steps to manually install the driver files: Step 1. Insert the driver disk created in section 5.2. Step 2. Use either the NetWare Remote Manager or the DOS copy command to copy the files from the driver disk to the NetWare server. NetWare Remote Manager: a. Start the NetWare Remote Manager from the NetWare GUI (execute STARTX). b. Copy the QL2300.HAM and QL2300.DDI files (drag and drop) from the disk to the following directories on the server: C:\NWSERVER\DRIVERS (NetWare 6.x) C:\NWSERVER (NetWare 5.x) DOS Copy Command: a. Start at the DOS prompt. If your server does not stop at the DOS prompt, press the F8 key when the Starting DOS or Starting Caldera DR-DOS message displays during a hardware boot. If you miss the message, press CTRL+ALT+DELETE, then wait for the message to re-display. FL B 5-3

36 5 NetWare Driver Installation Removing the Driver When prompted, press Y in answer to all questions except SERVER (Y/N)?. When prompted SERVER (Y/N)?, press N. b. Copy the QL2300.HAM and QL2300.DDI files from the disk to the following directories on the server: C:\NWSERVER\DRIVERS (NetWare 6.x) C:\NWSERVER (NetWare 5.x) Make sure the QL2300.HAM and QL2300.DDI files are in the C: directory. Step 3. Start the server and manually load the driver once for each QLA200 HBA in the system. Each time you load the driver, note the slot number for future reference. Step 4. Start NWCONFIG. Select NCF Files Options. Select Edit STARTUP.NCF File to edit the file STARTUP.NCF. Step 5. At the end of the STARTUP.NVF file, append the following load line once for each QLA200 HBA in the system, using the slot number written down from step 3: LOAD QL2300.HAM SLOT=n /LUNS /ALLPATHS /PORTNAMES /QUALIFIED For example, if you have two QLA200 HBAs in slots 2 and 3, add the following lines: LOAD QL2300.HAM SLOT=2 /LUNS /ALLPATHS /PORTNAMES /QUALIFIED LOAD QL2300.HAM SLOT=3 /LUNS /ALLPATHS /PORTNAMES /QUALIFIED Step 6. Exit the editor (save the changes you made). Step 7. Exit NWCONFIG. 5.4 Removing the Driver Step 8. Restart the NetWare server. There are two ways to remove the NetWare driver: Removing the QLA200 HBA and the NetWare driver (see section 5.4.1) Removing the NetWare driver (see section 5.4.2) 5-4 FL B

37 5 NetWare Driver Installation Removing the Driver Removing the QLA200 HBA and the NetWare Driver If you are removing the QLA200 HBA from the server, perform the following steps: Step 1. Remove the QLA200 HBA from the server hardware. Step 2. Power on the server. Start the NetWare server if it does not start automatically. Step 3. The HWDETECT program automatically detects that the QLA200 HBA has been removed, and consequently removes the driver load instance. If HWDETECT does not remove the driver, perform the steps in section Removing the NetWare Driver If you are not removing the QLA200 HBA from the server, or you removed the QLA200 HBA and HWDETECT did not remove the driver load instance, perform the following steps: Step 1. Start NWCONFIG. Select NCF Files Options. Select Edit STARTUP.NCF File to edit the file STARTUP.NCF. Step 2. At the start of each line that loads the QL2300.HAM file (there is one line for each QLA200 HBA in the server), insert a pound sign (#) to comment out that line. Spaces are allowed after the pound character; be sure to add the space on all lines that load the NetWare driver. The following example lists the load lines for two driver instances commented out with the pound sign (#): # LOAD QL2300.HAM SLOT=2 /LUNS # LOAD QL2300.HAM SLOT=3 /LUNS Step 3. Exit the editor (save the changes you made). Step 4. Exit NWCONFIG. Step 5. Restart the NetWare server. When you want to reload the QLogic driver, use NWCONFIG (see step 1) to edit the STARTUP.NCF file. Remove the pound sign (#) that you inserted in step 1. Exit the editor (save any changes you made), exit NWCONFIG, and restart the server. FL B 5-5

38 5 NetWare Driver Installation Driver Parameters 5.5 Driver Parameters System Parameters The NetWare driver has two types of optional parameters: System parameters (specified when the driver is loaded) (see section 5.5.1) NVRAM parameters (stored in the HBA s NVRAM) (see section 5.5.2) The optional system parameters are specified on the driver load line. There are two types of system parameters: Global. The parameter applies to all driver instances; the value specified in the first instance is used globally for all instances. Instance. The parameter applies only to the individual driver instance specified by the load line. The system parameters are described in table 5-1. Table 5-1. QL2300.HAM Driver Parameters Parameter Type Description SLOT = n Instance This parameters tells NetWare the PCI slot number (n) of the HBA on which to load this driver instance. SLOT=n parameter example: LOAD QL2300.HAM SLOT=3 /LUNS Instance This parameter tells NetWare to scan for all LUNs when this driver is loaded. Otherwise, NetWare scans only for LUN zero devices. The scanned LUN number range is 0 to (n 1), where n is specified by the /MAXLUNS=n option. /LUNS parameter example: LOAD QL2300.HAM SLOT=3 /LUNS /GANXT Instance This parameter queries the fabric name server; it is used instead of a single GNNFT parameter. /GANXT is used for compatibility with name servers that do not support GNNFT. /GANXT parameter example: LOAD QL2300.HAM SLOT=3 /LUNS /GANXT /ALLPATHS Global This parameter disables failover and reports to NetWare all devices on all HBA paths, which allows upper layer modules to do failover across a Netware server's multiple HBAs. /ALLPATHS parameter example: LOAD QL2300.HAM SLOT=3 /LUNS /ALLPATHS 5-6 FL B

39 5 NetWare Driver Installation Driver Parameters Table 5-1. QL2300.HAM Driver Parameters (Continued) Parameter Type Description /PORTNAMES Global This parameter internally tracks devices by port name rather than node name, which is required when storage LUNs do not have a 1:1 correspondence across port names. Tracking devices by port name allows upper layer modules to do failover across a storage subsystem's multiple ports. /PORTNAMES parameter example: LOAD QL2300.HAM SLOT=3 /LUNS /PORTNAMES /PORTDOWN=n Global This parameter sets the port down timeout period to n seconds, which is the timeout period for storage port down. When the timeout expires, failover is triggered if multiple ports are available. /PORTDOWN=n parameter example: LOAD QL2300.HAM SLOT=3 /LUNS /PORTDOWN=n /LINKDOWN=n Global This parameter sets the link down timeout period to n seconds, which is the timeout period for adapter link down. When this timeout expires, adapter path failover is enabled if multiple ports are available. /LINKDOWN=n parameter example: LOAD QL2300.HAM SLOT=3 /LUNS /LINKDOWN=n /FAILBACK=n Global This parameter sets the failback delay time period to n seconds. This is the time period that elapses when a port update event has occurred before any attempt is made to failback paths/ports. /FAILBACK parameter example: LOAD QL2300.HAM SLOT=3 /LUNS /FAILBACK=n /BACKOFF Global This parameter disables failback of I/O after a broken link or a broken port has been restored and made operational. /BACKOFF parameter example: LOAD QL2300.HAM SLOT=3 /LUNS/BACKOFF /IGNCFG Global This parameter avoids reading the configuration file QL2X00.CFG, and allows all devices to be reported to NetWare. The QL2X00.CFG file is located in the default DOS directory (C:\NWSERVER); this file is written by QLogic SANsurfer software or the CFG.NLM test tool. /IGNCFG parameter example: LOAD QL2300.HAM SLOT=3 /LUNS /IGNCFG FL B 5-7

40 5 NetWare Driver Installation Driver Parameters Table 5-1. QL2300.HAM Driver Parameters (Continued) Parameter Type Description /REQCFG Global This parameter requires reading the configuration file QL2X00.CFG. All devices not specified in this file are ignored. If this file does not exist, all devices are ignored. The QL2X00.CFG file is located in the default DOS directory (C:\NWSERVER); this file is written by QLogic SANsurfer software or the CFG.NLM test tool. /REQCFG parameter example: LOAD QL2300.HAM SLOT=3 /LUNS /REQCFG /CONSOLE Global This parameter sends system alerts to the server console when failover and failback events occur. /CONSOLE parameter example: LOAD QL2300.HAM SLOT=3 /LUNS /CONSOLE /MAXLUNS=n Global This parameter sets the maximum number of LUNs allowed during the LUN scan. The range of LUNs searched is 0 to (n 1). /MAXLUNS parameter example: LOAD QL2300.HAM SLOT=3 /LUNS /MAXLUNS=256 /SKIPREPORT Instance This parameter avoids executing the SCSI Report LUNs command during LUN scanning. Omitting this parameter allows the driver to use the response from the SCSI Report LUNS command to optimize the LUN scan by performing SCSI Inquiry commands only to LUNs listed in the response. /SKIPREPORT parameter example: LOAD QL2300.HAM SLOT=3 /LUNS /SKIPREPORT /INQUIRY Instance This parameter forces the use of SCSI Inquiry commands during the LUN scan regardless of the LUNs listed by the response to the SCSI Report LUNs command. The existence of a particular LUN is determined by the results of the SCSI Inquiry command to that LUN. /INQUIRY parameter example: LOAD QL2300.HAM SLOT=3 /LUNS /INQUIRY /STARTUNIT Instance This parameter sends the SCSI Start Unit command to each LUN during the LUN scan. On some multiple port RAID subsystems, this parameter may cause LUN ownership to transfer across ports. /STARTUNIT parameter example: LOAD QL2300.HAM SLOT=3 /LUNS /STARTUNIT 5-8 FL B