librenms/doc/Agent.md
2014-11-28 01:30:59 +01:00

1.1 KiB

Agent setup

To gather data from remote systems you can use LibreNMS in combination with check_mk (included in the scripts directory).

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.
cp scripts/check_mk_agent /usr/bin/check_mk_agent
chmod +x /usr/bin/check_mk_agent
  • Copy the xinetd config file into place.
cp scripts/check_mk_xinetd /etc/xinetd.d/check_mk
  • Create the relevant directories.
mkdir -p /usr/lib/check_mk_agent/plugins /usr/lib/check_mk_agent/local
  • Copy each of the scripts from scripts/agent-local/ into /usr/lib/check_mk_agent/local
  • And restart xinetd.
/etc/init.d/xinetd restart
  • Login to the LibreNMS web interface and edit the device you want to monitor. Under the modules section, ensure that unix-agent is enabled.
  • Then under Applications, enable the apps that you plan to monitor.
  • Wait, in around 10 minutes you should start seeing data in your graphs under Apps for the device.