LibreNMS UNIX Agent

Last Updated: June 21, 2014

Outdated Please use https://docs.librenms.org/Extensions/Agent-Setup/

Install xinetd

apt-get install xinetd

Configure xinetd

cd /etc/xinetd.d/
wget http://fisheye.observium.org/browse/~raw,r=HEAD/Observium/scripts/observium_agent_xinetd

change the only_from line to your observium server IP

Download Unix agent scripts

cd /usr/bin
wget http://fisheye.observium.org/browse/~raw,r=HEAD/Observium/scripts/observium_agent
chmod +x observium_agent

Application Monitoring

mkdir /usr/lib/observium_agent
mkdir /usr/lib/observium_agent/local
cd /usr/lib/observium_agent/local

Nginx

wget http://fisheye.observium.org/browse/~raw,r=HEAD/Observium/scripts/agent-local/nginx
chmod +x nginx

Add this to your vhost

location /nginx-status {
    stub_status on;
    access_log   off;
    allow 127.0.0.1;
    deny all;
}

MySQL

wget http://fisheye.observium.org/browse/~raw,r=HEAD/Observium/scripts/agent-local/mysql
wget http://fisheye.observium.org/browse/~raw,r=HEAD/Observium/scripts/agent-local/mysql.cnf
chmod +x mysql

Add a user for observium polling

mysql -u root -p
Password: <enter password here>
mysql> GRANT SUPER, REPLICATION SLAVE, PROCESS ON *.* TO 'observium_mon'@'localhost'
    -> IDENTIFIED BY '<enter password here>';

Edit the mysql.cnf file. Change these values

$mysql_user = 'observium_mon';
$mysql_pass = '<enter password here';

Package Monitoring

wget http://fisheye.observium.org/browse/~raw,r=HEAD/Observium/scripts/agent-local/dpkg
chmod +x dpkg

BIND

wget http://fisheye.observium.org/browse/~raw,r=HEAD/Observium/scripts/agent-local/bind
chmod +x bind