Dell SAS 5 Adapter Device Driver for SLES 10 x86_64 and RHEL 5 Gold (x86 & x86_64). Driver Version : 04.00.00.01 Package Version: 04.00.00.01-4 TABLE OF CONTENTS ================= 1 Introduction 2 Compatibility / Minimum Requirements 3 Install Instructions 3.1 The package. 3.2 Installing the OS on a SAS 5 controller. 3.3 Adding the SAS 5 Driver to an Existing Linux system 3.4 Updating the SAS 5 Driver on an Existing Linux system. 4 Fixes or Enhancements in this Release 5 Important Information 6 Known issues 1 Introduction ============== This is the driver for following controllers: SAS 5 Adapters 2 Compatibility / Minimum Requirements ====================================== This Device Driver is compatible with: RHEL 5 Gold and later updates, and SLES 10 distributions. Minimum SAS 5 FW version: 00.10.49.00.06.12.02.00 3 Installation Instructions =========================== The package is a compressed tar file. 3.1 The package. --------------- The package is a compressed tar file. To extract the components within the tar file, please follow the instructions as below: Preparation of the DUD image. 1. From the support site download the file. 2. Transfer the file to a Linux system. 3. Run "gunzip on the transferred file to unzip the file. 4. Run "tar -xvf *.tar" on the unzipped file. 5. Go into the appropriate sub-directory. 6. Transfer the image to the floppy. Use "dd if= of=/dev/fd0" On most systems, the floppy drive is designated by the /dev/fd0 special file. The RPM package. One of the components of the tar file is an RPM package with a filename ending in .rpm. 3.2 Installing the OS on a SAS 5 controller. ------------------------------------------- Use the command "Linux dd updates" at the beginning of the Linux installation process if you will be installing the O/S to a disk attached to the SAS 5 controller. This step is required because LSI PCI Ids are not in the kernel's supported device table. This work around will always be necessary for these kernels since they are pre-existing and cannot be patched. Detailed Steps: 1. You will be prompted with "Do you have a driver disk?" 2. Select "Yes" 3. You will be prompted to select the device from which to install drivers. Select fd0 4. You will be prompted to press OK after inserting the driver disk. Select "OK" 5. You will be prompted to load any more drivers. Select "No" 6. Continue with installation. 3.3 Adding the SAS 5 Driver to an Existing Linux system ------------------------------------------------------- 1. Install the DKMS rpm package. Use the command "rpm -ivh " 2. Install the Driver package. Use the command "rpm -ivh " 3. Restart the computer for the changes to take effect. 3.4 Updating the SAS 5 Driver on an Existing Linux system. --------------------------------------------------------- 1. If DKMS installation is needed, use the following instruction to install the package. Install the DKMS rpm package. Use the command "rpm -ivh " 2. Install the Driver package. Use the command "rpm -Uvh " 3. Restart the computer for the changes to take effect. 4. When upgrading from an older to newer version of the driver, first uninstall the older RPM doing: # rpm -e mptlinux-- Then install the new rpm doing: # rpm -ivh mptlinux--..rpm 4 Fixes or Enhancements in this Release ======================================= 1 Corrected several bugs in the rpm spec file. 2 Added support for RHEL5 Gold. 3 Corrected issue in RHEL5 where removing the secondary disk in an IM array would cause the filesystem to go read-only 5 Important Information ======================= 5.1 Power state transition. -------------------------- Note that system power state transitions are not validated on Dell platforms under the Linux Operating Systems. If attempted, the system might hang and/or panic resulting in data loss. 5.2 DKMS AUTOINSTALL -------------------- DKMS AUTOINSTALL option should always be disabled in the DKMS configuration file for driver installation. 5.3 Possible Driver Install Issues After Kernel Update ------------------------------------------------------ After a kernel update, the driver needs to be built for the new kernel before rebooting into the new kernel. This is specifically applicable for storage controllers. As the mptlinux driver is not native to the kernel, the DKMS "add" and "install" steps have to be performed on the driver. The driver installation might fail if there is another DKMS-installed module which also does not have support in the upgraded kernel, and has to be part of the RAM disk image. Here is the example of the error message: ... Saving old initrd as /boot/initrd-2.6.9-22.ELsmp_old.img Making new initrd as /boot/initrd-2.6.9-22.ELsmp.img (If next boot fails, revert to the _old initrd image) mkinitrd....(bad exit status: 1) WARNING! WARNING! WARNING! There was a problem remaking your initrd. You must manually remake it before booting into this kernel. DKMS: uninstall Completed. ------------------------------ Deleting module version: v03.02.63 completely from the DKMS tree. ------------------------------ Done. When building and installing the driver for updated kernel, if this problem occurs, please follow the following steps to install the drivers: a) Manually re-build the initrd image. This will show what modules are missing from kernel module tree. Here is an example of the output of the command: # mkinitrd /boot/test.img `uname -r` No module found for kernel (2.6.9-22.ELsmp ) (Using this as an example), aborting. b) Record the list of missing module name and run the following commands on each of them: dkms build -m -v -k dkms install -m -v -k --directive "REMAKE_INITRD=no" This will install the module, but the initrd will not be rebuilt. c) After this, run the following command on mptlinux driver: dkms build -m mptlinux -v -k dkms install -m mptlinux -v -k This will install module and remake the initrd, including all drivers listed in module configuration file. 5.4 Xen and PAE Kernels -------------- This driver needs additional installation steps to properly work with the 2.6.16.21-0.8-xen for x86_64, 2.6.18-8.el5xen for both i686 and x86_64, and 2.6.18-8.el5PAE for i686. After installing the kernels it is necessary to install the driver by following the steps mentioned below. The kernel version used in these steps is 2.6.16.21-0.8-xen. Please substitute proper versions that’s appropriate for your environment. 1. Install the kernel source code (the rpm package can be found on the Linux media CDs) rpm -Uvh kernel-source-2.6.16.21-0.8.x86_64.rpm 2. Remove the current driver dkms remove -m mptlinux -v 4.00.00.01 -k 2.6.16.21-0.8-xen 3. Build the driver dkms build -m mptlinux -v 4.00.00.01 -k 2.6.16.21-0.8-xen 4. Install the driver dkms install -m mptlinux -v 4.00.00.01 -k 2.6.16.21-0.8-xen Please, notice the version of the driver may vary if these steps were executed on a SLES10 x86_64 system running 2.6.16.21-0.8-smp Kernel. Additional parameters may be needed on the dkms commands if the driver does not build on a x86_64 system. 6 Known issues ============== No known issues.