1. Paket nagiosql installieren (wie man das Repository einbindet, wird in einem eigenen Artikel beschrieben) .
2. Webinstaller aktivieren:
   touch /usr/share/nagiosql/htdocs/install/ENABLE_INSTALLER
3. Webinstaller starten, Datenbankanbindung herstellen (das Root-PW der MySQL-DB ist zur Installation erforderlich)
4. Nach Abschluss der Installation den “Enabler” wieder löschen:
   rm -f /usr/share/nagiosql/htdocs/install/ENABLE_INSTALLER
5. Im Webfrontend einloggen und die Pfade unter Administration/Domänen/localhost prüfen (sollten zur Debian-Standardinstallation passen).
6. Nagios-Konfiguration anpassen: damit NagiosQL die vollständige Kontrolle über alle Objekte hat, sollte dort nur ein einziger cfg_dir-Eintrag drinstehen:
   cfg_dir=/etc/nagiosql/domains/localhost
7. ggf. jetzt vorhandene Konfiguration importieren. Am besten kopiert man sich alles was man braucht vorher unter/etc/nagios/import zusammen (einschließlich der Konfigurationsdateien in /etc/nagios-plugins/config).
8. Check der Konfiguration, Neustart von Nagios, wohlfühlen …. oder die Fehler suchen

ACHTUNG: das Paket sorgt nur für einen Readonly-Zugriff auf nagios.cfg und cgi.cfg. Normalerweise sollte das reichen. Für den Eintrag von cfg_dir bemüht man daher besser die Shell (der Eintrag wird ja auch nur ein einziges Mal angefasst).

Fragen und Diskussionen am besten im Nagios-Portal unter Projekte/NagiosQL oder oder im Forum der NagiosQL Website.

Gegenüber früheren Versionen des Debian-Paketes gibt es eine wichtige Änderung: selbst hochgeladene Hintergründe für Maps werden nicht mehr in /etc/nagvis/maps gespeichert, sondern in /var/lib/nagvis/images/maps. Aus einer früheren Installation noch unter /etc/nagvis/maps vorhandene Bilder werden nicht automatisch an die neue Stelle kopiert, sondern müssen von Hand umgezogen werden.

War bereits eine Installation mit einer Konfigurationsdatei nagvis.ini.php vorhanden, die nicht ersetzt wurde, sind einige Einstellungen zu prüfen. Das von mir bereitgestellte Paket benötigt folgende Einträge:

[paths]
base="/usr/share/nagvis/htdocs/"
cfg="/etc/nagvis/"
var="/var/cache/nagvis/"
map="/var/lib/nagvis/images/maps/"
mapcfg="/etc/nagvis/maps/"
htmlbase="/nagvis"
...
[automap]
...
graphvizpath="/usr/bin"
...


NagVis ist nun nach der Installation standardmäßig unter http://localhost/nagvis erreichbar (nicht wie bisher unter /nagios/nagvis). Die Konfiguration für Apache nimmt man in /etc/nagvis/apache.conf vor (hier muss ggf. auch die Authentifikation angepasst werden, wenn die Authentifikation vom nagios3-Paket verändert wurde. Bei Problemen hilft ein Blick in /var/log/apache2/error.log meist weiter (RTFL - read the famous logfiles ;-))

Ich habe begonnen, für meine bevorzugte Server-Distribution (Debian, zur Zeit Lenny)  Pakete neu zu bauen oder für Lenny zu aktualisieren.  Was davon für die allgemeine Installation taugt, stelle ich auf debian.swobspace.net zur Verfügung. Diese Pakete laufen bei mir und sind für meine Zwecke einigermaßen ausgetestet, haben aber nicht notwendigerweise einen “rock solid” Status, wie man es vielleicht von Originalpaketen aus der Distribution gewohnt ist. Daher: Verwendung auf eigene Gefahr!

Um die Pakete zu installieren, fügt man in /etc/apt/sources.list folgenden Eintrag hinzu:


# -- debian.swobspace.net
deb http://debian.swobspace.net lenny main
deb-src http://debian.swobspace.net lenny main


Damit aus dem Repository nicht alle vorhandenen Pakete, sondern nur die explizit ausgewählten Pakete installiert werden, ergänzt man in der Datei /etc/apt/preferences folgende Einträge (ggf. muss die Datei neu angelegt werden):


Package: *
Pin: origin debian.swobspace.net
Pin-Priority: 200


Package: gesuchtes_paket
Pin: origin debian.swobspace.net
Pin-Priority: 600


Pin-Priority 200 sorgt dafür, dass Pakete aus der verwendeten Distribution bevorzugt installiert werden (Default ist dort 500, 500 hat höhere Priorität als 200). Pakete, die von debian.swobspace.net installiert werden sollen, vergibt man explizit eine Priorität größer als 500 (hier im Beispiel 600). Mit apt-cache policy lässt sich leicht überprüfen, ob das Pinning (die Einträge in der Datei preferences) funktioniert. apt-cache policy gesuchtes_paket liefert dann das Pinning bezogen auf das gesuchte Paket. Einfach mal ausprobieren

Wie es sich gehört, ist das Repository signiert. Den Schlüssel gibt es unter http://www.swobspace.net/wob@swobspace.net.pub.asc

ID 774716B9, 'Wolfgang Barth (wob) <wob@swobspace.net>'
Fingerprint = 2EF4 808C 339F 10ED 25C5  BC61 2AC2 362A 7747 16B9

Den Schlüssel installiert man mit apt-key add <schlüssel>:

wget http://www.swobspace.net/wob@swobspace.net.pub.asc -O- | apt-key add -


apt-get update (bzw. aptitude update) nicht vergessen!