Atualize o Servidor Perfeito ISPConfig do Ubuntu 20.04 para Ubuntu 22.04

Este tutorial irá guiá-lo na atualização de um servidor gerenciado pelo ISPConfig do Ubuntu 20.04 (Focal Fossa) para o Ubuntu 22.04 (Jammy Jellyfish). Este guia funciona tanto para configurações de servidor único quanto para múltiplos servidores. Basta repetir os mesmos passos em cada servidor.

Atenção: o mailman2 não é suportado no Ubuntu 22.04, e o mailman3 não é (ainda) suportado pelo ISPConfig.

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 Ubuntu 20.04 para o Ubuntu 22.04

Por favor, consulte o guia sobre como atualizar o Ubuntu: https://www.howtoforge.com/ubuntu-20-04-to-22-04-upgrade/

2. Limpar o mailman

Se o mailman2 foi instalado, devemos renomear o diretório de dados para evitar conflitos de transporte de e-mail.

mv /var/lib/mailman /var/lib/mailman-bk

Em seguida, execute estes comandos:

mkdir -p /var/lib/mailman/data/  
touch /var/lib/mailman/data/{aliases,transport-mailman,virtual-mailman}  
postmap /var/lib/mailman/data/{aliases,transport-mailman,virtual-mailman}

para criar alguns arquivos vazios em vez disso.

3. Instalar pacotes PHP ausentes

O Ubuntu 22.04 vem com PHP 8.1 como a versão padrão do PHP, então precisamos instalá-lo (junto com o curl necessário posteriormente):

apt -y install php8.1 php8.1-cli php8.1-cgi php8.1-fpm php8.1-gd php8.1-mysql php8.1-imap php8.1-curl php8.1-intl php8.1-pspell php8.1-sqlite3 php8.1-tidy php8.1-xsl php8.1-zip php8.1-mbstring php8.1-soap php8.1-opcache php8.1-common php8.1-readline php8.1-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/tutorial/how-to-install-php-7-for-ispconfig-3-from-debian-packages-on-debian-8-and-9/

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

Para reconfigurar os serviços para que estejam corretamente configurados para o Debian 11, 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

Siga os passos da 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 Ubuntu 22.04 e alguns serviços podem estar quebrados.

5. Atualizar caminhos para usar PHP 8.1 como versão padrão do PHP

Como o PHP 8.1 é a versão padrão do PHP enviada com o Ubuntu 22.04, 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.1, para que fique assim:

Apache php.ini path: /etc/php/8.1/apache2/php.ini  
CGI php.ini path: /etc/php/8.1/cgi/php.ini  
PHP-FPM init script: php8.1-fpm  
PHP-FPM php.ini path: /etc/php/8.1/fpm/php.ini  
PHP-FPM pool directory: /etc/php/8.1/fpm/pool.d  
PHP-FPM socket directory: /var/lib/php8.1-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.1 em vez da versão antiga.

Também precisamos deixar o sistema usar o PHP 8.1 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.1. Em seguida, execute

update-alternatives --config php-cgi

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

update-alternatives --config php-fpm.sock

Se você precisar selecionar uma versão do PHP, selecione o PHP 8.1 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.1 executando estes comandos:

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

6. Atualizar 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.