======================================================================
Halcyon PrimeAlert (R) ClusterWatch
Version 2.2.0
README.install
======================================================================
Overview
======================================================================
This README.install file describes how to install and setup the
PrimeAlert for ClusterWatch.
It consists of the following sections:
- Definitions
- Extracting the Distribution
- Installation Instructions
. Server Packages
. Agent Packages
- Uninstallation Instructions
. Server Packages
. Agent Packages
- Install & Uninstall Logs
- Module Loading
Definitions
======================================================================
Server Host: A host where the Sun Management Center (SunMC) server
is installed and running. This host must be a Solaris
host, and it contains the package SUNWessrv.
Agent Host: A host where a Sun Management Center agent is installed
and running. This system must be a Solaris or Linux
host, and contains the package SUNWesagt (SunMC agent on
Solaris), or sun-symon-esagt (SunMC agent on Linux).
(Note: Sparse root zones available on Solaris 10+ systems
do not require SUNWesagt but SunMC agents should be
configured before enabling zone support for this product.)
ESROOT: This parameter only applies for a Solaris
installation host. 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 SunMC agent host, run the following
command (for Solaris 10+ zoned environment, run the
following command in a non-sparse root zone):
# echo "`pkgparam SUNWesagt BASEDIR`/SUNWsymon"
Extracting the Distribution
======================================================================
The PrimeAlert ClusterWatch distribution file,
HALClusterWatch_2.2.0.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
folowing directory:
/tmp
In this case, the procedure for extracting the distribution will be:
% su -
# cd /tmp
# gzip -d HALClusterWatch_2.2.0.tar.gz
# tar xvf HALClusterWatch_2.2.0.tar
Following the example above, the source directory <EXTRACT_DIR> would
be the following:
/tmp/HALClusterWatch_2.2.0
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.
These are the required steps to install this product:
1. Install the server host packages
2. Install the agent host packages
3. Zone configuration (optional)
1. Server Packages
----------------------------------------------------------------------
To install the "PrimeAlert ClusterWatch" 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 metadata server.
% su -
# cd <EXTRACT_DIR> (i.e. /tmp/HALClusterWatch_2.2.0)
# ./HALClusterWatch-install.sh -s
# /opt/SUNWsymon/sbin/es-stop -m
# /opt/SUNWsymon/sbin/es-start -m
Note: During installation on the server host, when asked whether you
want to install the packages for the agent layer, answer "y"
only if this is the agent that will be loaded with the module.
The following package is installed or upgraded by the installation:
- HALmmssch
- HALmmskit
2. Agent Packages
----------------------------------------------------------------------
The installation of the agent host packages is similar to the server
host packages installation.
To install the "PrimeAlert ClusterWatch" module packages on the Sun
Management Center agent host, do the following:
1. Become the "root" user on the Sun Management Center agent host.
2. Extract the distribution file.
3. Run the install script.
4. Restart the agent.
% su -
# cd <EXTRACT_DIR> (i.e. /tmp/HALClusterWatch_2.2.0)
# ./HALClusterWatch-install.sh -a
# /opt/SUNWsymon/sbin/es-stop -a
# /opt/SUNWsymon/sbin/es-start -a
The following package is installed or upgraded by the installation:
- HALsmasch (on Solaris)
- HALsmakit (on Solaris)
- HALmmasch (on Linux)
- HALmmakit (on Linux)
3. Zone Configuration
----------------------------------------------------------------------
If you would like to use this product in a Solaris whole root zoned
environment, just install the module the same way as in a global zone.
If you would like to use this product in a Solaris sparse root zoned
environment, ensure SunMC agent is configured in the sparse root zone.
Perform the following steps in each sparse root zone where the product
is required after installing it in the global zone:
# zlogin [name of sparse root zone]
# $ESROOT/sbin/HALZoneConfig.sh
# $ESROOT/sbin/es-stop -a
# $ESROOT/sbin/es-start -a
Uninstallation Instructions
======================================================================
This section explains how to uninstall the PrimeAlert for
ClusterWatch components:
1. Uninstall the server host packages
2. Uninstall the agent 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
To manually uninstall the product, use the UNIX "pkgrm" command with
the name of the packages to be removed as arguments, or use "rpm -e"
command on a Linux host. Refer to the "Installation Instructions"
section to determine the various packages installed.
On UNIX machine:
# pkgrm <PKG_1> <PKG_2> ... <PKG_N>
On Linux machine:
# rpm -e <PKG_1> <PKG_2> ... <PKG_N>
1. Uninstall Server Packages
----------------------------------------------------------------------
To uninstall the PrimeAlert for ClusterWatch module 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 ClusterWatch server
2. Uninstall Agent Packages
----------------------------------------------------------------------
To uninstall the PrimeAlert for ClusterWatch module on the
Sun Management Center agent host, do the following:
1. Become the "root" user on the Sun Management Center agent host
2. Run the uninstall script with the appropriate parameters
% su -
# cd /var/opt/SUNWsymon/uninstall
# ./HALUninstall.sh -module ClusterWatch agent
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
Note: There are no install or uninstall logs for the Windows console.
Installation Log
----------------
The name of the installation log for this product is the following:
HALClusterWatch-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".
---//---
</pre>