From 9effac039f001b25042fc4f1915bbc760d72bfe7 Mon Sep 17 00:00:00 2001 From: Tyler Christiansen Date: Sun, 3 Nov 2013 19:07:33 -0800 Subject: [PATCH] update install instructions for poller-wrapper --- doc/INSTALL.md | 8 +++++++- doc/INSTALL_RHEL.md | 11 +++++++++++ 2 files changed, 18 insertions(+), 1 deletion(-) diff --git a/doc/INSTALL.md b/doc/INSTALL.md index edca1b67c..d998e551d 100644 --- a/doc/INSTALL.md +++ b/doc/INSTALL.md @@ -103,9 +103,15 @@ Discover localhost and poll it for the first time: php discovery.php -h all && php poller.php -h all +The polling method used by LibreNMS is `poller-wrapper.py`, which was placed in the public domain by its author. By default, the LibreNMS cronjob runs `poller-wrapper.py` with 16 threads. The current LibreNMS recommendation is to use 4 threads per core. The default if no thread count is `16 threads`. + +If the thread count needs to be changed, you can do so by editing `librenms.cron` before copying (or by editing `/etc/cron.d/librenms` if you've already copied the cron file). Just add a number after `poller-wrapper.py`, as in the below example: + + /opt/librenms/poller-wrapper.py 12 >> /dev/null 2>&1 + Create the cronjob - cp librenms.cron /etc/cron.d/librenms + ln -s librenms.cron /etc/cron.d/librenms ### Daily Updates ### diff --git a/doc/INSTALL_RHEL.md b/doc/INSTALL_RHEL.md index 83fdcd147..2564d823a 100644 --- a/doc/INSTALL_RHEL.md +++ b/doc/INSTALL_RHEL.md @@ -117,6 +117,17 @@ Discover localhost and poll it for the first time: php discovery.php -h all && php poller.php -h all +The polling method used by LibreNMS is `poller-wrapper.py`, which was placed in +the public domain by its author. By default, the LibreNMS cronjob runs `poller- +wrapper.py` with 16 threads. The current LibreNMS recommendation is to use 4 th +reads per core. The default if no thread count is `16 threads`. + +If the thread count needs to be changed, you can do so by editing `librenms.cron +` before copying (or by editing `/etc/cron.d/librenms` if you've already copied the cron file). Just add a number after `poller-wrapper.py`, as in the below ex +ample: + + /opt/librenms/poller-wrapper.py 12 >> /dev/null 2>&1 + Create the cronjob cp librenms.cron /etc/cron.d/librenms