*********************************************************************
*                         ServeRAID Manager                         *
*                            README.TXT                             *
*                           Version 8.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  OS/2 software levels
3.0  Troubleshooting tips
     3.1  General
     3.2  Microsoft Windows
     3.3  Novell NetWare
     3.4  Linux
     3.5  Solaris
     3.6  ServeRAID Manager running as a plug-in
4.0  Web Site and Support Phone Number
5.0  Trademarks and Notices
6.0  Disclaimer


1.0  Overview
_____________

  The ServeRAID Manager program is used to configure, administer, 
  and monitor IBM ServeRAID controllers, network-attached storage 
  enclosures, Adaptec HostRAID controllers, and integrated RAID 
  controllers, such as the LSI 1020/1030 and LSI SAS1064, that are
  installed locally or remotely in your IBM servers.
  
  1.1  New features in this release
  _________________________________
                 
    o  Support for native OS authentication on Windows, Linux,
       Unix, Netware, and Solaris10 (i386)*. With native authentication,
       you log into the ServeRAID Manager on local and remote systems 
       using your standard network user name and password.
       
       NOTE:  Native OS authentication replaces the Security Manager
              feature in the ServeRAID Manager agent. The Security 
              Manager is no longer a part of the agent console.
              
       *LSI 1030, LSI SAS1064 support only.
       
    o  Support for the following features on network storage
       devices (enclosures):
       
       NOTE:  These features require enclosure firmware  
              level 2.15 or greater.
              
       - Logical drive migration wizard for expanding or migrating
         arrays
         
       - Improved ROM update wizard, featuring a common user interface
         for direct-attached and network-attached storage devices
         
       - Network management tools for configuring network details and 
         Ethernet port settings
         
       - New right-click actions for direct access to configuration 
         wizard options: Configure access-control list, Configure 
         target information, Increase logical drive capacity
       
                       
  1.2  Supported operating systems
  ________________________________

  You can use the ServeRAID Manager program with the following
  operating systems:
     
    o  Microsoft Windows:
       
       + Windows 2000 Server/Advanced Server
       + Windows Server 2003 Workstation/Server/Enterprise Server         
       + Windows Server 2003 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* 
       + SuSE Linux Enterprise Server 9*
       + SuSE Linux Enterprise Server 9 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 i386(x86)
       
       
    *Out-of-box and current quarterly update or service pack
  

  Minimum System Requirements:  Intel Compatible 500 MHz processor
                                256 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-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  IBM TotalStorage DS300 storage enclosure
    o  IBM TotalStorage DS400 storage enclosure
    o  LSI-1030 integrated RAID controller
    o  LSI-1064 integrated RAID controller
    

2.0  Installation and setup notes
_________________________________

  o  Refer to the IBM ServeRAID Installation Guide (INSTALL.PDF) in 
     the /BOOKS directory on the "IBM ServeRAID Support" CD for 
     installation information.
       
  o  To install the ServeRAID Manager on Red Hat Enterprise Linux,
     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 the ServeRAID Manager on Sun Solaris10 (i386), you
     must preinstall the following packages from the installation CD's:
       
       - SUNWcslr Core Solaris Libraries (Root)
       - SUNWcsl Core Solaris, (Shared Libs)
       - SUNWlibmsr Math & Microtasking Libraries (Root)
       - SUNWgccruntime GCC Runtime libraries 
       
     In addition you must also install the LSI Logic drivers.
     
       - ITImpt LSI Logic FusionMPT(tm) drivers
       
     Installation steps:
     
       - 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
       
       - Use pkgadd command to install
       
            #pkgadd -d .
            
         NOTE: The '.' represents the current directory where the
               package was unpacked.
               
       - Follow the instructions given in the installer program.
	
  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.1  OS/2 software levels
  _________________________
    
    This ServeRAID release supports the following levels of code
    for OS/2 storage management and device driver software:
  
    - OS/2 device driver 7.00       
    - IPSSEND 7.00       
    - ServeRAID Manager 6.11
       
    Because the OS/2 device driver supports only the 7.00 level of
    code, you may see version mismatches in the ServeRAID Manager 
    RaidCfg.log file for BIOS, firmware, and device driver levels.  


3.0  Troubleshooting tips
_________________________

  3.1  General
  _________________
  
    o  The ServeRAID Manager will not start on a server that is using
       only 16 colors.

       The ServeRAID Manager supports a minimum of 256 colors.  You
       must switch the video mode from 16 colors to a mode with at
       least 256 colors.

    o  If the ServeRAID Manager console does not repaint correctly,
       select the View->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.
       
    o  With Linux kernel versions 2.4 and 2.6, the ARCCONF 
       DELETE <logical_drive> command may fail with a Kernel Oops 
       error message. Even though the drives are removed from the 
       ServeRAID Manager console, they may not really be deleted. 
       Reboot the controller; then, issue the ARCCONF DELETE command
       again.  
       
  3.5  Solaris
    __________
          
      o  If you cannot see installed controllers please run devfsadm -C
         to refresh the Solaris device tree.
         
      o  In case of LSI 1020/1030, the SRM GUI refresh time may be slightly
         higher than normal.
       
  
  3.6  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/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.


5.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.
  
  Sun is a trademark or registered trademark of Sun Microsystems, Inc.
  in the United States and other countries.
  
  Solaris is a trademark or registered trademark of Sun Microsystems, 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.

