Forge Home

rrd

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

13,142 downloads

7,697 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

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.

Download

Documentation

Aethylred/rrd — version 0.1.3 Jul 29th 2015

RRD

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

Build Status

Purpose

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.

Dependencies

No dependencies on other Puppet Modules

Usage

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

References

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

Attribution

This module is derived from the puppet-blank module by Aaron Hicks (aethylred@gmail.com)

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

Licensing

This file is part of the rrd Puppet module.

Licensed under the Apache License, Version 2.0