ACKNOWLEDGE.CGI(1) General Commands Manual ACKNOWLEDGE.CGI(1) NAME acknowledge.cgi - Xymon CGI script to acknowledge alerts SYNOPSIS acknowledge.cgi?ACTION=action&NUMBER=acknum&DELAY=validity&MESSAGE=text DESCRIPTION acknowledge.cgi is invoked as a CGI script via the acknowledge.sh CGI wrap- per. acknowledge.cgi is passed a QUERY_STRING environment variable with the AC- TION, NUMBER, DELAY and MESSAGE parameters. PARAMETERS ACTION is the action to perform. The only supported action is "Ack" to ac- knowledge an alert. NUMBER is the number identifying the host/service to be acknowledged. It is included in all alert-messages sent out by Xymon. DELAY is the time (in minutes) that the acknowledge is valid. MESSAGE is an optional text which will be shown on the status page while the acknowledgment is active. You can use it to e.g. tell users not to con- tact you about the problem, or inform them when the problem is expected to be resolved. OPTIONS --no-pin acknowledge.cgi normally requires the user to enter the acknowledg- ment code received in an alert message. If you run it with this op- tion, the user will instead get a list of the current non-green sta- tuses, and he may send an acknowledge without knowing the code. --no-cookies Normally, acknowledge.cgi uses a cookie sent by the browser to ini- tially filter the list of hosts presented. If this is not desired, you can turn off this behaviour by calling acknowledge.cgi with the --no-cookies option. This would normally be placed in the CGI_ACK_OPTS setting in cgioptions.cfg(5) --env=FILENAME Loads the environment defined in FILENAME before executing the CGI script. --debugEnables debugging output. FILES $XYMONHOME/web/acknowledge_header HTML header file for the generated web page $XYMONHOME/web/acknowledge_footer HTML footer file for the generated web page $XYMONHOME/web/acknowledge_form Query form displayed when acknowledge.cgi is called with no parame- ters. ENVIRONMENT VARIABLES XYMONHOME Used to locate the template files for the generated web pages. QUERY_STRING Contains the parameters for the CGI script. BUGS When using alternate pagesets, hosts will only show up on the acknowledg- ment page if this is accessed from the primary page in which they are de- fined. So if you have hosts on multiple pages, they will only be visible for acknowledging from their main page which is not what you would expect. SEE ALSO xymongen(1), hosts.cfg(5), xymonserver.cfg(5) Xymon Version 4.3.30: 4 Sep 2019 ACKNOWLEDGE.CGI(1)
NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | OPTIONS | FILES | ENVIRONMENT VARIABLES | BUGS | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=acknowledge.cgi&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>