Icinga – Open Source Monitoring – Installation unter Debian 5 (Lenny) mit IDOUtils und MySQL Datenbank

Wie vergangenes Jahr berichtet, wurde der bekannte Open-Source Monitoring Dienst Nagios geforkt und unter dem Projekt ICINGA in neuem Glanz veröffentlicht. Ich werde hier in den nächsten Wochen meine Erfahrungen schildern und einige HowTo’s dazu veröffentlichen. Der Start erfolgt mit der Installation von ICINGA unter Debian Lenny.

Abhängigkeiten und erforderliche Programme installieren

Folgende Voraussetzungen müssen für den Betrieb von ICINGA installiert sein:

*) Apache Webserver
*) MySQL Datenbank + libdbi Treiber
*) GCC Compiler, C/C++ dev libraries
*) GD Library

Installation des Apache Webserver + Mysql Datenbank

Die benötigten libdbi Treiber werden über folgenden Befehl installiert:

apt-get install -y libdbi0-dev libdbd-mysql

Der GCC Compiler und die erforderlichen C/C++ development Libraries werden zusammengefasst als build-essential installiert:

apt-get install -y build-essential

Installation der GD Libraries:

apt-get install -y libgd2-xpm-dev libjpeg62-dev libpng12-0

Benutzer und Gruppe für ICINGA anlegen

Damit ICINGA funktioniert, benötigt es einen eigenen Benutzer mit dem Namen icinga. Diesen legen wir wie folgt an und vergeben ein Passwort:

useradd -m icinga
passwd icinga

Um das Webinterface mit vollem Funktionsumfang nutzen zu können (Kommandos zu senden) wird noch eine spezielle Gruppe benötigt in welche die beiden User icinga und www-data hinzugefügt werden:

groupadd icinga-cmd
usermod -a -G icinga-cmd icinga
usermod -a -G icinga-cmd www-data

ICINGA downloaden und entpacken

Nach dem die Vorbereitungen soweit getroffen sind, kann ICINGA von Sourceforge downgeloaded, validiert und entpackt werden. Ich benutze dazu immer das Verzeichnis /usr/src. Bitte achtet darauf, dass ihr die aktuelle stable Version runterladet, um keine ältere Version zu installieren. In meinem Fall ist die Version 1.0 die momentane stable Version.

cd /usr/src
wget http://sourceforge.net/projects/icinga/files/icinga/1.0/icinga-1.0.tar.gz/download
wget http://sourceforge.net/projects/icinga/files/icinga/1.0/icinga-1.0.tar.gz.md5/download
md5sum -c icinga-1.0.tar.gz.md5

Folgendes Ergebniss muss beim MD5 Check herauskommen:

icinga-1.0.tar.gz: OK

Das Paket wird anschließend mit folgendem Befehl in das /usr/src Verzeichnis entpackt:

tar xvzf icinga-1.0.tar.gz

Installation von ICINGA

Wir beginnen jetzt mit der eigentlichen Installation von ICINGA mit den entsprechenden Optionen für IDOUtils

cd /usr/src/icinga-1.0
./configure --with-command-group=icinga-cmd --enable-idoutils
make all
make fullinstall

Die jeweiligen Schritte können abhängig vom System einige Zeit in Anspruch nehmen. Die Grundinstallation von ICINGA ist damit abgeschlossen, für den Betrieb sind aber noch einige weitere Konfigurationsschritte notwendig. Eine Bespielkonfiguration wurde bereits im Pfad /usr/local/icinga/etc angelegt.

Download und Installation der Nagios Plugins

ICINGA verwendet die Nagios Plugins um die eigentlichen Checks durchzuführen. Die Plugins sind kleine eigenständige Programme, die auch unabhängig von ICINGA bzw. Nagios verwendet werden können. Der Download ist ebenfalls bei Sourceforge verfügbar und ich empfehle wieder die Verwendung der aktuellsten stable Version. In meinem Fall die Version 1.4.14.

cd /usr/src
wget http://sourceforge.net/projects/nagiosplug/files/nagiosplug/1.4.14/nagios-plugins-1.4.14.tar.gz/download
tar xvzf nagios-plugins-1.4.14.tar.gz

Nach dem Entpacken können die Plugins installiert werden:

cd /usr/src/nagios-plugins-1.4.14
./configure --prefix=/usr/local/icinga --with-nagios-user=icinga
make
make install

Benutzer für das ICINGA Webinterface anlegen

Jetzt definieren wir den User und ein entsprechendes Passwort, mit dem wir uns zukünftig auf dem Webinterface anmelden (icingaadmin kann dabei durch einen beliebigen Usernamen ersetzt werden):

htpasswd -c /usr/local/icinga/etc/htpasswd.users icingaadmin

Anmerkung: Um später weitere User hinzuzufügen muss die Option “-c” weggelassen werden, da die Datei sonst immer neu generiert und überschrieben wird. Im Anschluss den Apache neu starten:

/etc/init.d/apache2 restart

Konfiguration der MySQL Datenbank und IDOUtils

Damit IDOUtils auch in unsere MySQL Datenbank schreibt, müssen wir eine entsprechende Datenbank anlegen und IDOUtils konfigurieren. Mit folgenden Befehl verbinden wir uns mit der MySQL Server Konsole:

mysql -u root -p

Ihr werdet nun nach eurem Passwort gefragt, das ihr bei der Installation angegeben habt. Nun legen wird die Datenbank und den User icinga an. Bitte password durch ein ensprechendes Passwort ersetzen.

create database icinga;
grant all privileges on icinga.* to 'icinga'@'localhost' identified by 'password' with grant option;
flush privileges;
quit

Nachdem die Datenbank und der User erstellt wurde, spielen wir die mitgelieferte Datenbankstruktur in die Datenbank icinga ein:

cd /usr/src/icinga-1.0/module/idoutils/db
mysql -u root -p icinga < mysql.sql

Jetzt muss IDOUtils noch die Datenbankverbindung mitgeteilt werden. Dazu benennen wir die Beispielkonfiguration um…

mv /usr/local/icinga/etc/ido2db.cfg-sample /usr/local/icinga/etc/ido2db.cfg
vi /usr/local/icinga/etc/ido2db.cfg

…und passen die entsprechenden Einträge an (password wieder durch das eingegebene Passwort ersetzen):

db_servertype=mysql
db_host=localhost
db_port=3306
db_name=icinga
db_user=icinga
db_pass=password

Dienste Starten und Autostart konfigurieren

Die entsprechenden Dienste bzw. Init Skripts sollten in dieser Reihenfolge gestartet werden:

/etc/init.d/ido2db start
/etc/init.d/icinga start

Damit beim Systemstart IDOUtils und ICINGA auch automatisch in der richtigen Reihenfolge ausgeführt werden, benötigen wir noch diese 2 Befehle

update-rc.d ido2db defaults 50
update-rc.d icinga defaults 51

Das Webinterface

Herzlichen Glückwunsch, euer ICINGA ist nun voll funktionsfähig und überwacht den lokalen Server.

Der erste Stein sollte damit gelegt sein. Jetzt liegt es an Euch, euer ICINGA zu befüllen und eure Serverfarmen zu überwachen. Solltet Ihr bereits ein Nagios im Einsatz gehabt haben, dann sollte es mühelos möglich sein, die Konfigurationsdateien zu übernehmen. Das werde ich in den nächsten Tagen auch ausprobieren und wenn alles gut geht mein Nagios durch ICINGA ersetzen. Zudem möchte ich auch Erweiterungen wie PNP und NagVis testen. Weitere Updates kommen in den nächsten Tagen und Wochen. Um kein Update zu verpassen, abonniert ihr am Besten meinen RSS Feed oder folgt mir auf Twitter und Facebook.

Der Zugriff auf das Webinterface erfolgt bequem per Browser mit folgender URL:

http://serverip/icinga

Und so sieht das Monitoring am ICINGA Server aus:

Ähnliche Artikel:

1. Webserver (LAMP) Installation unter Debian 5 (Lenny) und Ubuntu
2. ICINGA – Nagios ist geforked
3. MySQL – ERROR 1045: Access denied for user ‘debian-sys-maint’@'localhost’
4. VMware Server 2 installation unter Debian 5 (Lenny)
5. Java Installation unter Debian 5.0 (Lenny)

Tags: debian, fork, howto, icinga, installation, lenny, Nagios