Upgrade do Plesk: o que cai e o que fica no ar
O que realmente fica indisponível na janela, o pré-check que evita cancelar no meio e o checklist de validação por assinatura depois que o autoinstaller termina.

Resposta curta: a indisponibilidade esperada no upgrade do Plesk é do painel (porta 8443) e do webmail, não dos sites e do e-mail, que seguem no ar com reinícios curtos quando Apache/nginx, PHP-FPM, Postfix ou o banco são atualizados. Com snapshot antes e log acompanhado, a janela é previsível.
Neste artigo
- O que cai e o que continua no ar durante o upgrade
- Conferir se o sistema operacional ainda é suportado pela versão de destino
- Snapshot ou backup do Plesk: qual dos dois permite reverter
- Rodar o autoinstaller em sessão persistente e ler o log em paralelo
- Validação pós-upgrade em três a cinco assinaturas representativas
- Quando o upgrade para no meio: retomar, reparar ou reverter
- Repetir a mesma janela em vários servidores e parar de estimar no chute
O que cai e o que continua no ar durante o upgrade
A confusão que trava a marcação da janela é tratar "atualizar o Plesk" como "derrubar o servidor". Não é a mesma coisa. O autoinstaller atualiza os componentes do painel e os pacotes que ele gerencia; a indisponibilidade esperada é a do painel, na porta 8443, enquanto o Plesk se reinicia e aplica as migrações internas.
Os serviços de produção (Apache/nginx, PHP-FPM, Postfix/Dovecot, MySQL/MariaDB) continuam servindo, exceto nos momentos em que o próprio upgrade atualiza um desses pacotes e reinicia o serviço correspondente. Aí a queda é de segundos a poucos minutos, por serviço, não do servidor inteiro.
Traduzindo para o que você precisa escrever na janela de manutenção:
| Componente | Comportamento esperado | Quem percebe |
|---|---|---|
| Painel Plesk (8443) | Indisponível durante boa parte do upgrade | Você, o cliente que acessa o painel |
| Sites HTTP/HTTPS | No ar, com reinícios curtos do web server | Visitante, se cair bem no reinício |
| PHP-FPM (pools por site) | Reinício por versão de PHP atualizada | Sites dinâmicos, requisições em voo |
| E-mail (SMTP/IMAP) | No ar, com reinício curto se Postfix/Dovecot forem atualizados | Cliente de e-mail reconecta sozinho |
| Banco de dados | No ar; reinício se houver atualização do servidor MySQL/MariaDB | Site cai em erro de conexão durante o reinício |
| Webmail (Roundcube/Horde) | Pode ficar indisponível enquanto o componente é atualizado | Cliente que usa webmail |
Não prometa ao cliente "zero downtime". Prometa indisponibilidade parcial e curta, em janela combinada. É o que a arquitetura entrega e é o que você consegue sustentar depois.
Texto pronto do aviso de manutenção para o cliente final
Troque data e horário, mande por e-mail e guarde o envio. Isso evita a maior parte da fricção quando alguém abre o site no meio da janela e vê um erro de 20 segundos.
Conferir se o sistema operacional ainda é suportado pela versão de destino
O erro mais caro não é o upgrade falhar. É o upgrade não começar porque o sistema operacional do servidor saiu da lista de suportados da versão de destino do Plesk, e você descobrir isso com a janela aberta e o cliente avisado.
Antes de agendar qualquer coisa, confira na documentação oficial do Plesk a matriz de sistemas operacionais suportados pela versão para a qual você vai subir: o Deployment Guide do Plesk Obsidian traz essa lista na seção de requisitos de instalação (docs.plesk.com/en-US/obsidian/deployment-guide/, consultado em 2026-11-01). Um servidor em distribuição fora de suporte pode continuar rodando a versão atual do Plesk e simplesmente não receber a nova.
Levante o estado real da máquina antes:
# versão atual do Plesk e build
plesk version
# distribuição e release
cat /etc/os-release
# espaço livre (o upgrade baixa pacotes e grava logs)
df -h /
df -h /tmp /var
# memória e swap disponíveis
free -m
Checklist de pré-voo, na ordem em que vale rodar:
- Distribuição e versão do SO estão na lista de suportados da versão de destino.
- Espaço em disco sobrando em
/,/vare/tmp. Disco cheio interrompe o upgrade e aparece no log de instalação comoNo space left on device. - Backup ou snapshot concluído e verificado (próxima seção).
- Nenhuma outra operação pesada agendada para a janela: cron de backup, importação de banco, crawl de SEO.
- Acesso SSH funcionando com usuário que não dependa do painel, porque o painel vai estar fora.
- Janela fora do horário comercial dos clientes do servidor. Em servidor de agência, isso costuma ser madrugada ou domingo de manhã.
Snapshot ou backup do Plesk: qual dos dois permite reverter
Backup do Plesk e snapshot de máquina resolvem problemas diferentes. O backup do Plesk (assinaturas, bases, e-mail, configurações) devolve conteúdo. O snapshot de disco/VM devolve o estado do servidor inteiro, incluindo a versão do painel. Para reverter um upgrade que deu errado, é o snapshot que salva.
Se o ambiente é VPS ou dedicado com virtualização, tire o snapshot imediatamente antes de disparar o autoinstaller, com a janela já começada. Se não há snapshot disponível, aceite que a reversão será parcial e planeje a janela com mais folga: o caminho vira reinstalar/retomar e restaurar backup, que leva bem mais tempo.
Antes de prosseguir, valide que o backup existe de verdade: confira tamanho do arquivo e data, e, em pelo menos uma assinatura, abra o conteúdo do backup. Backup não verificado é esperança, não plano de reversão.
Rodar o autoinstaller em sessão persistente e ler o log em paralelo
O upgrade do Plesk é feito pelo autoinstaller. Rode sempre dentro de uma sessão persistente, porque uma queda de SSH no meio da instalação é exatamente o cenário que você está tentando evitar:
# sessão persistente: se o SSH cair, o processo continua
screen -S plesk-upgrade
# ou: tmux new -s plesk-upgrade
# inicia o instalador/atualizador interativo
plesk installer
Enquanto o processo roda, abra um segundo terminal e acompanhe o log de instalação do autoinstaller em /var/log/plesk/install/. É nele que aparece o pacote exato que falhou, o que a mensagem genérica da tela não diz:
# lista os logs mais recentes
ls -lt /var/log/plesk/install/ | head
# acompanha o mais recente em tempo real
tail -f /var/log/plesk/install/autoinstaller3.log
O que observar no log, em vez de ficar olhando a barra de progresso:
- Falha de download de repositório: problema de rede ou mirror, costuma resolver retomando.
No space left on device: pare, libere espaço, retome.- Erro de dependência de pacote do SO: normalmente é o sinal de que o pré-check de distribuição foi ignorado.
- Falha na migração do banco do painel: é o caso em que reverter por snapshot costuma ser mais rápido que insistir.
Não feche a sessão achando que travou porque a tela ficou parada. Confirme pelo log antes de interromper qualquer coisa.
Validação pós-upgrade em três a cinco assinaturas representativas
Terminar o upgrade não é terminar a janela. Escolha de três a cinco assinaturas representativas (uma WordPress com e-mail, uma estática, uma com banco pesado, uma com PHP mais antigo) e passe por todas as verificações. Não valide só o site que você lembra de cabeça.
| Verificação | Como testar | Resultado esperado |
|---|---|---|
| Painel | Acessar https://servidor:8443 e logar |
Login normal, versão nova exibida |
| Site HTTP/HTTPS | Abrir home e uma página interna | 200, sem erro de PHP, certificado válido |
| PHP por assinatura | Conferir versão de PHP nas configurações do domínio | Mesma versão de antes do upgrade |
| Banco | Abrir uma página que consulta o banco; abrir phpMyAdmin | Sem erro de conexão |
| Webmail | Logar em uma conta real | Caixa carrega, mensagens listadas |
| SMTP autenticado | Enviar uma mensagem por cliente externo autenticando na porta de submissão | Mensagem entregue |
| Recebimento | Enviar de fora para a conta de teste | Mensagem chega sem atraso |
| Agendamentos | Conferir tarefas cron/agendadas do painel | Lista intacta |
Um par de comandos resolve a checagem rápida de serviços antes de abrir o navegador:
# versão após o upgrade
plesk version
# estado dos serviços gerenciados pelo Plesk
systemctl status sw-cp-server --no-pager
systemctl status postfix dovecot --no-pager
Registre o resultado numa planilha simples com uma linha por assinatura testada. Em servidor de agência com muitos sites, essa planilha é o que você mostra ao cliente que reclama no dia seguinte: a assinatura dele foi verificada, está anotado o horário.
Quando o upgrade para no meio: retomar, reparar ou reverter
Três caminhos, nessa ordem de preferência.
Retomar o autoinstaller. Para falha de rede, repositório indisponível ou disco cheio já corrigido, rodar plesk installer de novo retoma de onde parou. É o caminho menos destrutivo e costuma dar conta desse tipo de falha. Corrija a causa apontada no log antes de retomar; repetir o comando sem mexer em nada só repete o erro.
Reparar o Plesk. Se o painel sobe mas se comporta de forma estranha (componentes fora de sincronia, serviço que não inicia), use as ferramentas de reparo do Plesk antes de pensar em restaurar. O utilitário de linha de comando plesk repair cobre os casos típicos: plesk repair installation reconcilia a instalação do painel, plesk repair web as configurações de web server dos domínios e plesk repair mail as de e-mail. Rode primeiro em modo de verificação, sem aplicar nada, leia o relatório e só então autorize a correção. Depois, valide pelo que o reparo deveria ter arrumado: painel abrindo em 8443, site da assinatura afetada respondendo 200 e serviço que estava parado ativo no systemctl status.
Reverter pelo snapshot. Reserve para falha estrutural: migração do banco do painel interrompida, sistema de pacotes quebrado, servidor sem SSH. Restaurar o snapshot devolve o servidor ao estado pré-janela, incluindo a versão antiga do painel. O custo é perder tudo que entrou depois do snapshot: e-mails recebidos, pedidos, comentários. Por isso a janela precisa ser curta e em horário de baixo movimento, e por isso vale avisar o cliente de e-commerce separadamente.
Se chegou na reversão, não tente de novo no mesmo dia. Leia o log inteiro, descubra a causa, resolva o pré-requisito (espaço, distribuição, pacote conflitante) e remarque. Upgrade tentado duas vezes na mesma madrugada, no cansaço, é como se perde dado.
Repetir a mesma janela em vários servidores e parar de estimar no chute
Se você mantém mais de um servidor Plesk, transforme isso num procedimento fixo em vez de improvisar a cada versão:
- Um servidor de menor criticidade sobe primeiro, com uma semana de observação antes dos demais.
- Mesma janela semanal para todos (exemplo: domingo, 6h às 8h), comunicada uma vez no contrato de manutenção.
- Um modelo único de e-mail de aviso, com data e hora como únicas variáveis.
- A mesma planilha de validação, com as assinaturas de amostra já escolhidas por servidor.
- Snapshot obrigatório, sem exceção, mesmo em upgrade "pequeno".
- Um registro curto após cada janela: versão de origem, versão de destino, duração real, o que deu errado.
Esse último item é o que mais rende com o tempo. Depois de três ou quatro janelas registradas, você para de estimar duração no chute e passa a dizer ao cliente um intervalo baseado no seu próprio histórico, naquele servidor, com aquele perfil de sites. A documentação oficial do Plesk dá o procedimento; o tempo real de cada servidor só o seu registro dá.
Referências
- Documentação oficial (plesk) — Plesk Obsidian Deployment Guide. Consultado em 2026-11-01.