Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
XYMON-MAILACK(8)	     System Manager's Manual		XYMON-MAILACK(8)

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.  xy-
     mon-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 to-
     gether with the acknowledgment, e.g. to provide an explanation for the  is-
     sue  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.

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

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

Xymon			   Version 4.3.30:  4 Sep 2019		XYMON-MAILACK(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=xymon-mailack&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help