blog
Painéis

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.

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

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
  1. O que cai e o que continua no ar durante o upgrade
  2. Conferir se o sistema operacional ainda é suportado pela versão de destino
  3. Snapshot ou backup do Plesk: qual dos dois permite reverter
  4. Rodar o autoinstaller em sessão persistente e ler o log em paralelo
  5. Validação pós-upgrade em três a cinco assinaturas representativas
  6. Quando o upgrade para no meio: retomar, reparar ou reverter
  7. 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:

  1. Distribuição e versão do SO estão na lista de suportados da versão de destino.
  2. Espaço em disco sobrando em /, /var e /tmp. Disco cheio interrompe o upgrade e aparece no log de instalação como No space left on device.
  3. Backup ou snapshot concluído e verificado (próxima seção).
  4. Nenhuma outra operação pesada agendada para a janela: cron de backup, importação de banco, crawl de SEO.
  5. Acesso SSH funcionando com usuário que não dependa do painel, porque o painel vai estar fora.
  6. 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:

Não feche a sessão achando que travou porque a tela ficou parada. Confirme pelo log antes de interromper qualquer coisa.

Sequência da janela de upgrade do PleskPré-checkSO suportado, disco, SSHSnapshotTirar e verificar antesAutoinstallerEm screen, log em paraleloValidaçãoAssinaturas de amostraRegistroDuração real e falhas
Sequência fixa da janela de manutenção do Plesk, do pré-check ao registro pós-janela.

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.

Decisão quando o upgrade para no meioFalha de rede ou discoCorrigir causa e retomarPainel sobe estranhoplesk repair em modo verificaçãoReparo resolveuValidar 8443, site, serviçoFalha estruturalReverter pelo snapshotDepois de reverterLer log, remarcar outro dia
Ordem de preferência quando o autoinstaller para no meio: retomar, reparar, reverter.

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:

  1. Um servidor de menor criticidade sobe primeiro, com uma semana de observação antes dos demais.
  2. Mesma janela semanal para todos (exemplo: domingo, 6h às 8h), comunicada uma vez no contrato de manutenção.
  3. Um modelo único de e-mail de aviso, com data e hora como únicas variáveis.
  4. A mesma planilha de validação, com as assinaturas de amostra já escolhidas por servidor.
  5. Snapshot obrigatório, sem exceção, mesmo em upgrade "pequeno".
  6. 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

  1. Documentação oficial (plesk) — Plesk Obsidian Deployment Guide. Consultado em 2026-11-01.
Leia também