home | help 
rrdbotd(8)		     System Manager's Manual		      rrdbotd(8)

NAME
     rddbotd -- an SNMP poller which writes to an round robin database

SYNOPSIS
     rddbotd [-M] [-b bindaddr] [-c confdir] [-w workdir] [-m mibdir]
	     [-d debuglevel] [-p pidfile] [-r retries] [-t timeout]
     rddbotd -V

DESCRIPTION
     rddbotd is an SNMP polling daemon which writes the polled values to an rrd-
     tool(1)  RRD  database. An can poll many different SNMP sources in an effi-
     cient manner.

     Table queries are supported, where the OID index of a certain value is  not
     known beforehand, or may change regularly.

     In  addition  multiple SNMP agents may be specified for a certain value. If
     one SNMP agent cannot be contacted or errors for some reason,  another  one
     will be tried.

     The  configuration  (eg:  SNMP  sources,  polling intervals) are located in
     files in a directory, with one configuration file per RRD.  The  format  of
     the configuration files are described in: rrdbot.conf(5)

OPTIONS
     The options are as follows.

     -b bindaddr
		 Address to bind to and send SNMP packets from.

     -c confdir  The  directory in which configuration files are stored. See be-
		 low for info on the various file locations.

     -d debuglevel
		 Don't detach from the console and run as a daemon. In	addition
		 the  debuglevel argument specifies what level of error messages
		 to display. 0 being the least, 4 the most.

     -m mibdir	 The directory in which to look for MIB files. The  default  di-
		 rectory is usually sufficient.

     -M 	 Display MIB parsing warnings.

     -p pidfile  Specifies  a  location  for the a process id file to be written
		 to. This file contains the process id of  rddbotd  and  can  be
		 used to stop the daemon.

     -r retries  The  number  of times to retry sending an SNMP packet. Defaults
		 to 3 retries.

     -t timeout  The amount of time (in seconds) to wait for an  SNMP  response.
		 Defaults to 5 seconds.

     -V 	 Prints the version of rddbotd and the locations of the configu-
		 ration files, RRD files etc.

     -w workdir  The  default  directory  where to look for RRD files. See below
		 for info on the various file locations.

FILE LOCATIONS
     To determine the default location for the configuration files and RRD files
     run this command:

	   # rrdbotd -V

     The configuration files for SNMP pollers are laid out in a directory  tree,
     with  one file per RRD. Subdirectories can be used to organize the configu-
     ration files. The contents of the configuration files are described in rrd-
     bot.conf(5).

     By default the RRD files mirror the directory structure and  names  of  the
     configuration files, with an .rrd extension appended to the filename.

     For example if your configuration files are in a structure like the follow-
     ing:

	   /usr/local/etc/rrdbot/
	     gateways/
	       gateway-load.conf
	       gateway-traffic.conf
	     temperature/
	       inside-temperature.conf
	       outside-temperature.conf
	     machine-load.conf

     Then the default RRD files would be in a similar directory structure:

	   /var/db/rrdbot/
	     gateways/
	       gateway-load.conf.rrd
	       gateway-traffic.conf.rrd
	     temperature/
	       inside-temperature.conf.rrd
	       outside-temperature.conf.rrd
	     machine-load.conf.rrd

     The default location for an RRD file can be overridden by using the rrd op-
     tion in the configuration file.

     You can use the rrdbot-create(8) tool to create the needed RRD files in the
     appropriate places.

SEE ALSO
     rrdbot.conf(5), rrdbot-create(8), rrdbot-get(1), rrdtool(1)

AUTHOR
     Stef Walter <stef@memberwebs.com>

rrdbot				  August, 2006			      rrdbotd(8)
home | help