HP QLA Driver Kit
=================

This driver kit contains all the drivers and utilities needed to
deploy HP supported QLogic adapters on Linux.

Kit Contents
------------

This driver kit contains the following components:

Scripted RPM for QLA 7.x driver (hp_qla2x00src)
Scripted RPM for QLA 8.x driver (hp_qla2x00src)
Source RPM for QLA 7.x driver (hp_qla2x00)
Source RPM for QLA 8.x driver (hp_qla2x00)
Fibre Channel Utilities for x86 architecture (fibreutils)
Fibre Channel Utilities for x86_64 architecture (fibreutils)
Fibre Channel Utilities for ia64 architectures (fibreutils)
Driver parameter configuration script for 2.4 kernels (set_parm2.24)
Driver parameter configuration script for 2.6 kernels (set_parm2.26)
Master installation utility (INSTALL)
Revistion History (revision_history)

Installation
------------

Perform the following steps to install the HP QLA driver kit:

1. Untar the hp_qla2x00-<date>.tar.gz using the command:

	# tar zxvf hp_qla2x00-<date>.tar.gz

2. Change directory to the hp_qla2x00 directory that was just created

	# cd hp_qla2x00

3. Run the INSTALL script

	# ./INSTALL

The INSTALL script also has the following flags:

-a	compile driver for all kernels installed on the system
-f	turn on failover in the QLogic driver
-F	skip third party storage detection
-s	create binary RPM from source RPM
-u	uninstall driver kit components

Uninstall
---------

You can uninstall the driver kit components by using the -u flag of the
INSTALL script:

	# ./INSTALL -u

-or-

You can manually uninstall the kit by uninstalling the RPMs:

	# rpm -e hp_qla2x00src
	# rpm -e hp_qla2x00
	# rpm -e fibreutils


Using the Source RPM
--------------------

In some cases, you may have to build a binary RPM (hp_qla2x00) from the
source RPM and use that in place of the scripted RPM (hp_qla2x00src).
You will need to do this if your production servers do not have the kernel
sources and gcc installed.

If you need to build a binary RPM to install, you will need a development
machine with the same kernel as the production servers that you will be
deploying to.  You can then install the binary RPM produced on your 
production servers.  Note that the binary RPM that you build will
only work for that kernel and configuration that you build on.  Also note
that you should use the 7.x version of the hp_qla2x00 source RPM for 2.4
kernel based distributions and the 8.x version of the hp_qla2x00 source RPM
for 2.6 kernel based distributions.

To create the binary RPM from the source RPM do the following:

Issue the command:

# ./INSTALL -s

	-or-

1. Install the source rpm by issuing the command

	# rpm -ivh hp_qla2x00-<version>-<revision>.src.rpm

2. Depending on the distribution, change directory to

   Red Hat: /usr/src/redhat/SPECS
   SUSE: /usr/src/packages/SPECS

3. Build the RPM by using the rpmbuild command (the rpm command contains the
   RPM build functionality in some older distributions) using the command:

	# rpmbuild -bb hp_qla2x00.spec

4. At the end of the command output there should be a line that says
   "Wrote: ...rpm".  This line shows where the binary RPM is.

You should copy the binary RPM to the production servers and install it using
the command:

	# rpm -ivh hp_qla2x00-<version>-<revision>.<architecture>.rpm