• Red Hat Enterprise Linux 4, 5, 6
• SUSE Linux Enterprise Server 10, 11
• Fedora Core 9, 10, 11

• i386 (with or without "CONFIG_REGPARM")
• x86_64 (AMD64, Intel EM64T)

NOTE: The kernel header files, make, and gcc must be installed. For details on how to do this, click here.

1. Unzip and untar the driver files with tar xfz lnx_drv_celerity8_XXX.tgz
2. Enter the lnx_drv_celerity8_XXX directory and run the install script install.sh.
3. After the driver is installed, it can be loaded automatically if desired.
4. The install script also provides the ability to install ATTO Command Line Tools appropriate for your adapter.

Type the following to manually load the module:

$ modprobe celerity8fc

You may receive a warning that the module will taint the kernel.

On SUSE 11, you may also receive an error message about "unsupported" drivers:

$ modprobe celerity8fc
FATAL: module '/lib/modules/2.6.27.19-5-default/kernel/drivers/scsi/celerity8fc.ko' is unsupported
Use --allow-unsupported or set allow_unsupported_modules to 1 in
/etc/modprobe.d/unsupported-modules


You can fix this problem by loading the driver with modprobe --allow-unsupported celerity8fc or editting the file /etc/modprobe.d/unsupported-modules as described.

Unzip and untar the driver files:

$ tar xfz lnx_drv_celerity8_XXX.tgz

NOTE: Make sure there are no spaces in the path in which you extract the archive. The Linux kernel Makefile may fail if the path name contains a space character.

Make and install the modules (must be done as root):

$ cd lnx_drv_celerity8_XXX.tgz/src
$ make install


NOTE: You need the kernel header files installed to build this driver. If the header files are in a non-standard location, you may need to modify the KDIR variable on the make command line, eg. make install KDIR=/path/to/kernel

The modules will now be installed and ready to use.

On some Linux distributions, the driver may not load automatically when the system is booted. To enable this behavior, try the following suggestions:

Recommended for Red Hat 4 & 5:

Add the following line to /etc/modprobe.conf after installing the driver:

alias scsi_hostadapterX celerity8fc

Where X is the next available number.

Recommended for Red Hat 3:

Add the following line to /etc/rc.modules after installing the driver:

modprobe celerity8fc

NOTE: You may need to create /etc/rc.modules and make it executable with chmod +x /etc/rc.modules

Recommended for SUSE 9:

The driver should reload automatically if it is loaded when the system was last shut down. However, to manually enable driver loading for every system boot, use the following instructions:

1. Run the "yast' utility by selecting it the GUI (under "System" in the application menu) or running it from a command line.
2. Select "Hardware", then "Disk Controller".
3. Under "Disk Controller Configuration", select the ATTO device.
4. Select the "celerity8fc" module under the "Module to Use" heading.
5. Put an X in the box next to "Load Module in initrd".
6. Select "Finish" to complete the configuration.

Add the following line to /etc/init.d/boot.local:

modprobe celerity8fc

The following module parameters are supported by this driver:

• target_mode (default 0) Non-zero enables target mode function, 0 disables. For a sample module for the ATTO target mode interface, please contact ATTO Technical Support.
• initiator_mode (default 1) Non-zero enables initiator function, 0 disables. Note that the ATTO Configuration Tool will not function properly if initiator mode is disabled.
• event_log_mask (default 0) Logs error and informative messages to the kernel ring buffer. This value is a bit-mask of message catergories; set to 0xFFFFFFFF to log all possible messages. This feature is mostly for debugging purposes and is not recommended for normal use.
• quick_init (default 0) Normally, each Celerity adapter port may take up to 9 seconds to initialize. When this option is non-zero, each port will take only about 4 seconds to initialize. However, it is possible that the driver will fail to detect some connected devices before completing this accelerated initialization, so this option should be used with caution.
• t10_dif (default 0) Controls how the adapter handles drives formatted for T10-DIF. If the setting is zero (default), then the drive will create the protection information when writing, and the drive will check it on reading and will not transfer it to the host. If the setting is nonzero, the adapter creates the protection information and transfers it to the drives when writing; when reading, the drive transfers the protection information to the adapter and the adapter will verify that it is correct.

There are also several other parameters available for tweaking. For documentation on these settings, read the file oswrap.c (look for "Module parameter definitions") or the output of the command modinfo celerity8fc.ko.

A vendor-specific library for the SNIA HBA API is included with this driver. The shared library file (attofc_xx.so) is installed automatically along with the driver modules.

The library file is copied to /usr/lib, and an entry is placed in the file /etc/hba.conf pointing to the library file. Any previous versions of the library file will be overwritten.

For more information on the SNIA HBA API, please visit SNIA's web site.

On certain 64-bit platforms, the driver Makefile may be unable to detect the correct CPU architecture. In this instance, you will see an error similar to the following when attempting to compile the driver:

cc1 : error : CPU you selected does not support x86_64 instruction set

This can be resolved by specifying the correct architecture when running the make command, such as:

$ make install ARCH=x86_64

This driver requires that the kernel header files, make, and gcc be installed on the system.

For SUSE, use the YAST utility's "Software Management" module to install the "kernel-source", "gcc", and "make" packages.

For Red Hat, use the "Add/Remove Applications" utility to install the "Development Tools" packages. For details on installing the kernel source package:

• For Red Hat 4 & 5, click here

Refer to your system documentation for further details.

ATTO Technology, Inc.
155 CrossPoint Parkway
Amherst, New York 14068
Phone: (716) 691-1999
Fax: (716) 691-9353
www.attotech.com

ATTO Technology can also be reached via e-mail at the following addresses:

Sales Support: sls@attotech.com
Technical Support: techsupp@attotech.com