mirror of https://github.com/Icinga/icinga2.git
139 lines
5.5 KiB
Markdown
139 lines
5.5 KiB
Markdown
## <a id="setting-up-icinga2-user-interfaces"></a> Setting up Icinga 2 User Interfaces
|
|
|
|
Icinga 2 is compatible to Icinga 1.x user interfaces by providing additional
|
|
features required as backends.
|
|
|
|
Furthermore these interfaces (and somewhere in the future an Icinga 2
|
|
exclusive interface) can be used for the newly created `Icinga Web 2`
|
|
user interface.
|
|
|
|
Some interface features will only work in a limited manner due to
|
|
[compatibility reasons](#differences-1x-2), other features like the
|
|
statusmap parents are available through intelligent compatibility layers
|
|
for dumping the host dependencies as parents.
|
|
Special restrictions are noted specifically in the sections below.
|
|
|
|
> **Tip**
|
|
>
|
|
> Choose your preferred interface. There's no need to install [Classic UI](#setting-up-icinga-classic-ui)
|
|
> if you prefer [Icinga Web](#setting-up-icinga-web) or [Icinga Web 2](#setting-up-icingaweb2) for example.
|
|
|
|
### <a id="setting-up-icinga-classic-ui"></a> 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.
|
|
|
|
#### <a id="installing-icinga-classic-ui"></a> Installing Icinga Classic UI
|
|
|
|
The Icinga package repository has both Debian and RPM packages. You can install
|
|
the Classic UI using the following packages:
|
|
|
|
Distribution | Packages
|
|
--------------|---------------------
|
|
Debian | icinga2-classicui
|
|
all others | icinga2-classicui-config icinga-gui
|
|
|
|
> **Note**
|
|
>
|
|
> Debian packages require additional dependencies satisfied by the [debmon](http://www.debmong.org)
|
|
> repository.
|
|
|
|
> **Note**
|
|
>
|
|
> On all distributions other than Debian you may have to restart both your web
|
|
> server as well as Icinga 2 after installing the Classic UI package.
|
|
|
|
Verify that your Icinga 1.x Classic UI works by browsing to your Classic
|
|
UI installation URL:
|
|
|
|
Distribution | URL | Default Login
|
|
--------------|--------------------------------------------------------------------------|--------------------------
|
|
Debian | [http://localhost/icinga2-classicui](http://localhost/icinga2-classicui) | asked during installation
|
|
all others | [http://localhost/icinga](http://localhost/icinga) | icingaadmin/icingaadmin
|
|
|
|
> **Note**
|
|
>
|
|
> Due to compatibility restrictions, not all features available in Icinga 1.x
|
|
> Classic UI will be available with Icinga 2. The different handling of
|
|
> [commands](#differences-1x-2-commands) and [macros](#differences-1x-2-macros)
|
|
> renders the command expander invalid for example.
|
|
|
|
|
|
### <a id="setting-up-icinga-web"></a> Setting up Icinga Web
|
|
|
|
Icinga 2 can write to the same schema supplied by `Icinga IDOUtils 1.x` which
|
|
is an explicit requirement to run `Icinga Web` next to the external command pipe.
|
|
Therefore you need to setup the DB IDO feature remarked in the previous sections.
|
|
|
|
#### <a id="installing-icinga-web"></a> Installing Icinga Web
|
|
|
|
The Icinga package repository has both Debian and RPM packages. You can install
|
|
the Classic UI using the following packages:
|
|
|
|
Distribution | Packages
|
|
--------------|-------------------------------------
|
|
RHEL/SUSE | icinga-web icinga-web-{mysql,pgsql}
|
|
Debian | icinga-web
|
|
|
|
Additionally you need to setup the `icinga_web` database.
|
|
|
|
> **Note**
|
|
>
|
|
> The Icinga Web RPM packages install the schema files into
|
|
> `/usr/share/doc/icinga-web-*/schema` (`*` means package version).
|
|
> The Icinga Web dist tarball ships the schema files in `etc/schema`.
|
|
>
|
|
> On SuSE-based distributions the schema files are installed in
|
|
> `/usr/share/doc/packages/icinga-web/schema`.
|
|
|
|
|
|
Additionally you need to enable the `ExternalCommandListener` feature.
|
|
|
|
# icinga2-enable-feature command
|
|
|
|
Then edit the Icinga Web configuration for sending commands in `/etc/icinga-web/conf.d/access.xml`
|
|
(RHEL) or `/etc/icinga-web/access.xml` (SUSE) setting the command pipe path
|
|
to the default used in Icinga 2. Make sure to clear the cache afterwards.
|
|
|
|
# vim /etc/icinga-web/conf.d/access.xml
|
|
|
|
<write>
|
|
<files>
|
|
<resource name="icinga_pipe">/var/run/icinga2/cmd/icinga.cmd</resource>
|
|
</files>
|
|
</write>
|
|
|
|
# icinga-web-clearcache
|
|
|
|
Verify that your Icinga 1.x Web works by browsing to your Web installation URL:
|
|
|
|
Distribution | URL | Default Login
|
|
--------------|-------------------------------------------------------------|--------------------------
|
|
Debian | [http://localhost/icinga-web](http://localhost/icinga-web) | asked during installation
|
|
all others | [http://localhost/icinga-web](http://localhost/icinga-web) | root/password
|
|
|
|
|
|
|
|
### <a id="setting-up-icingaweb2"></a> Setting up Icinga Web 2
|
|
|
|
Icinga Web 2 currently supports `status.dat`, `DB IDO`, or `Livestatus` as backends.
|
|
Please consult the INSTALL documentation shipped with `Icinga Web 2` for
|
|
further instructions.
|
|
|
|
> **Note**
|
|
>
|
|
> Icinga Web 2 is still under heavy development. Rather than installing it
|
|
> yourself you should consider testing it using the available Vagrant
|
|
> demo boxes.
|
|
|
|
### <a id="additional-visualization"></a> Additional visualization
|
|
|
|
There are many addons in the wild which are using Icinga 1.x backends and
|
|
are well integrated into user interfaces.
|
|
|
|
The most famous ones are PNP or inGraph (graphing performance data), graphite, NagVis
|
|
(network maps), etc.
|
|
|