======================================================================
Halcyon Monitoring Solutions
www.HalcyonInc.com
Neuron Integration for IBM Tivoli
Version 1.1.2
README.install
======================================================================
Overview
======================================================================
This README.install file describes how to install and setup the
Halcyon Neuron Integration for IBM Tivoli.
It consists of the following sections:
- Definitions
- Extracting the Distribution File
- Installation Instructions
. Server Packages (Solaris)
- Halcyon Forums
- Uninstallation Instructions
. Server Packages (Solaris)
- Install & Uninstall Logs
Definitions
======================================================================
Installation Host The host where the Neuron Integration for IBM
Tivoli is to be installed. This system must
be a Solaris host, and contain the package
HALhmfcon (this is the system where the Halcyon
Neuorn Core is 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.
Neuron Event The Neuron Event Manager is a web-based interface
Manager for creating and managing Rules. Rules consist
of user defined event filters, automated actions
and schedules and are meant to allow specific
actions to be taken when specific events are
received by the Neuorn Core.
BASEDIR The base directory where the Halcyon Neuron 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 File
======================================================================
The Neuron Integration for IBM Tivoli distribution file,
Halcyon_Integration_for_IBM_Tivoli_[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_IBM_Tivoli_[version].tar.gz
# tar xvf Halcyon_Integration_for_IBM_Tivoli_[version].tar
Following the example above, the source directory [EXTRACT_DIR] would
be the following:
/var/tmp/Halcyon_Integration_for_IBM_Tivoli_[version]
Installation Instructions
======================================================================
There is one step required to install this product:
1. Install the Server host packages
Server Packages (Solaris)
----------------------------------------------------------------------
To install the "Neuron Integration for IBM Tivoli" 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
% su -
# cd [EXTRACT_DIR]
(i.e. /var/tmp/Halcyon_Integration_for_IBM_Tivoli_[version])
# ./Halcyon_Integration_for_IBM_Tivoli-install.sh
After the package is installed, the module will be deployed to the
Halcyon Neuron Core in the [LOCALDIR]/deploy directory.
4. Copy the Tivoli "postemsg" binary into [LOCALDIR]/bin.
Alternatively, you can create a softlink within [LOCALDIR]/bin
to the postemsg binary.
5. The Tivoli baroc file for the Neuron Integration for IBM Tivoli is
[BASEDIR]/conf/module/TivoliAdapter.baroc
where [BASEDIR] is typically /opt/HMF
Configuration details will have been asked during installation, but
the Neuron Integration for IBM Tivoli can also be configured
manually. Please refer to the README.config file for instructions.
NOTE: These configuration details are simply default values. To use
the integration solution, Rules and Actions must be setup
within Neuron Event Manager indicating when and which events
should be sent to IBM Tivoli. If no configuration is provided
with the action, these configured defaults will be used.
For more information on setting up these Rules and Actions,
please refer to the Neuron Event Manager documentation.
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 Neuron Integration for IBM
Tivoli components:
1. Uninstall the Server host packages
In general, the uninstall script can be used with no arguments to
uninstall any Halcyon product:
# [LOCALDIR]/uninstall/HALUninstall.sh
Uninstall Server Packages (Solaris)
----------------------------------------------------------------------
To uninstall the "Neuron Integration for IBM Tivoli" 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_IBM_Tivoli 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_IBM_Tivoli-install_[YYYYMMDD]-[HHMMSS].log
Uninstall Log
-------------
The following is the generic uninstall log file:
uninstall.log.[YYYYMMDD]-[HHMMSS]
---//---