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