Code

README.Debian, control: Added some notes about Gearman mode.
[pkg-pnp4nagios.git] / debian / README.Debian
1 PNP4Nagios for Debian
2 ---------------------
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>.
8 Using bulk mode
9 ---------------
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.
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".
19 To register the NPC event broker module (npcdmod), add the following line
20 (without quotes) to "/etc/nagios3/nagios.cfg":
22 "broker_module=/usr/lib/pnp4nagios/npcdmod.o config_file=/etc/pnp4nagios/npcd.cfg"
24 Finally reload your Nagios server by running "/etc/init.d/nagios3 reload". All
25 performance data should be processed now.
27 If you want links to PNP4Nagios for your monitored hosts and services in the
28 Nagios web frontend just add
30 - "action_url  /pnp4nagios/graph?host=$HOSTNAME$"
31   to your hosts or host template(s)
33 - "action_url  /pnp4nagios/graph?host=$HOSTNAME$&srv=$SERVICEDESC$"
34   to your services or service template(s)
36 For more information and different modes of operation, see
37 <http://docs.pnp4nagios.org/pnp-0.6/config>.
39  -- Sven Velt <sven@velt.de>  Wed, 30 Sep 2009 13:55:35 +0000
41 Using Gearman mode
42 ------------------
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 enable
46 the PNP Gearman worker, set 'RUN' to 'yes' in /etc/default/pnp_gearman_worker.
47 Also, you'll need a running mod_gearman environment. See
48 <http://labs.consol.de/lang/en/nagios/mod-gearman/> for detailed setup
49 instructions.
51  -- Sebastian Harl <tokkee@debian.org>  Wed, 27 Apr 2011 09:32:52 +0200