The Main Configuration file is designed in plain text "ini"-like format.
There are sections which are marked by the surrounding brackets [] and variables which have an assigned value. The variables have to be in the correct section so you have to ensure to have uncommented the section too.
Semicolons (;
) are used to mark comments. Sections and variables with a leading semicolon are commented out and won't be recognized by NagVis.
In a fresh NagVis installation there is no file with the default configuration. The default configuration is stored in the PHP-Code of NagVis. If there is a file etc/nagvis.ini.php
which has stored configuration information it will override the default configurations.
There is a file etc/nagvis.ini.php-sample
with sample configuration values. All values are commented out.
All values which are used througout NagVis are stored in the global section.
Value | Default | Description |
backend | ndomy_1 | Default backend (ID of the backend - copy the text from which <backend-id> stands for in [backend_<backend-id>] ) |
backgroundcolor | #fff | Default background color of maps |
contextmenu | 0 | Enable/Disable the context menu on your map objects. (New in 1.4) |
contexttemplate | default | Default context template. (New in 1.4) |
eventbackground | 0 | Enable/Disable changing background color on state changes (Configured color is shown when summary state is PENDING, OK or UP) (New in 1.4) |
eventhighlight | 1 | Enable/Disable highlighting of the state changing object by adding a flashing border (New in 1.4) |
eventhighlightduration | 10000 | Duration of the highlighting in miliseconds (New in 1.4.1) |
eventhighlightinterval | 500 | Interval of the highlighting in miliseconds (New in 1.4.1) |
eventlog | 0 | Enable/Disable the eventlog in the new javascript frontend. The eventlog keeps track of important actions and information (New in 1.4) |
eventloglevel | info | Loglevel of the eventlog (Available: debug, info, warning, critical) (New in 1.4) |
eventlogheight | 100 | Height of the javascript eventlog in px (New in 1.4) |
eventloghidden | 1 | Hide/Show the eventlog on map loading (New in 1.4) |
eventscroll | 1 | Enable/Disable scrolling to the icon which changed the state when the icon is out of the visible scope (New in 1.4) |
eventsound | 1 | Enable/Disable sound signals on state changes (New in 1.4) |
headermenu | 1 | Enable/Disable the header menu |
headertemplate | default | Default header template |
hovermenu | 1 | Enable/Disable the hover menu |
hovertemplate | default | Default hover template |
hovertimeout | 5 | Default hover menu ajax request timeout in seconds (Deprecated in 1.4) |
hoverdelay | 0 | Delay of hover menu appearance in seconds |
hoverchildsshow | 1 | Enable/Disable the child objects in hover menu |
hoverchildslimit | 10 | Limit hover child objects to this maximum value |
hoverchildsorder | asc | Order of the child objects (Available: asc/desc) |
hoverchildssort | a | Sort method of the child objects (Available: "s": State, "a": Alphabet ) |
icons | std_medium | Default iconset |
onlyhardstates | 0 | Recognize only hard states (not soft) |
recognizeservices | 1 | Recognize service states in host/hostgroup objects |
showinlists | 1 | Show the maps in lists (dropdowns,index page,...) |
urltarget | _self | Target of the Icon link, this option adapts <a target=""> (_self is same window) |
usegdlibs | 1 | Use gdlibs (if set to 0, lines will not work, all other types should work fine) (Deprecated in 1.4) |