*********************************************************************
*                   IBM ServeRAID Linux Update                      *
*                            README.TXT                             *
*                           Version 6.00                            *
*********************************************************************


CONTENTS
________

1.0  Overview
2.0  Change history
     2.1  ServeRAID Family 5.11 to 6.00
     2.2  ServeRAID Family 5.10 to 5.11
     2.3  ServeRAID Family 4.84 to 5.10
     2.4  ServeRAID Family 4.80 to 4.84
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 IPSSEND command-line programs
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-6M Ultra320 SCSI controller,
        IBM ServeRAID-5i Ultra320 SCSI controller, IBM ServeRAID-4H
        Ultra160 SCSI controller, IBM ServeRAID-4M Ultra160
        SCSI controller, IBM ServeRAID-4Mx Ultra160 SCSI
        controller, IBM ServeRAID-4L Ultra160 SCSI controller, and
        IBM ServeRAID-4Lx Ultra160 SCSI controller (hereafter
        referred to as IBM ServeRAID-4 Ultra160 SCSI controllers). 

  Follow each step in this README to ensure that your ServeRAID
  controllers have the latest software levels.

  The ServeRAID 6.00 release of code contains the following levels
  of firmware:
  
    o  Firmware level 6.00 for the ServeRAID-6M Ultra320 SCSI
       Controllers
      
    o  Firmware level 6.00 for the ServeRAID-5i Ultra320 SCSI
       Controllers
    
    o  Firmware level 6.00 for the ServeRAID-4 Ultra160 SCSI
       Controllers

    o  Firmware level 5.11 for the ServeRAID-3H/3HB Ultra2 SCSI
       Controller and the ServeRAID-3L Ultra2 SCSI Controller

    o  Firmware level 2.88 for the ServeRAID-II Ultra SCSI Controller

    o  Firmware level 2.88 for the integrated ServeRAID Controller
       on the IBM PC Server 330 and IBM Netfinity 5500 system boards

    o  Firmware Level 2.25 for the ServeRAID Adapter
            

  Creating logical drives 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 came 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 5.11 to 6.00
  __________________________________

    o  Support for the new IBM ServeRAID-6M Ultra320 SCSI controller.

    o  Support for new operating systems:
    
       + Microsoft Windows .NET Enterprise Server, Datacenter, and Server
       + Microsoft Windows .NET Enterprise Server 2003 64-Bit Edition
       + SuSE Linux 8.0 64-Bit Edition
       + Red Hat Linux 8.0
       
    o  Support for SCO UnixWare (formerly Caldera UnixWare)  
       and SCO Open Unix (formerly Caldera Open Unix)
 
    o  Enhanced functionality in the ServeRAID Manager:
    
       - New Email Notification Manager in the ServeRAID Manager 
         Agent notifies users about system events.
         
       - Ability to initialize logical drives during Express or
         Custom configuration. This option no longer appears on
         the Preferences menu.
         
       - Ability to log warning and fatal events to the operating
         system event log on Windows and Unix systems. Use the
         ServeRAID Manager Agent to enable/disable event logging.

       - Simplified process for creating spanned arrays.

       - Reorganized some Action menu options for easier access to  
         ServeRAID Manager functions.

    o  New 2 terabyte limit for logical drives.

    o  Support for RAID Level-5EE logical drives on ServeRAID-6M, 
       ServerRAID-4L, ServerRAID-4Lx, ServeRAID-4M, and ServeRAID-4Mx 
       controllers.
           
    o  (For Windows NT and Windows 2000 only) The failover device driver
       can no longer be used for installation. You must install the
       regular Windows device driver first; then, update using the
       failover driver.
           
    o  Fixed a problem with OS/2, which caused data corruption on
       shut down. To fix the problem, the new OS/2 driver implements   
       a two-pass shutdown procedure. The first pass issues a firmware 
       flush cache command. The second pass waits eight seconds for    
       the firmware to complete the flush; then, shut down resumes.
       
    o  Fixed a problem with the SCO OpenServer device driver, which 
       sometimes caused a controller reset. This problem occured   
       when the driver detected a bad command ID from ips bcopy.      
      
    o  Fixed a problem during failover and server restart which caused 
       clustered drives to be marked defunct.
       

  2.2  ServeRAID Family 5.10 to 5.11
  __________________________________

    o  Fixed a cache flushing problem in the ServeRAID-3H/3HB
       controller.  This problem could occur when: (1) the array
       includes a RAID level-5 logical drive running in WB mode;
       (2) a drive goes defunct during an active flush to that drive
       and then (3) an adapter is reset after another flush command
       is sent to the same sector on that drive. This fix was
       implemented in firmware to help increase data reliability.
    
    o  Fixed an intermittent system hang which can occur during a PCI
       bus scan when a ServeRAID 4M, 4L, 4Mx, or 4Lx is installed in
       slots 4, 5, and/or 6 of the x345 system.
            

  2.3  ServeRAID Family 4.84 to 5.10
  __________________________________
    
    o  Support for the new IBM ServeRAID-5i Ultra320 SCSI controller.

    o  Support for new operating systems:
    
       + OpenLinux 3.1.1
       + Red Hat Linux 7.2 and 7.3
       + SuSE Linux 7.3 and 8.0
    
    o  New event mechanism to alert user when version numbers do not
       match in BIOS, firmware, and device drivers.
    
    o  New audible alarm in ServeRAID Manager agent when critical and
       fatal events occur.    
    
    o  Fixed a problem with the ServeRAID Manager "Send test trap"
       function.  Certain management programs such as Tivoli Netview
       did not recognize the test trap.

    o  Fixed a problem with the ServeRAID Manager configuration wizard
       when creating large arrays near 1 Terabyte or greater in size.
       The large arrays caused the ServeRAID Manager configuration
       wizard to display the wrong logical drive size.

    o  Fixed a problem in UnixWare/Open UNIX device driver of not
       handling 64 bit DMA requests from the OS when greater than 4GB
       memory addressing is activated.
       
    o  (For Windows NT and Windows 2000 only, ServeRAID-3 family only)
       Fixed 'Event ID 11' condition in critical RAID-level 5 logical 
       drives.           
              
    o  (For Windows NT and Windows 2000 only) Fixed resource 
       constraints under heavy workloads (Event ID 11).
       
    o  Reduced excessive error logging in critical RAID-level 1 logical
       drives.
        
  
  2.4  ServeRAID Family 4.80 to 4.84
  __________________________________

    o  (For Windows NT and Windows 2000 only)  Fixed delay condition
       known to cause the ServeRAID driver or other hardware to
       timeout (Event ID 11).  
    
    o  (For Windows NT only)  Many causes of blue screens can lead to
       data corruption.  In rare circumstances, if a blue screen occurs
       while a RAID level-5 configuration has one defunct physical
       drive, data corruption might occur. To reduce the risk of data
       corruption in this scenario, the ServeRAID Windows NT device
       driver now delays after a blue screen occurs before resetting
       the ServeRAID controller.

       Additionally, a fix was implemented for the rare occurrence of
       data corruption when all of the following conditions are met:

       - A ServeRAID-3HB controller is installed with the 4.70 or 4.80
         firmware and device driver.
      
       - Four or more hard disk drives are in the array.
    
       - One or more of the hard disk drives in the array are 17 GB, 
         or larger.
    
       - The array includes a RAID level-5 logical drive.
    
       - The server is turned off without shutting down the operating
         system, or a blue screen occurs. 

    o  Fixed system hangs or error messages that might occur during
       tape backup operations or other single-threaded operations
       because of ServeRAID command time-outs. This problem was
       observed specifically on SCO OpenServer ("Unrecovered read
       error" messages are displayed on the OpenServer console).

    o  (For e-Server xSeries 360) When using the "IBM ServeRAID 4.80
       BIOS and Firmware Update (1 of 2)" diskette on a ServeRAID-4H
       controller, fixed occurrences when the firmware update did not
       complete successfully and the server would restart.

    o  The performance on some applications has been improved when
       using write-back mode on a RAID level-5 logical drive that has
       a defunct physical drive.
    
  
3.0  Installation and setup instructions
________________________________________

  NOTE:  If your operating system is already installed on a
         ServeRAID controller, update the ServeRAID device driver
         before updating the BIOS and firmware.  Refer to the IBM
         ServeRAID Device Driver Installation Instructions
         (DEVDRV.PDF) in the /BOOKS directory on the "IBM
         ServeRAID Support" CD.
  
  3.1  Updating the BIOS and firmware
  ___________________________________

    NOTES:

      o  The ServeRAID-6M, ServeRAID-5i, and ServeRAID-4 controllers 
         do not support SCSI CD-ROM drives.

      o  To install a ServeRAID-6M, ServeRAID-5i, or a ServeRAID-4 
         controller in a server with one or more existing ServeRAID 
         controllers, do the following:

         *  Update the BIOS and firmware on the existing controllers
            using the ServeRAID 6.00 software.
         *  Install the new controller in the server.

    1.  Insert the "IBM ServeRAID Support" CD into the CD-ROM drive
        or insert the "IBM ServeRAID BIOS and Firmware Update (1 of
        4)" diskette into the diskette drive; then, turn on the
        server.

        NOTE:  When starting the "IBM ServeRAID Support" CD in
               startable (bootable) CD mode, the ServeRAID ROM Update
               Wizard might hang if the ServeRAID BIOS level is 3.50
               or earlier.  To prevent this potential problem,
               update the ServeRAID BIOS and firmware with the "IBM
               ServeRAID BIOS and Firmware Update (1 of 4)" diskette.

    2.  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, the ServeRAID Manager will start.  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.
         
      o  To install device drivers for Caldera OpenLinux 3.1.1 on a 
         ServeRAID-6M controller, you must obtain special diskette 
         images from Caldera; you cannot use the diskette images on 
         the "IBM ServeRAID Support" CD. To obtain the diskette 
         images and installation instructions, go to the Caldera web
         site at http://support.caldera.com/caldera/; then, search the
         knowledge base for "ServeRaid 6M".

    Install the ServeRAID device drivers that are provided with the
    IBM ServeRAID controllers on the "IBM ServeRAID Support" CD.  
    Refer to the IBM ServeRAID Device Driver Installation
    Instructions (DEVDRV.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 Support" CD or
    from 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 more installation information.

    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/<imagefilename>.rpm

          where /tmp is the directory used for the download in step 1
          and <imagefilename> is the name of the file that was
          downloaded from the Web.

      3.  Press Enter.

  
  3.5  Installing the IPSSEND command-line program
  ________________________________________________

    Install the ServeRAID IPSSEND command-line program that is
    provided with the IBM ServeRAID controllers on the "IBM ServeRAID
    Support" CD or from 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 more installation
    information.


4.0 Troubleshooting tips
________________________

  4.1  General
  ____________

  o  In a rare occurrence among ServeRAID-4 controllers, the NVRAM on
     the ServeRAID controller will not contain a valid configuration.
     The "IBM ServeRAID Support" CD will display a window indicating 
     that the program cannot communicate with the controller.
		
     Use the Mini-Configuration program to restore the controller
     settings to the factory-default settings.  Refer to the "IBM
     ServeRAID User's Reference" for information on using the
     Mini-Configuration program.
  
  o  If you rebuild the Linux kernel, the SCSI-generic support must
     be included or the ServeRAID Manager program and the IPSSEND
     command-line 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 <RETURN> to see video modes available,
        <SPACE> 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:
     
     o  The Caps Lock or Scroll Lock is set.
     o  The Shift or Alt keys are held.  
     
     Press <Enter> 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  If you experience problems with SCSI CD-ROM drives connected to
     a ServeRAID-6M, ServeRAID-5i, or ServeRAID-4 controller, 
     do one of the following:
   
     o   Use a ServeRAID-3HB or ServeRAID-3L controller instead.
     o   Install an IDE CD-ROM drive in your server.

     The ServeRAID-6M, ServeRAID-5i, and ServeRAID-4 controllers do 
     not support SCSI CD-ROM drives.

  o  If you are installing a ServeRAID-4 controller into a server
     with one or more existing ServeRAID controllers, and the
     server fails to start and displays POST code EF10, do the
     following:

     1.  Remove the ServeRAID-4 controller from the server.
     2.  Update the BIOS and firmware on the existing controllers
         using the ServeRAID 6.00 software.
     3.  Install the ServeRAID-4 controller in the server.

  o  If you are running DOS applications in protected mode, you must
     add the following lines to the CONFIG.SYS:

     device=x:\himem.sys
     device=x:\emm386.exe NOEMS
     
     where x is the drive where DOS is installed. 

  o  On a Netfinity server, if your operating system fails to start
     three times consecutively, the system BIOS will turn off the
     processor cache.  When this happens the "IBM ServeRAID Support"
     CD behaves unexpectedly.  To correct this problem, enter the
     system BIOS and re-enable the processor cache (or load the
     default settings). Refer to your system documentation for
     instructions on entering the system BIOS.

  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  If you previously installed version 1.00 of the ServeRAID Linux
     device driver on a kernel without ServeRAID support (stable
     kernels prior to 2.2.13 and development kernels prior to 2.3.16),
     you must start with a fresh set of kernel sources before 
     applying the ServeRAID Linux device driver version 5.11.

  o  The Caps Lock key is disabled when using the ServeRAID Manager
     program in startable-CD (bootable-CD) mode.


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


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


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.