logfetch(1) [debian man page]

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)

Check Out this Related Man Page

HOBBITCLIENT.CFG(5)						File Formats Manual					       HOBBITCLIENT.CFG(5)

NAME

       hobbitclient.cfg - Xymon client environment variables

DESCRIPTION

       Xymon  programs	use  multiple environment variables beside the normal set of variables.  For the Xymon client, the environment definitions
       are stored in the ~xymon/client/etc/hobbitclient.cfg file.  Each line in this file is of the form NAME=VALUE and  defines  one  environment
       variable NAME with the value VALUE.

SETTINGS

       BBDISP The IP-address used to contact the Xymon server. Default: Chosen when the Xymon client was compiled.

       BBDISPLAYS
	      List  of	IP-adresses  of  Xymon	servers.  Data	will  be  sent	to  all  of  the servers listed here. This setting is only used if
	      BBDISP=0.0.0.0.

       BBPORT The portnumber for used to contact the Xymon server.  Default: 1984.

       BBHOME The Xymon client top-level directory. Default: The $HOBBITCLIENTHOME setting inherited from the "runclient.sh" script  which  starts
	      the Xymon client.

       BBCLIENTLOGS
	      The directory for the Xymon clients' own logfiles. Default: $BBHOME/logs

       BBTMP  Directory used for temporary files. Default: $BBHOME/tmp/

       BB     Full path to the bb(1) client program. Default: $BBHOME/bin/bb.

       Commands
	      Many extension scripts expect a series of environment variables to point at various system utilities. These are included in the file
	      when the client is built.

INHERITED SETTINGS

       Some environment variables are inherited from the "runclient.sh" script which launches the Xymon client:

       MACHINEDOTS
	      The hostname of the local system. Default: Taken from "uname -n".

       MACHINE
	      The hostname of the local system, with dots replaced by commas.  For compatibility with Big Brother extension scripts.

       BBOSTYPE
	      The operating system of the local system, in lowercase. Default: taken from "uname -s".

       HOBBITCLIENTHOME
	      The top-level directory for the Xymon client. Default: The location of the "runclient.sh" script.

SEE ALSO

       xymon(7)

Xymon							    Version 4.2.3:  4 Feb 2009					       HOBBITCLIENT.CFG(5)

Linux and UNIX Man Pages

logfetch(1) [debian man page]

Check Out this Related Man Page