Provided by: xymon_4.3.0~beta2.dfsg-9.1_i386 bug

NAME

       hobbitsvc.cgi - CGI program to view Xymon status logs

SYNOPSIS

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

DESCRIPTION

       hobbitsvc.cgi  is  a  CGI program to present a Xymon 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
       Xymon).  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 Xymon daemon from the
              Xymon 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  Xymon  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 Xymon 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

       xymon(7), hobbitd(1)