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)