README

   1 Round Robin Database Tools
   2 ==========================
   3
   4 It is pretty easy to gather status information from all sorts of things,
   5 ranging from the temperature in your office to the number of octets which
   6 have passed through the FDDI interface of your router. But it is not so
   7 trivial to store this data in a efficient and systematic manner. This is
   8 where RRDtool kicks in. It lets you log and analyze the data you gather from
   9 all kinds of data-sources (DS). The data analysis part of RRDtool is based
  10 on the ability to quickly generate graphical representations of the data
  11 values collected over a definable time period.
  12
  13
  14 To compile:
  15 -----------
  16
  17   you need the following libraries installed on your system.
  18
  19    cgilib-0.5.tar.gz
  20    freetype-2.1.5.tar.gz
  21    libart_lgpl-2.3.16.tar.gz
  22    libpng-1.2.5.tar.gz
  23    zlib-1.2.1.tar.gz
  24
  25   you can either get these libraries directly from their original sites
  26   or you can get copies from
  27
  28    http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/pub/libs
  29
  30   if the libraries are not installed in standard places you may need
  31   to set CPPFLAGS and LDFLAGS accordingly. This will be improved in further
  32   editions of this developers series. Here is an example call.
  33
  34   env CPPFLAGS="-I/scratch/oetiker/cgilib-0.5 \
  35                 -I/scratch/oetiker/lib/include/libart-2.0 \
  36                 -I/scratch/oetiker/lib/include \
  37                 -I/scratch/oetiker/lib/include/freetype2" \
  38        LDFLAGS="-L/scratch/oetiker/lib/lib -R/scratch/oetiker/lib/lib \
  39                 -L/scratch/oetiker/cgilib-0.5" \
  40       ./configure --prefix=/scratch/oetiker/rrdtool
  41
  42   make             <------ GNU make
  43
  44   make install     <------ GNU make
  45
  46 This will configure, compile and install RRDtool in
  47 /usr/local/rrdtool-VERSION. If you prefer to install RRDtool in some other
  48 place, use
  49
  50   sh configure --prefix=/some/other/RRDtool-dir
  51
  52 The configure script will try to find your perl installation (5.004
  53 preferred). If it does not find it, you can still build RRDtool but no perl
  54 modules will be generated.
  55
  56 By default the perl modules will be installed under the RRDtool install
  57 directory. This will require you to use a 'use lib' statement in your
  58 RRDtool perl programs. If you do not care what happens to your site-perl
  59 directory, you can also use
  60
  61    --enable-perl-site-install
  62
  63 when running configure to have the RRD perl modules installed  whereever you
  64 keep your local perl modules. Doing this reliefs you from using 'use lib' in
  65 your scripts.
  66
  67 Configure will also look for an TCL installation on your system. If it finds
  68 one it will build a TCL interface for RRDtool. If you keep tcl in a non
  69 standard location you can use
  70
  71   sh configure --with-tcllib=/sw/tcl-8.3/lib
  72
  73 to indicte the right version (note, this must point to the directory where
  74 tclConfig.sh is located). Note that install will integrate the tcl bindings
  75 into your tcl installation. It will use a separate directory for each
  76 version though, so this is not much of a problem. Never the less the TCL
  77 module will not get intalled by default as TCL wants its module in the base
  78 tcl installation where you might not be able to write to. So if you want the
  79 tcl stuff installed, type
  80
  81   make site-tcl-install
  82
  83
  84 Getting Started:
  85 ----------------
  86
  87 Either after compiling or after installing you can try the example
  88 RRDtool applications in the examples directory.
  89
  90 To learn:
  91 ---------
  92
  93 Read the documentation in the doc directory. Start of with
  94 RRDtool. All documents are available as html and as ASCII text.
  95
  96 If you are looking for a more slow paced introduction, make sure to read
  97 Alex van den Bogaerdt's rrdtutorial which is also available from the doc
  98 directory. Also read his cdeftutorial and Steve Rader's rpntutorial.
  99
 100 If you want to know about the format of the log files check
 101 src/rrd_format.h there are a lot of comments in there ...
 102
 103 How to make Tobi happy:
 104 -----------------------
 105
 106 If you want to show your appreciation for RRDtool you could make me happy
 107 by going to ee-staff.ethz.ch/~oetiker/wish and ordering a CD from
 108 my CD wish list ...
 109
 110
 111 How to keep in touch:
 112 ---------------------
 113
 114 There are 3 Mailing lists for RRDtool:
 115
 116 rrd-announce    LOW volume RRDtool Announcements List (Only Stable Releases)
 117 rrd-users       For discussion amongst people who use RRDtool in their applications
 118 rrd-developers  For people who actually HACK RRDtool code
 119
 120 To subscribe to <MAILGLIST> send a message with the subject 'subscribe'
 121 to <MAILGLIST>-request@list.ee.ethz.ch.
 122
 123 Note, that postings to rrd-announce will always be cross-posted
 124 to rrd-users and rrd-developers as well.
 125
 126 To Contribute:
 127 --------------
 128
 129 Contributed feature and bug patches are most welcome. But please
 130 send complete patches. A complete patch patches the CODE as well
 131 as the CHANGES, CONTRIBUTORS and the POD files.
 132
 133 Use GNU   diff --unified --recursive olddir newdir   to build your patches.
 134
 135 The latest Version:
 136 -------------------
 137 Is available from http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/
 138
 139
 140 Tobias Oetiker <oetiker@ee.ethz.ch>