bionic (8) xymon-mailack.8.gz

Provided by: xymon_4.3.28-3build1_amd64 bug

NAME

       xymon-mailack - permit acknowledging alerts via e-mail

SYNOPSIS

       xymon-mailack --env=FILENAME [--debug]

DESCRIPTION

       xymon-mailack  normally  runs  as  an input mail-filter for the xymon user, e.g. by being called from the
       xymon users' procmailrc(5) file. xymon-mailack recognizes e-mails that  are  replies  to  xymond_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 xymon-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/xymon-mailack --env=$HOME/server/etc/xymonserver.cfg

USE WITH QMAIL

       If  you  are  using Qmail to deliver mail locally, you can run xymon-mailack directly from a .qmail file.
       Setup the xymon-users .qmail file like this:

              | $HOME/server/bin/xymon-mailack --env=$HOME/server/etc/xymonserver.cfg

OPTIONS

       --env=FILENAME
              Load environment from FILENAME, usually xymonserver.cfg.

       --debug
              Don't send a message to xymond, but dump the message to stdout.

SEE ALSO

       xymond_alert(8), xymond(8), xymon(7)