Hvernig á að setja upp LibreNMS eftirlitsverkfæri á Debian 11/10


LibreNMS er opinn uppspretta og fullbúið netvöktunartæki sem býður upp á breitt úrval vöktunareiginleika og getu fyrir nettækin þín.

Helstu eiginleikar eru:

  • Sjálfvirk uppgötvun á öllu netinu þínu með því að nota ARP, SNMP, BGP, OSPF, LLDP og FDP samskiptareglur.
  • Aðvörunarkerfi sem er mjög sérhannaðar og hægt er að fínstilla það til að senda viðvaranir með tölvupósti, Slack og öðrum rásum.
  • Einfalt og auðvelt að sérsníða mælaborð.
  • Víðtækt API til að stjórna og setja línurit af gögnum frá vöktunarþjóninum þínum.
  • Víðtækur stuðningur við tæki – Styður margs konar vélbúnaðarframleiðendur eins og Cisco, Juniper, HP og marga fleiri.
  • Sjálfvirkar uppfærslur og villuleiðréttingar.
  • Margþátta auðkenning.
  • Innbyggður stuðningur fyrir Android og iOS forrit.
  • og margt fleira.

Í þessari handbók munum við setja upp LibreNMS vöktunartólið á Debian 11/10.

Skref 1: Settu upp Nginx, MariaDB og PHP

Til að byrja, endurnýjaðu geymslurnar og settu upp nauðsynlega pakka sem hér segir:

$ sudo apt update
$ sudo apt install software-properties-common wget apt-transport-https

Næsta skref er að setja upp Nginx og viðbótarpakka eins og curl, git, SNMP og python pakka sem LibreNMS vöktunartólið þarfnast.

Svo keyrðu skipunina:

$ sudo apt install nginx-full curl acl fping graphviz composer git imagemagick mtr-tiny nmap python3-pip python3-memcache python3-mysqldb python3-dotenv python3-pymysql rrdtool snmp snmpd whois python3-redis python3-systemd python3-setuptools python3-systemd

Næst skaltu setja upp MariaDB gagnagrunnsþjóninn, PHP og viðbótar PHP viðbætur sem LibreNMS vöktunartólið þarfnast.

$ sudo apt install mariadb-server php php-fpm php-cli php-xml php-common php-gd php-json php-snmp php-pdo php-mysql php-zip php-curl php-mbstring php-pear php-bcmath

Þegar það hefur verið sett upp, vertu viss um að virkja Nginx, php-fpm, MariaDB og SNMP þjónustu eins og sýnt er.

$ sudo systemctl enable --now nginx
$ sudo systemctl enable --now php7.4-fpm
$ sudo systemctl enable --now mariadb
$ sudo systemctl enable --now snmpd.service

Skref 2: Stilltu TimeZone fyrir PHP

Næsta skref krefst þess að við stillum eða stillum PHP tímabeltið. Þetta er gert í php.ini skránni sem er sjálfgefin PHP stillingarskrá.

Fáðu aðgang að php.ini stillingarskránum á eftirfarandi slóðum með því að nota uppáhalds ritilinn þinn.

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

Farðu í færibreytuna date.timezone og stilltu hana á tímabeltið þitt. Til að fá alhliða lista yfir öll studd tímabelti skaltu fara á opinberu PHP síðuna.

Í þessu dæmi erum við að stilla tímabeltið á UTC.

date.timezone = UTC

Vistaðu síðan breytingarnar og lokaðu skránum.

Skref 3: Búðu til gagnagrunn fyrir LibreNMS

Í þessu skrefi munum við búa til gagnagrunn fyrir LibreNMS uppsetningu. En fyrst skulum við tryggja gagnagrunninn öruggan með því að keyra eftirfarandi skriftu:

$ sudo mysql_secure_installation

Fylgdu ítarlegum leiðbeiningum sem leiðbeina þér um hvernig á að búa til MariaDB rót lykilorðið, fjarlægja nafnlausa notendur og prófa gagnagrunninn og að lokum banna ytri rót innskráningu.

Næst skaltu skrá þig inn á MariaDB:

$ sudo mysql -u root -p

Keyrðu síðan eftirfarandi skipanir til að búa til gagnagrunn og gagnagrunnsnotanda og úthluta gagnagrunnsnotandanum öll réttindi.

CREATE DATABASE librenms_db CHARACTER SET utf8 COLLATE utf8_unicode_ci;
CREATE USER 'librenms_user'@'localhost' IDENTIFIED BY '[email '; 
GRANT ALL PRIVILEGES ON librenms_db.* TO 'librenms_user'@'localhost';

Vistaðu síðan breytingarnar og farðu úr MariaDB leiðbeiningunum.

FLUSH PRIVILEGES;
EXIT;

Nauðsynlegt er að fínstilla gagnagrunninn. Svo opnaðu MariaDB stillingarskrána sem sýnd er:

$ sudo vim /etc/mysql/mariadb.conf.d/50-server.cnf

Límdu síðan eftirfarandi kóðalínur í 'mysqld' hlutann.

innodb_file_per_table=1
lower_case_table_names=0

Vistaðu breytingarnar og lokaðu skránni. Til að beita breytingunum skaltu endurræsa gagnagrunnsþjóninn.

$ sudo systemctl restart mariadb

Skref 4: Bættu við LibreNMS notanda

Þú þarft líka að búa til nýjan LibreNMS notanda. Þetta er notandinn sem LibreNMS mun keyra undir. Í þessu dæmi erum við að búa til notanda sem heitir librenms með eftirfarandi eiginleikum.

$ sudo useradd librenms -d /opt/librenms -M -r -s /bin/bash
$ sudo usermod -aG librenms www-data

  • Valkosturinn -d setur heimamöppuna fyrir Librenms notandann á /opt/librenms skrána.
  • Valkosturinn -r stillir Librenms notanda sem kerfisnotanda.
  • Valkosturinn -M sleppir því að búa til heimaskrá fyrir notandann þar sem hún hefur þegar verið skilgreind með -d valkostinum.
  • Valkosturinn -s tilgreinir tegund skeljar, í þessu tilviki, bash.

Skref 5: Klóna LibreNMS Git geymslu

Með því að skipta um gír, ætlum við nú að klóna LibreNMS git geymsluna til að byrja að setja hana upp.

Keyrðu eftirfarandi skipanir til að klóna Git geymsluna

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

Skiptu síðan aftur í heimaskrána.

$ cd  ~

Næst þurfum við að úthluta eignarhaldi og heimildum á skráarsafninu á Librenms heimaskrá. Til að ná þessu skaltu keyra eftirfarandi skipanir:

$ sudo chown -R librenms:librenms /opt/librenms
$ sudo chmod 771 /opt/librenms

Að auki skaltu breyta aðgangsstýringarlistum fyrir Librenms heimaskrá með því að nota setfacl skipunina. Þetta veitir Librenms hópnum leyfi til að lesa og skrifa á undirmöppurnar í heimaskránni.

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

Skref 6: Settu upp PHP Dependencies

Sumar ósjálfstæði er krafist af PHP við uppsetningu LibreNMS vöktunartólsins. Til að gera þetta þarftu að vera skráður inn sem librenmuser.

$ sudo su - librenms

Næst skaltu setja upp allar PHP ósjálfstæði eins og hér segir.

$ ./scripts/composer_wrapper.php install --no-dev

Þegar uppsetningu á ósjálfstæði er lokið skaltu loka librenms notandanum.

$ exit

Skref 7: Stilltu PHP-FPM fyrir LibreNMS uppsetningu

Áfram þurfum við að gera nokkrar breytingar á PHP-FPM til að styðja við LibreNMS.

Til að ná þessu. Afritaðu 'www.conf' skrána sem er sjálfgefin laug stillingarskrá yfir í 'librenms.conf' skrána eins og hér segir.

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

Næst skaltu breyta 'librenms.conf' skránni.

$ sudo nano /etc/php/7.4/fpm/pool.d/librenms.conf

Breyttu notanda- og hópbreytum í librenms eins og sýnt er

user = librenms
group = librenms

Næst skaltu breyta hlustunareigindinni í /run/php-fpm-librenms.sock sem hér segir.

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

Vistaðu breytingarnar og farðu úr stillingum. Vertu viss um að endurræsa PHP-FPM þjónustuna til að beita breytingunum.

$ sudo systemctl restart php7.4-fpm

Skref 8: Stilltu SNMP púkann

SNMP samskiptareglur eru TCP/IP samskiptareglur sem safnar og skipuleggur mælikvarða eða upplýsingar frá stýrðum tækjum yfir netkerfi.

Flest eftirlitsverkfæri eins og Cacti nýta SNMP þjónustuna til að safna upplýsingum frá ytri gestgjöfum. Og það gerir LibreNMS líka.

Til að stilla SNMP þjónustuna skaltu halda áfram og afrita snmpd.conf.example skrána í /etc/snmp/snmpd.conf skrána.

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

Næst skaltu breyta snmpd.conf skránni.

$ sudo vim /etc/snmp/snmpd.conf

Finndu RANDOMSTRINGGOESHERE strenginn.

com2sec readonly  default         RANDOMSTRINGGOESHERE

Breyttu því í librenms.

com2sec readonly  default		  librenms

Vistaðu breytingarnar og hættu.

Næst skaltu hlaða niður dreifingarskránni, sem er skrá sem greinir sjálfkrafa stýrikerfi stýrðu hnútanna og greinir dreifingu þess.

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

Gerðu það keyranlegt og endurræstu SNMP þjónustuna.

$ sudo chmod +x /usr/bin/distro
$ sudo systemctl restart snmpd

Skref 9: Stilltu Nginx fyrir LibreNMS

Með Nginx sem ákjósanlegur vefþjónn okkar þurfum við að fara auka skref og stilla það til að þjóna LibreNMS.

Í fyrsta lagi munum við búa til Nginx netþjónablokk eins og sýnt er.

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

Límdu eftirfarandi línur af kóða. Fyrir eigindina server_name, gefðu upp skráð lén eða IP-tölu netþjónsins þíns.

server {
  listen      80;
  server_name 23.92.30.144;        
  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:/var/run/php/php-fpm.sock;
  }
  location ~ /.ht {
   deny all;
  }
 }

Vistaðu breytingarnar og farðu úr stillingarskránni. Næst skaltu virkja Nginx netþjónablokkina með því að búa til táknrænan hlekk eins og sýnt er.

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

Endurræstu síðan Nginx til að beita breytingunum sem gerðar voru á stillingunum.

$ sudo systemctl restart nginx

Að auki geturðu staðfest að allar Nginx stillingar séu í lagi með því að keyra skipunina:

$ sudo nginx -t

Skref 10: Afritaðu Logrotate og Cron stillingarnar

Sjálfgefið er að LibreNMS geymir annála sína í /opt/librenms/logs skránni. Með tímanum getur þetta auðveldlega fyllst og valdið plássvandamálum. Til að koma í veg fyrir þetta er mælt með því að snúa gömlum annálaskrám.

Afritaðu því logrotate skrána í LibreNMS möppunni í /etc/logrotate.d/ möppuna.

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

Jafn mikilvægt, afritaðu cron vinnuskrána sem hér segir til að leyfa sjálfvirka skoðanakönnun og uppgötvun nýrra tækja

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

Skref 11: Ljúktu við uppsetningu LibreNMS úr vafra

Til að klára uppsetninguna úr vafra skaltu fara á eftirfarandi vefslóð:

http://server-ip

Þetta færir þig á gátlistann fyrir uppsetningu sem sýndur er. Ef allt lítur vel út, smelltu á „gagnagrunn“ táknið til hægri.

Vertu viss um að fylla út allar upplýsingar um gagnagrunninn og smelltu á 'Athugaðu skilríki'.

Þegar upplýsingar um gagnagrunninn hafa verið staðfestar skaltu smella á „Byggðu gagnagrunn“.

Þegar þú kemst yfir þetta skref skaltu smella á næsta tákn til að búa til Admin notanda. Gefðu upp notandanafn, lykilorð og netfang stjórnanda notandans og smelltu á „Bæta við notanda“.

Að lokum, smelltu á síðasta hnappinn til að ljúka uppsetningunni.

Þú munt rekast á þessa villu og tilkynna þér að uppsetningarforritið „Mistókst að skrifa skrá: /opt/librenms/.env“.

En ekki hafa áhyggjur. Einfaldlega uppfærðu /opt/librenms/.env skrána handvirkt aftur með gagnagrunnsupplýsingunum sem gefnar eru upp. Þessar upplýsingar eru mismunandi í þínu tilviki.

Svo, opnaðu skrána.

$ sudo nano /opt/librenms/.env

Eyddu öllu innihaldi skráarinnar og límdu upplýsingarnar sem gefnar eru upp hér að ofan í skrána og vistaðu breytingarnar.

Næst skaltu fara til baka og smella á „Reyna aftur“ hnappinn. Þetta tekur þig á LibreNMS innskráningarsíðuna. Gefðu upp innskráningarskilríki og smelltu á 'Innskráning'.

Þegar þú hefur skráð þig inn færðu slíkt mælaborð. Héðan geturðu byrjað að bæta við gestgjöfum þínum og fylgst með ýmsum mælingum.

Og þannig er það. Í þessari handbók höfum við leiðbeint þér í gegnum uppsetningu á LibreNMS vöktunartólinu á Debian 11/10.