Skip to content
Upcoming Events

Background-Daemon

The Icinga Director Background Daemon is available (and mandatory) since v1.7.0. It is responsible for various background tasks, including fully automated Import, Sync & Config Deployment Tasks.

Daemon Installation

To run the Background Daemon, you need to tell systemd about your new service. First make sure that the system user icingadirector exists. In case it doesn’t, please create one:

useradd -r -g icingaweb2 -d /var/lib/icingadirector -s /bin/false icingadirector
install -d -o icingadirector -g icingaweb2 -m 0750 /var/lib/icingadirector

Then copy the provided Unit-File from our contrib to /etc/systemd/system, enable and start the service:

MODULE_PATH=/usr/share/icingaweb2/modules/director
cp "${MODULE_PATH}/contrib/systemd/icinga-director.service" /etc/systemd/system/
systemctl daemon-reload

Now your system knows about the Icinga Director Daemon. You should make sure that it starts automatically each time your system boots:

systemctl enable icinga-director.service

Starting the Daemon

You now can start the Background daemon like any other service on your Linux system:

systemctl start icinga-director.service

Stopping the Daemon

You now can stop the Background daemon like any other service on your Linux system:

systemctl stop icinga-director.service

Getting rid of the old Job Daemon

Before v1.7.0, Icinga Director shipped an optional Job Daemon. This one is no longer needed and should be removed from your system as follows:

systemctl stop director-jobs
systemctl disable director-jobs
rm /etc/systemd/system/director-jobs.service
systemctl daemon-reload