From fb38de86c91b198a3f37e73f0e1041bd048f04b8 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 013b86939..5a57ff52d 100644 --- a/doc/INSTALL.md +++ b/doc/INSTALL.md @@ -103,7 +103,13 @@ 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 diff --git a/doc/INSTALL_RHEL.md b/doc/INSTALL_RHEL.md index 635354146..7fd3e34e0 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