ATTO 6Gb ExpressSAS RAID Adapter Linux ReadMe Supported operating systems Supported architectures Supported adapters Installation instructions Loading the driver Advanced - Building the drivers manually Advanced - Configuring the driver to load at boot time Advanced - Optional Module Parameters Troubleshooting 64-bit driver installation Installing kernel source and other necessary packages Contact information Supported operating systems (both 32 and 64 bit versions) Red Hat Enterprise Linux 5, 6 CentOS 5, 6 Fedora 17 SUSE Linux Enterprise Server 10, 11sp2 openSUSE 12.2 Supported architectures i386 (with or without "CONFIG_REGPARM") x86_64 (AMD64, Intel EM64T) Supported adapters ATTO ExpressSAS R680 ATTO ExpressSAS R608 ATTO ExpressSAS R60F ATTO ExpressSAS R644 Installation instructions NOTE: The kernel header files, `make`, and `gcc` must be installed. For details on how to do this, click here. Unzip and untar the driver files with `tar xfz lnx_drv_esasraid2_XXX.tgz` Enter the `lnx_drv_esasraid2_XXX` directory and run the install script `install.sh`. After the driver is installed, it can be loaded automatically if desired. Loading the driver Type the following to manually load the module: `$ modprobe esas2raid` 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 esas2raid FATAL: module '/lib/modules/2.6.27.19-5-default/kernel/drivers/scsi/esas2raid.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 esas2raid` or editting the file `/etc/modprobe.d/unsupported-modules` as described. Advanced - Building the drivers manually Unzip and untar the driver files: `$ tar xfz lnx_drv_esasraid2_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_esasraid2_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. 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 5 & 6: Add the following line to /etc/modprobe.conf after installing the driver: `alias scsi_hostadapterX esas2raid` Where X is the next available number. Recommended for SUSE 10: Add the following line to /etc/init.d/boot.local: `modprobe esas2raid` 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 esas2raid.ko`. 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` 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, click here. Refer to your system documentation for further details. Contact information You may receive customer service, sales information, and technical support by phone Monday through Friday, Eastern Standard Time 8:00 am to 6: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