cookbook 'cacti', '= 0.2.0'
cacti (7) Versions 0.2.0 Follow3
Cookbook for installing/configuring Cacti
cookbook 'cacti', '= 0.2.0', :supermarket
knife supermarket install cacti
knife supermarket download cacti
chef-cacti 
Description
Install/configures Cacti server.
Requirements
Platforms
- CentOS 6
- Red Hat Enterprise Linux 6
- Ubuntu 12.04
Databases
- MySQL
Cookbooks
Attributes
These attributes are under the node['cacti'] namespace.
| Attribute | Description | Type | Default |
|---|---|---|---|
| version | Version of Cacti to install | String | "0.8.8a", but currently is dependent on package available |
| user | Username to own Cacti files | String | cacti |
| group | Group to own Cacti files | String | apache2 |
| cron_minute | Schedule to pass to cron | String | "*/5" |
Apache2 Attributes
These attributes are under the node['cacti']['apache2'] namespace.
| Attribute | Description | Type | Default |
|---|---|---|---|
| server_aliases | VirtualHost ServerAliases | Array of Strings | [ node['hostname'] ] |
| server_name | VirtualHost ServerName | String | node['fqdn'] |
| conf_dir | Apache configuration dir | String | '/etc/httpd/conf.d' |
| doc_root | VirtualHost DocumentRoot | String | /var/www/html |
These attributes are under the node['cacti']['apache2']['ssl'] namespace.
| Attribute | Description | Type | Default |
|---|---|---|---|
| certificate_file | mod_ssl CertificateFile | String | /etc/pki/tls/certs/localhost.crt |
| chain_file | mod_ssl CertificateChainFile | String | "" |
| force | Force HTTPS | Boolean | false |
| key_file | mod_ssl CertificateKeyFile | String | /etc/pki/tls/private/localhost.key |
| enabled | Support HTTPS | Boolean | true |
Spine Attributes
These attributes are under the node['cacti']['spine'] namespace.
| Attribute | Description | Type | Default |
|---|---|---|---|
| checksum | Checksum for Spine | String | - |
| url | URL for Spine installation | String | |
| version | Version of Spine to install | String | node['cacti']['version'] |
Recipes
-
recipe[cacti]empty recipe. -
recipe[cacti::server]will install Cacti server. -
recipe[cacti::spine]will install Spine for Cacti server.
Usage
Cacti Server Required Data Bag
Create a cacti/server encrypted data bag with the following information per Chef environment:
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 Server Installation
- Create required encrypted data bag:
knife data bag create cacti server --secret-file=path/to/secret - Add
recipe[cacti::server]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
Contributing
Please use standard Github issues/pull requests.
Contributors
- Brian Flad (bflad417@gmail.com)
- Morgan Blackthorne (@stormerider)
Dependent cookbooks
| apache2 >= 0.0.0 |
| build-essential >= 0.0.0 |
| cron >= 0.0.0 |
| database >= 0.0.0 |
| mysql >= 0.0.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
