HOBBITCGI.CFG(5) File Formats Manual HOBBITCGI.CFG(5)NAME
hobbitcgi.cfg - Command-line parameters for the Xymon CGI tools
SYNOPSIS
$BBHOME/etc/hobbitcgi.cfg
DESCRIPTION hobbitcgi.cfg(1) controls the commandline options passed to all of the Xymon CGI tools through their respective shell-script wrappers. Typ-
ically the options listed here are used for system-wide configuration of the CGI utilities, e.g. to define where they read configuration
files.
The exact set of commandline options available are described in the man-page for each of the CGI utilities.
The file is "sourced" into the shell script wrapper, so assignments to the CGI-specific variables must follow standard shell-script syntax.
SETTINGS
CGI_ACKINFO_OPTS
Options for the hobbit-ackinfo.cgi(1) utility.
CGI_ACK_OPTS
Options for the bb-ack.cgi(1) utility.
CGI_CSVINFO_OPTS
Options for the bb-csvinfo.cgi(1) utility.
CGI_DATEPAGE_OPTS
Options for the bb-datepage.cgi(1) utility.
CGI_ENADIS_OPTS
Options for the hobbit-enadis.cgi(8) utility.
CGI_EVENTLOG_OPTS
Options for the bb-eventlog.cgi(1) utility.
CGI_FINDHOST_OPTS
Options for the bb-findhost.cgi(1) utility.
CGI_HIST_OPTS
Options for the bb-hist.cgi(1) utility.
CGI_HOBBITCOLUMN_OPTS
Xymon-specific options for column documentation. This uses the bb-csvinfo.cgi(1) utility with the server/etc/columndoc.cfg configu-
ration file.
CGI_HOBBITCONFREPORT_OPTS
Options for the hobbit-confreport.cgi(1) utility.
CGI_HOBBITGRAPH_OPTS
Options for the hobbitgraph.cgi(1) utility.
CGI_HOSTGRAPHS_OPTS
Options for the hobbit-hostgraphs.cgi(1) utility.
CGI_NKEDIT_OPTS
Options for the hobbit-nkedit.cgi(1) utility.
CGI_NKVIEW_OPTS
Options for the hobbit-nkview.cgi(1) utility.
CGI_REPLOG_OPTS
Options for the bb-replog.cgi(1) utility.
CGI_REP_OPTS
Options for the bb-rep.cgi(1) utility.
CGI_SNAPSHOT_OPTS
Options for the bb-snapshot.cgi(1) utility.
CGI_SVCHIST_OPTS
Options for the hobbitsvc.cgi(1) utility when used to view historical logs. Note that the "--historical" option must be included in
this setting.
CGI_SVC_OPTS
Options for the hobbitsvc.cgi(1) utility.
SEE ALSO xymon(7), the individual CGI utility man-pages.
Xymon Version 4.2.3: 4 Feb 2009 HOBBITCGI.CFG(5)
Check Out this Related Man Page
HOBBIT-STATUSREPORT.CGI(1) General Commands Manual HOBBIT-STATUSREPORT.CGI(1)NAME
hobbit-statusreport.cgi - CGI program to report a status for a group of servers
SYNOPSIS
hobbit-statusreport.cgi --column=COLUMNNAME [options]
DESCRIPTION
hobbit-statusreport.cgi is a CGI tool to generate a simple HTML report showing the current status of a single column for a group of Xymon
hosts.
E.g. You can use this report to get an overview of all of the SSL certificates that are about to expire.
The generated webpage is a simple HTML table, suitable for copying into other documents or e-mail.
hobbit-statusreport.cgi runs as a CGI program, invoked by your webserver. It is normally run via a wrapper shell-script in the CGI direc-
tory for Xymon.
EXAMPLES
The Xymon installation includes two web report scripts using this CGI tool: The hobbit-certreport.sh script generates a list of SSL server
certificates that are yellow or red (i.e. they will expire soon); and the hobbit-nongreen.sh script generates a report of all statuses that
are currently non-green. These can be accessed from a web browser through a URL referencing the script in the Xymon CGI directory (e.g.
"/xymon-cgi/xymon-nongreen.sh").
OPTIONS --column=COLUMNNAME
Report the status of the COLUMNNAME column.
--all Report the status for all hosts known to Xymon. By default, this tool reports only on the hosts found on the current page from where
the CGI was invoked (by looking at the "pagepath" cookie).
--filter=CRITERIA
Only report on statuses that match the CRITERIA setting. See the bb(1) man-page - in the "hobbitdboard" command description - for
details about specifying filters.
--heading=HTML
Defines the webpage heading - i.e. the "title" tag in the generated HTML code.
--show-column
Include the column name in the display.
--show-colors
Show the status color on the generated webpage. The default is to not show the status color.
--no-colors
Do not include text showing the current color of each status in the report. This is the default.
--show-summary
Show only a summary of the important lines in the status message. By default, the entire status message appears in the generated
HTML code. This option causes the first non-blank line of the status message to be shown, and also any lines beginning with "&COLOR"
which is used by many status messages to point out lines of interest (non-green lines only, though).
--show-message
Show the entire message on the webpage. This is the default.
--link Include HTML links to the host "info" page, and the status page.
--embedded
Only generate the HTML table, not a full webpage. This can be used to embed the status report into an external webpage.
--env=FILENAME
Load the environment from FILENAME before executing the CGI.
--area=NAME
Load environment variables for a specific area. NB: if used, this option must appear before any --env=FILENAME option.
SEE ALSO xymon(7)Xymon Version 4.2.3: 4 Feb 2009 HOBBIT-STATUSREPORT.CGI(1)