Installing the Red Hat or SUSE Linux Drivers

Language:

After you download the drivers, as described in Downloading the Oracle Linux, Red Hat, or SUSE Linux Drivers, you can install the drivers by following the procedures in the order listed in this section:

To Build the FCoE Driver
Loading the Newly Built FCoE Driver
Deploying the Networking Driver

Note - You do not need to install any drivers for the Oracle Linux OS.

To Build the FCoE 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 for the host. You can then choose either to manually or automatically load the driver, as described in Loading the Newly Built FCoE Driver.

In the directory that contains the source driver file, qla2xxx-x.yy.zz-dist.tgz, enter the commands shown in the following example.
```
# tar -xvzf *.tgz
# cd qla2xxx-src-u.vv.ww.xx.yy.zz-k
```

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:
  For RHEL: /lib/modules/2.6.../kernel/drivers/scsi/qla2xxxFor SLES: /lib/modules/2.6.../update

Choose how you want to load the driver, as described in Loading the Newly Built FCoE Driver.

Loading the Newly Built FCoE Driver

After you build the FCoE driver, as described in To Build the FCoE Driver , you can choose to manually or automatically load the driver. This section contains the following topics:

To Manually Load the FCoE Driver

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

Build the driver binary, as described in To Build the FCoE Driver .

Manually load the driver by using the modprobe -v command.
Note - On SLES 11, before running the modprobe -v command, modify the /etc/modprobe.d/unsupported-modules file by changing the line, allow_unsupported_modules 0, to allow_unsupported_modules 1.
```
# modprobe -v qla2xxx
```

If you want to manually unload the driver, use the modprobe -r command.
```
# modprobe -r qla2xxx
```

To Automatically Load the FCoE Driver

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

Build the driver binary, as described in To Build the FCoE Driver .

Install the driver module (*.ko) files to the appropriate kernel module directory.
```
# ./extras/build.sh install
```

For SUSE Linux users, edit the /etc/sysconfig/kernel file and modify the INITRD_MODULES directive as shown in the following example.
```
 ...
INITRD_MODULES=".... qla2xxx"
...
```

Change to the /boot directory.

Back up the current RAMDISK image.

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

Build the RAMDISK image with the mkinitrd command.

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

Reboot the system to load the RAMDISK image with the driver.

Deploying the Networking Driver

Networking driver deployment includes creating, installing, and removing the driver. This section contains the following topics:

To Create the Driver

Move the base driver tar file to a directory; for example:
```
/home/user-name
```

Untar the archive by issuing the following command:
```
tar -xvzf qlge-x.x.x.x.tgz
```

Change to the driver src directory as follows:
```
cd qlge/
```

Compile the driver module by issuing the following command:
```
make install
```
The binary is installed as follows:
```
/lib/modules/[KERNEL_VERSION]/kernel/drivers/net/qlge/qlge.[k]o
```
Note - The install locations shown in this section are the default locations. Some Linux distributions might use other locations.

To Install the Driver

Load the module by issuing the following command:
```
modprobe -v qlge <parameter>=<value>
```
When utilizing an out-of-box driver for SLES 10 SP2, follow these steps to ensure that the module loads on reboot:

To Rebuild the Driver

Rebuild the RAMDISK as follows:
1. Open /etc/sysconfig/kernel.
2. Edit the INITRD_MODULES= line to append qlge; for example:
```
INITRD_MODULES=piix thermal fan reiserfs qlge
```
3. Issue the mkinitrd command; for example:
```
mkinitrd -i initrd-2.6.16.60-0.21-smp-qlge -k vmlinuz-2.6.16.60-0.21-smp -M boot/System.map-2.6.16.60-0.21-smp
```
  Note - Type the entire preceding command on a single line.
4. Modify the menu.lst file to include the new RAMDISK as an option to boot from.
5. Reboot the system.

Modify the variables in the sysconfig as follows:
1. Open the following file to edit:
```
/etc/sysconfig/kernel
```
2. Locate the following line:
```
MODULES_LOADED_ON_BOOT=""
```
3. Add qlge to the line; for example:
```
MODULES_LOADED_ON_BOOT="qlge"
```
4. Reboot to automatically load the module.
  If the module does not auto-load on reboot, follow this step (this should not be necessary with RHEL 5.3):
5. Open the /etc/modprobe.conf file and add the following line:
```
alias eth# qlge
```
  Where # is the Ethernet port number for the adapter.

To Remove the Driver

Issue the following command:
```
modprobe -r qlge
```
For Kernel 2.6.x, issue the rmmod command instead:
```
rmmod qlge
```

To uninstall the binary module, issue the following command:
```
make uninstall
```

To clean the driver build directory, issue the following command:
```
make clean
```