Migração de Tenants
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:
Clique no menu Sistema;
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
Após preencher os campos, clique em "Salvar Config" para registrar os parâmetros localmente;
Clique no botão "Iniciar Migração" no canto superior direito;
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.
Atualizado
Isto foi útil?

