Atualize o Servidor Perfeito ISPConfig do Debian 11 para o Debian 12

Este tutorial irá guiá-lo na atualização de um servidor gerenciado pelo ISPConfig do Debian 11 (bullseye) para o Debian 12 (bookworm). Este guia funciona tanto para configurações de servidor único quanto para múltiplos servidores. Basta repetir os mesmos passos em cada servidor.

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

Pré-requisitos

Certifique-se de que você está logado como usuário root

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

Por favor, passe pelo guia sobre como atualizar o Debian em si primeiro: https://www.howtoforge.com/how-to-upgrade-from-debian-11-to-debian-12/

2. Instalar pacotes PHP ausentes

O Debian 12 vem com o PHP 8.2 como a versão padrão do PHP, então precisamos 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://www.howtoforge.com/ispconfig-php-debian/

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

Para reconfigurar os serviços para que eles sejam configurados corretamente para o Debian 12, precisamos executar o script de atualização do ISPConfig e deixá-lo reconfigurar os serviços. Execute o script a partir da linha de comando com

ispconfig_update.sh --force

Passe pelos passos de atualização. Quando perguntado se você 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 podem estar quebrados.

5. Atualizar 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 enviada com o Debian 12, precisamos atualizar os caminhos do PHP no ISPConfig.

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

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

Caminho do php.ini do Apache: /etc/php/8.2/apache2/php.ini  
Caminho do php.ini do CGI: /etc/php/8.2/cgi/php.ini  
Script de inicialização do PHP-FPM: php8.2-fpm  
Caminho do php.ini do PHP-FPM: /etc/php/8.2/fpm/php.ini  
Diretório do pool do PHP-FPM: /etc/php/8.2/fpm/pool.d  
Diretório do socket do PHP-FPM: /var/lib/php8.2-fpm

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

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

update-alternatives --config php

Se você precisar selecionar uma versão do PHP, selecione o PHP 8.2. Em seguida, execute

update-alternatives --config php-cgi

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

update-alternatives --config php-fpm.sock

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

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

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

6. Atualizar o phpMyAdmin (opcional)

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

Execute este comando para rodar 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. Veja esta postagem no fórum para mais informações: https://www.howtoforge.com/community/threads/keep-your-phpmyadmin-installation-up-to-date-automatically.88495/

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