QLogic QLA2x00 Fibre Channel Driver for RedHat Linux 6.2 (x86)                                Contents --------1. OS Support2. Supported Features2.1. ISP2100 Features2.2. ISP2200 Features2.3. Extended LUN Support3. Release History4. Creating the Driver Diskette4.1. Driver Diskette for Fresh Installation4.2. Driver Diskette for Adding the QLogic Controller to Existing OS4.3. Driver Diskette that Contains the Source Code5. Installing the Driver 5.1. Fresh OS Installation with the QLogic Controller as Boot5.1.1 Fresh OS Installation with the QLogic Controller as Boot       (Work-around)5.2. Fresh OS Installation with the QLogic Controller as Add-On5.3. Adding the QLogic Controller to the Existing OS6. Loading the Driver6.1 Loading the Driver Automatically6.1.1 Building a Custom Kernel to Load the Driver 6.1.2 Building a Ramdisk Image to Load the Driver6.2. Loading the Driver Manually7. Removing the Driver8. Driver Parameters8.1. System Parameters8.2. NVRAM Parameters8.3  Driver Command Line Parameters9. Limitations10. Additional Notes10.1 Proc Filesystem Support10.2 Adding QLogic Driver to the Kernel10.3 Building a Driver from the Sources10.3.1 Building an Uni-Processor (UP) Version of the Ddriver10.3.2 Building Symmetric Multi-Processor (SMP) Version of the Driver11. Diskette Content12. Contacting QLogic======================================================================1. OS Support -------------This driver works with RedHat Linux 6.2 which is Linux kernel version2.2.14-5.0 (x86) operating system. Earlier or later versions of RedHatLinux are not supported in this release. The modules included in thisrelease will load on RedHat 6.2 only. However, the source code is alsoprovided to compile your own version of the driver should it be required.======================================================================2. Supported Features---------------------2.1. ISP2100 Features---------------------* FCAL - direct attach loop * Fabric support * Initiator mode only * Fault recovery on down loops* Persistent binding2.2. ISP2200 Features---------------------* FCAL - direct attach loop* Point-to-point* Fabric support* Initiator mode only* Fault recovery on down loops* Persistent binding2.3. Extended LUN Support-------------------------We support the number of LUNs the kernel does up to 255. ======================================================================3. Release History ------------------Please refer to Release Notes.======================================================================4. Creating the Driver Diskette-------------------------------4.1. Driver Diskette for Fresh Installation-------------------------------------------Download 2x00_boot2.23.zip file from QLogic's website. If prompted "What would you like to do with this file?" choose "Save this programto disk". Specify a temporary location on the hard drive and downloadthe driver. Insert a blank diskette and run the self-extracting fileyou just downloaded specifying A:\ for "Unzip To Folder:". The diskette should contain the following files:    Modules.cgz    Modinfo    Rhdd-6.1    Modules.dep    Pcitable4.2. Driver Diskette for Adding the QLogic Controller to Existing OS--------------------------------------------------------------------Download qla2x00-2.23-0.i386.rpm file from QLogic's website. If prompted "What would you like to do with this file?" choose "Save this program to disk". Insert a blank diskette and download to the diskette directly.4.3. Driver Diskette that Contains the Source Code--------------------------------------------------Download qla2x00src-v2.23.tgz file from QLogic's website. If prompted"What would you like to do with this file?" choose "Save this programto disk". Insert a blank diskette and download to the diskette directly.======================================================================5. Installing the Driver ------------------------This section is divided into the following three sections.1. Fresh OS installation with the QLogic Controller as Boot2. Fresh OS installation with the QLogic Controller as Add-on3. Adding the QLogic Controller to the Existing OS5.1. Fresh OS Installation with the QLogic Controller as Boot --------------------------------------------------------------------Note: Due to the incompatibility between the embedded qlogicfc.o       objective file within the RedHat Linux v6.2 and qla2x00, the       fresh installation will have some difficulties loading our       qla2x00.o modules during system reboots after the installation.      Please read the "Work-around" section on how to perform the       fresh installation. In the future release of RedHat, this issue      will be resolved. Perform the following steps to install RedHat on the Fibre Channeldrive attached to the QLA2x00 controller. These steps outlinethe procedure when installing from an IDE CDROM.1. Insert the RedHat Installation floppy and boot the computer. When   the computer comes up, it will display the welcome window and boot   prompt. You then must type one of the following:       boot: expert (for graphical mode)   OR       boot: expert text (for text mode)2. During the installation process, the system will ask you to insert   the driver diskette. Insert the diskette created in Section 4.1,    then tab to OK, and hit Enter.3. After selecting the language and keyboard settings, the system    will ask you to select an "Installation Method". Select the "Local   CDROM" and tab to OK. 4. Next the system will ask for Devices. Select "Add Device" and    select "SCSI" in the following screen. Tab to OK.5. Once Install displays the list of possible devices, stroll down to   the bottom of the list and select the qla2x00 modules. The system    will load the selected module.6. If the device for the selected module is detected, it will be   listed in the following screen under "I have found the following   devices". Select Done.7. Continue the RedHat installation with the QLogic driver.   ======================================================================5.1.1 Fresh OS Installation with the QLogic Controller as Boot       (Work-around)--------------------------------------------------------------1. Insert the RedHat Installation floppy and boot the computer. When   the computer comes up, it will display the welcome window and boot   prompt. Type the following at the boot prompt:       boot: expert text2. Follow the instructions from step 2 through 7 as descbribed in    Section 5.1 until the system prompt for making a "boot" diskette.3. Once system prompts for making a "boot" diskette, please insert a   blank floppy disk.4. Press <ALT> and <F2> simultaneously to bring up a new screen's    console, i.e.,        bash#5. Perform to following tasks:   a) # cd /mnt/sysimage/etc      # PATH=$PATH:/mnt/sysimage/bin      # vi conf.modules (Use vi editor or equivalent)   b) Remove the line that contains "qlogicfc"    c) Exit and save conf.modules   d) Press <ALT> and <F1> to bring back the "Installation" screen.   e) Continue and finish with the installation.  At this time the      "boot" diskette has been saved.6. Reboot the system with the "boot" diskette that you created in    step 5.7. Once system boots up, open a new terminal (console) and perform the   following to build the "ramdisk" image:   a) # cd /boot   b) * If your computer is a multi-processor system, type:      # mkinitrd -f initrd-2.2.14-5.0smp.img 2.2.14-5.0smp      * If your computer is a single-processor system, type:      # mkinitrd -f initrd-2.2.14-5.0.img 2.2.14-5.0   Note: "2.2.14-5.0" or "2.2.14-5.0smp" is the subdirectory under         /lib/modules/"kernel_release" where the qla2x00.o module         resides. The command "uname -r" will display the current         release.   c) Load a new lilo file by executing this command:          # /sbin/lilo======================================================================5.2. Fresh OS Installation with the QLogic Controller as Add-On---------------------------------------------------------------Perform the following steps to install RedHat and the QLogic driver on device not attached to the QLA2x00 controller. Same as section 5.1.IMPORTANT!  The QLA2x00 controller must be present in the system             in order to install its module. ======================================================================5.3. Adding the QLogic Controller to the Existing OS----------------------------------------------------Perform the following steps if you want to add a new driver or upgradethe existing driver to a newer version.1. Create a directory for the *.rpm files unless it already exists.       # mkdir /home/qla2x002. Change the current directory to the RedHat 6.2 driver directory:       # cd /home/qla2x003. Insert the rpm diskette you created in Section 4.2 and copy the   files to the current directory:       # mcopy a:qla2x00-2.23-0.i386.rpm . (do not ignore the (.) at                                            the end)4. To invoke the RedHat RPM package manager to install the QLogic    drivers for the first time, type command:       # rpm -iv qla2x00-2.23-0.i386.rpm   If you are updating the QLogic drivers use the following option to   upgrade the drivers. Type command:       # rpm -iv --force   qla2x00-2.23-0.i386.rpm5. At this point, the QLogic driver is installed on your boot drive.   However, the driver needs to be loaded before the system can access   the devices attached to the QLogic controller. See the next section   for Loading the driver.======================================================================6. Loading the Driver---------------------You do not need to perform these steps to load the driver if you already installed the driver using the steps in section 5.1, 5.1.1, or 5.2. Perform these steps only when you are adding the driver to the existing OS. There are two ways to load the driver: automatically and manually.6.1. Loading the Driver Automatically-------------------------------------The kernel will automatically load the QLogic driver at boot time, ifyou included it in a custom kernel, or load it via the ramdisk image.6.1.1 Building a Custom Kernel to Load the Driver-------------------------------------------------1. Using the diskette you created in Section 4.3, copy the   qla2x00src-v2.23.tgz file to /home/qla2x00. Follow these steps:       # cd /home       # mkdir qla2x00       # cd /home/qla2x00       # mcopy a:*.tgz .       # tar -xvzf qla*.tgz2. Extract the kernel-headers and kernel-sources RPM files from the    first RedHat CD:       # cd /mnt/cdrom/RedHat/RPMS       # rpm -iv kernel-headers*.rpm       # rpm -iv kernel-source*.rpm 3. Follow the instructions on AddKernel.txt before continuing to    step 4.4. Build the SMP kernel by first changing to the source directory       # cd /usr/src/linux5. # make mrproper (This removes everything. You need to do this when                    you build a SMP kernel for the first time.)6. # make menuconfig    ->Select SCSI Support <Enter>   ->Select SCSI Low Level Drivers <Enter>   ->Scroll down and look for QLogic HBA name,      i.e. QLA2x00 Support <New>   ->Hit <space bar> twice to select the (*)QLA2x00 Support   ->Select Exit until you go back to the Main Menu.   Note: Perform the steps (a) and (b) only if you're building an SMP         kernel on a multi-processor (SMP) system.         (a)->select "Processor type and features" and hit <space bar>         (b)->select "Symmetric multiproccessor" and hit <space bar>