===== NagVis =====

**View Nagios hosts status on any background image**

Web Site: http://www.nagvis.org/


===== Prerequisites =====


=== MKLivestatus - Event Broker Module ===

[[http://www.mathias-kettner.de/checkmk_livestatus.html|MKLivestatus]] it's an Event Broker Module that provides an Unix socket to which NagVis (and every similar application) can //link// to receive real time Nagios data. MKLivestatus requires the php module //php-net-socket (Debian) / php5-sockets (SUSE)//.

You can also install a Nagios alternative front-end (**Check MK**) completely based on Nagios config files. Check MK requires the Apache Python module, //python_module (SUSE)//.

If you install Check MK, add the following entry in ///etc/apache2/sysconfig.d/loadmodule.conf//:

  LoadModule python_module                  /usr/lib64/apache2/mod_python.so

Add the entry entry //python// in ///etc/sysconfig/apache2// for the keyword //APACHE_MODULES//:

  APACHE_MODULES=".... python"
 

== MKLivestatus and Check MK installation ==

Installing Check MK as well, it's possible to use the installer to facilitate the process:

  -[[http://mathias-kettner.de/check_mk_download.html|download the tarball]] in /download (for example)
  -go to download folder: **''cd /download''**
  -extract the content: **''tar xzf check_mk-//version//.tar.gz''**
  -go to the extracted files directory: **''cd check_mk-//version//''**
  -run the script: **''./setup.sh''**
  -answer the questions

The installer modifies the Nagios configuration file (///usr/local/nagios/etc/nagios.cfg//) by adding the statement to load the broker in Nagios:

<code>
# Load Livestatus Module
broker_module=/usr/lib/check_mk/livestatus.o /usr/local/nagios/var/rw/live
event_broker_options=-1

# added by setup.sh of check_mk 
cfg_dir=/usr/local/nagios/etc/check_mk.d
</code>


===== Installation =====

  -[[http://www.nagvis.org/downloads|download the tarball]] in /download (for example)
  -goto in download folder: **''cd /download''**
  -extract the content: **''tar xzf nagvis-//versione//.tar.gz''**
  -go to the extracted files directory: **''cd nagvis-//versione//''**
  -run the script: **''./install.sh''**