======================================================================
Halcyon PrimeAlert (R) PlusPack
Version 2.1.0
README.install
======================================================================
Overview
======================================================================
This README.install file describes how to install and setup the
PrimeAlert PlusPack modules.
It consists of the following sections:
- Definitions
- Extracting the Distribution
- Installation Instructions
. Server Packages
. Agent Packages
. Console Packages
- Uninstallation Instructions
. Server Packages
. Agent Packages
. Console Packages
- 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,
Linux, or HP-UX host, and contain the package SUNWesagt,
HALpialag, or HALpiahpa.
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 PlusPack distribution file,
HALPlusPack_2.1.0.tar.Z OR
HALPlusPack_2.1.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
following directory:
/tmp
In this case, the procedure for extracting the distribution will be:
% su -
# cd /tmp
# uncompress HALPlusPack_2.1.0.tar.Z OR
gzip -d HALPlusPack_2.1.0.tar.gz
# tar -xvf HALPlusPack_2.1.0.tar
NOTE:
Versions of Red Hat Linux prior to 6.1 may contain a problematic
version of tar that cannot handle long pathnames. Although this will
not affect the installation of the Linux packages, extraneous files
may be created in the directory where the tarball is extracted; thus,
the tarball should be extracted in a dedicated staging directory,
such as /tmp/install. Note that if your version of Linux tar cannot
handle long pathnames, then the extracted tarball should only be used
for doing installations on the local Linux host.
Following the example above, the source directory <EXTRACT_DIR> would
be the following:
/tmp/HALPlusPack_2.1.0
Installation Instructions
======================================================================
This product may be installed using Halcyon's installation script or
with Sun Management Center's Agent Update feature. To rollout the product
with Agent Update, refer to file README.AgentUpdate for details.
NOTE:
If you choose to use Agent Update, then all Halcyon modules must be
installed using Agent Update. It is not possible to use Agent
Update in conjunction with Halcyon's installation script.
To install the product with Halcyon's installation script, continue with
the instructions outlined in this file.
There is one optional and two required steps to install this product:
1. Install the server host packages
2. Install the agent host packages
3. Install the console host packages
1. Server Packages (Solaris)
----------------------------------------------------------------------
To install the "PrimeAlert PlusPack" 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
% su -
# cd <EXTRACT_DIR> (i.e. /tmp/HALHALPlusPack_2.1.0)
# ./HALPlusPack-install.sh
The following packages are installed or upgraded:
- HALmmsdir
- HALmmsfbr
- HALmmsfil
- HALmmskit
- HALmmslog
- HALmmsprc
- HALmmsssa
- HALmmstop
2. Agent Packages (Solaris, HP-UX, and Linux)
----------------------------------------------------------------------
The installation of the agent host packages is similar to the server
host packages installation.
To install the "PrimeAlert PlusPack" module packages
on an agent host, do the following:
1. Become the "root" user on the agent host
2. Extract the distribution file
3. Run the install script
4. Restart the agent
On Solaris:
% su -
# cd <EXTRACT_DIR> (i.e. /tmp/HALPlusPack_2.1.0)
# ./HALPlusPack-install.sh
# /opt/SUNWsymon/sbin/es-stop -a
# /opt/SUNWsymon/sbin/es-start -a
On Linux or HP-UX:
% su -
# cd <EXTRACT_DIR> (i.e. /tmp/HALPlusPack_2.1.0)
# ./HALPlusPack-install.sh
# /opt/PrimeAlert/bin/pa stop agent
# /opt/PrimeAlert/bin/pa start agent
NOTE:
On HP-UX systems it may be necessary to run the install script from
a local file system since the HP installation software requires root
access to the directories containing the packages.
On a Solaris host, the following packages are installed or upgraded by
the installation:
- HALsmadir
- HALsmafbr
- HALsmafil
- HALsmalog
- HALsmaprc
- HALsmatop
- HALsmakit
- HALsmassa
On an HP-UX or Linux host, the following packages are installed or
upgraded by the installation:
- HALpmadir
- HALpmafbr
- HALpmafil
- HALpmalog
- HALpmaprc
- HALpmatop
3. Console Packages (Solaris & Windows)
----------------------------------------------------------------------
The installation of the console host packages is optional. These
packages install the HELP files for the module. The packages can be
installed on either the Solaris or the Windows console.
To install the "PrimeAlert PlusPack" module packages
on the Sun Management Center console host, do the following:
Solaris Console
---------------
1. Become the "root" user on the Sun Management Center console host
2. Extract the distribution file
3. Run the install script
4. Restart the console
% su -
# cd <EXTRACT_DIR> (i.e. /tmp/HALPlusPack_2.1.0)
# ./HALPlusPack-install.sh
# /opt/SUNWsymon/sbin/es-start -c
The following packages are installed or upgraded:
- HALmmcdir
- HALmmcfbr
- HALmmcfil
- HALmmclog
- HALmmcprc
- HALmmcssa
- HALmmctop
Windows Console
---------------
1. Extract the distribution file
2. Run the InstallShield installer for Windows
3. Restart the console
# cd <EXTRACT_DIR>/packages/win32
# Double click on "HALPlusPack_2.1.0.exe"
# Double click on "Sun Management Center.exe" to start the console
Uninstallation Instructions
======================================================================
This section explains how to uninstall the various PrimeAlert
PlusPack components:
1. Uninstall the server host packages
2. Uninstall the agent host packages
3. Uninstall the console 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. Refer to the
"Installation Instructions" section to determine the various packages
installed.
# pkgrm <PKG_1> <PKG_2> ... <PKG_N>
Uninstall Server Packages
----------------------------------------------------------------------
To uninstall the PrimeAlert PlusPack 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 PlusPack server
Uninstall Agent Packages
----------------------------------------------------------------------
To uninstall the PrimeAlert PlusPack module packages
on the agent host, do the following:
1. Become the "root" user on the agent host
2. Run the uninstall script with the appropriate parameters
On Solaris:
% su -
# cd /var/opt/SUNWsymon/uninstall
# ./HALUninstall.sh -module PlusPack agent
On Linux or HP-UX:
% su -
# cd /var/opt/PrimeAlert/uninstall
# ./HALUninstall.sh -module PlusPack agent
Uninstall Console Packages (Solaris & Windows)
----------------------------------------------------------------------
To uninstall the "PrimeAlert PlusPack" module
packages on the Sun Management Center console host, do the following:
Solaris Console
---------------
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 PlusPack console
Windows Console
---------------
1. Double-click on "Add/Remove Programs" in the "Control Panel"
Start -> Settings -> Control Panel
2. Select "Halcyon PrimeAlert PlusPack" and
click the "Add/Remove..." button.
3. An UnInstallShield session will be launch; follow the
instructions to uninstall the product.
Install & Uninstall Logs
======================================================================
All Halcyon PrimeAlert install and uninstall log files can be found
in the following directories:
On Solaris:
/var/opt/SUNWsymon/install
/var/opt/SUNWsymon/uninstall
On Linux or HP-UX:
/var/opt/PrimeAlert/install
/var/opt/PrimeAlert/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:
HALPlusPack-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".
---//---