IBM SSA Tools Help

IBM SSA RAID Adapters for PC Servers
IBM SSA Windows NT Event Logger
Installation / Setup Notes - README.TXT
Version v1.43 - Last Updated 25th April 2000


1.0  -  INSTALLATION
2.0  -  SETUP
 .1  -   Event Control File - EVNCTRLF.TXT
 .2  -   Predictive Failure Analysis - PFA
3.0  -  EXPERT USERS
4.0  -  CUSTOMER SUPPORT HOMEPAGE

APPENDIX A - Setup Error Messages


1.0 INSTALLATION
================

To install the NT SSA Event Logger service :

FROM CD-ROM

 \nt\setup.exe,     (installs all Host Software)

 \nt\files\elogger\setup.exe (Event Logger only)

 If you are an expert user, the raw files are
 supplied in the \nt\files\elogger\expert
 directory on the CD-ROM see section 4.0 below.

FROM WEBSITE DOWNLOAD

 Run setup.exe from

 c:\issa\update\elog

 Note : The RSM setup media also contains the
        latest Event Logger. If you have
        downloaded the RSM media run setup.exe
        from

        c:\issa\update\rsm

2.0 SETUP
=========

 2.1 Event Control File - EVNCTRLF.TXT
 =====================================
 The event control file in the \issa
 directory controls the forwarding of SSA
 events to the Netfinity Alert Manager.

 This may already be enabled, depending upon
 which type of Event Logger you installed.

 To enable event forwarding to Netfinity,
 remove the "#" from the start of the line
 "#Netfinity".

 The POPUP section in the control file controls
 which SSA events are raised as Netfinity popup
 alerts.

 Other options are configurable, see the event
 control file for details.

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

 2.2 Predictive Failure Analysis - PFA
 =====================================
 Predictive Failure Analysis is built-in to all IBM
 SSA disk drives. This allows drives to predict and
 report this prediction to the system BEFORE any
 actual data loss / drive failure occur.

 RSM and the standard SSA Event Logger support
 events of this type ( RSM will show an icon in the
 PFA column of the Physical View if a drive has
 reported en event of this type ).

 To enable the logging and analysis of such events,
 the setup program creates a new directory :

  c:\issa\pfa

 Where any PFA events are logged in the file

  pfalog.dat

 Older SSA Event Loggers used the SYSTEM ENVIRONMENT
 VARIABLE "PFA_FILENAME" which the setup program
 will remove if found. (This change will not be
 apparent until the next reboot)

3.0 Expert Users (CD-ROM Only)
==============================

To install the Event Logger manually, copy all
the files in

  \nt\files\elogger\expert

on the CD-ROM to

  c:\issa (or such)

Copy the required EVNCTRLF.TXT :

 Default :
  \nt\files\elogger\expert\evnctrlf.txt

 Netfinity Alert Forwarding :
  \nt\files\elogger\expert\netfin\evnctrlf.txt

To install and starts the Event Logger service,
open a Command Prompt :

  cd               (  = install path )
  md pfa
  servutil -i  \pfa\pfalog.dat

  Note : -d displays debug output as appropriate.


4.0 SSA Customer Support Homepage
=================================

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


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.

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