*********************************************************************
*                         ServeRAID Manager                         *
*                            README.TXT                             *
*                           Version 4.20                            *
*********************************************************************

CONTENTS
________

1.0  Overview
2.0  Installation and setup notes
3.0  Troubleshooting tips
     3.1  SCO UnixWare
     3.2  Novell NetWare
     3.3  Red Hat Linux
     3.4  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 Netfinity servers.
  
  You can use the ServeRAID Manager program with the following
  operating systems:

  o  Microsoft Windows NT, Windows 2000, Windows 98, and Windows 95
     NOTE: On Windows 98 and Windows 95, you can monitor remote 
           systems only.
  o  IBM OS/2 Warp Server
  o  Novell NetWare 5.x
  o  SCO OpenServer 5.0.X
  o  SCO UnixWare 7.x
  o  Red Hat Linux 6.2

  Minimum System Requirements:  Intel Compatible 200 MHz processor
                                64 MB RAM
                                20 MB hard disk drive space


2.0  Installation and setup notes
_________________________________

  o  To install the ServeRAID Manager, refer to the README.TXT for
     the specific operating system you are using.

  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 
     Main 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 Main 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 Main 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  SCO UnixWare
  _________________
  
    o  The Back button in the online help does not always work.
   
       There is an intermittent problem when using the Back button in
       the online help.  In certain cases, you must press the Back 
       button two times to return to the previous page.

    o  SCO UnixWare 7.01 shows the time in the Event Viewer as PST.
   
    o  Images (such as .GIFs) might not display when using the DISPLAY 
       environment variable to display the application on a remote X
       platform.

  3.2  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 Netfinity Director Extension ServeRAID sub-agent
       cannot be started successfully, and vice versa. 
     
  3.3  Red Hat 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.
           
  
  3.4  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 Netfinity
       Director.
    
    o  If the server you are managing appears as a '?' icon in the 
       ServeRAID Manager Main 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.

