README.Debian: Replaced c&p'ed Nagios with Icinga.

[pkg-pnp4nagios.git] / debian / README.Debian

diff --git a/debian/README.Debian b/debian/README.Debian
index bd8cbe73e9ac2c5de44975ed75b2c6147c99dfd4..1b6513441c149789bd79f0c6252ba8e38264b210 100644 (file)
--- a/debian/README.Debian
+++ b/debian/README.Debian
@@ -5,8 +5,8 @@ PNP4Nagios supports several modes of operation. They differ in the way how
 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


@@ -21,9 +21,31 @@ To register the NPC event broker module (npcdmod), add the following line
 
 "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
 


@@ -42,12 +64,25 @@ Using Gearman mode
 ------------------
 
 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/icingacfg" 
+  and reload your monitoring system: "service icinga/nagios 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
 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