Configuration Plugin Alarmprogram

This plugin contains multiple modules. Informix itself triggers several events to call the alarmprogram configured in the onconfig file (ALARMPROGRAM / SYSALARMPROGRAM)

The plugin requires a small customization on the server itself. Prerequisites are that the components wget and md5sum are installed.

The plugin uses a shell script, which is inserted into the alarmprogram.sh or evidence.sh.
Check whether the ALARMPROGRAM or SYSALARMPROGRAM parameter points to these scripts. If this is not the case, the insertion must be installed in the corresponding script to which these variables points.
Wget is used to send the event to a URL of the admin scout. It checks whether this event should trigger an e-mail alarm or not. If this is the case, a mail is sent to the configured addresses.

For installation, a directory 'cursor' must be created on the server in $INFORMIXDIR. The user informix must have full rights (775) in this directory. The script push_alarm.sh has to be stored there. This script can be found on a Samba share of the scout \\<name or IP of the scout>\adminfiles\admin-plugin-files. It must be executable for informix.

In the $INFORMIXDIR/etc/alarmprogram.sh, the following entry must be made at the beginning:

$INFORMIXDIR/cursor/push_alarm.sh "$1" "$2" "$3" "$4" "$5" "$6"

you need a similar configuration in SYSALARMPROGRAM $INFORMIXDIR/etc/evidence.sh

$INFORMIXDIR/cursor/push_alarm.sh "$1" "$2" "$3" "$4" "$5" "$6" "$7" "$8" "$9" "$(10)" "$(11)" "$(12)"

The Script push_alarm.sh is very simple. It uses just a few system commands. Required is md5sum and wget. There are platforms such as AIX, where not all the parameters of the hostname command are available. Alternatively, the hostname can be entered as a string (for `hostname -f`) or the IP address of the machine (for hostname -I) instead of the hostname call. Instead of:

HOSTNAME=`hostname -f`
IPS=`hostname -i`

will be changed to

HOSTNAME=myhostname
IPS=172.16.0.67

If you are not sure whether the commands work, check whether hostname -f is the fully qualified hostname and hostname -i is the IP of the machine. If this is not the case, these values must be entered in the script as described.

The second step - the configuration of the address of the Admin-Scout - can alternatively be done in two ways.

Installation of the Sensor 'Configuration Sensor for alarm program and sysalarm program Plugin'
This sensor writes the configuration file to $INFORMIXDIR/cursor - The name of the admin scout (or its IP) is set in the parameter of the sensor.
You create a $ INFORMIXSERVER.conf file in the $INFORMIXDIR/cursor directory. The file must contain one line: TO_HOST = <cursor-scout-networkname or IP>

In order to determine which events a mail should be sent, you can set it in the General configuration for each event class whether mail is sent or not. Select the correct server from the list above the list. The configuration is stored per server. A set hacking means mailing takes place.

You can get an overview of all generated events in the ICC under 'Reports-> Alarmprogramreport'

Event entries older than 100 days are automatically deleted.

back