Como Instalar a Solução de Monitoramento LibreNMS no Rocky Linux

LibreNMS é uma ferramenta de monitoramento que suporta descoberta automática com múltiplos protocolos, incluindo SNMP, ARP, OSPF e BGP. Para monitorar sistemas operacionais, você pode usar o protocolo SNMP, que está disponível na maioria dos sistemas operacionais, incluindo Linux, Windows e BSDs.

Existem três versões do Protocolo SNMP, v1 e v2 que são seguras apenas com uma senha de comunidade, e o protocolo v3 que suporta senhas para autenticação e criptografia. Para o ambiente de produção, é recomendado usar o protocolo SNMP v3, que é mais seguro do que v2 e v1.

Neste guia, você aprenderá como instalar a ferramenta de monitoramento LibreNMS no servidor Rocky Linux. Este guia inclui a instalação do LEMP Stack (Nginx, MariaDB e PHP-FPM) e a configuração básica do serviço SNMP.

Ao final, você terá a solução de monitoramento LibreNMS pronta para produção e poderá apenas adicionar um novo host ou servidor, ou dispositivo para monitorar com o LibreNMS.

Pré-requisitos

Para completar este guia, você precisará dos seguintes requisitos:

• Um servidor Rocky Linux - Este exemplo usa o Rocky Linux 8.
• Um usuário não-root com privilégios de sudo root/administrador.
• Um nome de domínio local para a implantação local.

Configurando Repositórios

Antes de começar a instalar pacotes, você agora configurará repositórios em seu sistema Rocky Linux. Você precisará adicionar o repositório EPEL (Pacotes Extras para Linux Empresarial) e o repositório PHP Remi.

Execute o seguinte comando dnf para adicionar o repositório EPEL ao seu sistema.

sudo dnf install epel-release

Digite Y quando solicitado para a confirmação e pressione ENTER para prosseguir.

Em seguida, execute o seguinte comando dnf para adicionar o repositório PHP Remi. Este repositório fornece várias versões do PHP, que inclui o PHP 8.1 mais recente que é necessário para a instalação do LibreNMS.

sudo dnf install dnf-utils http://rpms.remirepo.net/enterprise/remi-release-8.rpm

Agora digite Y e pressione ENTER para prosseguir.

Após adicionar os repositórios EPEL e Remi, verifique usando o comando dnf abaixo.

sudo dnf repolist

Você deve ver que os repositórios EPEL e Remi foram adicionados e estão disponíveis em seu sistema Rocky Linux.

Instalando Dependências de Pacotes

Após adicionar os repositórios EPEL e Remi, você agora começará a instalar as dependências de pacotes para o LibreNMS. Isso inclui o LEMP Stack, pacotes SNMP e algumas dependências básicas do Python.

Antes de iniciar a instalação, execute o seguinte comando para habilitar o módulo do repositório PHP ‘remi-8.1‘. A versão mais recente do LibreNMS requer pelo menos PHP 8.

sudo dnf reset php  
sudo dnf module enable php:remi-8.1

Digite y para confirmar e habilitar o repositório PHP Remi 8.1.

Em seguida, execute o seguinte comando dnf para instalar as dependências de pacotes para o LibreNMS. Quando solicitado a confirmar a instalação, digite y e pressione ENTER para prosseguir, e a instalação começará.

sudo dnf install bash-completion cronie fping git ImageMagick mariadb-server mtr net-snmp net-snmp-utils nginx nmap php-fpm php-cli php-common php-curl php-gd php-gmp php-json php-mbstring php-process php-snmp php-xml php-zip php-mysqlnd python3 python3-PyMySQL python3-devel python3-redis python3-memcached python3-pip python3-systemd rrdtool unzip

Após as dependências serem instaladas, execute o seguinte comando para iniciar e habilitar alguns serviços como Nginx, MariaDB, PHP-FPM e snmpd.

sudo systemctl enable nginx php-fpm mariadb snmpd  
sudo systemctl start nginx php-fpm mariadb snmpd

Neste ponto, alguns serviços básicos Nginx, MariaDB, PHP-FPM e o snmpd serão iniciados automaticamente na inicialização do sistema. E todos esses serviços estão em execução.

Configurando o Firewalld

Para este exemplo, estamos usando o Rocky Linux com firewalld habilitado. Agora você adicionará ambos os protocolos HTTP e HTTPS ao firewalld.

Execute o seguinte comando firewall-cmd para adicionar os serviços HTTP e HTTPS ao firewalld. Você deve receber a mensagem de saída ‘success‘, o que significa que a nova regra foi adicionada.

sudo firewall-cmd --permanent --zone public --add-service http  
sudo firewall-cmd --permanent --zone public --add-service https

Em seguida, recarregue o firewalld para aplicar novas alterações. Depois, verifique o status do firewalld usando o seguinte comando.

sudo firewall-cmd --reload  
sudo firewall-cmd --list-all

Você receberá a saída de que ambos os protocolos HTTP e HTTPS foram adicionados ao firewalld.

Baixando o Código Fonte do LibreNMS

Neste passo, você fará o download do código fonte do LibreNMS do GitHub. Mas antes disso, você também criará um novo usuário dedicado ‘librenms‘ que será usado para executar o aplicativo LibreNMS.

Execute o seguinte comando para criar um novo usuário do sistema ‘librenms’. Este usuário será usado para executar o aplicativo LibreNMS.

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

Agora mova seu diretório de trabalho para ‘/opt’ e baixe o código fonte do LibreNMS via o comando git abaixo. Você deve agora obter um novo diretório ‘/opt/librenms‘, que será usado como o diretório de instalação do LibreNMS.

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

Altere a propriedade e a permissão do diretório de instalação do LibreNMS ‘/opt/librenms‘. A propriedade da instalação deve ser o usuário ‘librenms’, e também a permissão 771 permitirá que o usuário leia, escreva e execute no diretório.

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

Por fim, execute o seguinte comando para definir as listas de controle de acesso para alguns dos diretórios do LibreNMS. Isso concederá ao grupo ‘librenms‘ permissão de leitura, escrita e execução em alguns diretórios específicos do LibreNMS.

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/

Instalando Dependências PHP para o LibreNMS

Após baixar o código fonte do LibreNMS e configurar as permissões corretas, você agora instalará as dependências PHP para o LibreNMS.

Faça login como o usuário ‘librenms’ usando o seguinte comando.

su - librenms

Agora, instale as dependências PHP via o script de instalação como abaixo.

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

Você agora verá a instalação das dependências PHP que são necessárias para o LibreNMS. Você também verá a instalação dos pacotes Python para o LibreNMS.

Após a instalação das dependências PHP ser concluída, você pode agora sair do usuário ‘librenms‘ pressionando ‘Ctrl+d‘ ou pode digitar o comando ‘exit‘.

Configurando PHP-FPM

Neste passo, você configurará sua instalação do PHP-FPM para o LibreNMS. Você modificará a configuração padrão ‘/etc/php.ini‘ e configurará um pool específico do PHP-FPM para o LibreNMS.

Execute o seguinte comando para configurar o fuso horário correto para seu sistema Rocky Linux.

sudo timedatectl set-timezone Europe/Stockholm

Agora edite a configuração do PHP ‘/etc/php.ini‘ usando o seguinte editor nano.

sudo nano /etc/php.ini

Descomente a opção ‘date.timezone’ e altere o valor para o seu fuso horário atual do servidor.

date.timezone = Europe/Stockholm

Salve o arquivo e feche o editor quando terminar.

Em seguida, copie a configuração padrão do pool PHP-FPM ‘www.conf‘ para ‘librenms.conf‘. Neste exemplo, você configurará o pool específico do PHP-FPM para a ferramenta de monitoramento LibreNMS.

cp /etc/php-fpm.d/www.conf /etc/php-fpm.d/librenms.conf

Agora edite a configuração do pool PHP-FPM ‘/etc/php-fpm.d/librenms.conf‘ usando o seguinte editor nano.

sudo nano /etc/php-fpm.d/librenms.conf

Altere o nome do pool padrão de ‘[www]‘ para ‘[librenms]‘.

[librenms]

Altere o usuário e o grupo padrão para ‘librenms‘. Isso fará com que o processo PHP-FPM seja executado como o usuário e grupo ‘librenms‘.

user = librenms  
group = librenms

Por fim, altere a opção listen para ‘/run/php-fpm-librenms.sock’. Isso especificará o arquivo sock para o pool PHP-FPM librenms.

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

Salve o arquivo e saia do editor quando terminar.

Agora execute o seguinte comando systemctl para reiniciar o serviço PHP-FPM e aplicar novas alterações.

sudo systemctl restart php-fpm

Configurando o Servidor MariaDB

Após configurar o PHP-FPM, você agora configurará o servidor de banco de dados MariaDB e criará um novo banco de dados e usuário para o LibreNMS.

O LibreNMS requer o servidor de banco de dados MariaDB com InnoDB habilitado. Portanto, agora você precisará habilitá-lo. Em seguida, você criará um novo banco de dados e usuário para o LibreNMS.

Edite a configuração do servidor MariaDB ‘/etc/my.cnf.d/mariadb-server.cnf’ usando o seguinte editor nano.

sudo nano /etc/my.cnf.d/mariadb-server.cnf

Coloque a seguinte configuração na seção ‘[mysqld]‘.

[mysqld]  
....  
innodb_file_per_table=1  
lower_case_table_names=0

Salve o arquivo e saia do editor quando terminar.

Agora execute o seguinte comando systemctl abaixo para reiniciar o serviço MariaDB e aplicar novas alterações. O servidor MariaDB agora está em execução com o mecanismo de banco de dados InnoDB habilitado.

sudo systemctl restart mariadb

Em seguida, faça login no shell do MariaDB via o comando mysql abaixo. Quando solicitado pela senha, você pode apenas pressionar ENTER ou digitar a senha root do MariaDB.

sudo mysql -u root -p

Execute as seguintes consultas para criar um novo banco de dados e usuário para o LibreNMS. Neste exemplo, você criará um novo banco de dados e usuário ‘librenms‘, e certifique-se de alterar a senha do banco de dados pela sua senha.

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';  
FLUSH PRIVILEGES;

Em seguida, execute a seguinte consulta para verificar os privilégios para o usuário do banco de dados ‘librenms@localhost‘.

SHOW GRANTS FOR librenms@localhost;

Você deve ver que o usuário ‘librenms’@localhost tem privilégios para o banco de dados ‘librenms‘.

Agora digite ‘exit‘ para sair do shell do MariaDB.

Configurando Blocos de Servidor Nginx

Após configurar o servidor MariaDB e criar o banco de dados e usuário, você agora criará uma nova configuração de bloco de servidor Nginx para o LibreNMS.

Antes de começar, certifique-se de ter decidido sobre o domínio local que será usado para o LibreNMS. Neste exemplo, o LibreNMS deve estar rodando com o domínio ‘librenms.howtoforge.local‘.

Crie uma nova configuração de bloco de servidor Nginx ‘/etc/nginx/conf.d/librenms.conf‘ usando o seguinte editor nano.

sudo nano /etc/nginx/conf.d/librenms.conf

Adicione a seguinte configuração ao arquivo e certifique-se de alterar o nome do domínio pelo seu domínio.

server {  
    listen      80;  
    server_name librenms.howtoforge.local;  
    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;  
    }  
}

Salve o arquivo e saia do editor quando terminar.

Em seguida, execute o seguinte comando para verificar a configuração do Nginx e garantir que a configuração esteja correta.

sudo nginx -t

Se sua configuração do Nginx estiver correta, você verá a mensagem de saída como ‘test successful - Syntax OK‘.

Agora reinicie o serviço Nginx para aplicar a nova configuração do bloco de servidor.

sudo systemctl restart nginx

Neste ponto, você completou a configuração do LEMP Stack (Nginx, banco de dados MariaDB e PHP-FPM) para o LibreNMS. Além disso, o LibreNMS deve agora estar em execução em seu sistema Rocky Linux.

Configurando SELinux

Para este guia, você executará o LibreNMS com o SELinux habilitado no modo enforcing. Portanto, agora você configurará regras do SELinux para o LibreNMS.

Para começar, execute o seguinte comando dnf abaixo para instalar o pacote ‘policycoreutils-python-utils‘ em seu sistema Rocky Linux. Este pacote fornece várias linhas de comando para gerenciar o SELinux.

sudo dnf install policycoreutils-python-utils

Quando solicitado, digite y para confirmar e pressione ENTER para prosseguir.

Em seguida, execute o seguinte comando para configurar rótulos para o código fonte do LibreNMS.

semanage fcontext -a -t httpd_sys_content_t '/opt/librenms/html(/.*)?'  
semanage fcontext -a -t httpd_sys_rw_content_t '/opt/librenms/(rrd|storage)(/.*)?'  
semanage fcontext -a -t httpd_log_t "/opt/librenms/logs(/.*)?"  
semanage fcontext -a -t bin_t '/opt/librenms/librenms-service.py'  
restorecon -RFvv /opt/librenms  
chcon -t httpd_sys_rw_content_t /opt/librenms/.env

Execute o seguinte comando para permitir acesso a alguns serviços para o servidor web Nginx.

setsebool -P httpd_can_sendmail=1  
setsebool -P httpd_execmem 1

Agora, crie um novo arquivo ‘http_fping.tt’ usando o seguinte editor nano.

nano http_fping.tt

Adicione a seguinte configuração ao arquivo.

module http_fping 1.0;  
  
require {  
type httpd_t;  
class capability net_raw;  
class rawip_socket { getopt create setopt write read };  
}  
  
#============= httpd_t ==============  
allow httpd_t self:capability net_raw;  
allow httpd_t self:rawip_socket { getopt create setopt write read };

Salve o arquivo e saia do editor quando terminar.

Em seguida, execute o seguinte comando para converter o ‘http_fping.tt‘ para o formato do SELinux. Depois, adicione a nova regra compilada ao SELinux.

checkmodule -M -m -o http_fping.mod http_fping.tt  
semodule_package -o http_fping.pp -m http_fping.mod  
semodule -i http_fping.pp

Agora que você terminou a configuração do SELinux para o LibreNMS. Em seguida, você configurará algumas configurações adicionais para o LibreNMS.

Finalizando as Configurações do LibreNMS

Para finalizar a configuração do LibreNMS, você agora configurará o comando ‘lnms‘, copiará algumas configurações padrão do LibreNMS, incluindo configurações para cron e logrotate. Além disso, você configurará o serviço SNMP para o LibreNMS.

Execute o seguinte comando para habilitar o comando ‘lnms‘ e copiar a conclusão bash do comando ‘lnms‘.

ln -s /opt/librenms/lnms /usr/bin/lnms  
cp /opt/librenms/misc/lnms-completion.bash /etc/bash_completion.d/

Copie a configuração de exemplo do cron do LibreNMS para o ‘/etc/cron.d/librenms‘.

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

Copie a configuração padrão do logrotate para o LibreNMS para ‘/etc/logrotate.d/librenms‘.

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

Agora copie a configuração padrão do serviço snmpd para ‘/etc/snmp/snmpd.conf’. Em seguida, edite o novo arquivo ‘/etc/snmp/snmpd.conf’ usando o editor nano.

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

Altere a senha de comunidade padrão para o serviço snmpd ‘RANDOMSTRINGGOESHERE‘ pela sua senha.

# Altere RANDOMSTRINGGOESHERE para sua string de comunidade SNMP preferida  
com2sec readonly  default         RANDOMSTRINGGOESHERE

Salve o arquivo e saia do editor quando terminar.

Em seguida, baixe o arquivo binário que será usado pelo LibreNMS para detectar automaticamente o sistema operacional de cada host alvo. Depois, torne-o executável alterando a permissão padrão.

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

Por fim, reinicie o serviço snmpd para aplicar novas alterações e novas configurações.

systemctl restart snmpd

Agora que todas as configurações básicas estão concluídas. Em seguida, você iniciará a instalação do LibreNMS via o navegador web.

Acessando a Instalação Web do LibreNMS

Em sua máquina local, edite o arquivo ‘/etc/hosts’ e defina o nome de domínio local da sua instalação do LibreNMS. Além disso, certifique-se de alterar o endereço IP pelo endereço IP do seu servidor.

192.168.5.100   librenms.howtoforge.local

Agora abra o navegador web e visite o nome de domínio da sua instalação do LibreNMS (ou seja: http://librenms.howtoforge.local/).

A princípio, o instalador do LibreNMS verificará os ambientes para a instalação. Certifique-se de que todos os requisitos estejam marcados como verdes, o que significa que o sistema está pronto para a instalação do LibreNMS.

Clique no ícone do banco de dados para continuar.

Agora insira os detalhes do banco de dados e usuário para o seu LibreNMS e clique em ‘Check Credentials‘. Se suas credenciais de banco de dados estiverem corretas, a seção será marcada como verde.

Agora clique em ‘Build Database‘ para iniciar a migração do banco de dados para o LibreNMS.

Após a migração do banco de dados ser concluída, você verá a seção ‘Build Database‘ marcada como verde.

Clique no ícone da chave para começar a configurar o usuário administrador para o LibreNMS.

Agora insira o novo usuário administrador, senha e endereço de e-mail para sua instalação do LibreNMS e clique em ‘Add User‘.

Agora a instalação está concluída e você verá a seguinte página. Você pode ver que a instalação está concluída e as configurações foram escritas no arquivo ‘.env‘.

Agora clique no link ‘validate your install‘ para verificar a instalação do LibreNMS.

Você agora deve ser redirecionado para a página de login do LibreNMS. Insira seu usuário administrador e senha, e clique em ‘Login‘.

Agora certifique-se de que todas as configurações estejam marcadas como ‘OK‘, o que significa que a configuração não tem erro.

Você também pode corrigir todos os erros ou avisos seguindo as instruções recomendadas pelo LibreNMS.

Agora você pode adicionar um novo host alvo, máquina virtual ou dispositivo de rede para monitorar a Solução de Monitoramento LibreNMS.

Conclusão

Parabéns! Você instalou a Solução de Monitoramento LibreNMS no servidor Rocky Linux. Você também aprendeu a configuração básica do LEMP Stack (Nginx, MariaDB e PHP-FPM) no Rocky Linux.

A partir daqui, você pode continuar a adicionar um host ou máquina alvo para monitorar, configurar o Agente LibreNMS, configurar alertas ou notificações, configurar integração de terceiros com o Graylog e realizar outras tarefas.