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

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
       msgcache 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  msgcache,  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)