HowTo: Icinga – Web Frontend 1.0.1 (neues Interface) Installation unter Debian 5 (Lenny)

Da ich bereits vor einigen Wochen die Installationsanleitung für ICINGA + IDOUtils mit dem alten langweiligen Web Frontend veröffentlicht habe, möchte ich auch das neue Design vorstellen und Schritt für Schritt erklären wie man es unter Debian Lenny installiert und in das bereits bestehende ICINGA integriert.

Abhängigkeiten und erforderliche Programme installieren

Folgende Voraussetzungen müssen für den Betrieb des neuen ICINGA Web Frontends installiert sein:

*) Apache Webserver
*) PHP 5.x
*) MySQL Datenbank
*) ICINGA mit IDOUtils
*) ICINGA API

Wer ICINGA nach meiner Installationsanleitung, oder der offiziellen icinga Docs installiert hat, sollte alle notwendigen Voraussetzungen installiert haben. Es fehlen lediglich die PHP Pakete, welche über folgenden Befehl installiert werden:

apt-get install php5-cli php-pear php5-xmlrpc php5-xsl php5-ldap php5-gd php5-mysql

Zusätzlich muss das Apache Modul Rewrite aktiviert werden:

a2enmod rewrite

ICINGA Web Frontend downloaden und entpacken

Nach dem die Vorbereitungen soweit getroffen sind, kann das neue ICINGA Web Paket von Sourceforge downgeloaded, validiert und entpackt werden. Ich benutze dazu wie 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.1 die momentane stable Version.

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

Folgendes Ergebniss muss beim MD5 Check herauskommen:

icinga-web-1.0.1.tar.gz: OK

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

tar xvzf icinga-web-1.0.1.tar.gz

Installation des ICINGA Web Frontends

Wir beginnen jetzt mit der eigentlichen Installation des neuen Webinterfaces in das Verzeichnis /usr/local/icinga-web. Bitte password durch ein ensprechendes Passwort ersetzen.

cd /usr/src/icinga-web-1.0.1
./configure --prefix=/usr/local/icinga-web --with-icinga-api=/usr/local/icinga/share/icinga-api --with-db-name=icinga_web --with-db-user=icinga_web --with-db-pass=password
make install

PHP Abhängigkeiten überprüfen

Mit folgendem Befehl wird die PHP Installation + Module überprüft:

make testdeps

Der Check sollte wie folgt aussehen (zum Vergrößern klicken):

Die Extension php5-pdo-pgsql kann dabei vernachlässigt werden, da diese nur bei PostgreSQL zum Einsatz kommt. Wir verwenden jedoch MySQL. Alle anderen Checks sollten auch OK stehen.

PHP Magic Quotes auf Off setzen

Folgende php.ini’s müssen editiert werden…

vi /etc/php5/apache/php.ini
vi /etc/php5/cli/php.ini

…um die magic_quotes_gpc auf Off zu setzen (standardmäßig auf on):

magic_quotes_gpc = off

Konfiguration der MySQL Datenbank

Damit das Icinga Web Frontend funktioniert benötigen wir eine eigene MySQL Datenbank. Mit folgenden Befehl verbinden wir uns mit der MySQL Server Konsole:

mysql -u root -p

Ihr werdet nun nach eurem MySQL root Passwort gefragt, das ihr bei der Installation angegeben habt. Nun legen wir den User icinga_web mit den entsprechenden Berechtigungen an. Bitte password durch das vorhin beim Kompilieren verwendete ersetzen.

GRANT USAGE ON icinga_web.* TO 'icinga_web'@'localhost' IDENTIFIED BY 'password' WITH MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0;
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, ALTER, INDEX ON icinga_web.* TO 'icinga_web'@'localhost';
flush privileges;
quit

Nachdem der User erstellt wurde, legen wir mit dem mitgelieferten Skript die Datenbank icinga_web an und spielen die mitgelieferte Datenbankstruktur ein:

cd /usr/src/icinga-web-1.0.1
make db-initialize

Folgende Frage kann nun mit „Y“ bestätigt werden, da wir bereits beim Kompilieren die entsprechenden Credentials definiert haben:

Use the db-user specified in icinga-webs database.xml (Needs create Database/create Table rights)?(n,y)? y

Konfiguration API

Folgende Einstellungen müssen für die ICINGA API vorgenommen werden, damit diese mit den IDOUtils kommunizieren kann. Als Datenbank Parameter wird also die IDOUtils Datenbank mit dem entsprechenden User + Passwort angegeben. (wurde bei der Grundinstallation von Icinga mit den IDOUtils vorgenommen).

vi /usr/local/icinga-web/app/modules/Web/config/module.xml

<setting name="api.interfaces.data">
<ae:parameter name="api_type">IcingaApi::CONNECTION_IDO</ae:parameter>
<ae:parameter name="config_type">mysql</ae:parameter>
<ae:parameter name="config_host">127.0.0.1</ae:parameter>
<ae:parameter name="config_port">3306</ae:parameter>
<ae:parameter name="config_database">icinga</ae:parameter>
<ae:parameter name="config_user">icinga</ae:parameter>
<ae:parameter name="config_password">password</ae:parameter>
<ae:parameter name="config_table_prefix">icinga_</ae:parameter>
</setting>

Apache Alias erstellen

Damit das neue Interface auch über unseren Webserver ausgegeben wird, erstellen wir eine neue Apache Konfigurationsdatei…

vi /etc/apache2/conf.d/icinga-web.conf

…mit foglendem Inhalt

Alias /icinga-web /usr/local/icinga-web/pub
<directory /usr/local/icinga-web/pub>
AllowOverride All
</directory>

Apache neu starten

apache2ctl restart

/usr/local/icinga/var/icinga.log und /var/log/apache2/error.log auf Errors überprüfen.

Das neue Web Frontend

[sam id=’2′ codes=’true‘]

Der Zugriff auf das neue ICINGA Web Frontend  erfolgt bequem per Browser mit folgender URL:

http://serverip/icing-web

Initial Login Daten:
User: root
Passwort: password

Das Login Passwort sollte dann umgehend über „Admin“ -> „Users“ geändert werden.

Und so sieht das Monitoring am ICINGA Server aus: