home | help 
rrdbot-create(8)	     System Manager's Manual		rrdbot-create(8)

NAME
     rddbot-create -- create the RRD files for rrdbotd(8) to write values to.

SYNOPSIS
     rddbot-create [-nv] [-c confdir] [-w workdir]
     rddbot-create -V

DESCRIPTION
     rrdbotd(8) is an SNMP polling daemon. It writes out the polled values to an
     rrdtool(1)  database. The rddbot-create tool can create those RRD files for
     you.

     rddbot-create uses configuration files, one per RRD, to determine where and
     how to do its work. Details of these files and which  settings  to  put  in
     them  are found in the rrdbot.conf(5) manual under the CREATE SECTION head-
     ing.

     By default th RRD files are created in the default work directory (see  the
     FILE LOCATIONS section below). Files that already exist are not overwritten
     or modified in any way.

     You can use the -n option to see the rrdtool(1) commands that would be exe-
     cuted.  This is useful if you want to customize the commands before running
     them.

OPTIONS
     The options are as follows.

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

     -n 	 Rather  than  create  the  files, print the rrdtool(1) commands
		 that would be used to create the files.

     -v 	 Print verbose messages.

     -V 	 Prints the version of rddbot-create and the  locations  of  the
		 configuration 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.

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

AUTHOR
     Stef Walter <stef@memberwebs.com>

rrdbot				  August, 2006			rrdbot-create(8)
home | help