CentOS 7 para AlmaLinux 8 com cPanel sem reinstalar
O que a ferramenta converte, o que ela deixa para trás e o checklist de validação que acha a quebra antes do cliente abrir chamado.

Resposta curta: a conversão in-place com ELevate/Leapp preserva contas, /home, zonas DNS, bancos e certificados sem reinstalar, mas exige pré-check limpo, snapshot do hipervisor como única reversão e validação de ea-php, Exim/Dovecot, MariaDB e AutoSSL depois dos reboots.
Neste artigo
- O que a elevação in-place resolve, e o que ela não resolve
- Três coisas para conferir antes de abrir a janela
- O que a conversão preserva e o que você leva na mão
- A janela real, dividida em três blocos de risco
- Como rodar a conversão sem perder o terminal no meio
- Checklist pós-conversão, na ordem em que o cliente reclama
- Reversão e quando simplesmente não converter
O que a elevação in-place resolve, e o que ela não resolve
Elevação in-place (ELevate, que usa o Leapp por baixo) troca a distribuição do servidor sem reinstalar: o disco continua o mesmo, /home continua o mesmo, as contas do cPanel continuam no lugar, o IP não muda e você não precisa refazer DNS nem avisar cliente para trocar nameserver. É a diferença entre um dia de janela programada e uma semana de migração conta a conta.
O que ela não resolve: o sistema de pacotes muda de verdade. Repositórios de terceiros, módulos Perl compilados à mão, binários estáticos jogados em /usr/local/bin, builds antigos de ImageMagick, agentes de monitoramento empacotados para EL7, tudo isso é responsabilidade sua antes e depois. Leapp bloqueia o que não sabe tratar, e é exatamente por isso que o pré-check existe.
A documentação do cPanel para o caminho CentOS 8 para AlmaLinux OS (docs.cpanel.net) descreve o modelo mental que vale para qualquer conversão suportada: você confirma a versão do painel, roda a verificação, resolve os bloqueios, executa a conversão e valida o servidor depois. O procedimento específico de CentOS 7 para AlmaLinux 8 é o ELevate; confirme na documentação da versão que você baixou antes de rodar qualquer coisa, porque a sintaxe do script e a lista de bloqueios mudam entre releases.
Três coisas para conferir antes de abrir a janela
Versão do cPanel e do sistema, e o espaço livre que derruba o Leapp
Conversão só é suportada em combinações de versão específicas, e o piso sobe a cada release do ELevate. Antes de agendar a janela, verifique na documentação do ELevate qual a minor de CentOS 7 exigida na origem, qual a tier mínima de cPanel & WHM, qual a minor de AlmaLinux OS 8 usada como destino e qual o piso de espaço livre recomendado. Esses quatro parâmetros mudam entre releases do script e não adianta copiar número de post antigo. Comece pelas duas pontas:
/usr/local/cpanel/cpanel -V
cat /etc/redhat-release
uname -r
Se o painel estiver em uma tier antiga, atualize o cPanel antes da conversão, não depois. Converter distribuição e subir major do painel na mesma janela junta duas fontes de falha que você vai ter dificuldade de separar quando algo quebrar.
Espaço livre é a causa clássica de falha do Leapp, e ela aparece no meio do processo, não no --check. O Leapp baixa a árvore de pacotes do destino e monta o userspace de upgrade em /var/lib/leapp, então / precisa de folga em GB (o valor mínimo está na documentação do ELevate; confira lá, e some mais se /var não for partição separada). E /boot precisa caber o kernel e o initramfs do upgrade: em uma partição de 500 MB com três kernels EL7 instalados, não cabe. Confira e limpe antes:
df -h / /boot /var
rpm -q kernel
package-cleanup --oldkernels --count=1
Inventário dos pacotes de terceiros que travam a conversão
O que não veio dos repositórios oficiais é o que costuma travar o Leapp. Levante a lista antes:
yum repolist enabled
rpm -qa --qf '%{NAME} %{VENDOR} %{PACKAGER}\n' | grep -vi -e cpanel -e 'CentOS' | sort
Cruze com o que está rodando de verdade: agente de backup, antivírus, Imunify, monitoramento, driver de armazenamento, qualquer repositório de EPEL fixado em versão.
Backup que você consegue restaurar em outro host
Snapshot do hipervisor é o seu ponto de retorno real, porque conversão de distribuição não tem rollback por yum history. Além do snapshot, garanta uma cópia fora do servidor de:
/home(contas, mail, webspace)/var/cpanel(configuração do painel, usuários, pacotes, zonas internas)/var/lib/mysqlou dump lógico por banco/etc/inteiro, ou no mínimonamed,exim*,dovecot,my.cnf/etc/apache2/confe/etc/apache2/conf.d/userdataquando houver include customizado (em EA4, que é o único EasyApache suportado no caminho para EL8;/usr/local/apache/confsó existe em legado EA3)
Se o snapshot do hipervisor é a sua reversão, teste que você sabe acioná-lo. Snapshot que ninguém nunca restaurou é esperança, não plano.
O que a conversão preserva e o que você leva na mão
| Item | Comportamento esperado | O que validar depois |
|---|---|---|
Contas do cPanel e /home |
Preservado no disco | Login no cPanel, permissões de public_html |
| Zonas DNS locais | Preservadas em /var/cpanel e named |
named-checkzone e resposta do resolver |
| Bancos MySQL/MariaDB | Dados preservados | Versão do engine, tabelas de sistema, grants |
| Certificados e chaves TLS | Preservados | Cadeia completa servida, renovação AutoSSL |
| Versões de PHP (ea-php) | Reinstaladas na nova base EL | Conjunto de extensões por versão |
| Repositórios de terceiros | Podem ser removidos ou desabilitados | Reinstalar com o repo da EL correta |
| Módulos Perl/Python via CPAN/pip | Não migram sozinhos | Recompilar na nova stack |
| Kernels e módulos fora de árvore | Não migram | Reconstruir ou remover antes |
A regra prática: dado é preservado, software empacotado por terceiros é problema seu.
A janela real, dividida em três blocos de risco
Não prometa ao cliente "meia hora". A janela tem três blocos com perfis diferentes de risco, e só o segundo é indisponibilidade total.
| Etapa | Serviço no ar | O que acontece |
|---|---|---|
| Pré-check e correções | Sim | Verificação, remoção de repositórios incompatíveis, update do painel |
| Conversão e reboots | Não | Leapp troca a base do sistema, servidor reinicia mais de uma vez |
| Pós-conversão e validação | Parcial | Serviços sobem, você valida e corrige o que ficou fora |
A Napoleon não mediu a duração dessas etapas em laboratório e não vai estimar número aqui. A duração depende de disco, quantidade de pacotes, tamanho de /var/lib/mysql e da velocidade do mirror. O que dá para afirmar com segurança: o servidor reinicia mais de uma vez durante a conversão e fica inacessível por e-mail e web no bloco do meio. Planeje a comunicação em cima disso e mantenha acesso de console (KVM, VNC, serial) do painel do provedor aberto, porque se o boot parar você não vai entrar por SSH.
Como rodar a conversão sem perder o terminal no meio
Rodar a verificação antes da conversão
O script do ELevate tem um modo de verificação que lista os bloqueios sem alterar nada. Rode, leia a saída inteira e trate cada bloqueio:
# exemplo de uso; confirme a sintaxe na documentação da versão baixada
/scripts/elevate-cpanel --check
Bloqueio típico: repositório de terceiro habilitado, pacote sem equivalente em EL8, versão de PHP fora do EasyApache, MySQL em versão não suportada no destino. Cada item resolvido é um item a menos para descobrir às três da manhã.
Iniciar a conversão
Comece apenas com --check limpo, snapshot feito e console aberto. Use screen ou tmux: queda de SSH no meio de um estágio que ainda não desacoplou do terminal é um jeito caro de aprender a lição.
screen -S elevate
/scripts/elevate-cpanel --start
O processo acompanha os estágios e os reboots. Não intervenha entre reinícios achando que travou; acompanhe pelo log que o próprio script indica e pelo console do hipervisor.
Checklist pós-conversão, na ordem em que o cliente reclama
Versões de PHP e handlers por domínio depois do EasyApache
O EasyApache reinstala as versões, mas o conjunto de extensões nem sempre volta idêntico, e o handler por domínio pode cair no default.
rpm -qa | grep ^ea-php | sort
php -v
/usr/local/cpanel/bin/rebuild_phpconf --current
Confira em MultiPHP Manager se cada domínio continua na versão que estava, e teste um phpinfo() real buscando as extensões que a aplicação usa (intl, imagick, soap, ioncube).
Exim e Dovecot: testar envio autenticado, não o status do serviço
E-mail é o primeiro a gerar chamado e o último que você lembra de testar. Valide envio autenticado e recebimento, não só o status do serviço:
systemctl status exim dovecot
exim -bV
doveconf -n > /root/doveconf-pos.txt
openssl s_client -connect 127.0.0.1:587 -starttls smtp -quiet
Pontos de quebra conhecidos nesse tipo de troca de base: cipher suites e versões de TLS mais restritivas no novo OpenSSL derrubando clientes antigos em 587 e 993, e caminhos de certificado do hostname que o serviço não encontra mais. Teste com um cliente real, não só com telnet.
MariaDB e MySQL: quando rodar mysql_upgrade e quando não rodar
A troca de base muda o módulo e pode mudar a minor version do engine. Suba o serviço, confirme qual engine e qual versão você tem na mão antes de rodar qualquer upgrade:
mysql -e 'SELECT VERSION();'
mysql -e "SHOW VARIABLES LIKE 'log_error'"
O upgrade de tabelas de sistema depende do destino. Em MariaDB (na série que o seu cPanel oferece, confira na documentação da versão instalada) rode mysql_upgrade --force, que a partir do MariaDB 10.5 é o symlink de mariadb-upgrade. Em MySQL 8.0.16 e superiores você não precisa rodar nada: o próprio servidor executa o upgrade do data dictionary e das tabelas de sistema durante o start, e o mysql_upgrade ficou obsoleto (deprecado, sem efeito prático). O binário pode continuar presente no pacote dependendo da release e do empacotador, então encontrá-lo no PATH não significa que ele ainda seja o caminho correto. Em MySQL 5.7 o mysql_upgrade --force continua valendo.
O caminho do log de erro sai do log_error lido acima, não de um palpite: em cPanel o padrão é /var/lib/mysql/<FQDN>.err, e my.cnf pode ter apontado para outro lugar. Com o valor em mãos:
tail -n 100 "$(mysql -NB -e "SELECT @@log_error")"
Se o serviço nem sobe para responder a essa consulta, pegue o caminho direto do arquivo de configuração (grep -r log_error /etc/my.cnf /etc/my.cnf.d/) ou caia no journalctl -u mysqld -n 100.
Se o serviço não subir, leia o .err antes de mexer em qualquer coisa. Parâmetro de my.cnf herdado de uma versão antiga (variável removida no engine novo) é causa frequente de recusa de start, e a correção é remover a linha, não reinstalar o banco.
Validar a cadeia TLS servida e forçar o AutoSSL
Certificado continua no lugar, mas o store de CAs e a lib de TLS mudaram. Valide a cadeia servida pela borda, não o arquivo no disco:
openssl s_client -connect exemplo.com.br:443 -servername exemplo.com.br -showcerts </dev/null | head -n 20
Depois force uma execução do AutoSSL pelo WHM em Manage AutoSSL e acompanhe o log do provedor. Erro de validação HTTP aqui normalmente é regra de rewrite ou .well-known bloqueado, não problema do certificado.
Reinstalar monitoramento, antivírus e backup com o repositório da EL8
Reinstale agora, com o repositório da EL8: monitoramento, antivírus, backup externo, agente de WAF. Confirme que cada um subiu e está reportando, porque backup que parou de rodar na conversão só aparece no dia em que você precisa dele.
Reversão e quando simplesmente não converter
Não existe reversão por pacote. A reversão é o snapshot: você volta o volume ao estado anterior à conversão e perde tudo que entrou no servidor desde então. Por isso duas decisões operacionais valem a pena:
- Congelar escrita antes do snapshot, ou aceitar que e-mails recebidos durante a janela se perdem no rollback.
- Definir no papel, antes de começar, o critério e o prazo para desistir. Sem horário-limite, a tendência é insistir até ficar sem janela.
Contra o nosso próprio interesse, dois casos em que a conversão in-place é a escolha errada:
- Servidor com histórico de gambiarra acumulada. Se a stack tem binários compilados à mão, versões de PHP fora do EasyApache e repositórios fixados, instalar um servidor novo em AlmaLinux 8 e transferir conta por conta pelo próprio cPanel costuma dar menos trabalho e tem rollback trivial: você só não vira o DNS.
- Servidor pequeno com poucas contas. Com poucos domínios, a transferência pelo WHM com janela por conta é mais previsível que converter tudo de uma vez.
A conversão in-place brilha no caso oposto: muitas contas, muito e-mail, IP que não pode mudar, stack limpa e dentro do que o painel gerencia. Aí ela economiza uma semana de trabalho e um monte de ticket de propagação.
Uma última coisa sobre ordem: atualize o cPanel, resolva o --check, tire o snapshot, converta, valide. Trocar essa ordem é a forma mais comum de transformar uma janela programada em uma madrugada ruim.
Referências
- Documentação oficial (cpanel) — How to Convert from CentOS 8 to AlmaLinux OS. Consultado em 2026-10-07.