blog
Servidores

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.

JR · · 8 min de leitura · 2 tabelas · 9 blocos de código

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
  1. O que muda quando você não espera a madrugada
  2. Cinco checagens antes de disparar evitam a noite perdida
  3. Pelo WHM, Upgrade to Latest Version faz o mesmo que o upcp
  4. Pelo terminal, /scripts/upcp é o mesmo comando da rotina noturna
  5. Como saber que a atualização terminou de verdade
  6. Quais serviços reiniciam e o que o cliente percebe
  7. Três testes antes de encerrar a janela
  8. 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.

  1. Confirme a versão atual. Anote antes, para comparar depois.
  2. Confirme o tier de atualização. Se o servidor está travado em um tier antigo, o upcp nã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.
  3. 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.
  4. Verifique espaço em disco em /usr/local/cpanel e /var. Disco cheio é causa conhecida de atualização interrompida.
  5. 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.

Quando mexer no tier de atualizaçãoLer o anúncio da correçãoQuais builds contêm a correçãoTier atual recebe a build?Confira no anúncio, não no palpiteSim: manter o tierDispare o upcp sem mexer em nadaNão: ajustar o tier no WHMSó então, e só o necessário
Só troque de tier se o anúncio mostrar que o atual não recebe a correção.

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:

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.

Três testes antes de fechar a janelaServiços principais ativoshttpd, exim e dovecot em activeSite respondeStatus 200, 301 ou 302Webmail e envio externoLogin, caixa abre e e-mail chega
Os três testes são sempre os mesmos, em todo servidor.

Checklist para padronizar em vários servidores

Copie para o seu gerenciador de tarefas e reutilize em cada correção de segurança:

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

  1. Documentação oficial (cpanel) — Update Server Software. Consultado em 2026-11-09.
Leia também