This document describes the following:

  *  Configuring the Linux kernel to detect MSA1000 LUNs
  *  Building and installing an FCA2214 HBA driver from source code



   ****************************** NOTE ******************************
   Building the FCA2214 HBA driver, and editing the Linux kernel
   using the original source code supplied on this CD is done at 
   your own risk.  The code is provided "as is", and Hewlett-Packard 
   Company makes no express or implied warranty of any kind.
   ******************************************************************


---------------------------------------------------
Configuring the Linux kernel to detect MSA1000 LUNs
---------------------------------------------------

Before any LUNs will be visible on Linux kernel 2.4.x, it must 
be rebuilt with a slight change made to the kernel source:

1. Install the kernel source RPM from the Linux distribution CD (If not already installed).

   - mount the installation CD-ROM of your Linux distribution that contains
     the kernel source RPM file.  The file will be named kernel-source-XXX.i386.rpm,
     where XXX is the version of your kernel.

   - Change to the directory on the CD where the kernel source RPM file is located.

   - Issue the command to install the package: 

        rpm -Uvh kernel-source-XXX.i386.rpm


* NOTE: steps 2-4 can be automated using the script, msainstall, provided in the 
        /HBA/Linux directory on the MSA1000 Software Support CD. To run the 
        script, change to /HBA/Linux directory on the CD and type: ./msainstall


2. Edit the file /usr/src/linux-<kernel-version>/drivers/scsi/scsi_scan.c

   - Find the line that reads '{"COMPAQ","LOGICAL VOLUME","*", BLIST_FORCELUN},'

   - Insert the following line before it '{"COMPAQ","MSA1000","*", BLIST_SPARSELUN},'
     (Omit single quotes before and after the string, when entering the line.)

3. Save the file and build a custom kernel image.

4. Configure your system to boot to the new kernel image by default.

5. Reboot Linux onto the new default kernel image.


-------------------------------------------------------------------
Building and installing an FCA2214 HBA driver (qla2x00src-vXXX.tgz) 
from source code for Linux Kernel Version 2.4.2 or Later
-------------------------------------------------------------------

   1. Install kernel-source and kernel-headers RPMs from the 
         Linux distribution CDs (If not already installed).
      
      - mount the installation CD-ROM of your Linux distribution that contains
        the kernel source RPM file.  The file will be named kernel-source-XXX.i386.rpm,
        where XXX is the version of your kernel.

      - Change to the directory on the CD where the kernel source RPM file is located.

      - Issue the command to install the package: 

           rpm -Uvh kernel-source-XXX.i386.rpm

      - mount the installation CD-ROM of your Linux distribution that contains
        the kernel headers RPM file.  The file will be named kernel-headers-XXX.i386.rpm,
        where XXX is the version of your kernel.

      - Change to the directory on the CD where the kernel headers RPM file is located.

      - Issue the command to install the package: 

           rpm -Uvh kernel-headers-XXX.i386.rpm

   2. Untar the FCA2214 driver source to a temporary folder. 

   3. Build the FCA2214 driver.

      - For Red Hat 7.1/7.2:
        For uni-processor, issue the command:   

           make all 

        For multiprocessor, issue the command:  

           make all SMP=1

      - For SuSE 7.3/Enterprise 7:
        For uni-processor, issue the command:

           make all OSVER=linux

        For multiprocessor, issue the command:

           make all SMP=1 OSVER=linux

   4. Issue the command to install the FCA2214 driver:
         
         make install

   5. Issue the command to load the FCA2214 driver:

         insmod qla2300


After the driver module is loaded, there will be a listing for the MSA1000
Controller as well as any configured LUNs in /proc/scsi/scsi.  If the
entries for configured LUNs are missing, please refer to the first section 
of this document. 

For more detailed instructions, refer to the README.qla2x00 file inside 
the FCA2214 driver source archive.