Commit Graph

703 Commits

Author SHA1 Message Date
fablabo
12533aa9a6 Update Rancid.md (#12487)
* Update Rancid.md

The current installation manual suggests running php-fpm as user librenms.  adding user www-data to group rancid won't help in making the rancid config files available for librenms.

* Update Rancid.md

Co-authored-by: Jellyfrog <Jellyfrog@users.noreply.github.com>
2021-02-01 20:54:57 +01:00
dlehman83
9f591c0aa2 Update Documentation (#12411)
* Update Documentation

Most work in Graylog and SNMP
Fixed many code tags, spelling and wording.
Added SNMP PowerShell example.

* Update SNMP-Configuration-Examples.md

Fix TOC brackets
2020-12-30 15:38:14 +01:00
djamp42
9ccb707335 Update Distributed-Poller.md Discovery using dispatcher service (#12387)
* Update Distributed-Poller.md

Clarify discovery when using dispatcher service. The limitation of running one discovery per server is only for cron based polling.

* Update Distributed-Poller.md

Co-authored-by: Neil Lathwood <gh+n@laf.io>
2020-12-17 21:17:59 +00:00
Hans Erasmus
d23ed0dd6e Update to incorporate new locking mechanisms (#12388) 2020-12-12 18:02:11 +01:00
Alex Muthmann
980e4a6a28 Update docs for raspberry.sh (#12389)
When using the original docs for the raspberry.sh script all I got in the SNMP output was `nsExtendOutLine."raspberry".1 = sudo: No such file or directory`

this can be fixed by using the complete path to the sudo command.
2020-12-10 01:02:30 +01:00
CrazyMax
a0062aa633 Remove hardcoded URLs to doc (#12364)
Co-authored-by: CrazyMax <crazy-max@users.noreply.github.com>
2020-11-27 23:34:58 +01:00
MarlinMr
a95f098ee8 More secure example configuration (#12317) 2020-11-17 00:52:15 +01:00
Tony Murray
f4ea49e38e Update Distributed-Poller.md 2020-11-12 07:40:02 -06:00
Hans Erasmus
904667def8 Update distributed poller documentation (#12312)
Because of https://github.com/librenms/librenms/pull/11896 I thought it would be a good idea to update the docs as well.
2020-11-11 23:05:02 +01:00
CameronMunroe
59accd7e42 Improve Services documentation (#12226)
* Update Services.md

I updated the services page for a few of the following reasons:

* Fix placement of certain info that was better placed elsewhere.
* Adjust the documentation to inculde how to install during setup step.
* Fixed a few lines for a better feel to the wording.

* Update Services.md

Dispatcher Service notice.

* Update Services.md

dispatcher -> dispatch
2020-10-20 19:12:30 -05:00
Heath Barnhart
e56f17e86b Added instructions for rsyslog version 8 (#12224)
* Update Syslog.md

Added instructions for rsyslog version 8

* Update Syslog.md

Not familiar with the markup, but looking at the source file for the page Jellyfrog linked it looks correct for tabs. Does the Git preview not render them?

* Update Syslog.md

Co-authored-by: Jellyfrog <Jellyfrog@users.noreply.github.com>
2020-10-20 15:09:38 +02:00
Tim de Boer
aa9f6d2cbe Update IRC-Bot.md (#12216)
Fixed the IRC-Bot Extensions link.
2020-10-15 10:33:20 -05:00
Jellyfrog
782db09bd4 Add docs for Supermicro Superdoctor (#12200) 2020-10-08 12:55:06 +02:00
Tony Murray
1e4702fa4f Support multiple daily process locking backends with distributed polling (#11896)
* Implement locks in the file cache

* Replace custom locks

* implement restore lock
Used when re-hydrating

* remove legacy use statements

* Add class descriptions

* Fix style

* Default to database cache driver

* missed cache_locks table
prevent chicken-egg issue

* style fixes

* Remove custom file lock implementation

* missed items from file cache

* Update schema definition
hmm, other schema noise must be from manual modification as this is generated from a freshly migrated db.

* require predis, it is pure python, so no harm in adding

* and set predis as the default client
2020-10-07 07:36:35 -05:00
Avinash Kumar
ff4dcd5678 icecast doc correction (#12183) 2020-10-03 18:26:41 +02:00
Adam Bishop
41ed0537b4 Fix midnight poller data loss (#11582)
* Handle more signals

* Flush buffers before exiting process
This ensures log messages aren't lost

* Restart process before jobs have finished
If there is a very log running job it can cause service restart to
take over 5 minutes.

We tweak the order of things to make sure that running processes
continue, but nothing more is scheduled.

The worst case impact is that a pollling/discovery job gets
scheduled twice, but this should not be a big issue - this should
only occur at most once per day.

* Remove python 3.8 feature

* Ensure that processes from the previous invocation are reaped

* Correct typo's

* Attach subprocess descriptors to /dev/null

Occasionally, PHP would throw a fit and crash when its stdout went
away. To avoid this, we attach stdout to devnull.

This means we lost output of daily.sh - but this is already recorded
in $LOGDIR/daily.log

* Don't immediately schedule long running jobs

To avoid the situation where the maintenance reload happens or a sighup,
then a second long running job is immediately started, we wait
(`last_[poll/discovery]_timetaken` * 1.25) seconds before scheduling
any jobs.

* Add `psutil` to requirements

* Add support for "systemctl reload" to the unit files

* Add a fallback for systems that don't have psutil

* Reduce CPU load when psutil is not installed

* Don't avoid double polling by extending the timeout

This shouldn't happen due to locks

* Remove fallback option

* Remove extra variable

* Fix issue introduced during rebase

* Fix issue introduced when fixing issue introduced during rebase

* Make psutil optional
2020-09-29 23:50:40 -05:00
SourceDoctor
f3f67e834f Update Application Docs for Unbound (#12151) 2020-09-23 23:18:06 +02:00
PipoCanaja
0e0e80c827 More eventlogs for snmptraps (#12112)
* Allow detailed trap display and inform user about snmptrapd misconfiguration

* Documentation update

* Documentation update

* Documentation update

* CodeClimate

* CodeClimate

* ChangeRequest PR

* Fix tests

* config_definitions

translation

doc

* styleci

* lnms translation generate after npm-install
2020-09-23 17:00:02 +02:00
Hans Erasmus
9559b09f5e Update Oxidized docs (#12116) 2020-09-21 23:07:23 +02:00
Avinash Kumar
78fa539628 Icecast, Opensips and Voip monitor Application (#12070)
* Icecast added

* Opensips added

* Voip Monitor added

* Icecast documentation

Icecast corrections

* Opensips documentation added

Opensips corrections

* Voip monitor documentation added

Voip monitor corrections

* Icecast corrections

* Opensips corrections

* Voip monitor corrections

* test data added for icecast

* test data added for opensips
2020-09-18 16:49:20 +02:00
Adam Bishop
bbdb1a2a5d Rewrite smokeping script to be an lnms command (#11585)
* Rewrite smokeping script to be an lnms command

* Add a default number of probes for smokeping

* Formatting fixes

* Refactor to simplify a couple of methods

* Fix a name collision when using more than 60 threads

* Simplify

* First pass at documentation

A few climate fixes too.

I'm a little dubious about the + LibreNMS fix - it could be included
in /etc/smokeping/config if it is really needed, but it sounds like
(looking at git blame) it's needed for if the script generates a broken
configuration file.

I'm thinking we should just not generate broken config.

* Improve testability and add some tests

* Load laravel to make translations available

* Second pass at documentation

* Fix brace

* Extend the device factory to include the type

Also adds a device group fake I created before I realised I didn't need it

* Mimic gen_smokeping.php a little more closely

* Update tests to properly verify old and new behaviour against each other

* Replace gen_smokeping with a wrapper

* Don't double whitespace

Render does this automatically.
Explicitly order by hostname too.

* Make faker less likely to generate duplicates

I tried adding a unique constraint here, but it didn't have the
intended effect.

Extending the hostname like this seems to work fine - I tried
generating 10 million hosts and got no duplicates, compared to
duplicates appearing with as few as 100 hosts without this
 change.

A true fix would be to add an 'fqdn' fake upstream.

* Make the tests more robust

* Assorted bug fixes

* Style corrections

* Handle 'generic' devices

* Fix an issue that came up during rebase

Co-authored-by: Tony Murray <murraytony@gmail.com>
2020-09-18 00:04:54 -05:00
SourceDoctor
dbd2b06b80 MySQL Documentation Update (#12085) 2020-09-11 13:09:29 +02:00
Nathan Lam
7f0b483580 rrdcache OPTS > BASE_OPTIONS (#12074)
Not sure if it's `OPTS` in older versions of `rrdcached`, but it's 100% `BASE_OPTIONS` for 1.7.0. `OPTS` was broken for me for a while.
2020-09-09 10:21:31 +02:00
TheGreatDoc
6495a9284b Update Smokeping.md (#12048) 2020-09-02 15:21:40 +02:00
Hans Erasmus
94fae616a4 Update Fast Ping Check docs (#12024) 2020-08-25 08:14:44 -05:00
Hans Erasmus
ca9dee9df2 Update Applications Docs for Apache Agent (#12009)
* Update Applications.md

Updated docs to resemble updated apache snmp extend script which is now compatible with python3.

* Updated document as requested

* Updated to reflect newest library deps 

Changed the agent code to use newer libraries as suggested by SourceDoctor. Docs now reflects the same change.

* Fixed typo

* Small update to trigger stuck tests
2020-08-18 20:37:04 +02:00
Hans Erasmus
22026eb11e Fixed header anchors (#12002)
Fixed header anchors not working. Fixed according to suggestions made [here](https://gist.github.com/asabaylus/3071099)
2020-08-06 18:10:56 +02:00
Hans Erasmus
fe79029494 Update RRDCached.md (#11967)
Tested the steps for CentOS 7 on CentOS8 today, worked for me?
2020-07-28 23:09:55 +02:00
Tony Murray
020c5fd7e1 Remove legacy code and fix missing device graphs (#11950)
* removing $graphs global

* remove unused things

* fix some additional graphs

* Fix graphs persisting too soon

* correct name for poller module performance graph

* only one type of graph is used here
2020-07-23 09:57:22 -05:00
Anael Mobilia
0b5a9106d8 Update Smokeping.md (#11956)
* Update Smokeping.md

Add smokeping URL path on the config example

* fix quote
2020-07-22 16:01:14 +02:00
Tony Murray
5f0388f0e3 Remove DB credentials from config.php
Better validation when config.php does not exist

Update docs and quote password

only populate legacy vars in config_to_json
drop .travis.yml config copy
remove credentials from config.php.default

Check for existance of .env instead of config.php in python scripts

legacy credential cleanup

tiny cleanups

consistent env for artisan server and artisan dusk
2020-06-27 07:47:08 -05:00
ZoLuSs
fc55830c7a Fix Application Sudo Example (#11707)
* Update Proxmox Process

On latest version of Debian (9.1 and later) snmpd run ad Debian-snmp user.
In visudo change snmp to Debian-snmp

* fix typo

Co-authored-by: SourceDoctor <sourcehhdoctor@gmail.com>
2020-06-22 12:34:25 +02:00
Tony Murray
867aa132c1 Merge pull request #11661 from SourceDoctor/app_dhcp_enhancement
Application DHCP Upgrade
2020-06-16 17:03:45 -05:00
Slashdoom
53f378a900 Update Services.md (#11834)
Add CHECK_MRPE section for https://github.com/librenms/librenms-agent/pull/192
2020-06-16 21:56:04 +02:00
Anael Mobilia
22916afb9e Apps - backupninja (#11010)
* GUI - graphs

* GUI - Apps

* Polling

* GUI - apps

* Add backupninja to documentation

* Apps - backupninja : add link to librenmsagent script

* Add backupninja snmprec file

* Delete backupninja.snmprec

No Regression tests on apps (yet), only on devices.

* Remove old debug

* Update language : FR -> EN

* Add debug informations

* File path moved to /etc/snmp/

* Python script now use json

* Update following example on puppet script

* Update installation instructions following puppet example

* Update apps.inc.php

Co-authored-by: PipoCanaja <38363551+PipoCanaja@users.noreply.github.com>
Co-authored-by: SourceDoctor <sourcehhdoctor@gmail.com>
2020-06-16 01:04:30 +02:00
Tony Murray
8c19cfeadd Merge pull request #11516 from SourceDoctor/rrdcached_doc_update
Update RRDCached Documentation
2020-06-15 13:26:36 -05:00
Tony Murray
9bf91f7153 Merge pull request #11741 from SourceDoctor/agent_sudo_fix
Application sudo correction
2020-06-14 16:39:03 -05:00
SourceDoctor
1093315700 Merge branch 'master' into app_dhcp_enhancement 2020-06-08 20:51:41 +02:00
Tony Murray
2a5b1fd071 Clearer python-memcached info (#11772) 2020-06-04 20:36:25 -05:00
SourceDoctor
adf7e54204 Application sudo correction 2020-05-30 19:19:13 +02:00
Tony Murray
90e95f160d fix bullets (#11732) 2020-05-30 06:36:17 +02:00
Hans Erasmus
b2d6540ff2 Update rrdtool setting explanation (#11724)
After some users said it was not clear.
2020-05-28 11:13:02 +02:00
Tony Murray
b767c61836 Update distributed poller docs intro (#11721)
Add info about config sharing
2020-05-28 08:43:10 +02:00
gardar
14193253fe Add support for windows librenms(check_mk) agent (#11691)
* Allow agent to run against windows os

* Display processes from windows check_mk agent

* Replace tabs with spaces

* Fix indent

* Add documentation for windows agent
2020-05-26 16:04:38 +02:00
Unknown
acd090da81 Corrected wrong path in documentation (#11675) 2020-05-24 13:51:52 -05:00
SourceDoctor
cbe572f959 Application DHCP Upgrade 2020-05-22 23:02:19 +02:00
craig-nokia
bffa46f34a Update the options for distributed_poller (#11655)
Added $config[] and enabled the remi repository for redis.
2020-05-22 01:16:56 +02:00
jonasblomq
caf1cd3707 Update Fast-Ping-Check.md (#11645)
Added stopping and starting RRDCached during the change of the rrd files step.
This will prevent data loss and corruption of the rrd files.
2020-05-20 08:09:23 -05:00
SourceDoctor
f5d537ff18 equalize socket location 2020-05-18 22:50:26 +02:00
SourceDoctor
2d31e9583a remove Debian Jessi howto 2020-05-18 22:42:42 +02:00