a) netxtreme2-<version>.src.rpm - NetXtreme II L2/cnic/bnx2fc/libfc/libfcoe
driver source RPM
b) netxtreme2-<version>.tar.gz - tar zipped NetXtreme II
L2/cnic/bnx2fc/libfc/libfcoe driver source
c) INSTALL.TXT - This file
d) README.<driver>.TXT - driver specific readme instructions,
where driver is bnx2, bnx2x, bnx2i, bnx2fc.
e) RELEASE.<driver>.TXT - release information text providing list of bug fixes
and enhancement for each driver.
Installing Source RPM Package
=============================
The following are general guidelines for installing the driver.
1. Install the source RPM package:
rpm -ivh netxtreme2-<version>.src.rpm
2. CD to the RPM path and build the binary driver for your kernel:
cd /usr/src/{redhat,OpenLinux,turbo,packages,rpm ..}
(For RHEL 6.0 and above, cd ~/rpmbuild )
rpm -bb SPECS/netxtreme2.spec
or
rpmbuild -bb SPECS/netxtreme2.spec (for RPM version 4.x.x)
Note that the RPM path is different for different Linux distributions.
The driver will be compiled for the running kernel by default. To build
the driver for a kernel different than the running one, specify the
kernel by defining it in KVER:
rpmbuild -bb SPECS/netxtreme2.spec --define "KVER <kernel version>"
where <kernel version> in the form of 2.x.y-z is the version of another
kernel that is installed on the system.
3. Install the newly built package (driver and man page):
rpm -ivh RPMS/<arch>/netxtreme2-<version>.<arch>.rpm
where <arch> is the machine architecture such as i386:
rpm -ivh RPMS/i386/netxtreme2-<version>.i386.rpm
Note that the --force option may be needed on some Linux distributions
if conflicts are reported.
The drivers will be installed in the following path:
2.4.x kernels:
/lib/modules/<kernel_version>/kernel/drivers/net/bnx2.o
/lib/modules/<kernel_version>/kernel/drivers/net/bnx2x.o
2.6.0 kernels:
/lib/modules/<kernel_version>/kernel/drivers/net/bnx2.ko
/lib/modules/<kernel_version>/kernel/drivers/net/bnx2x.ko
2.6.16 and newer kernels:
/lib/modules/<kernel_version>/kernel/drivers/net/bnx2.ko
/lib/modules/<kernel_version>/kernel/drivers/net/bnx2x.ko
/lib/modules/<kernel_version>/kernel/drivers/net/cnic.ko
Newer RHEL and SLES distros:
/lib/modules/<kernel_version>/updates/bnx2.ko
/lib/modules/<kernel_version>/updates/cnic.ko
/lib/modules/<kernel_version>/updates/bnx2x.ko
/lib/modules/<kernel_version>/updates/bnx2i.ko
/lib/modules/<kernel_version>/updates/bnx2fc.ko
4. Unload existing driver if necessary:
rmmod bnx2
rmmod bnx2x
If the cnic driver is loaded, it should also be unloaded along with dependent
drivers:
rmmod bnx2fc
rmmod bnx2i
rmmod cnic
5. Load the bnx2 driver for the BCM5706/BCM5708/5709/5716 devices:
insmod bnx2.o
or
insmod bnx2.ko (on 2.6.x kernels)
or
modprobe bnx2
To load the bnx2x driver for the BCM57710/BCM57711/BCM57711E/BCM57712 devices:
insmod bnx2x.o
or
insmod bnx2x.ko (on 2.6.x kernels)
or
modprobe bnx2x
To load the cnic driver:
insmod cnic.ko
or
modprobe cnic
To load the bnx2i driver:
insmod bnx2i.ko
or
modprobe bnx2i
service iscsid restart (Please refer REDAME.bnx2i.txt for more details
about iSCSI operation)
To load the bnx2fc driver for BCM57712 device:
insmod bnx2fc.ko
or
modprobe bnx2fc
service fcoe start (Please refer README.bnx2fc.txt for more details about
FCoE operation)
Note that the inbox kernel may have an older version of bnx2, bnx2x and cnic
driver. It is important for FCoE offload user to unload these inbox versions
before attempting to load bnx2fc driver. There are 2 options to reach the
desired goal,
a) Reboot the server
OR
b) If already loaded, unload inbox bnx2, bnx2x, cnic drivers and load newly
installed version from netxtreme2-foce package using 'modprobe <DRV-NAME>'
NOTE: Driver upgrade (rpm -Uvh) is not supported.
NOTE: On SLES 11, change "allow_unsupported_modules" parameter value of
/etc/modprobe.d/unsupport-modules' from 0 to 1, until bnx2fc driver
is inbox. Failing to do so will not load bnx2fc.
6. To configure network protocol and address, refer to various Linux
documentations.
Building Driver From TAR File
=============================
The following are general guidelines for installing the driver.
1. Create a directory and extract the files:
tar xvzf netxtreme2-<version>.tar.gz
2. Build the drivers as a loadable module for the running kernel:
make
The driver will be compiled for the running kernel by default. To build
the driver for a kernel different than the running one, specify the
kernel by defining it in KVER:
make KVER=<kernel version>
where <kernel version> in the form of 2.x.y-z is the version of another
kernel that is installed on the system.
3. Test the driver by loading it (Same procedures as described in the
Source RPM section above).
4. Install the driver and man page:
make install
See RPM instructions above for the location of the installed driver.
5. To configure network protocol and address, refer to various Linux
documentations.
Unloading and Removing Driver
=============================
If the driver was installed using rpm, do the following to remove it:
rpm -e nextreme2
Note - this will remove libfc2, libfcoe2, bnx2, bnx2x and cnic modules as well