********************************************************************* * IBM ServeRAID Linux Update Readme * * Version 3.60 * ********************************************************************* CONTENTS ________ 1.0 Overview 2.0 Step 1, Updating the BIOS and firmware 3.0 Step 2, Creating logical drives 4.0 Step 3, Updating the device driver 4.1 Installing the driver for the first time 4.1.1 Installing from the IBM ServeRAID Support CD 4.1.2 Installing from the IBM ServeRAID Device Driver Diskette 4.1.3 Installing from the Web 4.2 Updating the driver from an earlier version 4.2.1 Updating from the IBM ServeRAID Support CD 4.2.2 Updating from the IBM ServeRAID Device Driver Diskette 4.2.3 Updating from the Web 5.0 Troubleshooting tips 6.0 Change history 7.0 Trademarks and notices 1.0 Overview _____________ Follow each step in this readme to ensure that your ServeRAID controllers have the latest software level for Linux 2.2.x. Creating logical drives requires the "IBM ServeRAID Support CD." This CD either came with your ServeRAID controller or You can download an ISO image from the IBM Web site. Refer to the documentation that came with your CD-ROM writer for details on how to create a CD from an ISO image. If a CD burner is not available and the CD is lost, defective, or destroyed, contact your local HelpCenter for a replacement "IBM ServeRAID Support CD." To install the ServeRAID command-line programs, refer to the readme.txt file on "IBM ServeRAID Command-Line Program Diskette." For more information about IBM ServeRAID and server products, visit the IBM Netfinity Web site at: http://www.pc.ibm.com/netfinity or refer to the ServeRAID User's Guide. The Firmware/Bios on the "IBM ServeRAID Support CD" and the "IBM ServeRAID Firmware/BIOS Update Diskette Version 3.60" contains BIOS Level 3.60.05 and the following firmware levels: o Firmware Level 3.60.21 for the ServeRAID 3H Ultra 2 SCSI Adapter and the ServeRAID 3L Ultra 2 SCSI Adapter. o Firmware Level 2.88.13 for the ServeRAID II Ultra SCSI Adapter. o Firmware Level 2.88.13 for the integrated ServeRAID Controller on the IBM PC Server 330 and IBM Netfinity 5500 system boards. o Firmware Level 2.25.01 for the ServeRAID Adapter. 2.0 Step 1, Updating the BIOS and firmware ___________________________________________ IMPORTANT NOTE: The Linux device driver bundled with Caldera OpenLinux 2.3, Red Hat Linux 6.1, SuSE Linux 6.2, and Pacific HiTech TurboLinux 4.0 is not compatible with version 3.60 of the ServeRAID firmware. To use ServeRAID 3.60 firmware you must update the ServeRAID Linux device driver to version 3.60 (or newer) BEFORE updating the firmware on the controller. The updated Linux device driver is available from: o IBM ServeRAID Support CD (version 3.60 or higher) o IBM ServeRAID Device Driver Diskette (version 3.60 or higher) o IBM ServeRAID for Linux Web site (http://www.developer.ibm.com/welcome/netfinity/serveraid.html) o IBM Netfinity Support Web site (http://www.pc.ibm.com/support) NOTES: a. When upgrading the BIOS/firmware to 3.60, you must also upgrade to 3.60 version drivers and utilities. b. If you are running a ServeRAID-3L with write-back mode enabled and a 64 KB logical block size, you might experience a hang condition. This behavior will be corrected in the first half 2000 firmware release. To work-around this potential problem, change the cache setting to Write Through. Otherwise, do not create logical drives with a block size of 64 KB. Once the block size is set with the creation of the array, you cannot change the block size without losing data. If you need to run in write-back mode, you must backup your data, recreate arrays and logical drives, and then restore your data. 1. Insert the "IBM ServeRAID Support CD" into the CD-ROM drive or insert the "IBM ServeRAID BIOS/Firmware Update Diskette" into the diskette drive; then, turn on the system. NOTE: The ServeRAID BIOS/Firmware Update program might hang while booting the "IBM ServeRAID Support CD," if the ServeRAID BIOS is 3.10 or earlier. To prevent this potential problem, update the ServeRAID BIOS and firmware with the ServeRAID BIOS/Firmware Diskette 3.50 or later which is available on the IBM Web site. 2. Wait for the BIOS/Firmware Update program to start and follow the instructions on the screen. 3.0 Step 2, Creating logical drives ____________________________________ Skip this step if your ServeRAID controller has already been configured with logical drives. 1. After the "IBM ServeRAID Support CD" updates the BIOS/firmware, it will start the ServeRAID Manager. You will see an Express/Custom choice on the screen. Choose Express for the ServeRAID Manager to automatically create your logical drives. Choose Custom to manually create your logical drives. You must create logical drives on the ServeRAID controller before you can use it. 4.0 Step 3, Updating the device driver _______________________________________ 4.1 Installing the driver for the first time _____________________________________________ 4.1.1 Installing from the IBM ServeRAID Support CD ___________________________________________________ Before proceeding, you must have already installed a Linux distribution onto your system. This set of instructions assumes you already have a Linux system installed and want to add a ServeRAID to your system. 1. Insert the "IBM ServeRAID Support CD" into the CD-ROM drive. 2. Type: mount -t iso9660 /dev/cdromdevicefile /mnt where cdromdevicefile is the specific device file for the CD-ROM block device. Typically this is /dev/cdrom. 3. Press Enter; then, type: cd /usr/src patch -p0 < /mnt/programs/linux/driver/patch.ips 4. Unmount the CD-ROM: umount /mnt 5. Reconfigure and recompile your kernel NOTE: See the Linux Kernel-HOWTO for more information on configuring and recompiling your kernel. 4.1.2 Installing from the IBM ServeRAID Device Driver Diskette _______________________________________________________________ Before proceeding, you must have already installed a Linux distribution onto your system. This set of instructions assumes you already have a Linux system installed and want to add a ServeRAID to your system. 1. Insert the "IBM ServeRAID Device Driver Diskette" into the diskette drive. 2. Type: mount -t msdos -o conv=auto /dev/diskettedevicefile /mnt where diskettedevicefile is the specific device file for the diskette block device. Typically this is /dev/fd0. 3. Press Enter; then, type: cd /usr/src patch -p0 < /mnt/linux/patch.ips 4. Unmount the diskette drive: umount /mnt 5. Reconfigure and recompile your kernel NOTE: See the Linux Kernel-HOWTO for more information on configuring and recompiling your kernel. 4.1.3 Installing from the Web ______________________________ Before proceeding, you must have already installed a Linux distribution onto your system. This set of instructions assumes you already have a Linux system installed, want to add a ServeRAID to your system and are running a stable kernel prior to 2.2.13 or a development kernel prior 2.3.16. 1. Download the file (ips-360.tgz) o http://www.pc.ibm.com/support o http://www.developer.ibm.com/welcome/netfinity/serveraid.html 2. Unpack the file using tar -zxvf ips-360.tgz to create the files: README ChangeLog ips-1.00-3.60-patch ips-3.60-patch 3. Apply the patch cd /usr/src patch -p0 < ips-3.60-patch 4. Reconfigure and recompile your kernel NOTE: See the Linux Kernel-HOWTO for more information on configuring and recompiling your kernel. 4.2 Updating the driver from an earlier version ________________________________________________ 4.2.1 Updating from the IBM ServeRAID Support CD _________________________________________________ Before proceeding, you must have already installed a Linux distribution onto your system and have previously patched the ServeRAID driver into your kernel. 1. Insert the "IBM ServeRAID Support CD" into the CD-ROM drive. 2. Type: mount -t iso9660 /dev/cdromdevicefile /mnt where cdromdevicefile is the specific device file for the CD-ROM block device. Typically this is /dev/cdrom. 3. Press Enter. 4. Type: cd /usr/src/linux cp /mnt/programs/linux/driver/ips.c drivers/scsi cp /mnt/programs/linux/driver/ips.h drivers/scsi 5. Unmount the CD-ROM: umount /mnt 6. Press Enter. 7. Reconfigure and recompile your kernel NOTE: See the Linux Kernel-HOWTO for more information on configuring and recompiling your kernel. 4.2.2 Updating from the IBM ServeRAID Device Driver Diskette ____________________________________________________________ Before proceeding, you must have already installed a Linux distribution onto your system and have previously patched the ServeRAID driver into your kernel. 1. Insert the "IBM ServeRAID Device Driver Diskette" into the diskette drive. 2. Type: mount -t msdos -o conv=auto /dev/diskettedevicefile /mnt where diskettedevicefile is the specific device file for the diskette block device. Typically this is /dev/fd0. 3. Press Enter. 4. Type: cd /usr/src/linux cp /mnt/linux/ips.c drivers/scsi cp /mnt/linux/ips.h drivers/scsi 5. Unmount the diskette drive: umount /mnt 5. Press Enter. 6. Reconfigure and recompile your kernel NOTE: See the Linux Kernel-HOWTO for more information on configuring and recompiling your kernel. 4.2.3 Updating from the Web ___________________________ Before proceeding, you must have already installed a Linux distribution onto your system. This set of instructions assumes you already have a Linux system installed, want to add a ServeRAID to your system and are running a kernel that includes ServeRAID support (stable kernels 2.2.13 and later or development kernels 2.3.16 and later). 1. Download the file (ips-360.tgz) o http://www.pc.ibm.com/support o http://www.developer.ibm.com/welcome/netfinity/serveraid.html 2. Unpack the file using tar -zxvf ips-360.tgz to create the files: README ChangeLog ips-1.00-3.60-patch ips-3.60-patch 3. Apply the patch cd /usr/src patch -p0 < ips-1.00-3.60-patch 4. Reconfigure and recompile your kernel NOTE: See the Linux Kernel-HOWTO for more information on configuring and recompiling your kernel. 5.0 Troubleshooting tips ________________________ o If you received a controller with version 3.60 of the ServeRAID firmware (the firmware version number is displayed during the boot process) you will need to downgrade the firmware on your controller to version 3.50 before installing Caldera OpenLinux 2.3, Red Hat Linux 6.1, SuSE Linux 6.2, or Pacific HiTech TurboLinux 4.0. You can obtain version 3.50 of the ServeRAID BIOS and Firmware Diskette from: o IBM Netfinity Support Web site (http://www.pc.ibm.com/support) Normally the ServeRAID BIOS and Firmware Diskette will not update the BIOS and firmware on your controller if you already have a newer version. To force the update, press Ctrl+F at the update screen. After installing Linux you must update the ServeRAID Linux device driver (see section 4 of this readme). Then, you can update the firmware on the controller back to 3.60 (see section 1 of this readme). o On Netfinity systems, if your system fails to boot three times consecutively, the system BIOS will turn off the processor cache. When this happens the ServeRAID Support CD behaves unexpectedly. To correct this problem enter the system BIOS and reenable the processor cache (or load default settings). o If you are installing Red Hat Linux 6.1 onto a system with more than one type of SCSI controller (i.e. the onboard Adaptec and a ServeRAID controller) you might experience a kernel panic when you reboot the system after the installation completes. To work-around this potential problem, use the following procedure: 1. At the "Congratulations, installation is complete." screen, press . 2. At the "bash#" prompt, type: cd /mnt/sysimage 3. Press Enter. 4. Type: LC_ALL=C usr/sbin/chroot . /sbin/mkinitrd -f /boot/initrd-2.2.12-20.img 2.2.12-20 5. Press Enter. 6. Type: usr/sbin/chroot . /sbin/lilo 7. Press Enter. 8. Type: cd / 9. Press Enter. 10. If you are using the text-based installation of Red Hat Linux 6.1, proceed to step 14. Otherwise continue through step 13. 11. Press to return to the install screen. 12. Conclude the installation by selecting "Exit". 13. Your system is now installed and will reboot. 14. Press to return to the install screen. 15. Conclude the installation by selecting "OK". 16. Your system is now installed and will reboot. 6.0 Change history __________________ ServeRAID Family changes from level 3.50.20 to 3.60.21 ______________________________________________________ o ServeRAID Manager has the following new features: - Runs in Netfinity Director on Windows NT - OS/2 and NetWare 5.0 support - Option to verify a Microsoft Cluster Server (MSCS) is setup correctly - Standby Hot Spare support - BIOS compatibility mode setting - Enable write-back cache in the drives support - Printable configuration, code levels, event logs, and VPD - Enhanced PCI Hot Plug and Failover support - Enclosure monitoring. o The ServeRAID Manager replaces the following programs: - DOS Configuration program - OS/2 Administration and Monitoring program - NetWare Administration and Monitoring program - Windows NT Administration and Monitoring program. o IPSSEND BACKUP now saves the BIOS settings. o The High-Performance Windows NT 4.0 (monolithic) driver is integrated with the standard miniport driver now. You can now expect higher performance and less CPU utilization when accessing RAID drives. o New device driver for the Red Hat Linux 6.0 operating system. ServeRAID-3H/3L changes from level 3.50.25 to 3.60.21 _____________________________________________________ o Performance enhancements in the ServeRAID firmware. o Support for arrays consisting of up to 16 physical drives with 32 KB and 64 KB stripe-unit sizes. o Support for up to four concurrent FlashCopy commands. ServeRAID-3H/3L changes from level 3.50.22 to 3.50.25 _____________________________________________________ o Fix of rare, but potential, failure that might result under repeated manual movement of cluster resources from one server to another under MSCS. o Fix of potential hang conditions resulting from the handling of the ServeRAID battery-backup cache. o Enhancement of drive rebuilding while logical drive migration is in progress. o Fix of various operating system-level traps reported on, but not limited to, OS/2 and UnixWare 7.1. o Improved handling of drives that exceed the (Predictive Failure Analysis (PFA) threshold. ServeRAID-3H/3L changes from level 3.11.00 to 3.50.22 _____________________________________________________ o Rebuild recovery enhancements o New RAID level-5E o FlashCopy o Adaptive Read-Ahead support o Enhanced import configuration path when importing a configuration with a non-default stripe-unit size o RAID level-1 rebuild error recovery enhancements o Corrected system hang condition for PC Server 704 o Channel 3 quorum-arbitration link no longer required when running Microsoft Cluster Server (MSCS) o Clustering error recovery enhancements o Message to the user added when voltage drop or removal of Battery-Backup Cache option ServeRAID Family changes from level 3.11.00 to 3.50.20 ______________________________________________________ o New ServeRAID Manager for Windows NT and UnixWare o Support for 12 controllers with Windows NT o Logical drive numbering starts at 1 instead of 0 o When creating a hot-spare drive, old ServeRAID configuration data is automatically deleted from the drive. This eliminates the low-level format requirement for cluster setups. o Corrected Windows NT installation problems with more than seven drives in RAID level-5 array. ServeRAID-II and integrated ServeRAID controller on the IBM PC Server 330 and IBM Netfinity 5500 system boards: Changes from level 2.88.08 to 2.88.13 ___________________________________________________________ o Enhancement of drive rebuilding while logical drive migration is in progress. o Fix of various operating system-level traps reported on, but not limited to, OS/2 and UnixWare 7.1. ServeRAID-II and integrated ServeRAID controller on the IBM PC Server 330 and IBM Netfinity 5500 system boards: Changes from level 2.88.06 to 2.88.08 ___________________________________________________________ o Rebuild recovery enhancements o Clustering error recovery enhancements 7.0 Trademarks and notices __________________________ The following terms are trademarks of the IBM Corporation in the United States or other countries or both: IBM Netfinity OS/2 ServeRAID Microsoft, Windows, and Windows NT are trademarks or registered trademarks of Microsoft Corporation. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Other company, product, and service names may be trademarks or service marks of others. THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. Note to U.S. Government Users -- Documentation related to restricted rights -- Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp.