Formatbeschreibung der Hauptkonfigurationsdatei
Allgemeine Informationen
Die Hauptkonfigurationsdatei ist im reinen Textformat im Stil der "ini"-Dateien.
Abschnitte sind durch [] markiert und Variablen haben einen zugewiesenen Wert. Die Variablen müssen auch im richtigen Abschnitt stehen, so dass Sie sicherstellen müssen, dass ggf. auch der Abschnitt aktiviert ist.
Semikola (;) werden benutzt, um Kommentare zu markieren. Abschnitte und Variablen mit einem vorangestellten Semikolon werden als Kommentare angesehen und von NagVis nicht erkannt.
Bei einer neuen NagVis-Installation gibt es keine Datei mit einer Default-Konfiguration. Standardwerte sind im PHP-Code enthalten.
Konfigurationseinstellungen in der Datei etc/nagvis.ini.php übersteuern diese Standardwerte.
Es gibt eine Datei etc/nagvis.ini.php-sample mit Beispiel-Konfigurationswerten. Alle Werte sind auskommentiert.
Beschreibung der Abschnitte im Detail
global
Alle Werte, die für das gesamte NagVis gelten, werden im global-Abschnitt gespeichert. Dieses Beispiel zeigt alle Werte des global-Abschnittes:
[global]
language="english"
displayheader=1
refreshtime=60
dateformat="Y-m-d H:i:s"
| Wert | Default | Beschreibung |
| language | english | Sprachauswahl (german und english sind als Standard verfügbar) |
| displayheader | 1 | Anzeigen des Header-Menus in Maps |
| refreshtime | 60 | Aktualisierungsintervall in Maps bzw. laden der nächsten Map bei Map-Rotation |
| dateformat | Y-m-d H:i:s | Das in NagVis benutzte Format für Datum- und Zeit. Verfügbare Optionen wie bei der date()-Funktion von php (neu in 1.3) |
|
defaults
Default-Werte für Maps, die Sie benutzen. Wenn für die Map bzw. ein Element kein Wert angegeben wurde, dann wird ein Standardwert benutzt.
Dieses Beispiel zeigt alle Werte im defaults-Abschnitt:
[defaults]
backend="ndomy_1"
icons="std_medium"
recognizeservices=1
onlyhardstates=0
usegdlibs=1
backgroundcolor="#fff"
headertemplate="default"
showinlists=1
urltarget="_self"
hovermenu=1
hovertemplate="default"
hoverdelay=0
hoverchildshow=1
hoverchildssort="a"
hoverchildsorder="asc"
hoverchildslimit=10
| Wert | Default | Beschreibung |
| backend | ndomy_1 | Default-Backend (ID des Backends – kopieren Sie den Text, der für [backend_<backend-id>]) |
| icons | std_medium | Default-Iconset |
| recognizeservices | 1 | Service-Zustände in Host/Hostgroup-Objekten erkennen |
| onlyhardstates | 0 | nur Hard-Zustände benutzen (keine Soft-Zustände) |
| backgroundcolor | #fff | Default-Hintergrundfarbe für Maps |
| usegdlibs | 1 | gdlibs benutzen (wenn 0, werden Linien nicht funktionieren, alle anderen Typen sollten funktionieren) |
| headertemplate | default | Default header template |
| showinlists | 1 | Anzeigen von Maps in Listen (Dropdowns, Index-Seite, ...) |
| urltarget | _self | Ziel des Icon-Links, diese Option passt an (_self ist das gleiche Fenster) |
| hovermenu | 1 | aktivieren/deaktivieren von Hover-Menüs (neu mit 1.3) |
| hovertemplate | default | Default hover template |
| hovertimeout | 5 | Default-Timeout bei Ajax-Anfragen in Hover-Menüs (in Sekunden) (neu mit 1.3) |
| hoverdelay | 0 | Verzögerung des Hover-Menü-Auftretens (in Sekunden) |
| hoverchildsshow | 1 | Anzeigen von Child-Objekten in Hover-Menüs (neu mit 1.3) |
| hoverchildssort | a | Sortierreihenfolge von Child-Objekten ("s"=Status, "a"=Alphabet) (neu mit 1.3) |
| hoverchildsorder | asc | Reihenfolge von Child-Objekten ("asc"=aufsteigend, "desc"=absteigend) (neu mit 1.3) |
| hoverchildslimit | 10 | max. Anzahl von Child-Objekten (neu mit 1.3) |
wui
Dieses sind die Optionen für die WUI.
Dieses Beispiel zeigt alle Werte des wui-Abschnitts:
[wui]
autoupdatefreq=25
maplocktime=5
allowedforconfig=EVERYONE
| Wert | Default | Beschreibung |
| autoupdatefreq | 25 | In diesem Intervall wird die Map von der WUI gesichert. |
| maplocktime | 5 | Zeit in Minuten, die eine Map von einem editierenden Benutzer blockiert wird. |
| allowedforconfig | EVERYONE | Benutzer, die die NagVis-Konfiguration ändern dürfen (kommaseparierte Liste) oder EVERYONE |
paths
In diesem Abschnitt werden alle benötigten Pfad-Variablen definiert.
Dieses Beispiel zeigt alle Werte des paths-Abschnitts:
[paths]
base="/usr/local/nagios/share/nagvis/"
htmlbase="/nagios/nagvis"
htmlcgi="/nagios/cgi-bin"
| Wert | Default | Beschreibung |
| base | /usr/local/nagios/share/nagvis/ | absoluter physikaler NagVis-Pfad |
| htmlbase | /nagios/nagvis | absoluter html-NagVis-Pfad |
| htmlcgi | /nagios/cgi-bin | absoluter html-NagVis-cgi-Pfad |
backend_*
Die Backend-Abschnitte zur Definition der Backends werden alle [backend_<backend-id>] benannt. In dem Beispiel ist ndomy_1 die backend_id.
Abhängig vom Wert in backendtype müssen die gültigen Werte für die Backends gesetzt werden. In diesem Beispiel ist es das ndomy-Backend.
[backend_ndomy_1]
backendtype="ndomy"
; the following options depend on the selected backendtype, in this case it is ndomy
dbhost="localhost"
dbport=3306
dbname="db_nagios"
dbuser="root"
dbpass="xxx"
dbprefix="nagios_"
dbinstancename="default"
maxtimewithoutupdate=181
htmlcgi="/nagios/cgi-bin"
| Wert | Default | Beispiel |
| backendtype | ndomy | Art des Backends – MUSS gesetzt werden |
| dbhost | localhost | Hostname des Rechner mit der NDO-Datenbank |
| dbport | 3306 | Port der NDO-Datenbank |
| dbname | db_nagios | Name der NDO-Datenbank |
| dbuser | root | Benutzername für den Datenbankzugriff (nur Lese-Berechtigung erforderlich) |
| dbpass | root | Passwort für den Datenbankzugriff (nur Lese-Berechtigung erforderlich) |
| dbprefix | nagios_ | Präfix der Tabellen der NDO-Datenbank (wie in ndo2db.cfg definiert) |
| dbinstancename | default | Name der Nagios-Instanz der NDO-Datenbank (wie in ndomod.cfg definiert) |
| maxtimewithoutupdate | 180 | Max. Verzögerung in Sekunden nach dem letzten Update in NDO. NagVis meldet, dass Nagios nicht läuft, wenn die Verzögerung erreicht wurde. |
| htmlcgi | /nagios/cgi-bin | Pfad zum cgi-bin-Verzeichnis dieses Backends (interessant bei mehreren NDO-Backends) |
rotation_*
Definiert verschiedene Map-Rotationspools. In diesem Beispiel schaltet der Browser alle 15 Sekunden zwischen den Maps "demo" und "demo2" hin und her. Die Rotation wird aktiviert durch die URL: index.php?rotation=.
In diesem Fall ist die Rotation-ID "demo"
[rotation_demo]
maps="demo,demo2"
interval=15
| Wert | Default | Beschreibung |
| maps | | Liste von Maps in diesem Pool, die zu rotieren sind. Sie können auch externe URLs durch [] klammern (z.B. maps="demo1,[http://localhost/test.php]". Die URL muss von dem Server erreichbar sein, auf dem NagVis läuft. |
| interval | 15 | Map-Rotationsintervall in Sekunden |
automap
(Neu in 1.3)
Setzt die Automap-Optionen.
[automap]
showinlists=1
defaultroot="localhost"
graphvizpath="/usr/local/bin"
defaultparams="&maxLayers=2"
| Wert | Default | Beschreibung |
| showinlists | 1 | aktivieren/deaktivieren der Automap in Map-Listen (Map-Indexseite, Dropdown-Menüs in den Headern) |
| defaultroot | localhost | Default-Wert für das Root-Objekt. Details finden Sie in der Automap-Dokumentation |
| graphvizpath | /usr/local/bin | wenn die graphviz-Binaries (dot,neato,twopi,...) nicht über PATH gefunden werden können, muss der Pfad hier gesetzt werden |
| defaultparams | &maxLayers=2 | Dies sind die Parameter für die Automap-Ansichten und Links in den Listen (Map-Indexseite, Dropdown-Menüs in den Headern) |