chef-cacti

Description

Install/configures Cacti and optionally Spine.

Requirements

Chef

• Chef 11 (for 0.3.0+ of cookbook)

Platforms

• CentOS 6
• Fedora 19, 20
• PLD Linux Th (Experimental)
• Red Hat Enterprise Linux 6
• Ubuntu 12.04, 12.10, 13.04, 13.10

Databases

• MySQL

Cookbooks

Opscode Cookbooks

• apache2
• apt
• build-essentials
• cron
• database
• mysql
• yum-epel

Attributes

These attributes are under the node['cacti'] namespace.

Admin Attributes

These attributes are under the node['cacti']['admin'] namespace.

Apache2 Attributes

These attributes are under the node['cacti']['apache2'] namespace.

These attributes are under the node['cacti']['apache2']['ssl'] namespace.

Database Attributes

All of these node['cacti']['database'] attributes are overridden by cacti/server encrypted data bag (Hosted Chef) or data bag (Chef Solo), if it exists

rrdtool Attributes

These attributes are under the node['cacti']['rrdtool'] namespace.

Spine Attributes

These attributes are under the node['cacti']['spine'] namespace.

Recipes

• recipe[cacti] Installs/configures Cacti
• recipe[cacti::apache2] Installs/configures Apache 2 and PHP for Cacti
• recipe[cacti::configuration] Configures Cacti configuration files
• recipe[cacti::cron] Installs Cacti polling cron entry
• recipe[cacti::database] Installs/configures Cacti MySQL server
• recipe[cacti::package] Installs Cacti via packages
• recipe[cacti::spine] Install Spine for Cacti

LWRPs

• cacti_device: Creating Devices
• cacti_graph: Creating Draphs
• cacti_tree: Adding entries to Tree
• cacti_data_query: Adding data_queries to a Device

Currently only Creating and Adding is supported.

See full documentation for each LWRP and action below for more information.

cacti_device

Only action supported is :create, which is the default.

cacti_graph

Only action supported is :create, which is the default.

cacti_tree

Only action supported is :create, which is the default.

cacti_data_query

Only action supported is :create, which is the default.

Usage

Cacti Server Data Bag

For securely overriding attributes on Hosted Chef, create a cacti/server encrypted data bag with the model below. Chef Solo can override the same attributes with a cacti/server unencrypted data bag of the same information.

required:
* ['admin']['password'] - local administrator password
* ['database']['host'] - FQDN or "localhost" (localhost automatically installs/configures database)
* ['database']['name'] - Name of Cacti database
* ['database']['user'] - Cacti database username
* ['database']['password'] - Cacti database username password

optional:
* ['database']['port'] - Database port, defaults to 3306

Repeat for other Chef environments as necessary. Example:

{
  "id": "server",
  "development": {
    "admin": {
      "password": "cacti_admin_password"
    },
    "database": {
      "host": "localhost",
      "name": "cacti",
      "user": "cacti",
      "password": "cacti_db_password"
    }
  }
}

Cacti Default Installation

• Create recommended (encrypted) data bag: knife data bag create cacti server --secret-file=path/to/secret
• Add recipe[cacti] to your node's run list.
• Browse to http://node['cacti']['apache2']['server_name']/cacti

Cacti Spine Installation

• Add recipe[cacti::spine] to your node's run list.
  • If non-localhost database:
  • Login as administrator
  • Settings > Paths > Spine Poller File Path: /usr/bin/spine
  • Settings > Poller > Poller Type: spine

Testing and Development

Here's how you can quickly get testing or developing against the cookbook thanks to Vagrant and Berkshelf.

vagrant plugin install vagrant-berkshelf
vagrant plugin install vagrant-cachier
vagrant plugin install vagrant-omnibus
git clone git://github.com/bflad/chef-cacti.git
cd chef-cacti
vagrant up BOX # BOX being centos5, centos6, debian7, fedora18, fedora19, fedora20, freebsd9, ubuntu1204, ubuntu1210, ubuntu1304, or ubuntu1310

You can then SSH into the running VM using the vagrant ssh BOX command.

The VM can easily be stopped and deleted with the vagrant destroy command. Please see the official Vagrant documentation for a more in depth explanation of available commands.

Contributing

Please use standard Github issues/pull requests.

Contributors

• Brian Flad (bflad417@gmail.com)
• Morgan Blackthorne (@stormerider)
• Elan Ruusamäe (@glensc)