Zuletzt aktualisiert: 07.05.2026
Für viele Nutzer ist eine grafische Oberfläche unverzichtbar. Icinga2 liefert mit Icinga Web die grafische Oberfläche, über die sich Checks, Hosts und Statusmeldungen übersichtlich visualisieren und verwalten lassen.
Wenn du meinen Guide zur Installation von Icinga2 und IcingaDB bereits durchgeführt hast, kannst du hier direkt weitermachen. Wenn nicht, empfehle ich dir, zunächst meinen vorherigen Guide zu lesen.
Schritt-für-Schritt-Anleitung zur Installation von Icingaweb und IcingaDB Web auf RHEL 10.1
Dieser Guide führt dich durch die komplette Einrichtung von Icingaweb auf RHEL 10.1 – inklusive IcingaDB-Web-Modul, Datenbank-Setup, Setup-Wizard im Browser, Redis-Anbindung und API-Verbindung zu Icinga 2. Am Ende hast du eine vollständig eingerichtete Web-Oberfläche für deinen Icinga-Stack.
Schritt 1: Installieren von IcingaWeb und IcingaDB-Web
Bevor die Installation und Konfiguration von Icinga Web startet, wird das icingadb-web Paket installiert. Dieser Schritt stellt sicher, dass im späteren Verlauf der Icinga Web Installationsanleitung das Modul direkt aktiviert und konfiguriert werden kann. Zur Installation nutzt du:
dnf install icingadb-webEs wird automatisch die icingacli und libapache2-mod-php mit installiert. Beide Abhängigkeiten sind wichtig.
Kurz erklärt:
- libapache2-mod-php ermöglicht dir, PHP Dateinen (.php) direkt in den Apache-Webserver zu verarbeiten.
- Icingacli ist die Kommandozeilenschnittstelle zur Verwaltung und Konfiguration von Icinga Web 2. Mit diesem wird auch der Setup-Token erstellt den gleich brauchen werden.
Ist auf deinem System SELinux aktiv, muss zudem das entsprechende Icinga Web 2 Paket installiert werden:
dnf install icingaweb2-selinuxSchritt 2: Einrichten von IcingaWeb
Als erstes legst du eine Datenbank für IcingaWeb an. Diese dient dazu, dass IcingaWeb Daten aufrufen, weiterleiten und verarbeiten kann.
mysql -u root -p
CREATE DATABASE icingaweb2;
CREATE USER 'icingaweb2'@'localhost' IDENTIFIED BY 'DeinSicheresPasswort';
GRANT ALL ON icingaweb2.* TO icingaweb2@localhost;Als Nächstes erstellst du zur Authentifikation einen Token. Dieser wird benötigt, um IcingaWeb mit dem IcingaWeb Setup Wizard schnell und einfach zu konfigurieren. Den Token erstellst du mit:
icingacli setup token createFür den Fall, dass das Token zu einem späteren Zeitpunkt erneut aufgerufen werden muss, steht dafür dieser Befehl zur Verfügung:
icingacli setup token showSchritt 3: IcingaWeb im Browser einrichten
Um das icinga Web 2 Setup zu starten, rufst du die IP-Adresse deiner Icinga-Instanz im Browser auf und fügst /icingaweb2/setup hinten an. Deine IP-Adresse kannst du mit ip a einsehen.
Sollte die Seite nicht erreichbar sein, vergewissere dich, dass die folgenden Services laufen.
systemctl status httpd
systemctl status php-fpmAuf der nun sichtbaren Seite trägst du den Token ein, den wir vorher erstellt haben.
Icinga Module wählen
Auf dieser Seite wählst du aus den fünf vorgeschlagenen Modulen die aus, die du nutzen willst. Standardmäßig ist bereits das IcingaDB Modul ausgewählt, was beibehalten werden muss!
WICHTIG: Da eine aktuelle Installation von Icinga 2 und Icinga Web 2 durchführt wird, kommt IcingaDB anstelle der bisher verwendeten IDO zum Einsatz. Von daher kann auf das Modul Monitoring verzichtet werden.
Icinga Web PHP Module überprüfen
Hier bekommst du eine Übersicht über alle vorhandenen Bauteile und ihren jeweiligen Status.
Authentifizierungsmethode wählen
In diesem Abschnitt kannst du eine von drei Authentifizierungsmethoden festlegen. Zur Auswahl stehen LDAP, External oder wie in diesem Fall Database.
Diese werden im nächsten Schritt ausgefüllt.
Datenbank-Authentifizierung
Zunächst gibst du an, auf welche Datenbankressource du zugreifen möchtest. Wähle anschließend den Datenbanktyp aus.
Solltest du den Host angepasst haben, gib den angepassten Host ein. Selbiges gilt für den Port. Den Datenbanknamen, den Benutzernamen und das Passwort haben wir unter Schritt 2 festgelegt. Wenn du eine zusätzliche SSL-Verschlüsselung möchtest, kannst du den entsprechenden Button anklicken und deine Daten eintragen.
Drückst du nun auf Prüfen, erscheint wie im Beispielbild ein Textfenster. Dieses prüft deine Einstellung vorab. Wenn dies funktioniert hat, geht es weiter.
Icingaweb Backend Authentifizierung
Wir haben angegeben, dass wir eine Datenbank für die Authentifizierung nutzen (unsere Datenbankressource). Diese muss nun definiert werden.
Icingaweb Admin User anlegen
Natürlich benötigst du auch ein Administratorkonto. Dieses legst du nun für Icinga Web 2 an.
Benutzername und Passwort sind frei wählbar.
Konfiguration der Icingaweb-Anwendung
Auf dieser Seite hast du die Möglichkeit, einige individuelle Einstellungen für die Anwendung und das Logging-Verhalten von Icinga Web 2 vorzunehmen. In diesem Guide bleiben die Standardeinstellungen erhalten.
Zusammenfassung der bisherigen Konfiguration
Du erhältst noch einmal eine Übersicht aller angegebenen Punkte. Wenn du mit diesen zufrieden bist und dir keine Fehler aufgefallen sind, drücke auf „Weiter”.
IcingaDB Web konfigurieren
Nach Icingaweb2 ist nun IcingaDB Web an der Reihe. Es folgen fünf Schritte, die uns im Anschluss Icinga 2 starten lassen.
Folge dem Wizard auf die nächste Seite. Hier musst du die Datenbank-Daten von Icinga DB eingeben, diese haben wir zu Beginn erstellt.
Die Anleitung dazu findest du im Guide „Icinga mit IcingaDB”.LINK!!!
Prüfe die Einstellungen, um Fehler vorzubeugen und ein spätere Fehlersuche zu vermeiden.
Redis Informationen bereitstellen
Im folgendem Fenster wird nun die Verbindung mit dem IcingaDB Redis hergestellt. Wie bei der Datenbank werden hier die Zugangsdaten eingeben und die Konfiguration geprüft.
Hinweis: Da während der Einrichtung von Redis auf ein Passwort verzichtet wurde, kann das Feld hier ebenfalls freigelassen werden.
Icinga API mit Icingaweb verbinden
Der letzte Schritt vor dem erfolgreichen Abschluss der Konfiguration von Icingaweb ist das Herstellen der Verbindung von Icinga Web zur Icinga 2 API.
Standardmäßig wird root als API Username festgelegt. Diesen Benutzer und das Passwort findest du aber auch unter /etc/icinga2/conf.d/api-users.conf
Auch hier kannst du die eingegebenen Parameter noch einmal prüfen lassen.
Gesamtübersicht
Auch hier gibt es wieder eine Übersicht über alle eingegebenen Parameter.
Schau es dir noch einmal an und gleich es ab. Fertigstellen.
Deiner Ersten Anmeldung steht nun nichts mehr im Wege. Außer dem Passwort…
Danke, dass du mir bis hierhin gefolgt bist! Nun hast du alles was du brauchst, um Icingaweb und IcingaDB Web auf RHEL 10.1 zu installieren.
Du willst Icinga in deiner Umgebung professionell aufsetzen oder betreiben lassen?
Wir unterstützen dich bei Planung, Installation und Betrieb deines Monitoring-Stacks, von der einzelnen Instanz bis zur verteilten Umgebung mit mehreren Zonen. Jetzt unverbindlich anfragen per E-Mail unter sales@netways.de oder über unser Kontaktformular!
