Monitoring Lab Setup

---

Below are the requirements for running LibreNMS on Ubuntu 18.04:

• Database Server – We will use MariaDB
• PHP 7.2
• Web Server – We will use Nginx

Install LEMP stack (MariaDB, Nginx, and PHP)

Installation of MariaDB

Add MariaDB repository on to the ubuntu system

sudo apt-get install software-properties-common

Run the command below to add Repository Key to the system

sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xF1656F24C74CD1D8

Once the PGP key is imported, proceed to add repository URL to your Ubuntu 18.04 server:

sudo add-apt-repository 'deb [arch=amd64] http://mirror.zol.co.zw/mariadb/repo/10.3/ubuntu bionic main'

then Install MariaDB

Error: Failed to load processor bash

No macro or processor named 'bash' found

You will be prompted to provide MariaDB root password. Enter Class password and Press <Ok> and confirm the new password to install MariaDB.

Confirm MariaDB version and successful connectivity by mysql –u root -p

Next, LibreNMS is not fully compatible with MySQL strict mode, for now, please disable this after mysql is installed.

sudo vim /etc/mysql/mariadb.cnf

Within the [mysqld] section please add:

innodb_file_per_table=1
sql-mode=""
lower_case_table_names=0

Then restart mysql sudo systemctl restart mysql

Now you need to create a database for LibreNMS.

mysql –u root –p

Error: Failed to load processor mysql

No macro or processor named 'mysql' found

Installation of PHP

Ubuntu 18.04 has PHP 7.2 in its repositories. Install it by running the commands below on your terminal

sudo apt-get -y install wget php php-pear php-cgi php-common curl php-curl \
php-mbstring php-gd php-mysql php-gettext php-bcmath \
php-imap php-json php-xml php-snmp php-fpm php-zip

To confirm the php version installed, use the command php –v

it should give you a similar output as below

PHP 7.2.8 (cli) (built: Jul 17 2018 09:50:46) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies

Ensure date.timezone is set in php.ini to your preferred time zone:

Edit both files:

sudo vim /etc/php/7.2/fpm/php.ini and sudo vim /etc/php/7.2/cli/php.ini

Change date.timezone under [Date] section:

[Date]
; Defines the default timezone used by the date functions
; http://php.net/date.timezone
date.timezone = Asia/Colombo

Restart php fpm:

sudo systemctl restart php7.2-fpm.service

Installation of NGINX

For this setup, we will use Nginx as a web server for LibreNMS, install it by running:

sudo service apache2 stop
sudo apt-get install nginx

Make sure apache webserver is not installed nor running

Installation of LIbreNMS

We will download and install LibreNMS in this step. If you don’t have git, first install it:

sudo apt-get install git

LibreNMS will run under its own user called librenms which we need to add:

sudo useradd -r -M -d /opt/librenms librenms
getent passwd librenms

it will giva an output like,

librenms:x:997:996::/opt/librenms:/bin/sh

Add this user to web user group www-data

sudo usermod -a -G librenms www-data

When done. proceed to install packages required by LibreNMS

sudo apt-get update
sudo apt install rrdtool whois fping imagemagick graphviz  mtr-tiny \
nmap python-mysqldb snmp snmpd python-memcache mtr-tiny acl

Clone LibreNMS source code from github:

git clone https://github.com/librenms/librenms.git librenms

output:

Cloning into 'librenms'...
remote: Counting objects: 130428, done.
remote: Compressing objects: 100% (27/27), done.
remote: Total 130428 (delta 10), reused 10 (delta 4), pack-reused 130396
Receiving objects: 100% (130428/130428), 128.54 MiB | 19.52 MiB/s, done.
Resolving deltas: 100% (88754/88754), done.
Checking out files: 100% (8476/8476), done.

Next, move the folder librenms to /opt

sudo cp -R librenms /opt/

Change permission of the directory:

sudo chown -R librenms:librenms /opt/librenms/
sudo chmod -R 775 /opt/librenms/

Configure snmpd

sudo cp /opt/librenms/snmpd.conf.example /etc/snmp/snmpd.conf
sudo vim /etc/snmp/snmpd.conf

Edit the text which says RANDOMSTRINGGOESHERE and set your own community string.

curl -o distro https://raw.githubusercontent.com/librenms/librenms-agent/master/snmp/distro
chmod +x distro
sudo mv distro  /usr/bin/distro

Restart snmpd

sudo systemctl restart snmpd

Create LibreNMS Cron job and run the command below to set cron job:

sudo cp /opt/librenms/librenms.nonroot.cron /etc/cron.d/librenms

LibreNMS keeps logs in /opt/librenms/logs. Over time these can become large and be rotated out. To rotate out the old logs you can use the provided logrotate config file:

sudo cp /opt/librenms/misc/librenms.logrotate /etc/logrotate.d/librenms

Finally, fix all permissions

sudo chown -R librenms:librenms /opt/librenms
sudo setfacl -d -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/
sudo setfacl -R -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/

Configure Nginx:

Let’s create the VirtualHost definition for Nginx to be used by LibreNMS. sudo vim /etc/nginx/conf.d/librenms.conf

server {
 listen      80;
 server_name librenms.instXY.ac.lk;
 root        /opt/librenms/html;
 index       index.php;

 charset utf-8;
 gzip on;
 gzip_types text/css application/javascript text/javascript application/x-javascript image/svg+xml text/plain text/xsd text/xsl text/xml image/x-icon;
 location / {
  try_files $uri $uri/ /index.php?$query_string;
 }
 location /api/v0 {
  try_files $uri $uri/ /api_v0.php?$query_string;
 }
 location ~ \.php {
  include fastcgi.conf;
  fastcgi_split_path_info ^(.+\.php)(/.+)$;
  fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
 }
 location ~ /\.ht {
  deny all;
 }
}

Check syntax:

sudo nginx –t

output:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

if all is okay, restart nginx:

sudo systemctl restart nginx

Run composer install:

cd /opt/librenms
sudo ./scripts/composer_wrapper.php install --no-dev

Now open your web browser and start the installer:

​http://librenms.instXY.ac.lk/install.php

Next,LibreNMS WebUI configurations