X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=doc%2Frrdbuild.pod;h=f8437a960e6a3a692cd4a6a7bcd6f65370e36e1a;hb=c1f4d92a5b64793471b6a4ca78ec7fa71db18df9;hp=f7412321b1e73ce764a400663968b13cae92bc2b;hpb=a9e69acbc184063dcc0eda6a250ee1b7ae1cbb47;p=rrdtool.git diff --git a/doc/rrdbuild.pod b/doc/rrdbuild.pod index f741232..f8437a9 100644 --- a/doc/rrdbuild.pod +++ b/doc/rrdbuild.pod @@ -35,12 +35,15 @@ Once you have decided. Save the two locations into environment variables. Depending on the shell you are using, you can do either (bash,zsh): BUILD_DIR=/tmp/rrdbuild - INSTALL_DIR=/usr/local/rrdtool-1.2.13 + INSTALL_DIR=/usr/local/rrdtool-1.2.99907080300 Or if you run tcsh: set BUILD_DIR=/tmp/rrdbuild - set INSTALL_DIR=/usr/local/rrdtool-1.2.13 + set INSTALL_DIR=/usr/local/rrdtool-1.2.99907080300 + +If your F is mounted with the option noexec (RHEL seems todo that) you have to choose +a different directory! Now make sure the BUILD_DIR exists and go there: @@ -52,9 +55,9 @@ pre-installed. Note that these instructions assume that your copies of B and B are actually B and B respectively. It could be that they are installed as B and B on your system. - wget http://oss.oetiker.ch/rrdtool/pub/rrdtool-1.2.13.tar.gz - tar zxf rrdtool-1.2.13.tar.gz - cd rrdtool-1.2.13 + wget http://oss.oetiker.ch/rrdtool/pub/rrdtool-1.2.99907080300.tar.gz + tar zxf rrdtool-1.2.99907080300.tar.gz + cd rrdtool-1.2.99907080300 ./configure --prefix=$INSTALL_DIR && make && make install Ok, this was very optimistic. This try will probably have ended with @@ -65,16 +68,47 @@ package for each library you install. Once you have the missing bits on board, just re-run the last line of the instructions above. But again this may have been too optimistic, and you actually have to -compile your own copies of the required libraries. Here is how: +compile your own copies of the required libraries. + +=head3 Build Tipps for AIX + +If you are woking with AIX, you may find the the B<--disable-shared> 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 B<--disable-static> +instead. + +Another hint to get rrdtool working on AIX is to use the IBM XL C Compiler: + + export CC=/usr/vac/bin/cc + export PERLCC=$CC + +(Better instructions for AIX welcome!) + +=head2 Building Libraries + +In order to build the libraries you need a compiler on your system. +Unfortunately compilers are not all alike. This has an effect on the CFLAGS +you want to set. The examples below are for the popular GCC compiler suite. +If you have an other compile you have to use the following settings: =over +=item Sun Forte + + CFLAGS="-xO3 -kPIC" + +=back + +=over + =item Building zlib +Chances are very high that you already have that on your system ... + cd $BUILD_DIR wget http://oss.oetiker.ch/rrdtool/pub/libs/zlib-1.2.3.tar.gz tar zxf zlib-1.2.3.tar.gz - cd zlib-1.2.2 + cd zlib-1.2.3 env CFLAGS="-O3 -fPIC" ./configure --prefix=$BUILD_DIR/lb make make install @@ -87,8 +121,8 @@ drop the settings of LDFLAGS and CPPFLAGS. Note that the backslash (\) at the end of line 4 means that line 4 and line 5 are on one line. cd $BUILD_DIR - wget http://oss.oetiker.ch/rrdtool/pub/libs/libpng-1.2.8-config.tar.gz - tar zxvf libpng-1.2.10.tar.gz + wget http://oss.oetiker.ch/rrdtool/pub/libs/libpng-1.2.18.tar.gz + tar zxvf libpng-1.2.18.tar.gz cd libpng-1.2.10 env CPPFLAGS="-I$BUILD_DIR/lb/include" LDFLAGS="-L$BUILD_DIR/lb/lib" CFLAGS="-O3 -fPIC" \ ./configure --disable-shared --prefix=$BUILD_DIR/lb @@ -98,9 +132,9 @@ the end of line 4 means that line 4 and line 5 are on one line. =item Building freetype cd $BUILD_DIR - wget http://oss.oetiker.ch/rrdtool/pub/libs/freetype-2.1.10.tar.bz2 - tar jxvf freetype-2.1.10.tar.bz2 - cd freetype-2.1.10 + wget http://oss.oetiker.ch/rrdtool/pub/libs/freetype-2.3.5.tar.gz + tar zxvf freetype-2.3.5.tar.gz + cd freetype-2.3.5 env CPPFLAGS="-I$BUILD_DIR/lb/include" LDFLAGS="-L$BUILD_DIR/lb/lib" CFLAGS="-O3 -fPIC" \ ./configure --disable-shared --prefix=$BUILD_DIR/lb make @@ -111,13 +145,51 @@ add the following at the end of the configure line: GNUMAKE=gmake EGREP=egrep -=item Building libart_lgpl +=item Building fontconfig + +Note that fontconfig has a runtime configuration file in INSTALL_DIR/etc you +may want to adjust that so that fontconfig finds the fonts on your system. +Run the fc-cache program to build the fontconfig cache after changeing the +config file. + + cd $BUILD_DIR + wget http://oss.oetiker.ch/rrdtool/pub/libs/fontconfig-2.4.2.tar.gz + tar zxvf fontconfig-2.4.2.tar.gz + cd fontconfig-2.4.2 + env CFLAGS="-O3 -fPIC" ./configure --prefix=$INSTALL_DIR + make + make install + +=item Building Cairo + + cd $BUILD_DIR + wget http://oss.oetiker.ch/rrdtool/pub/libs/cairo-1.4.10.tar.gz + tar zxvf cairo-1.4.10.tar.gz + cd cairo-1.4.10 + env CFLAGS="-O3 -fPIC" ./configure --prefix=$INSTALL_DIR \ + --enable-xlib=no \ + --enable-xlib-render=no \ + --enable-win32=no + make + make install + +=item Building Glib + + cd $BUILD_DIR + wget http://oss.oetiker.ch/rrdtool/pub/libs/glib-2.12.13.tar.gz + tar zxvf glib-2.12.13.tar.gz + cd glib-2.12.13 + env CFLAGS="-O3 -fPIC" ./configure --prefix=$INSTALL_DIR + make + make install + +=item Building Pango cd $BUILD_DIR - wget http://oss.oetiker.ch/rrdtool/pub/libs/libart_lgpl-2.3.17.tar.gz - tar zxvf libart_lgpl-2.3.17.tar.gz - cd libart_lgpl-2.3.17 - env CFLAGS="-O3 -fPIC" ./configure --disable-shared --prefix=$BUILD_DIR/lb + wget http://oss.oetiker.ch/rrdtool/pub/libs/pango-1.17.5.tar.gz + tar zxvf pango-1.17.5.tar.gz + cd pango-1.17.5 + env CFLAGS="-O3 -fPIC" ./configure --prefix=$INSTALL_DIR make make install @@ -135,16 +207,16 @@ include files. This is done via environment variables. Depending on the shell you are running, the syntax for setting environment variables is different. Under csh/tcsh you use: - set IR=-I$BUILD_DIR/lb/include - setenv CPPFLAGS "$IR $IR/libart-2.0 $IR/freetype2 $IR/libpng" - setenv LDFLAGS -L$BUILD_DIR/lb/lib + set IR="-I$BUILD_DIR/lb/include -I$INSTALL_DIR/include" + setenv CPPFLAGS "$IR" + setenv LDFLAGS -L$BUILD_DIR/lb/lib setenv CFLAGS -O3 If you are running bash/sh/ash/ksh/zsh use this: - IR=-I$BUILD_DIR/lb/include - CPPFLAGS="$IR $IR/libart-2.0 $IR/freetype2 $IR/libpng" - LDFLAGS="-L$BUILD_DIR/lb/lib" + IR="-I$BUILD_DIR/lb/include -I$INSTALL_DIR/include" + CPPFLAGS="$IR" + LDFLAGS="-L$BUILD_DIR/lb/lib -R$INSTALL_DIR/lib -L$INSTALL_DIR/lib" CFLAGS=-O3 export CPPFLAGS LDFLAGS CFLAGS @@ -153,8 +225,8 @@ 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 their current state. - cd $BUILD_DIR/rrdtool-1.2.13 - ./configure --prefix=$INSTALL_DIR --disable-python --disable-tcl + cd $BUILD_DIR/rrdtool-1.2.99907080300 + ./configure --prefix=$INSTALL_DIR --disable-tcl make clean make make install