# Migração de Tenants

{% hint style="warning" %}
**Disponível para o perfil: Superadministrador**
{% endhint %}

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.

<figure><img src="/files/jC2oUL55PO57KUrAurP0" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/WIfY0rWBt906GQrdynqc" alt=""><figcaption></figcaption></figure>

### 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**.

<figure><img src="/files/YBmwSsB2CxnnhFdrI6F3" alt="" width="375"><figcaption></figcaption></figure>

***

### 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.

<figure><img src="/files/hCaHSCjRNieBIh8wt6l3" alt="" width="375"><figcaption></figcaption></figure>

#### 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.

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajuda.zdg.com.br/configuracao-superadmin/sistema/migracao-de-tenants.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.