Installing Icinga Director on RHEL¶

The recommended way to install Icinga Director is to use prebuilt packages from our official release repository. If the repository is not configured yet, please add it first before installing the package.

All packages we provide are signed with the following key.

Adding Icinga Package Repository¶

Info

A paid repository subscription is required for RHEL repositories. Get more information on icinga.com/subscription.

Don’t forget to fill in the username and password section with appropriate credentials in the local .repo file.

Here’s how to add the official release repository:

curl https://packages.icinga.com/subscription/rhel/ICINGA-release.repo -o /etc/yum.repos.d/ICINGA-release.repo

Installing the Package¶

Use your distribution’s package manager to install the icinga-director package as follows:

dnf install icinga-director

Setting up the Database¶

A MySQL (≥5.7), MariaDB (≥10.1), or PostgreSQL (≥9.6) database is required to run Icinga Director. Please follow the steps listed for your target database, to set up the database and the user. The schema will be imported later via the web interface.

Setting up a MySQL or MariaDB Database¶

Warning Make sure to replace CHANGEME with a secure password.

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

Setting up a PostgreSQL Database¶

Warning Make sure to replace CHANGEME with a secure password.

psql -q -c "CREATE DATABASE director WITH ENCODING 'UTF8';"
psql director -q -c "CREATE USER director WITH PASSWORD 'CHANGEME';
GRANT ALL PRIVILEGES ON DATABASE director TO director;
CREATE EXTENSION pgcrypto;"

Configuring Icinga Director¶

Log in to your running Icinga Web setup with a privileged user and follow the steps below to configure Icinga Director:

Create a new resource for the Icinga Director database via the Configuration → Application → Resources menu. Please make sure that you configure utf8 as encoding.
Select Icinga Director directly from the main menu and you will be taken to the kickstart wizard. Follow the instructions and you are done!