How to install LibreNMS on Ubuntu 20.04(sinhala)

අද මම මේ article  එකෙන් කතා කරන්න යන්නේ open-source network monitoring tool එකක් වන LibreNms ගැන. මෙතැනදී මම විස්තර කරන්නේ LibreNms කියන්නේ මොකක්ද කියන එක සහ එක install කරන්නේ කොහොමද කියන එක.

What is libreNMS?

LibreNms කියන්නනේ cacti, Nagios වගේම network monitoring tool එකක්. එක GPLv3 යටතේ release කෙරෙන free and open-source tool එකක්. මේක ඇත්තටම user-friendly විදිහට හදල තියනවා. එක හින්දම LibreNms එක ඕනිම කෙනෙක්ට තෙරුන්ගන්න සහ  use කරන්න ලේසියි.

LibreNms වැඩ කරන විදිහ සහ support එක ගැන සරලව කතාකරොත්, එකෙන් SNMP, LLDP, OSPF, ARP, CDP, BGP සහ FDP වගේ protocols use කරලා network එක auto-discover කරගන්නවා. ඒවගේම LibreNms use කරලා ගොඩක් network hardware (Cisco, Juniper, Foundry, FreeBSD, Brocade වගේ ) සහ  Windows, Linux, FreeBSD වගේ operating systems වුනත් monitoring  කරන්න පුළුවන්. තව LibreNms

මේ LibreNms Features විදිහට customizable alerts, API access සහ mobile app (Android and iOS) වගේ තව ගොඩක් දේවල් තියනවා.

Install libreNMS

හරි දැන් අපි බලමු LibreNms Install කරන විදිහ ගැන.

මුලින්ම මම මෙතන Root user ට log වෙනවා නැත්තනම් හැමවෙලේම sudo කියල type කරන්න වෙන නිසා. ඊළගට System update කරන් ඉමු.

su
apt update
apt upgrade

ඊළගට අපි Required Packages install කරමු. මෙතැනදී apache,mariadb-server හා python වගේ LibreNms වලට ඕනි කරන Packages install වෙනවා. ඒ හින්ද අපිට apache සහ mariadb වෙනම install කරන්න ඕනි වෙන්නේ නෑ.

apt install software-properties-common 
add-apt-repository universe
apt update  
apt install acl curl apache2 composer fping git graphviz imagemagick libapache2-mod-fcgid mariadb-client mariadb-server mtr-tiny nmap php7.4-cli php7.4-curl php7.4-fpm php7.4-gd php7.4-json php7.4-mbstring php7.4-mysql php7.4-snmp php7.4-xml php7.4-zip rrdtool snmp snmpd whois python3-pymysql python3-dotenv python3-redis python3-setuptools

By default, MariaDB වල root user ට  password එකක් එන්නේ නෑ. දැන් අපි Password එකක් දාල අනිත් basic config ටික කරමු.

mysql_secure_installation

මෙහෙම type කරලා Enter කරපු ගමන් පහල තියෙනවා වගේ list එකක් එයි, එක ඔයාට කැමති විදිහට Y  or  N යොදල වෙනස්කරගන්න පුළුවන්.

මෙතැනදී මම හැම එකටම Yes (Y) දෙනවා.

1. 1. root user ට හොද password එකක් දාන්න.

1. anonymous users ල remove කරන්න.
2. remotely root log එක Disallow කරන්න.
3. test database ටික remove කරන්න.
4. privilege tables ටික reload කරන්න.

Set root password? [Y/n] y
New password: 
Re-enter new password: 
Password updated successfully!
Reloading privilege tables..
 ... Success!

Remove anonymous users? [Y/n] y
 ... Success!

Disallow root login remotely? [Y/n] y
 ... Success!

Remove test database and access to it? [Y/n] y
 - Dropping test database...
 ... Success!
 - Removing privileges on test database...
 ... Success!

Reload privilege tables now? [Y/n] y
 ... Success!

Cleaning up...

All done!  If you've completed all of the above steps, your MariaDB
installation should now be secure.

Thanks for using MariaDB!

හරි ඊළගට අපි librenms user ව add කරමු.

useradd librenms -d /opt/librenms -M -r -s "$(which bash)"

දැන් /opt location එකට ගිහින් LibreNMS Download කරගන්න ඕනි.

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

ඊළගට librenms user ට /opt/librenms directory එකේ permissions දෙන්න ඕනි.

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

ඊළගට අපි librenms user ට log වෙලා PHP dependencies Install කරන්න ඕනි

su - librenms
./scripts/composer_wrapper.php install --no-dev
exit

proxy එකක්  used කරනවනම් ඉස්සල්ල කිව්වා විදිහ වැඩකරන්නේ නැති වෙන්න පුළුවන්. ඒ වෙලාවට composer package ටික  manually instrall කරන්න ඕනි.

wget https://getcomposer.org/composer-stable.phar
mv composer-stable.phar /usr/bin/composer
chmod +x /usr/bin/composer

ඊළගට timezone හදන්න ඕනි.එකට මුලින්ම මේ link එකට (https://php.net/manual/en/timezones.php) ගිහින් හරියන timezone එක බලන්න.(eg -: “America/New_York”, “Australia/Brisbane”, “Etc/UTC” ). දැන් එක පහල php.ini file එකේ date.timezone කියන තැනට ඉස්සරහින් දාන්න. timezone එක හරියට යොදන එක ගොඩක් වැදගත් මොකද system alerts වගේ දේවල් වලට time එක හරියට තියෙන්න ඕනි නිසා.

nano /etc/php/7.4/fpm/php.ini
nano /etc/php/7.4/cli/php.ini

මෙතැනදී මම use කරන්නේ nano editor එක නිසා Ctrl + w ඔබල search කරන්න පුළුවන්.(මෙතන උදාහරණයක් විදිහට Etc/UTC timezone එක දානවා.)

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

අවගේම system timezone එකත් හරියට යොදන්න ඕනි.

timedatectl set-timezone Etc/UTC

දැන් MariaDB එක Configure කරගන්න සහ database එක හදන්න ඕනි.

MariaDB එක Configure කරන්න 50-server.cnf file එකට log වෙන්න.

nano /etc/mysql/mariadb.conf.d/50-server.cnf

මෙතන [mysqld] section එකට පහල ටික add කරන්න.

innodb_file_per_table=1
lower_case_table_names=0

මේතැනදී bind-address කියන තැන Database එකේ address එක තියෙන්නේ “127.0.0.1 ” කියල. ඒ මෙතැනදී මේ vps එකේම DB එක තියෙන නිසා. වෙනම DB server එකක් use කරනවනම් එතනට server ip address එක add කරන්න.

# this is only for the mysqld standalone daemon
[mysqld]

#
# * Basic Settings
#
innodb_file_per_table=1
lower_case_table_names=0

# localhost which is more compatible and is not less secure.
bind-address = 127.0.0.1

DB එක restart කරන්න.

systemctl enable mariadb
systemctl restart mariadb

ඊළගට DB එකට root use ට කලින් දුන්න passwd එක දීල log වෙන්න.

mysql -u root

දැන්  DB එක create කරන්න ඕනි මෙතැනදී මම  password එක ”password”  විදිහට දානවා ලේසියට.හැබැයි මේක use කරද්දී හොද password එකක් දන්න.

CREATE DATABASE librenms CHARACTER SET utf8 COLLATE utf8_unicode_ci;
CREATE USER 'librenms'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON librenms.* TO 'librenms'@'localhost';
FLUSH PRIVILEGES;
exit

ඊළගට PHP-FPM(FastCGI Process Manager) එක Configure කරන්නඕනි.

මෙතැනදී මුලින්ම librenms.conf file එක හදන්න ඕනි.

cp /etc/php/7.4/fpm/pool.d/www.conf /etc/php/7.4/fpm/pool.d/librenms.conf
nano /etc/php/7.4/fpm/pool.d/librenms.conf

මෙතැනදී අපි පහල තියෙන වෙනස්කම් ටික  කරන්න ඕනි.

[www] වෙනුවට එතනට  [librenms]කියල Add කරන්න.

[librenms]

user සහ  group කියන දෙකට “librenms”: කියල add කරන්න.

user = librenms 
group = librenms

listen කියන තැනට පහල තියෙන එක add කරන්න.

listen = /run/php-fpm-librenms.sock

; pool name ('www' here)
[librenms]

; Unix user/group of processes
; Note: The user is mandatory. If the group is not set, the default user's group
;       will be used.
user = librenms
group = librenms

; Note: This value is mandatory.
listen = /run/php-fpm-librenms.sock

ඊළගට අපි Web Server එක Configure කරන්න ඕනි. මම මුලින් install කරේ Apache Web Server එක නිසා මම එකේ config කරනවා.

මුලින්ම librenms.conf file එක හදන් ඉන්න ඕනි.

nano /etc/apache2/sites-available/librenms.conf

දැන් ඒ file එක config කරමු. මේකේ ServerName එකට අවශ්‍යනම් server එකේ නම දන්නා පුළුවන්.

<VirtualHost *:80> 
   DocumentRoot /opt/librenms/html/ 
   ServerName librenms.example.com

   AllowEncodedSlashes NoDecode
   <Directory "/opt/librenms/html/">
     Require all granted 
     AllowOverride All
     Options FollowSymLinks MultiViews
   </Directory>

  # Enable http authorization headers
  <IfModule setenvif_module>
    SetEnvIfNoCase ^Authorization$ "(.+)" HTTP_AUTHORIZATION=$1
  </IfModule>

  <FilesMatch ".+\.php$">
    SetHandler "proxy:unix:/run/php-fpm-librenms.sock|fcgi://localhost"
  </FilesMatch>
</VirtualHost>

ඊළගට default site එක disable කරලා librenms site එක enable කරන්න. ඊටපස්සේ Apache Web Server එක restart කරන්න.

a2dissite 000-default
a2enmod proxy_fcgi setenvif rewrite
a2ensite librenms.conf
systemctl restart apache2
systemctl restart php7.4-fpm

ඊළගට lnms command completion එක Enableකරමු.

මේකෙන් සාමාන්‍ය linux command type කරද්දී tab එබුවම completion වෙනවා වගේ lnms command type කරාමත් completion කරන්න පුළුවන් වෙනවා.

ln -s /opt/librenms/lnms /usr/bin/lnms
cp /opt/librenms/misc/lnms-completion.bash /etc/bash_completion.d/

ඊළගට snmpd Configure  කරමු.මේකෙන් මේ install කරන vps එකේ snmp enable කරන්න පුළුවන්.

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

nano /etc/snmp/snmpd.conf

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

curl -o /usr/bin/distro https://raw.githubusercontent.com/librenms/librenms-agent/master/snmp/distro
chmod +x /usr/bin/distro
systemctl enable snmpd
systemctl restart snmpd

ඊළගට Cron job එකහදමු.

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

දැන් Web installer එක run කරන්න server එකේ IP එක හෝ domain name එකට යන්න.

මෙතැනදී අපිට බලාගන්න පුළුවන් අපි අවශ්‍ය කරන හැමෙකක්ම හරියට install කරලද කියල.

මෙතන කලින් අපි librenms user ට දුන්න password එක දෙන්න ඕනි.

මෙතන Build Database කියල දුන්නම මේ විදිහට එක build වෙනවා.

මෙතැනදී අපි admin user කෙනෙක්ව දාගන්න ඕනි.(password එක හොද එකක් දන්නා මතක තියාගන්න.)

මෙතන vaildate your install කියන එක click කරන්න.

admin user name සහ password ගහල log වෙන්න

දැන් තියෙන්නේ ඔනිකරන device add කරගන්න එක.

ඊළගට config.php file එකට permissions දෙන්න ඕනි.

chown librenms:librenms /opt/librenms/config.php

මොකක්හරි අවුලක් තියේද බලන්න Troubleshooting කරන්න ඕනිවොනොත්.

sudo su - librenms
./validate.php

Congratulations! දැන් අපි LibreNMS එක ubuntu 20.04 වලට install කරලා ඉවරයි. මම හිතනවා මේ ලිපිය ප්‍රයෝජනවත් වෙයි කියල.මේගැන අදහස් යෝජනා චෝදනා හෝ අඩුපාඩුවක් තියේනම් commect  එකක් දන්නා. එහෙනම් තවත් ලිපියකින් හමුවෙමු.