********************************************************************* * IBM ServeRAID UnixWare 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 UnixWare installation 3.3.2 Updating the device driver after UnixWare is installed 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 UnixWare installation ________________________________________________________________ The instructions that you use for installing the ServeRAID files when using UnixWare depend on the number of IDE and SCSI disk-storage adapters and controllers installed in the server. If all of the direct-access-storage devices (DASD) in the server are attached to a single disk-storage adapter or controller (such as the ServeRAID controller), you can skip the instructions in this section and go directly to "Installing the files while installing UnixWare." NOTES: o Attaching devices to multiple disk-storage adapters or controllers If you are attaching devices to multiple disk-storage adapters or controllers (including IDE and SCSI controllers integrated on the system board), use the following instructions. If you are not using multiple disk-storage adapters and controllers go to "Installing the files while installing UnixWare." o If you are installing UnixWare 7.1.0, you must obtain PTF7425A from SCO (ftp://ftp.sco.com/SLS) before proceeding. This patch provides two new boot diskettes (used when doing a new install of UnixWare 7.1.0) and a patch diskette. Installing UnixWare on a ServeRAID drive ________________________________________ Use the following instructions if you are using multiple disk-storage adapters or controllers and you are installing UnixWare on a drive attached to a ServeRAID controller. If you not using multiple disk-storage adapters and controllers, go to 'Installing the files while installing UnixWare.' 1. Install all ServeRAID controllers that you intend to use in your server. 2. Using the ServeRAID Manager program, create all of your arrays and define all of your logical drives. 3. Make a list of all of the ServeRAID controllers, including the order and slot number, installed in the server. To do this: a. Turn on the server. b. When the ServeRAID Mini-Configuration prompt appears, press Ctrl+I. When a server contains more than one ServeRAID controller, a selection window appears. c. The menu lists the ServeRAID controllers in order. Select the first ServeRAID controller from the menu. d. Select Advanced Functions from the Main Menu. e. Select View Controller and PCI Information from the Advanced Functions menu. f. Record the slot number for the ServeRAID controller; then, press Esc three times to return to the controller-selection window. g. Repeat step 3c through step 3f until you record the slot number for each ServeRAID controller that appears on the selection screen. 4. Turn off the server; then, remove all ServeRAID controllers except the first one on your list. NOTE: If one of the ServeRAID controllers that you need to remove is on the system board, you must do one of the following: o If the CD-ROM drive that you are using to install your operating system is attached to the integrated ServeRAID controller, disconnect or remove all disk drives attached to the integrated controller. o If only disk drives are attached to the integrated controller, disconnect the SCSI cable from the ServeRAID connector on the system board. See the label inside the server cover for the location of the ServeRAID connector. 5. Remove all other non-ServeRAID IDE and SCSI disk-storage adapters or controllers. NOTE: If one of the disk-storage controllers that you need to remove is on the system board, you must do one of the following: o If the CD-ROM drive that you are using to install your operating system is attached to the integrated disk-storage controller, disconnect or remove all disk drives attached to the integrated controller. o If only disk drives are attached to the integrated controller, disconnect the cable for the integrated controller from the IDE or SCSI connector on the system board. See the label inside the server cover for the location of the IDE or SCSI controller connector. 6. Follow the instructions in "Installing the files while installing UnixWare"; then, return here and continue with step 7. 7. Turn off the server. 8. Install any non-ServeRAID disk-storage adapters or controllers in the server; then, attach the drives to the disk-storage adapters and controllers. 9. Install the second ServeRAID controller from the list you created in step 3f; then, attach the drives to the ServeRAID controller. 10. Turn on the server and allow UnixWare to detect the new disk-storage adapters and controllers. 11. Turn off the server. 12. Repeat steps 9 through 11 until all ServeRAID adapters, ServeRAID controllers, and drives are installed. 13. You can now partition and format the logical drives attached to the additional ServeRAID adapters and controllers. See the information provided with UnixWare for more instructions. Installing UnixWare on a non-ServeRAID drive ____________________________________________ Use the instructions in this section if you are using multiple disk-storage adapters or controllers, you are installing UnixWare on a drive attached to a non-ServeRAID adapter or controller, and you intend to store only data on the drives attached to your ServeRAID adapters and controllers. 1. Install all ServeRAID controllers that you intend to use in your server. 2. Using the ServeRAID Manager program, create all of your arrays and define all of your logical drives. 3. Make a list of all of the ServeRAID controllers, including the order and slot numbers, installed in the server. To do this: a. Turn on the server. b. When the ServeRAID Mini-Configuration prompt appears, press Ctrl+I. When a server contains more than one ServeRAID controller, a selection screen appears. c. The menu lists the ServeRAID controllers in order. Select the first ServeRAID controller from the menu. d. Select Advanced Functions from the Main Menu. e. Select View Controller and PCI Information from the Advanced Functions menu. f. Record the slot number for the ServeRAID controller; then, press Esc three times to return to the controller-selection screen. g. Repeat step 3c through step 3f until you record the slot number for each ServeRAID controller that appears on the selection screen. 4. Turn off the server; then, remove all ServeRAID, IDE, and SCSI disk-storage adapters and controllers except the one attached to the drive where you intend to install UnixWare. NOTE: If one of the disk-storage or ServeRAID controllers that you need to remove is on the system board, do one of the following: o If the CD-ROM drive that you are using to install your operating system is attached to the integrated controller, disconnect or remove all disk drives attached to the integrated controller. o If only disk drives are attached to the integrated controller, disconnect the SCSI or IDE cable for the integrated controller from the connector on the system board. See the label inside the server cover for the location of the SCSI and IDE cable connectors. 5. Follow the instructions in "Installing the files while installing UnixWare"; then, return here and continue with step 6. 6. Turn off the server. 7. Install any non-ServeRAID disk-storage adapters or controllers in the server; then, attach the drives to the disk-storage adapters and controllers. 8. Install the first ServeRAID controller from the list you created in step 3f; then, attach the drives to the ServeRAID controller. 9. Turn on the server and allow UnixWare to detect the new disk-storage adapters and controllers. 10. Turn off the server. 11. Repeat steps 8 through 10 until all ServeRAID adapters, ServeRAID controllers, and drives are installed. 12. You can now partition and format the logical drives attached to the ServeRAID adapters and controllers. See the information provided with UnixWare for more instructions. Installing the files while installing UnixWare ______________________________________________ To install the ServeRAID files while installing UnixWare 7.1: 1. Use the instructions provided with UnixWare to begin the installation. 2. When a message appears asking if you want to install any HBA diskettes, insert the "IBM ServeRAID Device Drivers for SCO Operating Systems - UnixWare HBA and OpenServer BTLD" diskette; then, select Install HBA diskette. 3. Use the instructions provided in the UnixWare manual to complete the normal installation process. 3.3.2 Updating the device driver after UnixWare is installed _____________________________________________________________ Use the following instructions to install the ServeRAID files after you install UnixWare, or use these instructions to update a previously installed ServeRAID file with a newer version. You can use the UnixWare Pkgadd or the UnixWare SCOAdmin utility program to install the files. o Installing an HBA diskette file using Pkgadd: 1. Insert the "IBM ServeRAID Device Drivers for SCO Operating Systems - UnixWare HBA and OpenServer BTLD" diskette into the diskette drive. 2. Type: pkgadd -d /dev/dsk/f0t 3. Press Enter. 4. When the message 'Insert diskette into Floppy Drive 1' appears, press Enter. 5. When the message 'Installation of IBM ServeRAID SCSI IHV HBA (ips) was successful' appears, type: q 6. Press Enter. 7. After the device driver is installed, shut down and restart the server. o Installing an HBA diskette file using SCOAdmin: 1. Insert the "IBM ServeRAID Device Drivers for SCO Operating Systems - UnixWare HBA and OpenServer BTLD" diskette into the diskette drive. 2. Start the SCOAdmin utility program by typing SCOADMIN at the system prompt. 3. Click 'Software_Management'. 4. Click 'Application Installer'. 5. Click the 'Install From' tab. 6. Click Disk_A. 7. Click 'Update View' if nothing appears in the window. 8. When the icon labeled ips appears in the window, click Install. 9. After the device driver is installed, remove the diskette from the diskette drive; then, shut down and restart the server. 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 UnixWare a 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 M400UW.dsz file 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 M400UW.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 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 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.