======================================================================
Halcyon Monitoring Solutions
www.HalcyonInc.com
Neuron Integration for Sun Ops Center
Version 1.8.0
README.install
======================================================================
Overview
======================================================================
This README.install file describes how to install and setup the
Neuron Integration for Sun Ops Center.
It consists of the following sections:
- Definitions
- Extracting the Distribution File
- Installation Instructions
. Setup Sun Ops Center Integration User
. Collect Sun Ops Center configuration information
. Install Server Host Packages (Solaris)
- Halcyon Forums
- Uninstallation Instructions
. Server Packages (Solaris)
- Install & Uninstall Logs
Definitions
======================================================================
Installation Host The host where the Neuron Integration for Sun Ops
Center is to be installed. This system must be
a Solaris host, and contain the package HALhmfcon
(this is the system where the Halcyon Neuron 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 Sun Ops Center distribution file,
Halcyon_Integration_for_Sun_Ops_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_Ops_Center_[version].tar.gz
# tar xvf Halcyon_Integration_for_Sun_Ops_Center_[version].tar
Following the example above, the source directory [EXTRACT_DIR] would
be the following:
/var/tmp/Halcyon_Integration_for_Sun_Ops_Center_[version]
Installation Instructions
======================================================================
There are three steps required to install this product:
1. Setup Sun Ops Center Integration User
2. Collect Sun Ops Center configuration information
3. Install the Server Host Packages
1. Setup Sun Ops Center Integration User
----------------------------------------------------------------------
In order to receive notifications from Sun Ops Center, an existing
Sun Ops Center user must be specified during the installation of the
Sun Ops Center Integration. Please follow the "Pre-Configuration:
Create Sun Ops Center Integration User" instructions located in the
README.config file (in the same directory as this file).
2. Collect Sun Ops Center configuration information
----------------------------------------------------------------------
During the installation of the Halcyon Neuron Integration for Sun
Ops Center, you will be asked for the following pieces of Sun Ops
Center configuration information:
- Integration username and password (as setup in step 1 above).
- Sun Ops Center JMX server and connection port.
If you do not know what the host or port values should be,
please consult your Sun Ops Center admin.
NOTE: The port should be in the cacao.properties file
under com.sun.cacao.jmxmp.connector.port.
The default location of this file is:
/etc/cacao/instances/default/private
Please have the above details ready before continuing with the next
step.
3. Install Server Host Packages (Solaris)
----------------------------------------------------------------------
To install the "Halcyon_Integration_for_Sun_Ops_Center" packages
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_Sun_Ops_Center_[version])
# ./Halcyon_Integration_for_Sun_Ops_Center-install.sh
Configuration details will have been asked during installation,
but the Neuron Integration for Sun Ops Center can also be
configured manually. Please refer to the README.config file
for instructions.
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 Sun
Ops Center:
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 Sun Ops 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_Ops_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_Ops_Center-install_[YYYYMMDD]-[HHMMSS].log
Uninstall Log
-------------
The following is the generic uninstall log file:
uninstall.log.[YYYYMMDD]-[HHMMSS]
---//---