======================================================================
                     Halcyon Monitoring Solutions
                          www.HalcyonInc.com

                     Neuron EventAction Converter
                            Version 1.16.0

                      README.EventActionConverter 
======================================================================



Overview
======================================================================
The Halcyon Neuron EventAction Converter utility can be used to
convert an existing PrimeAlert EventAction dat file to a rule file
that the Neuron Management Suite can use in order to process incoming
events.

Alternatively, if you have the Halcyon Neuron Event Manager, you
can import EventAction dat files via its UI.  Please refer to
NeuronEventManager_[VERSION]_UsersGuide.pdf.



Definitions
======================================================================
BASEDIR     The base directory where the Halcyon Neuron Management
            Suite was installed. The default value is /opt/HMF. To
            determine the value of BASEDIR, run one of the following
            commands:

            On a Solaris host (for Solaris 10+ zoned environment,
            this must be a non-sparse root zone):

                # pkgparam HALhmfcom BASEDIR

            On a Linux host:

                # rpm -q --queryformat '%{INSTPREFIXES}\n' HALhmfcom

LOCALDIR    The configuration and logfile directory of the Halcyon
            Neuron Management Suite. By default this is /var/opt/HMF.
            To determine LOCALDIR, run on of the one of the following
            commands:

            On a Solaris host (for Solaris 10+ zoned environment,
            this must be a non-sparse root zone):

                # pkgparam HALhmfcom LOCALDIR

            On a Linux host:

                # cat [BASEDIR]/globalInstallVariables | grep LOCALDIR



Executing the Halcyon Neuron EventAction Converter
======================================================================
To convert an existing PrimeAlert EventAction rule file, do the
following as root on the host where Neuron Management Suite is
installed:

   % su -
   # [BASEDIR]/bin/EventActionConverter -in [in] -out [out]

Where:

   - in: The PrimeAlert EventAction rule file. This is usually 
         /var/opt/SUNWsymon/cfg/HALEventAction.dat

   - out: A temporary rule file for the converted EventActions.
          This could be:
             /var/opt/HMF/conf/service/TempRuleFile.drl

To actually import the converted rules into Halcyon Neuron Management
Suite, execute the RuleImport utility as follows:

   % su -
   # [BASEDIR]/bin/RuleImporter -user [USER]
       -ruleBase EventManager -ruleFile [out file from above]
       -languageFile [dsl file]

   where USER is the Neuron Management Suite username. The utility
   will ask for the user's password. See section 4 User Management
   of the Neuron Management Server User's Guide for information on
   how to set up users.

Where:

   - ruleFile: The "out" file specified above, such as:
       /var/opt/HMF/conf/EventManager/TempRuleFile.drl 

   - languageFile: The rule's language file, which should be:
       /var/opt/HMF/conf/service/EventManager.dsl


Neuron Management Suite will use the updated rule file immediately.


NOTE 1: The rules in an existing Neuron Management Suite rule file
        (i.e. EventManager.drl) will be lost if you specify that
        file as the [out] for the EventActionConverter.

NOTE 2: If the rules already exist in Neuron Management Suite import
        of the rule file will fail.

NOTE 3: Not every feature of PrimeAlert EventAction can be used in
        Neuron Management Suite.  The conversion utility will display
        information about those unsupported features.


---//---