# 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.

> 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.

João Rizzon · 2026-11-16 · 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](https://docs.cpanel.net/whm/software/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 `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.
- **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/cpanel` e `/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

> **** "Saiu uma correção de segurança do painel do servidor e vou aplicar hoje às 15h, sem esperar a rotina automática da madrugada. Durante uns minutos o webmail e o painel podem pedir login de novo ou demorar para responder. O site deve seguir no ar, o e-mail pode atrasar alguns instantes, e eu testo tudo antes de encerrar."

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
- [ ] `upcp` disparado dentro de `screen` ou pelo WHM (Upgrade to Latest Version)
- [ ] Log acompanhado até a linha final, sem `[ERROR]` sem explicação
- [ ] Versão nova confirmada
- [ ] `httpd`, `exim`, `dovecot` ativos
- [ ] 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.

