bbcombotest(1) [debian man page]

BBCOMBOTEST(1)						      General Commands Manual						    BBCOMBOTEST(1)

NAME

       bbcombotest - Xymon combination test tool

SYNOPSIS

       bbcombotest --help
       bbcombotest --version
       bbcombotest [--debug] [--quiet]

DESCRIPTION

       bbcombotest is a Xymon extension script that runs on the BBDISPLAY server.  It combines the results of one or more of the normal Xymon test
       results into a combined test result, using standard arithmetic og logical operators.

       The resulting tests are sent to the Xymon display server as any normal test - so all of the standard Xymon functions  (history,	statistics
       etc.) are available for the combined tests.

       The  tool  was born from the need to monitor systems with built-in redundancy and automatic failover - e.g. load-balanced web servers.  But
       other uses are possible.

OPTIONS

       --quiet
	      Normally, the test status sent by bbcombotest includes information about the underlying test results used to determine  the  current
	      value of the combined test. "--quiet" eliminates this information from the test status page.

       --debug
	      Provide debugging output for use in troubleshooting problems with bbcombotest.

       --no-update
	      Dont send any status messages - instead, the result of the combotests is simply dumped to stdout. Useful for debugging.

FILES

       $BBHOME/etc/bbcombotest.cfg
	      Configuration file for bbcombotest, where the combined tests are defined

       $BBHOME/etc/hobbitlaunch.cfg
	      Configuration file controlling when bbcombotest is run.

SEE ALSO

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

Xymon							    Version 4.2.3:  4 Feb 2009						    BBCOMBOTEST(1)

LOGFETCH(1)						      General Commands Manual						       LOGFETCH(1)

NAME

       logfetch - Xymon client data collector

SYNOPSIS

       logfetch CONFIGFILE STATUSFILE

DESCRIPTION

       logfetch  is part of the Xymon client. It is responsible for collecting data from logfiles, and other file-related data, which is then sent
       to the Xymon server for analysis.

       logfetch uses a configuration file, which is automatically retrieved from the Xymon server. There is no	configuration  done  locally.  The
       configuration  file is usually stored in the $BBHOME/tmp/logfetch.cfg file, but editing this file has no effect since it is re-written with
       data from the Xymon server each time the client runs.

       logfetch stores information about what parts of the monitored logfiles have been processed already in the $BBHOME/tmp/logfetch.status file.
       This file is an internal file used by logfetch, and should not be edited. If deleted, it will be re-created automatically.

SECURITY

       logfetch  needs	read access to the logfiles it should monitor. If you configure monitoring of files or directories through the "file:" and
       "dir:" entries in client-local.cfg(5) then logfetch will require at least read-acces to the directory where the file  is  located.  If  you
       request checksum calculation for a file, then it must be readable by the Xymon client user.

       Do  NOT	install  logfetch  as  suid-root. There is no way that logfetch can check whether the configuration file it uses has been tampered
       with, so installing logfetch with suid-root privileges could allow an attacker to read any file on the system by using a hand-crafted  con-
       figuration file. In fact, logfetch will attempt to remove its own suid-root setup if it detects that it has been installed suid-root.

ENVIRONMENT VARIABLES

       DU     Command  used  to collect information about the size of directories.  By default, this is the command du -k. If the local du-command
	      on the client does not recognize the "-k" option, you should set the DU environment  variable  in  the  $BBHOME/etc/hobbitclient.cfg
	      file to a command that does report directory sizes in kilobytes.

FILES

       $BBHOME/tmp/logfetch.cfg

       $BBHOME/tmp/logfetch.status

SEE ALSO

       xymon(7), hobbit-clients.cfg(5)

Xymon							    Version 4.2.3:  4 Feb 2009						       LOGFETCH(1)