2.9 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 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/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 grant the web server write permissions for the command pipe:
# chgrp www-data /var/run/icinga2/icinga2.cmd
# chmod 660 /var/run/icinga2/icinga2.cmd
Note
Change "www-data" to the group the Apache HTTP daemon 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