Usando o recurso de backup/restauração do Painel de Controle

Introdução

Os recursos de Backup/Restaurar fornecidos pelo Painel de Controle permitem que você faça backup dos dados do seu portal e os restaure no ONLYOFFICE Workspace. Para acessar o Painel de Controle, faça login no seu portal e clique no ícone 'Painel de Controle' na Página Inicial. Alternativamente, você pode ir para 'Configurações' do portal e selecionar o link 'Painel de Controle' no painel lateral esquerdo.

Backup de dados

Para criar manualmente o backup dos dados do seu portal, vá para a página de Backup na seção CONFIGURAÇÕES COMUNS na barra lateral esquerda e use a seção Backup de Dados.

selecione o tipo e a localização necessários do Armazenamento para seus arquivos de backup:
- selecione a aba Temporário se desejar baixar o backup para o seu disco local quando o processo de backup terminar. Você poderá fazer isso usando o link que aparecerá abaixo.
- selecione a aba Módulo de Documentos e clique no botão Mais ao lado do campo que aparece abaixo. A janela Selecionar pasta será aberta. Defina uma pasta na seção Documentos Comuns onde deseja armazenar seu backup e clique no botão OK.
- selecione a aba Armazenamento de Terceiros, escolha um dos armazenamentos de terceiros disponíveis e insira os dados necessários para acessá-lo:
  1. O serviço necessário (Amazon AWS S3, Google Cloud Storage, Rackspace Cloud Storage, Selectel Cloud Storage, DropBox, Box.com, OneDrive, Google Drive) deve estar previamente conectado na seção Integração das configurações do portal. Caso contrário, os armazenamentos correspondentes estarão desativados e esmaecidos.
  2. A conta de terceiros (DropBox, Box.com, OneDrive, Google Drive, Yandex Disk e armazenamentos conectados via protocolo WebDAV, como Nextcloud ou ownCloud) deve estar previamente conectada ao módulo Documentos, além de ser compartilhada e colocada na seção Documentos Comuns. Caso contrário, os armazenamentos correspondentes estarão desativados e esmaecidos.
  Quando o armazenamento necessário for selecionado, especifique os dados para acessá-lo nos campos que aparecem abaixo:
  - Para o serviço Amazon AWS S3, os seguintes campos estão disponíveis:
    - Bucket - nome único do bucket da Amazon, por exemplo, meu-novo-bucket-teste-12345.
    - Região - uma região da AWS onde seu bucket da Amazon está localizado, por exemplo, us-east-2.
    - URL do Serviço - esta é uma propriedade opcional; altere-a apenas se quiser tentar um endpoint de serviço diferente. Deixe este campo vazio para usar o valor padrão.
    - Forçar Estilo de Caminho - quando verdadeiro, as solicitações sempre usarão o estilo de caminho. Deixe este campo vazio, pois a propriedade URL do Serviço não está especificada.
    - Usar Http - se esta propriedade estiver definida como verdadeiro, o cliente tentará usar o protocolo HTTP se o endpoint de destino o suportar. Por padrão, esta propriedade está definida como falso. Defina-a como verdadeiro ou deixe este campo vazio para usar o valor padrão.
    - Método de Criptografia no Lado do Servidor - o algoritmo de criptografia no lado do servidor usado ao armazenar este objeto no S3. Os valores possíveis são:
      - Nenhum
      - Criptografia no Lado do Servidor - SSE-S3 (seus ativos serão criptografados com chaves AES-256 GCM fortes, uma chave separada para cada objeto. As próprias chaves são criptografadas com uma chave raiz rotativa para proteção adicional) ou SSE-KMS (seus ativos serão criptografados com um mecanismo de criptografia versátil. Como o SSE-S3, ele se baseia em um método de criptografia AES-256 forte, mas oferece um modelo mais complexo e flexível, oferecendo permissões separadas para uma chave KMS, um recurso de trilha de auditoria e a capacidade de criar chaves personalizadas únicas). Para SSE-KMS, você pode escolher CMK Gerenciado - CMK gerenciado padrão da AWS ou CMK gerenciado pelo cliente. Quando a opção CMK gerenciado pelo cliente é selecionada, você precisa especificar o Id da Chave KMS.
      - Criptografia no Lado do Cliente - quando esta opção é selecionada, você precisa especificar o Id da Chave KMS.
  - Para o serviço Google Cloud Storage, o seguinte campo está disponível: Bucket (nome único do bucket do Google Cloud, por exemplo, teste_bucket111419).
  - Para o serviço Rackspace Cloud Storage, os seguintes campos estão disponíveis: Contêiner público (endereço URL do contêiner público do Rackspace), Contêiner privado (endereço URL do contêiner privado do Rackspace) e Região (uma região onde seus contêineres Rackspace estão localizados).
  - Para o serviço Selectel Cloud Storage, os seguintes campos estão disponíveis: Contêiner privado (nome do contêiner privado do Selectel, por exemplo, teste_contêiner) e Contêiner público (nome do contêiner público do Selectel, por exemplo, teste_contêiner_público).
  - Para os serviços DropBox, Box.com, OneDrive, Google Drive, Yandex Disk ou armazenamentos conectados via o protocolo WebDAV, clique no botão Mais ao lado do campo que aparece abaixo. A janela Selecionar pasta será aberta. Defina um diretório de recurso de terceiros localizado na seção Documentos Comuns onde deseja armazenar seu backup e clique no botão OK.
- selecione a aba Arquivo do Computador se desejar salvar o backup no seu disco local. No campo Escolha o local de armazenamento que aparece abaixo, especifique o caminho para a pasta onde deseja armazenar seu backup.
Se você selecionar o Módulo de Documentos ou um dos serviços de terceiros conectados a ele (DropBox, Box.com, OneDrive, Google Drive, Yandex Disk e armazenamentos conectados via o protocolo WebDAV), o tamanho do arquivo de backup afeta o espaço total em disco usado no seu portal.
marque a caixa Incluir Email no backup se você quiser fazer backup dos dados de Email também. Isso aumenta o tempo do processo de backup e o tamanho do arquivo de backup, mas se esta opção não estiver marcada, os dados de Email serão perdidos após a restauração, e você precisará conectar as contas novamente. Consulte a seção Backup de dados de Email para encontrar instruções adicionais para Email.
Os dados da licença não serão incluídos no backup. Após restaurar o backup, você precisará carregar seu arquivo de licença novamente.
clique no botão FAZER BACKUP.

Uma vez que o processo de backup for concluído, você encontrará o arquivo de backup .tar.gz (nome-do-portal_data_hora.tar.gz) na pasta especificada. Se você selecionou o armazenamento Temporário, o link para baixar o backup criado estará disponível por 24 horas.

Quando a criptografia está habilitada, uma nova cópia de backup do arquivo de dados conterá arquivos descriptografados. Quando tal cópia é restaurada, os arquivos serão criptografados novamente no disco.

Backup de dados de Email

Realize ações adicionais para fazer backup dos dados de Email.

Esta instrução não funciona para a versão Windows.

Entre no contêiner do Community Server:

docker exec -it onlyoffice-community-server bash

Vá para a pasta de serviços:

cd /var/www/onlyoffice/Services/TeamLabSvc

Abra o arquivo de configuração:
```
nano TeamLabSvc.exe.config
```
Adicione configurações para acesso à máquina host:
```
<backup>
  <mailServer pathToMailFilesOnHost="/app/onlyoffice/MailServer/data" hostAddress="127.0.0.1" hostUsername="root" hostKey="/tmp/key.pem" />
</backup>
```
- pathToMailFilesOnHost - o caminho completo para os arquivos do Mail Server. Para Linux, você pode especificar o seguinte caminho: /app/onlyoffice/MailServer/data.</li>
- hostAddress - o endereço da máquina onde o contêiner do Mail Server está localizado.
- hostUsername - o nome de usuário para conectar à máquina onde o contêiner do Mail Server está localizado.
- hostPassword - a senha para conectar à máquina onde o contêiner do Mail Server está localizado.
- hostKey - o caminho para o arquivo com o certificado SSH do usuário para conectar à máquina onde o contêiner do Mail Server está localizado. O arquivo deve estar no formato OpenSSH, podendo ser gerado com o Putty Key Generator.
ImportanteO campo hostPassword ou hostKey deve ser preenchido. Se ambos os campos forem preenchidos, a conexão será realizada usando a chave primeiro, se não for bem-sucedida, a senha será utilizada.

ImportanteO usuário (hostUsername) especificado nas configurações deve ter direitos para ler e escrever na pasta com os arquivos do Mail Server (pathToMailFilesOnHost). Para máquinas Linux, você pode executar o seguinte comando: chmod -R 755 /app/onlyoffice/MailServer/data.
Salve o arquivo (Ctrl+S) e saia (Ctrl+X).
Reinicie o serviço:
```
systemctl restart onlyofficeBackup
```
Vá para a seção Restauração de dados para restaurar dados do arquivo de backup.

Backup automático

Para automatizar o processo de backup, acesse a página Backup na seção CONFIGURAÇÕES COMUNS na barra lateral esquerda e use a seção Backup automático:

clique no alternador Desativado para habilitar o recurso.
selecione o Armazenamento necessário para seus arquivos de backup (as opções disponíveis são as mesmas descritas acima, exceto pelo armazenamento Temporário, que está disponível apenas na seção Backup de Dados).
especifique o intervalo de tempo em que os backups devem ser criados: Todo dia com indicação do horário necessário, Toda semana com indicação do dia da semana e horário necessários, ou Todo mês com indicação do dia do mês e horário necessários.
defina O número máximo de cópias de backup a serem armazenadas selecionando o valor necessário (de 1 a 30) na lista suspensa correspondente.
marque a caixa Incluir Email no backup se desejar fazer backup dos dados de Email também.
clique no botão SALVAR.

Os backups serão criados automaticamente com a periodicidade especificada.

Restauração de dados

Devido ao novo mecanismo de criptografia de senhas, não é possível restaurar a senha do backup usando a chave core.machinekey, que difere da original. Para garantir o funcionamento correto do portal, especifique a chave do servidor antigo nos arquivos web.appsettings.config, TeamlabSvc.exe.Config e no arquivo de configuração production.json do Painel de Controle antes de restaurar o backup em um novo servidor.

Para a versão Docker, você pode substituir machinekey aqui /app/onlyoffice/CommunityServer/data/.private/machinekey e reiniciar o contêiner do Community Server. Também é possível usar o parâmetro mk no script de instalação para especificar o machinekey ao instalar o ONLYOFFICE Workspace. Por exemplo, bash workspace-enterprise-install.sh -mk yourmachinekey ou bash workspace-install.sh -mk yourmachinekey.

Para restaurar os dados do seu portal a partir do arquivo de backup criado anteriormente, acesse a página Restaurar na seção CONFIGURAÇÕES COMUNS na barra lateral esquerda.

selecione a Fonte onde seus arquivos de backup estão armazenados:
- selecione a aba Módulo de Documentos e clique no botão Mais abaixo. Na janela Selecionar arquivo, escolha o arquivo de backup necessário armazenado em Documentos Comuns e clique em OK.
- selecione a aba Armazenamento de Terceiros, escolha o armazenamento de terceiros necessário e insira os dados para acessá-lo, bem como o endereço URL do arquivo de backup necessário no campo Caminho.
  Para contas conectadas ao módulo Documentos (DropBox, Box.com, OneDrive, Google Drive, Yandex Disk e armazenamentos conectados via protocolo WebDAV), clique no botão Mais abaixo. Na janela Selecionar arquivo, escolha o arquivo de backup necessário armazenado no diretório de recursos de terceiros localizado na seção Documentos Comuns e clique em OK.
- selecione a aba Arquivo do computador, clique no botão Mais ao lado do campo Escolha o local de armazenamento e procure o arquivo de backup necessário armazenado em seu disco local.
  Em vez de selecionar um arquivo de backup de uma certa Fonte, você pode simplesmente clicar no link Mostrar a lista de backups abaixo dos botões de rádio para selecionar o arquivo de backup necessário do histórico de backups (se um arquivo de backup foi excluído manualmente do armazenamento, ele não estará disponível na lista). Clique no link Restaurar ao lado do arquivo de backup necessário. Para excluir um arquivo de backup da lista, clique no ícone .
se necessário, deixe a caixa Enviar notificação sobre o processo de restauração do portal para os usuários marcada para notificar seus usuários do portal;
clique no botão RESTAURAR.
Lembre-se de que você precisará enviar seu arquivo de licença novamente quando o processo de restauração for concluído. Isso pode ser feito na seção Pagamentos.

Se você criar um arquivo de backup na versão em nuvem e depois restaurá-lo na versão de servidor, as senhas atuais serão redefinidas, e o acesso só poderá ser restaurado através do link Esqueceu sua senha? na página de autorização.