Installing the Red Hat or SUSE Linux Drivers

After you download the drivers, as described in Downloading the Red Hat or SUSE Linux Drivers, you can install the drivers by following the steps in these sections:

1. To Build the Fibre Channel Driver

2. To Load the Newly Built Fibre Channel Driver

3. To Build and Load the Ethernet HBA Driver

To Build the Fibre Channel Driver

The driver installation makes extensive use of the build.sh script, which is located in driver source (extras/build.sh).

From the source code, you can build a qla2xxx.ko module and a qla2xxx_conf.ko module for the host. You can then choose to load the driver manually or automatically, as described in To Load the Newly Built Fibre Channel Driver.

1. In the directory that contains the source driver file, qla2xxx-x.yy.zz-dist.tgz, use the commands shown in the following example.

   # tar -xvzf *.tgz
   # cd qlogic
   # ./drvrsetup (this extracts the source files directory into the current directory)
   # cd qla2xxx-x.yy.zz (x.yy indicates the driver version; zz indicates the file extension, which is typically .ko for kernel modules (binaries)).
   

2. Build and install the driver modules from the source code by executing the build.sh script.

   # ./extras/build.sh install
   

   This build script does the following:

   • Builds the driver .ko files.
   • Copies the .ko files to the appropriate directory: /lib/modules/2.6.../kernel/drivers/scsi/qla2xxx
   • Adds the appropriate directive in the modprobe.conf.local to remove the qla2xxx_conf module when unloading the qla2xxx module.
   • Updates the newly built qla2xxx_conf.ko module with any previously saved data in /etc/qla2xxx.conf.
3. Choose how you want to load the driver, as described in To Load the Newly Built Fibre Channel Driver.

To Load the Newly Built Fibre Channel Driver

• After you build the Fibre Channel driver, as described in To Build the Fibre Channel Driver , perform one of the following procedures:
  • To Manually Load the Fibre Channel Driver
  • To Automatically Load the Fibre Channel Driver

To Manually Load the Fibre Channel Driver

After building the Fibre Channel driver, you can choose to manually load the driver. If you want to automatically load the driver, skip to To Automatically Load the Fibre Channel Driver.

1. Build the driver binary, as described in To Build the Fibre Channel Driver .
2. Manually load the driver by using the modprobe -v command.

   # modprobe -v qla2xxx
   

3. When the Fibre Channel driver is manually loaded, you can build and load the Ethernet driver, as described in To Build and Load the Ethernet HBA Driver.
4. If you want to manually unload the driver, use the modprobe -r command.

   # modprobe -r qla2xxx
   # modprobe -r qla2xxx_conf (for use only with the SANsurfer FC HBA CLI utility)
   

To Automatically Load the Fibre Channel Driver

After building the Fibre Channel driver, you can choose to automatically load the driver. If you want to manually load the Fibre Channel driver, see To Manually Load the Fibre Channel Driver.

1. Build the driver binary, as described in To Build the Fibre Channel Driver .
2. Install the driver module (*.ko) files to the appropriate kernel module directory.

   # ./extras/build.sh install
   

3. For Red Hat Linux users, edit the /etc/modprobe.conf file and add the following entries, if they are not present:
   • alias scsi_hostadapter1 qla2xxx_conf (for use only with SANsurfer FC HBA CLI)
   • alias scsi_hostadapter2 qla2xxx
4. For SUSE Linux users, edit the /etc/sysconfig/kernel file and modify the INITRD_MODULES directive as shown in the following example.

   In this example, note that you must add the first module, qla2xxx_conf (for SANsurfer FC HBA CLI), followed by the qla2xxx module. The qla2xxx_conf module is for use only with SANsurfer FC HBA CLI while the qla2xxx module is a common module.

    ...
   INITRD_MODULES=".... qla2xxx_conf qla2xxx"
   ...
   

5. Change to the /boot directory.
6. Back up the current RAMDISK image.

   # cp -f initrd-2.6.kernel-version.img initrd-2.6.kernel-version.img.bak
   

7. Build the RAMDISK image with the mkinitrd -f command.

   Red Hat: # mkinitrd -f initrd-2.6.kernel-version.img kernel-version
   SUSE: # /sbin/mk_initrd
   

8. Reboot the system to load the RAMDISK image with the driver.
9. You can now build and load the Ethernet driver, as described in To Build and Load the Ethernet HBA Driver.

To Build and Load the Ethernet HBA Driver

1. Build the Ethernet HBA driver.

    # rpmbuild --rebuild sun-pci-e-dual-gigabit-kernel-6.1.5.src.rpm
   

2. Change to the rpm directory.

    # cd /usr/src/redhat/RPMS/arch
   

3. Install the Ethernet rpms, using the same command for both Red Hat and SUSE OSes.

   # rpm -ivh sun-pci-e-dual-gigabit-kernel-6.1.5.rpm
   

4. Use the depmod command to register the HBA.

   # depmod
   

5. Manually load the e1000 driver for all instances.

   # modprobe e1000g