[Pkg-nagios-changes] [SCM] Debian packaging for mod gearman. branch, upstream, updated. upstream/1.0.6-34-gd3fb2ec
Sven Nierlein
sven at nierlein.de
Wed Aug 24 09:22:04 UTC 2011
The following commit has been merged in the upstream branch:
commit d3fb2ecf0efc03577869f7ae86614a1b1fd744e3
Author: Sven Nierlein <sven at nierlein.de>
Date: Tue Aug 16 09:49:44 2011 +0200
updated docs
diff --git a/README.asciidoc b/README.asciidoc
index 05ebf99..73ea8b1 100644
--- a/README.asciidoc
+++ b/README.asciidoc
@@ -5,17 +5,18 @@ What is Mod-Gearman
-------------------
http://labs.consol.de/nagios/mod-gearman[Mod_Gearman] is an easy way
-of distributing active Nagios checks across your network and to increase
-nagios scalability. Mod-Gearman can even help to reduce the load on a
-single nagios host, because its much smaller and more efficient in
-executing checks. It consists of three parts:
+of distributing active Nagios checks across your network and
+increasing nagios scalability. Mod-Gearman can even help to reduce the
+load on a single nagios host, because its much smaller and more
+efficient in executing checks. It consists of three parts:
-* There is a NEB module which resides in the Nagios core and adds servicechecks, hostchecks
-and eventhandler to a Gearman queue.
+* There is a NEB module which resides in the Nagios core and adds servicechecks,
+ hostchecks and eventhandler to a Gearman queue.
* The counterpart is one or more worker clients executing the checks.
-Worker can be configured to only run checks for specific host- or
-servicegroups.
-* You need at least one http://gearman.org[Gearman Job Server] running
+ Worker can be configured to only run checks for specific host- or
+ servicegroups.
+* And you need at least one http://gearman.org[Gearman Job Server]
+ running.
http://labs.consol.de/wp-content/uploads/2010/09/Mod-Gearman.pdf[Have a look at the slides from the Nagios Workshop 2011 in Hannover]
@@ -24,8 +25,7 @@ http://labs.consol.de/wp-content/uploads/2010/09/Mod-Gearman.pdf[Have a look at
Download
--------
-* Latest stable release http://labs.consol.de/wp-content/uploads/2010/09/mod_gearman-1.0.8.tar.gz[version
- 1.0.8] from on July 22 2011
+* Latest stable release http://labs.consol.de/wp-content/uploads/2010/09/mod_gearman-1.0.9.tar.gz[version 1.0.9] from August 16 2011
* Mod Gearman is available for download at: http://labs.consol.de/nagios/mod-gearman
* Source is available at GitHub: http://github.com/sni/mod_gearman
* Older versions are available in the <<_archive,download archive>>.
@@ -35,12 +35,13 @@ Download
Support & Questions
-------------------
-* Mod-Gearman has been succesfully tested with Nagios 3.2.3 and Icinga
- 1.2.0 running on Lib-Gearman 0.14. There are no known bugs at the moment.
+* Mod-Gearman has been succesfully tested with Nagios >3.2.3 and Icinga
+ >1.2.0 running on Lib-Gearman >0.14. There are no known bugs at the moment.
Let me know if you find one.
* https://groups.google.com/group/mod_gearman[google groups mailinglist]
* http://labs.consol.de/lang/de/forum/#/categories/mod-gearman[support forum]
* Debian users may be interested in the http://labs.consol.de/nagios/mod-gearman/mod-gearman-quickstart-guide/[quickstart guide].
+* Debian users may also be interested in the official packages: http://packages.debian.org/source/wheezy/mod-gearman
How does it work
@@ -249,15 +250,20 @@ it can be started with
/usr/sbin/gearmand -t 10 -j 0
--------------------------------------
-or a supplied init script (extras/gearmand-init).
+or a supplied init script (extras/gearmand-init). Command line
+arguments have change in recent gearman versions and you now should
+use something like:
+--------------------------------------
+/usr/sbin/gearmand --threads=10 --job-retries=0
+--------------------------------------
Patch Nagios
^^^^^^^^^^^^
-NOTE: The needed patch is already included since Nagios 3.2.2. Use the patch if you
-use an older version.
+NOTE: The needed patch is already applied to Nagios 3.2.2. Use the patch if you
+have an older version.
It is not possible to distribute eventhandler with Nagios versions
prior 3.2.2. Just apply the patch from the ./extras/patches directory
@@ -600,6 +606,19 @@ results for a reporting installation or remote gui.
dupserver=logserver:4730,logserver2:4730
====
+workaround_rc_25::
+Duplicate jobs from gearmand result sometimes in exit code 25 of
+plugins because they are executed twice and get killed because of
+using the same ressource. Sending results (when exit code is 25 )
+will be skipped with this enabled.
+Only needed if you experience problems with plugins exiting with exit
+code 25 randomly. Default is off.
++
+====
+ workaround_rc_25=off
+====
+
+
Queue Names
@@ -809,6 +828,7 @@ Hints
Archive
-------
+* http://labs.consol.de/wp-content/uploads/2010/09/mod_gearman-1.0.9.tar.gz[version 1.0.9 - August 16 2011]
* http://labs.consol.de/wp-content/uploads/2010/09/mod_gearman-1.0.8.tar.gz[version 1.0.8 - July 22 2011]
* http://labs.consol.de/wp-content/uploads/2010/09/mod_gearman-1.0.7.tar.gz[version 1.0.7 - July 03 2011]
* http://labs.consol.de/wp-content/uploads/2010/09/mod_gearman-1.0.6.tar.gz[version 1.0.6 - June 04 2011]
diff --git a/docs/QUICKSTART b/docs/QUICKSTART
index b8ef05e..b473ff8 100644
--- a/docs/QUICKSTART
+++ b/docs/QUICKSTART
@@ -52,9 +52,9 @@ Half way done, the next step installs Mod-Gearman.
--------------------------------------
#> cd /tmp
-#> wget "http://labs.consol.de/wp-content/uploads/2010/09/mod_gearman-1.0.8.tar.gz"
-#> tar zxf mod_gearman-1.0.8.tar.gz
-#> cd mod_gearman-1.0.8
+#> wget "http://labs.consol.de/wp-content/uploads/2010/09/mod_gearman-1.0.9.tar.gz"
+#> tar zxf mod_gearman-1.0.9.tar.gz
+#> cd mod_gearman-1.0.9
#> ./configure --prefix=/opt --with-gearman=/opt --with-user=nagios --with-init-dir=/etc/init.d
#> make
#> make install
@@ -118,7 +118,7 @@ Your nagios.log should contain a line:
--------------------------------------
#> grep mod_gearman /var/log/nagios3/nagios.log
-[1295003042] mod_gearman: Version 1.0.8
+[1295003042] mod_gearman: Version 1.0.9
[1295003042] Event broker module '/opt/lib/mod_gearman/mod_gearman.o' initialized successfully.
--------------------------------------
@@ -152,7 +152,7 @@ Then we have a look at the shiped check plugin:
--------------------------------------
#> /opt/bin/check_gearman -H localhost -q worker_`hostname` -t 10 -s check
-check_gearman OK - debian64 has 1 worker and is working on 0 jobs. Version: 1.0.8|worker=1 jobs=2c
+check_gearman OK - debian64 has 1 worker and is working on 0 jobs. Version: 1.0.9|worker=1 jobs=2c
--------------------------------------
The interesting number is the last one, '2c' in our case, which means there
diff --git a/docs/QUICKSTART.html b/docs/QUICKSTART.html
index 354bc63..2f74f47 100644
--- a/docs/QUICKSTART.html
+++ b/docs/QUICKSTART.html
@@ -606,9 +606,9 @@ install Gearman from source.</p></div>
<div class="listingblock">
<div class="content">
<pre><tt>#> cd /tmp
-#> wget "http://labs.consol.de/wp-content/uploads/2010/09/mod_gearman-1.0.8.tar.gz"
-#> tar zxf mod_gearman-1.0.8.tar.gz
-#> cd mod_gearman-1.0.8
+#> wget "http://labs.consol.de/wp-content/uploads/2010/09/mod_gearman-1.0.9.tar.gz"
+#> tar zxf mod_gearman-1.0.9.tar.gz
+#> cd mod_gearman-1.0.9
#> ./configure --prefix=/opt --with-gearman=/opt --with-user=nagios --with-init-dir=/etc/init.d
#> make
#> make install
@@ -666,7 +666,7 @@ Restarting nagios3 monitoring daemon: nagios3</tt></pre>
<div class="listingblock">
<div class="content">
<pre><tt>#> grep mod_gearman /var/log/nagios3/nagios.log
-[1295003042] mod_gearman: Version 1.0.8
+[1295003042] mod_gearman: Version 1.0.9
[1295003042] Event broker module '/opt/lib/mod_gearman/mod_gearman.o' initialized successfully.</tt></pre>
</div></div>
</div>
@@ -693,7 +693,7 @@ worker_debian64 | 1 | 0 | 0
<div class="listingblock">
<div class="content">
<pre><tt>#> /opt/bin/check_gearman -H localhost -q worker_`hostname` -t 10 -s check
-check_gearman OK - debian64 has 1 worker and is working on 0 jobs. Version: 1.0.8|worker=1 jobs=2c</tt></pre>
+check_gearman OK - debian64 has 1 worker and is working on 0 jobs. Version: 1.0.9|worker=1 jobs=2c</tt></pre>
</div></div>
<div class="paragraph"><p>The interesting number is the last one, <em>2c</em> in our case, which means there
have been already 2 jobs executed by this worker.</p></div>
@@ -733,7 +733,7 @@ Mod-Gearman Worker: /opt/var/mod_gearman/mod_gearman_worker.log
<div id="footnotes"><hr /></div>
<div id="footer">
<div id="footer-text">
-Last updated 2011-07-09 11:51:30 CEST
+Last updated 2011-08-16 09:50:33 CEST
</div>
</div>
</body>
diff --git a/docs/README.html b/docs/README.html
index ed35946..3788792 100644
--- a/docs/README.html
+++ b/docs/README.html
@@ -561,27 +561,28 @@ footnotes: function () {
<h2 id="_what_is_mod_gearman">What is Mod-Gearman</h2>
<div class="sectionbody">
<div class="paragraph"><p><a href="http://labs.consol.de/nagios/mod-gearman">Mod_Gearman</a> is an easy way
-of distributing active Nagios checks across your network and to increase
-nagios scalability. Mod-Gearman can even help to reduce the load on a
-single nagios host, because its much smaller and more efficient in
-executing checks. It consists of three parts:</p></div>
+of distributing active Nagios checks across your network and
+increasing nagios scalability. Mod-Gearman can even help to reduce the
+load on a single nagios host, because its much smaller and more
+efficient in executing checks. It consists of three parts:</p></div>
<div class="ulist"><ul>
<li>
<p>
-There is a NEB module which resides in the Nagios core and adds servicechecks, hostchecks
-and eventhandler to a Gearman queue.
+There is a NEB module which resides in the Nagios core and adds servicechecks,
+ hostchecks and eventhandler to a Gearman queue.
</p>
</li>
<li>
<p>
The counterpart is one or more worker clients executing the checks.
-Worker can be configured to only run checks for specific host- or
-servicegroups.
+ Worker can be configured to only run checks for specific host- or
+ servicegroups.
</p>
</li>
<li>
<p>
-You need at least one <a href="http://gearman.org">Gearman Job Server</a> running
+And you need at least one <a href="http://gearman.org">Gearman Job Server</a>
+ running.
</p>
</li>
</ul></div>
@@ -592,8 +593,7 @@ You need at least one <a href="http://gearman.org">Gearman Job Server</a> runnin
<div class="ulist"><ul>
<li>
<p>
-Latest stable release <a href="http://labs.consol.de/wp-content/uploads/2010/09/mod_gearman-1.0.8.tar.gz">version
- 1.0.8</a> from on July 22 2011
+Latest stable release <a href="http://labs.consol.de/wp-content/uploads/2010/09/mod_gearman-1.0.9.tar.gz">version 1.0.9</a> from August 16 2011
</p>
</li>
<li>
@@ -618,8 +618,8 @@ Older versions are available in the <a href="#_archive">download archive</a>.
<div class="ulist"><ul>
<li>
<p>
-Mod-Gearman has been succesfully tested with Nagios 3.2.3 and Icinga
- 1.2.0 running on Lib-Gearman 0.14. There are no known bugs at the moment.
+Mod-Gearman has been succesfully tested with Nagios >3.2.3 and Icinga
+ >1.2.0 running on Lib-Gearman >0.14. There are no known bugs at the moment.
Let me know if you find one.
</p>
</li>
@@ -638,6 +638,11 @@ Mod-Gearman has been succesfully tested with Nagios 3.2.3 and Icinga
Debian users may be interested in the <a href="http://labs.consol.de/nagios/mod-gearman/mod-gearman-quickstart-guide/">quickstart guide</a>.
</p>
</li>
+<li>
+<p>
+Debian users may also be interested in the official packages: <a href="http://packages.debian.org/source/wheezy/mod-gearman">http://packages.debian.org/source/wheezy/mod-gearman</a>
+</p>
+</li>
</ul></div>
</div>
<h2 id="_how_does_it_work">How does it work</h2>
@@ -839,15 +844,21 @@ it can be started with</td>
<div class="content">
<pre><tt>/usr/sbin/gearmand -t 10 -j 0</tt></pre>
</div></div>
-<div class="paragraph"><p>or a supplied init script (extras/gearmand-init).</p></div>
+<div class="paragraph"><p>or a supplied init script (extras/gearmand-init). Command line
+arguments have change in recent gearman versions and you now should
+use something like:</p></div>
+<div class="listingblock">
+<div class="content">
+<pre><tt>/usr/sbin/gearmand --threads=10 --job-retries=0</tt></pre>
+</div></div>
<h4 id="_patch_nagios">Patch Nagios</h4>
<div class="admonitionblock">
<table><tr>
<td class="icon">
<div class="title">Note</div>
</td>
-<td class="content">The needed patch is already included since Nagios 3.2.2. Use the patch if you
-use an older version.</td>
+<td class="content">The needed patch is already applied to Nagios 3.2.2. Use the patch if you
+have an older version.</td>
</tr></table>
</div>
<div class="paragraph"><p>It is not possible to distribute eventhandler with Nagios versions
@@ -1401,8 +1412,9 @@ fork_on_exec
</dt>
<dd>
<p>
-Use this option to disable an extra fork for each plugin execution. This option
-will reduce the load on the worker host. Default: yes
+Use this option to disable an extra fork for each plugin execution.
+Disabling this option will reduce the load on the worker host, but may
+cause trouble with unclean plugins. Default: yes
</p>
<div class="exampleblock">
<div class="exampleblock-content">
@@ -1429,6 +1441,26 @@ results for a reporting installation or remote gui.
</div></div>
</div></div>
</dd>
+<dt class="hdlist1">
+workaround_rc_25
+</dt>
+<dd>
+<p>
+Duplicate jobs from gearmand result sometimes in exit code 25 of
+plugins because they are executed twice and get killed because of
+using the same ressource. Sending results (when exit code is 25 )
+will be skipped with this enabled.
+Only needed if you experience problems with plugins exiting with exit
+code 25 randomly. Default is off.
+</p>
+<div class="exampleblock">
+<div class="exampleblock-content">
+<div class="literalblock">
+<div class="content">
+<pre><tt>workaround_rc_25=off</tt></pre>
+</div></div>
+</div></div>
+</dd>
</dl></div>
</div>
<h2 id="_queue_names">Queue Names</h2>
@@ -1688,6 +1720,11 @@ Make sure all your worker have the nagios-plugins available under
<div class="ulist"><ul>
<li>
<p>
+<a href="http://labs.consol.de/wp-content/uploads/2010/09/mod_gearman-1.0.9.tar.gz">version 1.0.9 - August 16 2011</a>
+</p>
+</li>
+<li>
+<p>
<a href="http://labs.consol.de/wp-content/uploads/2010/09/mod_gearman-1.0.8.tar.gz">version 1.0.8 - July 22 2011</a>
</p>
</li>
@@ -1767,7 +1804,7 @@ Make sure all your worker have the nagios-plugins available under
<div id="footnotes"><hr /></div>
<div id="footer">
<div id="footer-text">
-Last updated 2011-07-22 22:45:23 CEST
+Last updated 2011-08-16 09:46:51 CEST
</div>
</div>
</body>
--
Debian packaging for mod gearman.
More information about the Pkg-nagios-changes
mailing list