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.

Überblick

global
allgemeine Optionen, die die gesamte NagVis-Installation beeinflussen
paths
Pfaddefinitionen
defaults
Standardwerte, die an die Maps und ihre Objekte vererbt werden
index
Optionen, um die Übersichtsseite für NagVis zu konfigurieren (neu in 1.4)
automap
Optionen für die Automap
wui
Optionen für die WUI
worker
Optionen für den Worker (neu in 1.4)
backend_*
Backend-Definitionen
rotation_*
Rotationspool-Definitionen

Beschreibung der Abschnitte im Detail

global

Alle Werte, die für das gesamte NagVis gelten, werden im global-Abschnitt gespeichert.

Wert	Default	Beschreibung
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
~~displayheader~~	1	~~Anzeigen des Header-Menus in Maps~~ Entfällt ab Version 1.4, siehe Option "headermenu" in den default- und index-Abschnitten
language	en_US	Wählen Sie die Sprache, die in NagVis benutzt werden soll. `de_DE` (Deutsch), `en_US` (Englisch), `fr_FR` (Französisch) und `pt_BR` (brasilianisches Portugiesisch; ab 1.4.4) sind als Standard verfügbar). Seit 1.4 müssen Sie die Sprache in einem anderen Format angeben. ("de_DE" statt "german")
refreshtime	60	Aktualisierungsintervall in Maps bzw. laden der nächsten Map bei Map-Rotation

paths

In diesem Abschnitt werden alle benötigten Pfad-Variablen definiert.

Wert	Default	Beschreibung
base	`/usr/local/nagios/share/nagvis/`	absoluter physikalischer NagVis-Pfad
htmlbase	`/nagios/nagvis`	absoluter html-NagVis-Pfad
htmlcgi	`/nagios/cgi-bin`	absoluter html-NagVis-cgi-Pfad

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.

Wert	Default	Beschreibung
backend	ndomy_1	Default-Backend (ID des Backends - kopieren Sie den Text, der für `<backend-id>` steht, nach `[backend_<backend-id>]`)
backgroundcolor	#fff	Default-Hintergrundfarbe für Maps
contextmenu	0	Aktivieren/Deaktivieren des Kontextmenüs auf Ihren Map-Objekten. (Neu in 1.4)
contexttemplate	default	Default context template. (Neu in 1.4)
eventbackground	0	aktivieren (1) bzw. deaktivieren (0) des Wechselns der Hintergrundfarbe bei Statusänderungen (die konfigurierte Farbe wird gezeigt, wenn der Gesamtstatus PENDING, OK oder UP ist) (Neu in 1.4)
eventhighlight	1	aktivieren (1) bzw. deaktivieren (0) der Hervorhebung von Statusänderungen durch Hinzufügen einer blinkenden Umrandung (Neu in 1.4)
eventlog	0	aktivieren (1) bzw. deaktivieren (0) des Ereignisprotokolls im neuen JavaScript-Frontend. Das Ereignisprotokoll enthält wichtige Aktionen und Informationen (Neu in 1.4)
eventloglevel	info	Loglevel des Ereignisprotokolls (verfügbar: debug, info, warning, critical) (Neu in 1.4)
eventheight	100	Höhe des JavaScript-Eventlogs in Pixeln (Neu in 1.4)
eventhidden	1	Verstecken/Zeigen des Eventlogs während des Map-Ladens (Neu in 1.4)
eventscroll	1	aktivieren (1) bzw. deaktivieren (0) des Bewegens zu dem Icon, das den Status verändert hat, falls das Icon nicht im sichtbaren Bereich liegt (Neu in 1.4)
eventsound	1	aktivieren (1) bzw. deaktivieren (0) von Sound-Signalen bei Statusänderungen (Neu in 1.4)
headermenu	1	aktivieren (1) bzw. deaktivieren (0) des Headermenüs
headertemplate	default	Default header template
hoverchildslimit	10	max. Anzahl von Child-Objekten
hoverchildsorder	asc	Reihenfolge von Child-Objekten ("asc"=aufsteigend, "desc"=absteigend)
hoverchildsshow	1	Anzeigen von Child-Objekten in Hover-Menüs
hoverchildssort	a	Sortierreihenfolge von Child-Objekten ("s"=Status, "a"=Alphabet)
hoverdelay	0	Verzögerung des Hover-Menü-Auftretens (in Sekunden)
hovermenu	1	aktivieren/deaktivieren von Hover-Menüs
hovertemplate	default	Default hover template
~~hovertimeout~~	5	~~Default-Timeout bei Ajax-Anfragen in Hover-Menüs (in Sekunden)~~ veraltet ab 1.4
icons	std_medium	Default-Iconset
onlyhardstates	0	nur Hard-Zustände benutzen (keine Soft-Zustände)
recognizeservices	1	Service-Zustände in Host/Hostgroup-Objekten erkennen
showinlists	1	Anzeigen von Maps in Listen (Dropdowns, Index-Seite, ...)
urltarget	_self	Ziel des Icon-Links, diese Option passt <a target=""> an (_self ist das gleiche Fenster)
~~usegdlibs~~	1	~~gdlibs benutzen (wenn 0, werden Linien ggf. nicht funktionieren, alle anderen Typen sollten funktionieren)~~ veraltet ab 1.4

index

Dieses sind die Optionen für die Übersichtsseite von NagVis (neu mit 1.4).

Wert	Default	Beschreibung
backgroundcolor	#fff	Default-Hintergrundfarbe für die Übersichtsseite
cellsperrow	4	Maps pro Zeile in Map-Listen.
headermenu	1	aktivieren (1) bzw. deaktivieren (0) des Headermenüs
headertemplate	default	Default header template
showrotations	1	aktivieren/deaktivieren der Anzeige von definierten Rotationen

automap

Setzt die Automap-Optionen.

Wert	Default	Beschreibung
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)
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
showinlists	1	aktivieren/deaktivieren der Automap in Map-Listen (Map-Indexseite, Dropdown-Menüs in den Headern)

wui

Dieses sind die Optionen für die WUI.

Wert	Default	Beschreibung
allowedforconfig	EVERYONE	Benutzer, die die NagVis-Konfiguration ändern dürfen (kommaseparierte Liste) oder EVERYONE
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.

worker

Optionen für den neuen Worker im JavaScript-Frontend von NagVis. (neu in 1.4)

Wert	Default	Beschreibung
interval	5	Das Intervall in Sekunden, in dem der Worker auf zu aktualisierende Objekte prüft.
updateobjectstates	15	Die Aufbewahrungszeit in Sekunden für die Zustände im Frontend. Die Statusinformationen werden nach Ablauf dieser Zeit im folgenden Worker-Intervall aufgefrischt.

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	Beschreibung
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=<rotation-id>. In diesem Fall ist die Rotation-ID "demo"

[rotation_demo]
maps="demo,demo2"
interval=15

Wert	Default	Beschreibung
interval	15	Map-Rotationsintervall in Sekunden
maps		kommaseparierte 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. Neu in 1.4: Sie können Label im folgenden Format hinzufügen: <label>:<map> und <label>:<[url]>. Die Label werden in der Rotationsliste angezeigt.