********************************************************************* * IBM ServeRAID Linux * * README.TXT * * Version 8.15 * ********************************************************************* CONTENTS ________ 1.0 Overview 2.0 Change history 2.1 ServeRAID Family 8.10 to 8.15 2.2 ServeRAID Family 8.00 to 8.10 2.3 ServeRAID Family 8.00 3.0 Installation and setup instructions 3.1 Updating the BIOS and firmware 3.2 Creating logical drives 3.3 Installing or updating the device driver 3.4 Installing the ServeRAID Manager 3.5 Installing the ARCCONF command-line program 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-8i Serial Attached SCSI (SAS) controller. It also provides information about ServeRAID support for the IBM TotalStorage DS300 and DS400 external storage enclosures. Follow each step in this README to ensure that your ServeRAID controllers have the latest software levels. The ServeRAID 8.15 release of code contains the following levels of firmware: o Firmware level 5.0 for the ServeRAID-8i SAS Controller Creating logical drives, prior to installing the ServeRAID Manager program, 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 comes 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 8.10 to 8.15 __________________________________ o Support for the following operating systems: + Red Hat Enterprise Linux 4 AS/ES/WS* + Red Hat Enterprise Linux 4 AS/ES for EM64T* + Red Hat Enterprise Linux 3 AS/ES/WS* + SuSE Linux Enterprise Server 9 with Service Pack 1 for Intel x86 and EM64T + Microsoft Windows Server 2003 with Service Pack 1 for EM64T + Novell NetWare 6.5 with Service Pack 3 *Out-of-box and current quarterly update o Enhanced functionality in the ServeRAID Manager program: - Ability to manage FlashCopy backups of logical drive data on external storage enclosures o Fixed RAID Level-5 rebuild problem o Fixed notification problem for lost cache data 2.2 ServeRAID Family 8.00 to 8.10 __________________________________ NOTE: This release first introduced with IBM Director 4.22. o Support for dual-controller configurations of the IBM TotalStorage DS300 and DS400 external storage enclosures o Enhanced functionality in the ServeRAID Manager program: - Support for following features on dual-controller enclosures: * Fail over and fail back of storage between controllers * Ability to select and change the preferred owner of an array * Enclosure-wide actions: shutdown, restart, update images * Automatic detection of fibre channel initiators o Support for the ServeRAID Manager program on the following operating systems: + SCO UnixWare 7.1.3 and 7.1.4 + SCO OpenServer 5.0.6a and 5.0.7 + IBM OS/2 WARP Server for e-business NOTE: When using ServeRAID Manager version 8.10 with OS/2 or UnixWare as an operating system on a remote system, the version information will display as 7.10. 2.3 ServeRAID Family 8.00 __________________________ o Support for the IBM ServeRAID-8i SAS controller o Support for the following operating systems: Microsoft Windows: + Windows 2000 Server/Advanced Server + Windows Server 2003 Workstation/Server/Enterprise Server + Windows Server 2003 for EM64T Linux: + Red Hat Enterprise Linux 3 AS/ES/WS* + Red Hat Enterprise Linux 3 AS/ES for EM64T* + SuSE Linux Enterprise Server 9* + SuSE Linux Enterprise Server 9 for EM64T* Netware: + Novell Netware 6.5 EP *Out-of-box and current quarterly update or service pack o Enhanced functionality in the ServeRAID Manager program: - Support for the following features on the IBM ServeRAID-8i controller: * RAID level-6 and RAID level-60 logical drives (in addition to standard RAID levels and volumes, including RAID-1E and 5EE) * FlashCopy backup of logical drive data * Copyback of logical drive data * Up to 512 KB stripe-unit size * Multiple dedicated hot spares - ROM Update wizard. Supports direct updates of ServeRAID controller software on local and remote systems - New action: Clear initialization method on ServeRAID-7t and ServeRAID-8i logical drives 3.0 Installation and setup instructions ________________________________________ NOTE: For detailed installation and setup instructions, refer to the IBM ServeRAID Installation Guide (INSTALL.PDF) in the /BOOKS directory on the "IBM ServeRAID Support" CD. 3.1 Updating the BIOS and firmware ___________________________________ 1. Install the new controller in the server. 2. Insert the "IBM ServeRAID Support" CD into the CD-ROM drive or insert the "IBM ServeRAID BIOS and Firmware Update (1 of 2)" diskette into the diskette drive; then, turn on the server. 3. 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, reboot the server. When the ServeRAID Manager starts, 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 Installing or updating the device driver _____________________________________________ NOTES: o When upgrading a Linux installation with a package that includes device drivers (such as a kernel upgrade), always re-install the latest version of the ServeRAID Linux device driver before rebooting your system. Install the ServeRAID device drivers that are provided with the IBM ServeRAID controllers on the "IBM ServeRAID Support" CD. Refer to the IBM ServeRAID Installation Guide (INSTALL.PDF) in the /BOOKS directory on the "IBM ServeRAID Support" CD. 3.4 Installing the ServeRAID Manager _____________________________________ Install the ServeRAID Manager that is provided with the IBM ServeRAID controllers on the "IBM ServeRAID Applications" CD or from the IBM Support Web site. Refer to the IBM ServeRAID Installation Guide (INSTALL.PDF) in the /BOOKS directory on the "IBM ServeRAID Support" CD for more installation information. o Before you can install the ServeRAID Manager under Red Hat Enterprise Linux, you must install two packages from Red Hat installation CD: - compat-libstdc++-7.3-2.96.122.i386.rpm - compat-libstdc++--devel-7.3-2.96.122.i386.rpm NOTE: The version string in the file name may be different than above. Be sure to check the version string on the Red Hat CD. For example, type: rpm --install /mnt/compat-libstdc++-7.3-2.96.122.i386.rpm where mnt is the mount point of the CD-ROM drive. o Before you can install the ServeRAID Manager under Red Hat Enterprise Linux 4 for EM64T, you must install the following package from the Red Hat installation CD: - xorg-x11-deprecated-libs-6.8.1-23.i386.rpm NOTE: The version string in the file name may be different than above. Be sure to check the version string on the Red Hat CD. o When automatically deploying ServeRAID Manager as a Linux RPM, some security authentication features are enabled by default. The normal process is for the user to start up the console and configure passwords prior to using the remote management features. This process does not provide the capability to connect remotely when the system does not have a local console. Therefore, it is impossible to log in to the system. To avoid this scenario, the security authentication must be disabled temporarily to configure the desired username and password. And then, re-enable the security feature for remote access. To disable security without using the ServeRAID Manager console, run the following command, as root: tweak.pl auth false At this point, you can connect from the remote console to configure the security settings. To re-enable security, run the following command, as root: tweak.pl auth true You must be in the /usr/RaidMan directory to run these commands. Notes: * While security is disabled your system will be in an insecure state; any user will be able to alter storage configurations. * Running tweak.pl will disconnect any users connected to the agent. o To install the ServeRAID Manager from the World Wide Web, use the following instructions: 1. Download the Linux version of the ServeRAID Manager file into a temporary directory, such as /tmp. 2. Type: rpm --install /tmp/.rpm where /tmp is the directory used for the download in step 1 and is the name of the file that was downloaded from the Web. 3. Press Enter. 3.5 Installing the ARCCONF command-line program ________________________________________________ The ARCCONF command-line program is normally installed with the ServeRAID Manager program. If you did not install ARCCONF when you installed the ServeRAID Manager, you can install it manually from the "IBM ServeRAID Support" CD or the IBM Support Web site. Refer to the IBM ServeRAID User's Reference (SRAID.PDF) in the /BOOKS directory on the "IBM ServeRAID Support" CD for installation instructions. NOTE: The HRCONF command-line program is also installed with the ServeRAID Manager. HRCONF only supports the IBM ServeRAID-7e (Adaptec HostRAID) controller. 4.0 Troubleshooting tips ________________________ o To avoid a kernel panic with the Linux 2.4.21-32.ELhugem kernel, you must boot with the boot line parameter: swiotlb=12288 o Under Red Hat Enterprise Linux AS 3, you may see the following message when you install the ServeRAID Manger: "Failed dependencies: libstdc++--libc6.1-1.so.2 is needed by RaidMan -7.10-00" To successfully install the ServeRAID Manager, you must install two packages from the Red Hat installation CD. See section 3.4, Installing the ServeRAID Manager, for details. o When installing SuSE Linux Enterprise Server 9 on a system with a USB keyboard and/or mouse, you must enter 'noapic acpi=off' in the boot parameters to complete the installation. o If you initialize one or more drives in a flashcopy source array, the flashcopy target cannot be deleted. To avoid creating a flashcopy drive that cannot be deleted, you must delete the flashcopy drive first, before you initialize the drives in the source array. o You cannot create a RAID volume using the ACU BIOS configuration ulility program for the ServeRAID-8i SAS controller. Use the ServeRAID Manager program, either in desktop or bootable-CD mode, to create RAID volumes for the ServeRAID-8i. o The ACU BIOS configuration utility does not distinguish between RAID volumes, simple volumes, and spanned volumes. It reports all volume types as just a "volume". Use the ServeRAID Manager program to view volume properties. o If you rebuild the Linux kernel, SCSI-generic support must be included or the ServeRAID Manager program will not work properly. 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 Spacebar 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: - The Caps Lock or Scroll Lock is set. - 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. Turn off the server. 2. Turn on the server. 3. Press the eject button on the CD-ROM drive. 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 The Caps Lock key is disabled when using the ServeRAID Manager program in bootable-CD mode. 5.0 Web Sites and Support Phone Number _______________________________________ o You can download new and updated files for IBM ServeRAID products from the IBM Support Web site: http://www.ibm.com/pc/support/ o For the latest list of supported operating systems, see the IBM Server Proven - SCSI and RAID Controllers Web site: http://www.pc.ibm.com/us/compat/controllers/matrix.html For supported operating systems on legacy (non-shipping) controllers, see: http://www.pc.ibm.com/us/compat/machines/index.html 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-IBM-SERV 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, Windows Server 2003, Windows XP, Windows 2000, and Windows NT are trademarks or registered trademarks of Microsoft Corporation. Linux is a registered trademark of Linus Torvalds. 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. Adaptec and HostRAID are trademarks or registered trademarks of Adaptec, Inc. 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.