LibreNMS Agent Installation

DerMeldos

1: Clone the librenms-agent repository:

cd /opt/
git clone https://github.com/librenms/librenms-agent.git
cd librenms-agent

2: Copy the relevant check_mk_agent to /usr/bin:

Linux:

cp check_mk_agent /usr/bin/check_mk_agent

freebsd

cp check_mk_agent_freebsd /usr/bin/check_mk_agent

3: Copy the service file(s) into place.

cp check_mk@.service check_mk.socket /etc/systemd/system

4: Create the relevant directories.

mkdir -p /usr/lib/check_mk_agent/plugins /usr/lib/check_mk_agent/local

5: Copy each of the scripts from agent-local/ into /usr/lib/check_mk_agent/local that you require to be graphed. You can find detail setup instructions for specific applications above.

6: Make each one executable that you want to use with

chmod +x /usr/lib/check_mk_agent/local/$script

7: Enable the check_mk service

systemctl enable check_mk.socket && systemctl start check_mk.socket

8: Login to the LibreNMS web interface and edit the device you want to monitor. Under the modules section, ensure that unix-agent is enabled.

9: Then under Applications, enable the apps that you plan to monitor.

10: Wait for around 10 minutes and you should start seeing data in your graphs under Apps for the device.