HOBBIT-MAILACK(8) System Manager's Manual HOBBIT-MAILACK(8)
NAME
hobbit-mailack - permit acknowledging alerts via e-mail
SYNOPSIS
hobbit-mailack --env=FILENAME [--debug]
DESCRIPTION
hobbit-mailack normally runs as an input mail-filter for the hobbit user, e.g. by being called from the xymon users' procmailrc(5) file.
hobbit-mailack recognizes e-mails that are replies to hobbitd_alert(8) mail alerts, and converts the reply mail into an acknowledge message
that is sent to the Xymon system. This permits an administrator to acknowledge an alert via e-mail.
ADDING INFORMATION TO THE REPLY MAIL
By default, an acknowledgment is valid for 1 hour. If you know in advance that solving the problem is going to take longer, you can change
this by adding delay=DURATION to the subject of your mail reply or on a line in the reply message. Duration is in minutes, unless you add a
trailing 'h' (for 'hours'), 'd' (for 'days') or 'w' (for 'weeks').
You can also include a message that will show up on the status-page together with the acknowledgment, e.g. to provide an explanation for
the issue or some other information to the users. You can either put it at the end of the subject line as msg=Some random text, or you can
just enter it in the e-mail as the first non-blank line of text in the mail (a "delay=N" line is ignored when looking for the message
text).
USE WITH PROCMAIL
To setup hobbit-mailack, create a .procmailrc file in the xymon-users home-directory with the following contents:
DEFAULT=$HOME/Mailbox
LOGFILE=$HOME/procmail.log
:0
| $HOME/server/bin/hobbit-mailack --env=$HOME/server/etc/hobbitserver.cfg
USE WITH QMAIL
If you are using Qmail to deliver mail locally, you can run hobbit-mailack directly from a .qmail file. Setup the xymon-users .qmail file
like this:
| $HOME/server/bin/hobbit-mailack --env=$HOME/server/etc/hobbitserver.cfg
OPTIONS
--env=FILENAME
Load environment from FILENAME, usually hobbitserver.cfg.
--debug
Dont send a message to hobbitd, but dump the message to stdout.
SEE ALSO
hobbitd_alert(8), hobbitd(8), xymon(7)
Xymon Version 4.2.3: 4 Feb 2009 HOBBIT-MAILACK(8)