IBM SSA Tools Help

IBM SSA RAID Adapters for PC Servers
SSA Remote Systems Management
Netfinity Manager Web Extension for v5.2 - README.TXT
Version v1.53 - Last Updated 11th July 2000


 1.0  -  PRE-REQUISITES
 2.0  -  INSTALLATION
 3.0  -  NOTES FOR USERS
  .1  -   Tutorial
  .2  -   Help
  .3  -   SRN List
  .4  -   Proxy Configurations
  .5  -   Netscape Configuration
  .6  -   Browser Time-outs
  .7  -   General
  .8  -   Known Problems / Fixes
  .9  -   Netfinity Alert Manager
 4.0  -  SSA HOMEPAGE

APPENDIX A - Setup Error Messages

1.0 PRE-REQUISITES
==================

 To run the Netfinity SSA Web Extension :

 * Any of the following IBM SSA RAID Adapters :

   IBM SSA RAID Adapter,
   IBM SSA RAID Cluster Adapter,
   IBM SerialRAID Adapter,
   IBM Advanced SerialRAID/X Adapter.

   You should ensure you are running the latest
   adapter, disk and enclosure microcode and are
   running the latest Windows NT drivers. The
   latest levels can be checked via RSM, or see

    http://www.storage.ibm.com/hardsoft/products/ssa/

 * Netfinity Manager Versions 5.2 with
   Web Manager Services installed and enabled.

 * Windows NT SSA Event Logger (at least Version 1.30)

 * NT Server 4.0 (Standard or Enterprise Edition SP3+)
   with Networking Installed. (Recommend SP5)

   NOTE: SP4+ is required when using Microsoft Cluster
         Service.

 * Netscape 4.5x+, recommend 4.7x
   or
   Internet Explorer 4.72 SP2, recommend 4.72 SP2
   Internet Explorer 5.0x,     recommend 5.00.23x+

   NOTE: RSM is not supported with any releases of
         Internet Explorer 3, or Netscape 3 or below.


2.0 INSTALLATION
================

 Run setup.exe from the Administrator account.

 When installation is complete, setup will restart
 the Netfinity Service. To confirm that SSA RSM has
 installed correctly open a browser at :

  http://your.machine.name:411/ssa

 OR select the "SSA Tools" icon setup creates on your
 Start Menu which opens your default browser at :

  http://your.machine.name:411/ssaindex.htm

 The SSA Tools Menu contains links to RSM itself, the
 RSM Tutorial, HTML versions of all SSA readme files,
 and other reference material.

 (NB This assumes you just installed on the server.
 If you have installed on a client, you may have to
 use Netfinity's "Remote System Manager" to access
 the client service via the server, see Netfinity
 documentation/help for more details)

 This is the Netfinity Web Manager index page. You
 should now see an extra icon "SSA" on this page.
 Click on this icon and you will see the SSA Host Page.
 The context sensitive help icon on each page should
 answer any further questions/problems you may experience.

 If you failed to get to the SSA Host Page, please
 confirm the following:

 a) You installed the Netfinity Web Manager when you
    installed Netfinity. If you did not, reinstall
    Netfinity, checking the box next to

    "Install Web Service Manager"

 b) You have enabled the Web Manager from the WWW
    icon on the Netfinity Service Manager NT Window.
    Also confirm that the port number is 411. If it is
    not, replace :411 in the URL above with the port
    number your machine is set to.

 c) If a) and b) are correctly setup, but you don't see
    an "SSA" icon on the Netfinity Web Manager Main page,
    confirm that the following files exist in your
    Netfinity directory. (Usually c:\wnetfin )

    ssabase.exe
    ssa.web
    ssa.ini
    ssa.dll
    ssalink.txt

    If they do, setup has copied the files correctly,
    but has failed to correctly install the new service.
    You can manually install as follows:

    Open a DOS window and cd into your Netfinity directory,
    and execute the three following commands. (Wait until
    the hour-glass next to the mouse pointer finishes
    before running each command)

    1) netfbase shutdown

    2) bdsvcini merge ssa.ini

    3) netfbase start

    You should now check the above URL again and the
    "SSA" icon should be visible.


3.0 NOTES FOR USERS
===================

 3.1 RSM TUTORIAL
 ================
 This version of RSM is supplied with an HTML based
 tutorial, which can be accessed via :

  http://your.machine.name:411/tutorial.htm

 OR from the "SSA Tools" index on your Start Menu.

 3.2 HELP WINDOW
 ===============
 The help within RSM is context sensitive. Clicking
 on the help icon opens another browser window
 containing the relevant help section. Every subsequent
 click on the help icon will update the same window.

 Please be aware that depending upon Windows setup and
 the browser used, the help window may not auto-raise
 when the icon is re-selected.

 3.3 SRN LIST
 ============
 Upon "analysing" the SSA Event Logger within RSM, if
 any problems exist, an SRN (Service Request Number)
 will be shown. Click on the link to open the SRN
 window, where instructions will be given to help you
 correct the problem.

 Some browsers will not refresh the window when
 subsequent SRN links are selected. Either use the
 'Find' function, or close the window and re-click
 on the link.


 3.4 PROXY CONFIGURATIONS
 ========================
 Some problems may be experienced when accessing
 SSA RSM via a proxy server. It is recommended that
 you use an automatic proxy configuration script
 (if available) otherwise

 - if you are accessing SSA RSM from behind a
   firewall, and SSA RSM itself is behind the
   firewall, ensure you are using the "no proxy
   for" to stop proxy usage for internal access

 Some problems have also been found using Netscape
 when an array contains a failed resource and no hot
 spare is available. At this point, the failed
 resource is replaced by a virtual disk, a "blank
 reserved". When using a proxy server, some versions
 of Netscape fail to process the "blank reserved"
 resource. Please contact a service representative.

 With the enhanced IP Address based security, if you
 access RSM through a proxy, you will not be granted
 access unless you add the IP address of the proxy
 server to RSM. This will nullify the IP security,
 as it will allow all users entering through the
 proxy server to access RSM.

 For local (behind a firewall) access you should
 ensure you are using an automatic proxy configuration
 script.

 3.5 NETSCAPE CONFIGURATION
 ==========================
 It has been found that in some cases, using Netscape
 and clicking on a link before the Explorer frame
 has finished loading will crash the RSM service.

 If you experience this, simply stop and start the
 RSM service from the Control Panel services window.

 To stop this happening, wait until all images have
 loaded before clicking on a link.

 It is recommended that you enable your browser to
 reload documents every time, otherwise cached pages
 may cause confusion when configuring systems.

  For Netscape4, Edit, Preferences, Advanced, Cache

 NETSCAPE 3 USER'S PLEASE NOTE : These versions of the
 browser are not supported, this is due to the lack of
 support for some JavaScript functions used in RSM
 versions 1.42+. This will only occur when you create
 RAID10 arrays with multiple domains. When you select
 the Primary and Secondary resources, your browser will
 not be able to validate the selections as they are made,
 you will still be presented with the confirmation screen.

 3.6 BROWSER TIME-OUTS
 ====================
 If your browser connection is slow (i.e. when remotely
 accessing RSM), the reply may time-out. Note that
 the action you performed will have been executed if
 it got to the server and will continue to completed,
 since the adapter execute all requests it receives.
 You should refresh the view before repeating the
 action, to ensure you don't perform the action twice.

 3.7 GENERAL
 ===========
 The stand-alone service defaults to port 511 to
 prevent conflicts with Netfinity Manager which, by
 default, binds to port 411.

 Both versions of RSM can be run on the same server
 without any apparent problems. It should be noted
 however that there is nothing to be achieved from
 this configuration, except the noticeable time delays
 when more than one user tries to access the stand-
 alone service.

 The Netfinity Service is multi-threaded by nature,
 i.e. the Netfinity server schedules the tasks should
 two users request information from the same adapter.

 The stand-alone service is single-threaded. If two
 users attempt to use a single service at the same
 time, one user may be returned a time-out. Simply
 click reload on your browser to retry.

 3.8 KNOWN PROBLEMS (P) / FIXES (F)
 ==================================
 See history.txt copied to your install directory for
 release notes / known problems and fixes / enhancements.

 3.9 NETFINITY ALERT MANAGER
 ===========================
 Note that all SSA events forwarded to the Netfinity SM
 Alert Manager are raised with a Severity of 0 - this is
 the highest priorty.

 Events are either of type :Failure or :Warning.

 See the Netfinity SM Documentation for further information.

4.0 SSA HOMEPAGE
================

 For all the latest code releases, device drivers etc,


  http://www.storage.ibm.com/hardsoft/products/ssa


 For updates to RSM,


  http://www.storage.ibm.com/hardsoft/products/ssa/rsm/


 For product news,

  http://www.storage.ibm.com/

 We always welcome comments, or suggestions for
 improvement via our Active Feedback forms,
 please submit via the forms on the Website.


APPENDIX A - Setup Error Messages
=================================

A1 - Device Driver
------------------

0. "Setup did not find the IBM SSA Adapter device driver.
    This device driver must be installed and running before
    setup can continue..."

    Follow the instructions displayed when you click OK and
    re-run setup when you have installed the appropriate
    device driver.

A2 - Windows NT Registry
------------------------

1. "Couldn't set registry root to HKEY_LOCAL_MACHINE"

    Setup failed to contact your System Registry.

2. "Could not create registry Key : xxx"

    Setup failed to create the registry key xxx, try
    creating the specified key with regedt32.exe and
    re-run setup.

3. "Could not create registry value : xxx"

    Setup failed to create the registry value xxx, try
    creating the specified value with regedt32.exe and
    re-run setup.

4. "Could not retrieve registry value : xxx"

    A value (xxx) required by setup could not be found.
    If setup aborted, you may not have one of the
    pre-requisite software components or services.

5. "Could not delete registry old Registry key... xxx"

    Setup removes old registry software keys after
    upgrading and recreates the keys with the new
    settings. Delete the key specified and re-run setup.

A3 - Application Launch
-----------------------

6. "Failed to launch application cmdxxx paramsyyy"

    Setup failed to run the specified application. This
    generally relates to the RSM or Event Logger Service
    utility - servutil.exe. Try running the command
    before setup to stop services if setup fails to
    copy files, or run the command after setup if setup
    fails to restart / start a service.

    For usage see : servutil -h

    For all commands add -d for debug output.

    Note : If setup fails to launch notepad, simply
           view the readme file later.

A4 - Event Logger
-----------------

7.  Not currently used.

A5 - RSM
--------

8. "Setup detected an old version of RSM which is not
    in the default location. This old version has been
    stopped, uninstalled and replaced by ..."

    You should delete the files in the old location
    as specified by the error message. These files have
    been replaced by those in the default c:\issa\web
    directory.

9. "Setup could not find the Microsoft TCP/IP Network
    Service on this machine..."

    The Stand Alone NT Service version of RSM requires
    TCP/IP Networking to function. Install the TCP/IP
    Network protocol and re-run setup.

10. "Setup could not find a version of Netfinity compatible
     with RSM. You must install the Stand Alone NT Service."

    RSM is compatible with Netfinity Manager Versions 5.0,
    5.1 and 5.2 Setup failed to find one of these. Install
    the Stand Alone version.

11. "The version of Netfinity you have installed is not
     compatible with the version of RSM you selected..."

    Re-select the appropriate version of RSM, or select
    the Stand Alone version.

12. "Could not find a default browser in your registry..."

    Setup couldn't find one of the supported browsers,
    see pre-reqs. Setup will not have created a link to
    the SSA Tools Menu, but RSM may still function with
    your browser, try running it manually.

A6 - General
------------

13. "This Software is for Windows NT Server 4.0 Only."

    Setup detected an operating system other than
    Windows NT. SSA Adapters are only supported on
    Intel Windows NT servers.

14. "An unknown error has occurred."

    Setup suffered an unrecoverable error. Please contact
    your service representative / supplier.

15. "An error occurred during the move data process: -nnn"

    If you have a previous version of the either RSM or
    the SSA Event Logger services running. You must ensure
    these are stopped before re-installing, setup tries to
    stop the service but may have failed. Use servutil.exe
    to stop both services manually, or use the Control
    Panel, services window to stop both

    "PC's SSA Event Logger" and
    "SSA Remote Systems Management"


Trademarks and Notices
======================

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

IBM, OS/2, Netfinity, Netfinity Manager

Microsoft and Windows are trademarks or registered
trademarks of Microsoft Corporation.

Adobe, Acrobat and the Acrobat Logo are trademarks of Adobe
Systems Incorporated.

Novell Netware is a trademark or registered trademark of
Novell Inc.

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

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

===
END
===