# Snapshot do VPS antes de atualizar o cPanel

Como usar a imagem do VPS como ponto de volta antes de mexer no painel ou no EasyApache, e por que reverter custa caro para todos os clientes do servidor, não só para o que quebrou.

> Desligue o VPS, crie o snapshot no painel do provedor (não no WHM), dê a ele um nome com data e motivo e só comece a atualizar quando ele aparecer como concluído.

João Rizzon · 2026-11-14 · Servidores

---

## O que o snapshot resolve e o que ele não resolve

Atualizar o cPanel de tier, trocar a versão do PHP padrão ou recompilar o Apache pelo EasyApache 4 são mudanças que mexem no servidor inteiro. Quando dão errado, o sintoma raramente fica restrito a um site: o painel não sobe, o PHP-FPM não inicia ou todos os domínios devolvem erro 500 ao mesmo tempo.

O snapshot do VPS é a forma mais rápida de ter um ponto de volta para esse tipo de mudança. Ele é uma imagem do disco da máquina inteira num instante. Restaurar significa trocar o disco atual por aquela imagem. A documentação do cPanel sobre [gerenciamento de droplets na DigitalOcean](https://docs.cpanel.net/knowledge-base/web-services/digitalocean-droplet-management/) trata esse ciclo (criar a imagem e restaurar a partir dela) como operação do painel do provedor, fora do WHM.

O que ele não resolve:

- **Não é backup.** Fica guardado no mesmo provedor e, normalmente, na mesma conta. Se a conta do provedor tiver problema, o snapshot vai junto.
- **Não é seletivo.** Reverter devolve o servidor inteiro ao passado. Não existe "reverter só o cliente X".
- **Não substitui o backup de contas do cPanel.** Para restaurar um site só, o caminho continua sendo o backup por conta.

O segundo ponto é o que costuma ficar fora do planejamento, e é o assunto deste guia.

## Por que reverter o snapshot afeta todas as contas do servidor

Num VPS com várias contas cPanel, o snapshot congela todas elas no mesmo segundo. Se você atualiza o servidor às 23h, percebe o problema às 9h do dia seguinte e reverte, todas as contas voltam para as 23h. Inclusive as de clientes que não tinham nada a ver com a mudança.

O que se perde no intervalo entre criar o snapshot e reverter:

| O que mudou no intervalo | Onde mora | O que acontece ao reverter |
|---|---|---||
| E-mails recebidos | Caixas em `/home/usuario/mail` | Somem. O remetente já recebeu confirmação de entrega e não reenvia |
| Pedidos de loja (WooCommerce etc.) | Banco MySQL/MariaDB | Somem do banco, mas o pagamento pode já ter sido processado no gateway |
| Posts, comentários, cadastros | Banco | Somem |
| Uploads de mídia | `wp-content/uploads` | Somem, e links já publicados quebram |
| Alterações de zona DNS no WHM | Arquivos de zona do servidor | Voltam ao estado anterior |
| Certificados SSL emitidos ou renovados | Configuração do servidor | Voltam ao certificado antigo |
| Contas criadas, senhas trocadas | Configuração do cPanel | Contas novas deixam de existir, senhas antigas voltam |

E-mail é o item mais traiçoeiro. Do ponto de vista do servidor que enviou, a mensagem foi entregue. Ninguém vai saber que ela sumiu até o cliente perguntar por um orçamento que nunca chegou.

A consequência prática: o custo do snapshot não está em criá-lo, está no tamanho da janela. Quanto mais tempo entre a imagem e a decisão de reverter, mais caro fica voltar.

## Antes de criar, como preparar a janela da mudança

O objetivo é manter o intervalo curto e saber exatamente o que mudou nele.

### Como escolher o horário e avisar os clientes

Faça a mudança no horário de menor movimento das contas mais ativas, não no seu horário livre. Se há loja virtual no servidor, olhe o histórico de pedidos para escolher.

Avise os clientes antes. Uma frase que funciona:

> **** "Na madrugada de quinta vamos atualizar o servidor. Por segurança, guardamos uma cópia completa antes. Se precisarmos voltar, qualquer coisa feita no site entre 23h e 1h pode precisar ser refeita, então evite publicar ou cadastrar nesse horário."

### Quais versões e configurações anotar antes da mudança

Anote versões e configuração para comparar depois e para saber o que reinstalar se escolher corrigir em vez de reverter:

```
/usr/local/cpanel/cpanel -V
cat /etc/cpupdate.conf
php -v
httpd -v
```

No EasyApache 4, exporte o perfil atual de pacotes. É ele que permite voltar só a pilha web, sem reverter a máquina. Essa exportação é prática operacional recomendada, não parte da documentação de droplets citada neste guia:

```
/usr/local/bin/ea_current_to_profile
```

O comando informa o caminho do arquivo JSON gerado. Copie esse arquivo para fora do servidor também.

### Por que guardar backup das contas críticas fora do VPS

Para as contas onde perda de dados dói (loja, sistema com cadastro), tenha um backup recente fora do servidor. Ele é o que permite, depois de uma reversão, recuperar o que entrou no intervalo.

## Onde criar o snapshot e por que não é no WHM

O snapshot é feito no painel do provedor do VPS, não no WHM. Na DigitalOcean, a documentação do cPanel indica o gerenciamento pelo painel do droplet. Em outros provedores o nome muda (imagem, ponto de restauração, snapshot), mas a lógica é a mesma.

### Por que desligar a máquina antes de criar o snapshot

Esta etapa é prática operacional recomendada, não parâmetro da documentação citada, que trata apenas de criar e restaurar a imagem pelo painel da DigitalOcean. Um snapshot com o servidor ligado captura o disco no meio de gravações. O banco de dados pode ficar inconsistente na imagem e só descobrir isso na hora de restaurar, que é o pior momento. O caminho mais seguro é desligar a máquina antes:

```
sync
poweroff
```

Espere o painel do provedor mostrar a máquina como desligada, crie o snapshot, aguarde a conclusão e ligue de novo. Isso custa alguns minutos de indisponibilidade, que você já avisou.

Se desligar não for opção, ao menos pare o MySQL/MariaDB e o Exim antes da imagem, para não ter transação nem mensagem pela metade. Também aqui é prática operacional, não procedimento documentado pelo cPanel.

### Qual nome dar ao snapshot para encontrá-lo depois

Use um nome que diga data, hora e motivo, por exemplo `2026-11-12-2300-antes-upcp-release`. Daqui a três semanas ninguém lembra o que era `snapshot-1`.

### Como saber que o snapshot ficou concluído

Antes de começar a mudança, veja o snapshot listado como concluído no painel. Snapshot em andamento não é ponto de volta.

## Quais testes fazer logo após a atualização

Com o servidor de volta no ar, faça a atualização (`/scripts/upcp`, troca de perfil do EasyApache, nova versão do PHP) e teste em seguida, não no dia seguinte:

- WHM e cPanel abrem e logam.
- Um site de cada tipo responde: WordPress com PHP padrão, site com versão de PHP diferente, loja.
- Envio e recebimento de e-mail de teste numa conta real.
- `httpd -v` e `php -v` mostram o esperado.

Defina antes um prazo de decisão, algo como "se não estiver ok até tal hora, reverto". O prazo existe para manter a janela de perda pequena.

### Quando corrigir a pilha web sai mais barato que reverter

Reverter a máquina é a opção mais cara em dados. Quando o problema é só a pilha web, normalmente sai mais barato reaplicar o perfil do EasyApache que você exportou antes, pelo WHM em EasyApache 4, sem tocar nas contas. Se for um único site quebrado por incompatibilidade de PHP, trocar a versão daquela conta no MultiPHP Manager resolve sem envolver o snapshot.

Use o snapshot quando o servidor como um todo ficou inutilizável e não há caminho de correção claro dentro do prazo.

## Ordem para reverter sem perder o que entrou no intervalo

- **Salve o que entrou no intervalo.** Se o servidor ainda responde, gere backup das contas ativas ou ao menos copie as caixas de e-mail e exporte os bancos das lojas. Depois da reversão, isso não existe mais.
- **Anote pedidos e cadastros.** Para lojas, liste os pedidos feitos depois do horário do snapshot. O gateway de pagamento tem esse registro mesmo que o banco perca.
- **Restaure o snapshot** pelo painel do provedor.
- **Reaplique o que salvou.** Restaure as mensagens nas caixas, reimporte pedidos manualmente ou mescle o que for possível.
- **Verifique DNS e SSL.** Se alguma zona foi alterada ou algum certificado renovado no intervalo, refaça.
- **Avise os clientes afetados** com o horário exato do ponto de volta.

Frase para o cliente depois de uma reversão:

> **** "A atualização causou instabilidade e voltamos o servidor para a cópia das 23h. O site está normal. Mensagens e cadastros recebidos entre 23h e 1h podem não estar lá: estamos recuperando o que foi possível e te mandamos a lista do que precisa ser conferido."

Se a decisão de reverter passar do prazo avisado, ajuste o horário final da frase e avise que a janela foi maior do que o combinado. É o motivo de manter o prazo curto: a promessa feita no aviso prévio só se sustenta se a decisão sai dentro dele.

## Checklist para repetir em cada VPS

Copie para o seu procedimento padrão e repita em cada VPS:

| Etapa | Feito |
|---|---||
| Horário de menor movimento escolhido e clientes avisados |  |
| Prazo de decisão definido (hora limite para reverter, igual à do aviso) |  |
| Versões registradas (`cpanel -V`, `php -v`, `httpd -v`, `cpupdate.conf`) |  |
| Perfil do EasyApache exportado e copiado para fora |  |
| Backup das contas críticas fora do VPS |  |
| Servidor desligado ou serviços de banco e e-mail parados |  |
| Snapshot criado, nomeado com data e motivo, status concluído |  |
| Mudança aplicada e testes feitos logo em seguida |  |
| Snapshot apagado depois de alguns dias estáveis |  |

O último item importa: snapshot antigo esquecido costuma ser cobrado por espaço e, pior, vira tentação de restaurar um ponto de semanas atrás, quando a perda seria enorme. Ele serve para a mudança daquela noite, não como política de backup.

