Man Page: rrdbot-create(8)

rrdbot-create(8)          BSD 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
     heading.

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

     You can use the -n option to see the rrdtool(1) commands that would be
     executed. 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
                 below 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
     configuration files. The contents of the configuration files are
     described in rrdbot.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 fol-
     lowing:

           /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
     option in the configuration file.

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

AUTHOR
     Stef Walter <stef@thewalter.net>

rrdbot                          April 16, 2008                          rrdbot
   [ back | home ]