Monitore seus dispositivos usando o LibreNMS no Ubuntu 16.04

• Pré-requisitos
• Instale Nginx e PHP
• Instale o MariaDB
• Instale o LibreNMS
• Configurações SSL e Nginx VHost
• Instalação usando WebUI

O LibreNMS é um sistema de monitoramento de rede de código aberto completo. Ele usa SNMP para obter os dados de diferentes dispositivos. Uma variedade de dispositivos é suportada no LibreNMS, como Cisco, Linux, FreeBSD, Juniper, Brocade, Foundry, HP e muitos mais. Ele suporta múltiplos mecanismos de autenticação e autenticação de dois fatores. Possui um sistema de alerta personalizável que pode alertar o administrador da rede por email, IRC ou folga.

Pré-requisitos

• Uma instância do servidor Vultr Ubuntu 16.04.
• Um usuário sudo .

Neste tutorial, usaremos nms.example.com como o nome de domínio apontado para a instância do Vultr. Certifique-se de substituir todas as ocorrências do nome de domínio de exemplo pelo nome real.

Atualize seu sistema base usando o guia Como atualizar o Ubuntu 16.04 . Depois que seu sistema for atualizado, continue com a instalação das dependências.

Instale Nginx e PHP

O front end do LibreNMS é escrito em PHP, portanto, precisamos instalar um servidor da Web e PHP. Neste tutorial, instalaremos o Nginx junto com o PHP 7.2 para obter o máximo de segurança e desempenho.

Instale o Nginx.

sudo apt -y install nginx

Inicie o Nginx e permita que ele inicie automaticamente na inicialização.

sudo systemctl start nginx
sudo systemctl enable nginx

Adicione e ative o repositório Remi, pois o repositório apt padrão contém uma versão mais antiga do PHP.

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

Instale o PHP versão 7.2 junto com os módulos exigidos pelo 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

Abra o arquivo de configuração carregado em um editor.

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

Encontre as seguintes linhas.

;cgi.fix_pathinfo=1
;date.timezone =

Remova o comentário e use esses valores; substitua Asia/Kolkata pelo fuso horário local.

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

Você também precisará alterar o fuso horário do sistema executando o seguinte comando.

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

Reinicie o PHP-FPM.

sudo systemctl restart php7.2-fpm

Instale o MariaDB

MariaDB é um fork de código aberto do MySQL. Adicione o repositório MariaDB ao seu sistema, pois o repositório padrão do Ubuntu contém uma versão mais antiga do 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

Instale o MariaDB. Durante a instalação, o instalador solicitará a senha do rootusuário do MySQL . Forneça uma senha forte.

sudo apt -y install mariadb-server

Antes de começarmos a usar o MariaDB, precisaremos ajustar um pouco a configuração. Abra o arquivo de configuração.

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

Adicione o seguinte código ao final do arquivo.

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

Reinicie o MariaDB e ative-o automaticamente no momento da inicialização.

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

Antes de configurar o banco de dados, você precisará proteger a instância do MariaDB.

sudo mysql_secure_installation

Você será solicitado a senha root atual do MariaDB e será solicitado a alterar a rootsenha. Como já definimos uma senha forte para o rootusuário durante a instalação, pule-a respondendo " N". Para todas as outras perguntas, responda " Y". As perguntas feitas são auto-explicativas.

Entre no shell do MySQL como root.

mysql -u root -p

Forneça a senha para o usuário root do MariaDB efetuar login. Execute as seguintes consultas para criar um banco de dados e um usuário de banco de dados para a instalação do 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;

Você pode substituir o nome do banco de dados librenms e o nome de usuário de librenms acordo com sua escolha. Certifique-se de alterar StrongPassword para uma senha muito forte.

Instale o LibreNMS

Além das dependências acima, o LibreNMS precisa de mais algumas dependências.

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

Adicione um novo usuário não privilegiado ao aplicativo LibreNMS.

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

O LibreNMS pode ser instalado diretamente, clonando seu repositório Github.

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

Mude a propriedade.

sudo chown librenms:librenms -R /opt/librenms

Instale as dependências do PHP.

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

O LibreNMS depende do SNMP para muitas tarefas. Como já instalamos o SNMP, copie o arquivo de configuração de exemplo para seu local.

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

Abra o arquivo de configuração no editor.

sudo nano /etc/snmp/snmpd.conf

Encontre esta linha.

com2sec readonly  default         RANDOMSTRINGGOESHERE

Edite o texto RANDOMSTRINGGOESHERE e substitua a sequência da comunidade por qualquer sequência de sua escolha. Por exemplo.

com2sec readonly  default         my-org

Lembre-se da string, pois será necessária mais tarde quando adicionarmos o primeiro dispositivo SNMP.

O SNMP também precisa de informações sobre a versão de distribuição. Baixe e instale o script para encontrar a versão da distribuição.

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

Inicie o serviço daemon SNMP e ative-o automaticamente no momento da inicialização.

sudo systemctl enable snmpd
sudo systemctl restart snmpd

Agora você precisará adicionar algumas entradas do crontab para executar as tarefas agendadas. Crie um novo arquivo de tarefa cron.

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

Reinicie o serviço cron daemon.

sudo systemctl restart cron

Configure logrotate para que os arquivos de log sejam atualizados automaticamente ao longo do tempo.

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

Por fim, defina a propriedade e as permissões apropriadas.

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

Configurações SSL e Nginx VHost

Logins e outras informações enviadas pela interface da web do LibreNMS não são protegidas se a conexão não for criptografada com SSL. Vamos configurar o Nginx para usar o SSL gerado com o SSL gratuito Vamos criptografar.

Adicione o repositório Certbot.

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

Instale o Certbot, que é o aplicativo cliente do Let's Encrypt CA.

sudo apt -y install certbot

Nota : Para obter certificados da Let's Encrypt CA, o domínio para o qual os certificados devem ser gerados deve estar apontado para o servidor. Caso contrário, faça as alterações necessárias nos registros DNS do domínio e aguarde a propagação do DNS antes de fazer a solicitação de certificado novamente. O Certbot verifica a autoridade do domínio antes de fornecer os certificados.

Gere os certificados SSL.

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

Os certificados gerados provavelmente serão armazenados no /etc/letsencrypt/live/nms.example.com/diretório O certificado SSL será armazenado como fullchain.pem e a chave privada será armazenada como privkey.pem.

Vamos criptografar os certificados expiram em 90 dias; portanto, é recomendável configurar a renovação automática para os certificados usando uma tarefa cron.

Abra o arquivo de tarefa cron.

sudo crontab -e

Adicione a seguinte linha no final do arquivo.

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

O trabalho cron acima será executado toda segunda-feira às 05:30, horário local. Se o certificado estiver vencido, ele será renovado automaticamente.

Crie um novo host virtual.

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

Preencher o arquivo.

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;
    }
 }

Substitua nms.example.com por seu domínio real na configuração acima.

Ative a configuração recém-criada.

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

Reinicie o Nginx.

sudo systemctl restart nginx

Instalação usando WebUI

Para finalizar a instalação, abra https://nms.example.com no seu navegador favorito. Você verá que os requisitos foram atendidos. Forneça os detalhes do seu banco de dados e crie uma nova conta administrativa. Uma vez instalado, você receberá uma mensagem para validar a instalação. Clique no link e efetue login usando a conta de administrador. Você deve ver que tudo, exceto o " Poller" tem um Okstatus " ".

Agora, clique no link para adicionar um dispositivo. Na Add Deviceinterface " ", forneça o nome do host como o host local e deixe tudo como está. Forneça sua string de comunidade no campo da comunidade. Deve ser exatamente a mesma string que você forneceu snmpd.confdurante a configuração do SNMP.

Depois que o dispositivo for adicionado, você poderá ver os detalhes na Devicesguia " ". Da mesma forma, você pode adicionar mais dispositivos ao aplicativo LibreNMS para monitoramento "24 horas".