======================================================================
Halcyon PrimeAlert (R) for Sun Web Server
Version 2.1.0
README.install
======================================================================
Overview
======================================================================
This README.install file describes how to install and setup the
PrimeAlert for Sun Web Server module.
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
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 is contains the package
SUNWescon.
ESROOT For Sun MC 3.0 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 agent host, run the 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 for Sun Web Server distribution file,
HALiWS_[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 HALiWS_[version].tar.gz
# tar -xvf HALiWS_[version].tar
Following the example above, the source directory [EXTRACT_DIR] would
be the following:
/tmp/HALiWS_[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 are two 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 (Solaris)
----------------------------------------------------------------------
To install the "PrimeAlert for Sun Web Server" 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 metadata server
% su -
# cd [EXTRACT_DIR] (i.e. /tmp/HALiWS_[version])
# ./HALiWS-install.sh
# /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 the Sun Web Server software is installed on
that particular host.
In general, the Agent host packages should only be installed on
hosts where the Sun Web Server application is installed
and running.
2. Agent Packages (Solaris)
----------------------------------------------------------------------
The installation of the Agent host packages is similiar to the Server
host packages installation.
Note: The Server host packages should be installed or upgraded before
the Agent packages.
To install the "PrimeAlert for Sun Web Server" 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/HALiWS_[version])
# ./HALiWS-install.sh
# /opt/SUNWsymon/sbin/es-stop -a
# /opt/SUNWsymon/sbin/es-start -a
3. Zone Configuration
----------------------------------------------------------------------
If you would like to use this product in a Solaris whole root zoned
environment, just install the module as if it is a global zone.
If you would like to use this product in a Solaris sparse root zoned
environment, 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 unistall the various PrimeAlert for
Sun Web Server 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
Uninstall Server Packages
----------------------------------------------------------------------
To uninstall the PrimeAlert for Sun Web Server 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 iWS server
Uninstall Agent Packages
----------------------------------------------------------------------
To uninstall the PrimeAlert for Sun Web Server 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. Run the uninstall script with the appropriate parameters
% su -
# cd /var/opt/SUNWsymon/uninstall
# ./HALUninstall.sh -module iWS 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
Installation Log
----------------
The name of the installation log for this product is the following:
HALiWS-install_[YYYYMMDD]-[HHMMSS].log
Uninstall Log
-------------
The following is the generic uninstall log file:
uninstall.log.[YYYYMMDD]-[HHMMSS]
---//---