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. The name of the RRD you want to tune. modify the heartbeat of a data source. By setting this to a high value the rrd will accept things like one value per day ... alter the minimum value acceptable as input from the data source. Setting min to 'U' will disable this limit. alter the maximum value acceptable as input from the data source. Setting max to 'U' will disable this limit. alter the type DST of a data source. 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 data from mrtg-2.0 right into rrdtool without generating *UNKNOWN* entries.

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