Zuletzt aktualisiert: 02.04.2026
Du möchtest Icinga auf Ubuntu 24.04 LTS installieren und direkt mit IcingaDB arbeiten? Gute Entscheidung! Die neue Architektur sorgt dafür, dass Monitoring-Daten deutlich besser verarbeitet werden als mit älteren Backends.
Schritt-für-Schritt Anleitung zur Installation von Icinga auf Ubuntu 24.04
In dieser Anleitung zeige ich dir Schritt für Schritt, wie du Icinga 2 mit IcingaDB installierst und konfigurierst.
Voraussetzungen für die Installation
Bevor du mit der Installation von Icinga auf Ubuntu 24.04 startest, sollte deine Umgebung folgende Voraussetzungen erfüllen:
- Betriebssystem Ubuntu 24.04 LTS mit mind. 2 GB RAM und 20 GB freiem Speicherplatz
- Du hast das Recht, als Sudo-Benutzer auf dieser Maschine zu arbeiten
- Zugriff auf eine SQL-Datenbank
- Eine Internetverbindung auf der Maschine
Schritt 1: Einbindung des Icinga-Repositiory
Um die aktuelle Version von Icinga installieren zu können, benötigen wir das offizielle Icinga-Repository. Zu Beginn werden wir die Liste der verfügbaren Softwarepakete aktualisieren.
Dazu führst du in deinem Terminal folgende Befehle aus:
1)
apt update2)
wget -O icinga-archive-keyring.deb "https://packages.icinga.com/icinga-archive-keyring_latest+ubuntu$(
. /etc/os-release; echo "$VERSION_ID"
).deb"
apt install ./icinga-archive-keyring.deb3)
echo "deb [signed-by=/usr/share/keyrings/icinga-archive-keyring.gpg] https://packages.icinga.com/ubuntu icinga-noble main"> /etc/apt/sources.list.d/noble-icinga.list
echo "deb-src [signed-by=/usr/share/keyrings/icinga-archive-keyring.gpg] https://packages.icinga.com/ubuntu icinga-noble main">> /etc/apt/sources.list.d/noble-icinga.list4)
apt updateSobald dieser Befehlsblock erfolgreich durchgelaufen ist, siehst du in deinem Terminal, dass die neuen Repos nun in deiner Liste zu finden sind.
Schritt 2: Icinga-Paket installieren
Um im nächsten Schritt das Icinga-Paket zu installieren, nutzt du:
apt install -y icinga2Schritt 3: Installation des Monitoring-Plugins und Aktivierung der Icinga-Api
Der folgende Schritt ermöglicht dir durch die Installation der Monitoring-Plugins die ersten Checks anzulegen und Daten zu sammeln.
apt install monitoring-pluginsUm nun die Ergebnisse der Check-Plugins abzurufen, muss die Icinga-API eingerichtet werden. Das erste Kommando aktiviert die API-Feature und erstellt automatisch X.509-TLS-Zertifikate für eine sichere Kommunikation. Weiter erstellt er einen API-Benutzer in der Konfigurationsdatei:
/etc/icinga2/conf.d/api-users.conf
Der Neustart des Dienstes lässt die neuen Konfigurationen laden und aktiviert sie.
icinga2 api setup
systemctl restart icinga2Schritt 4: Icinga DB einrichten
IcingaDB ist keine, wie der Name vielleicht vermuten lässt, eigenständige Datenbank.
Vielmehr handelt es sich hierbei um eine Sammlung von Komponenten zur Veröffentlichung, Synchronisierung und Visualisierung von Überwachungsdaten im Icinga-Ökosystem. Dazu gehören Redis, das IcingaDB-Feature des Icinga Core und der IcingaDB-Daemon.
Um IcingaDB nutzen zu können, benötigst du einen Redis-Server. Redis steht für Remote Dictionary Server. Es bietet eine In-Memory-Datenbank. Diese hat Icinga so optimiert, dass sie perfekt in die Icinga2-Infrastruktur passt.
Er speichert Ergebnisse, Downtimes temporär und reduziert so die Last auf der Haupt-Datenbank. Icinga2 nutzt anstelle des üblichen Ports 6379 den Port 6380. Dieser kann im Anschluss gleich aktiviert werden.
apt install icingadb-redis
systemctl enable --now icingadb-redis-serverStandardmäßig lauscht icingadb-redis nur auf 127.0.0.1, also auf localhost. Um dies zu ändern und in Zukunft auch du weitere Nodes einbinden kannst, ändern wir folgende Konfigurationsdatei: /etc/icingadb-redis/icingadb-redis.conf
In dieser Datei passt du am besten den Punkt „bind“ an: bind 127.0.0.1 wird bind 0.0.0.0
Somit können alle Interfaces auf den Redis zugreifen.
systemctl restart icingadb-redisSicherheitshinweis: Redis hat standardmäßig keine aktive Authentifizierung. Wenn du bind auf 0.0.0.0 änderst, kann dies unbefugten Zugriff ermöglichen, falls dein System extern kommuniziert. Um diese Sicherheitslücke zu schließen, ist es ratsam, verschiedene Sicherheitsvorkehrungen zu treffen.
Das umfasst: ein Passwort einrichten, Firewall-Regeln aufstellen oder TLS einrichten.
In diesem Guide wird jedoch darauf verzichtet, um die Verständlichkeit zu erleichtern und den Umfang zu reduzieren. Es wird dringend empfohlen, auch diese Anpassungen nachträglich vorzunehmen.
Mit dem Befehl starten wir den Service neu und die Änderungen werden aktiviert.
Damit Icinga über die IcingaDB Daten über den Redis verarbeiten kann, muss das entsprechende Feature freigegeben werden. Anschließend muss Icinga2 neugestartet werden.
icinga2 feature enable icingadb
systemctl restart icinga2Installieren der IcingaDB und Einrichten der Datenbank
Da nun die Schnittstelle von Icinga2 und IcingaDB aktiviert wurde, wird nun IcingaDB installiert.
apt-get install icingadbIn diesem Beispiel nutze ich MySQL (gerne darfst du aber auch MariaDB oder PostgreSQL nutzen, allerdings ist bei PostgreSQL der entsprechende Befehl anders. Da darfst du gerne in der offiziellen Icinga Docs nachlesen), um eine Datenbank für IcingaDB zu erstellen.
mysql -u root -p
CREATE DATABASE icingadb;
CREATE USER 'icingadb'@'localhost' IDENTIFIED BY 'DeinSicheresPasswort';
GRANT ALL ON icingadb.* TO 'icingadb'@'localhost';Somit hast du die Datenbank und den Datenbank-Nutzer erfolgreich angelegt. IcingaDB stellt zudem ein Datenbankschema zur Verfügung, das nun importiert wird:
mysql -u root -p icingadb </usr/share/icingadb/schema/mysql/schema.sqlZugriffsberechtigungen anpassen
Während der Installation von Icinga DB wird unter /etc/icingadb/config.yml eine Konfigurationsdatei angelegt, die mit Standardwerten gefüllt ist. Damit die Verbindung von Icinga DB zu Redis und MariaDB erfolgreich stattfinden kann, müssen diese Werte überprüft und gegebenenfalls angepasst werden.
Öffne also den Pfad mit einem Texteditor deiner Wahl und passe die folgenden Parameter gegebenenfalls an.
Für die Datenbank:
Host mit dem entsprechenden Hostname/Host-IP deiner Datenbank, database mit dem Namen deiner Datenbank, user mit dem Namen deines Datenbanknutzers und Password mit dem Passwort, dass du für deine Datenbank vergeben hast.
Für Redis:
host mit dem entsprechenden Hostname/Host-IP deiner Redis-Instanz. Wenn du während der Installation deines Redis-Servers den Port geändert oder ein Passwort gesetzt hast, musst du dies hier ebenfalls eintragen.
Sobald diese Änderungen abgeschlossen sind, kann der IcingaDB-Service aktiviert werden:
systemctl restart icingadb
systemctl enable --now icingadbSchritt 5: Node Wizard
Der Node Wizard hilft dir, deine Zonen einzustellen und Endpunkte deines Icinga-Monitoring festzulegen. Hierfür nutzt du:
icinga2 node wizardFolgende Punkte werden interaktiv abgefragt:
- Is this agent/satellite setup? –> Hier ’n‘ eingeben und mit Enter bestätigen
- Specifiy common name (FQDN of your master) –> Nichts eingeben und mit Enter bestätigen
- Master zone name –> Nichts eingeben und mit Enter bestätigen
- Specify additional global zones –> Nichts eingeben und mit Enter bestätigen
- Specify API bind host/port –> Nichts eingeben und mit Enter bestätigen
- Bind Host –> Nichts eingeben und mit Enter bestätigen
- Bind Port –> Nichts eingeben und mit Enter bestätigen
- Disable inclusion of conf.d directory –> Nichts eingeben und mit Enter bestätigen
Um nun die Konfiguration zu verifizieren und anschließend Icinga2 neu zu laden:
Icinga2 daemon -C
systemctl reload icinga2Herzlichen Glückwunsch, du hast Icinga2 mit der IcingaDB installiert!
Damit läuft deine Icinga-Umgebung mit IcingaDB auf Ubuntu 24.04. Im nächsten Schritt kannst du dein Monitoring gezielt erweitern, z.B. um weitere Hosts, Checks oder verteilte Strukturen.
Solltest du dazu weitere Fragen haben oder Unterstützung benötigen, wende dich gerne per E-Mail an sales@netways.de, über unser Kontaktformular oder auch telefonisch an unser Team.
