********************************************************************* * IBM ServeRAID UnixWare Update * * README.TXT * * Version 4.50 * ********************************************************************* CONTENTS ________ 1.0 Overview 2.0 Change history 2.1 ServeRAID Family 4.40 to 4.50 2.2 ServeRAID Family 4.30 to 4.40 2.3 ServeRAID Family 4.00 to 4.30 2.4 ServeRAID Family 3.61 to 4.00 2.5 ServeRAID Family 3.60 to 3.61 2.6 ServeRAID Family 3.50 to 3.60 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.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.4.4 Potential problems 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 _____________ NOTE: This README provides information needed to install and configure an IBM ServeRAID-4H Ultra160 SCSI controller, IBM ServeRAID-4M Ultra160 SCSI controller, and IBM ServeRAID-4L Ultra160 SCSI controller (hereafter referred to as IBM ServeRAID-4x Ultra160 SCSI controllers). Follow each step in this README to ensure that your ServeRAID controllers have the latest software levels. The ServeRAID 4.50 release of code contains the following levels of firmware: o Firmware level 4.50 for the ServeRAID-4x Ultra160 SCSI Controller o Firmware level 3.80 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 Support 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 4.40 to 4.50 __________________________________ o Support for OS/2 SMP and OS/2 e-business. o Added support for uninstalling the IBM ServeRAID Failover Virtual Adapter in Windows 2000. o Fixed the BIOS error reporting function to the service processor. o Fixed intermittent failure during startup of Windows NT. Previously, a blue screen occurred after loss of power to the server. o Fixed failure to rebuild hot-spare physical drive. 2.2 ServeRAID Family 4.30 to 4.40 __________________________________ o Fixed ServeRAID problem associated with loading (booting) from a SCSI CD-ROM drive. This problem affected only ServeRAID-3x, ServeRAID-II, and ServeRAID controllers. o Fixed tape backup problems associated with Microsoft Windows 2000. o Fixed system diagnostic problems associated with ServeRAID-4M and ServeRAID-4L controllers. o Fixed diskette drive access problem. This problem occured when a Netfinity Fibre Channel PCI Adapter or a Netfinity FAStT Host Adapter was installed in the server. 2.3 ServeRAID Family 4.00 to 4.30 __________________________________ o Support for the new IBM ServeRAID-4M Ultra160 SCSI controller and the IBM ServeRAID-4L Ultra160 SCSI controller o ServeRAID Manager has the following new features: - Enhanced reporting and troubleshooting for defunct drives - Setting a physical drive marked with a PFA to defunct. This new action makes drive replacement easier. - Starting the IBM ServeRAID Hot Replace Wizard from a remote connection. This feature is useful when replacing a controller in a server that does not have a monitor attached. 2.4 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 - Active (Hot-plug) 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 Active (Hot-plug) 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.5 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.6 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 Virtual Product Data (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 3.0 Installation and setup instructions ________________________________________ 3.1 Updating the BIOS and firmware ___________________________________ NOTES: o The ServeRAID-4x controller does not support SCSI CD-ROMs. o To install a ServeRAID-4x controller in 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.50 software. * Install the ServeRAID-4x controller in the server. o When upgrading the controller BIOS and firmware to 4.50, you must also upgrade to level 4.50 of the device drivers and utilities. 1. Insert the "IBM ServeRAID Support" CD into the CD-ROM drive or insert the "IBM ServeRAID BIOS and Firmware Update" diskette into the diskette drive; then, turn on the server. NOTE: When starting the "IBM ServeRAID Support" CD in startable (bootable) CD mode, the ServeRAID ROM Update Wizard might hang if the ServeRAID BIOS level is 3.50 or earlier. To prevent this potential problem, update the ServeRAID BIOS and firmware with the "IBM ServeRAID BIOS and Firmware Update" diskette. 2. Wait for the IBM ServeRAID ROM Update Wizard 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 _______________________________ Install the ServeRAID device drivers that are provided with the IBM ServeRAID controllers on the "IBM ServeRAID Support" CD. Refer to the IBM Netfinity ServeRAID-4x Ultra160 SCSI Controller Device Driver Installation Instructions (4DEVDRV.PDF) in the /BOOKS directory on the "IBM ServeRAID Support" CD. This booklet provides detailed instructions for installing the device drivers on the following operating systems: o SCO UnixWare 7.x 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 UnixWare, you must have either the Java Runtime Environment (JRE) or the Java Development Kit (JDK) installed on your system. o If a previous version of the ServeRAID Manager is installed on your server, 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 a UnixWare 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. Type: mount -r -F cdfs /dev/cdrom/cdromdevicefile /mnt where cdromdevicefile is the specific device file for the CD-ROM block device. You can look in the /dev/cdrom directory to determine what this is on your server, an example is 'c0b0t6l0' or 'cdrom0'. 3. Press Enter; then, type: pkgadd -d /mnt/programs/unixware/manager/RaidMan.ds 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. 6. Press Enter. Remove the CD-ROM from the server. 3.4.2 Updating using the World Wide Web ________________________________________ 1. Download the ServeRAID Manager file (M450UW.dsz) from the World Wide Web into a temporary directory, such as /tmp. 2. Type: 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 M450UW.dsz RaidMan.ds.Z 5. Press Enter. 6. Uncompress the file by typing: uncompress RaidMan.ds.Z 7. Press Enter. 8. Add the package by typing: pkgadd -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 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 /opt/RaidMan where /opt/RaidMan is the directory where the 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 the directory where the ServeRAID Manager is installed. 2. Press Enter. 3. Type: sh RaidAgnt.sh 4. Press Enter. 3.4.4 Potential problems starting the ServeRAID Manager ________________________________________________________ o The ServeRAID Manager fails to start and the following error message displays: "Can't find class com.ibm.sysmgt.raidmgr.mgtGUI.Launch" You must configure the TCP/IP hosts file for the local server hostname even if you do not install TCP/IP networking. 1. Open the /etc/hosts file. 2. If TCP/IP networking is configured, do the following: a. If the hostname of the server is identified on the line starting with 127.0.0.1, remove the hostname from this line. b. On a new line, type the IP address of the server. c. Using the Tab key, tab to the second column and type the fully qualified hostname. d. Using the Tab key, tab to the third column and type the nickname for the server. NOTE: The following is an example of a completed line: 1.1.1.1 matrix.localdomain matrix where 1.1.1.1 is the IP address of the server and matrix is the hostname of the server. 3. If TCP/IP networking is not configured, do the following: a. Type the server name in the third column of the line that starts with 127.0.0.1. NOTE: The following is an example of a completed line: 127.0.0.1 localhost matrix where matrix is the server name. 4. Restart the server for these changes to take effect. 3.5 Updating the command-line programs _______________________________________ To install the ServeRAID command-line programs, refer to the README.TXT file on the "IBM ServeRAID Command-Line Programs" diskette. 4.0 Troubleshooting tips ________________________ o If you experience problems with SCSI CD-ROM drives connected to a ServeRAID-4x 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-4x controller does not support SCSI CD-ROM drives. o If you are running DOS applications in protected mode, you must add the following lines to the CONFIG.SYS: device=x:\himem.sys device=x:\emm386.exe NOEMS where x is the drive that DOS is installed. o If you are installing a ServeRAID-4x controller into a server with one or more existing ServeRAID controllers, and the server fails to start and displays POST code EF10, do the following: 1. Remove the ServeRAID-4x controller from the server. 2. Update the BIOS and firmware on the existing controllers using the ServeRAID 4.50 software. 3. Install the ServeRAID-4x 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 IBM Netfinity ServeRAID-4x Ultra160 SCSI Controller User's Reference documents the BIOS compatibility mode incorrectly. The ServeRAID Mini-Configuration program displays the setting correctly as: o OFF indicates Extended Mode (8GB) o ON indicates Limited Mode (2GB) 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: Active PCI OS/2 Warp HelpCenter PC Server IBM Predictive Failure Analysis Netfinity ServeRAID Netfinity Manager ServerGuide 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.