Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- centos:web_c7:icinga:nagvis [21.04.2015 06:25. ] – [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 407: / Zeile 407: @@
 ...</code>
-Somit ergibt sich folgende NagVis-Konfigurationsdatei:
+Somit ergibt sich folgende NagVis-Konfigurations-Optionen:
-<file /usr/share/nagvis/etc/nagvis.ini.php>; <?php return 1; ?>
+   # egrep -v '(^\s+;|^;|^$)' /usr/share/nagvis/etc/nagvis.ini.php
+<code>[global]
+file_group="apache"
+language="de_DE"
+[paths]
+base="/usr/share/nagvis/"
+htmlcgi="/icingaweb2/monitoring"
+[defaults]
+urltarget="_parent"
+hosturl="[htmlcgi]/host/show?host=[host_name]"
+hostgroupurl="[htmlcgi]/list/hosts?hostgroup=[hostgroup_name]"
+serviceurl="[htmlcgi]/service/show?host=[host_name]&service=[service_description]"
+servicegroupurl="[htmlcgi]/list/services?servicegroup=[servicegroup_name]"
+backend="live_1"
+[index]
+[automap]
+defaultparams="&childLayers=2"
+defaultroot="vml000117.dmz.nausch.org"
+graphvizpath="/usr/bin/"
+[wui]
+[worker]
+[backend_live_1]
+backendtype="mklivestatus"
+socket="unix:/var/run/icinga2/cmd/livestatus"
+[backend_ndomy_1]
+backendtype="ndomy"
+[rotation_demo]
+maps="demo-germany,demo-ham-racks,demo-load,demo-muc-srv1,demo-geomap,demo-automap"
+interval=15
+[states]
+</code>
+Hier finden wir nochmals die komplette Konfigurationsdatei:
+   # vim /usr/share/nagvis/etc/nagvis.ini.php
+<file>; <?php return 1; ?>
 ; the line above is to prevent
 ; viewing this file from web.
@@ Zeile 1037: / Zeile 1072: @@
-==== Icinga Web 2 Modul ====
+===== Icinga Web 2 Modul =====
+==== Installation ====
-FIXME
+Für das Einbetten der NagVis-Karten in **Icinga Web2** greifen wir auf das Modul **[[https://github.com/divetoh/icingaweb2-module-nagvis|icingaweb2-module-nagvis]]** zurück.
+Als erstes holen wir uns das Modul von der **[[https://github.com/divetoh/icingaweb2-module-nagvis|GitHub]]** Seite.
    # wget https://github.com/divetoh/icingaweb2-module-nagvis/archive/master.zip
-   # unzip master.zip -d /usr/share/icingaweb2/modules
+Dann entpacken wir das ZIP-Archiv.
+   # unzip master.zip -d /usr/local/src/
-   # mv /usr/share/icingaweb2/modules/icingaweb2-module-nagvis-master/ /usr/share/icingaweb2/modules/nagvis
+Abschließend verschieben wir das Unterverzeichnis **nagvis** in das Icinga Web 2 Modulverzeichnis.
+   # mv /usr/local/src/icingaweb2-module-nagvis-master/nagvis/ /usr/share/icingaweb2/modules/
+==== Konfiguration ====
+Zur Konfiguration von **Icinga Web 2** öffnen wir die URL unserer Icinga-Installation.
+   $ firefox https://orwell.nausch.org/icingaweb2/
+Hier melden wir uns nun wie gewohnt an.
+{{ :centos:web_c7:icinga:icinga_0133.png?direct&725 |Bild: Icinga Web 2 Anmeldebildschirm}}
-==== muell ====
+Auf der linken Seite klicken wir auf den Menüpunkt **System**.
+{{ :centos:web_c7:icinga:icinga_0134.png?direct&725 |Bild: Icinga Web 2 Menü System}}
-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
+Hier licken wir nun auf den Menüpunkt **Module**.
-SCHRITT 3: verschieben Sie das entpackte NagVis-Verzeichnis
+{{ :centos:web_c7:icinga:icinga_0135.png?direct&725 |Bild: Icinga Web 2 Menü System}}
-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
+In diesem Fenster wählen wir dann unser neues Modul **nagvis** an.
-Sie sollten mindestens die folgenden Dateien und Verzeichnisse unter dem nagvis-Verzeichnis sehen
+{{ :centos:web_c7:icinga:icinga_0136.png?direct&725 |Bild: Icinga Web 2 Modul nagvis}}
-ls -l /usr/local/nagvis
+Zum aktivieren klicken wir auf der rechten Bildschirmseite auf den Schriftzug **enable**.
-    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)
+{{ :centos:web_c7:icinga:icinga_0136.png?direct&725 |Bild: Icinga Web 2 Modul nagvis}}
-SCHRITT 4: konfigurieren Sie NagVis
-Wechseln Sie zur neuen Position des NagVis-Verzeichnisses
-cd /usr/local/nagvis
+Zur abschließenden Modulkonfiguration klicken wir nun rechts oben auf den Reiter **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:
+{{ :centos:web_c7:icinga:icinga_0137.png?direct&725 |Bild: Icinga Web 2 Modul nagvis}}
-cp etc/nagvis.ini.php-sample etc/nagvis.ini.php
+Hier tragen wir nun die URL bzw. das Verzeichnis unserer **NagVis**-Installation ein und klicken abschließend auf die Schaltfläche **Save Changes**.
-Nun können Sie dieses Datei mit Ihrem bevorzugten Texteditor ändern ï¿½ ich benutze vi:
+{{ :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**.
+{{ :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**.
+{{ :centos:web_c7:icinga:icinga_0140.png?direct&725 |Bild: Icinga Web 2 Modul nagvis}}
+Einen ersten Eindruck können wir uns  mit Hilfe der bei der Erstinstallation angelegten Demo-Karten verschaffen.
+{{ :centos:web_c7:icinga:icinga_0141.png?direct&725 |Bild: Icinga Web 2 Modul nagvis}}
+===== individuelle Konfiguration =====
+==== User ====
+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**.
+{{ :centos:web_c7:icinga:icinga_0143.png?direct&725 |Bild: Icinga Web 2 NagVis Nutzerverwaltung}}
+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**.
+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.
+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.
+{{ :centos:web_c7:icinga:icinga_0144.png?direct&725 |Bild: Icinga Web 2 NagVis Nutzerverwaltung}}
+Nach Eingabe des alten Passwortes **admin** tragen wir 2x unser neues Passwort ein und klicken dann auf die Schaltfläche **Passwort ändern**.
+{{ :centos:web_c7:icinga:icinga_0144.png?direct&725 |Bild: Icinga Web 2 NagVis Passwortänderung}}
+==== 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.
+Als erstes legen wir uns das Backup-Verzeichnis an.
+   # mkdir /root/nagvis
+Dann verschieben wir die map-Konfigurationsdateien in dieses Verzeichnis.
+   # mv /usr/share/nagvis/etc/maps/* /root/nagvis/
+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>
-vi etc/nagvis.ini.php
+==== Automap ====
+Im folgendem Konfigurationsbeispiel, werden wir uns nun eine Automap für unseren Icinga 2 Host und den überwachten Hosts anlegen.
-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.
+Als erstes wählen wir aus dem NagVis-Menü **Optionen** den Menüpunkt
-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_0146.png?direct&800 |Bild: Icinga Web 2 NagVis Datenquellen}}
-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
+Hier wählen wir dann die **Standard-Datenquelle** aus und klicken anschließend auf die Schaltfläche **Speichern**.
-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.
+{{ :centos:web_c7:icinga:icinga_0147.png?direct&800 |Bild: Icinga Web 2 NagVis Datenquellen}}
-In diesem Beispiel müssen Sie @NAGVIS_WEB@ durch /nagvis und @NAGVIS_PATH@ durch /usr/local/nagvis/share ersetzen.
-SCHRITT 6: Berechtigungen
+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**.
-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:
+{{ :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!