SOFTPAQ NUMBER: N/A PART NUMBER: N/A FILE NAME: cpq_cciss_RedHatAS21-2.4.32-2.i386.rpm TITLE: Proliant Linux driver RPM for the Smart Array 5i, 5300 Series for Red Hat Linux Advanced Server 2.1 and Advanced Server 2.1 errata (2.4.9-e.8) kernel VERSION: 2.4.32-2 LANGUAGE: English CATEGORY: Storage Controllers DIVISIONS: N/A PRODUCTS AFFECTED: ProLiant BL20p All Models ProLiant DL760 All Models ProLiant DL580 G2 (1400MHz+), (700-900MHz) ProLiant DL380 G3 (2.4GHz+), G2 (1133 - 1400MHz), (667-1000MHz) ProLiant DL380 Packaged Cluster G2 (1266MHz) ProLiant DL360 G2 (1400MHz+), (667-1266MHz) ProLiant DL320 All Models ProLiant ML750 All Models ProLiant ML570 G2 (1.4 GHz+), (667-1000MHz) ProLiant ML530 G2 (2.4GHz+), (667-1000MHz) ProLiant ML370 G3 (2.4GHz+), G2 (1133-1400MHz), (667-1000MHz) ProLiant ML350 G3 (2.0GHz+), G2 (1133MHz-1400MHz ), (700MHz -1GHz) ProLiant ML330e All Models ProLiant ML330 G2 (1000MHz+), (667-999MHz) ProLiant ML310 All Models OPERATING SYSTEM: Red Hat Linux Advanced Server 2.1 SYSTEM CONFIGURATION: All shipping configurations PREREQUISITES: N/A EFFECTIVE DATE: October 17, 2002 ELECTRONIC DISTRIBUTION ALLOWED: Yes SOFTPAQ UTILITY VERSION: N/A SUPERSEDES: N/A DESCRIPTION: This RPM Package Manager (RPM) is used to provide binary driver modules that have been pre-built for Red Hat Linux Advanced Server 2.1 to enable Proliant Smart Array 53xx and Smart Array 5i controllers. This RPM provides a customer friendly approach to install a pre-built binary drivers. Enhancements: * Released CCISS driver version 2.4.32 to support RHAS2.1 and RHAS2.1 errata (2.4.9-e.8) kernels * Add back CCISS_RESCANDISK IOCTL to rescan disk for HP configuration and management tools * Allow rescaning the disk that was reserved by another system through CCISS_RESCANDISK IOCTL. Can now open /dev/cciss/c0d0 if any logical volumes exist * Handle 3rd party Bus Resets that would be seen by the array controller in a cluster configuration with the Smart Array Storage Cluster * Fix a bug in the usage count set to 2 instead of 1 which resulted in the CISS driver failing to delete non sequential logical volumes * Fix a bug in the usage count set to 2 instead of 1 which resulted in the CISS driver locking up the first logical drive if more than one logical drives are created A changelog for the Smart Array 5300 Series drivers is available at: ftp://ftp.compaq.com/pub/products/drivers/linux/released/cciss/cciss_history.htm IMPORTANT: Additional instructions may be viewed: rpm -q -i -p cpq_cciss_RedHatAS21-2.4.32-2.rpm | more Please read this section before proceeding. This RPM will install binary drivers that will only work with the default Red Hat Linux Advanced Sercer 2.1 and Red Hat Linux Advanced Sercer 2.1 errata kernels, and configuration that they have been built for. Earlier or later versions of Red Hat Linux are not supported. Special actions are required if you have modified the default kernel configuration that Red Hat ships for their Red Hat Advanced Server 2.1 product. If you have modified the default kernel configuration you will need to rebuild the kernel to use the updated drivers after installing the RPM with the --noscripts option. For directions to patch the existing driver and rebuild your kernel please refer to the Red Hat documentation. The driver patches will be available in a gzipped tar file in the /opt/compaq/storage_drivers directory after installing the RPM with the --noscripts option. The CCISS driver RPM will not install if it detects that your configuration is different than the Red Hat Advanced Server 2.1 default Server configuration. This driver RPM will not install if the loopback device is not configured but the initrd image is requested since the loopback device is required to create the initrd image. Supported Devices and Features Smart Array Cluster Storage Smart Array 5312 Controller Smart Array 5304 Controller Smart Array 5302 Controller Smart Array 532 Controller Smart Array 5i Plus Controller Smart Array 5i Controller HOW TO USE: 1. Login as the system administrator (root), download the RPM to a directory on your hard drive and change to that directory. 2. To install the driver type: # rpm -ivh cpq_cciss_RedHatAS21-2.4.32-2.i386.rpm You can expect to see a message similar to: Preparing... ################################################## cpq_cciss_RedHatAS21 ################################################## Attempting dry run first... ./install --drivers cciss --lilo --grub --initrd --noskip --dry-run ---> THIS IS A DRY RUN <--- /dev/cciss/c0d0 1+0 records in 1+0 records out ъл|lbaLILO 0 Boot Loader is LILO LILO_CONF = /etc/lilo.conf KERNELIMG = unknown kernel Kernel image is vmlinuz-2.4.9-e.3smp mkdir -p /usr/src/COMPAQ/driver_backup mkdir -p /usr/src/COMPAQ/driver_backup//./lib/modules/2.4.9-e.3/kernel/drivers/block cp -p /./lib/modules/2.4.9-e.3/kernel/drivers/block/cciss.o /usr/src/COMPAQ/driver_backup//./lib/modules/2.4.9-e.3/kernel/drivers/block/cciss.o Installing cciss for 2.4.9-e.3 kernel... cp -p ./lib/modules/2.4.9-e.3/kernel/drivers/block/cciss.o /./lib/modules/2.4.9-e.3/kernel/drivers/block/cciss.o done mkdir -p /usr/src/COMPAQ/driver_backup//./lib/modules/2.4.9-e.3smp/kernel/drivers/block cp -p /./lib/modules/2.4.9-e.3smp/kernel/drivers/block/cciss.o /usr/src/COMPAQ/driver_backup//./lib/modules/2.4.9-e.3smp/kernel/drivers/block/cciss.o Installing cciss for 2.4.9-e.3smp kernel... cp -p ./lib/modules/2.4.9-e.3smp/kernel/drivers/block/cciss.o /./lib/modules/2.4.9-e.3smp/kernel/drivers/block/cciss.o done /sbin/mkinitrd /boot/cpq-initrd-2.4.9-e.3smp.img-5 2.4.9-e.3smp Modifying /tmp/lilofile.2748, adding cpq-2.4.9-e.-5 Testing lilo configuration (/sbin/lilo -t). We always run /sbin/lilo -t, even for --dry-run /sbin/lilo -t -C /etc/lilo.conf > /dev/null 2>&1 Modifying default lilo entry default=cpq-2.4.9-e.-5 # (previously, default=cpq-2.4.9-e.-4) cpq-2.4.9-e.-5 There was a default kernel image....... /sbin/lilo -t -C /etc/lilo.conf > /dev/null 2>&1 lilo configuration appears OK. /sbin/lilo -t succeeded, so we would normally really run lilo at this point if it were not a dry-run The following patch would have been made to /etc/lilo.conf --- /etc/lilo.conf Tue Sep 10 16:21:15 2002 +++ /tmp/lilofile.2748 Tue Sep 10 16:22:07 2002 @@ -1,6 +1,6 @@ prompt timeout=50 -default=cpq-2.4.9-e.-4 # (previously, default=cpq-2.4.9-e.-3) +default=cpq-2.4.9-e.-5 # (previously, default=cpq-2.4.9-e.-4) boot=/dev/cciss/c0d0 map=/boot/map install=/boot/boot.b @@ -60,3 +60,10 @@ initrd=/boot/cpq-initrd-2.4.9-e.3smp.img-4 read-only root=/dev/cciss/c0d0p2 + +# The following entry was added by Compaq HBA install script +image=/boot/vmlinuz-2.4.9-e.3smp +label=cpq-2.4.9-e.-5 +initrd=/boot/cpq-initrd-2.4.9-e.3smp.img-5 +read-only +root=/dev/cciss/c0d0p2 ---> THIS WAS A DRY RUN <--- Dry run succeeded, installing for real... ./install --drivers cciss --lilo --grub --initrd --noskip /dev/cciss/c0d0 1+0 records in 1+0 records out ъл|lbaLILO 0 Boot Loader is LILO LILO_CONF = /etc/lilo.conf KERNELIMG = unknown kernel Kernel image is vmlinuz-2.4.9-e.3smp Installing cciss for 2.4.9-e.3 kernel...done Installing cciss for 2.4.9-e.3smp kernel...done /sbin/mkinitrd /boot/cpq-initrd-2.4.9-e.3smp.img-5 2.4.9-e.3smp Modifying /etc/lilo.conf, adding cpq-2.4.9-e.-5 Testing lilo configuration (/sbin/lilo -t). Modifying default lilo entry default=cpq-2.4.9-e.-5 # (previously, default=cpq-2.4.9-e.-4) cpq-2.4.9-e.-5 There was a default kernel image....... /sbin/lilo -t -C /etc/lilo.conf > /dev/null 2>&1 lilo configuration appears OK. Added linux Added linux-up Added cpq-2.4.9-e. Added cpq-2.4.9-e.-0 Added cpq-2.4.9-e.-1 Added cpq-2.4.9-e.-2 Added cpq-2.4.9-e.-3 Added cpq-2.4.9-e.-4 Added cpq-2.4.9-e.-5 * Setup Is Now Complete. Please REBOOT Your Computer NOW!! NOTE: If the installation fails or if you see any warning or error messages, STOP, do NOT reboot the computer. The driver will not be operational and you must uninstall the driver by typing the following command: # rpm -e cpq_cciss_RedHatAS21-2.4.32-2 The removal of the RPM restores the original cciss.o module, and builds a new initrd image with the previous driver object module (if any) and adds yet another grub or lilo entry. You can then boot using this newest lilo or grub entry, (provided the building of the new initrd image goes well), or your original lilo or grub entry. The successful installation will replace the driver that shipped with Red Hat Advanced Server 2.1 with the 2.4.32 version of the driver, create a new Initial RAM Disk Image (initrd) that contains the 2.4.32 version of the driver and modify /etc/lilo.conf (or /boot/grub/menu.lst) to allow the Linux Loader, lilo (or grub) to boot using the new ramdisk image. The installation of this RPM modifies the following files: /etc/lilo.conf (or /boot/grub/menu.lst) /etc/lilo.conf.bak-* (backup files) /boot/grub/menu.lst.bak-* (backup files) /boot/cpq-initrd-*.img-* (initrd images) if you have multiple processors installed in your server expect: /lib/modules/2.4.9-e.3smp/kernel/drivers/block/cciss.o if you have a single processor server expect: /lib/modules/2.4.9-e.3/kernel/drivers/block/cciss.o if your server uses the Red Hat Enterprise kernel expect: /lib/modules/2.4.9-e.3bigmem/kernel/drivers/block/cciss.o Backups of your previous files will be kept in the /usr/src/COMPAQ/driver_backup directory. The driver version can be verified by typing: # strings /lib/modules/2.4.9-e.3/kernel/drivers/block/cciss.o | grep Compaq Expect output similar to: %s: Compaq %s Controller Compaq CISS Driver (v 2.4.32) 3. The driver will be inserted in the Initial RAM Disk Image (initrd) and is automatically loaded every time the server boots, provided it is listed in /etc/modules.conf, which, normally, it is. 4. To load the module use the insmod command. Type: # insmod cciss Expect the following output if you have Symmetric Multi-Processing support enabled: Using /lib/modules/2.4.9-e.3smp/kernel/drivers/block/cciss.o Expect the following output if you have a single processor server: Using /lib/modules/2.4.9-e.3/kernel/drivers/block/cciss.o Expect the following output if your server is using the Red Hat Enterprise kernel: Using /lib/modules/2.4.9-e.3bigmem/kernel/drivers/block/cciss.o NOTE: You will experience error messages if the Smart Array controller is not installed. Please ensure that the hardware is installed properly. NOTE: If the hardware is properly installed and you experience error messages loading the modules, remove the entire RPM by typing: # rpm -e cpq_cciss_RedHatAS21-2.4.32-2 The removal of the RPM will restore the driver modules, and rebuild and initrd image for the running kernel and create appropriate entries in /etc/lilo.conf (or /boot/grub/menu.lst). Additionally you should still be able to boot using the previous entries still in /etc/lilo.conf or /boot/grub/menu.lst, provided the driver modules are restored, or were (and thus still are) in the initrd image. 5. To check whether the driver is loaded properly, type: # lsmod Expect to see the module name cciss displayed 6. If you attempt to install the RPM on an unsupported system, you will get an error message. The driver will not be operational and must be uninstalled by typing the following command: # rpm -e cpq_ciss_RedHatAS21-2.4.32-2 7. To remove the RPM package use the following command: # rpm -e cpq_cciss_RedHatAS21-2.4.32-2 Expect to see output similar to: Attempting dry run first... ---> THIS IS A DRY RUN <--- /dev/cciss/c0d0 1+0 records in 1+0 records out ъл|lbaLILO 0 Boot Loader is LILO LILO_CONF = /etc/lilo.conf KERNELIMG = unknown kernel Kernel image is vmlinuz-2.4.9-e.3smp mkdir -p /usr/src/COMPAQ/driver_backup Uninstalling /lib/modules/2.4.9-e.3/kernel/drivers/block/cciss.o mv /lib/modules/2.4.9-e.3/kernel/drivers/block/cciss.o /tmp/cciss.o.old.3754 Restoring previous cciss.o from backup. cp -f /usr/src/COMPAQ/driver_backup//lib/modules/2.4.9-e.3/kernel/drivers/block/cciss.o /lib/modules/2.4.9-e.3/kernel/drivers/block/cciss.o rm -f /usr/src/COMPAQ/driver_backup//lib/modules/2.4.9-e.3/kernel/drivers/block/cciss.o rm -f /tmp/cciss.o.old.3754 Uninstalling /lib/modules/2.4.9-e.3smp/kernel/drivers/block/cciss.o mv /lib/modules/2.4.9-e.3smp/kernel/drivers/block/cciss.o /tmp/cciss.o.old.3754 Restoring previous cciss.o from backup. cp -f /usr/src/COMPAQ/driver_backup//lib/modules/2.4.9-e.3smp/kernel/drivers/block/cciss.o /lib/modules/2.4.9-e.3smp/kernel/drivers/block/cciss.o rm -f /usr/src/COMPAQ/driver_backup//lib/modules/2.4.9-e.3smp/kernel/drivers/block/cciss.o rm -f /tmp/cciss.o.old.3754 /sbin/mkinitrd /boot/cpq-initrd-2.4.9-e.3smp.img-6 2.4.9-e.3smp Modifying /tmp/lilofile.3754, adding cpq-2.4.9-e.-6 Testing lilo configuration (/sbin/lilo -t). We always run /sbin/lilo -t, even for --dry-run /sbin/lilo -t -C /etc/lilo.conf > /dev/null 2>&1 Modifying default lilo entry default=cpq-2.4.9-e.-6 # (previously, default=cpq-2.4.9-e.-5) cpq-2.4.9-e.-6 There was a default kernel image....... /sbin/lilo -t -C /etc/lilo.conf > /dev/null 2>&1 lilo configuration appears OK. /sbin/lilo -t succeeded, so we would normally really run lilo at this point if it were not a dry-run The following patch would have been made to /etc/lilo.conf --- /etc/lilo.conf Tue Sep 10 16:22:09 2002 +++ /tmp/lilofile.3754 Tue Sep 10 16:29:56 2002 @@ -1,6 +1,6 @@ prompt timeout=50 -default=cpq-2.4.9-e.-5 # (previously, default=cpq-2.4.9-e.-4) +default=cpq-2.4.9-e.-6 # (previously, default=cpq-2.4.9-e.-5) boot=/dev/cciss/c0d0 map=/boot/map install=/boot/boot.b @@ -67,3 +67,10 @@ initrd=/boot/cpq-initrd-2.4.9-e.3smp.img-5 read-only root=/dev/cciss/c0d0p2 + +# The following entry was added by Compaq HBA install script +image=/boot/vmlinuz-2.4.9-e.3smp +label=cpq-2.4.9-e.-6 +initrd=/boot/cpq-initrd-2.4.9-e.3smp.img-6 +read-only +root=/dev/cciss/c0d0p2 ---> THIS WAS A DRY RUN <--- ./uninstall --drivers cciss --lilo --grub --initrd --noskip --dry-run Dry run succeeded, uninstalling for real... ./uninstall --drivers cciss --lilo --grub --initrd --noskip /dev/cciss/c0d0 1+0 records in 1+0 records out ъл|lbaLILO 0 Boot Loader is LILO LILO_CONF = /etc/lilo.conf KERNELIMG = unknown kernel Kernel image is vmlinuz-2.4.9-e.3smp Uninstalling /lib/modules/2.4.9-e.3/kernel/drivers/block/cciss.o Restoring previous cciss.o from backup. Uninstalling /lib/modules/2.4.9-e.3smp/kernel/drivers/block/cciss.o Restoring previous cciss.o from backup. /sbin/mkinitrd /boot/cpq-initrd-2.4.9-e.3smp.img-6 2.4.9-e.3smp Modifying /etc/lilo.conf, adding cpq-2.4.9-e.-6 Testing lilo configuration (/sbin/lilo -t). Modifying default lilo entry default=cpq-2.4.9-e.-6 # (previously, default=cpq-2.4.9-e.-5) cpq-2.4.9-e.-6 There was a default kernel image....... /sbin/lilo -t -C /etc/lilo.conf > /dev/null 2>&1 lilo configuration appears OK. Added linux Added linux-up Added cpq-2.4.9-e. Added cpq-2.4.9-e.-0 Added cpq-2.4.9-e.-1 Added cpq-2.4.9-e.-2 Added cpq-2.4.9-e.-3 Added cpq-2.4.9-e.-4 Added cpq-2.4.9-e.-5 Added cpq-2.4.9-e.-6 * Feedback -------- To provide kernel/driver development feedback send email to Cciss-discuss@lists.sourceforge.net For support for Proliant Smart Array controllers, please send email to support@compaq.com.