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

FreeBSD Manual Pages

  
 
  

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 ad-
       vance 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
       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 xy-
       mon-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)

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+14.3.quarterly>

home | help