======================================================================
                Halcyon PrimeAlert (R) EventAction
                          Version 2.5.0

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


This README.install file describes how to install and setup the
PrimeAlert EventAction module.

It consists of the following sections:
   - Definitions
   - Extracting the Distribution
   - Installation Instructions
      . Install The Server Host Packages (Solaris)
   - Uninstall Instructions
      . Uninstall The Server Host Packages (Solaris)
   - Install & Uninstall Logs
   - Module Loading


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.

ESROOT        For Sun Management Center (Sun MC) 3.5 or higher, this
              directory is determined by the user while installing
              Sun MC; the default value is /opt/SUNWsymon.  To
              determine the value of ESROOT on a Sun MC server host,
              run the command: 

              # echo "`pkgparam SUNWessrv BASEDIR`/SUNWsymon"



Extracting the Distribution
======================================================================
The PrimeAlert EventAction distribution file,

   HALEventAction_[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 would be:

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

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

   /tmp/HALEventAction_[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(s) to install this product:

   1. Install the server host packages.


1. Install The Server Host Packages (Solaris)
----------------------------------------------------------------------
To install the "PrimeAlert EventAction" 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. Extract the distribution file.
   3. Run the install script.
   4. Restart the Agent.

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

Now restart the SunMC agent as follows:

   # [ESROOT]/sbin/es-stop -a
   # [ESROOT]/sbin/es-start -a


Uninstall Instructions
======================================================================
NOTE: If the Halcyon products have been installed using Agent Update,
      then Sun's [ESROOT]/sbin/es-uninst script MUST be used to
      remove the Halcyon products.  If the products have been
      installed using Halcyon's installation method, continue with the
      instructions outlined in this section.

This section explains how to uninstall the various PrimeAlert EventAction 
components:

   1. Uninstall the server host packages.

In general, the uninstall script can be used with no arguments to 
uninstall any Halcyon PrimeAlert product:
 
   # /var/opt/SUNWsymon/uninstall/HALUninstall.sh


1. Uninstall The Server Host Packages (Solaris)
----------------------------------------------------------------------
Make sure to unload the PrimeAlert EventAction module before 
performing the following uninstallation procedure.

To uninstall the PrimeAlert EventAction 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 EventAction 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/log

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

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


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

      uninstall.log.[YYYYMMDD]-[HHMMSS]


Module Loading
======================================================================
Please refer to the "Module Loading" section in the help 
documentation for details on how to load the module.  Information on
how to access the help documentation is available in the "README"
file under the section "Help Documentation".

For solutions to common module loading problems, please refer to the
following file:

   - TroubleShooting

---//---