HP OpenView HPOV Event Handler

Project Notes

''This HPOV Event Handler takes the output of a Nagios monitoring system and feeds it into HP OpenView.

Additional requirements: these instructions assume Monarch or GroundWork Monitor Open Source is installed (either is readily downloadable from SourceForge). If you come up with a generalized procedure that works with generic Nagios please feel free to inform us and post it as well.

==========================================

The eventhandler will call the Openview command 'opcmsg' which has the following syntax:

/opt/OV/bin/OpC/opcmsg node= application= object= msg_text= severity= msg_grp=

> should be the fully qualified node name (xyz.Company.COM)
> and can be set depending on the type of message to be sent - maybe from the profile or type of check that produced the result
> should be the full text of the message (enclosed in ")
> should be set to GWMP or something unique

To keep these separate, GWMP is a new message group, so it is easy to capture/filter the events on the Openview side..

Definition for Global Host Event Handler
/usr/local/groundwork/nagios/eventhandlers/hpov_eventhandler.pl host $LASTHOSTCHECK$ "$HOSTNAME$" "$HOSTSTATE$" "$HOSTOUTPUT$"

Definition for Global Service Event Handler
/usr/local/groundwork/nagios/eventhandlers/hpov_eventhandler.pl service $LASTSERVICECHECK$ "$HOSTNAME$" "$SERVICESTATE$" "$SERVICEOUTPUT$" "$SERVICEDESC$"

Here are the instructions for installing the hpov event handler. These instructions assume you're using Monarch (downloadable from SourceForge) with Nagios (both Monarch and Nagios are integrated in GroundWork Monitor Open Source, which is also downloadable from SourceForge.)

1. Copy the file hpov_eventhandler.pl to /usr/local/groundwork/nagios/eventhandlers/ on the production system.

2. Define the command to be used for the host global event handler.

1. In Monarch, Commands, add a command with name "hpov_host_eventhandler".
2. The command line should be:

/usr/local/groundwork/nagios/eventhandlers/hpov_eventhandler.pl host $LASTHOSTCHECK$ "$HOSTNAME$" "$HOSTSTATE$" "$HOSTOUTPUT$"

1. The command type should be "other".

2. Define the command to be used for the service global event handler.

1. In Monarch, Commands, add a command with name "hpov_service_eventhandler".

1. The command line should be:

/usr/local/groundwork/nagios/eventhandlers/hpov_eventhandler.pl service $LASTSERVICECHECK$ "$HOSTNAME$" "$SERVICESTATE$" "$SERVICEOUTPUT$" "$SERVICEDESC$"

1. The command type should be "other".

3. Modify Nagios main config to enable the eventhandlers. Make the following changes in Monarch, Control, Nagios.cfg edit:

1. Enable eventhandlers.
2. Set the Global Host Eventhandler to hpov_host_eventhandler. This should be in the dropdown list.
3. Set the Global Service Eventhandler to hpov_service_eventhandler. This should be in the dropdown list.
4. Commit the changes to Nagios.

If you need to debug, you can look at the log file /usr/local/groundwork/nagios/eventhandlers/hpov.log for the opcmsg commands.''