debian/README.Debian

   1 PNP4Nagios for Debian
   2 ---------------------
   3
   4 PNP4Nagios supports several modes of operation. They differ in the way how
   5 performance data is being processed and, thus, the efficiency of PNP. Detailed
   6 documentation is available at <http://docs.pnp4nagios.org/pnp-0.6/modes>.
   7
   8 Using bulk mode
   9 ---------------
  10
  11 We recommend to use bulk mode with NPCD and npcdmod. This will facilitate an
  12 easy installation and fast processing of performance data. To enable NPCD, set
  13 'RUN' to 'yes' in /etc/default/npcd.
  14
  15 In order to enable processing of performance data in Nagios, please change the
  16 "process_performance_data" statement in "/etc/nagios3/nagios.cfg" to
  17 "process_performance_data=1".
  18
  19 To register the NPC event broker module (npcdmod), add the following line
  20 (without quotes) to "/etc/nagios3/nagios.cfg":
  21
  22 "broker_module=/usr/lib/pnp4nagios/npcdmod.o config_file=/etc/pnp4nagios/npcd.cfg"
  23
  24 Finally reload your Nagios server by running "/etc/init.d/nagios3 reload". All
  25 performance data should be processed now.
  26
  27 If you want links to PNP4Nagios for your monitored hosts and services in the
  28 Nagios web frontend just add
  29
  30 - "action_url  /pnp4nagios/graph?host=$HOSTNAME$"
  31   to your hosts or host template(s)
  32
  33 - "action_url  /pnp4nagios/graph?host=$HOSTNAME$&srv=$SERVICEDESC$"
  34   to your services or service template(s)
  35
  36 For more information and different modes of operation, see
  37 <http://docs.pnp4nagios.org/pnp-0.6/config>.
  38
  39  -- Sven Velt <sven@velt.de>  Wed, 30 Sep 2009 13:55:35 +0000
  40
  41 Using Gearman mode
  42 ------------------
  43
  44 Starting with version 0.6.12, PNP4Nagios may operate as a Gearman worker. This
  45 is useful in large, distributed setups using Nagios's mod_gearman. To use
  46 the PNP Gearman worker, you'll need a running mod_gearman environment. See
  47 <http://labs.consol.de/lang/en/nagios/mod-gearman/> for detailed setup
  48 instructions.
  49
  50 In addition, the following configuration is required to get you started:
  51
  52 - Enable processing of performance data in Nagios: set
  53   'process_performance_data=1' in "/etc/nagios3/nagios.cfg" and reload your
  54   Nagios server: /etc/init.d/nagios3 reload.
  55
  56 - Enable the PNP Gearman worker daemon by setting 'RUN' to 'yes' in
  57   /etc/default/pnp_gearman_worker. Check the Gearman related options in
  58   "/etc/pnp4nagios/process_perfdata.cfg" (GEARMAN_HOST and encryption
  59   settings) and start the Gearman worker: /etc/init.d/pnp_gearman_worker start
  60
  61 - Enable distribution of performance data in mod_gearman by setting the
  62   'perfdata=yes' option.
  63
  64 When operating in Gearman mode, process_perfdata.pl requires the
  65 Gearman::Worker, MIME::Base64, and Crypt::Rijndael Perl modules. These are
  66 available in the libgearman-client-perl, perl, and libcrypt-rijndael-perl
  67 Debian packages (see packages suggested by pnp4nagios-bin).
  68
  69  -- Sebastian Harl <tokkee@debian.org>  Wed, 27 Apr 2011 09:32:52 +0200
  70
  71 Installation with Icinga
  72 ------------------------
  73
  74 If you use Icinga you also have to change /etc/pnp4nagios/apache.conf and
  75 replace the line "AuthUserFile /etc/icinga/htpasswd.users" with
  76 "AuthUserFile /etc/icinga/htpasswd.users".
  77
  78  -- Alexander Reichle-Schmehl <tolimar@debian.org>  Tue, 25 Oct 2011 14:31:28 +0200
  79