IBM SSA Tools Help

IBM SSA RAID Adapters for PC Servers
SSA Remote Systems Management
Stand Alone NT Service - README.TXT
Version v1.53 - Last Updated 11th July 2000


 1.0  -  PRE-REQUISITES
 2.0  -  INSTALLATION

 3.0  -  SECURITY               <<< !IMPORTANT! >>>
 4.0  -  NOTES FOR USERS
  .1  -   Tutorial
  .2  -   Help
  .3  -   SRN List
  .4  -   Proxies
  .5  -   Netscape Configuration
  .6  -   Browser Time-outs
  .7  -   Service Port
  .8  -   General
  .9  -   Known Problems / Fix History
  .10 -   Before UNINSTALLING...
 5.0  -  SSA HOMEPAGE

APPENDIX A - Setup Error Messages


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

 To run the IBM SSA RSM Stand Alone NT Service

 * One 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

 * Windows NT SSA Event Logger Version, at least 1.30

 * NT Server 4.0 (Standard or Enterprise Edition SP3+)
   with TCP/IP 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 Administrators account.


 When installation is complete, confirm that RSM
 has installed correctly, by opening your browser at :

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

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

  http://your.machine.name:511/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.

 When you enter RSM, you are prompted for a uid and pwd,
 enter "SSA" for both, NB Security is case sensitive,
 must enter SSA in capitals for both uid and pwd.
 (See 3.0 NOW for important security information)
          ^^^
 You should then see the SSA Adapter List Page. The
 context sensitive help icon on each page should
 answer any further questions/problems you may
 experience.


3.0 SECURITY
============

 This version (Stand Alone NT Service) includes full
 access security. At install, only one user exists and
 has administrator access. This user can add/delete
 and modify user access privileges and has full
 SSA configuration permission.

 At least two users should be created, one to
 administer the SSA devices and one to simply view
 the current configuration. It is recommended that
 the default user is removed as soon as you have
 created a new administrator user to stop unauthorised
 access via the default user and password.

 The default user is : SSA
       with password : SSA

 (NB Usernames and passwords are case-sensitive and
     can only be from 1 to 10 characters - blank
     passwords cannot be used.)

 The encrypted access security resides in the hidden
 file ssacfg.sec in your install directory. There is a
 backup copy of the default file (ssacfg.bak) Should
 the original ssacfg.sec file become corrupt/unusable
 copy ssacfg.bak to ssacfg.sec and you can login
 again as user SSA and password SSA.

 *** SECURITY WARNING ***
  You should ensure that access is restricted
  to  your install directory otherwise an unauthorised
  user could replace the security file with the default
  and hence gain unauthorised SSA configuration access.
  It is highly recommended you confirm that :

   ssacfg.sec
   ssacfg.bak
   ssacfg.old

  are hidden files once they have been copied to your
  install directory, and that you don't share this
  directory on your network.
 ************************

 If you have already installed RSM, setup will ask if
 you wish to overwrite your existing security records.

 If you select YES, your security file (ssacfg.sec)
 is copied to ssacfg.old before it is overwritten by
 the default security file.

 If you select NO, your security file remains unchanged.

4.0 NOTES FOR USERS
===================

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

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

 OR from the SSA Tools Menu.

 4.2 HELP WINDOW
 ===============
 The help within SSA 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.

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

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

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

 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.

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

 4.7 SERVICE PORT
 ================
 If you have another service running, or using
 port 511, you can change the RSM port number to
 any valid number by running :

 c:\issa\servutil

 (With no parameters will show usage below)

 To re-install with a different port setting :

 c:\issa\servutil -i rsm c:\issa\web xxx

 (where xxx=new port number)

 This can also be used to change the install
 directory. Be sure to copy all the files in
 c:\issa\web including subdirectories before
 moving the service path.

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

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

 4.10 BEFORE UNINSTALLING...
 ===========================

 If uninstalling this version of SSA RSM, you MUST
 first run the following command

   c:\issa\servutil -rm rsm

 This will remove the SSA RSM Service from the Registry.
 Then run Control Panel->Add Remove Software to remove
 the program files.

 NB: If you do not run servutil -rm ,selecting SSA RSM in
 Add Remove Software will fail as the RSM service will
 still be running.


5.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 Version 5.2,
    Setup failed to find the Netfinity install location.
    Install the Stand Alone version.

11. "RSM no longer supports Netfinity SM Versions 5.0 and 5.1.
     You should upgrade Netfinity SM to Version 5.2 or install
     the RSM Stand Alone version"

    Setup has detected that you previously installed the
    Netfinity SM 5.0 / 5.1 version of RSM. This is not longer
    supported. You can continue to use the previous version,
    but you should install Netfinity SM 5.2 and re-run setup.

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

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

14. "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.

15. "An unknown error has occurred."

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

16. "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"

17. "The SSA Device Driver requires Windows Service Pack 3
     or later. Please install Service Pack 3 or later and
     re-run setup."

    Setup detected an unsupported level of Windows NT.
    Install Service Pack 5 and re-run setup.



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

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

IBM, OS/2

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
===