The Director aims to be your new favourite Icinga config deployment tool. Director is designed for those who want to automate their configuration deployment and those who want to grant their “point & click” users easy access to the configuration.
Go to file
Thomas Gelf f073b4d6a9 rectorObjectForm: catch errors when setting props 2016-03-05 15:58:24 +01:00
application IcingaObjectFieldForm: fix proposed fields for... 2016-03-05 15:49:49 +01:00
doc docs/30-Automation.md: fixed path 2016-03-03 13:47:27 +01:00
library rectorObjectForm: catch errors when setting props 2016-03-05 15:58:24 +01:00
public js/module: fix JS error on missing id 2016-03-05 13:49:08 +01:00
schema schema/pgsql: fix tests for timeperiod_ranges 2016-03-02 20:51:41 +01:00
test/php/library/Director StateFilterTest: a couple of tests for state filters 2016-03-01 04:28:26 +01:00
.gitignore .gitignore: just ignore all hidden files 2016-03-01 04:18:04 +01:00
README.md README.md: remove PostgreSQL warining 2016-03-01 05:06:09 +01:00
configuration.php config/deployments: re-arrange urls and links 2016-02-28 16:52:37 +01:00
module.info module.info: remove outdated warning 2016-03-01 06:41:20 +01:00
run.php library/Director: fix PSR2 complaints 2016-02-26 11:58:37 +01:00

README.md

Icinga Director

Icinga Director has been designed to make Icinga 2 configuration handling easy. It tries to target two main audiences:

  • Users with the desire to completely automate their datacenter
  • Sysops willing to grant their "point & click" users a lot of flexibility

What makes Icinga Director so special is the fact that it tries to target both of them at once.

Icinga Director

Requirements

  • Icinga 2 (>= 2.4.3)
  • Icinga Web 2 (>= 2.2.0)
  • A database, MySQL (>= 5.1) or PostgreSQL (>= 9.1) database (MariaDB and other forks are also fine)
  • php5-curl

Installation

Create Icinga Director database

MySQL

mysql -e "CREATE DATABASE director CHARACTER SET 'utf8';
   GRANT ALL ON director.* TO director@localhost IDENTIFIED BY 'some-password';"

PostgreSQL

CREATE DATABASE director WITH ENCODING 'UTF8';
CREATE USER director WITH PASSWORD 'some-password';
GRANT ALL PRIVILEGES ON DATABASE director TO director;

Configure Icinga Web 2

As with any Icinga Web 2 module, installation is pretty straight-forward. In case you're installing it from source all you have to do is to drop the director module in one of your module paths. Then go to your web frontend, Configuration, Modules, director - and enable the module.

In your web frontend please go to System / Configuration / Resources and create a new database resource pointing to your newly created database. Last but not least you have to tell the director module to use this newly created database resource.

In case you prefer automated or manual installation please learn more about automated installations in the related section of our documentation.