Roteiro: Restauração de backup¶
Perfil necessário: admin Menus usados: Sistema (Backups) Risco: alto (restauração errada sobrescreve dados operacionais) Rollback: N/A — a restauração É o rollback. Sempre gere um backup novo antes de restaurar.
Pré-requisitos¶
- [ ] Backup alvo gerado e baixado (ver system-backups)
- [ ] Janela de manutenção acordada (restauração derruba consistência durante o processo)
- [ ] Dump do estado atual gerado ANTES da restauração (ponto de retorno)
Passo a passo¶
1. Gerar backup de segurança do estado atual¶

Sistema → Backups → [Gerar backup] — baixe e guarde este arquivo. É seu ponto de retorno se a restauração trouxê-los para um estado pior.
2. Baixar o backup alvo¶
Na listagem: [⬇] do arquivo alvo. O tar inclui os 2 bancos + SHA-256.
3. Validar integridade¶
sha256sum -c checksums.sha256 # dentro do tar
4. Restaurar¶
A restauração é operação de DBA/host (não há botão na UI):
# extrair
tar -xf backup-<data>.tar.gz
# importar dumps (exemplo MariaDB local)
mariadb -u root -p iproute_sw < iproute_sw.sql
mariadb -u root -p iproute_sw_core < iproute_sw_core.sql
5. Recarregar tudo¶
Após restaurar: Sistema → OpenSIPS → [Recarregar todos os módulos] (a memória do OpenSIPS precisa refletir o banco restaurado).
6. Validar¶
- [ ] Login funciona; dados-chave presentes (Clientes/Planos/Rotas contagens coerentes)
- [ ] Chamada de teste sai e completa (CDR gerado)
- [ ] Comparar contagem de linhas de tabelas críticas com o esperado
Erros comuns¶
| Sintoma | Causa probável | Correção |
|---|---|---|
| SHA diverge | download corrompido | baixar de novo |
| FK/duplicate no import | ordem de import errada | importar core depois app conforme ordem do tar |
| OpenSIPS com dados velhos | reload pendente | Recarregar todos os módulos |
Impacto operacional¶
- Restaurar é destrutivo: SEMPRE gere o backup do estado atual primeiro (passo 1).
- Valide com chamada e contagens — restauração "que aparenta funcionar" com dados faltando é pior que não restaurar.