IBM ServeRAID Manager Application CD v9.30 CONTENTS ________ 1.0 Overview 1.1 New features in this release 1.2 Supported operating systems 1.3 Supported controllers and enclosures 2.0 Installation and setup notes 2.1 General 2.2 Linux 2.3 Solaris 2.4 VMWare 2.5 Windows silient un-installation 2.6 OS/2 software levels 3.0 Troubleshooting tips 3.1 General 3.2 Microsoft Windows 3.3 Novell NetWare 3.4 Linux 3.5 ServeRAID Manager running as a plug-in 4.0 Web Site and support phone number 5.0 Trademarks and notices 6.0 Disclaimer 7.0 Licensing 1.0 Overview _____________ The ServeRAID Manager program is used to configure, administer, and monitor IBM ServeRAID, Adaptec HostRAID, and other integrated RAID controllers. 1.1 New features in this release _________________________________ o Option to enable/disable automatic failover. o Parallel operation for back ground tasks. o Clear defunct option, to remove defunct state of a hard drive. o Fix for UART log truncation, raid_agent script modification with 'awk' utility. NOTE: See ServeRAID Manager change history (readme.chg) 1.2 Supported operating systems ________________________________ You can use the ServeRAID Manager program with the following operating systems: o Microsoft Windows: + Microsoft Windows Server 2008 SP2/R2 + Windows Vista - All versions (32-bit/64-bit) + Windows 2000 Server/Advanced Server + Windows Server 2003 Workstation/Server/Enterprise Server + Windows Server 2003 for EM64T* + Microsoft Windows XP Professional + Microsoft Windows XP Professional for EM64T o Linux: + Red Hat Enterprise Linux 3 AS/ES/WS* + Red Hat Enterprise Linux 3 AS/ES for EM64T* + Red Hat Enterprise Linux 4 AS/ES/WS* + Red Hat Enterprise Linux 4 AS/ES for EM64T* + Red Hat Enterprise Linux 5 AS/ES/WS* + Red Hat Enterprise Linux 5 AS/ES for EM64T* + SuSE Linux Enterprise Server 9* + SuSE Linux Enterprise Server 9 for EM64T* + SuSE Linux Enterprise Server 10 + SuSE Linux Enterprise Server 10 for EM64T o Netware: + Novell Netware 6.5 EP* o UnixWare: + SCO UnixWare 7.1.3 and 7.1.4 o OpenServer: + SCO OpenServer 5.0.6a and 5.0.7 o OS/2: + IBM OS/2 WARP Server for e-business o Solaris: + Sun Solaris 10 Update 1 o VMWare: + VMWare 3.0 *Out-of-box and current quarterly update or service pack Minimum System Requirements: Intel Pentium Compatible 1.2 GHz processor 512 MB RAM 80 MB hard disk drive space 256 color video mode 1.3 Supported controllers and enclosures _________________________________________ You can use the ServeRAID Manager program with the following controllers and enclosures: o IBM ServeRAID-8s Serial Attached SCSI (SAS) controller o IBM ServeRAID-8k/8k-l Serial Attached SCSI (SAS) controller o IBM ServeRAID-8i Serial Attached SCSI (SAS) controller o IBM ServeRAID-7t SATA controller o IBM ServeRAID-7k Ultra320 SCSI controller o IBM ServeRAID-7e/8e (Adaptec HostRAID) controllers o IBM ServeRAID-6i/6i+ Ultra320 SCSI controller o IBM ServeRAID-6M Ultra320 SCSI controller o IBM ServeRAID-5i Ultra320 SCSI controller o IBM ServeRAID-4H/4M/4L/4Mx/4Lx Ultra160 SCSI controllers o LSI-1030 integrated RAID controller 2.0 Installation and setup notes _________________________________ 2.1 General ____________ o Refer to the IBM ServeRAID Installation Guide (INSTALL.PDF) in the /BOOKS directory on the "IBM ServeRAID Support" CD for installation information. o The ServeRAID Manager generates log files automatically to assist in tracking ServeRAID activity. The log files are created in the directory where the ServeRAID Manager is installed. * RaidEvt.log - Contains the information reported in the ServeRAID Manager event viewer for all local and remote systems. * RaidEvtA.log - Contains the information reported in the ServeRAID Manager event viewer for the local system. * RaidNot.log - Contains the information reported in the Notification Manager event viewer. * RaidErr.log - Contains Java messages generated by the ServeRAID Manager. * RaidErrA.log - Contains Java messages generated by the ServeRAID Manager agent. Information written to these files is appended to the existing files to maintain a history. However, if any of the files reach a size of 5 Mbytes, the file is copied to a new file with the extension .OLD and the original (that is, the LOG file) is deleted and recreated. If a .OLD file already exists, the existing .OLD file is destroyed. o You can configure ServeRAID Manager settings on other servers exactly as they are configured on one server. To replicate the ServeRAID Manager tree and notification list, do the following: 1. Install the ServeRAID Manager on one server. 2. Start the ServeRAID Manager. Using the 'Add remote system' action, define the servers for your tree. 3. Open the Notification Manager. Using the 'Add system' action, define the notification list. 4. Exit the ServeRAID Manager. 5. Copy the following files onto a diskette from the directory where the ServeRAID Manager is installed: RaidMSys.ser --> to replicate the tree RaidNLst.ser --> to replicate the notification list RaidSMTP.ser --> to replicate the SMTP e-mail notification list RaidJob.ser --> to replicate the jobs in the Task Scheduler 6. Install the ServeRAID Manager on the other servers. 7. Copy the files from the diskette into the directory where the ServeRAID Manager is installed on the other servers. 2.2 Linux __________ o To install the ServeRAID Manager on Red Hat Enterprise Linux, AS 3 or WS 3, you must install two packages from the 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 To install the ServeRAID Manager on 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 To install ServeRAID Manager on Red Hat Enterprise Linux 5, you must install the following package from the Red Hat installation CD: - libXp-1.0.0-8.386.rpm (32-Bit) NOTE: The 32 bit libXp-1.0.0-8.386.rpm must be used for both 32/64 bit operating system o To install the ServeRAID Manager on Novell Linux Desktop 9 Service Pack 1 for 64-bit systems, you must install two packages from the Novell Linux installation CD: - liblcms-devel-1.12-55.2.x86_64.rpm - compat-32bit-9-200502081830.x86_64.rpm NOTE: The version string in the file name may be different than above. Be sure to check the version string on the Novell Linux CD. 2.3 Solaris ____________ o To install the ServeRAID Manager on Sun Solaris 10 (i386), you must preinstall the following packages from the Solaris installation CDs: - SUNWcslr Core Solaris Libraries (Root) - SUNWcsl Core Solaris (Shared Libs) - SUNWlibmsr Math & Microtasking Libraries (Root) - SUNWgccruntime GCC Runtime libraries You must also install the following LSI Logic drivers before the ServeRAID Manager: - ITImpt LSI Logic FusionMPT(tm) drivers - LSI Logic driver V5.06 or greater Follow the installation instructions for the driver in the driver readme. NOTE: If you do not follow the instructions in the driver readme, the ServeRAID Manager will not be able to manage the LSI controller. o To install the ServeRAID Manager on Sun Solaris: 1. Unpack the installer package. For example, type: #gunzip RaidMan-8.30.00.i386.pkg.tar.gz #tar -xvf RaidMan-8.30.00.i386.pkg.tar 2. Use the 'pkgadd' command to install the ServeRAID Manager package: #pkgadd -d . NOTE: The '.' represents the current working directory--the directory where the package was unpacked. 3. Follow the instructions in the installer program. o To run the ServeRAID Manager on Sun Solaris: 1. Go to /usr/RaidMan 2. Type: ./RaidMan.sh 2.4 VMWare ___________ To install the ServeRAID Manager program on VMWare: 1. Insert the IBM ServeRAID Application CD into the CD-ROM drive. 2. Type the following command to install the 32-bit Linux ServeRAID Manager on the VMWare ESX Server: rpm -ivh RaidMan-9.00.i386.rpm 3. Install the ServeRAID Manager on a Windows or Linux machine. 4. From the Windows or Linux client, connect to the ServeRAID Manager agent on the VMWare ESX Server using the management client. NOTES: o The ServeRAID agent on the VMWare ESX Server cannot be monitored from a guest operating system. o The VMWare ESX 3.0 firewall must have specific ports enabled for incoming and outgoing traffic. The default ports ServeRAID Manager uses for connection are 34570 to 34580. 2.5 Windows silent un-installation _____________________________________ Use the silent un-installation procedure to un-install the ServeRAID Manager software from a batch script. Silent un-installation uses a command line to un-install the software without messages or user interaction. The procedure has two basic steps: 1. Find the un-install values for ServeRAID Manager in the Windows Registry 2. Create the silent un-install command Step 1 - Find un-install values in the Windows Registry To determine the un-install string, look in the registry under: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall Search for the string "ServeRAID Manager". Then, look for the key "UninstallString". This value contains the string needed to un-install ServeRAID Manager silently. The following list shows the typical values for recent ServeRAID Manager releases. NOTE: You should still check the registry to verify the value for your release. SRM 9.30 - {7126EAD4-199B-483F-AD46-36BB388C6D4B} SRM 9.20 - {7126EAD4-199B-483F-AD46-36BB388C6D4B} SRM 9.00 - {7126EAD4-199B-483F-AD46-36BB388C6D4B} SRM 8.40 - {ABD84E9C-3A32-4644-A388-BA6F9F79A0C7} SRM 8.30 - {B96EB83B-D9ED-400E-B2C3-36870C36189A} SRM 8.25 - {B96EB83B-D9ED-400E-B2C3-36870C36189A} SRM 8.20 - {1877513F-AF66-4DA5-9548-AEC596B1BFB0} SRM 8.10 - {37095634-FCE6-41F1-90FB-AC4D43A7084D} SRM 8.00 - {37095634-FCE6-41F1-90FB-AC4D43A7084D} Step 2 - Create the silent un-install command To create a release-specific silent un-install command, add the /qn option to the UninstallString, and launch the 'msiexec' command with 'start /wait'. Example (SRM 8.40): start /wait MsiExec.exe /X{ABD84E9C-3A32-4644-A388-BA6F9F79A0C7} /qn By using start /wait, the command prompt will not return until the software is completely un-installed. Refer to the following article at the Microsoft support site for a detailed explanation of the 'msiexec' command line options: http://msdn2.microsoft.com/En-US/library/aa367988.aspx Refresh menu item to repaint the screen. 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. 3.2 Microsoft Windows ______________________ o If the network connection is disconnected while the ServeRAID Manager Agent is running, the agent cannot communicate with the ServeRAID Manager console. As a result, the ServeRAID Manager will not report task status in the Event viewer. Reestablish network commmunication; then, restart the ServeRAID Manager agent and console. o The ServeRAID Manager is distorted and hard to read. The Java Virtual Machine has a problem with the 256-color palette. Set the Display Properties Settings to a color mode with greater than 256 colors. o If a channel on the LSI 1030 controller does not contain any SCSI devices, the controller will not appear in the ServeRAID Manager. o When you shut down Windows, you see the message "unexpected shutdown". Windows displays this message if the ServeRAID Manager Agent fails to exit within 3 seconds. It has no affect on file I/O or other system operations and can be ignored. 3.3 Novell NetWare ___________________ o When starting the NetWare operating system, the ServeRAID agent fails to start. A message "The ServeRAID agent failed to start" displays when starting the server. The server is unable to load the ServeRAID agent. This is usually caused by loading Java before the ServeRAID agent. In the file Autoexec.ncf, move the line "LOAD RAIDAGNT -BOOT" so that it is before any lines that reference Java. o Due to incompatible versions of the ServeRAID Manager NLMs, there can be only one ServeRAID agent running at a time. If the stand-alone version of the ServeRAID agent is running already, the IBM Director Extension ServeRAID sub-agent cannot be started successfully, and vice versa. 3.4 Linux __________ o If you cannot connect to a local or remote ServeRAID Manager installed on a Linux system, verify that the TCP/IP hosts file is configured properly. 1. Open the /etc/hosts file. NOTE: The following is an example: 127.0.0.1 localhost.localdomain localhost matrix 2. If the hostname of the system is identified on the line with 127.0.0.1, you must create a new host line. 3. Remove the hostname from the 127.0.0.1 line. NOTE: The following is an example: 127.0.0.1 localhost.localdomain localhost 4. On a new line, type the IP address of the system. 5. Using the Tab key, tab to the second column and enter the fully qualified hostname. 6. Using the Tab key, tab to the third column and enter the nickname for the system. 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. 7. Restart the server for changes to take effect. o On certain versions of Linux, you may see messages concerning font conversion errors. Font configuration under X-Windows is a known JVM problem. It does not affect the proper operation of the ServeRAID Manager software. To suppress these messages, add the following line to your .Xdefaults file: stringConversionWarnings: False o Some pop-up identification boxes include complete window frames when running the ServeRAID Manager in bootable-CD mode. These pop-ups may run off the side of the screen due to the extra width of the window frame. This is a known problem of the fvwm window manager on the CD. o On rare occasions, the online help system may generate a Java exception. This is due to a known problem in the HTML rendering section of JFC/Swing. 3.5 ServeRAID Manager running as a plug-in ___________________________________________ o A 'plug-in', as referred to in this file and the ServeRAID Manager online help, specifically refers to IBM Director. o If the server you are managing appears as a '?' icon in the ServeRAID Manager tree, the server might not have any ServeRAID controllers installed. Check the server configuration and restart the plug-in. 4.0 Web Sites and support phone number ______________________________________ o You can download new and updated files for the IBM ServeRAID products from the IBM Support Web site: http://www.ibm.com/support/us/en o For the latest list of supported operating systems, see the IBM Server Proven - SCSI and RAID Controllers Web site: http://www-03.ibm.com/servers/eserver/serverproven/compat/us/xseries/controllers/matrix.html For supported operating systems on legacy (non-shipping) controllers, see: http://www-03.ibm.com/servers/eserver/serverproven/compat/us/indexsp.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. 5.0 Trademarks and notices __________________________ IBM is a registered trademark of International Business Machines Corporation in the United States and other countries. Adaptec and HostRAID are trademarks or registered trademarks of Adaptec, Inc in the United States and other countries. Linux is a registered trademark of Linus Torvalds in the United States and other countries. Microsoft, Windows, Windows Server, and Windows Vista are trademarks or registered trademarks of Microsoft Corporation in the United States and other countries. Novell, NetWare, and SUSE are registered trademarks of Novell, Inc. in the United States and other countries. Red Hat and the Shadowman logo are registered trademarks of Red Hat, Inc. in the United States and other countries. Other company, product, and service names may be trademarks or service marks of others. 6.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. 7.0 Licensing _____________ (c) 1999, 2007 Adaptec, Inc. All Rights Reserved. This software contains the valuable trade secrets of Adaptec or its licensors. The software is protected under international copyright laws and treaties. This software may only be used in accordance with the terms of its accompanying license agreement. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, photocopying, recording or otherwise, without prior written consent of Adaptec, Inc., 691 South Milpitas Blvd., Milpitas, CA 95035.