Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

hobbit-statusreport.cgi(1) [debian 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)

Check Out this Related Man Page

HOBBIT-HOSTGRAPHS.CGI(1)				      General Commands Manual					  HOBBIT-HOSTGRAPHS.CGI(1)

NAME

       hobbit-hostgraphs.cgi - CGI program to show multiple graphs

SYNOPSIS

       hobbit-hostgraph.cgi

DESCRIPTION

       hobbit-hostgraph.cgi is invoked as a CGI script via the hobbit-hostgraph.sh CGI wrapper.

       If no parameters are provided when invoked, it will present a form where the user can select a time period, one or more hosts, and a set of
       graphs.

       The parameters selected by the user are passed to a second invocation of hobbit-hostgraph.cgi, and result in a webpage showing  a  list	of
       graph images based on the trend data stored about the hosts.

       If multiple graph-types are selected, hobbit-hostgraph.cgi will display a list of graphs, with one graph per type.

       If  multiple  hosts  are  selected,  hobbit-hostgraph.cgi will attempt to display a multi-host graph for each type where the graphs for all
       hosts are overlayed in a single image, allowing for easy comparison of the hosts.

       The hostlist uses the PAGEPATH cookie provided by Xymon webpages to select the list of hosts to present. Only the hosts visible on the page
       where hobbit-hostgraph.cgi is invoked from will be visible.

       The resulting graph page can be bookmarked, but the bookmark also fixates the time period shown.

OPTIONS

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

BUGS

       This utility is experimental. It may change in a future release of Xymon.

       It is possible for the user to select graphs which do not exist. This results in broken image links.

       The set of graph-types is fixed in the server/web/hostgraphs_form template and does not adjust to which graphs are available.

       If the tool is invoked directly, all hosts defined in Xymon will be listed.

SEE ALSO

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

Xymon							    Version 4.2.3:  4 Feb 2009					  HOBBIT-HOSTGRAPHS.CGI(1)
Man Page