From 8497fc3605d5a3e238f404b2a18890757ae0e839 Mon Sep 17 00:00:00 2001 From: Markus Frosch Date: Tue, 9 Sep 2014 16:16:47 +0200 Subject: [PATCH] Extend documentation for icinga-web on Debian based systems Fixes #7158 --- doc/2-getting-started.md | 33 +++++++++++++++++++++++++++++++-- 1 file changed, 31 insertions(+), 2 deletions(-) diff --git a/doc/2-getting-started.md b/doc/2-getting-started.md index 3f3cf8f5a..735f83fe1 100644 --- a/doc/2-getting-started.md +++ b/doc/2-getting-started.md @@ -957,9 +957,11 @@ The Icinga package repository has both Debian and RPM packages. You can install Icinga Web using the following packages (RPMs ship an additional configuration package): Distribution | Packages - --------------|------------------------------------- + --------------|------------------------------------------------------- RHEL/SUSE | icinga-web icinga-web-{mysql,pgsql} - Debian | icinga-web + Debian | icinga-web icinga-web-config-icinga2-ido-{mysql,pgsql} + +#### Icinga Web on RPM based systems Additionally you need to setup the `icinga_web` database and import the database schema. Details can be found in the package `README` files, for example [README.RHEL](https://github.com/Icinga/icinga-web/blob/master/doc/README.RHEL) @@ -1020,6 +1022,33 @@ to the default used in Icinga 2. Make sure to clear the cache afterwards. > The path to the Icinga Web `clearcache` script may differ. Please check the > [Icinga Web documentation](https://docs.icinga.org) for details. +#### Icinga Web on Debian systems + +Since Icinga Web 1.11.1-2 on Debian and Ubuntu, the IDO autoconfiguration has been moved to additional packages. + +The package `icinga-web` no longer configures the IDO connection, you can use one of the config packages: + + - `icinga-web-config-icinga2-ido-mysql` + - `icinga-web-config-icinga2-ido-pgsql` + +These packages take care of setup up the IDO connection, enabling the command pipe from Icinga Web +and depend on the corresponding packages of Icinga 2. + +Please read the README.Debian files for details and how to do advanced configuration: + + - `/usr/share/doc/icinga-web/README.Debian` + - `/usr/share/doc/icinga-web-config-icinga2-ido-mysql/README.Debian` + - `/usr/share/doc/icinga-web-config-icinga2-ido-pgsql/README.Debian` + +If you change the XML configuration of Icinga Web, make sure to clear the config cache: + + # /usr/lib/icinga-web/bin/clearcache.sh + +> **Note** +> +> When you use an older version of icinga-web you should install it with: +> `apt-get install --no-install-recommends icinga-web` + #### Setting Up Icinga Web Summary Verify that your Icinga 1.x Web works by browsing to your Web installation URL: