Instalação

O instalador é o install.sh. Ele é idempotente: você pode executá-lo novamente depois de uma atualização para renovar as units, os timers e os pacotes.

1. Coloque o software em /opt/dtvsol

A partir de um tarball de release:

sudo mkdir -p /opt/dtvsol
sudo tar xzf dtvsol-router-<rev>.tar.gz -C /opt/dtvsol

Ou a partir do repositório ao qual você recebeu acesso:

sudo git clone <repository-url> /opt/dtvsol

Copie os binários licenciados que você recebeu para /opt/dtvsol/bin/: o dtvsold e o driver de OLT dtvsol-olt-<vendor>.

2. Execute o instalador

cd /opt/dtvsol
sudo ./install.sh

Se o servidor ainda não tiver um endereço IPv4 com rota padrão, o instalador lista as portas (nome, MAC, link) e pergunta a interface, o endereço, o gateway e os servidores DNS. Você também pode informá-los na linha de comando:

sudo ./install.sh --iface eno1 --ip XXX.XXX.XXX.10/24 --gw XXX.XXX.XXX.1 --dns XXX.XXX.XXX.53,XXX.XXX.XXX.54

Em seguida, o instalador:

1. Instala os pacotes do Ubuntu.
2. Coloca os arquivos em /opt/dtvsol e põe o dtvsol no PATH.
3. Ativa o encaminhamento (forwarding) IPv4 e IPv6 e carrega os módulos de kernel 8021q e ifb.
4. Grava uma configuração DHCP básica (somente se não existir nenhuma).
5. Instala as units do systemd, os timers, os jobs do cron, o filtro e a jail do fail2ban e a completação por Tab do dtvsol.
6. Gera uma chave de API aleatória e a exibe uma única vez. Guarde-a: o seu sistema de cobrança precisa dela.
7. Cria o usuário de sistema dtvsol (um login com sudo para os operadores).
8. Move a configuração para o banco de dados data/dtvsol.db, armazena a configuração de rede do próprio roteador e inicia os serviços.
9. Configura o chrony para que o roteador possa fornecer a hora às suas OLTs.

No final, ele mostra os próximos passos.

3. Proteja o equipamento

Cuidado

Faça isto antes de o roteador entrar em produção.

Defina a sua própria senha para o usuário dtvsol:

sudo passwd dtvsol

Adicione as suas redes de gerência ao ignoreip do fail2ban, para que um operador que digite a senha errada não seja bloqueado:

sudo nano /etc/fail2ban/jail.d/dtvsol.conf
sudo systemctl restart fail2ban

Permita que o seu NOC acesse a API (porta 8880) e o monitor (porta 8881). Somente o localhost é permitido até você adicionar uma rede:

dtvsol protect add XXX.XXX.XXX.0/24 "NOC"
dtvsol protect list

4. Registre a licença

Use o id de roteador e o token que a DTVSOL lhe forneceu. Informe o token como - para digitá-lo, em vez de deixá-lo no histórico do shell:

dtvsol licence enrol <router-id> -
dtvsol licence status

A licença é renovada por um timer diário. Veja Solução de problemas se ela informar algum problema.

5. Verifique a configuração de rede

O roteador guarda a sua própria rede (portas, bonds, seus endereços, a rota padrão e o DNS) no banco de dados e gera o arquivo do netplan a partir dela. O instalador armazenou o que encontrou. Verifique:

dtvsol netcfg show
dtvsol netcfg diff

Se o servidor já tinha uma rede configurada à mão, importe-a uma vez:

dtvsol netcfg import          # shows what would be stored, key by key
dtvsol netcfg import --save

Veja Alterações de rede antes de alterar qualquer coisa aqui.

6. Crie o primeiro usuário do monitor

O primeiro usuário deve ser um admin. A senha é pedida duas vezes:

dtvsol monitor user add alice admin
dtvsol monitor

O dtvsol monitor mostra o endereço a abrir, por exemplo https://XXX.XXX.XXX.10:8881/. O certificado é autoassinado: aceite-o uma vez no navegador. Veja o monitor.

7. Configurações opcionais

Se o seu sistema de cobrança provisiona roteadores MikroTik, defina o login do MK-api. O instalador criou uma senha aleatória e a mostrou uma vez no final; para definir a sua:

dtvsol mkapi set user billing password '<a-strong-password>'

Se você monitora com um NMS via SNMP:

dtvsol snmp set community '<secret>' location "POP 1" contact "noc@example.net"

8. Verifique o resultado

dtvsol version
dtvsol doctor --no-olt

O dtvsol doctor não deve informar achados críticos. Continue com Primeiros passos.

Atualização

Substitua os arquivos em /opt/dtvsol pelo novo release (ou git pull) e execute o instalador novamente:

cd /opt/dtvsol
sudo ./install.sh

A sua configuração em data/ e os seus logs em log/ são mantidos.