Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

hobbitfetch(8) [debian man page]

HOBBITFETCH(8)						      System Manager's Manual						    HOBBITFETCH(8)

NAME

       hobbitfetch - fetch client data from passive clients

SYNOPSIS

       hobbitfetch [--server=HOBBIT.SERVER.IP] [options]

DESCRIPTION

       This utility is used to collect data from Xymon clients.

       Normally,  Xymon clients will themselves take care of sending all of their data directly to the Xymon server. In that case, you do not need
       this utility at all. However, in some network setups clients may be prohibited from establishing a connection to an external server such as
       the  Xymon  server,  due  to  firewall  policies.  In  such a setup you can configure the client to store all of the client data locally by
       enabling the msgcache(8) utility on the client, and using hobbitfetch on the Xymon server to collect data from the clients.

       hobbitfetch will only collect data from clients that have the pulldata tag listed in the bb-hosts(5) file. The IP-address listed in the bb-
       hosts  file  must be correct, since this is the IP-address where hobbitfetch will attempt to contact the client.  If the msgcache daemon is
       running on a non-standard IP-address or portnumber, you can specify the portnumber as in pulldata=192.168.1.2:8084 for contacting the  msg-
       cache  daemon using IP 192.168.1.2 port 8084. If the IP-address is omitted, the default IP in the bb-hosts file is used. If the port number
       is omitted, the portnumber from the BBPORT setting in hobbitserver.cfg(5) is used (normally, this is port 1984).

OPTIONS

       --server=HOBBIT.SERVER.IP
	      Defines the IP address of the Xymon server where the collected client messages are forwarded to. By default, messages  are  sent	to
	      the loopback address 127.0.0.1, i.e. to a Xymon server running on the same host as hobbitfetch.

       --interval=N
	      Sets the interval (in seconds) between polls of a client. Default: 60 seconds.

       --id=N Used  when  you  have a setup with multiple Xymon servers. In that case, you must run hobbitfetch on each of the Xymon servers, with
	      hobbitfetch instance using a different value of N. This allows several Xymon servers to pick up data from the clients  running  msg-
	      cache, and msgcache can distinguish between which messages have already been forwarded to which server.
	      N is a number in the range 1-31.

       --log-interval=N
	      Limit how often hobbitfetch will log problems with fetching data from a host, in seconds. Default: 900 seconds (15 minutes). This is
	      to prevent a host that is down or where msgcache has not been started from flooding the hobbitfetch logs. Note that this is  ignored
	      when debugging is enabled.

       --debug
	      Enable debugging output.

SEE ALSO

       msgcache(8), hobbitd(8), xymon(7)

Xymon							    Version 4.2.3:  4 Feb 2009						    HOBBITFETCH(8)

Check Out this Related Man Page

HOBBITD_CHANNEL(8)					      System Manager's Manual						HOBBITD_CHANNEL(8)

NAME

       hobbitd_channel - Feed a hobbitd channel to a worker module

SYNOPSIS

       hobbitd_channel --channel=CHANNEL [options] workerprogram [worker-options]

DESCRIPTION

       hobbitd_channel	hooks  into  one  of  the  hobbitd(8)  channels  that  provide information about events occurring in the Xymon system.	It
       retrieves messages from the hobbitd daemon, and passes them on to the workerprogram on the STDIN (file descripter 1) of the worker program.
       Worker programs can then handle messages as they like.

       A number of worker programs are shipped with hobbitd, e.g.  hobbitd_filestore(8) hobbitd_history(8) hobbitd_alert(8) hobbitd_rrd(8)

       If you want to write your own worker module, a sample worker module is provided as part of the hobbitd distribution in the hobbitd_sample.c
       file. This illustrates how to easily fetch and parse messages.

OPTIONS

       hobbitd_channel accepts a few options.

       --channel=CHANNELNAME
	      Specifies the channel to receive messages from, only one channel can be used.  This option is required. The following  channels  are
	      available:
	      "status" receives all Xymon status- and summary-messages
	      "stachg" receives information about status changes
	      "page" receives information about statuses triggering alerts
	      "data" receives all Xymon "data" messages
	      "notes" receives all Xymon "notes" messages
	      "enadis" receives information about hosts being disabled or enabled.

       --daemon
	      hobbitd_channel  is normally started by hobbitlaunch(8) as a task defined in the hobbitlaunch.cfg(5) file. If you are not using hob-
	      bitlaunch, then starting hobbitd_channel with this option causes it to run as a stand-alone background task.

       --pidfile=FILENAME
	      If running as a stand-alone daemon, hobbitd_channel will save the proces-ID of the daemon in FILENAME. This is useful for  automated
	      startup- and shutdown- scripts.

       --env=FILENAME
	      Loads  the  environment variables defined in FILENAME before starting hobbitd_channel.  This is normally used only when running as a
	      stand-alone daemon; if hobbitd_channel is started by hobbitlaunch, then the environment is controlled by the task definition in  the
	      hobbitlaunch.cfg(5) file.

       --log=FILENAME
	      Redirect output to this log-file.

       --debug
	      Enable debugging output.

FILES

       This program does not use any configuration files.

SEE ALSO

       hobbitd(8), xymon(7)

Xymon							    Version 4.2.3:  4 Feb 2009						HOBBITD_CHANNEL(8)
Man Page