Atualize o ISPConfig Perfect Server do Debian 11 para o Debian 12

Este tutorial irá guiá-lo pela atualização de um servidor gerenciado por ISPConfig do Debian 11 (bullseye) para o Debian 12 (bookworm). Este guia funciona para configurações de servidor único e multiservidor. Basta repetir as mesmas etapas em todos os servidores.

Esteja ciente de que o processo de atualização pode causar algum tempo de inatividade.

Pré-requisitos

Certifique-se de estar logado como usuário root

1. Atualizando o sistema do Debian 11 para o Debian 12

Por favor, leia primeiro o guia sobre como atualizar o Debian: https://linux-console.net/how-to-upgrade-from-debian-11-to-debian-12/

2. Instale pacotes PHP ausentes

O Debian 12 vem com PHP 8.2 como versão padrão do PHP, então temos que instalá-lo:

apt-get install php8.2 php8.2-cli php8.2-cgi php8.2-fpm php8.2-gd php8.2-mysql php8.2-imap php8.2-curl php8.2-intl php8.2-pspell php8.2-sqlite3 php8.2-tidy php8.2-xsl php8.2-zip php8.2-mbstring php8.2-soap php8.2-opcache libonig5 php8.2-common php8.2-readline php8.2-xml curl

Não se esqueça de ajustar os arquivos de configuração do PHP, se necessário.

Se você ainda quiser usar o PHP 7.4 para alguns sites, instale-o como uma versão adicional seguindo https://linux-console.net/ispconfig-php-debian/

4. Execute uma atualização forçada do ISPConfig

Para reconfigurar os serviços para que fiquem configurados corretamente para o Debian 12, precisamos executar o script de atualização ISPConfig e deixá-lo reconfigurar os serviços. Execute o script na linha de comando com

ispconfig_update.sh --force

Siga as etapas de atualização. Quando questionado se deseja reconfigurar os serviços ou não, pressione Enter. Se você pular esta etapa respondendo "não", o ISPConfig não configurará seus serviços para o Debian 12 e alguns serviços poderão estar quebrados.

5. Atualize os caminhos para usar o PHP 8.2 como versão padrão do PHP

Como o PHP 8.2 é a versão padrão do PHP fornecida com o Debian 12, precisamos atualizar os caminhos do PHP no ISPConfig.

Faça login no painel como usuário administrador e vá para Sistema -> Configuração do servidor -> server1.example.com (o nome do host do seu servidor) -> Web -> Configurações de PHP

Substitua as referências de 7.4 por 8.2, para que fique assim:

Apache php.ini path: /etc/php/8.2/apache2/php.ini
CGI php.ini path: /etc/php/8.2/cgi/php.ini
PHP-FPM init script: php8.2-fpm
PHP-FPM php.ini path: /etc/php/8.2/fpm/php.ini
PHP-FPM pool directory: /etc/php/8.2/fpm/pool.d
PHP-FPM socket directory: /var/lib/php8.2-fpm

Esteja ciente de que todos os sites neste servidor que usam a versão "Padrão" do PHP agora usarão o PHP 8.2 em vez da versão antiga.

Também temos que permitir que o sistema use PHP 8.2 como manipulador PHP padrão para ações não ISPConfig. Para fazer isso, execute:

update-alternatives --config php

Se você precisar selecionar uma versão do PHP, selecione PHP 8.2. Então corra

update-alternatives --config php-cgi

Se você precisar selecionar uma versão do PHP, selecione PHP 8.2 também. Por último, corra

update-alternatives --config php-fpm.sock

Se você precisar selecionar uma versão do PHP, selecione PHP 8.2 novamente.

Para servidores com Apache2 instalado, temos que desabilitar o PHP-FPM 7.4 como manipulador PHP padrão e habilitar o PHP-FPM 8.2 executando estes comandos:

a2disconf php7.4-fpm
a2enconf php8.2-fpm
systemctl restart apache2

6. Atualize o phpMyAdmin (opcional)

Se você possui o phpMyAdmin instalado, recomendamos atualizar sua instalação, pois muitos usuários possuem uma versão desatualizada instalada.

Execute este comando para executar nosso script de atualização do phpMyAdmin:

curl https://git.ispconfig.org/ispconfig/tools/-/raw/master/auto_update_phpmyadmin.sh -sL | sh

Você pode manter o phpMyAdmin atualizado automaticamente a partir de agora usando este mesmo script. Consulte esta postagem do fórum para obter mais informações: https://linux-console.net/community/threads/keep-your-phpmyadmin-installation-up-to-date-automatically.88495/

Foram realizadas! Se você tiver algum problema, abra um tópico no fórum.