bb-rep.cgi - CGI front-end to bbgen reporting
bb-rep.cgi [--noclean] [bbgen-options]
bb-rep.cgi is invoked as a CGI script via the bb-rep.sh CGI wrapper.
It triggers the generation of a Xymon availability report for the
timeperiod specified by the CGI paramaters.
bb-rep.cgi is passed a QUERY_STRING environment variable with the
start-mon (Start month of the report)
start-day (Start day-of-month of the report)
start-yr (Start year of the report)
end-mon (End month of the report)
end-day (End day-of-month of the report)
end-yr (End year of the report)
style (Report style)
The following non-standard parameters are handled by the bbgen version
suburl (Page in report to go to, if not the top page)
The "month" parameters must be specified as the three-letter english
month name abbreviation: Jan, Feb, Mar ...
Start- and end-days are in the range 1..31; the start- and end-year
must be specified including century (e.g. "2003").
End-times beyond the current time are silently replaced with the
The generated report will include data for the start- and end-days,
i.e. the report will begin at 00:00:00 of the start-day, and end at
23:59:59 of the end-day.
The "style" parameter is passed directly to bbgen(1) and should be
"crit", "non-crit" or "all". Other values result in undefined
All of the processing involved in generating the report is done by
invoking bbgen(1) with the proper "--reportopts" option.
Do not clean the BBREP directory of old reports. Makes the
report-tool go a bit faster - instead, you can clean up the
BBREP directory e.g. via a cron-job.
Load the environment from FILENAME before executing the CGI.
All other options passed to bb-rep.cgi are passed on to the
bbgen(1) program building the report files.
HTML template header for the report request form
HTML template footer for the report request form
HTML template report request form
bbgen options passed by default to the bb-rep.cgi. This happens
in the bb-rep.sh wrapper.
BBHOME Home directory of the Xymon server installation
BBREP Directory where generated reports are stored. This directory
must be writable by the userid executing the CGI script,
typically "www", "apache" or "nobody". Default: $BBHOME/www/rep/
The URL prefix to use when accessing the reports via a browser.
bbgen(1), bb-hosts(5), hobbitserver.cfg(5)