********************************************************************* * IBM ServeRAID UnixWare Update * * README.TXT * * Version 4.70 * ********************************************************************* CONTENTS ________ 1.0 Overview 2.0 Change history 2.1 ServeRAID Family 4.50 to 4.70 2.2 ServeRAID Family 4.40 to 4.50 2.3 ServeRAID Family 4.30 to 4.40 2.4 ServeRAID Family 4.00 to 4.30 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, IBM ServeRAID-4Mx Ultra160 SCSI controller, IBM ServeRAID-4L Ultra160 SCSI controller, and IBM ServeRAID-4Lx Ultra160 SCSI controller (hereafter referred to as IBM ServeRAID-4 Ultra160 SCSI controllers). Follow each step in this README to ensure that your ServeRAID controllers have the latest software levels. The ServeRAID 4.70 release of code contains the following levels of firmware: o Firmware level 4.70 for the ServeRAID-4 Ultra160 SCSI Controller o Firmware level 3.82 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.50 to 4.70 __________________________________ o Support for the new IBM ServeRAID-4Mx Ultra160 SCSI controller and the IBM ServeRAID-4Lx Ultra160 SCSI controller 2.2 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.3 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.4 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. 3.0 Installation and setup instructions ________________________________________ 3.1 Updating the BIOS and firmware ___________________________________ NOTES: o The ServeRAID-4 controller does not support SCSI CD-ROMs. o To install a ServeRAID-4 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.70 software. * Install the ServeRAID-4 controller in the server. o When upgrading the controller BIOS and firmware to 4.70, you must also upgrade to level 4.70 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-4 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 (M470UW.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 M470UW.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 start a server with the IBM ServeRAID Support CD in the CD-ROM drive, the following warning message might display: You passed an undefined mode number. Press to see video modes available, to continue or wait 30 secs Press the Space bar to continue starting the IBM ServeRAID Support CD. Then, the following message displays and the CD starts: Uncompressing Linux... Ok, booting the kernel. o If you start a server with the IBM ServeRAID Support CD in the CD-ROM drive and a "boot:" prompt appears, then one of following might be preventing the CD from starting: o The Caps Lock or Scroll Lock is set. o The Shift or Alt keys are held. Press at the boot prompt to continue starting the IBM ServeRAID Support CD. o If you start a server with the IBM ServeRAID Support CD in the CD-ROM drive, and you are unable to eject the CD after exiting the ServeRAID Manager, do the following: 1. Power down the server. 2. Power the server back on. 3. Press the eject button on the CD-ROM. o If you experience problems with SCSI CD-ROM drives connected to a ServeRAID-4 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-4 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-4 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-4 controller from the server. 2. Update the BIOS and firmware on the existing controllers using the ServeRAID 4.70 software. 3. Install the ServeRAID-4 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 Caps Lock key is disabled when using the ServeRAID Manager program in startable-CD (bootable-CD) mode. 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.