LibreNMS är ett övervaknings verktyg för nätverks tjänster. LibreNMS går att intergrera med bla Rancid och Oxidized. LibreNMS har auto-discovery, plugins, API, och en IRC bot för att ta reda på status via IRC. Du kan autha dig mot bla MySQL(Default), LDAP eller HTTP för att få SSO stöd. LibreNMS övervakar enheter med hjälp av SNMP ,ping, deras agent eller med hjälp av Nagios plugins. LibreNMS är en fork av Observium.

Förberedelser

Du behöver en fungerande MySQL databas och en Apache med PHP.

MySQL

LibreNMS har inte stöd för MySQL strict mode än, därför måste det stängas av.

Öppna:

vim /etc/mysql/mysql.conf.d/mysqld.cnf

Lägg till följande inom [mysqld] delen:

innodb_file_per_table=1
sql-mode=""

Och starta om MySQL servern.

Webserver

Installera följande paket: Ubuntu 16.04

apt-get install libapache2-mod-php7.0 php7.0-cli php7.0-mysql php7.0-gd php7.0-snmp php-pear php7.0-curl snmp graphviz php7.0-mcrypt php7.0-json apache2 fping imagemagick whois mtr-tiny nmap python-mysqldb snmpd php-net-ipv4 php-net-ipv6 rrdtool git

I filerna /etc/php/7.0/apache2/php.ini och /etc/php/7.0/cli/php.ini se till att date.timezone är satt till din tidszon. Se PHP tidszoner vad som stöds.

Kör följande kommandon för att enable och disable några php och apache moduler.

a2enmod php7.0
a2dismod mpm_event
a2enmod mpm_prefork
phpenmod mcrypt

Skapa LibreNMS användaren

useradd librenms -d /opt/librenms -M -r
usermod -a -G librenms www-data

Installation

Clona ner repot.

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

Webinterface

cd /opt/librenms
mkdir rrd logs
chmod 775 rrd
vim /etc/apache2/sites-available/librenms.conf

Lägg in följande rader:

 <VirtualHost *:80>
  DocumentRoot /opt/librenms/html/
  ServerName  librenms.example.com
  CustomLog /opt/librenms/logs/access_log combined
  ErrorLog /opt/librenms/logs/error_log
  AllowEncodedSlashes NoDecode
  <Directory "/opt/librenms/html/">
    Require all granted
    AllowOverride All
    Options FollowSymLinks MultiViews
  </Directory>
</VirtualHost>

Sätt LibreNMS användaren som ägare av mappen:

chown -R librenms:librenms /opt/librenms

Aktivera sidan och rewrite module och starta om apache.

a2ensite librenms.conf
a2enmod rewrite
service apache2 restart

Om detta är den enda sidan du hostar glöm inte stänga av default sidan.

a2dissite 000-default.conf

Snmpd

Kopiera exempel filen från LibreNMS och ersätt raden RANDOMSTRINGGOESHERE med din egna commmunity sträng:

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

Starta om snmp servicen:

service snmpd restart

Cronjob

Lägg till cronjob scriptet som sköter discovery, alerts och övervakningen.

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

Web installer

Gå sedan till http://librenms.example.com/install.php och gå igenom stegen.

Konfiguration

Scripten finns under /opt/librenms. Och mycket av konfigurationen görs direkt i config.php som också finns under /opt/librenms.

Lägga till device

Kan göras via web interfacet under Devices > Add device

Eller från CLI med addhost.php scriptet.

php addhost.php <IP>

IRC Bot

Lägg in följande rader i config.php

...
$config['irc_host'] = "irc.freenode.org";
$config['irc_port'] = 6667;
$config['irc_chan'] = "#librenms,#otherchan,#noc";
...

Om servern du vill ansluta mot kör SSL så kan du ange ett + före porten.

...
$config['irc_port'] = "+6667";
...

Om servern har ett lösenord:

$config['irc_pass'] = "Passphrase123";

För att ändra namn från LibreNMS till något annat:

$config['irc_nick'] = "NotLibreNMSbot"

Systemd service

cat <<'__EOF__'>/etc/systemd/system/librenms-irc-bot.service
[Unit]
Description=IRC bot for LibreNMS
After=network.target

[Service]
ExecStart=/usr/bin/php /opt/librenms/irc.php
User=librenms
Group=librenms

[Install]
WantedBy=multi-user.target
__EOF__

Kör sedan följande kommando för att enable tjänsten vid omstart och för att starta tjänsten.

systemctl enable librenms-irc-bot.service && systemctl start librenms-irc-bot.service

IRC kommandon

Note: Det går bara att autha sig mot boten om man använder MySQL som inloggning. LDAP stöd är förhoppningsvis påväg se issue på LibreNMS Github.

Kommando	Beskrivning
.auth <User/Token>	<user>: Requsta auth token. <token>: Authar sig. Man måste autha sig för att kunna använda boten.
.device <hostname>	Ger basic info om hosten.
.down	Listar alla hostnamn som är nere.
.help	Tillgängliga kommandon.
.join <channel>	Joinar en kanal om användaren har admin-level.
.listdevices	Listar hostnamnet på alla kända devices.
.log [<N>]	Listar N linje ur eventlogen.
.port <hostname> <ifname>	Listar info relaterat till porten.
.quit	Boten disconnectar från IRC.
.reload	Reloadar konfigurationen.
.status <type>	Listar status info från den valda typen. En type kan vara devices, services, ports. Förkortning: dev, srv, prt.
.version	Printar `$this->config['project_name_version']`

LDAP

Kräver att paketet php-ldap är installerat. Lägg in följande rader i config.php

$config['auth_mechanism'] = "ldap";

$config['auth_ldap_version'] = 3; # v2 or v3
$config['auth_ldap_server'] = "ldap.example.com";
$config['auth_ldap_port']   = 389;
$config['auth_ldap_prefix'] = "uid=";
$config['auth_ldap_suffix'] = ",ou=People,dc=example,dc=com";
$config['auth_ldap_group']  = "cn=groupname,ou=groups,dc=example,dc=com";

$config['auth_ldap_groupbase'] = "ou=group,dc=example,dc=com";
$config['auth_ldap_groups']['admin']['level'] = 10;
$config['auth_ldap_groups']['noc']['level'] = 5;
$config['auth_ldap_groupmemberattr'] = "memberUid";

User levels

1: Normal användare. Kräver att en admin tilldelar devices och portar som dessa får läsa.
5: Får läsa allt om alla devices.
10: Admin konto som får skriva och läsa.
11: Demo konto. Samma som 10 fast får inte ta bort devices.

Navigation menu

LibreNMS

Contents