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

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

NAME

       bb-findhost.cgi - Xymon CGI script to find hosts

SYNOPSIS

       bb-findhost.cgi?host=REGEX

DESCRIPTION

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

       bb-findhost.cgi is passed a QUERY_STRING environment variable with the "host=REGEX" parameter. The REGEX is a Posix regular expression (see
       regex(7) ) describing the hostnames to look for.  A trailing wildcard is assumed on all hostnames - e.g. requesting the hostname "www" will
       match any host whose name begins with "www".

       It then produces a single web page, listing all of the hosts that matched any of the hostnames, with links to the Xymon webpages where they
       are located.

       The output page lists hosts in the order they appear in the bb-hosts(5) file.

       A sample web page implementing the search facility is included with bbgen, you access it via the URL /bb/help/bb-findhost.html.

OPTIONS

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

FILES

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

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

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

ENVIRONMENT VARIABLES

       BBHOSTS
	      bb-findhost.cgi uses the BBHOSTS environment variable to find the bb-hosts file listing all known hosts and their page locations.

       BBHOME Used to locate the template files for the generated web pages.

SEE ALSO

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

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

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)