mdxp / icinga-cookbook

icinga-cookbook

DESCRIPTION:

Installs and configures Icinga server.

REQUIREMENTS:

Cookbooks

• apache2
• build-essential

ATTRIBUTES:

See attributes/default.rb

Data Bags

Minimum requirements for users databag format:

Users

Create a users data bag that will contain the users that will be able to log into the Icinga webui. Each user can use htauth with a specified password. Users that should be able to log in should be in the sysadmin group. Example user data bag item:

{
  "id": "icinga",
  "groups": "sysadmin",
  "htpasswd": "hashed_htpassword",
  "icinga": {
    "icinga_email": "[email protected]"
  }
}

• email - This key must exist for each user with a sysadmin group value
• htpasswd - Used to have access

The htpasswd must be the hashed value. Get this value with htpasswd:

  % htpasswd -n -s icinga
  New password:
  Re-type new password:
  icinga:{SHA}8XLF6eTYQKVTVogqK2RIRrMCshY=

For example use the {SHA}8XLF6eTYQKVTVogqK2RIRrMCshY= value in the data bag.

USAGE:

Also, you will need one node with a "monitoring" role (I applying it to my icinga node, and this can be just a skeleton. This is just so that one of the templates generates correctly, and this requirement will likely be alleviated in future versions.)

Monitoring Role

Create a role to use for the monitoring server. The role name should match the value of the attribute "node['icinga']['server_role']". For example:

  % cat roles/monitoring.rb
  name "monitoring"
  description "Monitoring server"
  run_list(
    "recipe[icinga::server]"
  )


  % knife role from file monitoring.rb

icinga-cookbook's Issues

Vagrant - service not found

Hi Marius,

Forgive my ignorance if I oversee something, but on Vagrant 1.1.4 with the Berkshelf-plugin 1.0.6 installed, no extra stuff added nor configured, I end up with this error:

FATAL: Chef::Exceptions::ResourceNotFound: resource template[/usr/local/icinga/etc/icinga.cfg] is configured to notify resource service[icinga] with action restart, but service[icinga] cannot be found in the resource collection. template[/usr/local/icinga/etc/icinga.cfg] is defined in /tmp/vagrant-chef-1/chef-solo-1/cookbooks/icinga/definitions/icinga_conf.rb:3:in `block in from_file'

So, anything I've missed?