Halcyon Neuron Agent for Tru64
                             Version 2.0.0

                             README.install
-----------------------------------------------------------------------

Installation Instructions
=========================

Definitions
-----------

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".


Agent Host          A host where a Neuron Agent is installed and
                    running. This host must be a Tru64 host, and it
                    contains the package HALpialag.


Requirements
------------

This agent has been tested on:

    OSF V4.0F (aka Tru64 V4.0F)

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.


Extracting the Distribution File
--------------------------------

The Neuron Agent for Tru64 distribution file,
HALNeuronTru64_[version].tar.(Z|gz), must be extracted on a Tru64 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 -
  # mkdir -p /tmp/install
  # cd /tmp/install
  # uncompress HALNeuronTru64_[version].tar.Z
    or gzip -d HALNeuronTru64_[version].tar.gz
  # tar xvf HALNeuronTru64_[version].tar

In this case, the directory /tmp/install/HALNeuronTru64_[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
Tru64 host that is being upgraded to the latest version of the
Neuron Agent for Tru64, or that is receiving the Neuron Agent for 
Tru64 for the first time.

Login to a Tru64 host as root. Extract the Neuron Agent for Tru64
distribution file (see the above section 'Extracting the Distribution
File') in a temporary location, and then run the script
HALNeuronTru64-install.sh, e.g.:

  $ su -
  # cd [SOURCE_DIR]
  # ./HALNeuronTru64-install.sh -n

The following kits are installed or upgraded by the installation
script:

  - HALNIATAG
  - HALNMAEVT
  - HALNMAHTP
  - HALNMASTA
  - HALNMAMIB
  - HALNMAAST
  - HALNMADIR
  - HALNMAFIL
  - HALNMALOG
  - HALNMAPRC
  - HALNMARRD
  - HALNMARPT
  - HALNMAWEB
  - HALNMAKIT

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 Tru64.

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 "pa" 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 a Tru64 host, see the file:

  $PADIR/install/HALNeuronTru64-install_[YYYYMMDD]-[HHMMSS].log


Uninstallation Instructions
===========================

NOTE:  Before removing the Neuron Agent for Tru64, first remove all
       modules that are installed on the host.


First, stop the Neuron Agent for Tru64 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 removes the following packages:

  - HALNIATAG
  - HALNMAEVT
  - HALNMAHTP
  - HALNMASTA
  - HALNMAMIB
  - HALNMAAST
  - HALNMADIR
  - HALNMAFIL
  - HALNMALOG
  - HALNMAPRC
  - HALNMARRD
  - HALNMARPT
  - HALNMAWEB
  - HALNMAKIT


Uninstallation Log File
-----------------------

To view the uninstallation log on a Tru64 host, see the file:

  $PADIR/uninstall/log/uninstall.log.[YYYYMMDD]-[HHMMSS]

---//---
</pre>