diff --git a/doc/Extensions/Agent-Setup.md b/doc/Extensions/Agent-Setup.md index cf8a2508b1..a990661d02 100644 --- a/doc/Extensions/Agent-Setup.md +++ b/doc/Extensions/Agent-Setup.md @@ -3,6 +3,8 @@ Agent setup To gather data from remote systems you can use LibreNMS in combination with check_mk (included in the scripts directory). +The agent uses TCP-Port 6556, please allow access from the LibreNMS-Host and Poller-Nodes if you're using the Distributed Polling setup. + On each of the hosts you would like to use the agent on then you need to do the following: * Copy the `check_mk_agent` script into `/usr/bin` and make it executable. @@ -57,7 +59,7 @@ options { ``` Restart your bind9/named after changing the configuration. -Verify that everything works by executing `rdnc stats && cat /etc/bind/named.stats`. +Verify that everything works by executing `rndc stats && cat /etc/bind/named.stats`. In case you get a `Permission Denied` error, make sure you chown'ed correctly. Note: if you change the path you will need to change the path in `scripts/agent-local/bind`. @@ -89,3 +91,30 @@ And that your tinydns-instance is located in `/service/dns`, adjust this path if 3. Restart TinyDNS and Daemontools: `/etc/init.d/svscan restart` _Note_: Some say `svc -t /service/dns` is enough, on my install (Gentoo) it doesnt rehook the logging and I'm forced to restart it entirely. +### MySQL + +Unlike most other scripts, the MySQL script requires a configuration file `/usr/lib/check_mk_agent/local/mysql.cnf` with following content: + +```php +