
Readme File for the IBM FAStT Management Suite Java (MSJ) for
Linux.
                             
This README file contains the latest information about installing
IBM FAStT MSJ for Linux.

Important:  Please refer to section 9.0 for the limitations in this version
of FAStT MSJ.

Refer to the IBM Support Website for the latest information and
updated README file.

Last update: 06/09/2003

CONTENTS
--------
This readme file includes the following information:

1.0   Overview
2.0   Change History
3.0   Components 
4.0   Configuration
5.0   Requirements
6.0   Downloading and installing FAStT MSJ 
7.0   Executing FAStT MSJ
8.0   Uninstalling FAStT MSJ
9.0   Limitations
10.0  Web Sites and Support Phone number
11.0  Trademarks and Notices
12.0  Disclaimer

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

1.0 OVERVIEW
------------

IBM FAStT MSJ supports the following HBA's:
 
 -----------------------------------------------------------------------------
| FAStT Adapter      | Qlogic Adapter     | IBM Feature Code | IBM Option P/N |
 ------------------------------------------------------------------------------
|FAStT Host Adapter  | QLA2200F/66-IBM-SP |    FC2102        |    00N6881     |
|FAStT FC2           | QLA2310FL-IBM-SP	  |    FC2130	     |    19K1246     |
|FAStT FC2-133       | QLA2340-IBM-SP	  |    FC2104	     |    24P0960     |
|FAStT FC2-133 2-port| QLA2342-IBM-SP	  |                  |    24P8053     |
 -----------------------------------------------------------------------------

Some of the features include:
· Timely and accurate detection of I/O failures
· Local and remote management of adapters
· Device \ Port Configuration for fail-over capability (Linux)
· Performance statistics
· Central control point in a network environment
· Diagnostics & utilities

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

2.0 CHANGE HISTORY
------------------

08/21/2001: Initial release version 2.0
11/05/2001: Release of version 2.0 rls 15
            Updated Linux agent and fixed
            miscellaneous problems in the GUI
03/06/2002: Release of version 2.0 rls 32
            1) Fixed slow diagnostic performance
            2) Corrects the reporting of device
               target,ID and Port ID values.
            3) Fixed Stop on error when in Loopback test
            4) Fixes erroneous reporting of device failure when a 
               another device fails
            6) Miscellaneous client fixes.
06/24/2002: Release of version 2.0 rls 33
            1) Added supported drivers NT 8.1.5.60, Linux 6.0, 
               and Netware 6.50q to local.properties file.
            2) Fixed API issue with FC tape 
               (incorrect bus direction set).
02/21/2003: Release of version 2.0 rls 38
            - Added supported drivers WIN32 8.1.5.62, Linux 6.04.00
              and NetWare 6.50r to local.properties file.             
03/21/2003: Release of 2.0 rls 40 
                          
===================================================================

3.0 COMPONENTS
--------------

IBM FAStT MSJ consists of the following components.

· IBM FAStT MSJ Application: 

This is a Java based GUI application that runs on any
Linux system network-connected to the servers and
that manages the Host Bus adapters on those servers.

· IBM FAStT MSJ Agent: 

This software is required on systems where the Host Bus adapters
reside.

. Wrap Connector and Coupler

The IBM FAStT Host Bus Adapters (2200 and above) support Full
Duplex mode which enables loop back capability. To assist you in
isolating 2200 HBA loop problems, a wrap connector/coupler assembly
P/N 75G2725 can be obtained from Mechanicsburg or by contacting
IBM Level 2 Support.
For the 23x0 a wrap plug P/N 11P3847 and coupler P/N 05N6766 are included
in the FAStT 700 Storage Server carton. You can also obtain them from
Mechanicsburg as a kit (P/N 24P0950).

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

4.0 CONFIGURATION
-----------------

The configurations that FAStT MSJ supports can be divided 
into two types: Stand-alone and Networked.

4.1 STAND-ALONE
---------------

If you will manage the Host Bus adapter installed in a stand-alone
system, install the FAStT MSJ GUI and FAStT MSJ Linux Agent on that
system

4.2 NETWORKED
-------------

If you will manage the Host Bus adapter residing in a remote system
in a Linux environment, install the FAStT MSJ GUI on a management
system. In this case, only the FAStT MSJ Linux agent needs to be
installed in the remote system.

Note that a management system may contain HBAs and therefore the
agent should also be installed on that system.

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

5.0  REQUIREMENTS
-----------------

5.1  HARDWARE REQUIREMENTS
--------------------------
  
· IBM FAStT Fibre Channel HBAs (2200, 2310 or 2340)
· Single or Multi-processor Server or Workstation.
· Pentium III 450MHz MHz or better,128MB RAM,and a minimum 30MB
  disk space.

5.2  SOFTWARE REQUIREMENTS FOR Linux OS
---------------------------------------

· Linux 
· Must have "root" privileges
· HBA Miniport Driver: 6.0
· TCP/IP Protocol
· Must have Administrative Privileges to perform management
  functions(NVRAM modification).

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

6.0. INSTALLING FAStT MSJ
-------------------------

If you have downloaded the FAStT MSJ package from the IBM Support
web site, skip to Web Download section below.

6.1 CD Installation
-------------------

The following files are located in the FAStT_MSJ folder in the CD.

Linux

   · README.txt (this file)
       Note: The README file that is on this CD takes precedence
       over the one that is displayed and installed when FAStT MSJ
       setup is run. 
   · FAStTMSJ_install.bin (the install file for FAStT MSJ Linux)
   · The FAStT MSJ User's guide 	
         
6.2 WEB Download
----------------

The package includes the following:

   · README.txt (the Readme file for FAStT MSJ)
	Note: The README file that is part of this self extracting
        file takes precedence over the one that is displayed and
        installed when FAStT MSJ setup is run. 
   · FAStTMSJ_install_rel33.bin (the install file for FAStT MSJ Linux)
   · The FAStT MSJ User's guide 

6.3 Installation
----------------

The FAStTMSJ_install_rel33.bin installs the FAStT MSJ Application.
Depending on your requirements, not all components may be
installed.

Important: If FAStT MSJ is already installed, un-install it prior
to installing a new copy.

GUI Installation: 

  1. Open a shell and change to the directory that contains the
     FAStT MSJ installer.
  2. At the prompt , type: sh FAStTMSJ_install.bin 
  3. At the "Choose Product Features" screen, select the desired
     installation: GUI and Linux Agent
                   GUI
                   Linux Agent
                  
     You may also choose to customize your installation by clicking
     on the "Customize" button.
  4. FAStT installs in the /opt directory. The launch script is located
     in the /usr directory.
     
Note: The command line installation proceedure is not currently supported with 
      the IA-64 FAStTMSJ package. 
      
Command Line Installation of FAStT MSJ and the qlremote agent: 

  1. Open a shell and change to the directory that contains the
     FAStT MSJ installer.
  2. At the prompt , type: sh FAStTMSJ_install.bin -i silent 
  3. FAStT installs in the /opt directory. The launch script is located
     in the /usr directory.

Command Line Installation of only the qlremote agent: 

  1. Open a shell and change to the directory that contains the
     FAStT MSJ installer.
  2. At the prompt , type: sh FAStTMSJ_install.bin -i silent -DCHOSEN_INSTALL_SET="QMSJ_LA" 
  3. FAStT installs in the /opt directory. The launch script is located
     in the /usr directory.


===================================================================
      
7.0  RUNNING FAStT MSJ
----------------------

Once the application has been installed,launch it.

Note: The default FAStT MSJ password is "config". Make sure you 
change this password after installation to ensure that security 
is not compromised. To enter a new Password you must have
Administrative Privileges. You cannot perform management functions
and NVRAM\Flash modification unless you set a Password for FAStT MSJ.

 · Ensure that you are in a graphical user environment.
 · To start qlremote, open a command terminal from the root directory
   and type: qlremote    
 · Change to the usr directory in which the IBM FAStT MSJ script is
   installed. Type: cd /usr
 · Enter ./FAStT_MSJ
 · When FAStT MSJ is no longer required, enter ctrl-c and close the
   terminal window where qlremote is running. To ensure that qlremote
   has been terminated do the following:
   From a command terminal type: killall -TERM qlremote. 
   You should get a "no process killed" message.

Note: Ensure that no I/O's are occurring when qlremote is running.
	    
Please refer to the online help file or the User's Guide
for more information. To view the online help, go to Help
and "Set Browser Location" to match the location where your
preferred browser is located. FAStT MSJ supports Netscape
Communicator (version 4.5 or greater). You may now browse the Help
file by selecting "Browse Contents".

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

8.0  Uninstalling FAStT MSJ
----------------------------
8.1 Be sure to exit the FAStT MSJ application before you uninstall
     FAStT MSJ.

8.2 Change to the directory where you installed the FAStT MSJ 
    scripts.  For example, enter:cd /usr
    Type the following to run the InstallAnywhere Uninstaller.
                 ./FAStT_MSJ_Uninstaller

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

9.0  LIMITATIONS
-----------------

  - If multiple NICs (Network Interface Cards) are present in the 
    system, the FAStT MSJ client will broadcast to the first IP 
    address subnet based on the binding order. Therefore, ensure 
    that the NIC for the local subnet is first in the binding 
    order. If this is not done, the diagnostics might not run
    properly and remote connection might not occur. 
     
  - The FAStT MSJ application tries to help in not allowing the 
    user to connect to the same host more than once (causes 
    issues with policies and wasted system resources).  This 
    adds the requirement that all host IP address MUST resolve 
    to a host name to allow connection to complete.

  - If DNS is not used you must edit the local host file on the
    systems where you are running the FAStT MSJ GUI and the QLremote
    agent. Add the host name to IP mapping manually. 
    Edit the file /etc/hosts.

  - If the system has the firewall installed this could cause issues
    with async alarms from the agent running on Linux to a remote machine.
    This could also occur if the GUI is running on a Linux Client talking to
    a remote machine. To circumvent this problem do the following at a shell
    prompt:

         chkconfig --list

         Verify that "ipchains and iptables" in run levels 2, 3, 4, 5"
         are disabled.

         to disable at a specific run level

          chkconfig --level 2 ipchains off
          chkconfig --level 3 ipchains off
          chkconfig --level 4 ipchains off
          chkconfig --level 5 ipchains off

          chkconfig --level 2 iptables off
          chkconfig --level 3 iptables off
          chkconfig --level 4 iptables off
          chkconfig --level 5 iptables off

  - Updating the Flash BIOS is not supported 

  - When a FAStT Fibre Channel HBA (QL2200, 2310 or 2340) is connected 
    to the Fabric (switch), Loopback test is disabled since the 
    adapter is in a point to point mode.  Unplugging the cable from
    the Fabric and inserting a wrap connector at the end of the cable 
    (or at the adapter) will enable loopback test.

  - The FAStT MSJ online web help can only be viewed by Netscape
    Communicator (version 4.5 or greater). 

  - When an online device fails and goes offline and a subsequent 
    configuration refresh occurs, the loop id for that device does not 
    reflect the original ID since the device is in effect no longer in
    the loop (may show x100 or xff). 

  - When a failure occurs during Diagnostics (Loopback test and
    Read/Write Buffer test) and the test is restarted immediately, MSJ may
    request whether or not you want to refresh the configuration. Select NO 
    to continue the test. If YES is selected the Host may be disconnected
    with the following message:
        "Unable to connect to the Host: {Host Name / IP address}.
         The Host is currently in diagnostics mode, try again later."

    To recover, you need to stop (ctrl-c in the terminal session where you
    started qlremote) and then restart the agent "qlremote"

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

10.0  WEB SITES AND SUPPORT PHONE NUMBER
----------------------------------------
    10.1  IBM Support Web Site:
                http://www.ibm.com/pc/support

    10.2  IBM eServer xSeries Marketing Web Site:
                http://www.ibm.com/pc/us/eserver/xseries/index.html

    10.3 If you have any questions or problems about this package 
         go to the following Help Center World Telephone Numbers
         URL: http://www.ibm.com/planetwide

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

11.0  TRADEMARKS AND NOTICES
----------------------------

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

             IBM

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

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

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

12.0   Disclaimer
-----------------

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


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