diff --git a/debian/README.Debian b/debian/README.Debian
index 5364f0a5a9f1397c493ca89387d4d549e8d73217..87456770066fab5ae681e7b32cd55e57a3efeec2 100644 (file)
--- a/debian/README.Debian
+++ b/debian/README.Debian
performance data is being processed and, thus, the efficiency of PNP. Detailed
documentation is available at <http://docs.pnp4nagios.org/pnp-0.6/modes>.
performance data is being processed and, thus, the efficiency of PNP. Detailed
documentation is available at <http://docs.pnp4nagios.org/pnp-0.6/modes>.
-Using bulk mode
----------------
+Using bulk mode for Nagios3
+---------------------------
We recommend to use bulk mode with NPCD and npcdmod. This will facilitate an
easy installation and fast processing of performance data. To enable NPCD, set
We recommend to use bulk mode with NPCD and npcdmod. This will facilitate an
easy installation and fast processing of performance data. To enable NPCD, set
"broker_module=/usr/lib/pnp4nagios/npcdmod.o config_file=/etc/pnp4nagios/npcd.cfg"
"broker_module=/usr/lib/pnp4nagios/npcdmod.o config_file=/etc/pnp4nagios/npcd.cfg"
-Finally reload your Nagios server by running "/etc/init.d/nagios3 reload". All
+Finally reload your Nagios server by running "service nagios3 reload". All
performance data should be processed now.
performance data should be processed now.
+Using bulk mode for Icinga
+---------------------------
+
+We recommend to use bulk mode with NPCD and npcdmod. This will facilitate an
+easy installation and fast processing of performance data. To enable NPCD, set
+'RUN' to 'yes' in /etc/default/npcd.
+
+In order to enable processing of performance data in Icinga, please change the
+"process_performance_data" statement in "/etc/icinga/icinga.cfg" to
+"process_performance_data=1".
+
+To register the NPC event broker module (npcdmod), copy the file
+"/usr/share/doc/pnp4nagios-web-config-icinga/examples/npcdmod.cfg" to
+"/etc/icinga/modules"
+
+Finally reload your Icinga server by running "service icinga reload". All
+performance data should be processed now.
+
+
+Add links for PNP4Nagios to Nagios / Icinga Webfrontend
+-------------------------------------------------------
+
If you want links to PNP4Nagios for your monitored hosts and services in the
Nagios web frontend just add
If you want links to PNP4Nagios for your monitored hosts and services in the
Nagios web frontend just add
------------------
Starting with version 0.6.12, PNP4Nagios may operate as a Gearman worker. This
------------------
Starting with version 0.6.12, PNP4Nagios may operate as a Gearman worker. This
-is useful in large, distributed setups using Nagios's mod_gearman. To enable
-the PNP Gearman worker, set 'RUN' to 'yes' in /etc/default/pnp_gearman_worker.
-Also, you'll need a running mod_gearman environment. See
+is useful in large, distributed setups using Nagios's mod_gearman. To use
+the PNP Gearman worker, you'll need a running mod_gearman environment. See
<http://labs.consol.de/lang/en/nagios/mod-gearman/> for detailed setup
instructions.
<http://labs.consol.de/lang/en/nagios/mod-gearman/> for detailed setup
instructions.
+In addition, the following configuration is required to get you started:
+
+- Enable processing of performance data in Nagios: set
+ 'process_performance_data=1' in "/etc/nagios3/nagios.cfg" or
+ "/etc/icinga/icinga.cfg" and reload your monitoring system:
+ "service nagios3 reload" / "service icinga reload".
+
+- Enable the PNP Gearman worker daemon by setting 'RUN' to 'yes' in
+ /etc/default/pnp_gearman_worker. Check the Gearman related options in
+ "/etc/pnp4nagios/process_perfdata.cfg" (GEARMAN_HOST and encryption
+ settings) and start the Gearman worker: /etc/init.d/pnp_gearman_worker start
+
+- Enable distribution of performance data in mod_gearman by setting the
+ 'perfdata=yes' option.
+
+When operating in Gearman mode, process_perfdata.pl requires the
+Gearman::Worker, MIME::Base64, and Crypt::Rijndael Perl modules. These are
+available in the libgearman-client-perl, perl, and libcrypt-rijndael-perl
+Debian packages (see packages suggested by pnp4nagios-bin).
+
-- Sebastian Harl <tokkee@debian.org> Wed, 27 Apr 2011 09:32:52 +0200
-- Sebastian Harl <tokkee@debian.org> Wed, 27 Apr 2011 09:32:52 +0200