********************************************************************* * IBM ServeRAID OpenServer 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 OpenServer installation 3.3.2 Updating the device driver after installing OpenServer 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 ________________________________________ 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 OpenServer 5.x.5 installation ___________________________________________________________ NOTES: o You must install logical drives as Bus Number 0 when using the MKDEV program, regardless of the channel that the physical drives are on. o You must install a nondisk device, such as a CD-ROM or tape drive, as Bus Number 1, 2, 3, or 4 relative to the channel to which it is attached. Internal Channel 1 is Bus Number 1, Internal Channel 2 is Bus Number 2, External Channel 1 is Bus Number 1, External Channel 2 is Bus Number 2, External Channel 3 is Bus Number 3, and External Channel 4 is Bus Number 4. To configure the default nondisk devices during the initial installation: 1. Redefine the default tape drive in the initial boot string. For example, to install the boot-time loadable driver IPSRAID BTLD and redefine the tape drive, go to the BOOT prompt and type: link Stp=ips(0,1,2,0) The numbers in parentheses represent the host adapter number, the bus number, the SCSI ID, and the LUN respectively. 2. When prompted for the location of the installation CD, change the bus number and SCSI ID, as required. 1. At the BOOT prompt, type: link 2. Press Enter; then, when prompted for the name of the package, type: ipsraid 3. Press Enter. 4. After the kernel loads but before it runs, the link program prompts you to insert the "IBM ServeRAID Device Drivers for SCO Operating Systems - UnixWare HBA and OpenServer BTLD" diskette. While the installation program copies the files, one or both of the following messages might appear: o Extracting BTLD distribution for ipsraid... /etc/uadmin getdev b ips:No such device (error 19) o dynamic linker: dlvr_audit: Cannot open /dev/zero for file /lib/libprot.so.1 You can ignore the first message; if the second message appears, however, you must press Enter when prompted to continue the installation. 5. Keep the "IBM ServeRAID Device Drivers for SCO Operating Systems - UnixWare HBA and OpenServer BTLD" diskette available. You will need it to configure the device driver into the link kit. For additional information about adding a boot-time loadable driver at boot time, refer to "Using Boot-Time Loadable Drivers" in the SCO OpenServer Handbook. 3.3.2 Updating the device driver after installing OpenServer _____________________________________________________________ 1. Start the server in system maintenance mode, and log in as root. 2. Type: installpkg 3. Press Enter; then, select the diskette drive in which you will insert your installation diskette. 4. When prompted, insert the "IBM ServeRAID Device Drivers for SCO Operating Systems - UnixWare HBA and OpenServer BTLD" diskette. 5. When prompted for the name of the package, type: ipsraid 6. Press Enter; then, relink the kernel (as described in "Relinking the kernel" in the SCO OpenServer Handbook) by typing the following command: cd /etc/conf/cf.d 7. Press Enter; then type: ./link_unix 8. Press Enter. 9. After the kernel rebuilds, the following message appears: The UNIX kernel has been rebuilt. Do you want this kernel to boot by default? To continue, type y The system backs up the old kernel by moving /unix to /unix.old. 10. When the system asks for the kernel environment to be rebuilt, type 'y.' The system will respond with a message. 11. Remove the "IBM ServeRAID Device Drivers for SCO Operating Systems - UnixWare HBA and OpenServer BTLD" diskette from the diskette drive. 12. Shut down the server; then, restart the server. 3.4 Updating and starting the ServeRAID Manager ________________________________________________ NOTES: o To install or remove the ServeRAID Manager package, the user MUST have 'root' privileges. o The ServeRAID Manager requires installation of the SCO OpenServer Java Development Kit (JDK) or the Java Runtime Environment (JRE). The SCO OpenServer JDK is available from the SCO website: http://www.sco.com/java/ o If ServeRAID Manager 3.60 is installed on your system, you must remove this version before upgrading to the new version. All customization files, such as the remote systems in the Main Tree and the Notification List, will be saved and used in the new version. o To remove the ServeRAID Manager program from the SCO OpenServer system, do the following: 1. Type: pkgrm 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. Mount the CD-ROM; type: mount -r -f HS,lower /dev/cd0 /mnt 3. Press Enter; then, type (the following lines should be typed on one line): pkgadd -a /mnt/programs/openserv/manager/RaidMan.adm -d /mnt/programs/openserv/manager/RaidMan.ds 4. Press Enter. 5. When the installation is complete, type: umount /mnt 6. Press Enter. Remove the CD-ROM from the server. 3.4.2 Updating using the World Wide Web ________________________________________ 1. Download the M400OPN.trz file into a temporary directory, such as /tmp. 2. Change to the directory where you downloaded the file by typing: cd /tmp where /tmp is the directory used for the download in step 1. 3. Press Enter. 4. Rename the file you downloaded by typing: mv M400OPN.trz RaidMan.tar.Z 5. Press Enter. 6. Uncompress and untar the file by typing: zcat RaidMan.tar.Z | tar xf - 7. Press Enter. 8. Add the package. Type: pkgadd -a /tmp/RaidMan.adm -d /tmp/RaidMan.ds where /tmp is the directory used for the download in step 1. 9. Press Enter. 3.4.3 Starting the ServeRAID Manager _____________________________________ NOTE: You must have superuser privileges 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 /opt/RaidMan where /opt/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 /opt/RaidMan where /opt/RaidMan is 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 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.