Prendre en charge Dist-Upgrade

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

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

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

Attention : lisez attentivement 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 :
  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 :
  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érifiez 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 révision de l'OS, par ex. "jessie" si vous mettez à niveau vers Debian 8, "wheezy", vers Debian 7, "trusty" vers Ubuntu 14.04 et "xenial" vers Ubuntu 16.04.
  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 Mettez à niveau les packs ci-dessous.

Vérifiez 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 des packs 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 Mettez à niveau les packs ci-dessous.

Mettez à 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 actuellement installée, par ex. Onyx.
    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) en remplaçant le nom de code de l'OS par le nouveau nom de code, c'est-à-dire, remplacez "precise" par "trusty", "trusty" par "xenial", "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 réessayez.

Mettez à niveau les composants de Plesk.

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

Réparez 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 ses 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. Remplacez Include par IncludeOptional pour résoudre ce problème.
  • Lors 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' indique 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 ses 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 switch de init vers systemd est incomplet. Redémarrez le serveur pour résoudre ce problème.
 

Leave your feedback on this topic here

If you have questions or need support, please visit the Plesk forum or contact your hosting provider.
The comments below are for feedback on the documentation only. No timely answers or help will be provided.