720-0128-00 Rev A 1

Linux Driver Installation

Note: Before installing the 3ware 9550SX driver, you must have already installed your
3ware RAID controller in the system. Consult the 9550SX Install Guide for how to do
this. You can download the 9550SX documentation (Install, User and CLI guides) from:
http://www.3ware.com/support/userdocs.asp
A drive or unit managed by the 3ware RAID controller may be configured to be your
systems boot device. Or, you can use another device as your boot device, such as a disk
attached to the motherboard.
These steps assume that you do not have a 9500S installed in the system already. If you
already have a system with a 9500S and you wish to add the 9550SX to that same system,
you will need to upgrade the 9500S driver, 3DM 2, and/or CLI with the versions for the
9550SX.
The steps you follow to install the driver and make your RAID unit available depend on
which version of Linux you are using, and whether it will be your boot device. This
chapter provides step-by-step instructions for the following situations:
Red Hat / Fedora Core Linux Installation
Installing the 3ware driver and Red Hat Linux on a new drive or unit
Installing the 3ware driver on a system that boots Red Hat Linux from a different
device.

SuSE Linux Installation
Installing the 3ware driver and SuSE Linux with YaST2 on a new drive or unit.
Installing the 3ware driver on a system that boots SuSE Linux from a different
device.
The 9.3 code set provides compiled drivers for these versions of Linux:
Fedora Core 4 for AMD and Intel Platforms (32-bit & 64-bit)
RedHat Workstation 4 (no update) for AMD and Intel Platforms (32-bit & 64-bit)
SuSE 9.3 Pro for AMD and Intel Platforms (32-bit & 64-bit)
SuSE Linux Enterprise Server 9.0 for AMD and Intel Platforms (32-bit & 64-bit)

If you are using a Linux distribution for which there is not a compiled driver available
from 3ware, you can copy the source from the 3ware software CD or download the
source from the 3ware website and compile a new driver. For more information, see
3ware knowledgebase article 12690 at http://www.3ware.com/kb/article.aspx?id=12690.


720-0128-00 Rev A 2

Obtaining 3ware Linux Drivers
Obtain the 3ware driver for Linux from one of these two sources:
3ware software CD-ROM. Compiled and tested drivers for Red Hat and SuSE
Linux are included on this CD.

3ware web site. You can download the latest compiled and tested driver for
supported Linux distributions from the 3ware web site at
http://www.3ware.com/support/index.asp. Included in these downloads is the Linux
driver source, which you can use to compile the latest driver for RedHat, SuSE, and other
versions of Linux.
Be Sure to Use the Correct Drivers
The Linux 3w-9xxx drivers included on the 3ware CD are for 3ware 9550SX and 9500S
series controllers. 3ware 7/8000 series controllers use a Linux driver labeled 3w-xxxx.
The drivers for the 9000 series controllers and the 7/8000 series controllers are not
interchangeable, but can be used together when both controller types are installed in the
same system. The examples in these release notes refer only to the 9000 series driver
(9550SX and 9500S). For information about using the 7/8000 driver and controller, refer
to the user guide or installation procedure for the 7/8000-series controller.

Warning: Be sure to use the correct driver for your processor. Be sure you load the
correct driver on your system. It is possible to load the wrong driver onto a system,
however when you boot such systems, they will not work.

For Red Hat, AMCC offers the following drivers:

x86 32-bit for Intel x86 and AMD Athlon
AMD 64-bit, used for both AMD Opteron and Intel 64-bit Xeon (EM64T)

For SuSE, AMCC offers the following drivers:

x86 32-bit, for Intel x86 and AMD Athlon
AMD 64-bit, for AMD Opteron and Intel 64-bit Xeon (EM64T)
Determining the Current Version of your 3ware Driver
If you already have a 3ware controller installed, you can check the current driver version.
You can use 3DM 2 or the CLI to check the version of your driver. Check the 9550SX
Users Guide for instructions on how to do this.
If you have a 2.4 kernel or earlier, type the following command: cat /proc/scsi/3w-9xxx/*


720-0128-00 Rev A 3
where the asterisk (*) represents SCSI host ID and 9xxx represents the family of the
controller. For example: cat /proc/scsi/3w-9xxx/0
If you have a 2.6 kernels with sysfs, type the following command:
cat /sys/class/scsi_host/<hostid>/stats
where <hostid> is usually host0, unless other SCSI devices are available, in which case it
may be host1 or higher.
If you have a 2.6 kernel without sysfs, type the following command:
dmesg | grep 3w
(dmesg can also be used with earlier kernel versions.)
Driver Installation Under Red Hat Linux (these instructions also apply to Fedora Core
4)
Materials required
3ware software CD-ROM
Floppy diskette, if you need to create a driver diskette.
Red Hat Linux installation CD-ROM and boot disk. (Not required if Red Hat Linux
is already installed on another drive.)
Creating a Red Hat Linux Driver Diskette
If you are installing Linux on the new drive or unit managed by the 3ware RAID
controller, you must create a 3ware driver diskette. If Linux is already installed on
another device, you may install the 3ware driver from either the 3ware software CD-
ROM or make a driver diskette. To create a driver diskette
1 Insert the 3ware software CD into your system.
2 When the 3ware Escalade Menu appears, click the Driver & Firmware Disks
button.
3 In the 3ware Driver & Firmware Disk Images menu, click the button for the driver
disk you want to create. A confirmation window opens.
4 Insert a blank diskette into a drive and click the Yes button to begin creating the
driver floppy diskette.
Note: If you need to create a Linux driver diskette for a Linux distribution other that
what is available on the menu, see 3ware knowledgebase article 11843
http://www.3ware.com/kb/article.aspx?id=11843
Installing the 3ware Driver and Red Hat Linux on a New Unit

Note: If Red Hat Linux is already installed and bootable on another drive, see the section
called Installing the 3ware Driver on a Red Hat Linux System that Boots From a
Different Device.


720-0128-00 Rev A 4

Note: We have tested some older systems where an IDE drive connected to the
motherboard interfered with using a drive or unit managed by the 3ware RAID controller
as a boot device. Disconnecting the IDE drive while installing Linux will eliminate this
problem. After Linux is installed, the drive can be reconnected.
1 Boot with the Red Hat CD or diskette:
Insert either the Red Hat CD-ROM disk or a Red Hat boot diskette into
your computer.
Start or reboot your computer.
When the Welcome to Red Hat display appears, type expert at the boot
prompt. boot: linux dd A number of files will load and then a message
will prompt you to insert your driver disk.
2 Install the driver:
Insert the driver diskette containing the 3ware driver for Red Hat and press Enter.
The system automatically reports: Loading 3w-9xxx driver
3 When prompted, select the proper language and keyboard types for your locality.
4 If asked for what type of media, select Local CD-ROM since you are installing
from the Red Hat CD-ROM.
Installing the 3ware Driver on a Red Hat Linux System that Boots From a Different
Device
The steps for installing the 3ware driver vary slightly, depending on your specific
installation requirements. Select the appropriate set of steps below, based on whether:

You want to update the RAM disk
You prefer to load the driver manually or from a script, instead of updating the RAM

About Variables In the Driver Installation Instructions
These conventions are used for variable text for kernel strings and module names in the
instructions on the following pages. Kernel String Conventions <kernel string> refers to
the kernel version.
The kernel string will have different endings, depending on the kernel you are using.
For an SMP kernel (multi-processor), the kernel string will end in smp. For example:
2.6.11-smp.
For an Enterprise kernel, the kernel string will end in enterprise. For example:
2.6.11-enterprise
For a Bigmem kernel, the kernel string will end in bigmem. For example: 2.6.11-
bigmem


720-0128-00 Rev A 5
For a Hugemem kernel, the kernel string will end in hugemem. For example: 2.6.11-
hugmem

Module Naming Conventions

3w-9xxx.* refers to the specific module you will copy in the examples shown in steps 3
and 4. The name of the module you will copy (3w-9xxx.*) varies, depending on the
kernel; however you will always copy it to a file named 3w-9xxx.o for 2.4 kernels, or
3w-9xxx.ko for 2.6 kernels.

The available module files are:

For UP kernels: 3w-9xxx.ko
For SMP kernels: 3w-9xxx.smp
For Enterprise kernels: 3w-9xxx.ent
For Bigmem kernels: 3w-9xxx.big
For Hugemem kernels: 3w-9xxx.hug
For IA32E kernels: 3w-9xxx.i32

To install the 3ware driver and update the RAM disk
1 Log in as root and open a console window.
2 Mount the CD which contains the 3ware driver: To mount the CD, type: mount
/dev/cdrom and press Enter.
3 Copy the driver:
For Redhat workstation 4 on Intel x86 and AMD, type:

cp /mnt/cdrom/packages/drivers/linux/redhat/ws4/x86/3w-9xxx.* /lib/modules/<put
kernel string here>/kernel/drivers/scsi/ 3w-9xxx.ko

If prompted to overwrite, type y.

For 64-bit versions of Redhat workstation on Intel x86 and AMD, type:
cp /mnt/cdrom/packages/drivers/linux/redhat/ws4/x86_64/3w-9xxx.ko /lib/modules/<put
kernel string here>/kernel/drivers/scsi/ 3w-9xxx.ko
For 64-bit versions of Redhat workstation on 64-bit processors AMD Opteron or Intel
EM64T, type:
cp /mnt/cdrom/packages/drivers/linux/redhat/ws4/x86_64/3w-9xxx.smp
/lib/modules/<put kernel string here>/kernel/drivers/scsi/ 3w-9xxx.ko

If prompted to overwrite, type y.


720-0128-00 Rev A 6
4 If you installed a previous driver when you installed your operating system, then
perform this step to copy the driver into the update directory, as well. Otherwise, go
on to Step 5.
For Redhat workstation on Intel x86 and AMD, type:
cp /mnt/cdrom/packages/drivers/linux/redhat/ws4/x86/3w-9xxx.* /lib/modules/<put
kernel string here>/update 3w-9xxx.ko
If prompted to overwrite, type y.
For Redhat workstation on AMD Opteron and EM64T, type:
cp /mnt/cdrom/packages/drivers/linux/redhat/ ws4/x86_64/3w-9xxx.*
/lib/modules/<put kernel string here>/update 3w-9xxx.ko
If prompted to overwrite, type y.
Note: Use the appropriate module name and kernel string, as described under About
Variables In the Driver Installation Instructions.
5 For 2.4 Kernels, add the following line to /etc/modules.conf:

alias scsi_hostadapter 3w-9xxx.o

For 2.6 Kernels, add the following line to /etc/modprobe.conf

alias scsi_hostadapter 3w-9xxx.ko

6 Update the modules.dep file, by issuing the following command:
Run /sbin/depmod -a
7 Run mkinitrd by entering the following:
/sbin/mkinitrd -v -f /boot/initrd-<kernel string>.img <kernel string1>
where <kernel string1> is the /lib/modules directory from which to copy the 3w-9xxx
driver. Example: /sbin/mkinitrd v f /boot/initrd-2.4.18-14.img 2.4.18-14
8 If you are using the GRUB boot loader, skip to Step 5. If you are using the LILO
boot loader, run LILO to update the boot record on disk by typing the following:
/sbin/lilo
The output should be similar to:
Added linux *
9 Reboot.
The 3ware driver will be loaded from the ram disk automatically at boot time. To
install the 3ware driver and load the driver manually instead of using a RAM disk


720-0128-00 Rev A 7
1 Log in as root and open a console window.
2 Mount the CD which contains the 3ware driver. To mount the CD, type:
mount /dev/cdrom and press Enter.
3 Copy the driver.
For Redhat workstation on Intel x86 and AMD x86, type:
cp /mnt/cdrom/packages/drivers/linux/redhat/ws4/x86/3w-9xxx.* /lib/modules/<put
kernel string here>/kernel/drivers/scsi/ 3w-9xxx.ko
If prompted to overwrite, type y.
For Redhat workstation on AMD Opteron and EM64T, type:
cp /mnt/cdrom/packages/drivers/linux/redhat/ ws4/x86_64/3w-9xxx.*
/lib/modules/<put kernel string here>/kernel/drivers/scsi/ 3w-9xxx.ko
If prompted to overwrite, type y.
Note: Use the appropriate module name and kernel string, as described under About
Variables In the Driver Installation Instructions.
4 If you installed a previous driver when you installed your operating system, then
perform this step to copy the driver into the update directory, as well. Otherwise, go
on to Step 5.

For Redhat workstation on AMD Opteron and EM64T, type:

cp /mnt/cdrom/packages/drivers/linux/redhat/ ws3_u3/x86_64/3w-9xxx.*
/lib/modules/<put kernel string here>/update 3w-9xxx.ko

If prompted to overwrite, type y.

Note: Use the appropriate module name and kernel string, as described under About
Variables In the Driver Installation Instructions.

5 Add the following line to /etc/modules.conf:
alias scsi_hostadapter 3w-9xxx
6 Update the modules.dep file, by issuing the following command:
Run /sbin/depmod -a
7 Load the driver manually. Type:

modprobe 3w-9xxx

You can also incorporate the insmod command into a startup script.


720-0128-00 Rev A 8
Compiling a 3ware Driver for Linux
If you are using a Linux distribution for which there is not a compiled driver available
from 3ware, you can copy the source from the 3ware software CD or download the
source from the 3ware website and compile a new driver. For more information, see
3ware knowledgebase article 12690 at http://www.3ware.com/kb/article.aspx?id=12690.
Creating a SuSE Linux Driver Diskette
If you are installing Linux on the new drive or unit managed by the 3ware RAID
controller, you must create a 3ware driver diskette. If Linux is already installed on
another device, you may install the 3ware driver from the 3ware software CD-ROM. To
create a driver diskette
1 Insert the 3ware software CD into your system.
2 When the 3ware Escalade Menu appears, click Driver and Firmware Disks.
3 In the 3ware Driver and Firmware Disk Images menu, click the button for the driver
disk you want to create. A confirmation window opens.
4 Insert a blank diskette into a drive and click the Yes button to begin copying the
driver to the floppy diskette.

Note: If you need to create a Linux driver diskette for a Linux distribution other that
what is available on the menu, see 3ware knowledgebase article 11843 at
http://www.3ware.com/kb/article.aspx?id=11843
Installing the 3ware Driver and SuSE Linux with YaST2 on a New Unit
Note: If SuSE Linux is already installed on another drive, turn to Installing the 3ware
Driver on a SuSE Linux System that Boots from a Different Device.
1 Boot directly from the SuSE installation CD #1 or DVD.
2 When installing SuSE, press the F6 key You will then be prompted to insert the
driver disk.
3 Insert the 3ware Linux driver installation diskette.
4 Click OK and continue with installation.
Installing the 3ware Driver on a SuSE Linux System that Boots from a Different
Device
1 Log in as root.
2 Edit /etc/sysconfig/kernel and make sure the file contains the following line:

INITRD_MODULES="reiserfs 3w-9xxx"



720-0128-00 Rev A 9
Note: Other modules may be listed before or after 3w- 9xxx, depending on the
installation. You may see entries like reiserfs, ext3 or scsi_mod. If present, leave them
(ensuring there is a space between each module name), since the system needs them to
boot properly.

Note about variables: In the instruction below, replace <kernel string> with the kernel
version you are using (i.e. 2.6, etc.), replace *** with your version of SuSE. In addition,
replace 3w-9xxx.* with the appropriate module file for your kernel. The available module
files are: For UP kernels: 3w-9xxx.ko For SMP kernels: 3w-9xxx.smp For BigSMP (high
memory) kernels: 3w-9xxx.big

3 If you are using SuSE 9.1 or earlier, after the existing 3w-xxx entry, add
3w-9xxx to the /lib/modules/<kernel string>/modules.dep file
4 Mount the CD-ROM, copy and install the appropriate driver for your system.
Note: The AMD 64-bit driver is also used for 64-bit Intel Xeon systems.
mount /dev/cdrom /cdrom
cp /cdrom/packages/drivers/linux/suse/su93/3w-9xxx.* /lib/modules/<kernel
string>/kernel/drivers/scsi/3w-9xxx.ko
If prompted to overwrite, type y.
Then to load the driver type:
/sbin/insmod /lib/modules/<kernel string>/kernel/drivers/scsi/3w-9xxx.ko
If the driver installation fails, confirm that the correct driver was installed from the
CD-ROM. If a driver is not available for your system, you will need to compile your
own driver. For more information, see 3ware knowledgebase article 12690 at
http://www.3ware.com/kb/article.aspx?id=12690.
5 Type:
/sbin/depmod -a
6 Type:
/sbin/mkinitrd
7 If you are using the GRUB boot loader, you are finished. If you are using the LILO
boot loader, run LILO to update the boot record on disk by typing the following:
/sbin/lilo
The output should be similar to:
Added linux *



720-0128-00 Rev A 10
FreeBSD Driver Installation

Note: Before installing the 3ware driver, you must have already installed your 3ware
RAID controller in the system. Consult the 9550SX Install Guide on how to do this. You
can download the 9550SX documentation (Install, User and CLI guides) from:
http://www.3ware.com/support/userdocs.asp
A drive or unit managed by the 3ware RAID controller may be configured to be your
systems boot device. Or, you can use another device as your boot device, such as a disk
attached to the motherboard.
The steps you follow to install the driver and make your RAID unit available depend on
whether it will be your boot device. These instructions provide step-by-step instructions
for the following situations:
Installing the Driver While Installing FreeBSD on the 3ware RAID Controller
Installing the 3ware Driver on a FreeBSD System that Boots from a Different
Device
Obtaining 3ware FreeBSD Drivers
The 3ware software CD-ROM that came with the 3ware RAID controller includes
compiled and tested drivers for FreeBSD 5.4 only. To see if a more recent driver is
available, please see the 3ware web site at http://www.3ware.com/support/index.asp.

Materials Required

3ware driver
The driver and the corresponding source files can be found on the 3ware CD-ROM, at
/packages/drivers/freebsd/5.4/x86 or /packages/drivers/freebsd/5.4/x86_64, depending on
whether you have the 32-bit or 64-bit version of FreeBSD 5.4. The FreeBSD source is
available at /packages/drivers/freebsd/src/5.x. You can also download the FreeBSD
driver from the 3ware web site (http://www.3ware.com/support/index.asp).
FreeBSD installation CD-ROM or diskette

Note: Some versions of FreeBSD cannot boot to arrays larger than 1 terabyte. If you
want to create an array larger than 1 terabyte, check to make sure that the version of
FreeBSD you have supports it.
To install the driver as a module
1. Boot with the FreeBSD CD-ROM or diskette.
2. In the sysinstall menu, select Configure > Load KLD module. Note: Immediately
after the OS starts booting from the CD, insert an MS-DOS floppy with the 3ware driver,
twa.ko, into the floppy drive. If you do not insert it immediately, sysinstall may fail to
recognize the floppy drive.


720-0128-00 Rev A 11
3. Load the driver from the floppy drive.
4. Run the FreeBSD installation and reboot. For instructions on how to install
FreeBSD, see the FreeBSD website, at http://www.freebsd.org/
5. Remove the floppy disk and the CD.
6. On reboot, escape to the loader menu. Note: Once again, immediately after the OS
starts booting, insert an MS-DOS floppy with the 3ware driver, twa.ko, into the floppy
drive. If you do not insert it immediately, the loader may fail to recognize the floppy
drive.
7. At the loader prompt, run 'lsdev' to make sure the floppy drive has been
discovered.
8. Load the driver from the floppy. For example, if the floppy drive is disk0, type
load disk0:twa.ko
9. Run 'boot'. The system should now be able to boot.
10. After the system boots up, do the following:
a. Create a directory for the floppy.
mkdir /floppy
b. Mount the floppy. mount -t msdos /dev/fd0 /floppy
c. Copy the driver file to the appropriate directory. For FreeBSD 5.4, copy the files
to: cp /floppy/twa.ko /boot/kernel/twa.ko
d. Add line 'twa_load="YES"' to the file /boot/loader.conf

11. Eject the floppy disk and reboot. The 3ware driver, twa.ko, should be
automatically loaded at reboot time.

To make the driver part of the kernel
1. Boot with the FreeBSD CD-ROM or diskette.
2. In the sysinstall menu, select Configure > Load KLD module.
Note: Immediately after the OS starts booting from the CD, insert an MS-DOS floppy
with the 3ware driver, twa.ko, into the floppy drive. If you do not insert it immediately,
the sysinstall may fail to recognize the floppy drive.
3. Load the driver from the floppy drive.
4. Remove the floppy disk and the CD.
5. Go through OS installation. Make sure you install the kernel sources during this
step.
6. On reboot, escape to the loader menu.


720-0128-00 Rev A 12
Note: Immediately after the OS starts booting, insert an MS-DOS floppy with the 3ware
driver, twa.ko, into the floppy Installing the Driver While Installing FreeBSD on the
3ware RAID Controller www.3ware.com 91 drive. If you do not insert it immediately,
the loader may fail to recognize the floppy drive.

7. At the loader prompt, run lsdev to make sure the floppy drive has been
discovered.
8. Run load disk0:twa.ko (assuming disk0 is the floppy drive)
9. Run boot. The system should now be able to boot.
10. After the system boots up, change the kernel build infrastructure to include the
3ware driver sources.
a. Change to the following directory: cd /usr/src/sys/i386/conf
b. Copy the configuration file to a custom file. For example, if the configuration file is
GENERIC, type cp GENERIC custom.
c. Edit the custom file and add the lines shown below under RAID controllers device
twa # 3ware Escalade 9000 series
d. Save the file.
e. Change to the following directory: cd /sys/conf
f. Edit the file files.i386 and add the lines shown below
dev/twa/tw_cl_fwimg.c optional twa
dev/twa/w_cl_init.c optional twa
dev/twa/tw_cl_intr.c optional twa
dev/twa/tw_cl_io.c optional twa
dev/twa/tw_cl_misc.c optional twa
dev/twa/tw_osl_cam.c optional twa
dev/twa/tw_osl_freebsd.c optional twa
g. Save the file.
h. Add the following line to Makefile.i386 CFLAGS+=-I/sys/dev/twa
i. If you intend to bundle the firmware image with the driver, add the following line
to /sys/conf/options:

TWA_FIRMWARE_FLASH opt_twa.h
and the following line to your kernel configuration file (custom in the example
above): options TWA_FLASH_FIRMWARE
j. If you intend to enable printing of debug messages in the driver, add the following
line to /sys/conf/options: TWA_DEBUG opt_twa.h


720-0128-00 Rev A 13
and the following line to your kernel configuration file (custom in the example
above): options TWA_DEBUG=<number from 0 to 10> Specifying 0 in the above line
prints no debug messages, whereas specifying 10 prints a lot of debug messages.
11. Rebuild the kernel and install the new kernel.
12. Reboot with the rebuilt kernel.

Installing the 3ware Driver on a FreeBSD System that Boots from a Different
Device

To install the 3ware driver as a module
1. Copy the driver from the 3ware CD-ROM at /packages/drivers/freebsd5.4 (select
32-bit or 64-bit driver, as appropriate).
2. Load the driver
kldload twa.ko
If units are present, you should see unit information in the system log (usually,
/var/log/messages).

Note: Since twa.ko behaves like a SCSI driver, the units that it controls are seen as da0,
da1 etc.



720-0128-00 Rev A 14
To make the driver part of the kernel
1. Create the directory /sys/dev/twa mkdir /sys/dev/twa
2. Copy the 3ware driver source file archive (twa.tgz) to the directory you created in
step 1.
3. Unpack the 3ware driver source files. cd /sys/dev/twa ; tar -xzvf twa.tgz
4. Change the kernel build infrastructure to include the 3ware driver sources.
a. Change to the following directory: cd /usr/src/sys/i386/conf
b. Copy the configuration file to a custom file. For example, if the configuration file
is GENERIC, type cp GENERIC custom
c. Edit the custom file and add the lines shown below under RAID controllers.
device twa # 3ware Escalade 9000 series
d. Save the file.
e. Change to the following directory: cd /sys/conf
f. Edit the file files.i386 and add the lines shown below
dev/twa/tw_cl_fwimg.c optional twa
dev/twa/w_cl_init.c optional twa
dev/twa/tw_cl_intr.c optional twa
dev/twa/tw_cl_io.c optional twa
dev/twa/tw_cl_misc.c optional twa
dev/twa/tw_osl_cam.c optional twa
dev/twa/tw_osl_freebsd.c optional twa
g. Save the file.

h. Add the following line to Makefile.i386 CFLAGS+=-I/sys/dev/twa
i. If you intend to bundle the firmware image with the driver, add the following line
to /sys/conf/options: TWA_FIRMWARE_FLASH opt_twa.h and the following line to
your kernel configuration file (custom in the example above):
options TWA_FLASH_FIRMWARE
j. If you intend to enable printing of debug messages in the driver, add the following
line to /sys/conf/options: TWA_DEBUG opt_twa.h and the following line to your
kernel configuration file (custom in the example above):
options TWA_DEBUG=<number from 0 to 10>
Specifying 0 in the above line prints no debug messages, whereas specifying 10 prints a
lot of debug messages.


720-0128-00 Rev A 15
5. Rebuild the kernel and install the new kernel.
6. Reboot with the rebuilt kernel.
Compiling the Driver as a Loadable Module
If you wish to compile the driver yourself (for a different kernel version that you are
running), then perform the following steps.
1. Create the directories /sys/modules/twa and /sys/dev/twa
mkdir /sys/modules/twa
mkdir /sys/dev/twa
2. Copy the 3ware driver source file archive (twa.tgz) to
/sys/dev/twa.
3. Unpack the driver source files.
cd /sys/dev/twa
tar -xzvf twa.tgz
4. Move the Makefile to /sys/modules/twa
mv Makefile /sys/modules/twa
5. Change the directory to /sys/modules/twa/
cd /sys/modules/twa
6. Uncomment or comment the following line in Makefile, based on whether or not
you intend to bundle the firmware image with the driver:
TWA_FLASH_FIRMWARE=1
7. If you intend to enable printing of debug messages in the driver, uncomment the
following line in Makefile:
CFLAGS+=-DTWA_DEBUG=<number from 0 to 10>
Specifying 0 in the above line prints no debug messages, whereas specifying 10 prints a
LOT of debug messages.
8. Build the driver
make clean
make depend
make


720-0128-00 Rev A 16
9. Copy the driver to the appropriate directory. For FreeBSD 5.4, copy it to
cp twa.ko /boot/kernel/twa.ko
10. Unload the existing driver, if any
kldunload twa.ko
11. Load the new driver.
kldload twa.ko