> ## Documentation Index
> Fetch the complete documentation index at: https://docs.saninternet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Backup

> Guarda cópias do servidor, do painel e das contas de clientes em repositórios, e traz de volta arquivos, bancos de dados e e-mails de uma dessas cópias.

**Caminho no painel:** menu da esquerda > **CONFIGURAÇÕES** > **Backup**

A tela explica que o backup é feito pelo Restic, um programa de backup livre:
*"Para gerenciar repositórios de backup é usado o Restic - um software de backup
poderoso, moderno, seguro, leve e gratuito."*

## Três palavras que a tela usa

| Palavra | O que é |
| - | - |
| **Repositório** | o lugar onde as cópias ficam: uma pasta do próprio servidor ou um serviço de armazenamento remoto. É sempre protegido por uma senha |
| **Snapshot** | uma cópia, tirada num momento. Cada backup cria um snapshot novo dentro do repositório |
| **Operação** | cada pedido feito nesta área: criar um backup, restaurar, verificar, apagar snapshots. O painel põe o pedido numa fila e o executa em segundo plano |

## Recursos do backup

![Cartão Recursos do backup: Criar backup, Agendar backups regulares, Restaurar backup, Gerenciamento de repositório e Solução de problemas](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/backup-recursos.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=c38cb880ee40d1a18827baf806b1dcf7)

| Botão | Artigo |
| - | - |
| **Criar backup** | [Criar um backup](/keyhelp-admin/criar-backup) |
| **Agendar backups regulares** | [Agendar backups regulares](/keyhelp-admin/agendar-backups-regulares) |
| **Restaurar backup** | [Restaurar um backup](/keyhelp-admin/restaurar-backup) |
| **Gerenciamento de repositório** | [Gerenciamento de repositório](/keyhelp-admin/gerenciamento-de-repositorio) |
| **Solução de problemas** | [Solução de problemas](/keyhelp-admin/solucao-de-problemas) |

**O uso começa pelo repositório.** A tela avisa: *"Para criar um
backup, você deve primeiro configurar pelo menos um repositório, que pode estar
localizado no servidor local ou remoto."* O primeiro passo é
[Adicionar um repositório](/keyhelp-admin/adicionar-repositorio).

## Como o painel executa um pedido

| Estado na lista **Últimos eventos** | Quando |
| - | - |
| **Inicia em breve** | logo depois do pedido |
| **Em andamento** | a partir da virada do minuto seguinte, quando o painel começa a executá-lo |
| **Concluído**, **Concluído (com problemas)** ou **Cancelado** | no fim |

**Concluído (com problemas)** quer dizer que a operação terminou, e parte dela
falhou: a linha ganha um triângulo âmbar e o link **Mensagens**. Medido com a
restauração de um banco como `.sql` para uma pasta que não podia ser criada: o
banco não foi restaurado, e a operação terminou assim, e não como **Cancelado**.

**Depois de cada backup, o painel roda sozinho uma verificação**, que aparece na
lista como **Verificação de integridade / Sincronização de dados**. É ela que
atualiza a lista de snapshots e o tamanho do repositório.

Medido: pedidos feitos em sequência para o mesmo repositório rodaram um depois do
outro, dentro do mesmo minuto.

## Últimos eventos

![Cartão Últimos eventos: uma restauração Concluído (com problemas), com o link Mensagens marcado, verificações, exclusão de snapshots e um backup concluído](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/backup-eventos.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=d36c85e3f1bbe8831e8bcc0228857dc0)

A lista mostra as operações de todos os repositórios, da mais nova para a mais
antiga.

| Coluna | O que mostra |
| - | - |
| **INICIADO EM** | a hora em que o pedido foi feito. O mouse parado em cima mostra **Iniciado em**, **Finalizado em** e **Duração** |
| **OPERAÇÃO** | o que foi feito. O backup de um agendamento ganha **(Backup agendado)** ao lado. Na verificação, uma seta e um tamanho dizem quanto o repositório cresceu (seta vermelha, para cima) ou diminuiu (seta verde, para baixo) |
| **STATUS** | **Inicia em breve**, **Em andamento**, **Concluído**, **Concluído (com problemas)** ou **Cancelado** |
| **MENSAGENS** | o link **Mensagens**, marcado na imagem, quando a operação registrou problema |
| **DESCRIÇÃO** | o texto escrito ao pedir o backup |
| **REPOSITÓRIO** | onde a operação aconteceu. O nome leva à edição do repositório |

As operações que aparecem na coluna **OPERAÇÃO**:

| Operação | De onde vem |
| - | - |
| **Criar backup** | [Criar um backup](/keyhelp-admin/criar-backup), ou um agendamento |
| **Restaurar backup** | [Restaurar um backup](/keyhelp-admin/restaurar-backup) |
| **Verificação de integridade / Sincronização de dados** | depois de cada backup, e pelo ícone de sincronizar da [lista de repositórios](/keyhelp-admin/gerenciamento-de-repositorio) |
| **Deletar snapshots** | a exclusão de snapshots, na tela de restaurar |
| **Eliminar repositório** | a rotação de snapshots, explicada logo abaixo |
| **Desbloquear repositório** | [Solução de problemas](/keyhelp-admin/solucao-de-problemas) |

> [!NOTE]
>
> **"Eliminar repositório" não apaga o repositório**
>
> É o nome que a lista dá à limpeza da rotação de snapshots, que apaga os
> snapshots mais antigos. Medido: com rotação ligada, ela apareceu depois de cada
> backup e depois de salvar a rotação, e o repositório continuou lá, com os
> snapshots mais novos. A rotação está em
> [Adicionar um repositório](/keyhelp-admin/adicionar-repositorio).

### Mensagens

![Janela Mensagens: As seguintes mensagens foram registradas, e a mensagem da operação, em inglês](https://mintcdn.com/san-internet/dZE3NBY61yDby7Jw/keyhelp-admin/imagens/backup-mensagens.png?fit=max\&auto=format\&n=dZE3NBY61yDby7Jw\&q=85\&s=4f7a8f9045eca86dfc646957b0314531)

O link abre uma janela com o que a operação registrou. **A mensagem vem em
inglês, sem tradução.** Na imagem, a da restauração de banco descrita acima:
*"Databases which could not get restored: roundcube"*. Num backup cancelado
porque a pasta do repositório não existia mais, a mensagem foi a do programa de
backup: *"repository does not exist"*.

## O que pode dar errado

| Sintoma | Causa | O que fazer |
| - | - | - |
| **Um backup aparece como Cancelado** | a operação encontrou um erro, como um repositório que não se consegue abrir | abrir **Mensagens** na linha, e ver [Gerenciamento de repositório](/keyhelp-admin/gerenciamento-de-repositorio) |
| **Uma operação aparece como Concluído (com problemas)** | ela terminou, e parte dela falhou | abrir **Mensagens** na linha, para ver o que ficou de fora |
| **Apareceu "Eliminar repositório" na lista** | é a limpeza da rotação de snapshots | nada: o repositório continua |
| Um pedido continua em **Inicia em breve** muito depois do minuto seguinte | a tela de [Solução de problemas](/keyhelp-admin/solucao-de-problemas) cita repositório travado como causa | seguir aquele artigo |
| Os eventos de um repositório sumiram da lista | o repositório foi excluído, e a exclusão leva os eventos dele | ver [Gerenciamento de repositório](/keyhelp-admin/gerenciamento-de-repositorio) |

## Ver também

* [Backup (configuração)](/keyhelp-admin/config-backup), os ajustes do backup: repositórios dos clientes, núcleos do processador e o sistema antigo
* [Notificações](/keyhelp-admin/notificacoes), onde fica o texto do aviso por e-mail


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.