Short Notes on LibreNMS !

This post contains short notes & step by step guide on *NMS* –  An open source network monitoring system called LIBRENMS , it is based on MRTG Php/MySQL/Snmp.

---

STEP BY STEP iNSTALLATION FOR LIBRENMS

OS: Ubuntu 16 (Server Edition/64bit)

First install required support packages

apt-get update
# Now install all the required components in a single GO ...
apt install -y apache2 composer fping git graphviz imagemagick libapache2-mod-php7.0 mariadb-client mariadb-server mtr-tiny nmap php7.0-cli php7.0-curl php7.0-gd php7.0-json php7.0-mcrypt php7.0-mysql php7.0-snmp php7.0-xml php7.0-zip python-memcache python-mysqldb rrdtool snmp snmpd whois curl acl
[select your php version and install it accordingly)
apt-get install php-mbstring
sudo apt-get install php7.0-mbstring
sudo apt-get install php7.1-mbstring
sudo apt-get install php7.2-mbstring

Add local user for librenms
useradd librenms -d /opt/librenms -M -r
usermod -a -G librenms www-data
systemctl restart mysql

Create user & DB
mysql -uroot -pzaib1234
CREATE DATABASE librenms CHARACTER SET utf8 COLLATE utf8_unicode_ci;
CREATE USER 'librenms'@'localhost' IDENTIFIED BY 'zaib1234';
GRANT ALL PRIVILEGES ON librenms.* TO 'librenms'@'localhost';
FLUSH PRIVILEGES;
exit

Now edit maria-db config file
nano /etc/mysql/mariadb.conf.d/50-server.cnf

& add following
[Within the [mysqld] section please add]
innodb_file_per_table=1
sql-mode=""
lower_case_table_names=0
& restart mysql

systemctl restart mysql

Save & Exit.
Web Server Config
Edit PHP files & setup TIMEZONEs
nano /etc/php/7.0/apache2/php.ini
nano /etc/php/7.0/cli/php.ini

Search for ‘date.timezone‘ & change it to
date.timezone = Asia/Karachi

Save & EXit.
Configure Apache
nano /etc/apache2/sites-available/librenms.conf
Add the following config,

DocumentRoot /opt/librenms/html/
ServerName  librenms.campusN.ws.nsrc.org
CustomLog /opt/librenms/logs/access_log combined
ErrorLog /opt/librenms/logs/error_log
AllowEncodedSlashes NoDecode

Require all granted
AllowOverride All
Options FollowSymLinks MultiViews


Save & Exit
a2dissite 000-default
a2ensite librenms.conf
a2enmod rewrite
systemctl restart apache2
Edit SNMPD Config file to enable SNMP on localhost
Now edit SNMPD config file and add our SNMP community string like public or other
nano /etc/snmp/snmpd.conf
Edit the text which says rocommunity public and set your own community string.

save and exit.
curl -o /usr/bin/distro https://raw.githubusercontent.com/librenms/librenms-agent/master/snmp/distro
chmod +x /usr/bin/distro
systemctl restart snmpd
Install LIBRE-NMS via composer command
cd /opt
composer create-project --no-dev --keep-vcs librenms/librenms librenms dev-master

Example:

CRONJOBS for librenms
cp /opt/librenms/librenms.nonroot.cron /etc/cron.d/librenms
cp /opt/librenms/misc/librenms.logrotate /etc/logrotate.d/librenms
chown -R librenms:librenms /opt/librenms
setfacl -d -m g::rwx /opt/librenms/rrd /opt/librenms/logs
setfacl -R -m g::rwx /opt/librenms/rrd /opt/librenms/logs
Start Configuration of LIBRENMS
cd /opt/librenms

cp config.php.default config.php

sudo chown -R librenms:librenms /opt/librenms

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

sudo chmod -R ug=rwX /opt/librenms/bootstrap/cache /opt/librenms/storage /opt/librenms/logs /opt/librenms/rrd


Now access libre-nms via browser …
http://yourip/install.php

& follow onscreen steps…

Make sure to add id password which is authorized to change DB , as required …
and click on FINISH on GUI.
Adding config.php
At one point, IF REQUIRED You may have to create the config.php manually as showed here.
nano /opt/librenms/config.php
& paste the data as showed in the config window.
<!--?php

## Have a look in includes/defaults.inc.php for examples of settings you can set here. DO NOT EDIT defaults.inc.php!

### Database config
$config['db_host'] = 'localhost';
$config['db_user'] = 'librenms';
$config['db_pass'] = 'zaib1234';
$config['db_name'] = 'librenms';

// This is the user LibreNMS will run as
//Please ensure this user is created and has the correct permissions to your install
$config['user'] = 'librenms';

### This should *only* be set if you want to *force* a particular hostname/port
### It will prevent the web interface being usable form any other hostname
$config['base_url'] = "/";

### Enable this to use rrdcached. Be sure rrd_dir is within the rrdcached dir
### and that your web server has permission to talk to rrdcached.
#$config['rrdcached'] = "unix:/var/run/rrdcached.sock";

### Default community
$config['snmp']['community'] = array('public');

### Authentication Model
$config['auth_mechanism'] = "mysql"; # default, other options: ldap, http-auth
#$config['http_auth_guest'] = "guest"; # remember to configure this user if you use http-auth

### List of RFC1918 networks to allow scanning-based discovery
#$config['nets'][] = "10.0.0.0/8";
#$config['nets'][] = "172.16.0.0/12";
#$config['nets'][] = "192.168.0.0/16";

# Uncomment the next line to disable daily updates
#$config['update'] = 0;

# Number in days of how long to keep old rrd files. 0 disables this feature
$config['rrd_purge'] = 0;

# Uncomment to submit callback stats via proxy
#$config['callback_proxy'] = "hostname:port";

# Set default port association mode for new devices (default: ifIndex)
#$config['default_port_association_mode'] = 'ifIndex';

# Enable the in-built billing extension
$config['enable_billing'] = 1;

# Enable the in-built services support (Nagios plugins)
$config['show_services'] = 1;
Save & Exit.
Add User if required
php adduser.php admin2  admin2 10 aacable@yourmail.com


Make sure to remove COMPOSER & set permissions when all is OK. Else it will give error in VALIDATION part.
chown -R librenms:librenms /opt/librenms
apt-get remove composer

Some more snaps

Add Device



Devices Overview




Tips:
if you get error on daily.sh
root@graphs:/opt/librenms# ./daily.sh

Re-running /opt/librenms/daily.sh as librenms user

Updating to latest codebase FAIL

warning: unable to access ‘/root/.config/git/attributes’: Permission denied
The issue below cmds to resolve
cd /opt/librenms/
chown -R librenms:librenms /opt/librenms
setfacl -d -m g::rwx /opt/librenms/rrd /opt/librenms/logs
setfacl -R -m g::rwx /opt/librenms/rrd /opt/librenms/logs
./scripts/github-remove -d
apt install python3-pip
pip3 install -r /opt/librenms/requirements.txt
git checkout master
sudo chown -R librenms:librenms /opt/librenms
./daily.sh