Software Installation Guide for the QLA22xx Board Family Fibre Channel Host Adapter Boards for the PCI Bus FC0153302-00 F July 20, 2001
QLogic Corporation 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 Document Revision History Rev. A initial release, 4/29/99 Rev. B update, 5/24/99, (QLA2202F board added) Rev. C update, 2/29/00, (QLA2200G/2200L boards added; Windows 2000, Solaris SPARC, Solaris x86, and Linux driver installation instructions added) Rev. D update, 6/21/00, (QLA2204F board added; Detailed list of supported boards added; Linux driver installation instructions updated) Rev. E update, 2/6/01, (QLA2212F board added) Rev.
QLogic Corporation © 1999–2001 QLogic Corporation First Printed: March 1999 All Rights Reserved Worldwide Printed in U.S.A.
Table of Contents Section 1 1.1 1.2 1.3 Introduction Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Before You Install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . General Description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Section 2 2.1 2.2 2.3 2.4 UnixWare 7 Driver Installation Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing UnixWare 7.0 and the qlc2200 Driver . . . . . .
Table of Contents 5.3 5.3.1 5.3.2 5.3.3 5.4 5.5 5.5.1 5.5.2 5.5.3 Section 6 6.1 6.2 6.3 6.4 Section 7 7.1 7.2 7.3 7.3.1 7.3.2 Section 8 8.1 8.2 8.2.1 8.2.2 8.2.3 8.3 8.4 8.4.1 8.4.2 8.4.2.1 Page vi QLA22xx Software Installation Guide Windows 2000 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . Initial Installation of Windows 2000 and the Windows 2000 Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing the Windows 2000 Driver . . . . . . . . . . . . . . . . .
QLA22xx Software Installation Guide 8.4.2.2 8.4.2.3 8.5 8.5.1 8.5.2 Building a Ramdisk Image to Load the Driver Automatically . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Loading the Driver Manually . . . . . . . . . . . . . . . . . . . . Building a Driver from the Sources . . . . . . . . . . . . . . . . . . . . Building a Uniprocessor Version of the Driver . . . . . . . . . Building a Multiprocessor Version of the Driver . . . . . . . . Appendix A A.1 A.2 A.3 A.3.1 A.3.
Table of Contents Page viii QLA22xx Software Installation Guide FC0153302-00 F
Section 1 Introduction NOTE: Throughout this guide, the following QLogic host adapter boards are collectively referred to as the QLA22xx board unless otherwise noted: ■ QLA2200 family (64-bit PCI to Fibre Channel copper media): FC0210406-03 (ISP2200 chip) FC0210406-04 (ISP2200A/33 chip) FC0210406-05 (ISP2200A/66 chip) ■ QLA2200F family (64-bit PCI to Fibre Channel optical media): FC0310406-03 (ISP2200 chip) FC0310406-04 (ISP2200A/33 chip) FC0310406-05 (ISP2200A/66 chip) ■ QLA2202F family (64-bit PCI t
Before You Install 1 – Introduction 1.2 Before You Install Before you install the software drivers, you need to: ■ Locate and download the appropriate drivers for your operating system. The latest version of the QLA22xx drivers for the following operating systems are located on the QLogic web site, http://www.qlogic.com. ❑ ❑ ❑ ❑ ❑ ❑ ❑ Santa Cruz Operations (SCO) UnixWare 7.0 and 7.1 NetWare 4.X and 5.X Windows NT 4.0 Windows 2000 Solaris SPARC v2.6, 7, and 8 Solaris x86 v2.6 and 7 Red Hat Linux 6.2, 7.
Section 2 UnixWare 7 Driver Installation (qlc2200) 2.1 Introduction This section provides instructions for installing the UnixWare driver under the following operating system conditions: ■ Initial installation of UnixWare 7.0 and the qlc2200 driver ■ Initial installation of UnixWare 7.1 and the qlc2200 driver ■ Installation of the qlc2200 driver in an already installed UnixWare 7.0 or 7.1 system If UnixWare is not installed on your system, perform the installation procedures in section 2.
Installing UnixWare 7.0 and the qlc2200 Driver 2 – UnixWare 7 Driver Installation 2.2 Installing UnixWare 7.0 and the qlc2200 Driver Perform the following steps to install UnixWare 7.0 and the qlc2200 driver. 1. Follow the installation instructions that come with the UnixWare 7.0 installation disks. During the installation, you will be prompted to install the driver for the QLA22xx board. When installing UnixWare 7.
2 – UnixWare 7 Driver Installation Installing the qlc2200 Driver 2.4 Installing the qlc2200 Driver Perform the following steps to install the qlc2200 driver in a previously installed UnixWare 7.0 or 7.1 system. 1. Make sure you have root privileges. 2. Enter the following text at the prompt to run the pkgadd program: pkgadd -d diskette1 3. The following prompt appears: Insert diskette into Floppy Drive 1. Type [go] when ready, or [q] to quit: (default: go) 4.
Installing the qlc2200 Driver 2-4 2 – UnixWare 7 Driver Installation FC0153302-00 F
Section 3 NetWare Driver Installation (QL2200.HAM) 3.1 Introduction This section provides instructions for installing the NetWare driver in an already installed Novell NetWare 4.x or 5.x system. NOTE: References to Novell NetWare versions 4.x or 5.x refer to versions that are currently supported by Novell. 3.2 NetWare Driver Files and Parameters The latest versions of the software drivers and documentation for NetWare 4.x and 5.x are available on the QLogic web site. Be sure to review the README.
Installing the NetWare Driver 3 – NetWare Driver Installation Perform the following steps to install the NetWare driver in a previously installed NetWare 4.x or 5.x system. NOTE: The following procedure modifies your NetWare STARTUP.NCF file to load the driver automatically when your system boots. 1. Start NetWare and load the NetWare Install program from the NetWare server prompt (SERVERNAME:). Type the following command if you are using NetWare 4.
Section 4 Windows NT Driver Installation (QL2200.SYS) 4.1 Introduction This section provides instructions for installing the Windows NT driver under the following operating system conditions: ■ Initial installation of the Windows NT 4.0 operating system and the Windows NT driver ■ Installation of the Windows NT driver in an already installed Windows NT 4.0 operating system ■ Installing an updated Windows NT driver in an already installed Windows NT 4.
Windows NT Installation 4 – Windows NT Driver Installation 4.3.1 Initial Installation of Windows NT and the Windows NT Driver Perform the following steps to install Windows NT 4.0 on the Fibre Channel hard disk attached to the QLA22xx board. 1. Insert the Windows NT setup disk or CD (if booting from a bootable CD-ROM drive) in an appropriate drive. 2. Reboot your system. 3. Press F6 to Install Additional Devices. 4. Press s to specify an additional device. 5. Select Other, then press ENTER. 6.
4 – Windows NT Driver Installation QLDIRECT 4.3.3 Updating the Windows NT Driver Perform the following steps if a Windows NT driver is already installed and you want to install an updated version of the driver. NOTE: This procedure does not modify the current registry parameters for the QLA22xx Windows NT driver. 1. Open a DOS command prompt window. 2. Change the current directory to the Windows NT driver directory. For example: CD \WINNT\SYSTEM32\DRIVERS 3. Make a backup copy of the old driver.
QL2200IP NDIS Network Driver Installation 4 – Windows NT Driver Installation 4.5 QL2200IP NDIS Network Driver Installation Your system must meet the following requirements for the QL2200IP network driver interface specification (NDIS) network driver to function properly. ■ The QL2200 Enhanced + IP SCSI miniport driver must be installed. ■ The Fast!Util Drivers Load RISC Code adapter parameter must be enabled (refer to the Hardware Installation Guide for the QLA2200 Board Family [FC0151103-00]).
4 – Windows NT Driver Installation QL2200IP NDIS Network Driver Installation 11. Specify an IP address and subnet mask for each adapter on the network. Each IP address must be unique and all adapters must use the same subnet mask. For example: Adapter 1 IP address: 10.0.0.1 Subnet mask: 255.255.0.0 Adapter 2 IP address: 10.0.0.2 Subnet mask: 255.255.0.0 12. Click OK. 13. Remove the disk and click Yes to restart the computer. 4.5.
QL2200IP NDIS Network Driver Installation 4 – Windows NT Driver Installation 4.5.3 QL2200IP NDIS Driver Configuration The QL2200IP NDIS driver provides optional configuration parameters. The configuration parameters are listed in table 4-1 and described in the following paragraphs. Table 4-1. QL2200IP.
4 – Windows NT Driver Installation QL2200IP NDIS Network Driver Installation 6. Make configuration parameter modifications as necessary. 7. Click OK. The Network dialog box reappears. 8. Click Cancel. 9. Click Yes to restart the computer.
QL2200IP NDIS Network Driver Installation 4-8 4 – Windows NT Driver Installation FC0153302-00 F
Section 5 Windows 2000 Driver Installation (QL2200.SYS) 5.
Windows 2000 Installation 5 – Windows 2000 Driver Installation 3. Follow the standard Windows 2000 installation instructions. 4. Press F6 to Install Additional Devices. 5. Press s to specify an additional device. 6. Insert the disk that contains the QLogic driver into an appropriate drive, then press ENTER. 7. Windows 2000 detects the QLogic QLA2200 PCI Fibre Channel Adapter. Press ENTER to continue the driver installation. 8. Press ENTER to continue the Windows 2000 installation. 9.
5 – Windows 2000 Driver Installation QLDIRECT 5.3.3 Updating the Windows 2000 Driver Perform the following steps if a Windows 2000 driver is already installed and you want to install an updated version of the driver. NOTE: The latest versions of the software drivers and documentation are available on the QLogic web site, http://www.qlogic.com. 1. Click the Start button, point to Programs, point to Computer Management, and then click System Tools. 2. Double-click the Device Manager tab. 3.
QL2200IP NDIS Network Driver Installation 5 – Windows 2000 Driver Installation See appendix A for further information. 5.5 QL2200IP NDIS Network Driver Installation Your system must meet the following requirements for the QL2200IP network driver interface specification (NDIS) network driver to function properly. ■ The QL2200 Enhanced + IP SCSI miniport driver must be installed.
5 – Windows 2000 Driver Installation QL2200IP NDIS Network Driver Installation 14. Select Network & Dial-up Connections in the Control Panel. 15. Right-click the Local Area Connection icon, then select Properties. NOTE: If your system has multiple Local Area Connection icons, select the most recent (highest number listed). 16. Make sure the QLA2200 PCI Adapter is listed under Connect using. 17. Click Internet Protocol (TCP/IP), then select Properties. The TCP/IP Properties dialog box is displayed. 18.
QL2200IP NDIS Network Driver Installation 5 – Windows 2000 Driver Installation 5.5.3 QL2200IP NDIS Driver Configuration The QL2200IP NDIS driver provides optional configuration parameters. The configuration parameters are listed in table 5-1 and described in the following paragraphs. Table 5-1. QL2200IP.
5 – Windows 2000 Driver Installation QL2200IP NDIS Network Driver Installation 5. Click Configure. 6. Select the Advanced tab. 7. Make configuration parameter modifications as necessary. 8. Click OK. 9. Restart your system.
QL2200IP NDIS Network Driver Installation 5-8 5 – Windows 2000 Driver Installation FC0153302-00 F
Section 6 Solaris SPARC Driver Installation (QLA2200) 6.1 Introduction This section provides instructions for installing the Solaris SPARC driver in an already installed Solaris SPARC operating system. The latest version of the Solaris SPARC driver package is available on the QLogic web site. The files in the driver package cannot be read nor installed from a DOS environment. Be sure to review the README.TXT for both new and changed information. To install the driver from a CD-ROM, see section 6.2.
Installing the Solaris SPARC Driver from the QLogic Web Site 6 – Solaris SPARC Driver Installation 9. At the command prompt, type: pkgadd -d ./qla2200 10. Continue with step 7 in section 6.3. 6.3 Installing the Solaris SPARC Driver from the QLogic Web Site Perform the following steps to download the Solaris SPARC driver from the web to your hard disk, then install the driver on your system. NOTE: To install the QLA2200 driver, you must have superuser privileges. 1. Log on to the system as a superuser. 2.
6 – Solaris SPARC Driver Installation Installing the Solaris SPARC Driver from the QLogic Web Site 9. You are prompted to select the directory where the driver will be installed. For example: Processing package instance from QLogic QLA2320 driver (sparc) Solaris 2.8, Rev=X.XX Copyright (c) 1996-2001, by QLogic Corporation. All rights reserved. Where do you want the driver object installed (default=/kernel/drv): 10. Press ENTER to accept the default. 11.
FCode 6 – Solaris SPARC Driver Installation 6.4 FCode If you need FCode, see appendix B for instructions on how to install or update the FCode on the QLA22xx board.
Section 7 Solaris x86 Driver Installation (QLA2200) 7.1 Introduction This section provides instructions for installing the Solaris x86 driver under the following operating system conditions: ■ Installation of the Solaris x86 operating system on a Fibre Channel disk that is attached to the QLA22xx board. (The QLA22xx board is installed as a boot adapter.) ■ Installation of the QLA22xx board as an add-on adapter in an already installed Solaris x86 (v2.6 or 7) operating system. 7.
Solaris x86 Installation 7 – Solaris x86 Driver Installation 7.3.1 Installing the Solaris x86 Driver (QLA22xx Board as a Boot Adapter) NOTE: ■ To install the QLA22xx driver, you must have superuser privileges. ■ You must install the QLA22xx board into your x86 system before installing the Solaris x86 driver. ■ The QLA22xx board must be the only boot device in the system during driver installation.
7 – Solaris x86 Driver Installation Solaris x86 Installation 11. The system processes the disk and prompts you for additional disks. For example: If you have additional Update diskette to install (such as video), please insert diskette now. Additional Update diskette to install? (y/n) [y] 12. Remove the disk that contains the QLogic driver. 13. Type n. 14. Follow the on-screen instructions to complete the setup. 7.3.
Solaris x86 Installation 7 – Solaris x86 Driver Installation 8. When the driver is installed, the following information appears: Using as the package base directory. ## Processing package information. ## Processing system information. 11 package pathnames are already properly installed ## Verifying package dependencies. ## Verifying disk space requirements. Installing QLogic QLA2200 PCI-SCSI Adapter as ## Installing part 1 of 1. /kernel/drv/qla2200 /kernel/drv/qla2200.
Section 8 Red Hat Linux Driver Installation (qla2x00.o) 8.
Creating the Driver Floppy Disk 8 – Red Hat Linux Driver Installation 4. Download the driver to the temporary directory. 5. Insert a blank floppy disk. 6. Run the self-extracting file you downloaded. At the Unzip To Folder prompt, specify A:\. Verify that the floppy disk contains the following files: ■ ■ ■ ■ ■ modules.cgz modules.dep modinfo pcitable rhdd-6.1 8.2.
8 – Red Hat Linux Driver Installation Install a New Operating System and Driver 8.3 Install a New Operating System and Driver NOTE: To install the qla2x00 driver, the following requirements must be met. ■ For Red Hat Linux 6.2, you must have created the qla2x00 driver floppy disk (see section 8.2.1). ■ For Red Hat Linux 6.2, 7.0, and 7.1, you must have created a source code driver floppy disk (see section 8.2.3).
Install or Update the Driver (Installed Operating System) 8 – Red Hat Linux Driver Installation 8.4 Install or Update the Driver (Installed Operating System) Perform the following steps to install a new or upgrade an older version of the qla2x00 driver on an already installed Red Hat Linux operating system. The procedure consists of installing the driver on the boot drive (see section 8.4.1) and loading the new driver automatically (see sections 8.4.2.1 and 8.4.2.2) or manually (see section 8.4.2).
8 – Red Hat Linux Driver Installation Install or Update the Driver (Installed Operating System) The qla2x00 driver is now installed on your boot drive. However, the driver must be loaded before the system can access the devices attached to the QLA22xx board (see section 8.4.2). 8.4.2 Loading the Driver The qla2x00 driver must be loaded before the system can access the devices attached to the QLA22xx board. To build a custom kernel to automatically load the driver at boot time, see section 8.4.2.1.
Install or Update the Driver (Installed Operating System) 8 – Red Hat Linux Driver Installation b. Copy all the zipped qla2x00 source files to the /usr/src/linux/drivers/scsi directory. # cp /home/qla2x00/*.c /usr/src/linux/drivers/scsi # cp /home/qla2x00/*.h /usr/src/linux/drivers/scsi c. For Red Hat Linux 6.2, add the following lines to the Makefile in /usr/src/linux/drivers/scsi. Use the vi editor or equivalent.
8 – Red Hat Linux Driver Installation Install or Update the Driver (Installed Operating System) After line 609 add: **************** (hosts.c) ***************** #ifdef CONFIG_SCSI_QLOGIC_QLA2100 QLA2100_LINUX_TEMPLATE, #endif ****************** (end) ******************* 4. Build the symmetric multiprocessor (SMP) kernel by first changing to the source directory. # cd /usr/src/linux 5. Type the following command to remove everything. You need to do this when you build SMP kernel for the first time.
Install or Update the Driver (Installed Operating System) 8 – Red Hat Linux Driver Installation 8. Copy the new kernel image to the boot directory. In the following example, newsmp is the label for the kernel image. # cd arch/i386/boot # cp bzImage /boot/newsmp 9. Modify the /etc/lilo.conf file to make the boot loader load a new image. For example: image=/boot/newsmp label=newsmp root=/dev/hda5 (This is the location of the boot partition.
8 – Red Hat Linux Driver Installation Install or Update the Driver (Installed Operating System) 8.4.2.2 Building a Ramdisk Image to Load the Driver Automatically The Red Hat Linux kernel 2.2.x does not automatically load the qla2x00 driver when the system reboots. You can load the qla2x00 driver at boot time using a ramdisk image. For more information, refer to the Red Hat installation guide. Perform the following steps to load the qla2x00 driver using a ramdisk image. 1. For Red Hat Linux 6.
Building a Driver from the Sources 8 – Red Hat Linux Driver Installation To load the qla2x00 driver, do one of the following. ■ Type the following command: # modprobe qla2x00 ■ Under the directory that contains the qla2x.00.o file, type: # insmod qla2x00.o 8.5 Building a Driver from the Sources If your Linux kernel does not match the QLogic prebuilt driver binaries, you need to build the driver in your configuration locally.
8 – Red Hat Linux Driver Installation Building a Driver from the Sources 8.5.2 Building a Multiprocessor Version of the Driver Perform the following steps to build an SMP version of the qla2x00 driver. 1. If the QLogic SMP module is required to load with the Red Hat SMP kernel, it must be compiled with the same version number that was assigned to the original SMP kernel built by Red Hat. This step is not required for Red Hat Linux 7.0 and 7.1. For Red Hat Linux 6.
Building a Driver from the Sources 8 – Red Hat Linux Driver Installation 6. Using the floppy disk you created in section 8.2.3, copy the qla2x00src-vx.xx.tgz file to the /home/qla2x00 directory. # # # # # cd /home mkdir qla2x00 cd /home/qla2x00 mcopy a:*.tgz . (The period [.] at the end is required.) tar -xvzf qla*.tgz 7. Build the driver from the sources. For Red Hat Linux 6.0 and 7.1, type: # make SMP=1 For Red Hat Linux 7.1, type: # make SMP=1 OSVER=linux-2.
Appendix A QLDIRECT for Windows NT 4.0 and Windows 2000 A.1 Introduction The QLDIRECT driver, coupled with the QLogic Windows NT enhanced miniport driver, provides the following features: ■ A highly optimized I/O path for normal read and write operations with reduced CPU utilization and increased parallelization ■ Failover and failback features to reroute I/O operations to the correct path This appendix provides installation instructions for the QLDIRECT driver in an already installed Windows NT 4.
QLDIRECT Installation A – QLDIRECT for Windows NT 4.0 and Windows 2000 3. Execute the Setup.exe installation program on the disk and follow the instructions on the screen. 4. Remove the disk that contains the QLDIRECT driver. 5. Reboot your system to load the driver. A.3.2 Updating to QLDIRECT from QLFILTER The QLDIRECT driver replaces the QLogic QLFILTER driver. You must first uninstall the QLFILTER driver before installing the QLDIRECT driver.
Appendix B FCode B.1 Introduction This section provides instructions for installing FCode on a QLA22xx board installed in a Solaris SPARC system. A QLA22xx board with FCode loaded in its flash ROM provides boot capability to its attached devices. The following files are included. Be sure to review the readme.txt file for both new and changed information. ■ ifp2200.prom—FCode code binary file ■ readme.txt—FCode readme file ■ flasutil.
Setting the QLA22xx Board Connection Mode B – FCode Perform the following steps to run the flash utility. 1. Copy the qla2x00flash file and the ifp2200.prom file to the desired directory. 2. At the command line, enter the appropriate path. Use the information obtained with the show-devs command (see step 1 in section B.5). For example: qla2x00flash -1 /devices/pci@1f,0/pci@1/QLGC,qla@4: devctl ipf2200.prom B.
B – FCode Selecting the Boot Device B.4 Setting the QLA22xx Board Loop ID When the QLA22xx board is currently operating in loop mode (through connection mode 0 or connection mode 2), perform the following steps to view its loop ID and change it if necessary. 1. To view the loop ID, type the show-adapter-loopid command. ok show-adapter-loopid The loop ID displays. For example: Adapter loopid - 7c 2. If the loop ID is not correct, change it using the set-adapter-loopid command.
Building the Bootable Disk B – FCode 5. Save the boot device information to the QLA22xx board’s NVRAM. Use the set-boot-id command. Include the selected QLA22xx board’s WWN, loop ID, and LUN. For example: ok 2200002037009eeb 82 0 set-boot-id The following displays: Calculating NVRAM checksum, please wait.... done Boot device login successful Boot WWN - 20000020 37009eeb WWPN - 22000020 37009eeb Id - 82 Lun - 0 ok 6. To boot the QLA22xx board, type the complete boot path, including the loop ID and LUN.
B – FCode Building the Bootable Disk This df example shows that the current boot disk is /dev/dsk/c0t0d0s(x). There are two partitions of interest, slice 0 (/) and slice 7 (/home). Slice 0 uses 1.65 GB and has 875 MB free. Slice 7 uses 114 MB and has 5 GB free. Therefore, slice 7 (/home) contains enough disk space to store the temporary saveset files. If there were not at least 1.
Building the Bootable Disk B – FCode 4. Mount the boot partition to the /mnt mount point. For example: mount /dev/dsk/c3t130d0s0 /mnt 5. Change to the root partition mount point directory. For example: cd /mnt 6. Use the ufsdump utility to copy the root partition to the new book disk. For example: ufsdump 0f - / | ufsrestore rf 7. Use the rm command to delete the restoresymtable file: rm restoresymtable 8. Install the boot block on the new boot disk.
B – FCode Building the Bootable Disk 14. Create an alias entry for the new boot device (optional). For example: ok nvalias fibredisk /pci@1f,0/pci@1/QLGC,qla@4/sd@82,0 15. Set default boot device to be the new boot device (optional).
Building the Bootable Disk B-8 B – FCode FC0153302-00 F