********************************************************************* * IBM ServeRAID Linux Update * * README.TXT * * Version 4.00 * ********************************************************************* CONTENTS ________ 1.0 Overview 2.0 Change history 2.1 ServeRAID Family 3.61 to 4.00 2.2 ServeRAID Family 3.60 to 3.61 2.3 ServeRAID Family 3.50 to 3.60 2.4 ServeRAID Family 3.11 to 3.50 3.0 Installation and setup instructions 3.1 Updating the BIOS and firmware 3.2 Creating logical drives 3.3 Updating the device driver 3.3.1 Installing the device driver during installation 3.3.2 Updating the device driver after installation 3.4 Updating and starting the ServeRAID Manager 3.4.1 Updating using the "IBM ServeRAID Support CD" 3.4.2 Updating using the World Wide Web 3.4.3 Starting the ServeRAID Manager 3.5 Updating the command-line programs 4.0 Troubleshooting tips 5.0 Web Site and Support Phone Number 6.0 Trademarks and Notices 7.0 Disclaimer 1.0 Overview _____________ Follow each step in this README to ensure that your ServeRAID controllers have the latest software levels. The ServeRAID 4.00 release of code contains the following levels of firmware: o Firmware level 4.00 for the ServeRAID-4H Ultra160 SCSI Controller o Firmware level 3.61 for the ServeRAID-3H/3HB Ultra2 SCSI Controller and the ServeRAID-3L Ultra2 SCSI Controller o Firmware level 2.88 for the ServeRAID-II Ultra SCSI Controller o Firmware level 2.88 for the integrated ServeRAID Controller on the IBM PC Server 330 and IBM Netfinity 5500 system boards o Firmware Level 2.25 for the ServeRAID Adapter Creating logical drives requires the "IBM ServeRAID Support CD." This CD comes 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 writer is not available and the CD is lost, defective, or destroyed, contact the IBM HelpCenter for a replacement "IBM ServeRAID Support CD." 2.0 Change History __________________ 2.1 ServeRAID Family 3.61 to 4.00 __________________________________ o ServeRAID Manager has the following new features: - Runs in Netfinity Director on Windows 2000 as a console, server, and agent - Runs in Netfinity Director on NetWare 5.x and UnixWare 7.1 as an agent - Red Hat Linux 6.1 and OpenServer 5.05 support - SNMP trap support - Agent runs as a service - Hot-plug (Active) PCI hot-replace support for Windows NT 4.0 - RAID level-00, 10, 1E0, and 50 support o Windows 2000 device driver supports logical drives larger than 4 GB, clustering, failover, and Hot-plug (Active) PCI hot add and hot remove. o ServeRAID-4H firmware - New RAID level-00, 10, 1E0, and 50 - Ultra160 physical drive support - 4 channel support - Enhanced failed physical drive reporting o ServeRAID-3H/3HB and the ServeRAID-3L firmware - Enhanced failed physical drive reporting - (3L only) Fixed support for 64 KB stripe-unit size 2.2 ServeRAID Family 3.60 to 3.61 __________________________________ o (Windows NT only) Resolved adapter hang during FlashCopy. Requires this update in the firmware and IPSSEND command-line utility. o Integrated Retain Tip H1746 fix. 2.3 ServeRAID Family 3.50 to 3.60 __________________________________ 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 Service (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 expect higher performance and less CPU utilization when accessing RAID drives. o New device driver for the Red Hat Linux 6.0 operating system. o ServeRAID-3H/3HB and the ServeRAID-3L firmware - Performance enhancements in the ServeRAID firmware - Support for arrays consisting of up to 16 physical drives with 32 KB and 64 KB stripe-unit sizes - Support for up to four concurrent FlashCopy commands - Fix of rare, but potential, failure that might result under repeated manual movement of cluster resources from one server to another under MSCS - Fix of potential hang conditions resulting from the handling of the ServeRAID battery-backup cache - Enhancement of drive rebuilding while logical drive migration is in progress - Fix of various operating system-level traps reported on, but not limited to, OS/2 and UnixWare 7.1 - Improved handling of drives that exceed the Predictive Failure Analysis (PFA) threshold 2.4 ServeRAID Family 3.11 to 3.50 __________________________________ 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 arrays. o ServeRAID-3H/3HB and the ServeRAID-3L firmware - Rebuild recovery enhancements - New RAID level-5E - FlashCopy - Adaptive read-ahead support - Enhanced import configuration path when importing a configuration with a non-default stripe-unit size - RAID level-1 rebuild error recovery enhancements - Corrected system hang condition for PC Server 704 - Channel 3 quorum-arbitration link no longer required when running Microsoft Cluster Service (MSCS) - Clustering error recovery enhancements - Message to the user added when voltage drop or removal of battery-backup cache option 3.0 Installation and setup instructions ________________________________________ 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 the ServeRAID-4H or ServeRAID-3H/3HB or ServeRAID-3L controllers. o To use a ServeRAID-4H controller, you must update the ServeRAID Linux device driver to version 4.00 or later before installing the controller into the system. o To use firmware version 3.60 or later for the ServeRAID-3H/3HB or ServeRAID-3L controllers, you must update the ServeRAID Linux device driver to version 3.60 or later before updating the firmware on the controller. 3.1 Updating the BIOS and firmware ___________________________________ NOTES: o The ServeRAID-4H controller does not support SCSI CD-ROM(s). o To install a ServeRAID-4H controller into a server with one or more existing ServeRAID controllers, do the following: * Update the BIOS and firmware on the existing controllers using the ServeRAID 4.00 software. * Install the ServeRAID-4H controller in the server. o When upgrading the controller BIOS and firmware to 4.00, you must also upgrade to level 4.00 of the device drivers and utilities. 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 server. NOTE: When starting the "IBM ServeRAID Support CD" in startable-CD (bootable) mode, the ServeRAID BIOS/Firmware Update program might hang 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.2 Creating logical drives ____________________________ NOTES: o Skip this step if your ServeRAID controller already has been configured with logical drives. o You must create logical drives on the ServeRAID controller before you can use it. 1. After the "IBM ServeRAID Support CD" updates the BIOS and firmware, the ServeRAID Manager will start. 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. 3.3 Updating the device driver _______________________________ 3.3.1 Installing the device driver during Red Hat Linux 6.1 installation ____________________________________________________________ NOTE: This section provides instructions for installing the ServeRAID device driver (version 1.0) from diskette. Before you can install the device drivers, you must create the Red Hat device driver diskette. Creating the Red Hat Linux device driver diskette: o To create the Red Hat Linux device driver diskette on Windows 95, Windows 98, Windows NT 4.0, or Windows 2000, do the following: 1. Insert the "IBM ServeRAID Support CD" into the CD-ROM drive. 2. At a DOS prompt, type the following: d:\tools\dsk4w32 images\redhatdd.img a: where d is the drive letter of the CD-ROM drive and a is the drive letter of the diskette drive. 3. Press Enter. 4. Remove the CD from the CD-ROM drive. o To create the Red Hat Linux device driver diskette on OS/2 Warp, do the following: 1. Insert the "IBM ServeRAID Support CD" into the CD-ROM drive. 2. At a DOS prompt, type the following: d:\tools\dsk4wrp images\redhatdd.img a: where d is the drive letter of the CD-ROM drive and a is the drive letter of the diskette drive. 3. Press Enter. 4. Remove the IBM ServeRAID Support CD from the CD-ROM drive. o To create the Red Hat Linux device driver diskette on Linux, do the following: 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. Type the following lines on one line: dd if=/mnt/images/redhatdd.img of=/dev/diskettedevicefile bs=32k where diskettedevicefile is the specific device file for the diskette block device. Typically this is /dev/fd0. 4. Unmount the CD-ROM by typing: umount /mnt 5. Press Enter. 6. Remove the "IBM ServeRAID Support CD" from the CD-ROM drive. To install the device drivers for Red Hat Linux 6.1 (or later): 1. Insert the Red Hat 6.1 Installation CD into the CD-ROM drive. 2. Turn on or restart the server. 3. At the command prompt, type: linux dd and any other options for your installation; then, press Enter. 4. Follow the prompts to complete the installation. 3.3.2 Updating the device driver for Red Hat Linux 6.1 (or later) after installation ___________________________________________________________ This section provides instructions for updating the ServeRAID device drivers from CD-ROM, diskette, and the World Wide Web. You can update the device drivers if Linux is already installed or when updating previous device drivers. NOTE: Before proceeding, you must already have installed Red Hat 6.1 Linux distribution on your server. This set of instructions assumes the following: o You already have a Red Hat 6.1 Linux operating system installed. o You want to add a ServeRAID controller to your server. o To update device drivers from CD-ROM after installing Linux, do the following: 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. To unpack the device driver, type: tar -zxvf /mnt/programs/linux/driver/ips-400.tgz -C /tmp 4. To apply the patch, type: cd /usr/src 5. Press Enter; then, type: patch -p0 < /tmp/kernel-2.2.13-4.00-patch 6. Press Enter. 7. Unmount the CD-ROM by typing: umount /mnt 8. Press Enter. 9. Reconfigure and recompile your kernel. NOTE: See the Linux Kernel-HOWTO for more information on configuring and recompiling your kernel. o To update device drivers from diskette after installing Linux, do the following: 1. Insert the "IBM ServeRAID Device Drivers" 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. To unpack the device driver, type: tar -zxvf /mnt/linux/ips-400.tgz -C /tmp 4. To apply the patch, type: cd /usr/src 5. Press Enter; then, type: patch -p0 < /tmp/kernel-2.2.13-4.00-patch 6. Press Enter. 7. Unmount the diskette drive by typing: umount /mnt 8. Press Enter. 9. Reconfigure and recompile your kernel. NOTE: See the Linux Kernel-HOWTO for more information on configuring and recompiling your kernel. o To update device drivers downloaded from the World Wide Web after installing Linux, do the following: 1. Download the file ips-400.tgz that is available from the IBM Developer Web site at the following address: http://www.developer.ibm.com/welcome/netfinity/ serveraid.html 2. To unpack the device driver, type: tar -zxvf ips-400.tgz -C /tmp 3. To apply the patch, type: cd /usr/src 4. Press Enter; then, type: patch -p0 < /tmp/kernel-2.2.13-4.00-patch 5. Press Enter. 6. Reconfigure and recompile your kernel. NOTE: See the Linux Kernel-HOWTO for more information on configuring and recompiling your kernel. 3.4 Updating and starting the ServeRAID Manager ________________________________________________ NOTES: o To install or remove the ServeRAID Manager package, you must have 'root' privileges. o To use the ServeRAID Manager program with Linux, you must have either the Java Runtime Environment (JRE) or the Java Development Kit (JDK) installed on your system. The ServeRAID Manager expects to find the JRE or the JDK in the /usr/java/bin directory. Ensure that there is a link from /usr/java/bin to wherever the JRE or JDK is installed. o To remove the ServeRAID Manager program from the Linux system, do the following: 1. Type: rpm --erase RaidMan 2. Press Enter. 3.4.1 Updating using the "IBM ServeRAID Support CD" ____________________________________________________ 1. Insert the "IBM ServeRAID Support CD" into the CD-ROM drive. 2. If the CD does not mount automatically, type: mount -r /dev/cdrom /mnt where /mnt is the mount point and /dev/cdrom is the device file for the CD-ROM block device 3. Press Enter; then, type (the following lines should be typed on one line): rpm --install /mnt/programs/linux/manager/RaidMan-4.00-i386.rpm where /mnt is the mount point used in step 2. 4. Press Enter. 5. When the installation is complete, type: umount /mnt where /mnt is the mount point used in step 2. NOTE: For those operating systems that automount the CD, you must first close the window displaying the files on the CD. 6. Press Enter. Remove the CD-ROM from the server. 3.4.2 Updating using the World Wide Web ________________________________________ 1. Download the M400LNX.rpm file into a temporary directory, such as /tmp. 2. Type: rpm --install /tmp/M400LNX.rpm where /tmp is the directory used for the download in step 1. 3. Press Enter. 3.4.3 Starting the ServeRAID Manager _____________________________________ NOTE: You must have superuser priveleges before starting this procedure. o To start the ServeRAID Manager with a graphical user interface: NOTE: You can use the ServeRAID Manager to configure and setup the ServeRAID Manager Agent notification list, security list, and SNMP Trap Destination List. 1. Type: cd /usr/RaidMan where /usr/RaidMan is the directory where ServeRAID Manager is installed. 2. Press Enter. 3. Type: sh RaidMan.sh 4. Press Enter. o To start the ServeRAID Manager without a graphical user interface (the agent): NOTES: o This starts a monitoring agent for your ServeRAID controllers in a smaller memory footprint. No managing or configuration actions are available. o The agent might already be running if you selected this during package installation. To verify, type: "ps -aef | grep RaidAgnt | grep -v grep"; then, press Enter. 1. Type: cd /usr/RaidMan where /usr/RaidMan is the directory where ServeRAID Manager is installed. 2. Press Enter. 3. Type: sh RaidAgnt.sh 4. Press Enter. 3.5 Updating the command-line programs _______________________________________ To install the ServeRAID command-line programs, refer to the README.TXT file on "IBM ServeRAID Command-Line Program Diskette." 4.0 Troubleshooting tips ________________________ o If you experience problems with SCSI CD-ROM drives connected to a ServeRAID-4H controller, do one of the following: o Use a ServeRAID-3HB or ServeRAID-3L controller instead. o Install an IDE CD-ROM drive in your server. The ServeRAID-4H controller does not support SCSI CD-ROM drives. o If you are installing a ServeRAID-4H controller into a server with one or more existing ServeRAID controllers, and the server fails to start displaying POST code EF10, do the following: 1. Remove the ServeRAID-4H controller from the server. 2. Update the BIOS and firmware on the existing controllers using the ServeRAID 4.00 software. 3. Install the ServeRAID-4H controller in the server. o On a Netfinity server, if your operating system fails to start three times consecutively, the system BIOS will turn off the processor cache. When this happens the "IBM ServeRAID Support CD" behaves unexpectedly. To correct this problem, enter the system BIOS and re-enable the processor cache (or load the default settings). Refer to your system documentation for instructions on entering the system BIOS. o The ServeRAID-4H controller is not compatible with the ServeRAID device driver shipped with Caldera OpenLinux 2.3, Red Hat Linux 6.1, SuSE Linux 6.2, and Pacific HiTech TurboLinux 4.0. To install Red Hat Linux 6.1 using the device driver diskette, refer to the "Installation and setup instructions" section of this README.TXT file. Until the other distributions are updated to include the ServeRAID device driver version 4.00 or later, you will be unable to install the operating system to a ServeRAID-4H controller. You can use the ServeRAID-4H controller as secondary storage (non-boot controller) provided that you update the ServeRAID device driver to 4.00 or later prior to installing the ServeRAID-4H controller in your system. o If you received a ServeRAID-3H/3HB or ServeRAID-3L controller with version 3.60 or later of the ServeRAID firmware, 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 from the IBM Web site. 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. Then, you can update the firmware on the controller to the latest level. o When running the multiple processor kernel, Linux has a problem accessing controllers that are assigned IRQ 9 by the system BIOS. To correct this problem, enter the system BIOS and change the IRQ assigned to each controller. o If you previously installed version 1.00 of the ServeRAID Linux device driver on a kernel without ServeRAID support (stable kernels prior to 2.2.13 and development kernels prior to 2.3.16), you will need to start with a fresh set of kernel sources before applying the ServeRAID Linux driver verison 4.00 patch. 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 (the following lines should be typed on one line): 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. o The Mini-Configuration Program reports RAID level-10 as RAID level-1. 5.0 Web Sites and Support Phone Number _______________________________________ o You can download new and updated files for the IBM ServeRAID and Clustering products from the IBM Support Web site: http://www.ibm.com/pc/support/ o With the original purchase of an IBM hardware product, you have access to extensive support coverage. During the IBM hardware product warranty period, you may call the IBM Personal Computer HelpCenter (1-800-772-2227 in the U.S.) for hardware product assistance covered under the terms of the IBM hardware warranty. 6.0 Trademarks and Notices ___________________________ The following terms are trademarks of the IBM Corporation in the United States or other countries or both: HelpCenter OS/2 Warp IBM PC Server Netfinity Predictive Failure Analysis Netfinity Manager ServeRAID OS/2 UNIX is a registered trademark in the United States and other countries and is licensed exclusively through The Open Group. 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. 7.0 Disclaimer _______________ 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 Corporation.