======================================================================
Halcyon Monitoring Solutions
www.HalcyonInc.com
Neuron Integration for Sun Management Center
Version 1.1.4
README.install
-----------------------------------------------------------------------
Overview
======================================================================
This README.install file describes how to install and setup the
Halcyon Neuron Integration for Sun Management Center.
It consists of the following sections:
- Definitions
- Extracting the Distribution
- Installation Instructions
. Pre-Configuration for Sun Management Center Server Adapter
. Pre-Configuration for Sun Management Center Agent Adapter
. Install the Server host packages (required)
- Halcyon Forums
- Uninstallation Instructions
. Server Packages (Solaris)
- Install & Uninstall Logs
Definitions
======================================================================
Sun MC Sun Management Center
Sun MC Server The server on which the Sun Management Center
server layer is installed.
Installation Host The host where the Halcyon Neuron Integration for
Sun Management Center is to be installed.
This system must be a Solaris host, that must
already have the Halcyon Neuron Core installed
(it must have the HALhmfcon package installed).
Neuron Core The Halcyon Neuron Core is the framework that is
central to all Halcyon Neuron Integration products
as well as the Neuron Management Portal.
BASEDIR The base directory where the Halcyon Management
Core was installed. The default value is
/opt/HMF. To determine the value of BASEDIR run
the command (for Solaris 10+ zoned environment, run
the following command in a non-sparse root zone):
# echo "`pkgparam HALhmfcon BASEDIR`/HMF"
LOCALDIR The configuration and logfile directory of the
Halcyon Neuron Core. By default this is
/var/opt/HMF
To determine [LOCALDIR] after installation,
issue the command (for Solaris 10+ zoned
environment, run the following command in a
non-sparse root zone):
# pkgparam HALhmfcon LOCALDIR
Extracting the Distribution
======================================================================
The Halcyon Neuron Integration for Sun Management Center distribution
file,
Halcyon_Integration_for_Sun_Management_Center_[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
/var/tmp
In this case, the procedure for extracting the distribution will be:
% su -
# cd /var/tmp
# gzip -d Halcyon_Integration_for_Sun_Management_Center_[version].tar.gz
# tar xvf Halcyon_Integration_for_Sun_Management_Center_[version].tar
Following the example above, the source directory [EXTRACT_DIR] would
be the following:
/var/tmp/Halcyon_Integration_for_Sun_Management_Center_[version]
Installation Instructions
======================================================================
To install this product you will need to complete at least one
pre-configuration step and one installation step:
1. Pre-Configuration for Sun Management Center Server Adapter
2. Pre-Configuration for Sun Management Center Agent Adapter
3. Install the Server host packages (required)
1. Pre-Configuration for Sun Management Center Server Adapter
----------------------------------------------------------------------
If you plan to use the Sun Management Center Server Adapter, please
complete the following, otherwise skip this step:
1.1 Install PrimeAlert for Sun Management Center
--------------------------------------------------------------------
Included in this distribution is the following file:
HALSunMC_[version].tar.gz
Please extract the distribution and install it as outlined in
README.install.
1.2 Include Sun MC libraries for Integration
--------------------------------------------------------------------
The "Halcyon Neuron Sun Management Center Server Adapter" requires
the inclusion of Sun MC libraries in the Halcyon Neuron Core
library path.
To include the libraries, copy the following jar files from the Sun
MC server host ([SUNMC_INSTALL_DIR]/classes) to the library
directory (/[LOCALDIR]/lib):
esclt.jar, escom.jar, esjrm.jar, esmsg.jar
Execute the following commands to copy the required files:
On the Sun MC server host:
% su -
# cd [SUNMC_INSTALL_DIR]/classes
# cp esclt.jar escom.jar esjrm.jar esmsg.jar [COMMON_LOCATION]
On the Neuron Core host:
% su -
# cd [COMMON_LOCATION]
# cp esclt.jar escom.jar esjrm.jar esmsg.jar /var/opt/HMF/lib
NOTE: By default SUNMC_INSTALL_DIR is: /opt/SUNWsymon
NOTE: The Sun MC files will be copied over during installation
if Sun MC and Halcyon Neuron Core are installed on the
same host.
1.3 Gather required information for installation
--------------------------------------------------------------------
During the installation carried out in step 3 below, you will be
asked a series of questions to configure the adapter to talk with
the Sun MC Server. Please collect this information beforehand:
- Sun MC Server host
- Sun MC Server port
- User name and password for a Sun MC esops user
2. Pre-Configuration for Sun Management Center Agent Adapter
----------------------------------------------------------------------
If you plan to use the Sun Management Center Agent Adapter, please
complete the following otherwise skip this step:
NOTE: In order for this integration approach to work, the Sun
Management Center agents being integrated must be configured
to send traps to the Halcyon Neuron Core.
2.1 Enable Sun Management Center Agent Trap Forwarding
--------------------------------------------------------------------
On each Sun Management Center agent host, run the following:
% su -
# /[SUNMC_INSTALL_DIR]/sbin/es-trapdest -a host:port -f sunmcTraps
SUNMC_INSTALL_DIR: directory where Sun MC was installed
(default is /opt/SUNWsymon)
host: where the Halcyon Neuron Core is installed
port: port the Halcyon Neuron Core is configured to receive
SNMP traps on (default is 2162)
2.2 Gather required information for installation
--------------------------------------------------------------------
During the installation carried out in step 3 below, you will be
asked a question to configure the adapter to talk with the Sun MC
Agents. Please collect this information beforehand:
- Snmp Community String used by the Sun MC agents.
3. Install the Server host packages (required)
----------------------------------------------------------------------
To install the "Halcyon Neuron Integration for Sun Management Center"
package on a Solaris host, do the following:
1. Become the "root" user on the Solaris host
2. Extract the distribution file
3. Run the install script
4. During the installation, specify which integration you are
installing.
% su -
# cd [EXTRACT_DIR]
(i.e. /var/tmp/Halcyon_Integration_for_Sun_Management_Center_[version])
# ./Halcyon_Integration_for_Sun_Management_Center-install.sh
During installation you will receive two prompts:
Do you wish to install the Sun Management Center Server Adapter [n]:
Do you wish to install the Sun Management Center Agent Adapter [n]:
Enter either n or y for each (the default for each is no).
IMPORTANT: Ensure that the Pre-Configuration step (above) has been
done for the adapter being installed.
After the package is installed, the adapter will be deployed to the
Halcyon Neuron Core in the /[LOCALDIR]/deploy directory.
Halcyon Forums
======================================================================
Halcyon experts actively participate in the online Halcyon Forums. The
experts are constantly monitoring the forums, answering questions and
posting useful tips, tricks, and general knowledge base information.
Whether you have a technical question or just wish to expand our
knowledge base, this is the place for you.
http://forums.HalcyonInc.com
Uninstallation Instructions
======================================================================
This section explains how to uninstall the Halcyon Neuron Integration
for Sun Management Center components:
1. Uninstall Server Packages (Solaris)
In general, the uninstall script can be used with no arguments to
uninstall any Halcyon product:
# /[LCOALDIR]/uninstall/HALUninstall.sh
Uninstall Server Packages (Solaris)
----------------------------------------------------------------------
To uninstall the "Halcyon Neuron Integration for Sun Management Center"
packages on a Solaris host, do the following:
1. Become the "root" user on the Solaris host
2. Run the uninstall script with the appropriate parameters
% su -
# cd /[LOCALDIR]/uninstall
# ./HALUninstall.sh -module Integration_for_Sun_Management_Center hmf
Install & Uninstall Logs
======================================================================
All Halcyon install and uninstall log files can be found in the
following directories:
/[LOCALDIR]/install
/[LOCALDIR]/uninstall/log
Installation Log
----------------
The name of the installation log for this product is the following:
Halcyon_Integration_for_Sun_Management_Center-install_[YYYYMMDD]-[HHMMSS].log
Uninstall Log
-------------
The following is the generic uninstall log file:
uninstall.log.[YYYYMMDD]-[HHMMSS]
---//---