Pular para o conteúdo principal
Caminho no painel: menu da esquerda > Configuração > cartão Painel de Controle > Importar/Exportar as Configurações Tela de importação e exportação, com o botão Download e as seis caixas de escopo de importação

​
Exportar

Em Criar arquivo de exportação, clique em Download. Conferido: o arquivo é JSON legível, chamado keyhelp_settings_<data>.json. Nesta instalação saiu com 258 KB, e a maior parte disso, 162 KB, são as imagens do White Label, gravadas dentro do próprio arquivo. O conteúdo tem seis partes:
O arquivo de exportação carrega as chaves de API para dentroConferido abrindo o arquivo: a parte databases traz a linha de cada chave de API, com o nome, os IPs autorizados, as datas e o resumo criptográfico da chave. O segredo em si não vai (ele não existe em lugar nenhum depois de criado), mas o resumo vai, e importar esse arquivo em outro servidor faz a chave antiga passar a valer lá.Some com isso: o arquivo exportado tem o mesmo valor de um cofre de acesso, e merece o mesmo cuidado. Não é anexo de e-mail, não é arquivo de pasta compartilhada aberta, e não sobra em pasta de downloads.
A senha da interface do Rspamd também está lá dentroConferido procurando por nome de campo no arquivo: existe um email.rspamd_web_ui_password, com 126 caracteres, dentro de settings. É a senha da interface web do filtro de spam, e ela sai no arquivo mesmo com o escopo de importação não citando o assunto em lugar nenhum.Duas coisas seguem daí: o arquivo carrega mais do que as seis caixas de escopo sugerem, e quem o receber tem em mãos credencial de um serviço do servidor.
Também vai para dentro do arquivo o que identifica o servidor: nome de host, endereço do painel, IPs de DNS e o endereço de e-mail do sistema. A chave de licença não vai. Conferido: procurando por nome de campo no arquivo inteiro, não existe nenhum campo de licença. Faz sentido, porque a licença é amarrada ao hardware daquele servidor.
Com SMTP externo, trate o arquivo como se a senha dele estivesse láA própria tela diz que o endereço de remetente só é importado se o arquivo contiver configurações de SMTP personalizadas: essas configurações viajam no arquivo, na parte smtp, e a senha do servidor externo pode ir junto.

​
Importar

  1. Clique em Escolher arquivo e selecione um arquivo exportado.
  2. Marque, em Escopo de importação, o que você quer trazer.
  3. Clique em Iniciar processo de importação.
O escopo tem seis caixas, e Selecionar todos marca todas de uma vez:
A importação substitui, não soma, e apaga em silêncio o que não estiver no arquivoMedido, em três passos: exportei o servidor, depois criei uma chave de API nova, e então importei aquele arquivo antigo com o escopo Configurações de API marcado. A chave criada depois da exportação sumiu. Sobrou a que estava no arquivo, com o mesmo identificador e as mesmas datas.E o histórico não conta isso. O painel registrou a criação da chave e registrou que as configurações de API foram importadas, e não registrou a exclusão. Quem for procurar depois por que a integração parou não acha o motivo no histórico.Um escopo marcado por engano troca a configuração daquele assunto inteiro. Vale exportar o servidor de destino antes de importar qualquer coisa nele, porque esse arquivo é o único caminho de volta que este painel oferece.
O aviso sobre confiar na origem do arquivo é literalA tela avisa para importar somente arquivos de fontes em que você confia. O motivo fica claro pelo conteúdo: um arquivo preparado por outra pessoa pode trazer chave de API e identidade visual para dentro do seu servidor. Uma chave de API importada é acesso de programa ao servidor inteiro.

​
A regra da versão

A tela avisa que o arquivo só pode ser importado num painel da mesma versão que o gerou. É por isso que meta guarda a versão. Conferido: com o número de versão trocado dentro do arquivo, a importação foi recusada com a mensagem de que o arquivo carregado não é compatível com o sistema de importação, e nada foi alterado. A checagem é de verdade, e não um aviso de tela. Na prática isso muda a ordem do trabalho numa migração: atualizar os dois servidores para a mesma versão antes de exportar, e não exportar de um servidor velho para importar num novo.

​
O que não vai no arquivo

Vale dizer o que a tela não promete, porque o nome sugere mais do que ela faz:
  • contas de cliente, domínios, e-mails, bancos de dados e arquivos de site
  • certificados de SSL/TLS
  • as versões do PHP instaladas
  • as tarefas agendadas
Isso é configuração do painel, não conteúdo do servidor. Mover um servidor inteiro é outro assunto.

​
O que pode dar errado

​
Ver também