Como Instalar o LibreNMS com Nginx no Ubuntu 22.04

LibreNMS é uma ferramenta de monitoramento de rede gratuita, de código aberto e poderosa para sistemas operacionais baseados em Linux. Ele permite monitorar todos os principais sistemas operacionais, bem como dispositivos de rede, incluindo Cisco, Juniper, Foundry, FreeBSD, Brocade e muitos mais, através de um navegador da web. O LibreNMS utiliza vários protocolos de rede, como SNMP, ARP, CDP, FDP, LLDP, OSPF e BGP, para descobrir automaticamente todos os sistemas operacionais e dispositivos de rede. Ele oferece uma ampla gama de recursos, incluindo descoberta automática, acesso à API, alertas personalizáveis, atualizações automáticas e muito mais.

Neste tutorial, mostraremos instruções passo a passo sobre como instalar o LibreNMS no Ubuntu 22.04.

Pré-requisitos

• Um servidor executando Ubuntu 22.04.
• Uma senha de root configurada em seu servidor.

Começando

Primeiro, é recomendado atualizar os pacotes do seu sistema para a versão mais recente. Você pode fazer isso com o seguinte comando:

apt-get update -y

Após atualizar todos os pacotes, instale todas as dependências necessárias para o LibreNMS com o seguinte comando:

apt-get install rrdtool whois fping imagemagick graphviz mtr-tiny nmap python3-mysqldb snmp snmpd python3-pip python3-memcache mtr-tiny acl unzip git curl wget -y

Uma vez que todas as dependências estejam instaladas, você pode prosseguir para a próxima etapa.

Instalar Nginx, PHP e Servidor MariaDB

Em seguida, você precisará instalar o servidor Nginx, o servidor MariaDB, PHP e outras extensões PHP em seu servidor. Usaremos o gerenciador de processos php fastcgi (PHP-FPM). Você pode instalar todos eles executando o seguinte comando:

apt-get install nginx mariadb-server php php-pear php-cgi php-common php-curl php-mbstring php-gd php-mysql php-bcmath php-imap php-json php-xml php-snmp php-fpm php-zip -y

Após instalar todos os pacotes, você precisará definir o fuso horário em seu arquivo php.ini.

nano /etc/php/8.1/fpm/php.ini  
nano /etc/php/8.1/cli/php.ini

Defina o fuso horário do seu sistema conforme mostrado abaixo:

date.timezone = UTC

Salve e feche o arquivo de configuração quando terminar. Em seguida, reinicie o serviço PHP-FPM para aplicar as alterações:

systemctl restart php8.1-fpm

Uma vez que você tenha terminado, pode prosseguir para a próxima etapa.

Criar um Banco de Dados LibreNMS

Em seguida, você precisará criar um banco de dados e um usuário para o LibreNMS.

Primeiro, faça login no shell do MariaDB com o seguinte comando:

mysql

Uma vez logado, crie um banco de dados e um usuário com o seguinte comando:

MariaDB [(none)]> create database librenmsdb CHARACTER SET utf8 COLLATE utf8_unicode_ci;  
MariaDB [(none)]> grant all privileges on librenmsdb.* to librenms@localhost IDENTIFIED by "password";

Em seguida, limpe os privilégios e saia do shell do MariaDB com o seguinte comando:

MariaDB [(none)]> flush privileges;  
MariaDB [(none)]> exit;

Em seguida, edite o arquivo de configuração do MariaDB e modifique algumas configurações recomendadas:

nano /etc/mysql/mariadb.conf.d/50-server.cnf

Adicione as seguintes linhas na seção [mysqld]:

innodb_file_per_table=1
sql-mode=""
lower_case_table_names=0

Salve e feche o arquivo e reinicie o serviço MariaDB para aplicar as alterações:

systemctl restart mariadb

Neste ponto, seu MariaDB está configurado. Você pode agora prosseguir para a próxima etapa.

Instalar e Configurar o LibreNMS

Primeiro, você precisará criar um usuário dedicado para o LibreNMS. Você pode adicioná-lo com o seguinte comando:

useradd -r -M -d /opt/librenms librenms

Em seguida, adicione o usuário librenms ao grupo www-data com o seguinte comando:

usermod -a -G librenms www-data

Em seguida, mude o diretório para /opt e baixe a versão mais recente do LibreNMS com o seguinte comando:

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

Em seguida, crie um arquivo de log para o LibreNMS com o seguinte comando:

touch /opt/librenms/logs/librenms.log

Em seguida, copie o arquivo de configuração de exemplo do SNMP com o seguinte comando:

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

Em seguida, edite o arquivo snmpd.conf:

nano /etc/snmp/snmpd.conf

Encontre a seguinte linha:

com2sec readonly  default RANDOMSTRINGGOESHERE

E substitua-a pela seguinte linha:

com2sec readonly  default mysnmpserverkey        

Salve e feche o arquivo e, em seguida, baixe o binário da distribuição SNMP e copie-o para o local desejado:

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

Em seguida, reinicie o serviço SNMP para aplicar as alterações:

systemctl restart snmpd

Em seguida, você também precisará copiar o arquivo cron e logrotate do LibreNMS para o local desejado. Você pode copiá-los com o seguinte comando:

cp /opt/librenms/librenms.nonroot.cron /etc/cron.d/librenms  
cp /opt/librenms/misc/librenms.logrotate /etc/logrotate.d/librenms

Em seguida, mude o diretório para o librenms e instale as dependências necessárias usando o seguinte comando:

cd /opt/librenms  
./scripts/composer_wrapper.php install --no-dev

Uma vez que todas as dependências estejam instaladas, mude a propriedade do diretório librenms e dê as permissões necessárias com o seguinte comando:

chown -R www-data:librenms /opt/librenms  
chmod -R 775 /opt/librenms  
setfacl -d -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/  
setfacl -R -m g::rwx /opt/librenms/rrd /opt/librenms/logs /opt/librenms/bootstrap/cache/ /opt/librenms/storage/

Uma vez que você tenha terminado, pode prosseguir para a próxima etapa.

Criar um Host Virtual Nginx para o LibreNMS

Em seguida, você precisará criar um arquivo de configuração de host virtual Nginx para o LibreNMS. Você pode criá-lo com o seguinte comando:

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

Adicione as seguintes linhas:

server {
 listen      80;
 server_name librenms.example.com;
 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/php8.1-fpm.sock;
 }
 location ~ \.ht {
  deny all;
 }
}

Salve e feche o arquivo e, em seguida, verifique o Nginx para qualquer erro de sintaxe (erro do nginx) com o seguinte comando:

ginx -t

Você deve ver a seguinte saída:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

também queremos reiniciar o PHP uma vez para garantir que você não receba um “librenms 502 bad gateway”, o que pode significar que o php8.1-fpm não está iniciado.

systemctl php8.1-fpm restart

Só para ter certeza, executaremos um comando para parar o Apache2, caso ele tenha sido instalado em seu sistema. Portanto, se o próximo comando falhar, isso é perfeitamente normal, pois significa que você tem apenas o Nginx em execução como pretendido.

systemctl stop apache2

Agora reiniciamos o serviço Nginx para aplicar as alterações:

systemctl restart nginx

Você também pode verificar o status do serviço Nginx usando o seguinte comando:

systemctl status nginx

Você deve obter a seguinte saída:

? nginx.service - A high performance web server and a reverse proxy server
     Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
     Active: active (running) since Sat 2022-07-02 08:35:53 UTC; 8s ago
       Docs: man:nginx(8)
    Process: 49538 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
    Process: 49539 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
   Main PID: 49543 (nginx)
      Tasks: 3 (limit: 4579)
     Memory: 3.3M
        CPU: 43ms
     CGroup: /system.slice/nginx.service
             ??49543 "nginx: master process /usr/sbin/nginx -g daemon on; master_process on;"
             ??49544 "nginx: worker process" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" ""
             ??49545 "nginx: worker process" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" ""

Jul 02 08:35:53 ubuntu2204 systemd[1]: Starting A high performance web server and a reverse proxy server...
Jul 02 08:35:53 ubuntu2204 systemd[1]: Started A high performance web server and a reverse proxy server.

Uma vez que você tenha terminado, pode prosseguir para a próxima etapa.

Acessar a Interface Web do LibreNMS

Agora, abra seu navegador da web e digite a URL http://librenms.example.com para acessar o LibreNMS. Você será redirecionado para a página de verificação pré-instalação:

Certifique-se de que todas as extensões necessárias estejam instaladas e clique nas configurações do Banco de Dados. Você deve ver a seguinte página:

Forneça seu nome de usuário do banco de dados, nome do banco de dados, senha e clique no botão Verificar Credenciais. Uma vez que seja bem-sucedido, você deve ver a seguinte página:

Agora, clique no botão Construir Banco de Dados. Você deve ver a seguinte página:

Em seguida, clique no botão de criação do usuário Admin. Você deve ver a seguinte página:

Forneça seu nome de usuário admin, e-mail, senha e clique no botão Adicionar Usuário. Você deve ver a seguinte página:

Em seguida, clique no botão Finalizar instalação. Você deve ver a seguinte página:

Em seguida, clique em “valide sua instalação”. Você deve ver a página de login do LibreNMS:

Forneça seu nome de usuário admin do LibreNMS, senha e clique no botão Login. Você deve ver o painel do LibreNMS:

Conclusão

Parabéns! você instalou e configurou com sucesso o LibreNMS no servidor Ubuntu 22.04. Agora você pode adicionar um servidor remoto ou dispositivo de rede a partir do painel do LibreNMS e começar a monitorar via navegador da web. Sinta-se à vontade para me perguntar se você tiver alguma dúvida.