Readme File for SANavigator Diagnostic and Management Software for
Linux Red Hat.
                             
This README file contains the latest information about installing
SANavigator Diagnostic and Management Software for Linux Red Hat 7.1 kernel 2.4.9-21
  
Refer to the IBM Support Website for the latest information and updated README
file (http://www.ibm.com/pc/support).)

For details on the installation and use of SANavigator refer to the Problem
Determination MAPS document, Chapter 5 "Introduction to SANavigator" located on 
the IBM Support web site (http://www.ibm.com/pc/support).

Last update: First Release 03/26/2002 - non API

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

1.0   Overview
2.0   Change History
3.0   OS Support
4.0   Components 
5.0   Configuration
6.0   Requirements
7.0   Obtaining the SANavigator Package
8.0   SNIA API Library
9.0   Installing SANavigator
10.0  Starting SANavigator
11.0  Uninstalling SANavigator
12.0  Limitations
13.0  Web Sites and Support Phone number
14.0  Trademarks and Notices
15.0  Disclaimer


1.0 OVERVIEW
------------
SANavigator management software provides easy, centralized management and 
diagnosis of your SAN, and quick access to all device configuration
applications.

It provides an intuitive interface and powerful point and click functionality.
Through its graphical display of the complete SAN, administrators of all
levels can manage their networks with ease. 

With SANavigator you can monitor the health of your SAN and identify potential
problems that may impact the performance and/or the availability of your SAN.

Along with the available Problem Determination MAPS (PDs), SANavigator greatly
facilitates problem isolation and repair of your SAN. 

Some of the features include:
· Intuitive GUI with physical topology display.
· Out-of-band
· Quick identification of port connections for each of your devices
· Launch capability of applications and tools such as the IBM FAStT Storage
  Manager and IBM FAStT MSJ diagnostic.
· Event logging
· Ability to easily export SAN files so that they can be imported into
  a remote SANavigator system, displayed and analyzed.

2.0 CHANGE HISTORY
------------------
03/22/2002: Inititial release for Linux Red Hat.version 2.7.1i.
 		
3.0 OS SUPPORT
--------------

This application has been tested with Linux Red Hat 7.1 kernel 2.4.9-21

4.0 COMPONENTS
--------------

SANavigator consists of a Client and Server.

You can install the SANavigator tool as a client, a server, or both.
The major benefit of using the Client/Server feature is that you can
have a SAN running on a server and have a number of clients working on
the same SAN at the same time. Each client can see what all other clients
are doing. Clients can be as near as across the room or as far away as
halfway around the world. Each client can access as many servers as they
are authorized for. Users are assigned one of three levels of authorization
on the server: no access, view only, or administrative authority. Clients 
can set their personal preferences and they are saved locally. 

· SANavigator Client: 

This is a Java based GUI application that runs on any Windows NT\W2K system.
It allows you to manage a Server connected to the network

· SANavigator Server: 

This is a Java based application running on a Server and providing the
discovery engine and maintenance of the SAN database. Out-of-band discovery 
(through the network)requires that the SAN be connected to a fabric (either
 switch or managed hub).

5.0 CONFIGURATION
-----------------

The discovery configuration that SANavigator supports can be divided 
into two types: In-band and Out-of-band (Network).

 5.1 In-Band
If your SAN is directly connected to your FAStT Storage Server or to an
un-managed hub (that is no switch or managed hub is present) only in-band
discovery is possible. In-band discovery takes place on the Server where the
Host Bus Adapters are located. Both the client and the server need to be
installed. In-band is currently not supported due to HBA driver limitation.

 5.2 Out-of-band (Network)
If your SAN is connected to a fabric (switches and\or managed Hubs network
connected to your server) out-of-band management is required. The SAN 
discovery is done through SNMP communication.


6.0  REQUIREMENTS
-----------------

6.1  MINIMUM HARDWARE REQUIREMENTS
  
· 400 MHz Intel Pentium II
· CD ROM
· 128 MB RAM
· 100 MB Free Disk Space
· VGA 256 Colors or Greater

6.2  SOFTWARE REQUIREMENTS

· Linux Red Hat version 7.1 with Kernel 2.4.9-21
· FAStT HBA device drivers at level 5.38.1 or higher.

7.0. OBTAINING THE SANavigator PACKAGE
--------------------------------------
You can install SANavigator using the CD supplied in the FAStT Storage
Server carton or from the IBM Support web site. Check the web site for
latest information on SANavigator and to ensure that you have the latest level.

7.1 CD Installation

     - Insert the SANavigator CD
     - Login as root. From the Linux\Redhat directory on the CD, copy the
      .bin file (e.g.  SANav271irh.bin) to your temp directory. 
     - Start the Installer
        ./temp/SANav271irh.bin or...
        sh ./temp/SANav271irh.bin
     - Follow the on-screen instructions.

7.2 Web Download

Go to the IBM Support WEB site - http://www.pc.ibm.com/ to access the WEB page. 

The web site includes the following:

 -  This readme file.

 - A link to the SANavigator web site - http://www.sanavigator.com/ibm/xseries
   to allow you to download SANavigator. This will ensure that you are
   downloading the latest version of SANavigator.
   In order to download the package, you will need to register. Please have your
   FAStT Storage Server model number and serial number to complete the
   registration.

 
8.0. SNIA HBA library
---------------------
8.1 Support for in-band management using the HBA API Library is not available
    with the 5.38.1 HBA driver. A later release will provide support.
  

9.0. INSTALLING SANavigator
---------------------------
9.1 Before you begin, obtain your network information, including the IP address
    and subnets of SAN switches and servers.

9.2 To install SANavigator on your Linux based computer do the following:
     - Open a terminal session in the GUI
     - From the directory where you stored the bin file, do the following
       at the prompt:
	sh SANav271irh.bin or
        ./SANav271irh.bin

4. Wait for the introduction window to open
5. Follow the instructions presented by the Installer

    Note:  If the default directory is chosen, SANavigator will be installed
    in the /opt directory. Script files are stored in the /usr directory

10.0  Starting the SANavigator Server and Client
------------------------------------------------
10.1 Once the application has been installed, you can start it. 
	- Open a terminal session from the GUI
	- From the /usr directory enter the following:
		sh SANavigator or
                ./SANavigator

This will launch both the Client and the Server.

10.2 To launch only the client open a terminal session.
        - From the /usr directory enter the following:
                sh SANavigator_Client or
                ./SANavigator_Client

10.3 Once SANavigator is launched, it will try to discover the SAN based on the
    IP address of the server on which it is installed. If the IP address is not
    available, you will need to provide one. Select New in the Open SAN dialog and
    enter the IP address of your server.

10.4  In the General tab of the Discovery dialog (Click Discovery--->Setup),
      select out-of-band. Make sure Discovery is turned on.

  Please refer to the online help file or the Problem Determination Maps (PD's)
  for more information. PD's can be found on the IBM Support Web site.


11.0  Uninstalling SANavigator
------------------------------
11.1 Be sure to Exit the application before you uninstall SANavigator. If other
     Hosts are currently connected to this Server, exiting SANavigator will 
     disconnect these Hosts. If you do not want to disconnect other Hosts, Exit 
     Client Only. In this case you will not be able to un-install SANavigator
     until all remote hosts are disconnected. If you have not Exited from
     SANavigator - that is the Server is still running - end the Server. To end 
     the server enter the following commands:
	#ps -ef | grep -i "SANavigator"        (include quotes)
        #kill -9 process id
     
     The grep command will list the associated SANavigator process id. From the
     list, select the process id with the greatest value to close the Server
     (typically the one right before the grep process.)
 
11.2 Uninstall SANavigator by opening a terminal session in the GUI and entering
     the following commands from the /usr directory:      - 
        sh Uninstall_SANavigator or
        ./Uninstall_SANavigator

    Note: Uninstall instructions assume that SANavigator was installed using the
         default selections.

3. Wait for the introduction window to open
4. Follow the instructions presented by the Uninstaller.

12.0  LIMITATIONS
-----------------

12.1 Discovery

12.1.1 SANavigator defaults to your local subnet for initial discovery. You
       will need to enter the IP and subnet of the SAN you wish to discover in the
       Out-of-Band tab of the Discover Setup dialog.

12.1.2 It is more efficient to discover a large subnet by using the broadcast
       method rather than the sweep or individual IP method. The individual IP
       method may be faster when discovering a SAN on a subnet that is congested
       or that has long latencies. 

12.1.3 Verify that there is an Ethernet connection to the SANavigator System 
       and all SAN devices (switches and hubs connections are mandatory) before
       doing a discovery. Otherwise, discovery will show all red icons.

12.1.4 In the Discovery Setup dialog box General Tab, you can clear the current 
       SAN. This will remove any configuration that you may have previously set
       up. Therefore, MAKE SURE you save your SAN setup prior to clearing it.

12.2 Topology Representation and Display

12.2.1 Changing the color depth of the computer display may cause the window
       to turn black. This occurs when changing color depth and also when changing
       from a high resolution to a lower resolution. If your resolution is set at
       more than 1280 x 1024 pixels, some fields in the Port and LUN Performance
       dialogs are outside the boundary of the dialog. Increase the size of the
       dialog manually and they will display properly.

12.2.2 To obtain the best depiction of bridges and routers and the devices
       connected to them, enter the IP address for each(bridge and router) in the
       individual addresses table on the Out-of-Band tab of the Discover Setup
       dialog. 
       Ensure the Ethernet ports of the bridges\routers are connected to the same 
       subnetwork as the switches and associated Hosts.

12.2.3 Delete off line (red) connections and devices from the topology before
       connecting any new devices to the same port. 

12.2.4 Unidentified devices attached to a supported device may display as a
       Storage or Unknown device. To change the icon to the correct device type,
       right-click on the device,select "Properties," and then select the correct
       device type from the drop-down list.
 
12.2.5 Active speed may not be reported on all FAStT HBA's with device driver
       level 5.38.1. This will be fixed in the next HBA driver release.

12.2.6 Support for the in-band management using the HBA API Library is not available
       at this time. A later release will provide support.

12.3 General

12.3.1  In-band Management is not supported

12.3.2 Copy/Paste of information from outside of SANavigator is not supported.
       You can however, copy/paste within SANavigator (Device List for example).

12.4 Release Notes 
	Please refer to the ReleaseNotes.pdf (portable document format) file in
        the SANavigator install directory for additional limitations and hints.

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

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

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


14.0  TRADEMARKS AND NOTICES
----------------------------

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

             IBM

            SANavigator is a trademark of SANavigator, Inc.

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


15.0   Disclaimer
-----------------

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


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