A OPServices recomenda a utilização da nova geração de agentes NCPA para os seguintes sistemas operacionais baseados em RHEL:
- Oracle Linux v9.x+
- CentOS Stream v9.x+
- Rocky Linux v9.x+
- Alma Linux v9.x+
- RHEL v9.x+
E nos seguintes sistemas Debian-like:
- Debian v9.x+
- Ubuntu 20.04+
Procedimentos para instalação do agente NCPA em sistemas operacionais baseados em RHEL e Debian
Pré-requisitos:
- SELinux: desabilitado(ou deverá ser permitida a execução do daemon do agente).
- Firewall: deverá ser permitida a comunicação entre o OpMon e o host monitorado na porta 5693/TCP.
Procedimentos de instalação:
1. Seguir a instruções contidas na documentação do agente para o sistema operacional.
2. Configurar os seguintes parâmetros no arquivo de configuração:
[root@OL9 ~]# vim /usr/local/ncpa/etc/ncpa.cfg
- admin_password: senha de acesso à interface web do agente.
- admin_auth_only: setar valor em 1( irá exigir autenticação para acesso à interface do agente)
- allowed_hosts: relação dos hosts que poderão fazer requisições https ao agente. Deverá ser adicionado o IP do OpMon e o de loopback da máquina.
- community_string: token de acesso à api do NCPA(o padrão é: mytoken) .
- Por padrão, o NCPA vem com o suporte de plugins desenvolvidos nas seguintes linguagens:
- Linux: Shell Script, Python, Perl e PHP
- Windows: Powershell(.ps1), Visual Basic Script(.vbs), Windows Script File(.wsf) e executáveis em lotes(.bat).
3. Após as alterações no arquivo de configuração, reiniciar o serviço do NCPA e habilitá-lo para iniciar no boot do SO:
[root@OL9 ~]# systemctl restart ncpa [root@OL9 ~]# systemctl enable ncpa
4. Por fim, para testar o funcionamento do agente, execute os seguintes comandos:
Na máquina em que o agente foi instalado:
[root@OL9 ~]# curl -ks ‘https://127.0.0.1:5693/api?token=mytoken’
No servidor do OpMon:
[root@opmon ~]# curl -ks ‘https://<host>:5693/api?token=mytoken’ [root@opmon ~]# /usr/local/opmon/libexec/custom/check_ncpa.py -H <host> -p 5693 -t ‘<token>’ -M ‘cpu/percent’ -w 80 -c 90
5. Validada a instalação, os monitoramentos podem ser criados.