Instal LibreNMS Di Ubuntu 22.04

Catatan:
Instruksi ini mengasumsikan Anda adalah pengguna root.
Jika tidak, tambahkan sudo sebelum perintah shell (yang bukan pada prompt mysql>), atau sementara menjadi pengguna dengan hak akses root menggunakan sudo -s atau sudo -i.

Perhatikan bahwa versi PHP minimum yang didukung adalah 8.2.

Instalasi Paket yang Dibutuhkan

Untuk Ubuntu 22.04, jalankan perintah berikut untuk menginstal paket yang dibutuhkan:

apt install software-properties-common
LC_ALL=C.UTF-8 add-apt-repository ppa:ondrej/php
apt update
apt install acl curl fping git graphviz imagemagick mariadb-client mariadb-server mtr-tiny nginx-full nmap php-cli php-curl php-fpm php-gd php-gmp php-json php-mbstring php-mysql php-snmp php-xml php-zip rrdtool snmp snmpd unzip python3-pymysql python3-dotenv python3-redis python3-setuptools python3-psutil python3-systemd python3-pip whois traceroute

Tambahkan User LibreNMS

Buat pengguna baru untuk LibreNMS:

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

Unduh LibreNMS

Unduh LibreNMS dari GitHub:

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

Atur Hak Akses

Atur kepemilikan dan izin direktori:

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/

Instal Dependensi PHP

Instal dependensi PHP dengan menjalankan perintah berikut sebagai pengguna librenms:

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

Jika terjadi masalah akses internet melalui proxy, Anda bisa menginstal Composer secara manual:

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

Atur Zona Waktu

Pastikan Anda mengatur date.timezone di file php.ini sesuai dengan zona waktu yang diinginkan. Contoh valid: “Asia/Jakarta”, “Etc/UTC”.

Edit file php.ini:

vi /etc/php/8.3/fpm/php.ini
vi /etc/php/8.3/cli/php.ini

Setel juga zona waktu sistem:

timedatectl set-timezone Etc/UTC

Konfigurasi MariaDB

Edit file konfigurasi MariaDB:

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

Tambahkan baris berikut pada bagian [mysqld]:

innodb_file_per_table=1
lower_case_table_names=0

Kemudian restart MariaDB:

systemctl enable mariadb
systemctl restart mariadb

Masuk ke klien MariaDB:

mysql -u root

Buat database dan pengguna untuk LibreNMS:

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

Konfigurasi PHP-FPM

Salin file konfigurasi PHP-FPM dan ubah pengaturan:

cp /etc/php/8.3/fpm/pool.d/www.conf /etc/php/8.3/fpm/pool.d/librenms.conf
vi /etc/php/8.3/fpm/pool.d/librenms.conf

Ubah [www] menjadi [librenms], dan setel user serta group ke librenms:

user = librenms
group = librenms

Ubah jalur listen agar sesuai dengan konfigurasi NGINX:

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

Hapus file www.conf jika tidak digunakan lagi, lalu restart PHP-FPM:

rm /etc/php/8.3/fpm/pool.d/www.conf
systemctl restart php8.3-fpm

Konfigurasi NGINX

Buat file konfigurasi NGINX untuk LibreNMS:

vi /etc/nginx/conf.d/librenms.conf

Tambahkan konfigurasi berikut:

server {
listen 80;
server_name librenms.example.com;
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 ~ [^/].php(/|$) {
fastcgi_pass unix:/run/php-fpm-librenms.sock;
fastcgi_split_path_info ^(.+.php)(/.+)$;
include fastcgi.conf;
}
location ~ /.(?!well-known).* {
deny all;
}
}

Hapus file default NGINX dan restart:

rm /etc/nginx/sites-enabled/default
systemctl restart nginx

Konfigurasi SNMP

Salin dan edit file konfigurasi SNMP:

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

Ganti RANDOMSTRINGGOESHERE dengan community string Anda.

Aktifkan dan restart SNMP:

systemctl enable snmpd
systemctl restart snmpd

Cron Job

Salin file cron untuk LibreNMS:

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

Web Installer

Akses http://librenms.example.com/install di browser Anda dan ikuti instruksi di layar.

Jika diminta membuat file config.php, salin isi yang ditampilkan dan atur izin file:

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

Langkah Akhir

Anda sekarang bisa login ke LibreNMS melalui URL yang sudah diatur.

Semoga tutorial ini bermanfaat!