Monitorujte svoje zariadenia pomocou LibreNMS na Ubuntu 16.04

Predpoklady

Nainštalujte Nginx a PHP

Nainštalujte MariaDB

Nainštalujte LibreNMS

Konfigurácie SSL a Nginx VHost

Inštalácia pomocou WebUI

LibreNMS je plne vybavený systém na monitorovanie siete s otvoreným zdrojom. Používa sa SNMP na získavanie údajov z rôznych zariadení. V LibreNMS sú podporované rôzne zariadenia, ako napríklad Cisco, Linux, FreeBSD, Juniper, Brocade, Foundry, HP a mnohé ďalšie. Podporuje viacero autentifikačných mechanizmov a podporuje dvojfaktorovú autentifikáciu. Má prispôsobiteľný systém upozornení, ktorý môže upozorniť správcu siete prostredníctvom e-mailu, IRC alebo slack.

Predpoklady

• Inštancia servera Vultr Ubuntu 16.04.
• Sudo používateľ .

V tomto návode použijeme nms.example.com názov domény smerujúci k inštancii Vultr. Uistite sa, že ste nahradili všetky výskyty vzorového názvu domény skutočným.

Aktualizujte svoj základný systém pomocou príručky Ako aktualizovať Ubuntu 16.04 . Po aktualizácii systému pokračujte v inštalácii závislostí.

Nainštalujte Nginx a PHP

Frontend LibreNMS je napísaný v PHP, takže budeme musieť nainštalovať webový server a PHP. V tomto návode nainštalujeme Nginx spolu s PHP 7.2, aby sme dosiahli maximálnu bezpečnosť a výkon.

Nainštalujte Nginx.

sudo apt -y install nginx

Spustite Nginx a povoľte jej automatické spustenie pri štarte.

sudo systemctl start nginx
sudo systemctl enable nginx

Pridajte a povoľte úložisko Remi, pretože predvolené úložisko apt obsahuje staršiu verziu PHP.

sudo add-apt-repository --yes ppa:ondrej/php
sudo apt update

Nainštalujte PHP verziu 7.2 spolu s modulmi požadovanými LibreNMS.

sudo apt -y install php7.2 php7.2-cli php7.2-common php7.2-curl php7.2-fpm php7.2-gd php7.2-mysql php7.2-snmp php7.2-mbstring php7.2-xml php7.2-zip zip unzip

Otvorte načítaný konfiguračný súbor v editore.

sudo nano /etc/php/7.2/fpm/php.ini

Nájdite nasledujúce riadky.

;cgi.fix_pathinfo=1
;date.timezone =

Zrušte komentár a namiesto toho použite tieto hodnoty, nahraďte ich Asia/Kolkata miestnym časovým pásmom.

cgi.fix_pathinfo=0
date.timezone = Asia/Kolkata

Budete tiež musieť zmeniť systémové časové pásmo spustením nasledujúceho príkazu.

sudo ln -sf /usr/share/zoneinfo/Asia/Kolkata /etc/localtime

Reštartujte PHP-FPM.

sudo systemctl restart php7.2-fpm

Nainštalujte MariaDB

MariaDB je open source fork MySQL. Pridajte úložisko MariaDB do svojho systému, pretože predvolené úložisko Ubuntu obsahuje staršiu verziu MariaDB.

sudo apt-key adv --yes --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xF1656F24C74CD1D8
sudo add-apt-repository 'deb [arch=amd64,i386,ppc64el] http://mariadb.biz.net.id/repo/10.2/ubuntu xenial main'
sudo apt update

Nainštalujte MariaDB. Počas inštalácie si inštalátor vypýta heslo rootpoužívateľa MySQL . Poskytnite silné heslo.

sudo apt -y install mariadb-server

Než začneme používať MariaDB, budeme musieť trochu upraviť konfiguráciu. Otvorte konfiguračný súbor.

sudo nano /etc/mysql/conf.d/mariadb.cnf 

Pridajte nasledujúci kód na koniec súboru.

[mysqld]
innodb_file_per_table=1
sql-mode=""
lower_case_table_names=0

Reštartujte MariaDB a povoľte jej automatické spustenie pri štarte.

sudo systemctl restart mariadb.service 
sudo systemctl enable mariadb.service

Pred konfiguráciou databázy budete musieť zabezpečiť inštanciu MariaDB.

sudo mysql_secure_installation

Zobrazí sa výzva na zadanie aktuálneho koreňového hesla MariaDB a potom sa zobrazí výzva na zmenu roothesla. Keďže sme už rootpri inštalácii používateľa nastavili silné heslo , preskočte ho odpoveďou „ N“. Na všetky ostatné otázky odpovedzte „ Y“. Položené otázky sú samovysvetľujúce.

Prihláste sa do shellu MySQL ako root.

mysql -u root -p

Zadajte heslo pre používateľa root MariaDB na prihlásenie. Spustite nasledujúce dotazy na vytvorenie databázy a používateľa databázy pre inštaláciu LibreNMS.

CREATE DATABASE librenms CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'librenms'@'localhost' IDENTIFIED BY 'StrongPassword';
GRANT ALL PRIVILEGES ON librenms.* TO 'librenms'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Názov databázy librenms a používateľské meno môžete nahradiť librenms podľa vlastného výberu. Uistite sa, že StrongPassword ste heslo zmenili na veľmi silné.

Nainštalujte LibreNMS

Okrem vyššie uvedených závislostí potrebuje LibreNMS niekoľko ďalších závislostí.

sudo apt -y install fping git imagemagick jwhois mtr graphviz nmap python-memcache python-mysqldb rrdtool snmp snmpd whois composer

Pridajte nového neprivilegovaného používateľa pre aplikáciu LibreNMS.

sudo useradd librenms -d /opt/librenms -M -r
sudo usermod -aG www-data librenms

LibreNMS je možné nainštalovať priamo klonovaním jeho úložiska Github.

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

Zmeňte vlastníctvo.

sudo chown librenms:librenms -R /opt/librenms

Nainštalujte závislosti PHP.

cd /opt/librenms
sudo su librenms -c "composer install"

LibreNMS sa pri mnohých úlohách spolieha na SNMP. Keďže sme už nainštalovali SNMP, skopírujte vzorový konfiguračný súbor do jeho umiestnenia.

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

Otvorte konfiguračný súbor v editore.

sudo nano /etc/snmp/snmpd.conf

Nájdite tento riadok.

com2sec readonly  default         RANDOMSTRINGGOESHERE

Upravte text RANDOMSTRINGGOESHERE a nahraďte reťazec komunity ľubovoľným reťazcom podľa vlastného výberu. Napríklad.

com2sec readonly  default         my-org

Zapamätajte si reťazec, pretože sa bude vyžadovať neskôr, keď pridáme prvé zariadenie SNMP.

SNMP tiež potrebuje informácie o verzii distribúcie. Stiahnite si a nainštalujte skript, aby ste našli distribučnú verziu.

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

Spustite službu démona SNMP a povoľte jej automatické spustenie v čase zavádzania.

sudo systemctl enable snmpd
sudo systemctl restart snmpd

Now you will need to add some crontab entries to run the scheduled tasks. Create a new cron job file.

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

Restart the cron daemon service.

sudo systemctl restart cron

Setup logrotate so that the log files are automatically refreshed over time.

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

Finally, set the appropriate ownership and permissions.

sudo chown -R librenms:www-data /opt/librenms
sudo chmod g+w -R /opt/librenms
sudo setfacl -d -m g::rwx /opt/librenms/rrd /opt/librenms/logs
sudo setfacl -R -m g::rwx /opt/librenms/rrd /opt/librenms/logs

SSL and Nginx VHost configurations

Logins and other information sent through the web interface of LibreNMS are not secured if the connection is not encrypted with SSL. We will configure Nginx to use the SSL generated with Let's Encrypt free SSL.

Add the Certbot repository.

sudo add-apt-repository --yes ppa:certbot/certbot
sudo apt-get update

Install Certbot, which is the client application for Let's Encrypt CA.

sudo apt -y install certbot

Note: To obtain certificates from Let's Encrypt CA, the domain for which the certificates are to be generated must be pointed towards the server. If not, make the necessary changes to the DNS records of the domain and wait for the DNS to propagate before making the certificate request again. Certbot checks the domain authority before providing the certificates.

Generate the SSL certificates.

sudo certbot certonly --webroot -w /var/www/html -d nms.example.com

The generated certificates are likely to be stored in the /etc/letsencrypt/live/nms.example.com/ directory. The SSL certificate will be stored as fullchain.pem and private key will be stored as privkey.pem.

Let's Encrypt certificates expire in 90 days, hence it is recommended to set up auto-renewal for the certificates using a cron job.

Open the cron job file.

sudo crontab -e

Add the following line at the end of the file.

30 5 * * 1 /usr/bin/certbot renew --quiet

Vyššie uvedená úloha cron sa spustí každý pondelok o 5:30 miestneho času. Ak platnosť certifikátu vyprší, automaticky sa obnoví.

Vytvorte nového virtuálneho hostiteľa.

sudo nano /etc/nginx/sites-available/librenms

Vyplňte súbor.

server {
    listen 80;
    server_name nms.example.com;
    return 301 https://$host$request_uri;
}
server {

    listen 443;
    server_name nms.example.com;

    ssl_certificate           /etc/letsencrypt/live/nms.example.com/fullchain.pem;
    ssl_certificate_key       /etc/letsencrypt/live/nms.example.com/privkey.pem;

    ssl on;
    ssl_session_cache  builtin:1000  shared:SSL:10m;
    ssl_protocols  TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers HIGH:!aNULL:!eNULL:!EXPORT:!CAMELLIA:!DES:!MD5:!PSK:!RC4;
    ssl_prefer_server_ciphers on;

    access_log    /opt/librenms/logs/librenms.nginx.access.log;
    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:/run/php/php7.2-fpm.sock;
    }
    location ~ /\.ht {
        deny all;
    }
 }

Nahraďte nms.example.com vašou skutočnou doménou vo vyššie uvedenej konfigurácii.

Aktivujte novovytvorenú konfiguráciu.

sudo ln -s /etc/nginx/sites-available/librenms /etc/nginx/sites-enabled/librenms

Reštartujte Nginx.

sudo systemctl restart nginx

Inštalácia pomocou WebUI

Na dokončenie inštalácie otvorte https://nms.example.com vo svojom obľúbenom prehliadači. Uvidíte, že požiadavky budú splnené. Zadajte údaje o svojej databáze a vytvorte nový správcovský účet. Po inštalácii dostanete správu na potvrdenie inštalácie. Kliknite na odkaz a prihláste sa pomocou účtu správcu. Mali by ste vidieť, že všetko okrem „ Poller“ má stav „ Ok“.

Teraz kliknite na odkaz a pridajte zariadenie. V Add Devicerozhraní " " zadajte názov hostiteľa ako localhost a nechajte všetko tak, ako je. Zadajte svoj reťazec komunity v poli komunity. Musí to byť presne ten istý reťazec, ktorý ste zadali snmpd.confpočas konfigurácie SNMP.

Po pridaní zariadenia si môžete pozrieť podrobnosti na karte „ Devices“. Podobne môžete do aplikácie LibreNMS pridať ďalšie zariadenia na „nepretržité“ monitorovanie.