Mettre à jour le serveur parfait ISPConfig de Debian 11 à Debian 12

Ce tutoriel vous guidera à travers la mise à jour d’un serveur géré par ISPConfig de Debian 11 (bullseye) à Debian 12 (bookworm). Ce guide fonctionne pour les configurations à serveur unique et multiserveur. Il suffit de répéter les mêmes étapes sur chaque serveur.

Soyez conscient que le processus de mise à jour peut entraîner un certain temps d’arrêt.

Prérequis

• Assurez-vous d’être connecté en tant qu’utilisateur root

1. Mise à jour du système de Debian 11 à Debian 12

Veuillez d’abord consulter le guide sur la mise à jour de Debian lui-même : https://www.howtoforge.com/how-to-upgrade-from-debian-11-to-debian-12/

2. Installer les paquets PHP manquants

Debian 12 est livré avec PHP 8.2 comme version PHP par défaut, nous devons donc l’installer :

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’oubliez pas d’ajuster les fichiers de configuration PHP si nécessaire.

Si vous souhaitez toujours utiliser PHP 7.4 pour certains sites Web, installez-le en tant que version supplémentaire en suivant https://www.howtoforge.com/ispconfig-php-debian/

4. Exécuter une mise à jour forcée d’ISPConfig

Pour reconfigurer les services afin qu’ils soient correctement configurés pour Debian 12, nous devons exécuter le script de mise à jour d’ISPConfig et le laisser reconfigurer les services. Exécutez le script depuis la ligne de commande avec

ispconfig_update.sh --force

Suivez les étapes de mise à jour. Lorsque vous êtes invité à reconfigurer les services ou non, appuyez sur entrer. Si vous sautez cette étape en répondant “non”, ISPConfig ne configurera pas vos services pour Debian 12 et certains services pourraient être cassés.

5. Mettre à jour les chemins pour utiliser PHP 8.2 comme version PHP par défaut

Comme PHP 8.2 est la version PHP par défaut livrée avec Debian 12, nous devons mettre à jour les chemins PHP dans ISPConfig.

Connectez-vous au panneau en tant qu’utilisateur admin, puis allez à Système -> Configuration du serveur -> server1.example.com (le nom d’hôte de votre serveur) -> Web -> Paramètres PHP

Remplacez les références à 7.4 par 8.2, de sorte que cela ressemble à ceci :

Chemin php.ini d'Apache : /etc/php/8.2/apache2/php.ini  
Chemin php.ini CGI : /etc/php/8.2/cgi/php.ini  
Script d'initialisation PHP-FPM : php8.2-fpm  
Chemin php.ini PHP-FPM : /etc/php/8.2/fpm/php.ini  
Répertoire de pool PHP-FPM : /etc/php/8.2/fpm/pool.d  
Répertoire de socket PHP-FPM : /var/lib/php8.2-fpm

Soyez conscient que tous les sites Web sur ce serveur qui utilisent la version PHP “Par défaut” utiliseront maintenant PHP 8.2 au lieu de l’ancienne version.

Nous devons également laisser le système utiliser PHP 8.2 comme gestionnaire PHP par défaut pour les actions non-ISPConfig. Pour ce faire, exécutez :

update-alternatives --config php

Si vous devez sélectionner une version PHP, sélectionnez PHP 8.2. Ensuite, exécutez

update-alternatives --config php-cgi

Si vous devez sélectionner une version PHP, sélectionnez également PHP 8.2. Enfin, exécutez

update-alternatives --config php-fpm.sock

Si vous devez sélectionner une version PHP, sélectionnez à nouveau PHP 8.2.

Pour les serveurs avec Apache2 installé, nous devons désactiver PHP-FPM 7.4 en tant que gestionnaire PHP par défaut et activer PHP-FPM 8.2 en exécutant ces commandes :

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

6. Mettre à jour phpMyAdmin (optionnel)

Si vous avez phpMyAdmin installé, nous vous recommandons de mettre à jour votre installation car de nombreux utilisateurs ont une version obsolète installée.

Exécutez cette commande pour exécuter notre script de mise à jour phpMyAdmin :

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

Vous pouvez garder phpMyAdmin à jour automatiquement à partir de maintenant en utilisant ce même script. Consultez ce post de forum pour plus d’informations : https://www.howtoforge.com/community/threads/keep-your-phpmyadmin-installation-up-to-date-automatically.88495/

Nous avons terminé ! Si vous avez des problèmes, ouvrez un fil sur le forum.