Provided by: hobbit_4.2.0.dfsg-10_i386 bug

NAME

       hobbitsvc.cgi - CGI program to view Hobbit status logs

SYNOPSIS

       hobbitsvc.cgi [--hobbitd|--historical] [--history={top|bottom}]

DESCRIPTION

       hobbitsvc.cgi  is  a CGI program to present a Hobbit status log in HTML
       form (ie, as a web page). It can be used both for the logs showing  the
       current  status, and for historical logs from the "histlogs" directory.
       It is normally invoked as a CGI program, and therefore receives most of
       the input parameters via the CGI QUERY_STRING environment variable.

       Unless  the "--historical" option is present, the current status log is
       used. This assumes a QUERY_STRING environment variable of the form
          HOSTSVC=hostname.servicename
       where "hostname" is the name of the host with commas instead  of  dots,
       and  "servicename"  is  the  name  of  the  service (the column name in
       Hobbit).  Such links are automatically generated by the  bbgen(1)  tool
       when the environment contains "BBLOGSTATUS=dynamic".

       With  the  "--historical" option present, a historical logfile is used.
       This assumes a QUERY_STRING environment variable of the form
          HOST=hostname&SERVICE=servicename&TIMEBUF=timestamp
       where "hostname" is the name of the host with commas instead  of  dots,
       "servicename"  is  the name of the service, and "timestamp" is the time
       of the log. This is automatically generated by the bb-hist.cgi(1) tool.

OPTIONS

       --hobbitd
              Retrieve the current status log from hobbitd(1) rather than from
              the logfile. This is for use with the  Hobbit  daemon  from  the
              Hobbit monitor version 4.

       --historical
              Use a historical logfile instead of the current logfile.

       --history={top|bottom|none}
              When  showing the current logfile, provide a "HISTORY" button at
              the top or the bottom of the webpage, or not at all. The default
              is to put the HISTORY button at the bottom of the page.

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

       --templates=DIRECTORY
              Where  to  look  for  the HTML header- and footer-templates used
              when generating the webpages. Default: $BBHOME/web/

       --no-svcid
              Do not include the HTML tags to identify the hostname/service on
              the  generated  web  page. Useful is this already happens in the
              hostsvc_header template file, for instance.

       --multigraphs=TEST1[,TEST2]
              This causes hobbitsvc.cgi to generate links  to  service  graphs
              that  are  split  up into multiple images, with at most 5 graphs
              per image. This  option  only  works  in  Hobbit  mode.  If  not
              specified, only the "disk" status is split up this way.

       --no-disable
              By  default, the info-column page includes a form allowing users
              to disable and re-enable tests. If your setup uses  the  default
              separation  of  administration  tools into a separate, password-
              protected area, then use of the  disable-  and  enable-functions
              requires access to the administration tools. If you prefer to do
              this only via the dedicated  administration  page,  this  option
              will remove the disable-function from the info page.

       --no-jsvalidation
              The  disable-function  on  the  info-column page by default uses
              JavaScript to validate the form before submitting the  input  to
              the  Hobbit  server.  However,  some  browsers cannot handle the
              Javascript code correctly so the form does not work. This option
              disables  the  use  of  Javascript for form-validation, allowing
              these browsers to use the disable-function.

FILES

       $BBHOME/web/hostsvc_header
              HTML template header

       $BBHOME/web/hostsvc_footer
              HTML template footer

ENVIRONMENT

       NONHISTS=info,trends,graphs
              A comma-separated list of services that does not have meaningful
              history,  e.g.  the "info" and "trends" columns. Services listed
              here do not get a "History" button.

       TEST2RRD=test,test
              A comma-separated list of the tests that have an RRD graph.

SEE ALSO

       hobbit(7), hobbitd(1)