website/compiling.wml

   1 #include "$(ROOT)/.wml/template.inc" section=compiling subsection=none
   2
   3 <H1>Compiling</H1>
   4
   5 <P>This is for UNIX! A precompiled NT version of RRDtool is available from
   6 the download area</P>
   7
   8 <H2>Prerequisits</H2>
   9
  10 <P>Before you start compiling RRDtool, make sure you have the following
  11 packages installed on your system:</P>
  12
  13 <UL>
  14 <LI><A HREF="http://www.perl.com">Perl 5.005</A></LI>
  15 <LI><A HREF="ftp://ftp.gnu.org/gnu/make">GNU make</A></LI>
  16 <LI><A HREF="ftp://ftp.gnu.org/gnu/gcc">GNU gcc</A></LI>
  17 </UL>
  18
  19 <P>If you want to start hacking RRDtool, make sure you also have these:</P>
  20
  21 <UL>
  22 <LI><A HREF="ftp://ftp.gnu.org/gnu/autoconf">GNU autoconf</A></LI>
  23 <LI><A HREF="ftp://ftp.gnu.org/gnu/automake">GNU automake</A></LI>
  24 <LI><A HREF="ftp://ftp.gnu.org/gnu/libtool">GNU libtool</A></LI>
  25 </UL>
  26
  27 <H2>Compilation</H2>
  28
  29 <P>Now you are ready to compile the code:</P>
  30
  31 <PRE>
  32 sh configure
  33 make
  34 make install
  35 </PRE>
  36
  37
  38 <P>This will configure, compile and install RRDtool in
  39 <CODE>/usr/local/rrdtool-VERSION</CODE>.</P>
  40
  41 <H2>Additional Notes</H2>
  42
  43 <P>If you prefer to install RRDtool in some other place, use:</P>
  44
  45 <PRE>
  46 sh configure --prefix=/some/other/RRDtool-dir
  47 </PRE>
  48
  49 <P> If you prefer to live with shared libraries, make sure you add the
  50 <CODE>--enable-shared</CODE> option to your configure call:</P>
  51
  52 <PRE>
  53 sh configure --enable-shared
  54 </PRE>
  55
  56 <P> The configure script will try to find your perl installation. If it does
  57 not find it, you can still build RRDtool but no perl modules will be
  58 generated.</P>
  59
  60 <P>By default the perl modules will be installed under the RRDtool install
  61 directory. This will require you to use a 'use lib' statement in your
  62 RRDtool perl programs. If you do not care what happens to your site-perl
  63 directory, you can also use:</P>
  64
  65 <PRE>
  66 make site-perl-install
  67 </PRE>
  68
  69 <P> will install the perl modules whereever you keep your local perl
  70 modules. Doing this reliefs you from using 'use lib' in your scripts. </P>