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.

Resposta curta: 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.
Neste artigo
- O relatório da migração continua no servidor depois que a tela fecha
- Onde ficam as sessões e como achar a certa pelo horário
- Como rodar o view_transfer e filtrar pelo usuário que reclamou
- Como separar aviso de falha: a linha cita um item que não foi copiado?
- Checklist de leitura do relatório, da sessão ao item refeito
- Duas frases para explicar o resultado ao cliente
- Quatro problemas que o relatório nunca vai registrar
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. 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:
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:
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:
/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:
/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.
/usr/local/cpanel/scripts/view_transfer <ID_DA_SESSAO> | less
/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:
/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:
Quando era só aviso:
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
homeda 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.
Referências
- Documentação oficial (cpanel) — The view_transfer Script. Consultado em 2026-10-16.