Mettre à jour le serveur ISPConfig Perfect de Debian 11 vers Debian 12
Ce tutoriel vous guidera dans la mise à jour d'un serveur géré par ISPConfig de Debian 11 (bullseye) vers Debian 12 (bookworm). Ce guide fonctionne pour les configurations monoserveurs et multiserveurs. Répétez simplement les mêmes étapes sur chaque serveur.
Sachez que le processus de mise à jour peut entraîner des temps d'arrêt.
Conditions préalables
- Assurez-vous que vous êtes connecté en tant qu'utilisateur root
1. Mise à jour du système de Debian 11 vers Debian 12
Veuillez d'abord consulter le guide sur la mise à jour de Debian elle-même : https://linux-console.net/how-to-upgrade-from-debian-11-to-debian-12/
2. Installez les packages 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 version supplémentaire en suivant https://linux-console.net/ispconfig-php-debian/
4. Exécutez 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 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. Lorsqu'on vous demande si vous souhaitez reconfigurer les services ou non, appuyez sur Entrée. Si vous sautez cette étape en répondant « non », ISPConfig ne configurera pas vos services pour Debian 12 et certains services pourraient être interrompus.
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 administrateur, puis accédez à 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, pour que cela ressemble à ceci :
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
Sachez que tous les sites Web de ce serveur qui utilisent la version PHP "Default" utiliseront désormais 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 de PHP, sélectionnez PHP 8.2. Ensuite, courez
update-alternatives --config php-cgi
Si vous devez sélectionner une version de PHP, sélectionnez également PHP 8.2. Enfin, courez
update-alternatives --config php-fpm.sock
Si vous devez sélectionner une version de PHP, sélectionnez à nouveau PHP 8.2.
Pour les serveurs sur lesquels Apache2 est installé, nous devons désactiver PHP-FPM 7.4 comme 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. Mettez à jour phpMyAdmin (facultatif)
Si phpMyAdmin est installé, nous vous recommandons de mettre à jour votre installation car de nombreux utilisateurs ont installé une version obsolète.
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 désormais maintenir phpMyAdmin à jour automatiquement en utilisant ce même script. Consultez ce message du forum pour plus d'informations : https://linux-console.net/community/threads/keep-your-phpmyadmin-installation-up-to-date-automatically.88495/
Avaient fini! Si vous rencontrez des problèmes, ouvrez un fil de discussion sur le forum.