cacti

Overview
Module Description - What the module does and why it is useful
Setup - The basics of getting started with cacti
- What cacti affects
- Beginning with cacti
Usage - Configuration options and additional functionality
Limitations - OS compatibility, etc.
Development - Guide for contributing to the module
Release Notes - Changelog

Overview

Installs Cacti and manages all of its dependencies.

Module Description

The Cacti module installs, configures, and manages all of Cacti's dependencies.

Uses the puppetlabs-mysql module to install, manage, and configure mariadb for use with cacti.

Uses rmueller-cron to manage /etc/cron.d/cacti.

Setup

What cacti affects

Installed Packages

httpd
mariadb-server
php-mysql
php-pdo
php-common
php
php-cli
php-snmp
net-snmp-utils
net-snmp-libs
rrdtool

Managed Services

httpd
mariadb
snmpd

Managed Files

/etc/cacti/db.php
/etc/httpd/conf.d/cacti.conf
/etc/cron.d/cacti

Beginning with cacti

To get started using the cacti module with default settings use:

include ::cacti

However, the following NEED to be defined in hiera since no defaults are provided:

cacti::database_root_pass
cacti::database_pass
cacti::managed_services

Alternatively, if hiera is not available you can pass in the parameters directly:

class { '::cacti':
  database_root_pass => 'yourpass',
  database_pass => 'yourpass',
  managed_services => [ 'httpd', 'snmpd' ],
}

Usage

The following can be changed from their defaults by specifying values either in hiera or by passing them in as parameters:

cacti::cacti_package - Cacti's package name - DEFAULTS to "cacti"
cacti::database_root_pass - The database password for the root user
cacti::database_type - The type of database used - DEFAULTS to "mysql"
cacti::database_default - The database used by cacti - DEFAULTS to "cacti"
cacti::database_host - The hostname where the database in installed - DEFAULTS to "localhost"
cacti::database_user - The database user that cacti uses - DEFAULTS to "cacti"
cacti::database_pass - The database password for the cacti user
cacti::database_port - The port that the database is listening on - DEFAULTS to "3306"
cacti::database_ssl - Use SSL for database communication - DEFAULTS to "false"
cacti::managed_services - The services that this module will manage. Unless being managed elsewhere, you should define this as => [ 'httpd, 'snmpd' ]

Parameter example

class { '::cacti':
  cacti_package => 'cacti',
  database_root_pass => 'yourpass',
  database_pass => 'yourpass',
  database_type => 'mysql',
  database_default => 'cacti',
  database_host => 'localhost',
  database_user => 'cacti',
  database_port => '3306',
  database_ssl => false,
  managed_services => [ 'httpd', 'snmpd' ],
}

Limitations

Currently only the following Operating Systems are supported:

RHEL 7
CentOS 7

Development

If you wish to contribute to this module please either add an issue or better yet submit a Pull Request

danbeaman/cnwr-cacti