ATTO ExpressPCI SCSI Adapter Linux ReadMe

  1. Supported operating systems
  2. Supported architectures
  3. Supported adapters
  4. Installation instructions
  5. Loading the driver
  6. Advanced - Building the drivers manually
  7. Advanced - Configuring the driver to load at boot time
  8. Advanced - Optional Module Parameters
  9. Troubleshooting 64-bit driver installation
  10. Installing kernel source and other necessary packages
  11. Contact information


  1. Supported operating systems

    • Red Hat Enterprise Linux 3, 4, 5
    • SUSE Linux 9, 9.1, 9.2, 9.3, 10

  2. Supported architectures

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

  3. Supported adapters

    • ATTO ExpressPCI UL4D
    • ATTO ExpressPCI UL4S
    • ATTO ExpressPCI UL5D
    • ATTO ExpressPCI UL5D LP

  4. Installation instructions

    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_epciu320_XXX.tgz
    2. Enter the lnx_drv_epciu320_XXX directory and run the install script install.sh.
    3. After the driver is installed, it can be loaded automatically if desired.

  5. Loading the driver

    Type the following to manually load the module:

    $ modprobe express2

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


  6. Advanced - Building the drivers manually

    Unzip and untar the driver files:

    $ tar xfz lnx_drv_epciu320_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_epciu320_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.


  7. Advanced - Configuring the driver to load at boot time

    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 express2

    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 express2

    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 "express2" 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.


    Recommended for SUSE 10:

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

    modprobe express2


  8. Advanced - Optional Module Parameters

    The following module parameter is supported by this driver:

    • 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.

    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 express2.ko.


  9. Troubleshooting 64-bit driver installation

    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


  10. Installing kernel source and other necessary packages

    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 3, click here
    • For Red Hat 4 & 5, click here

    Refer to your system documentation for further details.


  11. Contact information

    You may receive customer service, sales information, and technical support by phone Monday through Friday, Eastern Standard Time 8:00 am to 8:00 pm, or by fax and web site 24 hours a day.

    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