Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

bb-ack.cgi(1) [debian man page]

BB-ACK.CGI(1)						      General Commands Manual						     BB-ACK.CGI(1)

NAME

       bb-ack.cgi - Xymon CGI script to acknowledge alerts

SYNOPSIS

       bb-ack.cgi?ACTION=action&NUMBER=acknum&DELAY=validity&MESSAGE=text

DESCRIPTION

       bb-ack.cgi is invoked as a CGI script via the bb-ack.sh CGI wrapper.

       bb-ack.cgi is passed a QUERY_STRING environment variable with the ACTION, NUMBER, DELAY and MESSAGE parameters.

PARAMETERS

       ACTION is the action to perform. The only supported action is "Ack" to acknowledge 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 contact you about the problem, or inform them when the problem is expected to be resolved.

OPTIONS

       --no-pin
	      bb-ack.cgi normally requires the user to enter the acknowledgment code received in an alert message. If you run it with this option,
	      the user will instead get a list of the current non-green statuses, and he may send an acknowledge without knowing the code.

       --no-cookies
	      Normally,  bb-ack.cgi uses a cookie sent by the browser to initially filter the list of hosts presented. If this is not desired, you
	      can turn off this behaviour by calling bb-ack.cgi with the --no-cookies option. This would normally be placed  in  the  CGI_ACK_OPTS
	      setting in hobbitcgi.cfg(5)

       --env=FILENAME
	      Loads the environment defined in FILENAME before executing the CGI script.

       --debug
	      Enables debugging output.

FILES

       $BBHOME/web/acknowledge_header
	      HTML header file for the generated web page

       $BBHOME/web/acknowledge_footer
	      HTML footer file for the generated web page

       $BBHOME/web/acknowledge_form
	      Query form displayed when bb-ack.cgi is called with no parameters.

ENVIRONMENT VARIABLES

       BBHOME 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 acknowledgment page if this is accessed from the primary page in which they
       are defined. 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

       bbgen(1), bb-hosts(5), hobbitserver.cfg(5)

Xymon							    Version 4.2.3:  4 Feb 2009						     BB-ACK.CGI(1)

Check Out this Related Man Page

BB-SNAPSHOT.CGI(1)					      General Commands Manual						BB-SNAPSHOT.CGI(1)

NAME

       bb-snapshot.cgi - CGI program to rebuild the Xymon webpages for a specific point in time.

SYNOPSIS

       bb-snapshot.cgi

DESCRIPTION

       bb-snapshot.cgi	is  invoked as a CGI script via the bb-snapshot.sh CGI wrapper.  It rebuilds the Xymon web pages to the look they had at a
       particular point in time, based upon the historical information logged about events.

       bb-snapshot.cgi is passed a QUERY_STRING environment variable with the following parameters:

	  mon (Start month of the snapshot)
	  day (Start day-of-month of the snapshot)
	  yr  (Start year of the snapshot)
	  hour (Start hour of the snapshot)
	  min  (Start minute of the snapshot)
	  sec  (Start second of the snapshot)

       The "month" parameters must be specified as the three-letter english month name abbreviation: Jan, Feb, Mar ...

       "day" must be in the range 1..31; "yr" must be specified including century (e.g. "2003"). "hour" must be specified using a 24-hour clock.

       All of the processing involved in generating the report is done by invoking bbgen(1) with the proper "--snapshot" option.

OPTIONS

       --env=FILENAME
	      Load environment from FILENAME before executing the CGI.

       bbgen-options
	      All options except "--env" are passed on to the bbgen(1) program building the snapshot files.

ENVIRONMENT VARIABLES

       BBGENSNAPOPTS
	      bbgen options passed by default to the bb-snapshot.cgi script.  This happens in the bb-snapshot.sh CGI wrapper script.

       BBHOME Home directory of the Xymon server files

       BBSNAP Directory where generated snapshots are stored. This directory must be writable by the userid executing the  CGI	script,  typically
	      "www", "apache" or "nobody". Default: $BBHOME/www/snap/

       BBSNAPURL
	      The URL prefix to use when accessing the reports via a browser.  Default: $BBWEB/snap

SEE ALSO

       bbgen(1), bb-hosts(5), hobbitserver.cfg(5)

Xymon							    Version 4.2.3:  4 Feb 2009						BB-SNAPSHOT.CGI(1)
Man Page