Prise en charge de Dist-Upgrade

À compter de Plesk 12.5, vous pouvez mettre à niveau le système d'exploitation sur un serveur Plesk. Les mises à niveau "dist-upgrade" suivantes sont prises en charge dans Plesk :

• Debian 6 vers Debian 7
• Debian 7 vers Debian 8
• Ubuntu 12.04 vers Ubuntu 14.04

Avertissement : si vous exécutez Plesk sur une distribution Linux qui n'est ni Debian 6, Debian 7, ni Ubuntu 12.04, n'essayez pas de mettre à niveau le système d'exploitation. Ce type de mise à niveau n'est pas pris en charge par Odin. Si vous essayez de procéder à a mise à niveau, vous endommagerez votre installation Plesk.

Avertissement : lisez avec précaution toutes les instructions ci-dessous et suivez-les scrupuleusement. Dans le cas contraire, Plesk et ses services risquent de devenir inutilisables.

Pour procéder à la mise à niveau "dist-upgrade" suivez ces étapes :

1. Avant de lancer dist-upgrade, assurez-vous de lire les informations sur les problèmes que vous pouvez rencontrer :
   • Si vous mettez à niveau depuis Debian 6, consultez la page : https://www.debian.org/releases/wheezy/amd64/release-notes/ch-upgrading.en.html#trouble.
   • Si vous mettez à niveau depuis Debian 7, consultez la page : https://www.debian.org/releases/stable/i386/release-notes/ch-upgrading.en.html#trouble.
2. Exécutez le script de pré-mise à niveau. Ce script est appelé distupgrade.helper.<OS.old-OS.new>_pre.sh et se trouve dans le répertoire /usr/local/psa/bin.
3. Exécutez la mise à niveau dist-upgrade conformément à la documentation du système d'exploitation:
   • Debian 6 : suivez les informations disponibles sur la page http://www.debian.org/releases/wheezy/i386/release-notes/ch-upgrading.html.
   • Debian 7 : suivez les informations disponibles sur la page https://www.debian.org/releases/jessie/i386/release-notes/ch-upgrading.en.html
   • Ubuntu 12.04 : utilisez l'outil do-release-upgrade comme décrit sur la page https://help.ubuntu.com/14.04/serverguide/installing-upgrading.html
4. Exécutez le script de post-mise à niveau. Ce script est appelé distupgrade.helper.<OS.old-OS.new>_post.sh et se trouve dans le répertoire /usr/local/psa/bin.

Une fois que le script post-mise à niveau a terminé, Plesk doit être opérationnel et en cours d'exécution. Vous pouvez vérifier le log de mise à niveau /var/log/plesk/install/plesk-distupgrade.log pour en savoir plus sur la mise à niveau.

Récupérer après un échec de dist-upgrade

Pour récupérer après l'échec d'une mise à niveau dist-upgrade, suivez ces étapes :

Vérifier les mises à jour des packs système

1. Vérifiez si /etc/apt/sources.list et si les répertoires dans /etc/apt/sources.list.d/ ont basculé vers la nouvelle version de l'OS (par ex. "jessie" si vous mettez à niveau vers Debian 8, "wheezy", vers Debian 7 et "trusty" vers Ubuntu 14).
2. Exécutez les commandes apt-get update, apt-get upgrade et apt-get dist-upgrade. Si aucun pack ne doit être mis à jour, alors les mises à niveau ont déjà été installées. Sinon, les packs doivent être mis à niveau. Pour en savoir plus, consultez la section Mettre à niveau les packs ci-dessous.

Vérifier les mises à jour des packs Plesk

1. Inspectez la liste des packs installés. Exécutez la commande dpkg -l | less. Les packs Plesk contiennent généralement les préfixes ou les suffixes "plesk-", "psa" ou "sw-". Vérifiez si la version de chaque pack Plesk contient le nom de l'OS vers lequel vous mettez à niveau (par ex. "debian8" si vous mettez à niveau depuis Debian 7).
2. Si la version d'un ou plusieurs packs de Plesk contient le nom de l'OS depuis lequel vous mettez à niveau (par ex.  "debian6" si vous mettez à niveau depuis Debian 6), alors ces packs doivent être mis à niveau. Pour en savoir plus, consultez la section Mettre à niveau les packs ci-dessous.

Mettre à niveau les packs

1. Activez les répertoires Plesk.
   1. Exécutez la commande plesk-installer --skip-cleanup (ajoutez des options le cas échéant).
   2. Sélectionnez la version de Plesk installée actuellement, c'est-à-dire 12.5.30.
   3. Attendez le chargement de la liste des composants, puis annulez l'installation.
   4. Le fichier /etc/apt/sources.list.d/50sw_autoinstaller.list sera alors créé.
2. Modifiez les répertoires apt (/etc/apt/sources.list et /etc/apt/sources.list.d/*.list). Remplacez le nom de code de l'OS par le nouveau nom de code (c'est-à-dire, remplacez "precise" par "trusty", "squeeze" par "wheezy" et "wheezy" par "jessie").
3. Mettez à niveau les packs.
   1. Exécutez la commande apt-get update.
   2. Exécutez la commande apt-get upgrade.
   3. Exécutez la commande apt-get dist-upgrade.
   4. Si l'installation des packs échoue, exécutez la commande apt-get install -f pour reconfigurer les packs qui n'ont pas été installés, résolvez les erreurs et essayez à nouveau.

Mettre à niveau les composants de Plesk

1. Une fois que les packs ont été mis à niveau, exécutez à nouveau le Programme d'installation de Plesk et installez les mises à jour pour les composants installés.

Réparer Plesk

1. Exécutez la commande plesk repair installation.
2. Exécutez la commande plesk repair all -n pour vérifier s'il y a des problèmes avec la configuration de Plesk.
3. Si des problèmes sont détectés, vous pouvez essayer de les résoudre automatiquement avec la commande de réparation de Plesk plesk repair mail ou plesk repair web). En cas d'échec, essayez de résoudre manuellement les problèmes détectés ou contactez l'assistance.

Problèmes potentiels

• Lors de la configuration d'Apache, le message d'erreur "API module structure...is garbled" indique qu'Apache a été mis à jour,mais un ou plusieurs modules n'ont pas été mis à jour. Désactivez les modules concernés pour résoudre le problème.
• Lors de la configuration d'Apache, le message d'erreur "No matches for the wildcard '*.conf" indique qu'Apache a été mis à jour, mais un ou plusieurs de ces fichiers de configuration disponibles dans /etc/apache2/conf.d et dans /etc/apache2/plesk.conf.d contiennent toujours la directive Include avec l'ancienne syntaxe. Replacez Include par IncludeOptional pour résoudre ce problème.
• Los du démarrage d'Apache, le message d'erreur "Could not open configuration file ..." indique que le fichier spécifié est un lien symbolique qui pointe vers un fichier inexistant. Supprimez le lien symbolique pour résoudre ce problème.
• Lors du démarrage d'Apache, le message d'erreur "Invalid command 'LockFile'inique qu'Apache a été mis à jour, mais le fichier /etc/apache2/apache2.conf contient la directive obsolète LockFile. Remplacez la ligne

LockFile ${APACHE_LOCK_DIR}/accept.lock

par la ligne

Mutex file:${APACHE_LOCK_DIR} default

pour résoudre ce problème.

• Lors du démarrage d'Apache, le message d'erreur "SSLSessionCache ... session cache not supported" peut indiquer que le fichier socache_shmcb.load est absent. Exécutez la commande suivante :

cp /etc/apache2/mods-available/socache_shmcb.load /etc/apache2/mods-enabled/

pour résoudre ce problème. Modifiez également le fichier /etc/apache2/mods-enabled/ssl.conf et remplacez la ligne :

SSLMutex file:${APACHE_RUN_DIR}/ssl_mutex

par la ligne :

Mutex file:${APACHE_LOCK_DIR} ssl-cache

pour éviter un autre problème.

• Lors de la configuration d'Apache, le message d'erreur "Invalid command 'Order'" indique qu'Apache a été mis à jour, mais un ou plusieurs de ces fichiers de configuration disponibles dans /etc/apache2/conf.d et dans /etc/apache2/plesk.conf.d contiennent toujours la directive obsolète Order. Remplacez les lignes :

Order allow,deny
Allow from all

par :

Require all granted

pour résoudre ce problème.

• Le message d'erreur "Config file dir.conf not properly enabled" peut indiquer que le fichier /etc/apache2/mods-enabled/dir.conf est un fichier réel au lieu d'un lien symbolique. Supprimez le fichier et créez un lien symbolique qui pointe vers /etc/apache2/mods-available/dir.conf pour résoudre le problème.
• Le message d'erreur "Failed to get D-Bus connection" peut indiquer que le swith de init vers systemd est incomplet. Redémarrez le serveur pour résoudre ce problème.