diff --git a/doc/rrdbuild.html b/doc/rrdbuild.html
index 27e088c05f3ce1e257cae2772e5b1f6eba8559a3..f7585a6623ef4a63bb589ee651baa29055a577d0 100644 (file)
--- a/doc/rrdbuild.html
+++ b/doc/rrdbuild.html
</p>
<hr />
<h1><a name="overview">OVERVIEW</a></h1>
-<p>If you downloaded the source of rrdtool you have to compile it. This
+<p>If you downloaded the source of RRDtool you have to compile it. This
document will give some information on how this is done.</p>
<p>RRDtool relies on services of third part libraries. Some of these libraries
may already be installed on your system. You have to compile copies of the other
<p>Once you have decided. Save the two locations into environment variables.</p>
<pre>
BUILD_DIR=/tmp/rrdbuild
- INSTALL_DIR=/usr/local/rrdtool-1.3.8</pre>
+ INSTALL_DIR=/opt/rrdtool-1.4.7</pre>
<p>If your <em class="file">/tmp</em> is mounted with the option noexec (RHEL seems todo that) you have to choose
a different directory!</p>
<p>Now make sure the BUILD_DIR exists and go there:</p>
<p>Lets first assume you already have all the necessary libraries
pre-installed.</p>
<pre>
- wget <a href="http://oss.oetiker.ch/rrdtool/pub/rrdtool-1.3.8.tar.gz">http://oss.oetiker.ch/rrdtool/pub/rrdtool-1.3.8.tar.gz</a>
- gunzip -c rrdtool-1.3.8.tar.gz | tar xf -
- cd rrdtool-1.3.8
+ wget <a href="http://oss.oetiker.ch/rrdtool/pub/rrdtool-1.4.7.tar.gz">http://oss.oetiker.ch/rrdtool/pub/rrdtool-1.4.7.tar.gz</a>
+ gunzip -c rrdtool-1.4.7.tar.gz | tar xf -
+ cd rrdtool-1.4.7
./configure --prefix=$INSTALL_DIR && make && make install</pre>
<p>Ok, this was very optimistic. This try will probably have ended with
<strong>configure</strong> complaining about several missing libraries.</p>
<p>If your OS lets you install additional packages from a software repository,
you may get away with installing the missing packages. When the packages are
installed, run configure again and try to compile again. Below you find some
-hints on getting your OS ready for the rrdtool compilation.</p>
-<p>Additions to this list are welcome. In general rrdtool should work with the
+hints on getting your OS ready for compiling RRDtool.</p>
+<p>Additions to this list are welcome. In general RRDtool should work with the
latest versions of the libraries. The versions listed here are just what was
current when I tested this.</p>
<p>
@@ -136,14 +136,9 @@ bad since OpenSolaris does not include an <em class="file">xrender.pc</em> file.
fix this:</p>
<pre>
perl -i~ -p -e 's/(Requires.*?)\s*xrender.*/$1/' /usr/lib/pkgconfig/cairo.pc</pre>
-<p>Make sure rrdtool finds your new compiler</p>
+<p>Make sure the RRDtool build system finds your new compiler</p>
<pre>
export PATH=/opt/SunStudioExpress/bin</pre>
-<p>Since there does not seem to be a viable msgfmt tool on OpenSolaris (short
-of installing it yourself). You have to call configure with the</p>
-<pre>
- --disable-libintl</pre>
-<p>option.</p>
<p>
</p>
<h2><a name="debian___ubuntu">Debian / Ubuntu</a></h2>
<p>
</p>
<h2><a name="gentoo">Gentoo</a></h2>
-<p>In Gentoo installing rrdtool is really simple you just need to <strong>emerge
+<p>In Gentoo installing RRDtool is really simple you just need to <strong>emerge
rrdtool</strong>. All dependencies will be handled automatically by the portage
system. The only thing you should care about are USE flags, which allow you
-fine tune features rrdtool will be built with. Currently the following USE
+fine tune features RRDtool will be built with. Currently the following USE
flags are available:</p>
<pre>
doc - install .html and .txt documentation
<h2><a name="general_build_tips_for_aix">General build tips for AIX</a></h2>
<p>If you are working with AIX, you may find the <strong>--disable-shared</strong> option
will cause things to break for you. In that case you may have to install the
-shared libraries into the rrdtool PREFIX and work with <strong>--disable-static</strong>
+shared libraries into the RRDtool PREFIX and work with <strong>--disable-static</strong>
instead.</p>
-<p>Another hint to get rrdtool working on AIX is to use the IBM XL C Compiler:</p>
+<p>Another hint to get RRDtool working on AIX is to use the IBM XL C Compiler:</p>
<pre>
export CC=/usr/vac/bin/cc
export PERLCC=$CC</pre>
export LDFLAGS=-R${INSTALL_DIR}/lib</pre>
<p>if you are using the Sun Studio/Forte compiler, you may also want to set</p>
<pre>
- export CFLAGS="-xO3 -xcode=pic13" (SPARC)
- export CFLAGS="-xO3 -Kpic" (x86)</pre>
+ CFLAGS="-xO3 -xcode=pic13" (SPARC)
+ CFLAGS="-xO3 -Kpic" (x86)</pre>
</dd>
<dt><strong><a name="linux" class="item">Linux</a></strong></dt>
<dd>
<pre>
- export CFLAGS="-O3 -fPIC"
export LDFLAGS="-Wl,--rpath -Wl,${INSTALL_DIR}/lib"</pre>
</dd>
<dt><strong><a name="hpux" class="item">HPUX</a></strong></dt>
wget <a href="http://pkgconfig.freedesktop.org/releases/pkg-config-0.23.tar.gz">http://pkgconfig.freedesktop.org/releases/pkg-config-0.23.tar.gz</a>
gunzip -c pkg-config-0.23.tar.gz | tar xf -
cd pkg-config-0.23
- ./configure --prefix=$INSTALL_DIR
+ ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC"
$MAKE
$MAKE install</pre>
<p>After installing pkgconfig in a custom directory, setting up the corresponding
wget <a href="http://oss.oetiker.ch/rrdtool/pub/libs/zlib-1.2.3.tar.gz">http://oss.oetiker.ch/rrdtool/pub/libs/zlib-1.2.3.tar.gz</a>
gunzip -c zlib-1.2.3.tar.gz | tar xf -
cd zlib-1.2.3
- ./configure --prefix=$INSTALL_DIR --shared
+ ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC" --shared
$MAKE
$MAKE install</pre>
<p>
cd $BUILD_DIR
wget <a href="http://oss.oetiker.ch/rrdtool/pub/libs/libpng-1.2.18.tar.gz">http://oss.oetiker.ch/rrdtool/pub/libs/libpng-1.2.18.tar.gz</a>
gunzip -c libpng-1.2.18.tar.gz | tar xf -
- cd libpng-1.2.18
- ./configure --prefix=$INSTALL_DIR
+ cd libpng-1.2.10
+ env CFLAGS="-O3 -fPIC" ./configure --prefix=$INSTALL_DIR
$MAKE
$MAKE install</pre>
<p>
wget <a href="http://oss.oetiker.ch/rrdtool/pub/libs/libxml2-2.6.32.tar.gz">http://oss.oetiker.ch/rrdtool/pub/libs/libxml2-2.6.32.tar.gz</a>
gunzip -c libxml2-2.6.32.tar.gz | tar xf -
cd libxml2-2.6.32
- ./configure --prefix=$INSTALL_DIR
+ ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC"
$MAKE
$MAKE install</pre>
<p>
wget <a href="http://oss.oetiker.ch/rrdtool/pub/libs/fontconfig-2.4.2.tar.gz">http://oss.oetiker.ch/rrdtool/pub/libs/fontconfig-2.4.2.tar.gz</a>
gunzip -c fontconfig-2.4.2.tar.gz | tar xf -
cd fontconfig-2.4.2
- ./configure --prefix=$INSTALL_DIR --with-freetype-config=$INSTALL_DIR/bin/freetype-config
+ ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC" --with-freetype-config=$INSTALL_DIR/bin/freetype-config
$MAKE
$MAKE install</pre>
<p>
wget <a href="http://oss.oetiker.ch/rrdtool/pub/libs/pixman-0.10.0.tar.gz">http://oss.oetiker.ch/rrdtool/pub/libs/pixman-0.10.0.tar.gz</a>
gunzip -c pixman-0.10.0.tar.gz | tar xf -
cd pixman-0.10.0
- ./configure --prefix=$INSTALL_DIR
+ ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC"
$MAKE
$MAKE install</pre>
<p>
./configure --prefix=$INSTALL_DIR \
--enable-xlib=no \
--enable-xlib-render=no \
- --enable-win32=no
+ --enable-win32=no \
+ CFLAGS="-O3 -fPIC"
$MAKE
$MAKE install</pre>
+<p>When building on Solaris you may want todo</p>
+<pre>
+ ./configure --prefix=$INSTALL_DIR \
+ --enable-xlib=no \
+ --enable-xlib-render=no \
+ --enable-win32=no \
+ CFLAGS="-O3 -fPIC -D_POSIX_PTHREAD_SEMANTICS"</pre>
<p>
</p>
<h3><a name="building_glib">Building Glib</a></h3>
wget <a href="http://oss.oetiker.ch/rrdtool/pub/libs/glib-2.15.4.tar.gz">http://oss.oetiker.ch/rrdtool/pub/libs/glib-2.15.4.tar.gz</a>
gunzip -c glib-2.15.4.tar.gz | tar xf -
cd glib-2.15.4
- ./configure --prefix=$INSTALL_DIR
+ ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC"
$MAKE
$MAKE install</pre>
<p>
wget <a href="http://oss.oetiker.ch/rrdtool/pub/libs/pango-1.21.1.tar.bz2">http://oss.oetiker.ch/rrdtool/pub/libs/pango-1.21.1.tar.bz2</a>
bunzip2 -c pango-1.21.1.tar.bz2 | tar xf -
cd pango-1.21.1
- ./configure --prefix=$INSTALL_DIR --without-x
+ ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC" --without-x
$MAKE
$MAKE install</pre>
<p>
are running, the syntax for setting environment variables is different.</p>
<p>And finally try building again. We disable the python and tcl bindings
because it seems that a fair number of people have ill configured python and
-tcl setups that would prevent rrdtool from building if they are included in
+tcl setups that would prevent RRDtool from building if they are included in
their current state.</p>
<pre>
- cd $BUILD_DIR/rrdtool-1.3.8
+ cd $BUILD_DIR/rrdtool-1.4.7
./configure --prefix=$INSTALL_DIR --disable-tcl --disable-python
$MAKE clean
$MAKE