← Back to branch summary

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

« back to all changes in this revision

Viewing changes to doc/rrdbuild.1

  • 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:
doc/rrdbuild.1
124
124
.\" ========================================================================
125
125
.\"
126
126
.IX Title "RRDBUILD 1"
127
 
.TH RRDBUILD 1 "2009-05-19" "1.3.8" "rrdtool"
 
127
.TH RRDBUILD 1 "2010-03-22" "1.4.3" "rrdtool"
128
128
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
129
129
.\" way too many mistakes in technical documents.
130
130
.if n .ad l
133
133
rrdbuild \- Instructions for building RRDtool
134
134
.SH "OVERVIEW"
135
135
.IX Header "OVERVIEW"
136
 
If you downloaded the source of rrdtool you have to compile it. This
 
136
If you downloaded the source of RRDtool you have to compile it. This
137
137
document will give some information on how this is done.
138
138
.PP
139
139
RRDtool relies on services of third part libraries. Some of these libraries
162
162
.PP
163
163
.Vb 2
164
164
\& BUILD_DIR=/tmp/rrdbuild
165
 
\& INSTALL_DIR=/usr/local/rrdtool\-1.3.8
 
165
\& INSTALL_DIR=/opt/rrdtool\-1.4.3
166
166
.Ve
167
167
.PP
168
168
If your \fI/tmp\fR is mounted with the option noexec (\s-1RHEL\s0 seems todo that) you have to choose
179
179
pre-installed.
180
180
.PP
181
181
.Vb 4
182
 
\& wget http://oss.oetiker.ch/rrdtool/pub/rrdtool\-1.3.8.tar.gz
183
 
\& gunzip \-c rrdtool\-1.3.8.tar.gz | tar xf \-
184
 
\& cd rrdtool\-1.3.8
 
182
\& wget http://oss.oetiker.ch/rrdtool/pub/rrdtool\-1.4.3.tar.gz
 
183
\& gunzip \-c rrdtool\-1.4.3.tar.gz | tar xf \-
 
184
\& cd rrdtool\-1.4.3
185
185
\& ./configure \-\-prefix=$INSTALL_DIR && make && make install
186
186
.Ve
187
187
.PP
192
192
If your \s-1OS\s0 lets you install additional packages from a software repository,
193
193
you may get away with installing the missing packages. When the packages are
194
194
installed, run configure again and try to compile again. Below you find some
195
 
hints on getting your \s-1OS\s0 ready for the rrdtool compilation.
 
195
hints on getting your \s-1OS\s0 ready for compiling RRDtool.
196
196
.PP
197
 
Additions to this list are welcome. In general rrdtool should work with the
 
197
Additions to this list are welcome. In general RRDtool should work with the
198
198
latest versions of the libraries. The versions listed here are just what was
199
199
current when I tested this.
200
200
.SS "OpenSolaris 2008.05"
215
215
\& perl \-i~ \-p \-e \*(Aqs/(Requires.*?)\es*xrender.*/$1/\*(Aq /usr/lib/pkgconfig/cairo.pc
216
216
.Ve
217
217
.PP
218
 
Make sure rrdtool finds your new compiler
 
218
Make sure the RRDtool build system finds your new compiler
219
219
.PP
220
220
.Vb 1
221
221
\& export PATH=/opt/SunStudioExpress/bin
239
239
.Ve
240
240
.SS "Gentoo"
241
241
.IX Subsection "Gentoo"
242
 
In Gentoo installing rrdtool is really simple you just need to \fBemerge
 
242
In Gentoo installing RRDtool is really simple you just need to \fBemerge
243
243
rrdtool\fR. All dependencies will be handled automatically by the portage
244
244
system. The only thing you should care about are \s-1USE\s0 flags, which allow you
245
 
fine tune features rrdtool will be built with. Currently the following \s-1USE\s0
 
245
fine tune features RRDtool will be built with. Currently the following \s-1USE\s0
246
246
flags are available:
247
247
.PP
248
248
.Vb 7
276
276
.IX Subsection "General build tips for AIX"
277
277
If you are working with \s-1AIX\s0, you may find the \fB\-\-disable\-shared\fR option
278
278
will cause things to break for you. In that case you may have to install the
279
 
shared libraries into the rrdtool \s-1PREFIX\s0 and work with \fB\-\-disable\-static\fR
 
279
shared libraries into the RRDtool \s-1PREFIX\s0 and work with \fB\-\-disable\-static\fR
280
280
instead.
281
281
.PP
282
 
Another hint to get rrdtool working on \s-1AIX\s0 is to use the \s-1IBM\s0 \s-1XL\s0 C Compiler:
 
282
Another hint to get RRDtool working on \s-1AIX\s0 is to use the \s-1IBM\s0 \s-1XL\s0 C Compiler:
283
283
.PP
284
284
.Vb 2
285
285
\& export CC=/usr/vac/bin/cc
312
312
if you are using the Sun Studio/Forte compiler, you may also want to set
313
313
.Sp
314
314
.Vb 2
315
 
\& export CFLAGS="\-xO3 \-xcode=pic13"   (SPARC)
316
 
\& export CFLAGS="\-xO3 \-Kpic"          (x86)
 
315
\& CFLAGS="\-xO3 \-xcode=pic13"   (SPARC)
 
316
\& CFLAGS="\-xO3 \-Kpic"          (x86)
317
317
.Ve
318
318
.IP "Linux" 4
319
319
.IX Item "Linux"
320
 
.Vb 2
321
 
\& export CFLAGS="\-O3 \-fPIC"
 
320
.Vb 1
322
321
\& export LDFLAGS="\-Wl,\-\-rpath \-Wl,${INSTALL_DIR}/lib"
323
322
.Ve
324
323
.IP "\s-1HPUX\s0" 4
357
356
\& wget http://pkgconfig.freedesktop.org/releases/pkg\-config\-0.23.tar.gz
358
357
\& gunzip \-c pkg\-config\-0.23.tar.gz | tar xf \-
359
358
\& cd pkg\-config\-0.23
360
 
\& ./configure \-\-prefix=$INSTALL_DIR
 
359
\& ./configure \-\-prefix=$INSTALL_DIR CFLAGS="\-O3 \-fPIC"
361
360
\& $MAKE
362
361
\& $MAKE install
363
362
.Ve
379
378
\& wget http://oss.oetiker.ch/rrdtool/pub/libs/zlib\-1.2.3.tar.gz
380
379
\& gunzip \-c zlib\-1.2.3.tar.gz | tar xf \-
381
380
\& cd zlib\-1.2.3
382
 
\& ./configure \-\-prefix=$INSTALL_DIR \-\-shared
 
381
\& ./configure \-\-prefix=$INSTALL_DIR CFLAGS="\-O3 \-fPIC" \-\-shared
383
382
\& $MAKE
384
383
\& $MAKE install
385
384
.Ve
396
395
\& cd $BUILD_DIR
397
396
\& wget http://oss.oetiker.ch/rrdtool/pub/libs/libpng\-1.2.18.tar.gz
398
397
\& gunzip \-c libpng\-1.2.18.tar.gz | tar xf \-
399
 
\& cd libpng\-1.2.18
400
 
\& ./configure \-\-prefix=$INSTALL_DIR
 
398
\& cd libpng\-1.2.10
 
399
\& env CFLAGS="\-O3 \-fPIC" ./configure \-\-prefix=$INSTALL_DIR
401
400
\& $MAKE
402
401
\& $MAKE install
403
402
.Ve
430
429
\& wget http://oss.oetiker.ch/rrdtool/pub/libs/libxml2\-2.6.32.tar.gz
431
430
\& gunzip \-c libxml2\-2.6.32.tar.gz | tar xf \-
432
431
\& cd libxml2\-2.6.32
433
 
\& ./configure \-\-prefix=$INSTALL_DIR
 
432
\& ./configure \-\-prefix=$INSTALL_DIR CFLAGS="\-O3 \-fPIC"
434
433
\& $MAKE
435
434
\& $MAKE install
436
435
.Ve
448
447
\& wget http://oss.oetiker.ch/rrdtool/pub/libs/fontconfig\-2.4.2.tar.gz
449
448
\& gunzip \-c fontconfig\-2.4.2.tar.gz   | tar xf \-
450
449
\& cd fontconfig\-2.4.2
451
 
\& ./configure \-\-prefix=$INSTALL_DIR \-\-with\-freetype\-config=$INSTALL_DIR/bin/freetype\-config
 
450
\& ./configure \-\-prefix=$INSTALL_DIR CFLAGS="\-O3 \-fPIC" \-\-with\-freetype\-config=$INSTALL_DIR/bin/freetype\-config
452
451
\& $MAKE
453
452
\& $MAKE install
454
453
.Ve
461
460
\& wget http://oss.oetiker.ch/rrdtool/pub/libs/pixman\-0.10.0.tar.gz
462
461
\& gunzip \-c pixman\-0.10.0.tar.gz  | tar xf \-
463
462
\& cd pixman\-0.10.0
464
 
\& ./configure \-\-prefix=$INSTALL_DIR
 
463
\& ./configure \-\-prefix=$INSTALL_DIR CFLAGS="\-O3 \-fPIC"
465
464
\& $MAKE
466
465
\& $MAKE install
467
466
.Ve
469
468
\fIBuilding Cairo\fR
470
469
.IX Subsection "Building Cairo"
471
470
.PP
472
 
.Vb 10
 
471
.Vb 11
473
472
\& cd $BUILD_DIR
474
473
\& wget http://oss.oetiker.ch/rrdtool/pub/libs/cairo\-1.6.4.tar.gz
475
474
\& gunzip \-c cairo\-1.6.4.tar.gz   | tar xf \-
477
476
\& ./configure \-\-prefix=$INSTALL_DIR \e
478
477
\&    \-\-enable\-xlib=no \e
479
478
\&    \-\-enable\-xlib\-render=no \e
480
 
\&    \-\-enable\-win32=no
 
479
\&    \-\-enable\-win32=no \e
 
480
\&    CFLAGS="\-O3 \-fPIC"
481
481
\& $MAKE
482
482
\& $MAKE install
483
483
.Ve
490
490
\& wget http://oss.oetiker.ch/rrdtool/pub/libs/glib\-2.15.4.tar.gz
491
491
\& gunzip \-c glib\-2.15.4.tar.gz  | tar xf \-
492
492
\& cd glib\-2.15.4
493
 
\& ./configure \-\-prefix=$INSTALL_DIR
 
493
\& ./configure \-\-prefix=$INSTALL_DIR CFLAGS="\-O3 \-fPIC"
494
494
\& $MAKE
495
495
\& $MAKE install
496
496
.Ve
503
503
\& wget http://oss.oetiker.ch/rrdtool/pub/libs/pango\-1.21.1.tar.bz2
504
504
\& bunzip2 \-c pango\-1.21.1.tar.bz2 | tar xf \-
505
505
\& cd pango\-1.21.1
506
 
\& ./configure \-\-prefix=$INSTALL_DIR \-\-without\-x
 
506
\& ./configure \-\-prefix=$INSTALL_DIR CFLAGS="\-O3 \-fPIC" \-\-without\-x
507
507
\& $MAKE
508
508
\& $MAKE install
509
509
.Ve
516
516
.PP
517
517
And finally try building again. We disable the python and tcl bindings
518
518
because it seems that a fair number of people have ill configured python and
519
 
tcl setups that would prevent rrdtool from building if they are included in
 
519
tcl setups that would prevent RRDtool from building if they are included in
520
520
their current state.
521
521
.PP
522
522
.Vb 5
523
 
\& cd $BUILD_DIR/rrdtool\-1.3.8
 
523
\& cd $BUILD_DIR/rrdtool\-1.4.3
524
524
\& ./configure \-\-prefix=$INSTALL_DIR \-\-disable\-tcl \-\-disable\-python
525
525
\& $MAKE clean
526
526
\& $MAKE