======================================================================
Halcyon PrimeAlert (R) for Adapter for Frameworks
Version 2.1.0
README.install
======================================================================
Overview
======================================================================
This README.install file describes how to install and setup the
PrimeAlert Adapter for Frameworks.
It consists of the following sections:
- Definitions
- Extracting the Distribution
- Installation Instructions
. Server Packages
. Console 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.
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 $ESROOT. 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 Adapter for Frameworks distribution file,
HALsmxfwk_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
# gzip -d HALsmxfwk_2.1.0.tar.gz
# tar -xvf HALsmxfwk_2.1.0.tar
Following the example above, the source directory <EXTRACT_DIR> would
be the following:
/tmp/HALsmxfwk_2.1.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.
There is one required step to install this product:
1. Install the server host packages (Contains the Console
Launcher utility)
1. Server Packages
----------------------------------------------------------------------
To install the "PrimeAlert Adapter for Frameworks" packages on the Sun
Management Center 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/HALsmxfwk_2.1.0)
# ./HALAdapterFrameworks-install.sh
The following packages are installed or upgraded:
- HALmmsfwk
- HALmmsclr
2. Server Packages (Windows)
----------------------------------------------------------------------
If you wish to use the Console Launcher utility provided with this
product on a windows host with the Sun MC Console installed, copy
the following files from the Sun Management Center host containing
the server packages, to a Windows host:
1. $ESROOT/modules/sbin/HALConsoleLauncher.bat
2. $ESROOT/modules/cfg/HALConsoleLauncher.jar
Please ensure that the files are copied to the same directory on
the Windows host. If not, the HALConsoleLauncher.bat will be unable
to locate the HALConsoleLauncher.jar and will fail to launch the
Sun MC console
Uninstallation Instructions
======================================================================
This section explains how to uninstall the PrimeAlert Adapter for
Frameworks 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:
# $ESROOT/sbin/es-uninst
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 Adapter for Frameworks 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 AdapterFrameworks 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:
HALAdapterFrameworks-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".
---//---
</pre>