RRDTUNE(1)                          rrdtool                         RRDTUNE(1)



[1mNAME[0m
       rrdtool tune - Modify some basic properties of a Round Robin Database

[1mSYNOPSIS[0m
       [1mrrdtool tune [4m[22mfilename[24m [[1m--heartbeat[22m|[1m-h [4m[22mds-name[24m:[4mheartbeat[24m] [[1m--mini-[0m
       [1mmum[22m|[1m-i [4m[22mds-name[24m:[4mmin[24m] [[1m--maximum[22m|[1m-a [4m[22mds-name[24m:[4mmax[24m]
       [[1m--data-source-type[22m|[1m-d [4m[22mds-name[24m:[4mDST[24m] [[1m--data-source-rename[22m|[1m-r [4m[22mold-[0m
       [4mname[24m:[4mnew-name[24m]

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

       The main application of the [1mtune [22mfunction is to relax the validation
       rules on an [1mRRD[22m. This allows to fill a new [1mRRD [22mwith data available in
       larger intervals than what you would normally want to permit.

       [4mfilename[0m
               The name of the [1mRRD [22myou want to tune.

       [1m--heartbeat[22m|[1m-h [4m[22mds-name[24m:[4mheartbeat[0m
               modify the [4mheartbeat[24m of a data source. By setting this to a
               high value the rrd will accept things like one value per day
               ...

       [1m--minimum[22m|[1m-i [4m[22mds-name[24m:[4mmin[0m
               alter the minimum value acceptable as input from the data
               source.  Setting [4mmin[24m to 'U' will disable this limit.

       [1m--maximum[22m|[1m-a [4m[22mds-name[24m:[4mmax[0m
               alter the maximum value acceptable as input from the data
               source.  Setting [4mmax[24m to 'U' will disable this limit.

       [1m--data-source-type[22m|[1m-d [4m[22mds-name[24m:[4mDST[0m
               alter the type [1mDST [22mof a data source.

       [[1m--data-source-rename[22m|[1m-r [4m[22mold-name[24m:[4mnew-name[24m]
               rename a data source

[1mEXAMPLE[0m
       "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 data from mrtg-2.0 right into rrdtool
       without generating *UNKNOWN* entries.

[1mAUTHOR[0m
       Tobias Oetiker <oetiker@ee.ethz.ch>



1.0.41                            2002-02-26                        RRDTUNE(1)
