Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- centos:web_c7:icinga:nagvis [21.04.2015 07:45. ] – [Konfiguration] django
+++ centos:web_c7:icinga:nagvis [22.07.2019 14:58. ] (aktuell) – Externe Bearbeitung 127.0.0.1
@@ Zeile 43: / Zeile 43: @@
 ==== Installation ====
-Im nächsten Schritt werden wir **NagVis** installieren. Haben wir schon eine bestehende NagVis-Installation können wir den Schritt überspringen und gleich mit der Konfiguration von **NagVis** beginnen. FIXME
+Im nächsten Schritt werden wir **NagVis** installieren. Haben wir schon eine bestehende NagVis-Installation können wir den Schritt überspringen und gleich mit der Konfiguration von **[[centos:web_c7:icinga:nagvis?&#erst-_konfiguration|NagVis]]** beginnen.
 Als erstes holen wir uns das aktuelle **tar.gz**-Paket von der [[http://www.nagvis.org/downloads|Nagvis-Homepage]] auf unseren Monitoring-Server.
@@ Zeile 1117: / Zeile 1117: @@
 {{ :centos:web_c7:icinga:icinga_0138.png?direct&725 |Bild: Icinga Web 2 Modul nagvis}}
+===== Start der NagVis-Anwendung =====
+Da wir die initiale Konfiguration abgeschlossen haben, können wir nun Das Modul **NagVis** aufrufen. Hierzu klicken wir im Menü links auf den Menüpunkt **Nagvis**.
-==== muell ====
+{{ :centos:web_c7:icinga:icinga_0139.png?direct&725 |Bild: Icinga Web 2 Modul nagvis}}
+Zur Erstanmeldung am Modul **Nagvis** geben wir als Anmeldedaten jeweils **admin** ein und klicken dann auf die Schaltfläche **Einloggen**.
-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
+{{ :centos:web_c7:icinga:icinga_0140.png?direct&725 |Bild: Icinga Web 2 Modul nagvis}}
-SCHRITT 3: verschieben Sie das entpackte NagVis-Verzeichnis
+Einen ersten Eindruck können wir uns  mit Hilfe der bei der Erstinstallation angelegten Demo-Karten verschaffen.
-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
+{{ :centos:web_c7:icinga:icinga_0141.png?direct&725 |Bild: Icinga Web 2 Modul 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)
+===== individuelle Konfiguration =====
-SCHRITT 4: konfigurieren Sie NagVis
+==== User ====
-Wechseln Sie zur neuen Position des NagVis-Verzeichnisses
+Bei der Installation von NagVis mit Hilfe des Installationsscriptes werden neben dem Admin-User noch ein Gast-Zugang angelegt.
+Hier legen wir nun für unsere(n) Icinga 2 Admin(s) jeweils einen User an. Dazu tragen wir Nutzernamen und Passwort in die zugehörigen Felder ein und klicken dann auf die Schaltfläche **Nutzer erstellen**.
-cd /usr/local/nagvis
+{{ :centos:web_c7:icinga:icinga_0143.png?direct&725 |Bild: Icinga Web 2 NagVis Nutzerverwaltung}}
-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:
+Anschließend weißen wir dem zuständigen Administrator die Anmin-Rechte an NagVis zu. Nach Auswahl des Benutzerkontos und Zuweisung der Rechte klicken wir auf die Schaltfläche **Nutzer bearbeiten**.
-cp etc/nagvis.ini.php-sample etc/nagvis.ini.php
+Den ungenutzten Gastzugang löschen wir nun noch, indem wir den Nutzernamen beim Menüpunkt **//Nutzer löschen//** auswählen und die Schaltfläche **Nutzer löschen** anklicken.
-Nun können Sie dieses Datei mit Ihrem bevorzugten Texteditor ändern ï¿½ ich benutze vi:
+Zu guter Letzt ändern wir das Standardpasswort des Accounts **admin** noch ab. Dazu wählen wir aus dem **Nutzermenü** rechts oben den Menüpunkt **//Passwort ändern//** aus.
-vi etc/nagvis.ini.php
+{{ :centos:web_c7:icinga:icinga_0144.png?direct&725 |Bild: Icinga Web 2 NagVis Nutzerverwaltung}}
-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.
+Nach Eingabe des alten Passwortes **admin** tragen wir 2x unser neues Passwort ein und klicken dann auf die Schaltfläche **Passwort ändern**.
-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.
+{{ :centos:web_c7:icinga:icinga_0144.png?direct&725 |Bild: Icinga Web 2 NagVis Passwortänderung}}
-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
+==== Demokartenmaterial ====
+Die mitgelieferten Karten dienen unter anderem dazu, sich über die Möglichkeiten von **NagVis** zu informieren bzw. dienen als Vorlagen für eigene Karten. Wir löschen daher die Kartendefinitionen **__nicht__**, sonder verschieben nur die zugehörigen Dateien in ein backup-Verzeichnis.
-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.
+Als erstes legen wir uns das Backup-Verzeichnis an.
-In diesem Beispiel müssen Sie @NAGVIS_WEB@ durch /nagvis und @NAGVIS_PATH@ durch /usr/local/nagvis/share ersetzen.
+   # mkdir /root/nagvis
-SCHRITT 6: Berechtigungen
+Dann verschieben wir die map-Konfigurationsdateien in dieses Verzeichnis.
-Dies ist sehr wichtig für eine funktionierende Installation.
+   # mv /usr/share/nagvis/etc/maps/* /root/nagvis/
-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:
+Abschließend deaktivieren wir noch die Parameter des Definitionsbereichs **Rotation pool definitions** in der Datei
+   # vim /usr/share/nagvis/etc/nagvis.ini.php
+<code> ...
+; ----------------------------
+; Rotation pool definitions
+; ----------------------------
+; in this example the browser switches between the maps demo and demo2 every 15
+; seconds, the rotation is enabled by url: index.php?rotation=demo
+; Django : 2015-04-20
+; default: [rotation_demo]
+; These steps are rotated. The single steps may have optional prefixes like "Demo2:"
+; which are used as display text on the index pages rotation list.
+; You may also add external URLs as steps. Simply enclose the url using []
+; instead of the map name.
+; Django : 2015-04-20
+; default: maps="demo-germany,demo-ham-racks,demo-load,demo-muc-srv1,demo-geomap,demo-automap"
+; rotation interval (seconds)
+; Django : 2015-04-20
+; default: interval=15
+...</code>
+==== Automap ====
+Im folgendem Konfigurationsbeispiel, werden wir uns nun eine Automap für unseren Icinga 2 Host und den überwachten Hosts anlegen.
+Als erstes wählen wir aus dem NagVis-Menü **Optionen** den Menüpunkt
+{{ :centos:web_c7:icinga:icinga_0146.png?direct&800 |Bild: Icinga Web 2 NagVis Datenquellen}}
+Hier wählen wir dann die **Standard-Datenquelle** aus und klicken anschließend auf die Schaltfläche **Speichern**.
+{{ :centos:web_c7:icinga:icinga_0147.png?direct&800 |Bild: Icinga Web 2 NagVis Datenquellen}}
+Nun definieren wir uns eine eigene Karte vom Typ **automap**; dafür wählen wir den Menüpunkt **Karten verwalten** aus dem Menü **Optionen aus**.
+{{ :centos:web_c7:icinga:icinga_0148.png?direct&800 |Bild: Icinga Web 2 NagVis Kartenverwaltung}}
-Ubuntu
+Zum Generieren der Automap befüllen wir beim Menüpunkt **Karte erstellen** die Felder **//ID (Interner Name)//** und **//Alias//**. Beim Kartentyp wählen wir **Automap basierend auf Eltern/Kind Beziehungen** aus. Abschließend klicken wir auf die Schaltfläche **Erstellen** und sichern damit unsere Eingaben.
-grep -e 'USER' /etc/apache2/envvars
+{{ :centos:web_c7:icinga:icinga_0149.png?direct&800 |Bild: Icinga Web 2 NagVis Kartenverwaltung}}
-SuSE/RedHat/Debian (SLES, OpenSuSE, Fedora)
+Basieren auf den Monitoringkonfiguration unserer **Icinga 2** Umgebung wird nach einer kurzen Zeit die generierte **automap** angezeigt.
-grep -e '^User' /etc/apache2/*.conf
+{{ :centos:web_c7:icinga:icinga_0151.png?direct&800 |Bild: Icinga Web 2 NagVis automap}}
-Wenn Ihre Konfigurationsdatei an anderer Stelle liegt, dann passen Sie den obigen Befehl an.
+Sobald wir mit der Maus übe einen der überwachten Host streichen, werden weitere Details des Hosts eingeblendet.
-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
+{{ :centos:web_c7:icinga:icinga_0152.png?direct&800 |Bild: Icinga Web 2 NagVis automap}}
-    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!
+Klicken wir auf einen Host, gelangen wir direkt auf die Icinga Web 2 Detailseite des Hosts.
-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.
+{{ :centos:web_c7:icinga:icinga_0153.png?direct&800 |Bild: Icinga Web 2 NagVis automap}}
-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>
+====== Links ======
+  * **⇐ [[centos:web_c7:icinga:graphite|Zurück zum Kapitel "Icinga Einbinden von Graphite zur graphischen Visualisierung - Installation und Konfiguration unter CentOS 7.x"]]**
+  * **[[centos:web_c7:start|Zurück zum Kapitel >>Webserverinstallation unter CentOS 7.x<<]]**
+  * **[[wiki:start|Zurück zu >>Projekte und Themenkapitel<<]]**
+  * **[[http://dokuwiki.nausch.org/doku.php/|Zurück zur Startseite]]**
-(z.B. http://localhost/frontend/nagvis-js/?mod=Map&show=deutschland)
-Viel Spaß und bitte melden Sie Bugs!