RRDTUNE(1)                          rrdtool                         RRDTUNE(1)



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

SSYYNNOOPPSSIISS
       rrrrddttooooll ttuunnee _f_i_l_e_n_a_m_e [----hheeaarrttbbeeaatt|--hh _d_s_-_n_a_m_e:_h_e_a_r_t_b_e_a_t] [----mmiinnii--
       mmuumm|--ii _d_s_-_n_a_m_e:_m_i_n] [----mmaaxxiimmuumm|--aa _d_s_-_n_a_m_e:_m_a_x]
       [----ddaattaa--ssoouurrccee--ttyyppee|--dd _d_s_-_n_a_m_e:_D_S_T] [----ddaattaa--ssoouurrccee--rreennaammee|--rr _o_l_d_-
       _n_a_m_e:_n_e_w_-_n_a_m_e]

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

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

       _f_i_l_e_n_a_m_e
               The name of the RRRRDD you want to tune.

       ----hheeaarrttbbeeaatt|--hh _d_s_-_n_a_m_e:_h_e_a_r_t_b_e_a_t
               modify the _h_e_a_r_t_b_e_a_t of a data source. By setting this to a
               high value the rrd will accept things like one value per day
               ...

       ----mmiinniimmuumm|--ii _d_s_-_n_a_m_e:_m_i_n
               alter the minimum value acceptable as input from the data
               source.  Setting _m_i_n to 'U' will disable this limit.

       ----mmaaxxiimmuumm|--aa _d_s_-_n_a_m_e:_m_a_x
               alter the maximum value acceptable as input from the data
               source.  Setting _m_a_x to 'U' will disable this limit.

       ----ddaattaa--ssoouurrccee--ttyyppee|--dd _d_s_-_n_a_m_e:_D_S_T
               alter the type DDSSTT of a data source.

       [----ddaattaa--ssoouurrccee--rreennaammee|--rr _o_l_d_-_n_a_m_e:_n_e_w_-_n_a_m_e]
               rename a data source

EEXXAAMMPPLLEE
       "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.

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



1.0.45                            2002-02-26                        RRDTUNE(1)
