installation_instructions

# NagVis 1.8 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.8.x.tar.gz

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

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

    mv nagvis-1.8.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: konfigurieren Sie die Maps

Es gibt zwei Wege, NagVis zu konfigurieren. Der erste ist die web-basierte Konfiguration mit Hilfe des NagVis-Frontends (`http://<nagiosserver>/<Pfad-zu-NagVis>/`). Schauen Sie sich die Optionen des Header-Menüs an. Zum Editieren von Map-Objekten müssen Sie das Objekt entsperren, das Sie bearbeiten möchten.

Beim zweiten Weg bearbeiten Sie direkt die Konfigurationsdateien mit dem Text-Editor Ihrer Wahl. Die Map-Konfigurationsdateien befinden sich in `etc/maps/`. Gültige Formate und Werte finden Sie unter Map Config Format Description.

## 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!