debian/README.Debian

   1 nagvis for Debian
   2 =================
   3
   4 As of version 1.6.4-1 nagvis uses the check-mk-livestatus backend as
   5 default to gather its information, however you'll have to manually activate
   6 that module in your Nagios or Icinga setup.
   7
   8
   9 Sadly currently it's not possible to make the package just work out of the
  10 box.  However, you'll only need to do two steps by hand to get NagVis up
  11 and running:
  12 1) Actiate the check-mk-livestatus backend (if not already done).
  13 2) Grant the www-data User Access to the check-mk-livestatus socket.
  14
  15 See sections bellow for details.
  16
  17
  18 Passwords
  19 =========
  20
  21 After successfull installation you should be able to access NagVis via
  22 http://$host/nagvis/.  To login you can use the user accoung "admin"
  23 (password "admin") or "guest" (with password "guest").
  24
  25
  26
  27 Using NagVis with Icinga:
  28 =========================
  29
  30 Add the following line to your /etc/icinga/icinga.cfg file:
  31
  32 --------
  33 broker_module=/usr/lib/check_mk/livestatus.o /var/lib/icinga/rw/live
  34 --------
  35
  36 This will activate check-mk-livestatus.  Please see
  37 /usr/share/doc/check-mk-livestatus/README.Debian for more details and
  38 further pointers.
  39
  40 You have to grant the www-data user read/write access to MK Livestatus'
  41 socket.  This may be done by runninf the following commands:
  42
  43 --------
  44 /etc/init.d/icinga stop
  45 dpkg-statoverride --update --add nagios www-data 2710 /var/lib/icinga/rw
  46 dpkg-statoverride --update --add nagios nagios 751 /var/lib/icinga
  47 /etc/init.d/icinga start
  48 --------
  49
  50 This will also enable support for external commands.  Please see
  51 /usr/share/doc/icinga/README.Debian section "External Commands" for further
  52 details and implications.
  53
  54
  55 Using NagVis with Nagios:
  56 =========================
  57
  58 Add the following line to your /etc/nagios3/nagios.cfg file:
  59
  60 --------
  61 broker_module=/usr/lib/check_mk/livestatus.o /var/lib/nagios3/rw/live
  62 --------
  63
  64 This will activate check-mk-livestatus.  Please see
  65 /usr/share/doc/check-mk-livestatus/README.Debian for more details and
  66 further pointers.
  67
  68 You have to grant the www-data user read/write access to MK Livestatus'
  69 socket.  This may be done by runninf the following commands:
  70
  71 --------
  72 /etc/init.d/nagios3 stop
  73 dpkg-statoverride --update --add nagios www-data 2710 /var/lib/nagios3/rw
  74 dpkg-statoverride --update --add nagios nagios 751 /var/lib/nagios3
  75 /etc/init.d/nagios3 start
  76 --------
  77
  78 This will also enable support for external commands.  Please see
  79 /usr/share/doc/nagios3/README.Debian section "External Commands" for further
  80 details and implications.
  81
  82
  83  -- Alexander Reichle-Schmehl <tolimar@debian.org>  Wed, 22 Feb 2012 15:22:51 +0100