Migração de Tenants
Disponibilizado na versão v3.1.4.7
A partir da versão 3.1.4.7, o Z-PRO possui uma ferramenta nativa no painel do Superadmin que permite importar empresas (tenants) de um servidor antigo (Origem) para o seu servidor atual (Destino) de forma automatizada.
Esta ferramenta copia tanto o Banco de Dados quanto os Arquivos (Mídias) da empresa selecionada.
Pré-requisitos
Para realizar a migração, você precisará ter em mãos as credenciais de acesso da VPS de Origem (o servidor antigo de onde você quer tirar os dados).
Você precisará de:
Acesso ao Banco de Dados da Origem (IP, Usuário, Senha e Nome do Banco).
Acesso SSH da Origem (IP, Usuário Root e Senha).
Caminhos das pastas (Onde o Z-PRO está instalado na VPS antiga).
Passo a Passo
Acesse o painel Superadmin do seu Z-PRO atual (Destino).
No menu lateral, clique em Migrações.
Você verá um formulário para estabelecer a conexão com o servidor antigo. Preencha os campos abaixo:
1. Configurações de Banco de Dados (Origem)
Preencha com os dados para acessar o PostgreSQL da VPS antiga.
Host: IP da VPS de Origem.
Porta: Geralmente 5432.
Usuário: Usuário do banco (ex:
postgresoudeployzdg).Senha: Senha do banco de dados.
Database: Nome do banco de dados.
2. Configurações SSH (Origem)
Preencha para permitir que o sistema copie os arquivos de mídia.
Host: IP da VPS de Origem.
Porta: 22 (Padrão).
Usuário:
root(Recomendado para evitar permissão negada).Senha: Senha do usuário root.
3. Caminhos e Identificação
Aqui você define onde buscar os arquivos e qual empresa migrar.
Caminho da Instalação (Origem): O caminho absoluto da pasta do projeto na VPS antiga (ex:
/home/deployzdg/zpro_backend).Caminho da Pasta Public (Origem): O local onde as mídias estão salvas (ex:
/home/deployzdg/zpro_backend/public).IP do Tenant na Origem: O ID numérico da empresa que você deseja migrar (Ex: Se na VPS antiga a empresa era o ID 4, digite
4).
Executando a Migração
Após preencher tudo, clique em Iniciar Migração.
O sistema executará o processo em duas etapas:
Migração de Dados: Copia tickets, contatos, configurações e históricos do banco.
Migração de Arquivos: Copia as imagens, áudios e vídeos da pasta
public.
Resolução de Problemas (Troubleshooting)
1. O processo travou ou parou? Se a migração parecer estagnada por mais de 30 minutos (devido a oscilações de rede ou timeout):
Reinicie o backend da sua VPS atual (Destino).
O sistema foi projetado para retomar o processamento automaticamente após o reinício.
2. Latência e Timeout Evite realizar migrações entre servidores com conexão de internet muito lenta ou instável. Uma latência alta pode causar timeouts durante a transferência de arquivos pesados via SSH.
3. Dados Faltantes Se o log apontar "violações" ou dados não migrados, verifique se houve alguma limpeza manual no banco de dados da origem que deixou registros "orfãos" (ex: um ticket sem contato associado). O migrador pode ignorar dados inconsistentes para proteger a integridade do novo servidor.
Atualizado