


RRDTUNE(1)                   rrdtool                   RRDTUNE(1)


NAME
       rrdtool tune - Modify some basic properties of a Round
       Robin Database

SYNOPSIS
       rrdtool tune filename [--heartbeat|-h ds-name:heartbeat]
       [--minimum|-i ds-name:min] [--maximum|-a ds-name:max]
       [--data-source-type|-d ds-name:DST]
       [--data-source-rename|-r old-name:new-name]

DESCRIPTION
       The tune option allows you to alter some of the basic
       configuration values stored in the header area of a Round
       Robin Database (RRD).  All these tunable parameters
       together decide when data fed into an RRD is to be
       regarded as invalid. Invalid data is entered into the
       database as *UNKNOWN*.

       The main application of the tune function is to relax the
       validation rules on an RRD. This allows to fill a new RRD
       with data available in larger intervals than what you
       would normally want to permit.

       filename
               The name of the RRD you want to tune.

       --heartbeat|-h ds-name:heartbeat
               modify the heartbeat of a data source. By setting
               this to a high value the rrd will accept things
               like one value per day ...

       --minimum|-i ds-name:min
               alter the minimum value acceptable as input from
               the data source.  Setting min to 'U' will disable
               this limit.

       --maximum|-a ds-name:max
               alter the maximum value acceptable as input from
               the data source.  Setting max to 'U' will disable
               this limit.

       --data-source-type|-d ds-name:DST
               alter the type DST of a data source.

       [--data-source-rename|-r old-name:new-name]
               rename a data source

EXAMPLE
       `rrdtool tune data.rrd -h in:100000 -h out:100000 -h
       through:100000'

       Set the minimum required heartbeat for data sources 'in',
       'out' and 'through' to 10000 seconds which is a little
       over one day in data.rrd.  This would allow to feed old



2002-02-26                    1.0.38                            1





RRDTUNE(1)                   rrdtool                   RRDTUNE(1)


       data from mrtg-2.0 right into rrdtool without generating
       *UNKNOWN* entries.

AUTHOR
       Tobias Oetiker <oetiker@ee.ethz.ch>




















































2002-02-26                    1.0.38                            2


