# Migração cPanel: como saber qual item falhou com o view_transfer

Como localizar a sessão pela data, ler o log com o view_transfer, separar aviso de falha real e responder ao cliente no mesmo dia.

> a cPanel mantém no servidor de destino, em /var/cpanel/transfer_sessions/, o registro de cada sessão de migração, e o script /usr/local/cpanel/scripts/view_transfer abre esse relatório conta a conta, mostrando qual item falhou sem precisar refazer a transferência inteira.

João Rizzon · 2026-10-29 · Revenda

---

## O relatório da migração continua no servidor depois que a tela fecha

A Transfer Tool do WHM mostra o progresso em tempo real e, quando você fecha o navegador, parece que a informação foi junto. Não foi. Cada execução da ferramenta cria uma **sessão de transferência** no servidor de destino, com log próprio por conta e por item copiado. É isso que você abre dias depois, quando o cliente escreve dizendo que o formulário parou ou que uma caixa de e-mail sumiu.

O caminho documentado pela cPanel para ler essas sessões pela linha de comando é o script `view_transfer`, descrito em [The view_transfer Script](https://docs.cpanel.net/whm/scripts/the-view_transfer-script/). Ele existe exatamente para o cenário em que a interface já não está mais aberta e você precisa do histórico bruto.

A diferença prática para uma agência: em vez de agendar uma nova janela de migração para o domínio inteiro por causa de uma conta de e-mail, você lê qual item registrou erro, repete só aquele item e responde ao cliente no mesmo dia.

## Onde ficam as sessões e como achar a certa pelo horário

Na instalação padrão, as sessões ficam no servidor de **destino**, aquele que recebeu as contas, dentro de `/var/cpanel/transfer_sessions/`. A página do `view_transfer` citada acima documenta o script, não esse caminho, então confirme o diretório no seu servidor antes de automatizar qualquer coisa em cima dele. Cada sessão é um diretório com um identificador próprio.

Como o nome da sessão não é autoexplicativo, a forma mais rápida de achar a migração de terça à noite é ordenar por data de modificação:

```bash
ls -lt /var/cpanel/transfer_sessions/ | head -20
```

Se você fez várias migrações no mesmo dia, para clientes diferentes, vale confirmar o conteúdo antes de abrir o log inteiro:

```bash
ls /var/cpanel/transfer_sessions/<ID_DA_SESSAO>/
```

O diretório da sessão guarda os arquivos de log e de estado daquela execução. Os nomes exatos variam conforme a versão do cPanel e o tipo de transferência, então liste o diretório em vez de supor o nome do arquivo. O que interessa é o padrão: existe um log geral da sessão e existem registros por conta transferida.

Dica de organização que economiza tempo depois: no momento em que você dispara a transferência, anote o horário de início no ticket interno do cliente. Com o horário, achar a sessão certa vira uma linha de `ls -lt`. Sem o horário, você abre três sessões até achar a do domínio em questão.

## Como rodar o view_transfer e filtrar pelo usuário que reclamou

A documentação oficial descreve o script no caminho `/usr/local/cpanel/scripts/view_transfer`, executado como root e recebendo o identificador da sessão:

```bash
/usr/local/cpanel/scripts/view_transfer <ID_DA_SESSAO>
```

Antes de tudo, execute o script sem argumentos para ver a sintaxe aceita pela sua versão:

```bash
/usr/local/cpanel/scripts/view_transfer
```

A saída costuma ser longa, porque inclui o log de cada conta e de cada etapa. Trate como log: pagine e filtre.

```bash
/usr/local/cpanel/scripts/view_transfer <ID_DA_SESSAO> | less
```

```bash
/usr/local/cpanel/scripts/view_transfer <ID_DA_SESSAO> > /root/migracao-cliente.txt
```

Salvar em arquivo tem duas vantagens para quem atende cliente: você anexa o trecho relevante no ticket e você relê sem reexecutar nada no servidor de produção.

Para ir direto ao ponto quando a reclamação já tem nome, filtre pelo usuário cPanel ou pelo domínio:

```bash
/usr/local/cpanel/scripts/view_transfer <ID_DA_SESSAO> | grep -i -C 5 'usuariocpanel'
```

O `-C 5` mostra cinco linhas de contexto antes e depois, o que normalmente basta para ver qual etapa estava rodando quando a linha de erro apareceu.

## Como separar aviso de falha: a linha cita um item que não foi copiado?

Esta é a parte em que a maioria das agências perde tempo: o log de uma migração bem-sucedida também tem linhas feias. Mensagens sobre módulos opcionais ausentes, diferenças de versão de PHP, permissões ajustadas durante a restauração, tudo isso aparece como aviso e não impede a conta de funcionar.

O critério útil é este: **aviso descreve algo que foi ajustado ou ignorado; falha descreve algo que não foi copiado**. Pergunte-se sempre qual item concreto o cliente perderia por causa daquela linha. Se a resposta for "nenhum", é ruído.

| O que a linha indica | Classificação prática | Ação |
|---|---|---||
| Item restaurado com ajuste de permissão ou de dono | Aviso | Nenhuma, confirme o acesso pelo cPanel |
| Módulo ou extensão indisponível no destino | Aviso com impacto possível | Verificar se o site usa; habilitar no destino |
| Conta transferida mas um item marcado com erro | Falha parcial | Repetir só aquele item |
| Conta inteira não criada no destino | Falha total | Repetir a conta, checar espaço e conflito de usuário |
| Transferência interrompida no meio | Falha de sessão | Conferir quais contas ficaram completas antes de repetir |

Um detalhe que gera reclamação tardia: conta criada com sucesso não significa conteúdo íntegro. Banco de dados grande e caixa de e-mail grande são os itens que mais aparecem com erro próprio dentro de uma conta que, no resumo, consta como transferida. Por isso vale ler o bloco da conta inteiro, não só a linha final dela.

## Checklist de leitura do relatório, da sessão ao item refeito

### Localize a sessão pelo horário anotado

Rode `ls -lt /var/cpanel/transfer_sessions/` no destino e confirme pelo horário anotado.

### Gere o relatório completo e salve em arquivo

Rode o `view_transfer` com o ID e redirecione para um arquivo no `/root`.

### Procure o usuário cPanel e, se não achar, o domínio

Use `grep -i -C 5` com o usuário cPanel e, se não achar, com o domínio.

### Classifique cada linha suspeita como aviso ou falha

Aplique a tabela acima. Anote só o que tem item concreto não copiado.

### Confirme no destino antes de concluir, porque log limpo não garante conteúdo íntegro

Log diz o que a ferramenta tentou. A verdade está no servidor: confira o banco em phpMyAdmin, a caixa no webmail, o arquivo no gerenciador. Já vi log limpo com caixa vazia e log com aviso e conta perfeita.

### Repita só o item que falhou, não a conta inteira

Uma caixa de e-mail você recria e sincroniza com IMAP. Um banco você exporta e importa. Refazer a conta inteira só quando a conta inteira falhou.

## Duas frases para explicar o resultado ao cliente

O cliente não quer saber de sessão, log ou script. Ele quer saber se perdeu algo e quando volta. Duas frases resolvem, e elas funcionam porque nomeiam o escopo do problema antes de nomear a solução.

Quando foi falha parcial:

> **** "Conferi o relatório da migração. O site e o banco de dados vieram completos. A conta de e-mail contato@seudominio.com.br foi a única que registrou erro na cópia das mensagens e já está sendo refeita. Os e-mails antigos continuam no servidor anterior, nada foi perdido, e eu aviso assim que a sincronização terminar."

Quando era só aviso:

> **** "Verifiquei linha a linha o relatório da migração desta conta: todos os itens foram transferidos. O comportamento que você notou vem de uma diferença de configuração no servidor novo, que eu já ajustei, e não de arquivo faltando."

Repare no que as duas têm em comum: escopo ("a única"), estado do dado antigo ("continuam no servidor anterior") e próximo passo com responsável definido. É o que reduz follow-up.

## Quatro problemas que o relatório nunca vai registrar

Seja honesto com o limite da ferramenta. O relatório da sessão registra o que a Transfer Tool fez. Ele não registra:

- alteração feita no site **depois** da migração, por você ou pelo cliente;
- e-mail que chegou no servidor antigo durante a propagação de DNS, porque isso aconteceu fora da sessão;
- conteúdo enviado por FTP ou plugin fora do `home` da conta;
- diferença de versão de PHP ou de extensão que quebra o site sem gerar erro na cópia.

Nesses casos o log vai aparecer limpo e você precisa investigar no servidor, não no relatório. Dizer "o log está limpo, logo o problema é outro" já é progresso: elimina a hipótese cara (refazer a migração) em poucos minutos.

Guarde o arquivo de saída do `view_transfer` junto do registro do projeto por alguns meses. Quando o cliente reclamar de algo em março referente a uma migração de janeiro, você responde com o relatório em mãos em vez de reconstruir memória.

