*********************************************************************
*                         ServeRAID Manager                         *
*                            README.TXT                             *
*                           Version 6.00                            *
*********************************************************************

CONTENTS
________

1.0  Overview
2.0  Installation and setup notes
3.0  Troubleshooting tips
     3.1  General
     3.2  Microsoft Windows
     3.3  Caldera Open UNIX and Caldera UnixWare
     3.4  SCO OpenServer
     3.5  Novell NetWare
     3.6  Linux
     3.7  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 that are installed locally or
  remotely in your IBM servers.
  
  You can use the ServeRAID Manager program with the following
  operating systems:

  o  Microsoft Windows NT 4.0, Windows 2000, Windows XP Professional,
     Windows .NET, and Windows ME.
     NOTE: On Windows ME, you can monitor remote systems only.
  o  IBM OS/2 Warp Server for e-business
  o  Novell NetWare 5.1 and NetWare 6.0
  o  SCO OpenServer 5.0.6a
  o  SCO UnixWare 7.1.1
  o  SCO Open UNIX 8.0.0
  o  Red Hat Linux 7.2 and 7.3
  o  SuSE Linux 7.3 and 8.0
  o  Caldera Linux 3.1.1
  o  Turbolinux 7.0

  Minimum System Requirements:  Intel Compatible 200 MHz processor
                                128 MB RAM
                                35 MB hard disk drive space
                                256 color video mode


2.0  Installation and setup notes
_________________________________

  o  Refer to the IBM ServeRAID User's Reference (SRAID.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.
                       
     * RaidSec.LOG  - Contains the information reported in the
                      Security 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 200,000 bytes, 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, notification list, security list, and
     SNMP traps 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.  Open the Security Manager. Using the 'Add user' action, 
         define the security list.

     5.  Exit the ServeRAID Manager.

     6.  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
         RaidSLst.ser --> to replicate the security list
         RaidSNMP.ser --> to replicate the SNMP trap destination list

     7.  Install the ServeRAID Manager on the other servers.

     8.  Copy the files from the diskette into the directory where
         the ServeRAID Manager is installed on the other servers.

  o  The ServeRAID Manager can monitor status information returned
     from certain enclosures.  If there are any problems, information 
     such as fan status, power supply status, and temperature status 
     is collected and reported in the event viewer.

     To monitor an enclosure, do the following:

     1.  Write down the description displayed in the 'Product or
         Model Number' field of the enclosure device information
         panel.
    
     2.  Exit the ServeRAID Manager.

     3.  Using a text editor, open the RaidDev.pps file.  This file
         is in the directory where the ServeRAID Manager is
         installed.

     4.  Using the enclosure description from step 1, add a line to 
         the file.  For example, if the description is 3520EX10, add 
         the following:
    
         3520EX10=true
    
     5.  Save and close the file.

     6.  Restart the ServeRAID Manager.


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.

  
  3.2  Microsoft Windows
  ______________________
  
    o  The ServeRAID Manager is distorted and hard to read.
    
       The Java Virtual Machine version 1.3 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 may 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  SCO Open UNIX and SCO UnixWare
  ___________________________________________
  
    o  Miscellaneous problems occur when the <NumLock> key is enabled.
       Turn off the <NumLock> key.
       
    o  Images (such as .GIFs) might not display when using the
       DISPLAY environment variable to display the application on a
       remote X platform.

  
  3.4  SCO OpenServer
  ___________________
  
    o  Unable to navigate using the mouse while the <NumLock> key is
       enabled.

       Turn off the <NumLock> key or see SCO Technical Article number
       108877 at  www.sco.com  for instructions on how to clear the
       <NumLock> key modifier.
   
  
  3.5  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.6  Linux
  __________
  
    o  If you cannot connect to a 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  Some pop-up identification boxes include complete window frames   
       when running the ServeRAID Manager in startable-CD (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.7  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 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.


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, 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.


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.

