======================================================================
            Halcyon PrimeAlert (R) for Adapter for Netcool
                          Version 2.1.0

                          README.install
======================================================================


Overview
======================================================================
This README.install file describes how to install and setup the
PrimeAlert Adapter for Netcool.

It consists of the following sections:
   - Definitions
   - Extracting the Distribution
   - Installation Instructions
      . Server Packages
   - Uninstallation Instructions
      . Server Packages
   - Install & Uninstall Logs
   - Configuration


Definitions
======================================================================
Server Host   The host where the Sun Management Center server is
              installed and running.  This system must be a Solaris
              host, and contain the package SUNWessrv.

Agent Host    A host where a Sun Management Center agent is
              installed and running.  This system must be a Solaris
              host, and contain the package SUNWesagt.

Console Host  A host where the Sun Management Center console is
              installed and running.  This system may be a Solaris or
              a windows host.  On Solaris it contains the package
              SUNWescon.


Extracting the Distribution
======================================================================
The PrimeAlert Adapter for Netcool distribution file,

   HALAdapterNetcool_[version].tar.gz

must be extracted on a UNIX host before any packages can be installed.
For example, assume that the distribution file has been copied to the
following directory:

   /tmp

In this case, the procedure for extracting the distribution will be:

   % su -
   # cd /tmp
   # gzip -d HALAdapterNetcool_[version].tar.gz
   # tar -xvf HALAdapterNetcool_[version].tar

Following the example above, the source directory [EXTRACT_DIR] would
be the following: 

   /tmp/HALAdapterNetcool_[version]


Installation Instructions
======================================================================
This product may be installed using Halcyon's standard installation
method or with Sun Management Center's Agent Update feature.  To
install the product with Agent Update, refer to the instructions in
the following file:

    ./AgentUpdate/README.AgentUpdate.html
                     or
    http://www.halcyoninc.com/support/README-AgentUpdate.html

NOTE:
   If you choose to use Agent Update, then all Halcyon products must be
   installed using Agent Update.  It is not possible to use Agent
   Update in conjunction with any other installation procedure.

To install the product with Halcyon's standard installation method,
continue with the instructions outlined in this section.

There is one required step and one optional step to install this 
product:

   1. Install the server host packages

1. Server Packages (Solaris)
----------------------------------------------------------------------
To install the "PrimeAlert Adapter for Netcool"  packages on the Sun
Management Center server host, do the following:

   1. Become the "root" user on the Sun Management Center server host
   2. Extract the distribution file
   3. Run the install script

   % su -
   # cd [EXTRACT_DIR] (i.e. /tmp/HALAdapterNetcool_[version])
   # ./HALAdapterNetcool-install.sh


Uninstallation Instructions
======================================================================
This section explains how to uninstall the PrimeAlert Adapter for 
Netcool components:

   1. Uninstall the server host packages
   2. Uninstall the console host packages

For products installed using Halcyon's standard installation method,
the following uninstall script can be used with no arguments to
uninstall any Halcyon PrimeAlert product:

   # /var/opt/SUNWsymon/uninstall/HALUninstall.sh

For products installed using Sun Management Center's Agent Update
method, the Sun Management Center uninstall script can be used with no
arguments to uninstall any Halcyon PrimeAlert product:

   # /opt/SUNWsymon/sbin/es-uninst


Uninstall Server Packages
----------------------------------------------------------------------
To uninstall the PrimeAlert Adapter for Netcool module packages
on the Sun Management Center server host, do the following:

   1. Become the "root" user on the Sun Management Center server host
   2. Run the uninstall script with the appropriate parameters

   % su -
   # cd /var/opt/SUNWsymon/uninstall
   # ./HALUninstall.sh -module AdapterNetcool server


Install & Uninstall Logs
======================================================================
All Halcyon PrimeAlert install and uninstall log files can be found 
in the following directories:
   
   /var/opt/SUNWsymon/install
   /var/opt/SUNWsymon/uninstall


   Installation Log
   ----------------
   The name of the installation log for this product is the following:

      HALAdapterNetcool-install_[YYYYMMDD]-[HHMMSS].log


   Uninstall Log
   -------------
   The following is the generic uninstall log file:

      uninstall.log.[YYYYMMDD]-[HHMMSS]


Configuration
======================================================================
Please refer to the "Installation and Configuration" section in the 
help documentation for details on how to configure the adapter.  
Information on how to access the help documentation is available in 
the "README" file under the section "Help Documentation".

---//---