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