This README file contains the latest information about IBM TotalStorage 
FAStT Storage Manager version 8.4 for x86 Linux.

Microsoft Windows Notepad will not view this readme properly, if you must view
this on a Windows system use Wordpad instead to view this readme.

Refer to the IBM TotalStorage Support Web Site or CD for the
installation and support guide.

For other related publications refer to Related Publications in the
installation and support guide.

Last Update:  08/11/2003


Products Supported: 

      ---------------------------------------------------
     |           | Machine Type |     Model              | 
     |-----------|--------------|------------------------|
     | FAStT 900 |     1742     | 90X , 90U              |
     |-----------|--------------|------------------------|
     | FAStT 600 |     1722     | 60U , 60X              |
     |-----------|--------------|------------------------|
     | FAStT 700 |     1742     | 1RX , 1RU              |
     |-----------|--------------|------------------------|
     | FAStT 500 |     3552     | 1RX , 1RU              |
     |-----------|--------------|------------------------|
     | FAStT 200 |     3542     | 1RX , 1RU ,2RX and 2RU |
      ---------------------------------------------------
      
Linux kernels Supported: 

   The following vendor kernels listed below have been tested and are 
   required for proper support.
 
 -------------------------------------------------------------------------------
| RedHat Advanced Server 2.1     |  2.4.9-e.16 UP, SMP, Enterprise(Bigmem)      |
|                                |             and Summit                       |    
|--------------------------------|----------------------------------------------|
| RedHat Linux 7.x               |  2.4.18-19.7.x UP, SMP and Enterprise(Bigmem)|
|--------------------------------|----------------------------------------------|
| RedHat Linux 8.0               |  2.4.18-27.8 UP, SMP, and Enterprise(Bigmem) |
|--------------------------------|----------------------------------------------|
| United Linux 1.0 with SP2a     |  2.4.19-333                                  |
| 32-bit (see note 1)            |                                              |
|--------------------------------|----------------------------------------------|
| United Linux 1.0               |  2.4.19 (The client code in this package will|
| IA-64 (see note 1)             |  only install and run on 32-bit linux)       |
|--------------------------------|----------------------------------------------|
| SuSE Professional 8.1          |  2.4.19                                      |
 -------------------------------------------------------------------------------

note 1 - United Linux support includes the following distributions:
          SuSE Linux Enterprise Server 8 (SLES 8)
          Turbolinux Enterprise Server 8 (TLES 8)
          Conectiva Linux Enterprise Edition Powered by United Linux     

CONTENTS
-----------------
1.0   Overview
2.0   Change History
3.0   Installation and Setup Instructions
4.0   Configuration Information
5.0   Unattended Mode
6.0   Web Sites and Support Phone Number
7.0   Trademarks and Notices
8.0   Disclaimer

=======================================================================

1.0   Overview
-------------------

1.1  Overview
-------------------

   This IBM Storage Manager release includes the IBM FAStT Storage
   Manager version 8.4 for Linux. 
   
   The linux directory contains the files necessary to install 
   the IBM FAStT Storage Manager Software version for Linux.
   The controller Firmware and NVSRAM files are located on the Windows
   CD in the Firmware and NVSRAM directories.

   The IBM FAStT Storage Manager version 8.4 Installation and Support
   Guide is also available on the IBM TotalStorage Disk Storage Systems
   Technical Support web site as a downloadable Portable Document Format
   (PDF) file. 
   
   The latest Firmware and NVSRAM files for IBM machine types 1722, 1742, 
   3542 and 3552 are available on IBM's Support Web Site.
   http://www.ibm.com/storage/techsup.htm

=======================================================================

1.2  Limitations
---------------------

1. In the Storage Manager 8.4 Client, Storage Partitioning must be
   enabled with the host type of 'linux' selected and the UTM must be
   removed from the 'Linux' storage partition. Otherwise the correct
   drive information is not presented to the Linux operating system.

2. When updating Firmware or NVSRAM with high disk activity a
   controller may become unresponsive during the update. IBM recommends
   that disk I/O be stopped during these code updates.

3. Upgrading FAStT500 with 512MB Cache. If you are upgrading controller
   firmware on a FAStT500 (machine type 3552) with 512MB of cache, you 
   will need to stop I/O and reboot the controller before upgrading 
   firmware followed by NVSRAM.

  To determine Storage Controller cache level, perform the following:

  a. On a storage management station start the client software and
     select a storage subsystem.
  b. Select Tools -> Manage Device to open the Subsystem Management
     Window.
  c. Highlight the Storage Subsystem that you are upgrading and then
     select Storage Subsystem -> Profile. It may take a little time for it
     to create the Storage Subsystem profile.
  d. Under the Controllers heading is an entry that displays
     information similar to the following example:

     Cache/processor size (MB):  256/32

   If this setting is listed as 512/32 you will need to arrange to
   perform this upgrade procedure at a time that you can stop I/O to
   the Storage Subsystem in order to ensure a successful firmware
   download and installation.

4. Storage Manager prompts you for a password if all hard disk
   drives are removed from the storage subsystem.

   After removing all drives from a storage subsystem (or not powering
   on drives and only the  controller), the IBM FAStT Storage Manager
   software will prompt you for a password when trying to start the
   software or trying to perform protected operations. Any password
   entered will fail.

   Password information is stored on a reserved area of each hard disk
   drive on the storage subsystem.  Each drive stores a mirrored copy
   of the password data.  When there are no drives in the storage
   subsystem, the storage management software does not find the
   password data when you attempt password protected operations. Add
   one drive to the storage subsystem and retry the operation.
   
   Since the RAID controller unit should not be powered on until the
   expansion units are attached and powered on, this should be done by
   powering off the RAID controller unit, properly attaching all
   expansion units (with drives installed), to the RAID controller unit
   and powering them on, and then powering the RAID controller unit
   back on.  At this point the storage subsystems can be re-discovered
   and managed using the IBM FAStT Storage Manager 8.3 software.

5. Display issues when using 256 color settings. A brownish hash
   pattern is displayed on the windows and in online help when running
   in 256 color mode.  Run the Storage Manager 8 application in a
   higher display mode.

6. The FAStT Storage Management dialog windows may be displayed
   cropped without the vertical and horizontal scroll bars. Just move
   the mouse pointer over the edge of the window until the mouse
   pointer change to window resize pointer, left click and hold to grip
   the window edge to resize it.

7. If you get "Error 21 - The Operation cannot complete because a
   ...  is in progress" error when you issue a Subsystem Management
   command from the IBM FAStT Storage Manager Client, the command may
   be cached. If the command is cached, the IBM FAStT Storage Manager
   Client will run the command as soon as the controller resources are
   available. Wait for at least ten minutes and check to see whether
   the command has been run. If not, re-attempt the command.

8. If the controller in the IBM FAStT Storage Server with firmware 
   05.3x.xx.xx is connected to a SAN with more than 64 host connections
   per controller port that can log into the controllers, one must 
   either use the switch zoning function or rearrange the SAN 
   connections so that only the maximum number of host connections can
   be seen and log into the controller. The FAStT Storage Subsystem 
   FAStT900, FAStT700 and FAStT500 (IBM machine type 1742 and 3552)
   have two ports per controller - one per minihub slot. The FAStT 
   Storage FAStT600 (IBM machine type 1722) has two ports per
   controller. The FAStT storage Subsystem FAStT200 (IBM machine type
   3542) has only one port per controller.  

9. If you define a large number of arrays, you will not be able to
   right-click a logical drive and get a pop-up menu in the Physical
   View of the Subsystem management window. You must use the Logical
   Drive pull-down menu to select the logical drive options.

10. The IBM FAStT Storage Server hardware and software is designed
    to have redundant paths from the host system to ensure the
    availability of storage. However, it is possible to connect a single
    host adapter from the host system to one of the controller minihubs
    and then connect this minihub to the minihub of the other
    controller. This configuration will create a FC-AL loop between the
    host adapter and the two IBM FAStT Storage Server controllers and no
    redundant path to the host system. When you connect the two minihubs
    together, always connect the "IN" port of one minihub to the "OUT"
    port of the other minihub or vice versa. Do not connect the "IN"
    port of one to the "IN" port of the other minihub or the "OUT" port
    of one minihub to the "OUT" port of the other minihub.

11. When creating a Remote Mirror of a base volume the following 
    restriction applies. First, you have created a snapshot of a base 
    volume and the base volume is receiving I/O. Second, you decide to 
    create a mirror relationship, using the base volume as the primary 
    volume in the mirrored pair. As you create the mirror relationship, 
    the snapshot volume is failed. The workaround is to quiesce I/O to 
    the base volume while you are creating the mirror relationship. 
    Alternatively, if the mirror relationship is created before creating 
    the snapshot volume, this will not happen.
 
12. When using a 64-bit Linux system the FAStT Storage must be managed from
    a 32-bit system using the out-of-band management method.  
    

=======================================================================

1.3  Enhancements
---------------------------
     N/A

=======================================================================

1.5  Dependencies
--------------------------

   IBM FAStT Storage Manager version 8.4 provides full management support
   IBM machine types 3552 and 3542 storage subsystems that have at least
   firmware version 04.00.02.xx, IBM machine type 1742 (models 1RX, 1RU)
   storage subsystem that have at least firmware version 05.00.04.xx or
   IBM machine type 1742 (models 90X, 90U) and 1722 storage subsystems
   that have at least firmware version 05.3x.xx.xx.
    
   The only IBM FAStT Storage Manager 8.3 supported management function 
   on controllers with firmware version 04.xx.xx.xx to 04.xx.01.xx is 
   controller firmware and NVSRAM download. 

=======================================================================

2.0   Change History
-----------------------------

This is the latest release of IBM FAStT Storage Manager version 8.4 for
Linux.

=======================================================================

2.1 Key Features added to IBM FAStT Storage Manager 8.4 with controller 
    firmware level 05.4x.xx.xx.
-----------------------------------------------------------------------------------

     See the IBM TotalStorage FAStT Storage Manager Version 8.4 Installation 
     and Support Guide for Intel-based Operating System Environments.
    
=======================================================================

2.2 Code levels at time of release are as follows
------------------------------------------------------------------

     1. IBM FAStT Storage Manager Client version:

         SMclient-LINUX-08.40.G5.00-1.i386.rpm

     2. IBM FAStT Storage Manager Runtime version:

         SMruntime-08.40.A5.00-1.i386.rpm

     3. IBM FAStT Storage Manager Utilities version:

         SMutil-08.40.A5.00-1.i386.rpm


   Refer to the http://ssddom02.storage.ibm.com/techsup/webnav.nsf/support/disk
   IBM TotalStorage Disk Storage Systems Technical Support web site for the 
   latest released code levels.

=======================================================================

3.0   Installation and Setup Instructions
----------------------------------------------------

3.1  Step-by-step instructions for this code update are as follows
-----------------------------------------------------------------------------------------

1. Install and update the driver for the IBM FAStT Host Adapter.

   a. Install the hardware by using the instructions that come with the
      adapter.
   b. Install the IBM FAStT Host Adapter driver by using the
      instructions provided in the readme file located in the
      Host_Adapter directory on the installation CD or downloaded 
      with the device driver source package from the IBM support website. 

2. Install the new Storage Manager version 8.4 software. Refer to the IBM 
   TotalStorage FAStT Storage Manager Version 8.4 Installation and Support 
   Guide for Intel-based Operating System Environments for detailed 
   installation instructions.

=======================================================================

3.2 Refer to the Host_Adapter directory on the installation CD for
    the applicable drivers or refer to the IBM Support Web Site for the
    latest supported host adapters, device drivers, and updated readme.

    At this time, the supported drivers are as follows:

    1. IBM FAStT Host Adapter device driver version 6.06.00-fo for Linux
    2. IBM FAStT FC-2 and FC2-133 Host Bus Adapter device driver 
       version 6.06.00-fo for Linux
    3. IBM FAStT_MSJ 2.0 release 42

=======================================================================

3.3  Helpful Hints
-----------------------

1. If you are unable to see the maximum number of drives during
   Automatic Configuration, you should be able to use Manual
   Configuration to select individual drives and select the maximum
   number of drives allowed.

2. Depending on the storage subsystem that you have purchased, you
   may have to purchase the FAST storage partitioning premium feature
   option or an option to upgrade the number of supported partitions
   in a storage subsystem. Please see IBM Marketing representatives
   or IBM resellers for more information.
   
   - IBM FAStT600 storage subsystem (machine type 1722): The standard
     configuration does not have the FAST storage partitioning premium
     feature enabled. Four partition, eight partition and an upgrade from 
     four to eight partition storage partitioning premium feature options 
     can be purchased.

   - IBM FAStT200, FAStT500, and FAStT700 storage subsystems (machine
     type 3542, 3552 and 1742 - models 1RU and 1RX, respectively): The 
     standard configuration has 64 partitions storage partitioning 
     premium option installed. No additional storage partitioning 
     premium feature options can be purchased for these storage
     subsystems.

   - IBM FAStT900 storage subsystem (machine type 1742 - models 90X and
     90U): The standard configuration has 16 partition storage partitioning
     premium option installed. An upgrade from 16 to 64 partition storage
     partitioning premium feature option can be purchased.
   
=======================================================================

4.0 Configuration Information
----------------------------------------


4.1 Configuration Settings
------------------------------------

1. By default, the IBM FAStT Storage Manager 8.4 firmware does not 
   automatically map logical drives when the IBM FAStT storage 
   partitioning premium feature is enabled. This means that the logical 
   drives after being created are not automatically presented to the host
   systems.

   a. For a new installation, after creating new arrays and logical drives,
      if your host OS type is any of the supported version of Linux OS's, 
      create a partition with the host type of Linux and map the logical
      drives to this partition.
      
   b. If you are upgrading with Storage Partitions and the host system OS
      was other than Microsoft Windows NT is accessing the default host
      group, you will need to change the default host type. After upgrading,
      the default host type is reset to Windows non-clustered (SP5 or 
      higher).

   Refer to the IBM FAStT Storage Manager online help to learn more
   about creating storage partitions and changing host types.


2. When you are configuring IBM machine type 1722, 1742, 3542, or 3552 
   storage controllers as boot devices, contact IBM support for supported
   configurations and instructions for configuring IBM storage controllers
   as boot devices.
   
   
3. When you are configuring IBM machine type 1742 or 3552 storage controllers
   in clustered Remote Mirror configurations, contact IBM support for 
   supported cluster configurations and instructions for configuring IBM 
   storage controllers in clustered Remote Mirror configurations.
 
=======================================================================

4.2 Hardware status and information
--------------------------------------------------

   New installations for IBM Machine types 1722, 1742, 3542,and 3552 should
   be installed with the IBM FAStT Host Adapter and Device Driver version
   6.06.00-fo.
   
   For more information, refer to the IBM TotalStorage Disk Storage 
   Systems Technical Support web site.

=======================================================================

4.3 Unsupported configurations
--------------------------------------------

   The following lists configurations that are currently not being
   supported with IBM FAStT Storage Manager 8.4.

1. Fibre Channel loop environments with the IBM Fibre Channel Hub,
   machine type 3523 and 3534, in conjunction with the IBM Fibre
   Channel Switch, machine types 2109-S16, 2109-F16 or 2109-S8. In this
   configuration, the hub is connected between the switch and the IBM
   Fibre Channel RAID Controllers.

2. The IBM Fibre Channel Hub, machine type 3523, connected to IBM
   machine type 1722, 1742, 3542 and 3552.

=======================================================================

5.0   Unattended Mode
-------------------------------
        N/A

=======================================================================

6.0   WEB Sites and Support Phone Number
--------------------------------------------------------------

   6.1  IBM TotalStorage Disk Storage Systems Technical Support web site:
        http://ssddom02.storage.ibm.com/techsup/webnav.nsf/support/disk

   6.2  IBM TotalStorage Marketing Web Site:
        http://www.storage.ibm.com/hardsoft/disk/fastt/index.html

   6.3  If you have any questions about this update, or problem
        applying the update go to the following HelpCenter World
        Telephone Numbers URL:
        http://www.ibm.com/planetwide

=======================================================================

7.0   Trademarks and Notices
-----------------------------------------

7.1 The following terms are trademarks of the IBM Corporation in the
    United States or other countries or both:

     IBM

     TotalStorage 
     
     the e-business logo

     xSeries
     
     pSeries

     HelpCenter
     
     Linux is a registered trademark of Linus Torvalds.

     Microsoft, Windows, and Windows NT are trademarks of Microsoft
     Corporation in the United States, other countries, or both.

     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.

     UNIX is a registered trademark of The Open Group in the United
     States and other countries.

     Other company, product, and service names may be
     trademarks or service marks of others.

=======================================================================

8.0   Disclaimer
----------------------

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


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