Migração de Tenants

[warning]

Disponível para o perfil: Superadministrador

A página de Migração de Dados permite a transferência de informações de uma instância externa (remota) para o servidor atual. O processo é registrado em tempo real, permitindo o acompanhamento do progresso e de eventuais interrupções.

Aviso: A migração importa dados do sistema de origem. Verifique se as configurações estão corretas antes de iniciar o procedimento.

1. Acessando a Página de Migração

Para acessar as configurações de migração, utilize o menu lateral do painel SuperAdmin:

  1. Clique no menu Sistema;
  2. Selecione a aba Migração de Dados.

2. Monitoramento de Status

O topo da página apresenta três indicadores sobre o estado das operações:

  • Concluídas: Quantidade de migrações finalizadas com sucesso;
  • Em Andamento: Migrações que estão sendo processadas no momento;
  • Falhou: Registro de migrações que apresentaram erro crítico.

Resumo quantitativo das migrações realizadas.

3. Configuração da Conexão Remota

Para que o sistema acesse os dados de origem, é necessário configurar o caminho de comunicação:

Configuração SSH

Caso o banco de dados remoto esteja em um servidor diferente, preencha os campos da seção Configuração SSH:

  • Host SSH: Endereço IP do servidor de origem;
  • Porta SSH: Porta de conexão (padrão 22);
  • Usuário SSH e Senha SSH: Credenciais de acesso ao servidor;
  • Caminho da chave SSH: Localização dos arquivos de chave privada para autenticação.

Banco de Dados Remoto

Informe os dados da instância de origem dos dados:

  • Host e Porta: Endereço do banco e porta (ex: 5432 para Postgres);
  • Nome do banco e Usuário: Identificação da base de dados e usuário com permissão de leitura;
  • Senha: Senha de acesso ao banco de dados remoto;
  • Dialeto: Tipo de banco de dados utilizado (ex: postgres);
  • ID do tenant na instância remota: Identificador numérico do cliente a ser migrado.

4. Execução da Migração

  1. Após preencher os campos, clique em "Salvar Config" para registrar os parâmetros localmente;
  2. Clique no botão "Iniciar Migração" no canto superior direito;
  3. Acompanhe a evolução na tabela Migrações.

Comandos da Listagem:

  • Progresso: Barra indicando a porcentagem de conclusão e a etapa atual (ex: TenantApi);
  • Logs Disponíveis: Contador de registros processados (ex: 10409 / 10412);
  • Ações: \ Clique no *ícone de Play (Retomar) caso uma migração apresente o status "Pausada";
    • Clique no ícone de olho para abrir os Detalhes da Migração.

5. Detalhes da Migração

Ao abrir os detalhes de uma migração, o sistema exibe o status específico de cada módulo migrado e os logs técnicos da operação.

Módulos Migrados (Seção Concluída)

Nesta área, o sistema lista todas as entidades que foram processadas, incluindo:

  • Configurações e Usuários: Setting, User, Login;
  • Comunicação: WhatsApp, Message, ChatFlow, AutoReply;
  • Organização: Kanban, Pipeline, Tag, Ticket, Contact;
  • Financeiro e Licença: Plans, License, LicenseActivationLog.

Logs de Erro

Caso ocorram inconsistências, utilize os botões para download de logs específicos:

  • fk\_violations: Violações de chaves estrangeiras;
  • import\_errors: Erros na inserção dos dados na nova instância;
  • download\_errors: Falhas no download de mídias da instância remota.

6. Verificação de Problemas

Caso a migração não seja concluída, verifique os seguintes itens:

  • Conexão com Banco: Valide se o host, porta e credenciais de usuário/senha estão corretos;
  • Configuração de SSH: Em caso de erro de SSH, confirme o host e a chave privada do servidor;
  • Status Pausado: Em caso de oscilação na rede, utilize o botão "Retomar" após a estabilização do ambiente.

results matching ""

    No results matching ""