File nagvis-README.SuSE of Package nagvis

nagvis for SUSE
=================

As of version 1.6.4-1 nagvis uses the check-mk-livestatus backend as
default to gather its information, however you'll have to manually activate
that module in your Nagios or Icinga setup.

Sadly currently it's not possible to make the package just work out of the
box.  However, you'll only need to do two steps by hand to get NagVis up
and running:
1) Actiate the check-mk-livestatus backend (if not already done).
2) Grant the wwwrun User Access to the check-mk-livestatus socket.

See sections bellow for details.


Passwords
=========

After successfull installation you should be able to access NagVis via
http://$host/nagvis/.  To login you can use the user accoung "admin"
(password "admin") or "guest" (with password "guest").

Using NagVis with Icinga:
=========================

Add the following line to your /etc/icinga/icinga.cfg file:

--------
broker_module=/usr/lib/check_mk/livestatus.o /var/spool/check_mk/livestatus.cmd
--------

This will activate check-mk-livestatus.  Please see
/usr/share/doc/packages/check_mk/README.SuSE for more details and
further pointers.

You have to grant the wwwrun user read/write access to MK Livestatus'
socket.  This may be done by runninf the following commands:

--------
groupmod -A wwwrun icingacmd 
--------

This will also enable support for external commands.  Please see
/usr/share/doc/packages/icinga/README.SuSE section "External Commands" for further
details and implications.


Using NagVis with Nagios:
=========================

Add the following line to your /etc/nagios/nagios.cfg file:

--------
broker_module=/usr/lib/check_mk/livestatus.o /var/spool/check_mk/livestatus.cmd
--------

This will activate check-mk-livestatus.  Please see
/usr/share/doc/packages/check_mk/README.SuSE for more details and
further pointers.

You have to grant the wwwrun user read/write access to MK Livestatus'
socket.  This may be done by runninf the following commands:

--------
groupmod -A wwwrun nagcmd
--------

This will also enable support for external commands.  Please see
/usr/share/doc/packages/nagios/README.SuSE section "External Commands" for further
details and implications.

openSUSE Build Service is sponsored by