<PRE>
Halcyon PrimeAlert (R) Neuron Agent for IBM AIX
Version 3.0.0
README.install
-----------------------------------------------------------------------
Installation Instructions
=========================
Definitions
-----------
Agent Host: The host where the PrimeAlert Neuron Agent for IBM
AIX is installed and running. This host must be an
IBM AIX host, and it contains the package HALniaagt.
PAROOT This environment variable contains the directory
where the agent binaries, libraries and default
configuration files are installed. The value of
PAROOT is "/opt/Neuron".
PADIR This environment variable contains the directory
where the agent stores configuration and log files.
The value of PADIR is "/var/opt/Neuron".
Requirements
------------
1) This agent has been tested on:
IBM AIX 5.2-6.1
Note: Halcyon officially supports the versions listed above as the
product was tested against these versions. It is possible
that the product may function correctly with other versions.
2) The following filesets must be installed in order to use the
PrimeAlert for SystemMonitor module:
bos.perf.libperfstat
bos.perf.perfstat
3) If you wish to integrate the Neuron Agent with the Neuron Core, you must have:
Java 1.5 or higher
Note: The Neuron Core is the central event integration component and is
bundled with the Neuron Integration.
For more information visit: http://www.HalcyonInc.com
Extracting the Distribution File
--------------------------------
The PrimeAlert Neuron Agent for IBM AIX distribution file,
HALNeuronAIX_[version].tar.(Z|gz), must be extracted on an IBM AIX host
before any packages can be installed. For example, assume that the
distribution file has been copied to the /tmp/install directory, and
will be extracted there. In this case, the procedure for extracting
the distribution file is:
% su -
# cd /tmp/install
# gzip -d HALNeuronAIX_[version].tar.gz
# tar xvf HALNeuronAIX_[version].tar
In this case, the directory /tmp/install/HALNeuronAIX_[version]
represents the installation source directory, [SOURCE_DIR], which
is referenced below.
Installing the Agent
--------------------
The procedure described in this sub-section should be performed on
any IBM AIX host that is being upgraded to the latest version of the
PrimeAlert Neuron Agent for IBM AIX, or that is receiving the PrimeAlert
Neuron Agent for IBM AIX for the first time.
Login to an IBM AIX host as root. Extract the Neuron Agent for IBM AIX
distribution file (see the above section 'Extracting the Distribution
File') in a temporary location, and then run the script
HALNeuronAIX-install.sh, e.g.:
% su -
# cd [SOURCE_DIR]
# ./HALNeuronAIX-install.sh -n
During installation, you are requested to enter the following
information:
- HTTP Port: The HTTP Port used by the agent. The default value
is 6680.
- Agent Port: The SNMP port used by the agent. The default
value is 6681.
- SNMP manager host/port: If you elect to send SNMP traps to
a manager, you will be prompted for the hostname and port of
a machine which will receive an SNMP trap for each agent event.
See the README file for an explanation of events.
- Module setup: If you elect to setup modules, the module loader
utility will start and you will be given a menu with options to
load, unload or edit modules. See the README file for further
details.
After the previous information has been provided, the install script
modifies the following configuration files:
$PADIR/cfg/domain-config.x
$PADIR/cfg/HALEventTarget-config.x
These files are the main configuration files for your Neuron Agent.
Finally, the install script displays some information on additional
shell scripts that can be used to start, stop, or inquire about the
status of the Neuron Agent for IBM AIX.
At this stage, the installation of the Neuron Agent component is
complete. No host reboot is required. If you have upgraded the agent
or any of its bundled modules, the agent must be restarted. For an
initial install, the agent must simply be started. The "na" script
controls the agent. Use the following commands to control the agent:
- na start agent: Starts the Neuron Agent.
- na stop agent: Stops the Neuron Agent.
- na restart agent: Restarts the Neuron Agent (stop and start).
- na status agent: Prints the status of the Neuron Agent
(is the agent running or not).
The shell script can be found in $PAROOT/bin.
Installation Log File
---------------------
To view the installation log on an IBM AIX host, see the file:
$PADIR/install/HALNeuronAIX-install_<YYYYMMDD>-<HHMMSS>.log
Uninstallation Instructions
===========================
NOTE: Before removing the Neuron Agent for IBM AIX, first remove all
modules that are installed on the host.
First, stop the Neuron Agent for IBM AIX process on the agent host
by issuing the following commands as root:
$ su -
# cd $PAROOT/bin
# ./na stop agent
Then, issue the following commands to uninstall the agent:
# cd $PADIR/uninstall
# ./HALUninstall.sh
Uninstallation Log File
-----------------------
To view the uninstallation log on an IBM AIX host, see the file:
$PADIR/uninstall/log/uninstall.log.<YYYYMMDD>-<HHMMSS>
---//---
</PRE>