


 RRRRRRRRDDDDTTTTUUUUNNNNEEEE((((1111))))                        1111....0000....44445555                         RRRRRRRRDDDDTTTTUUUUNNNNEEEE((((1111))))
 rrrrrrrrddddttttoooooooollll                                                             rrrrrrrrddddttttoooooooollll
                                 2222000000002222----00002222----22226666



 NNNNAAAAMMMMEEEE
      rrdtool tune - Modify some basic properties of a Round Robin Database

 SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
      rrrrrrrrddddttttoooooooollll ttttuuuunnnneeee _f_i_l_e_n_a_m_e [--------hhhheeeeaaaarrrrttttbbbbeeeeaaaatttt|----hhhh _d_s-_n_a_m_e:_h_e_a_r_t_b_e_a_t]
      [--------mmmmiiiinnnniiiimmmmuuuummmm|----iiii _d_s-_n_a_m_e:_m_i_n] [--------mmmmaaaaxxxxiiiimmmmuuuummmm|----aaaa _d_s-_n_a_m_e:_m_a_x]
      [--------ddddaaaattttaaaa----ssssoooouuuurrrrcccceeee----ttttyyyyppppeeee|----dddd _d_s-_n_a_m_e:_D_S_T] [--------ddddaaaattttaaaa----ssssoooouuuurrrrcccceeee----rrrreeeennnnaaaammmmeeee|----rrrr _o_l_d-
      _n_a_m_e:_n_e_w-_n_a_m_e]

 DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
      The tune option allows you to alter some of the basic configuration
      values stored in the header area of a Round Robin Database (RRRRRRRRDDDD).  All
      these tunable parameters together decide when data fed into an RRRRRRRRDDDD is
      to be regarded as invalid. Invalid data is entered into the database
      as *UNKNOWN*.

      The main application of the ttttuuuunnnneeee function is to relax the validation
      rules on an RRRRRRRRDDDD. This allows to fill a new RRRRRRRRDDDD 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 RRRRRRRRDDDD you want to tune.

      --------hhhheeeeaaaarrrrttttbbbbeeeeaaaatttt|----hhhh _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
              ...

      --------mmmmiiiinnnniiiimmmmuuuummmm|----iiii _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.

      --------mmmmaaaaxxxxiiiimmmmuuuummmm|----aaaa _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.

      --------ddddaaaattttaaaa----ssssoooouuuurrrrcccceeee----ttttyyyyppppeeee|----dddd _d_s-_n_a_m_e:_D_S_T
              alter the type DDDDSSSSTTTT of a data source.

      [--------ddddaaaattttaaaa----ssssoooouuuurrrrcccceeee----rrrreeeennnnaaaammmmeeee|----rrrr _o_l_d-_n_a_m_e:_n_e_w-_n_a_m_e]
              rename a data source

 EEEEXXXXAAAAMMMMPPPPLLLLEEEE
      "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.




                                    - 1 -        Formatted:  August 20, 2003






 RRRRRRRRDDDDTTTTUUUUNNNNEEEE((((1111))))                        1111....0000....44445555                         RRRRRRRRDDDDTTTTUUUUNNNNEEEE((((1111))))
 rrrrrrrrddddttttoooooooollll                                                             rrrrrrrrddddttttoooooooollll
                                 2222000000002222----00002222----22226666



 AAAAUUUUTTTTHHHHOOOORRRR
      Tobias Oetiker <oetiker@ee.ethz.ch>



















































                                    - 2 -        Formatted:  August 20, 2003



