Forge Home


A Puppet Module to install and configure the Round Robin Database tools, cache and bindings.


7,413 latest version

5.0 quality score

Version information

  • 0.1.3 (latest)
  • 0.1.2
  • 0.1.1
  • 0.1.0
  • 0.0.1 (deleted)
released Jul 29th 2015
This version is compatible with:
  • , , ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'Aethylred-rrd', '0.1.3'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add Aethylred-rrd
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install Aethylred-rrd --version 0.1.3

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.



Aethylred/rrd — version 0.1.3 Jul 29th 2015


This is a Puppet Module for installing and configuring the Round Robin Database tools, cache, and bindings.

Build Status


Why should there be a Puppet module for installing something as simple as RRD?

This module is mostly to cover dependencies when creating Puppet Modules for other tools or application that use RRD (e.g. Ganglia, Nagios, Cacti, etc). RRD is an application in it's own right and should be described independently.

The objective with this module is to provide a safe and consistently managed installation of RRD that can be depended on by other services and applications.


No dependencies on other Puppet Modules


Install RRD libraries

To only install the RRD libraries:

include rrd

Note: as the libraries are dependencies for the other RRD packages (rrdtool and rrdcached) the rrd class is not required by the other classes. It is simply for a lightweight RRD install.

Install the RRD tools

To install the RRD tools (a.k.a. rrdtool):

include rrd::tool

Default install the RRD cache daemon

For the default install of the RRD cache daemon (a.k.a. rrdcached):

include rrd::cache

Customised install of the RRD cache daemon

The rrd::cache class has the following parameters:

  • service: The enable parameter for the rrdcached service. Default is 'running'.
  • gid: the group ID that the rrdcached runs under. Default is undefined, which uses system default.
  • listen: the Unix socket that rrcached listens on. Defaults to 'unix:/var/run/rrdcached.sock'
  • journal_dir: The path where rrcached stores the cache journal. Defaults to '/var/lib/rrdcached/journal/'
  • timeout: Default is '1800'.
  • delay: Default is '1800'
  • write_threads: Default is '4'
  • jump_dir: Default is '/var/lib/rrdcached/db/'
  • always_flush: Default is true
  • enable_corefiles: Default is false
  • restrict_writes: Default is false
  • maxwait: Default is '30'
  • conf_file: The path to the rrdcached configuration file. Default is set approprately for operating system family.
  • service_name: The name of the rrdcached service. Default is set approprately for operating system family.

Install RRD language bindings

The module will install the RRD language bindings for Perl, PHP, Python, Ruby, and tcl. Install them in the following form, just replace the language name as appropriate:

include rrd::bindings::perl


This module uses the following modules for inspiration and reused code:


This module is derived from the puppet-blank module by Aaron Hicks (

This module has been developed for the use with Open Source Puppet (Apache 2.0 license) for automating server & service deployment.


This file is part of the rrd Puppet module.

Licensed under the Apache License, Version 2.0