# NagVis 1.5 Installationsanweisungen

Diese Anweisungen gelten für eine Neuinstallation.
Wenn Sie Ihre alte NagVis-Installation aktualisieren, raten wir dringend dazu, ein Backup Ihres NagVis-Verzeichnisses zu machen und die Konfigurationsdateien manuell anzupassen.

## SCHRITT 0: das System vorbereiten

Stellen Sie sicher, dass Ihr System den Systemanforderungen entspricht.

## SCHRITT 1: NagVis herunterladen

Holen Sie sich NagVis, die neueste Version finden Sie unter www.nagvis.org.

## SCHRITT 2: entpacken Sie NagVis

    tar xvzf nagvis-1.5.x.tar.gz

## SCHRITT 3: verschieben Sie das entpackte NagVis-Verzeichnis

Platzieren Sie den NagVis-Verzeichnisbaum irgendwo in Ihrem Nagios-share-Verzeichnis In den meisten Fällen ist `/usr/local/nagvis` die beste Wahl.

    mv nagvis-1.5.x /usr/local/nagvis

Sie sollten mindestens die folgenden Dateien und Verzeichnisse unter dem nagvis-Verzeichnis sehen

    ls -l /usr/local/nagvis
    etc
    LICENSE
    README
    share
    var

Verschieben Sie KEINE Dateien oder Verzeichnisse innerhalb des NagVis-Verzeichnisses (Sie können das tun, aber in diesem Fall müssen Sie einige Parameter und Werte in der Hauptkonfigurationsdatei anpassen/hinzufügen – wenn Sie nichts verändern, sollte es sofort funktionieren)

## SCHRITT 4: konfigurieren Sie NagVis

Wechseln Sie zur neuen Position des NagVis-Verzeichnisses

    cd /usr/local/nagvis

Eine Beispiel-Hauptkonfigurationsdatei finden Sie als `etc/nagvis.ini.php-sample`. Wenn Sie Einstellungen verändern möchten, kopieren Sie dieses Beispiel nach `etc/nagvis.ini.php`:

    cp etc/nagvis.ini.php-sample etc/nagvis.ini.php

Nun können Sie dieses Datei mit Ihrem bevorzugten Texteditor ändern – ich benutze vi:

    vi etc/nagvis.ini.php

Die meisten Zeilen in der frisch kopierten `nagvis.ini.php` sind auskommentiert (beginnen mit einem Semikolon). Wenn Sie verschiedene Einstellungen setzen möchten, dann entfernen Sie das Kommentarzeichen und ändern Sie den Wert.
Informationen zu allen möglichen Werten finden Sie in der Formatbeschreibung der Hauptkonfigurationsdatei.

## SCHRITT 5: konfigurieren des Web-Servers

Seit NagVis 1.5 ist es notwendig, den Web-Server zu konfigurieren, um NagVis zu nutzen. Sie finden eine Beispiel-Konfigurationsdatei in `etc/apache2-nagvis.conf-sample`. Kopieren Sie einfach die Datei in das `conf.d`-Verzeichnis Ihres Web-Servers. Dies ist z.B. `/etc/apache2/conf.d`.

    cp etc/apache2-nagvis.conf-sample /etc/apache2/conf.d/apache2-nagvis.conf

Nun müssen Sie die Datei öffnen und auf Ihre Anforderungen anpassen. Es ist wichtig, die Makros `@NAGVIS_WEB@` und `@NAGVIS_PATH@` durch die korrekten Werte zu ersetzen.
In diesem Beispiel müssen Sie `@NAGVIS_WEB@` durch `/nagvis` und `@NAGVIS_PATH@` durch `/usr/local/nagvis/share` ersetzen.

## SCHRITT 6: Berechtigungen

Dies ist sehr wichtig für eine funktionierende Installation.
Prüfen Sie zuerst, welcher Unix-Account für Ihren Webserver benutzt wird (in meinem Fall `wwwrun`). Wenn Sie nicht wissen, mit welchem Benutzer der Webserver läuft, dann werfen Sie einen Blick in die Webserver-Konfiguration. Im Falle von Apache können Sie dies mit dem folgenden Befehl tun:
Ubuntu

    grep -e 'USER' /etc/apache2/envvars

SuSE/RedHat/Debian (SLES, OpenSuSE, Fedora)

    grep -e '^User' /etc/apache2/*.conf

Wenn Ihre Konfigurationsdatei an anderer Stelle liegt, dann passen Sie den obigen Befehl an.
Gewähren Sie nun dem Webserver-Benutzer Berechtigungen für das NagVis-Verzeichnis (in meinem Fall sind die Pfade wie folgt):

    chown wwwrun:www /usr/local/nagvis -R
    chmod 664 /usr/local/nagvis/etc/nagvis.ini.php
    chmod 775 /usr/local/nagvis/etc/maps
    chmod 664 /usr/local/nagvis/etc/maps/*
    chmod 775 /usr/local/nagvis/etc/automaps
    chmod 664 /usr/local/nagvis/etc/automaps/*
    chmod 775 /usr/local/nagvis/share/userfiles/images/maps
    chmod 664 /usr/local/nagvis/share/userfiles/images/maps/*
    chmod 775 /usr/local/nagvis/var
    chmod 664 /usr/local/nagvis/var/*
    chmod 775 /usr/local/nagvis/var/tmpl/cache
    chmod 664 /usr/local/nagvis/var/tmpl/cache/*

Es ist möglich, restriktivere Berechtigungen für die Dateien zu setzen, aber für die meisten Setups sollten die Beispiele ausreichen. Verändern Sie die Werte nur dann, wenn Sie wissen, was Sie tun!

## SCHRITT 7: das grafische Konfigurations-Tool (WUI)

NagVis besitzt ein eingebautes webbasiertes Konfigurations-Tool namens WUI. Wenn Sie es einsetzen wollen, benutzen Sie folgenden URL in Ihrem Browser, um die Seite zu öffnen:

    http://<nagiosserver>/<path-to-nagvis>/frontend/wui/index.php

(z.B. http://localhost/nagvis/frontend/index.php).
Hinweis: wenn Sie Script- oder Popup-Blocker einsetzen, dann deaktivieren Sie diese vor der Nutzung der WUI.
Wenn Sie das NagVis-Bild sehen, klicken Sie rechts und es sollte sich ein Kontext-Menu öffnen, mit dem Sie über die WUI NagVis konfigurieren und Maps anlegen können.

Das Konfigurations-Tool zeigt NICHT die aktuellen Zustände der konfigurierten Nagios-Objekte. Es dient lediglich zur Konfiguration! Um Ihre Maps nachher benutzen zu können, schauen Sie unter SCHRITT 8!

Wenn das bei Ihnen nicht funktioniert oder wenn Sie die WUI nicht benutzen möchten, dann editieren Sie einfach die Map-Konfigurationsdateien im `etc/maps/`-Verzeichnis mit Ihrem bevorzugten Text-Editor.
Informationen zu gültigen Formaten und Werten finden Sie in der Formatbeschreibung der Map-Konfigurationsdatei.

## SCHRITT 8: betrachten Sie die Maps

Sie sollten nun in der Lage sein, Ihre definierten Maps in Ihrem Browser anzusehen:

    http://<nagiosserver>/<Pfad-zu-NagVis>/frontend/nagvis-js/?mod=Map&show=<mapname>

(z.B. http://localhost/frontend/nagvis-js/?mod=Map&show=deutschland)
Viel Spaß und bitte melden Sie Bugs!