Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende ÜberarbeitungLetzte ÜberarbeitungBeide Seiten der Revision | ||
centos:web_c7:icinga:nagvis [21.04.2015 07:03. ] – [Icinga Web 2 Modul] django | centos:web_c7:icinga:nagvis [21.04.2015 09:43. ] – Icinga Web 2 - Einbinden von NagVis zur graphischen Visualisierung - Installation und Konfiguration unter CentOS 7.x #centOS7 #nagvis #icinga2 django | ||
---|---|---|---|
Zeile 43: | Zeile 43: | ||
==== Installation ==== | ==== 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. | + | 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: |
Als erstes holen wir uns das aktuelle **tar.gz**-Paket von der [[http:// | Als erstes holen wir uns das aktuelle **tar.gz**-Paket von der [[http:// | ||
Zeile 1073: | Zeile 1073: | ||
===== Icinga Web 2 Modul ===== | ===== Icinga Web 2 Modul ===== | ||
+ | ==== Installation ==== | ||
Für das Einbetten der NagVis-Karten in **Icinga Web2** greifen wir auf das Modul **[[https:// | Für das Einbetten der NagVis-Karten in **Icinga Web2** greifen wir auf das Modul **[[https:// | ||
Zeile 1084: | Zeile 1085: | ||
# mv / | # mv / | ||
+ | ==== Konfiguration ==== | ||
+ | Zur Konfiguration von **Icinga Web 2** öffnen wir die URL unserer Icinga-Installation. | ||
+ | $ firefox https:// | ||
+ | Hier melden wir uns nun wie gewohnt an. | ||
+ | {{ : | ||
+ | Auf der linken Seite klicken wir auf den Menüpunkt **System**. | ||
+ | {{ : | ||
- | ==== muell ==== | + | Hier licken wir nun auf den Menüpunkt **Module**. |
- | + | {{ :centos: | |
- | Diese Anweisungen gelten für eine Neuinstallation. | + | |
- | Wenn Sie Ihre alte NagVis-Installation aktualisieren, | + | |
- | 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 | + | |
- | tar xvzf nagvis-1.8.x.tar.gz | + | In diesem Fenster wählen wir dann unser neues Modul **nagvis** an. |
- | SCHRITT 3: verschieben Sie das entpackte NagVis-Verzeichnis | + | {{ :centos: |
- | Platzieren Sie den NagVis-Verzeichnisbaum irgendwo in Ihrem System. In den meisten Fällen ist /usr/local/nagvis | + | |
- | mv nagvis-1.8.x / | + | Zum aktivieren klicken wir auf der rechten Bildschirmseite auf den Schriftzug **enable**. |
- | Sie sollten mindestens die folgenden Dateien und Verzeichnisse unter dem nagvis-Verzeichnis sehen | + | {{ : |
- | ls -l / | + | Zur abschließenden Modulkonfiguration klicken wir nun rechts oben auf den Reiter **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/ | + | {{ :centos: |
- | SCHRITT 4: konfigurieren Sie NagVis | + | |
- | Wechseln Sie zur neuen Position des NagVis-Verzeichnisses | + | |
- | cd / | + | Hier tragen wir nun die URL bzw. das Verzeichnis unserer **NagVis**-Installation ein und klicken abschließend auf die Schaltfläche **Save Changes**. |
- | 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/ | + | ===== 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**. | ||
- | Nun können Sie dieses Datei mit Ihrem bevorzugten Texteditor ändern � ich benutze vi: | + | {{ :centos: |
- | vi etc/nagvis.ini.php | + | Zur Erstanmeldung am Modul **Nagvis** geben wir als Anmeldedaten jeweils **admin** ein und klicken dann auf die Schaltfläche **Einloggen**. |
- | 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, | + | Einen ersten Eindruck können wir uns mit Hilfe der bei der Erstinstallation angelegten Demo-Karten verschaffen. |
- | Kopieren Sie einfach die Datei in das conf.d-Verzeichnis Ihres Web-Servers. Dies ist z.B. / | + | |
- | cp etc/ | + | {{ : |
- | 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 / | ||
- | SCHRITT 6: Berechtigungen | ||
- | Dies ist sehr wichtig für eine funktionierende Installation. | ||
- | Prüfen Sie zuerst, welcher Unix-Account | + | ===== 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 | ||
- | Ubuntu | + | {{ : |
- | grep -e ' | + | 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**. |
- | SuSE/RedHat/Debian (SLES, OpenSuSE, Fedora) | + | Den ungenutzten Gastzugang löschen wir nun noch, indem wir den Nutzernamen beim Menüpunkt **//Nutzer löschen// |
- | grep -e ' | + | 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. |
- | 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 / | + | Nach Eingabe des alten Passwortes |
- | chmod 664 / | + | |
- | chmod 775 / | + | |
- | chmod 664 / | + | |
- | chmod 775 / | + | |
- | chmod 664 / | + | |
- | chmod 775 / | + | |
- | chmod 664 / | + | |
- | chmod 775 / | + | |
- | chmod 664 / | + | |
- | chmod 775 / | + | |
- | chmod 664 / | + | |
- | 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://< | + | ==== 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__**, | ||
- | 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. | + | Als erstes legen wir uns das Backup-Verzeichnis an. |
- | SCHRITT 8: betrachten Sie die Maps | + | # mkdir /root/nagvis |
- | Sie sollten nun in der Lage sein, Ihre definierten Maps in Ihrem Browser anzusehen: | + | |
- | http://< | + | Dann verschieben wir die map-Konfigurationsdateien in dieses Verzeichnis. |
+ | # mv /usr/share/nagvis/etc/maps/* /root/nagvis/ | ||
- | (z.B. http://localhost/frontend/nagvis-js/?mod=Map&show=deutschland) | + | Abschließend deaktivieren wir noch die Parameter des Definitionsbereichs **Rotation pool definitions** in der Datei |
+ | # vim / | ||
+ | |||
+ | < | ||
+ | |||
+ | ; ---------------------------- | ||
+ | ; 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? | ||
+ | ; Django : 2015-04-20 | ||
+ | ; default: [rotation_demo] | ||
+ | ; These steps are rotated. The single steps may have optional prefixes like " | ||
+ | ; 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=" | ||
+ | ; rotation interval | ||
+ | ; Django : 2015-04-20 | ||
+ | ; default: interval=15 | ||
+ | |||
+ | ...</ | ||
+ | |||
+ | ==== Automap ==== | ||
+ | Im folgendem Konfigurationsbeispiel, | ||
+ | |||
+ | Als erstes wählen wir aus dem NagVis-Menü **Optionen** den Menüpunkt | ||
+ | |||
+ | {{ :centos: | ||
+ | |||
+ | Hier wählen wir dann die **Standard-Datenquelle** aus und klicken anschließend auf die Schaltfläche **Speichern**. | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Nun definieren wir uns eine eigene Karte vom Typ **automap**; | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | 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. | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Basieren auf den Monitoringkonfiguration unserer **Icinga 2** Umgebung wird nach einer kurzen Zeit die generierte **automap** angezeigt. | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Sobald wir mit der Maus übe einen der überwachten Host streichen, werden weitere Details des Hosts eingeblendet. | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | Klicken wir auf einen Host, gelangen wir direkt auf die Icinga Web 2 Detailseite des Hosts. | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | |||
+ | ====== Links ====== | ||
+ | * **⇐ [[centos: | ||
+ | * **[[centos: | ||
+ | * **[[wiki: | ||
+ | * **[[http:// | ||
- | Viel Spaß und bitte melden Sie Bugs! | + | ~~DISCUSSION~~ |
+ | ~~AUTOTWEET: |