SOFTPAQ NUMBER: N/A PART NUMBER: N/A FILE NAME: cpq_cpqfc_RedHat73-2.1.2-1.i386.rpm TITLE: Linux driver for Compaq's 64-bit/66MHz Fibre Channel Host Adapter for Red Hat Linux 7.3 (2.4.18-3) and 7.3 errata (2.4.18-4) kernels VERSION: 2.1.2-1 LANGUAGE: English CATEGORY: Storage DIVISIONS: N/A PRODUCTS AFFECTED: ProLiant DL760 All Models ProLiant DL580 G2 (1400MHz+), (700-900MHz) ProLiant DL580 (667-1000MHz) ProLiant DL380 G2 (1133MHz+), (667-1000MHz) ProLiant DL380 Packaged Cluster G2 (1266MHz) ProLiant DL360 G2 (1400MHz+), (667-1266MHz) ProLiant DL320 All Models ProLiant ML750 All Models ProLiant ML570 (667-1000MHz) ProLiant ML530 (667-1000MHz) ProLiant ML370 G2 (1133MHz+), (667-1000MHz) ProLiant ML350 G2 (1133MHz+), (700MHz -1GHz) ProLiant ML330e All Models ProLiant ML330 G2 (1000MHz+), (667-999MHz) ProLiant 8500 All Models ProLiant 8000 All Models OPERATING SYSTEM: Red Hat Linux 7.3 and 7.3 errata kernels SYSTEM CONFIGURATION: All shipping configurations PREREQUISITES: N/A EFFECTIVE DATE: August 09 7, 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 7.3 to enable Compaq's 64-bit/66-Mhz Fibre Channel Host Adapters. This RPM provides a customer friendly approach to install a pre-built binary drivers. Enhancements: * Provide CPQFC driver v2.1.2 support for RH73 kernel * Fixed issue of Storage Agent cmafcad crashed on requesting BMIC passthrough to the driver * Now supports both RH73 and RH73 errata kernels A changelog for the Linux FC drivers is available at: ftp://ftp.compaq.com/pub/products/drivers/linux/released/cpqfc/cpqfc_history.htm IMPORTANT: Additional instructions may be viewed: rpm -q -i -p cpq_cpqfc_RedHat73-2.1.1-8.rpm | more Please read this section before proceeding. This RPM will install binary drivers that will only work with the default Red Hat Linux 7.3 kernel version 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 7.3 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 RPM will not install if it detects that your configuration is different than the Red Hat 7.3 stock configuration. 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_cpqfc_RedHat73-2.1.2-1.i386.rpm You can expect to see a message similar to: # rpm -ihv cpq_cpqfc_RedHat73-2.1.2-1.i386.rpm Preparing... ################################################## cpq_cpqfc_RedHat73 ################################################## Attempting dry run first... ./install --drivers cpqfc --lilo --grub --initrd --noskip --dry-run ---> THIS IS A DRY RUN <--- Cannot find lilo config file /etc/lilo.conf, will not update. 2.4.18-4smp 2.4.18-3 The default kernel image is not the same as the currently loaded kernel image 2.4.18-4smp 2.4.18-4bigmem 2.4.18-4 2.4.18-3 Kernel image is vmlinuz-2.4.18-3 mkdir -p /usr/src/COMPAQ/driver_backup mkdir -p /usr/src/COMPAQ/driver_backup//./lib/modules/2.4.18-3/kernel/drivers/scsi cp -p /./lib/modules/2.4.18-3/kernel/drivers/scsi/cpqfc.o /usr/src/COMPAQ/driver_backup//./lib/modules/2.4.18-3/kernel/drivers/scsi/cpqfc.o Installing cpqfc for 2.4.18-3 kernel... cp -p ./lib/modules/2.4.18-3/kernel/drivers/scsi/cpqfc.o /./lib/modules/2.4.18-3/kernel/drivers/scsi/cpqfc.o done mkdir -p /usr/src/COMPAQ/driver_backup//./lib/modules/2.4.18-4/kernel/drivers/scsi cp -p /./lib/modules/2.4.18-4/kernel/drivers/scsi/cpqfc.o /usr/src/COMPAQ/driver_backup//./lib/modules/2.4.18-4/kernel/drivers/scsi/cpqfc.o Installing cpqfc for 2.4.18-4 kernel... cp -p ./lib/modules/2.4.18-4/kernel/drivers/scsi/cpqfc.o /./lib/modules/2.4.18-4/kernel/drivers/scsi/cpqfc.o done mkdir -p /usr/src/COMPAQ/driver_backup//./lib/modules/2.4.18-4bigmem/kernel/drivers/scsi cp -p /./lib/modules/2.4.18-4bigmem/kernel/drivers/scsi/cpqfc.o /usr/src/COMPAQ/driver_backup//./lib/modules/2.4.18-4bigmem/kernel/drivers/scsi/cpqfc.o Installing cpqfc for 2.4.18-4bigmem kernel... cp -p ./lib/modules/2.4.18-4bigmem/kernel/drivers/scsi/cpqfc.o /./lib/modules/2.4.18-4bigmem/kernel/drivers/scsi/cpqfc.o done mkdir -p /usr/src/COMPAQ/driver_backup//./lib/modules/2.4.18-4smp/kernel/drivers/scsi cp -p /./lib/modules/2.4.18-4smp/kernel/drivers/scsi/cpqfc.o /usr/src/COMPAQ/driver_backup//./lib/modules/2.4.18-4smp/kernel/drivers/scsi/cpqfc.o Installing cpqfc for 2.4.18-4smp kernel... cp -p ./lib/modules/2.4.18-4smp/kernel/drivers/scsi/cpqfc.o /./lib/modules/2.4.18-4smp/kernel/drivers/scsi/cpqfc.o done /sbin/mkinitrd /boot/cpq-initrd-2.4.18-3.img-3 2.4.18-3 The following changes would have been made to /boot/grub/menu.lst --- /boot/grub/menu.lst Fri Aug 9 14:08:11 2002 +++ /tmp/grub.conf.17199 Fri Aug 9 14:46:57 2002 @@ -1,5 +1,8 @@ System has boot partition vmlinuz-2.4.18-3 +/cpq-initrd-2.4.18-3.img-3 +System has boot partition +vmlinuz-2.4.18-3 /cpq-initrd-2.4.18-3.img-2 System has boot partition vmlinuz-2.4.18-3 @@ -23,8 +26,10 @@ # default=4 # commented out by Compaq HBA install script # default=5 # commented out by Compaq HBA install script # default=6 # commented out by Compaq HBA install script -default=7 -fallback=6 +# default=7 # commented out by Compaq HBA install script +default=8 +fallback=7 +# fallback=6 # commented out by Compaq HBA install script # fallback=5 # commented out by Compaq HBA install script # fallback=4 # commented out by Compaq HBA install script # fallback=3 # commented out by Compaq HBA install script @@ -74,3 +79,10 @@ kernel /vmlinuz-2.4.18-3 ro root=/dev/cciss/c0d0p2 initrd /cpq-initrd-2.4.18-3.img-2 + +# This entry (no. 8) added by Compaq HBA install script +title cpq-2.4.18-3-3 + root (hd0,0) + kernel /vmlinuz-2.4.18-3 ro root=/dev/cciss/c0d0p2 + initrd /cpq-initrd-2.4.18-3.img-3 + ---> THIS WAS A DRY RUN <--- Dry run succeeded, installing for real... ./install --drivers cpqfc --lilo --grub --initrd --noskip Cannot find lilo config file /etc/lilo.conf, will not update. 2.4.18-4smp 2.4.18-3 The default kernel image is not the same as the currently loaded kernel image 2.4.18-4smp 2.4.18-4bigmem 2.4.18-4 2.4.18-3 Kernel image is vmlinuz-2.4.18-3 Installing cpqfc for 2.4.18-3 kernel...done Installing cpqfc for 2.4.18-4 kernel...done Installing cpqfc for 2.4.18-4bigmem kernel...done Installing cpqfc for 2.4.18-4smp kernel...done /sbin/mkinitrd /boot/cpq-initrd-2.4.18-3.img-3 2.4.18-3 Updating /boot/grub/menu.lst 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_cpqfc_RedHat73-2.1.2-1 The removal of the RPM restores the original cpqfc.o module, builds a new initrd image with the previous (or no) module, and adds a new entry into /etc/lilo.conf or /boot/grub/menu.lst. You can then boot using the newest entry, or a prior known working entry. The successful installation will replace the driver that shipped with Red Hat Linux 7.3 with the 2.1.2 version of the driver, create a new Initial RAM Disk Image (initrd) that contains the 2.1.2 version of the driver and modify /etc/lilo.conf to allow the Linux Loader (lilo) to boot 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.18-3smp/kernel/drivers/scsi/cpqfc.o if you have a single processor server expect: /lib/modules/2.4.18-3/kernel/drivers/scsi/cpqfc.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: # grep version /proc/scsi/cpqfcTS/* Expect output similar to: Driver version = 2.1.2 3. The driver will be inserted in the Initial RAM Disk Image (initrd) and is automatically loaded every time the server boots. 4. To load the module use the insmod command. Type: # insmod cpqfc Expect the following output if you have Symmetric Multi-Processing support enabled: Using /lib/modules/2.4.18-3smp/kernel/drivers/scsi/cpqfc.o Expect the following output if you have a single processor server: Using /lib/modules/2.4.18-3/kernel/drivers/scsi/cpqfc.o NOTE: You will experience error messages if the Compaq's 64-bit/66MHz Fibre Channel Host Adapter is not installed. Please ensure that the hardware is installed properly. NOTE: If the hardware is properly installed and you observe error messages loading the modules, remove the entire RPM by typing: # rpm -e cpq_cpqfc_RedHat73-2.1.2-1 The removal of the RPM restores the original cpqfc.o module, builds a new initrd image with the previous (or no) module, and adds a new entry into /etc/lilo.conf or /boot/grub/menu.lst. You can then boot using the newest entry, or a prior known working entry. 5. To check whether the driver is loaded properly, type # lsmod Expect to see the module name cpqfc 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_cpqfc_RedHat73-2.1.2-1 7. Uninstalling the driver: 1) Uninstall using RPM by typing # rpm -e cpq_cpqfc_RedHat73-2.1.2-1 Expect to see output similar to: # rpm -e cpq_cpqfc_RedHat73-2.1.2-1 Attempting dry run first... ---> THIS IS A DRY RUN <--- Cannot find lilo config file /etc/lilo.conf, will not update. 2.4.18-4smp 2.4.18-3 The default kernel image is not the same as the currently loaded kernel image 2.4.18-4smp 2.4.18-4bigmem 2.4.18-4 2.4.18-3 Kernel image is vmlinuz-2.4.18-3 mkdir -p /usr/src/COMPAQ/driver_backup Uninstalling /lib/modules/2.4.18-3/kernel/drivers/scsi/cpqfc.o mv /lib/modules/2.4.18-3/kernel/drivers/scsi/cpqfc.o /tmp/cpqfc.o.old.17932 Restoring previous cpqfc.o from backup. cp -f /usr/src/COMPAQ/driver_backup//lib/modules/2.4.18-3/kernel/drivers/scsi/cpqfc.o /lib/modules/2.4.18-3/kernel/drivers/scsi/cpqfc.o rm -f /usr/src/COMPAQ/driver_backup//lib/modules/2.4.18-3/kernel/drivers/scsi/cpqfc.o rm -f /tmp/cpqfc.o.old.17932 Uninstalling /lib/modules/2.4.18-4/kernel/drivers/scsi/cpqfc.o mv /lib/modules/2.4.18-4/kernel/drivers/scsi/cpqfc.o /tmp/cpqfc.o.old.17932 Restoring previous cpqfc.o from backup. cp -f /usr/src/COMPAQ/driver_backup//lib/modules/2.4.18-4/kernel/drivers/scsi/cpqfc.o /lib/modules/2.4.18-4/kernel/drivers/scsi/cpqfc.o rm -f /usr/src/COMPAQ/driver_backup//lib/modules/2.4.18-4/kernel/drivers/scsi/cpqfc.o rm -f /tmp/cpqfc.o.old.17932 Uninstalling /lib/modules/2.4.18-4bigmem/kernel/drivers/scsi/cpqfc.o mv /lib/modules/2.4.18-4bigmem/kernel/drivers/scsi/cpqfc.o /tmp/cpqfc.o.old.17932 Restoring previous cpqfc.o from backup. cp -f /usr/src/COMPAQ/driver_backup//lib/modules/2.4.18-4bigmem/kernel/drivers/scsi/cpqfc.o /lib/modules/2.4.18-4bigmem/kernel/drivers/scsi/cpqfc.o rm -f /usr/src/COMPAQ/driver_backup//lib/modules/2.4.18-4bigmem/kernel/drivers/scsi/cpqfc.o rm -f /tmp/cpqfc.o.old.17932 Uninstalling /lib/modules/2.4.18-4smp/kernel/drivers/scsi/cpqfc.o mv /lib/modules/2.4.18-4smp/kernel/drivers/scsi/cpqfc.o /tmp/cpqfc.o.old.17932 Restoring previous cpqfc.o from backup. cp -f /usr/src/COMPAQ/driver_backup//lib/modules/2.4.18-4smp/kernel/drivers/scsi/cpqfc.o /lib/modules/2.4.18-4smp/kernel/drivers/scsi/cpqfc.o rm -f /usr/src/COMPAQ/driver_backup//lib/modules/2.4.18-4smp/kernel/drivers/scsi/cpqfc.o rm -f /tmp/cpqfc.o.old.17932 /sbin/mkinitrd /boot/cpq-initrd-2.4.18-3.img-4 2.4.18-3 The following changes would have been made to /boot/grub/menu.lst --- /boot/grub/menu.lst Fri Aug 9 14:46:59 2002 +++ /tmp/grub.conf.17932 Fri Aug 9 14:47:37 2002 @@ -1,5 +1,8 @@ System has boot partition vmlinuz-2.4.18-3 +/cpq-initrd-2.4.18-3.img-4 +System has boot partition +vmlinuz-2.4.18-3 /cpq-initrd-2.4.18-3.img-3 System has boot partition vmlinuz-2.4.18-3 @@ -27,8 +30,10 @@ # default=5 # commented out by Compaq HBA install script # default=6 # commented out by Compaq HBA install script # default=7 # commented out by Compaq HBA install script -default=8 -fallback=7 +# default=8 # commented out by Compaq HBA install script +default=9 +fallback=8 +# fallback=7 # commented out by Compaq HBA install script # fallback=6 # commented out by Compaq HBA install script # fallback=5 # commented out by Compaq HBA install script # fallback=4 # commented out by Compaq HBA install script @@ -86,3 +91,10 @@ kernel /vmlinuz-2.4.18-3 ro root=/dev/cciss/c0d0p2 initrd /cpq-initrd-2.4.18-3.img-3 + +# This entry (no. 9) added by Compaq HBA install script +title cpq-2.4.18-3-4 + root (hd0,0) + kernel /vmlinuz-2.4.18-3 ro root=/dev/cciss/c0d0p2 + initrd /cpq-initrd-2.4.18-3.img-4 + ---> THIS WAS A DRY RUN <--- ./uninstall --drivers cpqfc --lilo --grub --initrd --noskip --dry-run Dry run succeeded, uninstalling for real... ./uninstall --drivers cpqfc --lilo --grub --initrd --noskip Cannot find lilo config file /etc/lilo.conf, will not update. 2.4.18-4smp 2.4.18-3 The default kernel image is not the same as the currently loaded kernel image 2.4.18-4smp 2.4.18-4bigmem 2.4.18-4 2.4.18-3 Kernel image is vmlinuz-2.4.18-3 Uninstalling /lib/modules/2.4.18-3/kernel/drivers/scsi/cpqfc.o Restoring previous cpqfc.o from backup. Uninstalling /lib/modules/2.4.18-4/kernel/drivers/scsi/cpqfc.o Restoring previous cpqfc.o from backup. Uninstalling /lib/modules/2.4.18-4bigmem/kernel/drivers/scsi/cpqfc.o Restoring previous cpqfc.o from backup. Uninstalling /lib/modules/2.4.18-4smp/kernel/drivers/scsi/cpqfc.o Restoring previous cpqfc.o from backup. /sbin/mkinitrd /boot/cpq-initrd-2.4.18-3.img-4 2.4.18-3 Updating /boot/grub/menu.lst Feedback -------- To provide kernel/driver development feedback send email to cpqfc-discuss@lists.sourceforge.net Customer Service -------- For support for Compaq Smart Array controllers, please send email to support@compaq.com. Copyright 2002, Compaq Computer Corporation. All rights reserved. Product names mentioned herein may be trademarks and/or registered trademarks of their respective companies