Jason's Home Page - Linux HOWTOs

rrdtool - A reimplementation of MRTGs graphing and logging features ChangeLog

Web site:

http://oss.oetiker.ch/rrdtool/

HOWTO

# RRDtool 1.4.7
# =============
# Prerequisites:
# gettext
# libdbi (optional)
# Cairo
# pkg-config
# Pango
# GLib
# libxml2
# Perl
# Ruby
# lua (optional; for lua bindings)
# Tcl (optional; for Tcl bindings)
# Python >= 2.3 (optional; for Python bindings)
# zlib
# libpng
# Freetype

# If you're upgrading from 1.2.x to 1.3.x be aware that libart has been
# replaced by cairo/pango (see NEWS)

cd
test -f installed/mrtg/rrdtool-1.4.7.tar.gz &&
mv installed/mrtg/rrdtool-1.4.7.tar.gz .
test ! -f rrdtool-1.4.7.tar.gz &&
wget http://oss.oetiker.ch/rrdtool/pub/rrdtool-1.4.7.tar.gz

# Verify tarball w/ sha1sum:
# (this came from my tarball, I couldn't find an md5 or sha1sum on the
# author's site or in the e-mail announcement; if you get an "OK", then
# yours is the same as mine (and if mine is broken or cracked, yours is too)
echo "faab7df7696b69f85d6f89dd9708d7cf0c9a273b rrdtool-1.4.7.tar.gz" \
| sha1sum -c

# Extract it
mkdir -p -m 0700 src/mrtg
find src src/mrtg -maxdepth 1 -type d -name "rrdtool-*" -exec rm -r {} \;
cd src/mrtg
tar xzvf ~/rrdtool-1.4.7.tar.gz
cd rrdtool-1.4.7
test $UID = 0 && chown -R root:root .

# I use --disable-nls because I only read/write English (well), if that
# is not the case for you, leave that off

# Configure and build it
./configure --disable-nls
make

# Now become root to install it
su

# Clean up old installations of RRDtool that are installed
# under /opt
find /opt -maxdepth 1 -type d -name "rrdtool-*" -exec rm -r {} \;

# Install the new one
make install
ln -sf /opt/rrdtool-1.4.7 /opt/rrdtool

# Note: The default installation path is /opt/rrdtool-* now. If you
# have scripts and such that look for it as /usr/local/rrdtool, you
# may want to just create a symlink pointing there:
# ln -sf /opt/rrdtool /usr/local/rrdtool

# If you want to add RRDtool's bin directory to your PATH and man directory
# to your MANPATH (log out and log in for it to take effect):
cat << EOF > /etc/profile.d/rrdtool.sh
#!/bin/sh
export PATH=\$PATH:/opt/rrdtool/bin
export MANPATH=\$MANPATH:/opt/rrdtool/share/man
EOF
chmod 755 /etc/profile.d/rrdtool.sh

# Become yourself again
exit

# Update PATH and MANPATH in your current (non-root) shell - or just
# log out and back in again:
echo $PATH | grep -q "/opt/rrdtool/bin" ||
export PATH=$PATH:/opt/rrdtool/bin
echo $MANPATH | grep -q "/opt/rrdtool/share/man" ||
export MANPATH=$MANPATH:/opt/rrdtool/man

cd
mkdir -p -m 0700 installed/mrtg
rm -f installed/rrdtool-*.tar.gz installed/mrtg/rrdtool-*.tar.gz
mv rrdtool-1.4.7.tar.gz installed/mrtg/

## Read one of these:
# lynx /opt/rrdtool/share/doc/rrdtool-1.4.7/html/rrdtool.html
# less -r /opt/rrdtool/share/doc/rrdtool-1.4.7/txt/rrdtool.txt
# perldoc /opt/rrdtool/share/doc/rrdtool-1.4.7/txt/rrdtool.pod

# If you ever want to uninstall RRDtool, run this:
su
test -L /opt/rrdtool && rm /opt/rrdtool
test -L /usr/local/rrdtool && rm /usr/local/rrdtool
find /opt -maxdepth 1 -type d -name "rrdtool-*" -exec rm -r {} \;
find /usr/local -maxdepth 1 -type d -name "rrdtool-*" -exec rm -r {} \;
rm -f ~/installed/rrdtool-*.tar.* ~/installed/mrtg/rrdtool-*.tar.*
find ~/src ~/src/mrtg -maxdepth 1 -type d -name "rrdtool-*" -exec rm -r {} \;
exit