icinga2/doc/2.2-setting-up-icinga-classic-ui.md

Setting up Icinga Classic UI

Icinga 2 can write status.dat and objects.cache files in the format that is supported by the Icinga 1.x Classic UI. External commands (a.k.a. the "command pipe") are also supported. It also supports writing Icinga 1.x log files which are required for the reporting functionality in the Classic UI.

Installing Icinga Classic UI

You can download and build Icinga 1.x Classic UI in standalone mode using the following commands:

$ wget http://downloads.sourceforge.net/project/icinga/icinga/1.10.0/icinga-1.10.0.tar.gz
$ tar xzf icinga-1.10.0.tar.gz ; cd icinga-1.10.0
$ ./configure --enable-classicui-standalone --prefix=/usr/local/icinga2-classicui
$ make classicui-standalone

Once you've built Classic UI you can install it:

# make install-classicui-standalone install-classicui-standalone-conf install-webconf-auth
# service apache2 restart

Note

A detailed guide on installing Icinga 1.x Classic UI Standalone can be found on the Icinga Wiki here: https://wiki.icinga.org/display/howtos/Setting+up+Icinga+Classic+UI+Standalone

Configuring Icinga 2

By default Icinga 2 does not write status.dat and objects.cache files which are used by the Classic UI. The command pipe is also not enabled by default.

You can use icinga2-enable-feature to enable these features:

# icinga2-enable-feature statusdata
# icinga2-enable-feature compatlog
# icinga2-enable-feature command

After enabling these features you will need to restart Icinga 2:

# /etc/init.d/icinga2 restart

You should be able to find the status.dat and objects.cache files in /var/cache/icinga2. The log files can be found in /var/log/icinga2/compat. The command pipe can be found in /var/run/icinga2/cmd/icinga2.cmd.

Configuring the Classic UI

After installing the Classic UI you will need to update the following settings in your cgi.cfg configuration file in the STANDALONE (ICINGA 2) OPTIONS section:

Configuration Setting	Value
object_cache_file	/var/cache/icinga2/objects.cache
status_file	/var/cache/icinga2/status.dat
resource_file	-
command_file	/var/run/icinga2/cmd/icinga2.cmd
check_external_commands	1
interval_length	60
status_update_interval	10
log_file	/var/log/icinga2/compat/icinga.log
log_rotation_method	h
log_archive_path	/var/log/icinga2/compat/archives
date_format	us

---

Note

Depending on how you installed Icinga 2 some of those paths and options might be different.

In order for commands to work you will need to add your web server user to the icingacmd group:

# usermod -a -G icingacmd www-data

Note

Change www-data to the user name your web server is running as.

Verify that your Icinga 1.x Classic UI works by browsing to your Classic UI installation URL, e.g. http://localhost/icinga