3.2 KiB
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.
These features are implemented as part of the compat library and are enabled by default in the example configuration file.
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.
Installing Icinga Classic UI
You can install Icinga 1.x Classic UI in standalone mode using the following commands:
$ wget http://downloads.sourceforge.net/project/icinga/icinga/1.9.3/icinga-1.9.3.tar.gz
$ tar xzf icinga-1.9.3.tar.gz ; cd icinga-1.9.3
$ ./configure --enable-classicui-standalone --prefix=/usr/local/icinga2-classicui
$ make classicui-standalone
$ sudo make install-classicui-standalone install-webconf-auth
$ sudo 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 i2enfeature to enable these features:
# i2enfeature statusdat
# i2enfeature command
After enabling these features you will need to restart Icinga 2:
# /etc/init.d/icinga2 restart
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