- \n
- Install Packages<\/li>\n
- Install Nginx Webserver<\/li>\n
- Install and Configure PHP-FPM<\/li>\n
- Install and Configure MariaDB<\/li>\n
- Download and Configure LibreNMS<\/li>\n
- LibreNMS Web Installer<\/li>\n
- Final configuration<\/li>\n<\/ol>\n
Prerequisites<\/strong><\/p>\n
- \n
- Ubuntu 16.04 Server<\/li>\n
- Root Privileges<\/li>\n<\/ul>\n
Step 1 – Install Packages<\/h2>\n
The first step we must do for installing LibreNMS Monitoring Tools is to\u00a0install some packages needed on the server. Connect to your server and update the repository.<\/p>\n
ssh [email\u00a0protected]<\/a>
sudo apt update<\/p>\nInstall all the required packages for LibreNMS from the Ubuntu repository using the following command.<\/p>\n
apt install fping imagemagick whois mtr-tiny nmap python-mysqldb snmpd\u00a0 rrdtool git snmp graphviz<\/p>\n
After\u00a0the installation is complete, goto the next step.<\/p>\n
Step 2 – Install Nginx Webserver<\/h2>\n
In this tutorial, we will be running LibreNMS under the Nginx web server. Nginx is powerful web server\u00a0that’s\u00a0available in the Ubuntu repositories.<\/p>\n
Install nginx using apt command from the repository in the following way.<\/p>\n
apt install nginx<\/p>\n
When it’s done, start the service and enable it\u00a0to run automatically every time at system boot.<\/p>\n
systemctl start nginx
systemctl enable nginx<\/p>\nNginx web server is running under the default port 80. We can check the port using the netstat command, and check Nginx using curl command to get the HTTP status code, as shown below.<\/p>\n
netstat -plntu | grep 80
curl -I localhost<\/p>\n![\"Check](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts.png\" "\\"\\"")
<\/a><\/p>\nNginx installation has been completed.<\/p>\n
Step 3 – Install and Configure PHP-FPM<\/h2>\n
LibreNMS is PHP based web application monitoring tool. It offers support for new PHP version 7.0, and we will be using it for this guide.<\/p>\n
Install PHP, PHP-FPM, and all extensions\/modules needed for LibreNMS installation using the apt command below.<\/p>\n
apt install php7.0-cli php7.0-mysql php7.0-gd php7.0-snmp php-pear php7.0-curl php7.0-fpm php7.0-mcrypt php7.0-json php-net-ipv4 php-net-ipv6<\/p>\n
Next, we need to add some configuration to php.ini files. We need to define the default timezone in\u00a0php.ini file and make sure the timezone matches with the current\u00a0timezone used by the system.<\/p>\n
Check the currently timezone used by the system with the following command.<\/p>\n
timedatectl<\/p>\n
You should\u00a0get a result similar to the following.<\/p>\n
![\"Check](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-1.png\" "\\"\\"")
<\/a><\/p>\nYou can see\u00a0the server is using the ‘Europe\/Paris<\/strong>‘ timezone.<\/p>\n
Now go to the PHP configuration directory and edit php.ini files for\u00a0the\u00a0cli and fpm config.<\/p>\n
cd \/etc\/php\/7.0\/
vim fpm\/php.ini
vim cli\/php.ini<\/p>\nUncomment the ‘date.time<\/strong>‘ line and change the value with our system timezone ‘Europe\/Paris<\/strong>‘.<\/p>\n
date.time = Europe\/Paris<\/pre>\n
Uncomment cgi configuration below, change the value to 0.<\/p>\n
cgi.fix_pathinfo = 0<\/pre>\n
Save and exit.<\/p>\n
All configuration is complete. Now start the service and enable it to launch every time at system boot using the following systemctl commands.<\/p>\n
systemctl start php7.0-fpm
systemctl enable php7.0-fpm<\/p>\nPHP-FPM is now running on ubuntu server – it’s running under the sock file. Check it with the netstat command.<\/p>\n
netstat -pl | grep php<\/p>\n
![\"Check](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-2.png\" "\\"\\"")
<\/a><\/p>\nStep 4 – Install and Configure MariaDB<\/h2>\n
In this step, we will install the mariadb-server for the LibreNMS database. We will install, configure and create a new database and a new user for the LibreNMS installation.<\/p>\n
Install mariadb-server from ubuntu repository using the apt command below.<\/p>\n
apt install mariadb-server mariadb-client mariadb<\/p>\n
When it’s done, start the service, and enable\u00a0it to run automatically at system boot, something you can do\u00a0using the following systemctl commands.<\/p>\n
systemctl start mysql
systemctl enable mysql<\/p>\nThe database server mariadb is now running. Next we need to configure the root password for mariadb. We can use the ‘mysql_secure_installation’ command below to configure the root password.<\/p>\n
mysql_secure_installation<\/p>\n
You will be asked about the new root password – type your password and press ‘Enter’ to continue.<\/p>\n
Set root password? [Y\/n] Y
The root password for mariadb has been configured.<\/p>\n
Next, we must create a new database and user for LibreNMS. We will create a new database named ‘librenms’, a new user named ‘librenms’ with password ‘hakase-labs123’.<\/p>\n
Log in to the mariadb shell using the following command.<\/p>\n
mysql -u root -p
Type the ROOT Password:<\/p>\nRun mariadb queries below to create a new database and user, and grant all privileges on the database to the new user.<\/p>\n
CREATE DATABASE librenms CHARACTER SET utf8 COLLATE utf8_unicode_ci;
CREATE USER ‘librenms’@’localhost’ IDENTIFIED BY ‘hakase-labs123’;
GRANT ALL PRIVILEGES ON librenms.* TO ‘librenms’@’localhost’;
FLUSH PRIVILEGES;<\/p>\nA new database and user for LibreNMS has been created.<\/p>\n
![\"Add](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-3.png\" "\\"\\"")
<\/a><\/p>\nFor the LibreNMS installation, we need to add some configuration to the configuration file. Go to the ‘\/etc\/mysql\/’ directory and edit the mariadb configuration file.<\/p>\n
cd \/etc\/mysql\/
vim mariadb.conf.d\/50-server.cnf<\/p>\nPaste configuration below under the ‘[mysqld]<\/strong>‘ section.<\/p>\n
innodb_file_per_table=1
Save and exit.<\/p>\n
![\"Change](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-4.png\" "\\"\\"")
<\/a><\/p>\nNow apply the new configuration by restarting the service.<\/p>\n
systemctl restart mysql<\/p>\n
The mariadb database configuration has been completed.<\/p>\n
Step 5 – Download and Configure LibreNMS<\/h3>\n
In this step, we will configure the system for LibreNMS installation.<\/p>\n
– Add New User and Download LibreNMS<\/strong><\/p>\n
Create a new system user named ‘librenms’, define ‘\/opt\/librenms’ as the default home directory for the user, and assign the new ‘librenms’ user to the www-data group.<\/p>\n
Run the following command to do it all.<\/p>\n
useradd librenms -d \/opt\/librenms -M -r
usermod -a -G librenms www-data<\/p>\nNow go to the ‘\/opt\/’ directory and download the LibreNMS source code using the git command.<\/p>\n
cd \/opt\/
git clone https:\/\/github.com\/librenms\/librenms.git librenms<\/p>\n![\"Add](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-5.png\" "\\"\\"")
<\/a><\/p>\nNext, create a new directory for libreNMS log files and rrd files.<\/p>\n
mkdir -p \/opt\/librenms\/{logs,rrd}<\/p>\n
Change ownership permissions for the ‘rrd’ directory to ‘775’, and change the owner of the ‘librenms’ directory to the ‘librenms’ user and group.<\/p>\n
chmod -R 775 \/opt\/librenms\/rrd\/
chown -R librenms:librenms \/opt\/librenms\/<\/p>\n![\"Create](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-6.png\" "\\"\\"")
<\/a><\/p>\nA new ‘librenms’ has been created, and the LibreNMS source code has been downloaded.<\/p>\n
– Configure LibreNMS Virtualhost<\/strong><\/p>\n
Go to the ‘nginx’ configuration directory and create a new virtual host file ‘librenms’ with\u00a0vim<\/a><\/p>\n
cd \/etc\/nginx\/
vim sites-available\/librenms<\/p>\nPaste the following LibreNMS Virtual host configuration there.<\/p>\n
server {\u00a0\u00a0\u00a0 # Add your own domain name
\u00a0\u00a0\u00a0 # LibreNMS Webroot directory
\u00a0\u00a0\u00a0 # LibreNMS logs
\u00a0\u00a0\u00a0 # PHP-FPM handle all .php files requests
Save and exit. Now, activate the virtualhost.<\/p>\n
ln -s \/etc\/nginx\/sites-available\/librenms \/etc\/nginx\/sites-enabled\/<\/p>\n
Test the nginx configuration and make sure there is no error. Then restart the service.<\/p>\n
nginx -t
systemctl restart nginx<\/p>\n![\"Enable](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-7.png\" "\\"\\"")
<\/a><\/p>\n– Configure UFW Firewall<\/strong><\/p>\n
Add new ports to the firewall. Add new ssh, http, https and the port used by snmpd 161 udp type to the ufw firewall.<\/p>\n
Run the following ufw commands.<\/p>\n
ufw allow ssh
ufw allow http
ufw allow https
ufw allow 161\/udp<\/p>\n![\"Configure](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-8.png\" "\\"\\"")
<\/a><\/p>\nStart the ufw firewall with the ufw enable command as shown below.<\/p>\n
ufw enable<\/p>\n
Type ‘y’ and press ‘Enter’ to confirm. Start and enable it to launch every time at system boot.<\/p>\n
If you want to see the firewall status, run the ‘ufw status’ command.<\/p>\n
ufw status<\/p>\n
You will get the firewall status – active or inactive – and the list of ports and service added to the firewall.<\/p>\n
![\"List](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-9.png\" "\\"\\"")
<\/a><\/p>\nStep 6 – LibreNMS Web Installer<\/h2>\n
After\u00a0all the above steps are complete, we need to install LibreNMS through the web browser. Open your web browser, type the LibreNMS domain name ‘librenms.hakase-labs.co’ in\u00a0the address bar and press Enter.<\/p>\n
– Checking PHP Modules<\/strong><\/p>\n
You will be redirected to the install.php page showing the result of PHP module support checks. Make sure all status is green as shown below.<\/p>\n
![\"LibreNMS](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-10.png\" "\\"\\"")
<\/a><\/p>\nClick ‘Next Stage<\/strong>‘ to continue.<\/p>\n
– Database Configuration<\/strong><\/p>\n
Fill all the database info with your own db.<\/p>\n
- \n
- DB User: librenms<\/li>\n
- DB Pass: hakase-labs123<\/li>\n
- DB Name: librenms<\/li>\n<\/ul>\n
![\"Set](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-11.png\" "\\"\\"")
<\/a><\/p>\nAnd click ‘Next Stage<\/strong>‘.<\/p>\n
– Importing MySQL Database<\/strong><\/p>\n
Wait for the installer script to\u00a0import sample of database to our database – do not close the browser tab during this process.<\/p>\n
![\"Stage](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-12.png\" "\\"\\"")
<\/a><\/p>\nAfter\u00a0all db is imported, click ‘Goto Add User<\/strong>‘.<\/p>\n
– Add Admin User<\/strong><\/p>\n
Here, type your admin user, email, and password.<\/p>\n
![\"Add](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-13.png\" "\\"\\"")
<\/a><\/p>\nClick ‘Add User<\/strong>‘.<\/p>\n
– Generate LibreNMS Config<\/strong><\/p>\n
![\"Generate](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-14.png\" "\\"\\"")
<\/a><\/strong><\/p>\nClick the ‘Generate Config<\/strong>‘ button.<\/p>\n
And you will get a\u00a0config file similar to the one shown below.<\/p>\n
![\"Save](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-15.png\" "\\"\\"")
<\/a><\/p>\nCopy the php config script, and come back to your ssh session. Goto the ‘\/opt\/librenms’ directory and create the ‘config.php’ file manually using vim.<\/p>\n
cd \/etc\/librenms\/
vim config.php<\/p>\nPaste the configuration there, and change the ownership of the file to librenms user and group.<\/p>\n
chown librenms:librenms config.php<\/p>\n
![\"Chown](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-16.png\" "\\"\\"")
<\/a><\/p>\nBack to your web browser and click the ‘Finish Install<\/strong>‘ button.<\/p>\n
Now you get to the last page from the librenms web installer\u00a0– see below.<\/p>\n
![\"Installation](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-17.png\" "\\"\\"")
<\/a><\/p>\nStep 7 –\u00a0Final configuration<\/h2>\n
After the installation through web browser is complete, we need to do some\u00a0other steps.<\/p>\n
– Configure SNMP<\/strong><\/p>\n
Backup default configuration file and copy the sample configuration to the ‘\/etc\/snmp\/’ directory.<\/p>\n
mv \/etc\/snmp\/snmpd.conf \/etc\/snmp\/snmpd.conf.aseli
cp \/opt\/librenms\/snmpd.conf.example \/etc\/snmp\/snmpd.conf<\/p>\nEdit the new configuration with vim.<\/p>\n
vim \/etc\/snmp\/snmpd.conf<\/p>\n
Replace the ‘RANDOMSTRINGGOESHERE’ line with your own community name ‘hakaselabs’, as shown below.<\/p>\n
com2sec readonly\u00a0 default\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 hakaselabs<\/pre>\n
Save and exit.<\/p>\n
![\"SNMP](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-18.png\" "\\"\\"")
<\/a><\/p>\nNext, we need to download the distro detection script. Download it using curl, then make the script executable, then finally, restart the snmp service.<\/p>\n
curl -o \/usr\/bin\/distro https:\/\/raw.githubusercontent.com\/librenms\/librenms-agent\/master\/snmp\/distro
chmod +x \/usr\/bin\/distro
systemctl restart snmpd<\/p>\n![\"Restart](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-19.png\" "\\"\\"")
<\/a><\/p>\n– Crontab and Logrotate Configuration<\/strong><\/p>\n
Goto the librenms directory and copy sample configuration for Crontab and Logrotate.<\/p>\n
cd \/opt\/librenms\/<\/p>\n
Copy the configuration.<\/p>\n
cp librenms.nonroot.cron \/etc\/cron.d\/librenms
cp misc\/librenms.logrotate \/etc\/logrotate.d\/librenms<\/p>\nNow restart the cron service and reload the logrotate configuration.<\/p>\n
systemctl restart cron
logrotate -f \/etc\/logrotate.conf<\/p>\n
![\"Crontab](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-20.png\" "\\"\\"")
<\/a><\/p>\n![\"Validate](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2017\/12\/how-to-setup-librenms-monitoring-tool-with-nginx-on-ubuntu-16-04-lts-21.png\" "\\"\\"")
<\/a><\/p>\n