Manual de Instalação (Cliente)

Este guia descreve como instalar a IPv0 OLT API em seu servidor Linux.

Pré-requisitos

Linux (Ubuntu 20.04+, Debian 11+, CentOS 8+)
Python 3.8 ou superior
Acesso root/sudo

1. Instalação Automática

Transfira o arquivo ipv0-olt-api.zip para o servidor (ex: /opt).

Descompacte o arquivo:

unzip ipv0-olt-api.zip -d /opt/ipv0-olt-api
cd /opt/ipv0-olt-api

Execute o script de instalação como root:
```
sudo ./install.sh
```
- Este script instalará as dependências e configurará o serviço.
- Atenção: Ao final, ele exibirá o Machine ID. Copie este código para solicitar sua licença.

2. Ativação da Licença e Início do Serviço

A aplicação não iniciará sem uma licença válida.

Envie o Machine ID para o suporte.
Você receberá um arquivo de licença chamado license.key.

Copie este arquivo para a pasta da aplicação e INICIE o serviço:

# Copiar a licença
sudo cp license.key /opt/ipv0-olt-api/
sudo chown root:root /opt/ipv0-olt-api/license.key

# Habilitar e Iniciar o serviço agora:
sudo systemctl enable --now ipv0-olt-api

3. Configuração (hosts.json)

Renomeie o arquivo hosts.example.json para hosts.json e edite-o para adicionar suas OLTs. Caminho: /opt/ipv0-olt-api/hosts.json

Exemplo Completo:

{
    "10.155.156.2": {
        "username": "zabbix",
        "password": "p4ssw0rd",
        "driver": "nokia",
        "snmp_community": "public",
        "port": 22,
        "ssh_options": {
            "disabled_algorithms": {
                "pubkeys": [
                    "rsa-sha2-256",
                    "rsa-sha2-512"
                ]
            }
        }
    },
    "192.168.1.10": {
        "username": "admin",
        "password": "simple_password",
        "driver": "fiberhome",
        "port": 23
    }
}

Após editar, reinicie o serviço.

4. Diagnóstico e Debug

A API inclui uma ferramenta de diagnóstico. Para verificar status, licença e conexão:

cd /opt/ipv0-olt-api
sudo ./venv/bin/python3 debug.py

Comandos Úteis

Ver logs: sudo journalctl -u ipv0-olt-api -f
** Status do Serviço:** sudo systemctl status ipv0-olt-api
Testar API: curl http://localhost:5050/health

2.4 KiB Raw Permalink Blame History