What is RRDtool?
RRDtool is the OpenSource industry standard, high performance data logging and graphing system for time series data.
Installing RRDtool
If you want to store data in round-robin databases and generate graphs, then you'll need to install RRDtool. It is recommended that you use the package management tools available for your system to install RRDtool.
In order to use RRDtool from panoptes, you will additionally need to install perl library RRDs. Note that RRDs comes with RRDtool and cannot be installed from CPAN.
Installing RRD::Simple
Panoptes uses RRD::Simple from CPAN. Installing it should be as simple as:
# perl -MCPAN -e"install RRD::Simple"
Validating the install
Try the following commands to check if RRDs and RRD::Simple were installed properly.
perl -e'use RRDs; print "ok\n"'
perl -e'use RRD::Simple; print "ok\n"'
Both commands should print simply 'ok' if the libraries are found.
Make sure that the 'perl' you are running (from $PATH) is the same one being used in the panoptes scripts.
# check the first line of one of the scripts
head -1 /path/to/panoptes
# check where perl is executed from at the command line
which perl
Troubleshooting
The RRDs perl library is likely to be installed in the site_perl lib directory of the perl that came with your packaging system. If you installed RRDs from a packaging system and are using a non-default installation of perl, you may need to locate RRDs on the filesystem and copy it to an appropriate directory.
Building RRDtool
If you want building RRDtool manually, be aware that it has a rather huge dependency list. You want to consider installing RRDtool from your packaging system in order to get all the prereqs installed.
Here are the options I tend to use with configure:
./configure --enable-perl-site-install --disable-tcl --disable-ruby