blog
Servidores

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.

JR · · 9 min de leitura · 2 tabelas · 10 blocos de código

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
  1. O que a elevação in-place resolve, e o que ela não resolve
  2. Três coisas para conferir antes de abrir a janela
  3. O que a conversão preserva e o que você leva na mão
  4. A janela real, dividida em três blocos de risco
  5. Como rodar a conversão sem perder o terminal no meio
  6. Checklist pós-conversão, na ordem em que o cliente reclama
  7. 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:

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.

Os três blocos de risco da janelaPré-check e correçõesServiço no ar, bloqueios resolvidosConversão e rebootsIndisponibilidade total, vários reiníciosPós-conversãoServiços sobem, validação parcial
Só o bloco do meio é indisponibilidade total. Duração não medida em laboratório.

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:

Contra o nosso próprio interesse, dois casos em que a conversão in-place é a escolha errada:

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.

Converter in-place ou instalar servidor novoStack limpa e gerenciada pelo painel?Binários à mão e repos fixados reprovamMuitas contas e muito e-mail?Poucos domínios favorecem transferênciaIP precisa ser preservado?Evita refazer DNS e nameserverSim nos três: elevação in-placeSnapshot, check limpo, console abertoAlgum não: servidor novoTransferir conta a conta pelo WHM
Critério de decisão antes de agendar a janela.

Referências

  1. Documentação oficial (cpanel) — How to Convert from CentOS 8 to AlmaLinux OS. Consultado em 2026-10-07.
Leia também