Roteiro: Gerar, baixar e excluir backups do banco¶
Perfil necessário: admin (página restrita a admin)
Menus usados: Sistema
Risco: médio — backup é sua rede de segurança antes de qualquer mudança estrutural; excluir o único backup recente remove a rede
Rollback: não aplicável (a operação é sobre os próprios arquivos de backup; para reverter o banco, restaure o .tar.gz via mysql)
Pré-requisitos¶
- [ ]
mysqldumpdisponível no host do backend (senão a geração falha com "Comando mysqldump não encontrado") - [ ] Espaço em disco no diretório de backups configurado (
backup_dirdo backend) - [ ] Saber que a retenção automática mantém os
backup_retentionarquivos mais recentes — gerar pode excluir os mais antigos
O que o backup contém¶
Cada arquivo iproute_sw_AAAAMMDD_HHMMSS_<usuario>.tar.gz traz os dumps dos dois bancos do produto (core e aplicação, ex.: iproute_sw_core.sql e iproute_sw.sql), gerados com --single-transaction --routines --events --triggers, mais um manifest.json (data, autor, bancos incluídos). A listagem mostra SHA-256 de integridade (hash completo no tooltip).
Quando gerar¶
- Antes de rodar migrations ou edits manuais de schema (
mysqldireto) - Antes de operações em massa via UI (import de carriers, sync grande de perfis, exclusões em lote)
- Antes de updates de deploy (
scripts/update_sw.shaplica migrations com tracking — backup antes é barato) - Rotina periódica acordada com a operação (ex.: diária antes da janela de manutenção)
Passo a passo¶
1. Abrir a página¶
Caminho: Plataforma → Sistema → Backups

A listagem mostra: Arquivo, Criado por, Data, Tamanho e SHA-256 (abreviado).
2. Gerar o backup¶
Clique: [Gerar backup]
Resultado esperado: toast "Backup criado com sucesso" e o novo .tar.gz no topo da listagem (ordenado por data, mais recente primeiro). Se a retenção excluir arquivos antigos, o log de auditoria registra deleted_by_retention.
3. Baixar uma cópia¶
Clique: botão [Baixar] (ícone de download na linha)
Resultado esperado: download do arquivo no navegador (toast "Download iniciado"). O header da resposta traz X-Backup-Sha256 para conferir a integridade fora do painel. Download e exclusão ficam registrados na auditoria de admin.
4. Excluir um backup¶
Clique: botão [Excluir] (ícone de lixeira na linha)
Resultado esperado: diálogo de confirmação Excluir backup "<arquivo>"? — confirme e o arquivo (e seu .meta.json) desaparece da listagem.
Validação¶
- [ ] Visual: arquivo novo no topo da tabela com tamanho coerente (não 0 B)
- [ ] Funcional:
sha256sum <arquivo>no host bate com o SHA-256 exibido; tar contém os dois dumps (tar -tzf iproute_sw_*.tar.gz)
Erros comuns¶
| Sintoma | Causa provável | Correção |
|---|---|---|
| "Comando mysqldump não encontrado no sistema" | mysqldump ausente no host do backend | instalar client MariaDB/MySQL no host |
| Falha ao gerar backup (500) | credenciais/permissões de DB ou espaço em disco | ver detalhe do erro no toast/log do backend |
| Backup antigo sumiu da listagem | retenção automática (backup_retention) |
aumentar retenção na config do backend ou copiar fora antes |
| Botão de backup desabilitado/403 | usuário não-admin | operar com perfil admin |
Tabela de referência rápida¶
| Ação | Botão | Efeito |
|---|---|---|
| Gerar dump dos 2 bancos + manifest | [Gerar backup] | cria iproute_sw_<ts>_<user>.tar.gz + meta (sha256) |
| Baixar | ícone de download na linha | download com X-Backup-Sha256 |
| Excluir | ícone de lixeira na linha | remove arquivo + meta (com confirmação) |