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 3df0115895 run.php: cleanup, add property modifiers 2016-02-17 16:41:46 +01:00
application InspectController: delegate api instantiation 2016-02-17 16:40:43 +01:00
doc doc/70-REST-API: small enhancements 2016-02-04 16:40:18 +01:00
library ActionController: get api from endpoint object 2016-02-17 16:40:08 +01:00
public css: align password field to text field size 2016-02-05 17:18:13 +01:00
schema schema/mysql: forgot to raise schema version 2016-02-17 15:37:35 +01:00
test/php Test: Add first insane test for TimePeriodRanges^ 2015-07-01 16:47:44 +02:00
.gitignore Add .gitignore file to the project 2015-04-24 16:57:54 +02:00
README.md Migrations: implement DB migration helpers 2016-02-08 22:33:28 +01:00
configuration.php welcome: move to index, icingaweb2/director 2015-12-17 21:57:27 +01:00
module.info module.info: fix typo 2015-04-21 14:29:11 +02:00
run.php run.php: cleanup, add property modifiers 2016-02-17 16:41:46 +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.

Requirements

  • Icinga 2 (>= 2.4.0)
  • Icinga Web 2 (>= 2.1.0)
  • MySQL or PostgreSQL database
  • PostgreSQL: the schema is lacking behind right now, we'll fix this soon. If you want to start testing Director today please use MySQL

Installation

Create Icinga Director database

MySQL:

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

mysql director < schema/mysql.sql

PostgreSQL:

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

psql director < schema/pgsql.sql

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.