blog
Revenda

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.

JR · · 7 min de leitura · 1 tabela · 7 blocos de código

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
  1. O relatório da migração continua no servidor depois que a tela fecha
  2. Onde ficam as sessões e como achar a certa pelo horário
  3. Como rodar o view_transfer e filtrar pelo usuário que reclamou
  4. Como separar aviso de falha: a linha cita um item que não foi copiado?
  5. Checklist de leitura do relatório, da sessão ao item refeito
  6. Duas frases para explicar o resultado ao cliente
  7. 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.

Como classificar cada linha do relatorioLinha suspeita no logLeia o bloco inteiro da contaQual item o cliente perderia?Pergunta que separa ruido de falhaNenhum item perdidoAviso: ajuste ou modulo ausenteItem concreto nao copiadoFalha: banco, caixa ou contaConfirme no destinophpMyAdmin, webmail, gerenciador de arquivos
Criterio de triagem: aviso descreve ajuste, falha descreve item ausente.

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.

Da sessao ao item refeitoLocalizar sessaols -lt no servidor de destinoSalvar relatorioview_transfer com ID para arquivoFiltrar usuariogrep -i -C 5 com dominioConferir no destinoBanco, caixa e arquivos reaisRefazer so o itemConta inteira apenas se falhou
Sequencia reutilizavel para qualquer migracao cPanel ja concluida.

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:

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

  1. Documentação oficial (cpanel) — The view_transfer Script. Consultado em 2026-10-16.
Leia também