Installing the Red Hat or SUSE
Linux Drivers
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
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:
- 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 the preceding 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:
- Open /etc/sysconfig/kernel.
- Edit the INITRD_MODULES= line
to append qlge; for example:
INITRD_MODULES=piix thermal fan reiserfs qlge
- 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.
- Modify the menu.lst file
to include the new RAMDISK as an option to boot from.
- Reboot the system.
- Modify the variables in the sysconfig as
follows:
- Open the following
file to edit:
/etc/sysconfig/kernel
- Locate the following line:
MODULES_LOADED_ON_BOOT=""
- Add qlge to
the line; for example:
MODULES_LOADED_ON_BOOT="qlge"
- 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):
- 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