Backup e restauração

Há duas camadas:

• Versões da configuração dentro do banco de dados: rápidas, para desfazer uma alteração.
• Backups: arquivos completos do estado do roteador, mantidos no roteador e copiados para fora dele.

Versões da configuração

A configuração fica em /opt/dtvsol/data/dtvsol.db. Guarde uma versão nomeada antes de qualquer alteração importante:

dtvsol config save "before moving OLT 2"
dtvsol config status                  # the running configuration against the last version
dtvsol config versions                # the list (automatic ones are marked)
dtvsol config diff 14 running         # what changed since version 14
dtvsol config show 14                 # what version 14 holds

Restaure uma versão:

dtvsol config restore 14              # shows how many files would change
dtvsol config restore 14 --yes

A restauração informa a versão que ela substituiu, para que você possa voltar. Ela passa a valer quando aquilo que a usa roda de novo, por exemplo:

sudo systemctl restart dtvsol-vlans dtvsol-api isc-dhcp-server radvd

Edite um documento de configuração com segurança (JSON verificado, uma versão guardada antes):

dtvsol config docs                    # the documents and where each lives
dtvsol config edit plans

O backup diário

O dtvsol-backup.timer roda uma vez por dia. Ele:

1. Salva uma versão da configuração, se a configuração mudou.
2. Arquiva etc/, data/ (com uma cópia consistente do banco de dados), os logs de mapeamento do CGNAT e o machine id ao qual as senhas das OLTs estão vinculadas, como /opt/dtvsol/backups/dtvsol-<host>-<stamp>.tar.gz.
3. Mantém os últimos 14 arquivos no roteador (legíveis somente pelo root).
4. Se o backup externo estiver configurado, criptografa uma cópia com a sua chave pública OpenPGP e a envia por SSH.

dtvsol backup status        # last local and off-site backup, errors, next run
dtvsol backup list          # the archives on the router
dtvsol backup now           # run it now

A cópia externa criptografada

A cópia externa é criptografada no roteador com uma chave pública. A chave privada nunca passa pelo roteador, então uma cópia no servidor de backup não pode ser lida sem ela. A cópia é removida do roteador após o envio.

Configure-a em /opt/dtvsol/etc/config.php:

• backup_gpg_recipient: o fingerprint da sua chave pública OpenPGP. Importe a chave pública para o keyring de backup do roteador:

  sudo gpg --homedir /opt/dtvsol/data/backup-gnupg --import backup-public-key.asc

• backup_remote: user@host[:port] do servidor de backup. A chave SSH (id_ed25519) e o known_hosts para ele ficam em /opt/dtvsol/data/backup-ssh. Dê a essa conta acesso somente para envio.

Depois execute dtvsol backup now e verifique dtvsol backup status. Enquanto as duas configurações não estiverem presentes, o status informa que a cópia externa não está configurada.

Dica

Mantenha a chave privada offline e teste uma vez uma restauração a partir de uma cópia externa, em uma máquina reserva.

Um download avulso

Baixe um arquivo de etc/ e data/ pela API:

dtvsol backup /root/router-1-before-upgrade.tar.gz

Restaurar um arquivo

Restaure um arquivo que está no roteador. Tudo é reaplicado: DHCP, controle de banda, CGNAT, anti-spoofing e o resto.

dtvsol restore /root/router-1-before-upgrade.tar.gz

A resposta indica uma versão da configuração para a qual voltar se a restauração tiver sido um engano.

A partir de uma cópia externa: descriptografe-a com a sua chave privada na sua própria máquina, copie o arquivo para o roteador e restaure-o como acima.

Em um servidor novo

1. Instale o software do roteador no servidor novo.
2. Copie o arquivo para ele e execute dtvsol restore <file>.
3. Registre a licença para a nova máquina (dtvsol licence enrol …).
4. Execute dtvsol doctor.

Cuidado

As senhas das OLTs são criptografadas e vinculadas ao machine id guardado no backup. Se as OLTs não puderem ser alcançadas após uma mudança, defina as senhas delas novamente com dtvsol olt set <name> --pass ….

Backups da configuração das OLTs

As configurações das próprias OLTs têm backup separado, como um histórico que você pode comparar. Veja OLT.