Como atualizar o cPanel manualmente agora, com menos risco de quebrar
Roteiro para aplicar uma correção de segurança do cPanel em horário comercial: disparo pelo WHM ou terminal, leitura do log, serviços que reiniciam e os testes que fecham a janela com o cliente tranquilo.

Resposta curta: rode /scripts/upcp como root (ou use WHM » cPanel » Upgrade to Latest Version), acompanhe o log em /var/cpanel/updatelogs/ até a linha final e só encerre depois de testar site, webmail e envio de e-mail, porque cpsrvd e outros serviços podem reiniciar.
Neste artigo
- O que muda quando você não espera a madrugada
- Cinco checagens antes de disparar evitam a noite perdida
- Pelo WHM, Upgrade to Latest Version faz o mesmo que o upcp
- Pelo terminal, /scripts/upcp é o mesmo comando da rotina noturna
- Como saber que a atualização terminou de verdade
- Quais serviços reiniciam e o que o cliente percebe
- Três testes antes de encerrar a janela
- Checklist para padronizar em vários servidores
O que muda quando você não espera a madrugada
A rotina automática do cPanel roda o script upcp uma vez por dia, no horário definido pelo cron do servidor. Quando sai uma correção de segurança e o cliente não pode ficar exposto até lá, você dispara o mesmo upcp manualmente. Não existe um "modo emergência" diferente: é o mesmo processo, só que no horário que você escolhe e com você olhando.
Isso tem uma consequência prática. Na madrugada ninguém percebe uma reinicialização de serviço de alguns segundos. No meio da tarde, alguém vai perceber. Por isso o roteiro abaixo tem três partes que valem tanto quanto o disparo em si: avisar antes, acompanhar a saída até o fim e testar site, webmail e envio antes de fechar a janela.
A documentação oficial do cPanel descreve as duas telas do WHM envolvidas: Upgrade to Latest Version, que atualiza o cPanel, e Update Server Software, que atualiza os pacotes do sistema operacional. O comando upcp, a opção --force, o arquivo /etc/cpupdate.conf e o caminho de log /var/cpanel/updatelogs/ não vêm dessa página: são conhecimento de operação. O mesmo vale para a organização, o checklist e os comandos de validação, e vou sinalizar quando for o caso.
Cinco checagens antes de disparar evitam a noite perdida
Faça isto em todo servidor, sempre na mesma ordem. Vira hábito rápido.
- Confirme a versão atual. Anote antes, para comparar depois.
- Confirme o tier de atualização. Se o servidor está travado em um tier antigo, o
upcpnão vai buscar a versão que traz a correção. Antes de mexer no tier, abra o anúncio da correção e veja quais builds a contêm. Correções de segurança costumam sair para todos os tiers suportados, inclusive LTS, então o mais comum é o tier atual já receber a build corrigida. Trocar de tier (de LTS para RELEASE, por exemplo) pode levar o servidor a uma versão maior, com mais mudanças do que a correção, e isso aumenta o risco numa janela diurna. Só ajuste o tier, em WHM, na tela de preferências de atualização, se o anúncio mostrar que o tier atual não recebe a correção. - Tenha um ponto de retorno. Snapshot da VM ou backup recente. Atualização do cPanel raramente quebra, mas "raramente" não serve de argumento quando o cliente liga.
- Verifique espaço em disco em
/usr/local/cpanele/var. Disco cheio é causa conhecida de atualização interrompida. - Avise o cliente com a janela e o que ele pode notar.
/usr/local/cpanel/cpanel -V
cat /etc/cpupdate.conf
df -h /usr/local/cpanel /var
exim -bpc
O primeiro comando devolve a versão instalada. O segundo mostra o tier configurado (linha CPANEL=). O terceiro, o espaço livre nas partições que importam aqui. O quarto, o tamanho atual da fila do Exim: anote o número para comparar no fim.
O que dizer ao cliente antes da janela
Não prometa "zero indisponibilidade". Prometa que você está acompanhando.
Pelo WHM, Upgrade to Latest Version faz o mesmo que o upcp
Para o cPanel em si, o caminho do WHM equivalente ao upcp é WHM » cPanel » Upgrade to Latest Version. A tela dispara a atualização e exibe a saída do processo no navegador.
A tela WHM » Software » Update Server Software é outra coisa: segundo a documentação oficial, ela atualiza os pacotes do sistema operacional, não o cPanel. Pode fazer sentido rodá-la na mesma janela se a correção envolver pacote do sistema, mas ela não substitui o upcp.
Pontos de atenção nesse caminho:
- O WHM em si pode reiniciar durante o processo. O serviço que entrega o WHM, o cPanel e o webmail (
cpsrvd) faz parte do que é atualizado. Se a página parar de responder por alguns segundos, não feche a aba em pânico: recarregue e confira o log. - Fechar o navegador não é a forma de cancelar. Trate o processo como algo que segue rodando no servidor. Se você perdeu a tela, acompanhe pelo log (próxima seção).
- Use o WHM quando não tiver SSH ou quando for um servidor que você mantém para um cliente com acesso só ao painel. Para quem tem terminal, a linha de comando dá mais controle.
Pelo terminal, /scripts/upcp é o mesmo comando da rotina noturna
Pelo terminal, como root, o comando é o mesmo que a rotina noturna usa:
/scripts/upcp
Se a versão instalada já é a mais recente do tier e você precisa reaplicar a atualização (por exemplo, porque a anterior terminou com erro), existe a opção de forçar:
/scripts/upcp --force
Use --force só quando há motivo. Para aplicar uma correção que ainda não está instalada, o comando simples basta.
Não rode solto em uma sessão SSH
Se a conexão SSH cair no meio, você perde a visão do processo e fica sem saber em que ponto ele parou. Prática de operação, não item da documentação: abra uma sessão screen ou tmux antes.
screen -S upcp
/scripts/upcp
Se cair, reconecte com screen -r upcp e a saída estará lá.
Como saber que a atualização terminou de verdade
O upcp, disparado pelo terminal ou pelo Upgrade to Latest Version, grava log em /var/cpanel/updatelogs/, um arquivo por execução, com data no nome. É esse arquivo que vale como registro, não a tela. Para a atualização de pacotes pelo Update Server Software, a fonte consultada não documenta onde fica o registro: guarde a saída exibida no navegador.
ls -lt /var/cpanel/updatelogs/ | head -3
tail -f /var/cpanel/updatelogs/update.NOME_DO_ARQUIVO.log
Substitua NOME_DO_ARQUIVO pelo mais recente da listagem (o nome acima é exemplo de formato, não literal).
O que procurar:
| Sinal no log | O que significa | O que fazer |
|---|---|---|
| Linha final indicando conclusão do processo | Terminou | Seguir para a validação |
Linhas com [ERROR] ou [WARN] |
Algo falhou ou foi pulado | Ler o contexto acima da linha antes de qualquer outra ação |
| Log parado há muito tempo sem nova linha | Etapa lenta (download, pacotes) ou travamento | Checar rede e disco antes de matar o processo |
| Arquivo novo não aparece | O upcp não iniciou, ou outro já está rodando |
Verificar se há outro upcp em execução |
Regra prática: a janela só termina quando o log termina. "A tela parou de mexer" não é conclusão.
Depois, confirme a versão de novo e compare com a anotada antes:
/usr/local/cpanel/cpanel -V
Se a versão não mudou e o log não mostra erro, o mais provável é que o tier configurado não inclua a versão com a correção. Volte à etapa de tier.
Quais serviços reiniciam e o que o cliente percebe
A página oficial não traz uma lista fechada de serviços reiniciados em cada execução, e isso depende do que a atualização mexe. Então não vou inventar uma. O que dá para afirmar pela natureza do processo, e o que vale esperar em uma janela diurna:
| Serviço | Onde o cliente percebe | Comportamento típico |
|---|---|---|
cpsrvd (cPanel, WHM, webmail) |
Webmail e painel pedem login de novo ou demoram | Volta sozinho em segundos |
| Servidor web (Apache) | Site pode recusar conexão brevemente | Só se houver atualização de pacote relacionado |
| Exim (envio de e-mail) | Envio pode ficar na fila por instantes | Fila é processada quando volta |
| Dovecot (IMAP/POP) | Cliente de e-mail reconecta | Reconexão automática na maioria dos apps |
Por isso a frase ao cliente fala em webmail e painel, que é o efeito mais provável. Se o log mostrar atualização de pacotes do servidor web ou de e-mail, conte com reinício desses também.
Três testes antes de encerrar a janela
Três testes, sempre os mesmos, em todo servidor. Leva menos de cinco minutos e é o que você mostra ao cliente se ele perguntar.
Serviços principais ativos após o upcp
systemctl is-active httpd exim dovecot
Cada linha deve responder active. Qualquer outra resposta, investigue antes de testar o resto.
Site respondendo com o status esperado
curl -sI https://dominio-do-cliente.com.br | head -1
O esperado é um status de sucesso ou redirecionamento (200, 301, 302). Um 5xx indica problema no servidor web ou no PHP. Teste pelo menos um site WordPress e um site estático, se houver os dois no servidor.
Webmail abre e e-mail externo chega
Webmail: abra https://dominio-do-cliente.com.br:2096 no navegador, faça login com uma conta de teste e confira se a caixa abre. Envio: mande uma mensagem dessa conta para um endereço externo (Gmail, Outlook) e acompanhe o log do Exim enquanto envia:
tail -f /var/log/exim_mainlog
exim -bpc
O primeiro mostra a entrega em tempo real. O segundo devolve o tamanho da fila: compare com o valor antes da janela. Fila crescendo depois da atualização é sinal de que o envio não normalizou.
Só depois desses três testes você manda a mensagem de encerramento ao cliente.
Checklist para padronizar em vários servidores
Copie para o seu gerenciador de tarefas e reutilize em cada correção de segurança:
- [ ] Versão anotada (
cpanel -V) - [ ] Fila do Exim anotada (
exim -bpc) - [ ] Anúncio da correção conferido: o tier atual recebe a build corrigida (trocar de tier só se não receber)
- [ ] Snapshot ou backup recente confirmado
- [ ] Espaço em disco verificado
- [ ] Cliente avisado com horário
- [ ]
upcpdisparado dentro descreenou pelo WHM (Upgrade to Latest Version) - [ ] Log acompanhado até a linha final, sem
[ERROR]sem explicação - [ ] Versão nova confirmada
- [ ]
httpd,exim,dovecotativos - [ ] Site responde com status esperado
- [ ] Webmail abre e envio externo entregue
- [ ] Fila do Exim igual ou menor que antes
- [ ] Cliente avisado do encerramento
Se você mantém muitos servidores, escalone: aplique primeiro no de menor risco, valide, e só então siga para os de clientes mais sensíveis. Uma correção que quebra algo aparece no primeiro, não no décimo.
E, contra a pressa: se a correção não é crítica para o que o servidor roda, esperar a rotina da madrugada é uma opção legítima. O disparo manual vale quando o risco de ficar exposto até lá é maior que o custo de uma janela diurna acompanhada.
Referências
- Documentação oficial (cpanel) — Update Server Software. Consultado em 2026-11-09.