Skip to content

danbeaman/cnwr-cacti

 
 

Repository files navigation

cacti

Build Status Coverage Status

Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with cacti
  4. Usage - Configuration options and additional functionality
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module
  7. 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

Release Notes

Version 0.0.1

  • create the module

Version 0.0.2

  • add testing and prepare for the forge

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Ruby 57.0%
  • Puppet 30.5%
  • HTML 12.5%