Instalação

Instalação

A documentação oficial atual usa instalação manual suportada. O antigo conceito de 'script oficial que instala tudo' não deve ser usado como base desta documentação.

Ponto técnico 1

Método atual: A documentação oficial atual usa instalação manual suportada. O antigo conceito de 'script oficial que instala tudo' não deve ser usado como base desta documentação.

Ponto técnico 2

Requisitos: Use sistema operacional suportado, NGINX recomendado, MariaDB/MySQL, PHP compatível, RRDtool, SNMP e dependências Python/PHP. A documentação atual informa PHP mínimo 8.4 e recomenda 8.5.

Ponto técnico 3

Usuário e diretório: LibreNMS é normalmente instalado em /opt/librenms com usuário de sistema librenms. Ownership e ACLs de rrd, logs, storage e cache são parte funcional da instalação.

Ponto técnico 4

Composer: As dependências PHP são instaladas com scripts/composer_wrapper.php install --no-dev executado como librenms.

Ponto técnico 5

Banco: Crie banco/usuário dedicados e configure MariaDB conforme a documentação atual. Valide timezone e parâmetros antes do web installer.

Ponto técnico 6

PHP-FPM e Web: Configure PHP-FPM e NGINX/Apache conforme o SO. HTTPS deve ser configurado antes de qualquer exposição pública.

Ponto técnico 7

Scheduler: A instalação atual inclui librenms-scheduler.service/timer. Dispatcher Service é uma evolução opcional para scheduling e escala.

Ponto técnico 8

Validação: Após a instalação, execute ./validate.php como librenms. CLI e WebUI fazem verificações diferentes; use ambos.

Ponto técnico 9

Primeiro dispositivo: Adicione localhost e depois um equipamento real. Não comece cadastrando centenas de dispositivos antes de validar polling, RRD, alerting e backup.

Procedimento de engenharia

Comandos / fluxo de referência

su - librenms
cd /opt/librenms
./validate.php

# Scheduler systemd
systemctl status librenms-scheduler.timer

Rotina operacional recomendada

• Revise estados críticos, lacunas de coleta e falhas de entrega a cada turno.
• Revise alertas ruidosos, objetos lentos, credenciais e erros recorrentes semanalmente.
• Revise versões, backup/restore, permissões e capacidade periodicamente.

Sintoma → escopo → camada → evidência → hipótese → validação

Construa, quebre, diagnostique e recupere

1. Registre um baseline saudável.
2. Induza uma falha controlada relacionada ao tema.
3. Identifique a camada com falha antes de reiniciar componentes.
4. Corrija a causa identificada e valide a recuperação.

Pronto para produção?

Documentação sensível à versão

LibreNMS é rolling release. O conteúdo foi confrontado com a documentação oficial atual; instalação, Dispatcher, API, distributed polling, RRDCached, Redis, HA e requisitos devem ser reconfirmados antes de change.