1 RRDBUILD(1) rrdtool RRDBUILD(1)
6 rrdbuild - Instructions for building RRDtool
9 If you downloaded the source of RRDtool you have to compile it. This
10 document will give some information on how this is done.
12 RRDtool relies on services of third part libraries. Some of these
13 libraries may already be installed on your system. You have to compile
14 copies of the other ones before you can build RRDtool.
16 This document will tell you about all the necessary steps to get going.
20 compilation or if you know what you are doing just replace the export
21 bits with setenv.
23 We further assume that your copies of t\bta\bar\br and m\bma\bak\bke\be are actually G\bGN\bNU\bU t\bta\bar\br
24 and G\bGN\bNU\bU m\bma\bak\bke\be respectively. It could be that they are installed as g\bgt\bta\bar\br
28 Before you start to build RRDtool, you have to decide two things:
30 1. In which directory you want to build the software.
32 2. Where you want to install the software.
34 Once you have decided. Save the two locations into environment
35 variables.
37 BUILD_DIR=/tmp/rrdbuild
38 INSTALL_DIR=/opt/rrdtool-1.4.3
41 you have to choose a different directory!
43 Now make sure the BUILD_DIR exists and go there:
45 mkdir -p $BUILD_DIR
46 cd $BUILD_DIR
48 Lets first assume you already have all the necessary libraries pre-
49 installed.
51 wget http://oss.oetiker.ch/rrdtool/pub/rrdtool-1.4.3.tar.gz
52 gunzip -c rrdtool-1.4.3.tar.gz | tar xf -
53 cd rrdtool-1.4.3
54 ./configure --prefix=$INSTALL_DIR && make && make install
56 Ok, this was very optimistic. This try will probably have ended with
60 If your OS lets you install additional packages from a software
61 repository, you may get away with installing the missing packages. When
62 the packages are installed, run configure again and try to compile
63 again. Below you find some hints on getting your OS ready for compiling
64 RRDtool.
66 Additions to this list are welcome. In general RRDtool should work with
67 the latest versions of the libraries. The versions listed here are just
68 what was current when I tested this.
71 Just add a compiler and the gnome development package:
73 pkg install sunstudioexpress
74 pkg install SUNWgnome-common-devel
77 xrender is required for compilation with cairo. This is not true and
78 also bad since OpenSolaris does not include an _\bx_\br_\be_\bn_\bd_\be_\br_\b._\bp_\bc file. Use
79 Perl to fix this:
81 perl -i~ -p -e 's/(Requires.*?)\s*xrender.*/$1/' /usr/lib/pkgconfig/cairo.pc
83 Make sure the RRDtool build system finds your new compiler
85 export PATH=/opt/SunStudioExpress/bin
87 Since there does not seem to be a viable msgfmt tool on OpenSolaris
88 (short of installing it yourself). You have to call configure with the
90 --disable-libintl
92 option.
95 Use apt-get to make sure you have all that is required. A number of
96 packages will get added through dependencies.
98 apt-get install libpango1.0-dev libxml2-dev
103 system. The only thing you should care about are USE flags, which allow
104 you fine tune features RRDtool will be built with. Currently the
105 following USE flags are available:
107 doc - install .html and .txt documentation
108 into /usr/share/doc/rrdtool-1.x.xx/
109 perl - build and install perl language bindings
110 python - build and install python language bindings
111 ruby - build and install ruby language bindings
112 tcl - build and install tcl language bindings
113 rrdcgi - build and install rrdcgi
115 After you've decided which USE flags you need, set them either in
116 _\bm_\ba_\bk_\be_\b._\bc_\bo_\bn_\bf or _\b/_\be_\bt_\bc_\b/_\bp_\bo_\br_\bt_\ba_\bg_\be_\b/_\bp_\ba_\bc_\bk_\ba_\bg_\be_\b._\bu_\bs_\be and finally run:
118 # emerge -va rrdtool
120 Take a look at Gentoo handbook for further details on how to manage USE
121 flags: http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2
124 But again this may have been too optimistic still, and you actually
125 have to compile your own copies of some of the required libraries.
126 Things like libpng and zlib are pretty standard so you will probably
127 have them on your system anyway. Freetype, Fontinst, Cairo, Pango may
128 be installed, but it is possible that they are pretty old and thus
129 don't live up to our expectations, so you may want to compile their
130 latest versions.
133 If you are working with AIX, you may find the -\b--\b-d\bdi\bis\bsa\bab\bbl\ble\be-\b-s\bsh\bha\bar\bre\bed\bd option
134 will cause things to break for you. In that case you may have to
135 install the shared libraries into the RRDtool PREFIX and work with
138 Another hint to get RRDtool working on AIX is to use the IBM XL C
139 Compiler:
141 export CC=/usr/vac/bin/cc
142 export PERLCC=$CC
144 (Better instructions for AIX welcome!)
147 Some libraries want to know where other libraries are. For this to
148 work, set the following environment variable
150 export PKG_CONFIG_PATH=${INSTALL_DIR}/lib/pkgconfig
151 export PATH=$INSTALL_DIR/bin:$PATH
154 find instructions on how to compile pkgconfig.
156 Since we are compiling libraries dynamically, they must know where to
157 find each other. This is done by setting an appropriate LDFLAGS.
158 Unfortunately, the syntax again differs from system to system:
160 Solaris
161 export LDFLAGS=-R${INSTALL_DIR}/lib
163 if you are using the Sun Studio/Forte compiler, you may also want
164 to set
166 CFLAGS="-xO3 -xcode=pic13" (SPARC)
167 CFLAGS="-xO3 -Kpic" (x86)
169 Linux
170 export LDFLAGS="-Wl,--rpath -Wl,${INSTALL_DIR}/lib"
172 HPUX
173 export LDFLAGS="+b${INSTALL_DIR}/lib"
175 AIX
176 export LDFLAGS="-Wl,-blibpath:${INSTALL_DIR}/lib"
178 If you have GNU make installed and it is not called 'make', then do
180 export MAKE=gmake
181 export GNUMAKE=gmake
183 otherwise just do
185 export MAKE=make
189 As mentioned above, without pkgconfig the whole build process will be
190 lots of pain and suffering, so make sure you have a copy on your
191 system. If it is not available natively, here is how to compile it.
193 wget http://pkgconfig.freedesktop.org/releases/pkg-config-0.23.tar.gz
194 gunzip -c pkg-config-0.23.tar.gz | tar xf -
195 cd pkg-config-0.23
196 ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC"
197 $MAKE
198 $MAKE install
200 After installing pkgconfig in a custom directory, setting up the
201 corresponding environment variable will be helpful.
203 export PKG_CONFIG=$INSTALL_DIR/bin/pkg-config
207 Chances are very high that you already have that on your system ...
209 cd $BUILD_DIR
210 wget http://oss.oetiker.ch/rrdtool/pub/libs/zlib-1.2.3.tar.gz
211 gunzip -c zlib-1.2.3.tar.gz | tar xf -
212 cd zlib-1.2.3
213 ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC" --shared
214 $MAKE
215 $MAKE install
219 Libpng itself requires zlib to build, so we need to help a bit. If you
220 already have a copy of zlib on your system (which is very likely) you
221 can drop the settings of LDFLAGS and CPPFLAGS. Note that the backslash
222 (\) at the end of line 4 means that line 4 and line 5 are on one line.
224 cd $BUILD_DIR
225 wget http://oss.oetiker.ch/rrdtool/pub/libs/libpng-1.2.18.tar.gz
226 gunzip -c libpng-1.2.18.tar.gz | tar xf -
227 cd libpng-1.2.10
228 env CFLAGS="-O3 -fPIC" ./configure --prefix=$INSTALL_DIR
229 $MAKE
230 $MAKE install
234 cd $BUILD_DIR
235 wget http://oss.oetiker.ch/rrdtool/pub/libs/freetype-2.3.5.tar.gz
236 gunzip -c freetype-2.3.5.tar.gz | tar xf -
237 cd freetype-2.3.5
238 ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC"
239 $MAKE
240 $MAKE install
242 If you run into problems building freetype on Solaris, you may want to
243 try to add the following at the start the configure line:
245 env EGREP=egrep
249 cd $BUILD_DIR
250 wget http://oss.oetiker.ch/rrdtool/pub/libs/libxml2-2.6.32.tar.gz
251 gunzip -c libxml2-2.6.32.tar.gz | tar xf -
252 cd libxml2-2.6.32
253 ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC"
254 $MAKE
255 $MAKE install
259 Note that fontconfig has a run time configuration file in
260 INSTALL_DIR/etc you may want to adjust that so that fontconfig finds
261 the fonts on your system. Run the fc-cache program to build the
262 fontconfig cache after changing the config file.
264 cd $BUILD_DIR
265 wget http://oss.oetiker.ch/rrdtool/pub/libs/fontconfig-2.4.2.tar.gz
266 gunzip -c fontconfig-2.4.2.tar.gz | tar xf -
267 cd fontconfig-2.4.2
268 ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC" --with-freetype-config=$INSTALL_DIR/bin/freetype-config
269 $MAKE
270 $MAKE install
274 cd $BUILD_DIR
275 wget http://oss.oetiker.ch/rrdtool/pub/libs/pixman-0.10.0.tar.gz
276 gunzip -c pixman-0.10.0.tar.gz | tar xf -
277 cd pixman-0.10.0
278 ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC"
279 $MAKE
280 $MAKE install
284 cd $BUILD_DIR
285 wget http://oss.oetiker.ch/rrdtool/pub/libs/cairo-1.6.4.tar.gz
286 gunzip -c cairo-1.6.4.tar.gz | tar xf -
287 cd cairo-1.6.4
288 ./configure --prefix=$INSTALL_DIR \
289 --enable-xlib=no \
290 --enable-xlib-render=no \
291 --enable-win32=no \
292 CFLAGS="-O3 -fPIC"
293 $MAKE
294 $MAKE install
298 cd $BUILD_DIR
299 wget http://oss.oetiker.ch/rrdtool/pub/libs/glib-2.15.4.tar.gz
300 gunzip -c glib-2.15.4.tar.gz | tar xf -
301 cd glib-2.15.4
302 ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC"
303 $MAKE
304 $MAKE install
308 cd $BUILD_DIR
309 wget http://oss.oetiker.ch/rrdtool/pub/libs/pango-1.21.1.tar.bz2
310 bunzip2 -c pango-1.21.1.tar.bz2 | tar xf -
311 cd pango-1.21.1
312 ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC" --without-x
313 $MAKE
314 $MAKE install
316 B\bBu\bui\bil\bld\bdi\bin\bng\bg r\brr\brd\bdt\bto\boo\bol\bl (\b(s\bse\bec\bco\bon\bnd\bd t\btr\bry\by)\b)
317 Now all the dependent libraries are built and you can try again. This
318 time you tell configure where it should be looking for libraries and
319 include files. This is done via environment variables. Depending on the
320 shell you are running, the syntax for setting environment variables is
321 different.
323 And finally try building again. We disable the python and tcl bindings
324 because it seems that a fair number of people have ill configured
325 python and tcl setups that would prevent RRDtool from building if they
326 are included in their current state.
328 cd $BUILD_DIR/rrdtool-1.4.3
329 ./configure --prefix=$INSTALL_DIR --disable-tcl --disable-python
330 $MAKE clean
331 $MAKE
332 $MAKE install
334 SOLARIS HINT: if you want to build the Perl module for the native Perl
335 (the one shipping with Solaris) you will need the Sun Forte compiler
336 installed on your box or you have to hand-tune
337 bindings/perl-shared/Makefile while building!
339 Now go to _\b$_\bI_\bN_\bS_\bT_\bA_\bL_\bL_\b__\bD_\bI_\bR/\b/s\bsh\bha\bar\bre\be/\b/r\brr\brd\bdt\bto\boo\bol\bl/\b/e\bex\bxa\bam\bmp\bpl\ble\bes\bs/\b/ and run them to see if
340 your build has been successful.
343 Tobias Oetiker <tobi@oetiker.ch>
347 1.4.3 2010-03-22 RRDBUILD(1)