For the complete documentation index, see llms.txt. This page is also available as Markdown.

Migração de Tenants

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.


Atualizado

Isto foi útil?