~ubuntu-branches/ubuntu/saucy/rrdtool/saucy-proposed

« back to all changes in this revision

Viewing changes to doc/rrdbuild.pod

  • Committer: Bazaar Package Importer
  • Author(s): Clint Byrum
  • Date: 2010-07-22 08:07:01 UTC
  • mfrom: (1.2.8 upstream) (3.1.6 sid)
  • Revision ID: james.westby@ubuntu.com-20100722080701-k46mgdfz6euxwqsm
Tags: 1.4.3-1ubuntu1
* Merge from debian unstable, Remaining changes:
  - debian/control: Don't build against ruby1.9 as we don't want
    it in main.
* require libdbi >= 0.8.3 to prevent aborts when using dbi datasources

Show diffs side-by-side

added added

removed removed

Lines of Context:
4
4
 
5
5
=head1 OVERVIEW
6
6
 
7
 
If you downloaded the source of rrdtool you have to compile it. This
 
7
If you downloaded the source of RRDtool you have to compile it. This
8
8
document will give some information on how this is done.
9
9
 
10
10
RRDtool relies on services of third part libraries. Some of these libraries
41
41
Once you have decided. Save the two locations into environment variables.
42
42
 
43
43
 BUILD_DIR=/tmp/rrdbuild
44
 
 INSTALL_DIR=/usr/local/rrdtool-1.3.8
 
44
 INSTALL_DIR=/opt/rrdtool-1.4.3
45
45
 
46
46
 
47
47
If your F</tmp> is mounted with the option noexec (RHEL seems todo that) you have to choose
55
55
Lets first assume you already have all the necessary libraries
56
56
pre-installed. 
57
57
 
58
 
 wget http://oss.oetiker.ch/rrdtool/pub/rrdtool-1.3.8.tar.gz
59
 
 gunzip -c rrdtool-1.3.8.tar.gz | tar xf -
60
 
 cd rrdtool-1.3.8
 
58
 wget http://oss.oetiker.ch/rrdtool/pub/rrdtool-1.4.3.tar.gz
 
59
 gunzip -c rrdtool-1.4.3.tar.gz | tar xf -
 
60
 cd rrdtool-1.4.3
61
61
 ./configure --prefix=$INSTALL_DIR && make && make install
62
62
 
63
63
Ok, this was very optimistic. This try will probably have ended with
68
68
If your OS lets you install additional packages from a software repository,
69
69
you may get away with installing the missing packages. When the packages are
70
70
installed, run configure again and try to compile again. Below you find some
71
 
hints on getting your OS ready for the rrdtool compilation. 
 
71
hints on getting your OS ready for compiling RRDtool.
72
72
 
73
 
Additions to this list are welcome. In general rrdtool should work with the
 
73
Additions to this list are welcome. In general RRDtool should work with the
74
74
latest versions of the libraries. The versions listed here are just what was
75
75
current when I tested this.
76
76
 
88
88
 
89
89
 perl -i~ -p -e 's/(Requires.*?)\s*xrender.*/$1/' /usr/lib/pkgconfig/cairo.pc 
90
90
 
91
 
Make sure rrdtool finds your new compiler
 
91
Make sure the RRDtool build system finds your new compiler
92
92
 
93
93
 export PATH=/opt/SunStudioExpress/bin
94
94
 
108
108
 
109
109
=head2 Gentoo
110
110
 
111
 
In Gentoo installing rrdtool is really simple you just need to B<emerge
 
111
In Gentoo installing RRDtool is really simple you just need to B<emerge
112
112
rrdtool>. All dependencies will be handled automatically by the portage
113
113
system. The only thing you should care about are USE flags, which allow you
114
 
fine tune features rrdtool will be built with. Currently the following USE
 
114
fine tune features RRDtool will be built with. Currently the following USE
115
115
flags are available:
116
116
 
117
117
 doc    - install .html and .txt documentation
143
143
 
144
144
If you are working with AIX, you may find the B<--disable-shared> option
145
145
will cause things to break for you. In that case you may have to install the
146
 
shared libraries into the rrdtool PREFIX and work with B<--disable-static>
 
146
shared libraries into the RRDtool PREFIX and work with B<--disable-static>
147
147
instead.
148
148
 
149
 
Another hint to get rrdtool working on AIX is to use the IBM XL C Compiler:
 
149
Another hint to get RRDtool working on AIX is to use the IBM XL C Compiler:
150
150
 
151
151
 export CC=/usr/vac/bin/cc
152
152
 export PERLCC=$CC
176
176
 
177
177
if you are using the Sun Studio/Forte compiler, you may also want to set
178
178
 
179
 
 export CFLAGS="-xO3 -xcode=pic13"   (SPARC)
180
 
 export CFLAGS="-xO3 -Kpic"          (x86)
181
 
 
 
179
 CFLAGS="-xO3 -xcode=pic13"   (SPARC)
 
180
 CFLAGS="-xO3 -Kpic"          (x86)
182
181
 
183
182
=item Linux
184
183
 
185
 
 export CFLAGS="-O3 -fPIC"
186
184
 export LDFLAGS="-Wl,--rpath -Wl,${INSTALL_DIR}/lib" 
187
185
 
188
186
=item HPUX
214
212
 wget http://pkgconfig.freedesktop.org/releases/pkg-config-0.23.tar.gz
215
213
 gunzip -c pkg-config-0.23.tar.gz | tar xf -
216
214
 cd pkg-config-0.23
217
 
 ./configure --prefix=$INSTALL_DIR
 
215
 ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC"
218
216
 $MAKE
219
217
 $MAKE install
220
218
 
231
229
 wget http://oss.oetiker.ch/rrdtool/pub/libs/zlib-1.2.3.tar.gz
232
230
 gunzip -c zlib-1.2.3.tar.gz | tar xf -
233
231
 cd zlib-1.2.3
234
 
 ./configure --prefix=$INSTALL_DIR --shared
 
232
 ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC" --shared
235
233
 $MAKE
236
234
 $MAKE install
237
235
 
245
243
 cd $BUILD_DIR
246
244
 wget http://oss.oetiker.ch/rrdtool/pub/libs/libpng-1.2.18.tar.gz
247
245
 gunzip -c libpng-1.2.18.tar.gz | tar xf -
248
 
 cd libpng-1.2.18
249
 
 ./configure --prefix=$INSTALL_DIR
 
246
 cd libpng-1.2.10
 
247
 env CFLAGS="-O3 -fPIC" ./configure --prefix=$INSTALL_DIR
250
248
 $MAKE
251
249
 $MAKE install
252
250
 
271
269
 wget http://oss.oetiker.ch/rrdtool/pub/libs/libxml2-2.6.32.tar.gz
272
270
 gunzip -c libxml2-2.6.32.tar.gz | tar xf -
273
271
 cd libxml2-2.6.32
274
 
 ./configure --prefix=$INSTALL_DIR
 
272
 ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC"
275
273
 $MAKE
276
274
 $MAKE install
277
275
 
286
284
 wget http://oss.oetiker.ch/rrdtool/pub/libs/fontconfig-2.4.2.tar.gz
287
285
 gunzip -c fontconfig-2.4.2.tar.gz   | tar xf -
288
286
 cd fontconfig-2.4.2
289
 
 ./configure --prefix=$INSTALL_DIR --with-freetype-config=$INSTALL_DIR/bin/freetype-config
 
287
 ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC" --with-freetype-config=$INSTALL_DIR/bin/freetype-config
290
288
 $MAKE
291
289
 $MAKE install
292
290
 
296
294
 wget http://oss.oetiker.ch/rrdtool/pub/libs/pixman-0.10.0.tar.gz
297
295
 gunzip -c pixman-0.10.0.tar.gz  | tar xf -
298
296
 cd pixman-0.10.0
299
 
 ./configure --prefix=$INSTALL_DIR
 
297
 ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC"
300
298
 $MAKE
301
299
 $MAKE install
302
300
 
309
307
 ./configure --prefix=$INSTALL_DIR \
310
308
    --enable-xlib=no \
311
309
    --enable-xlib-render=no \
312
 
    --enable-win32=no
 
310
    --enable-win32=no \
 
311
    CFLAGS="-O3 -fPIC"
313
312
 $MAKE
314
313
 $MAKE install
315
314
 
319
318
 wget http://oss.oetiker.ch/rrdtool/pub/libs/glib-2.15.4.tar.gz
320
319
 gunzip -c glib-2.15.4.tar.gz  | tar xf -
321
320
 cd glib-2.15.4
322
 
 ./configure --prefix=$INSTALL_DIR
 
321
 ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC"
323
322
 $MAKE
324
323
 $MAKE install
325
324
 
329
328
 wget http://oss.oetiker.ch/rrdtool/pub/libs/pango-1.21.1.tar.bz2
330
329
 bunzip2 -c pango-1.21.1.tar.bz2 | tar xf -
331
330
 cd pango-1.21.1
332
 
 ./configure --prefix=$INSTALL_DIR --without-x
 
331
 ./configure --prefix=$INSTALL_DIR CFLAGS="-O3 -fPIC" --without-x
333
332
 $MAKE
334
333
 $MAKE install
335
334
 
342
341
 
343
342
And finally try building again. We disable the python and tcl bindings
344
343
because it seems that a fair number of people have ill configured python and
345
 
tcl setups that would prevent rrdtool from building if they are included in
 
344
tcl setups that would prevent RRDtool from building if they are included in
346
345
their current state.
347
346
 
348
 
 cd $BUILD_DIR/rrdtool-1.3.8
 
347
 cd $BUILD_DIR/rrdtool-1.4.3
349
348
 ./configure --prefix=$INSTALL_DIR --disable-tcl --disable-python
350
349
 $MAKE clean
351
350
 $MAKE