Article ID: 126808, created on Sep 5, 2015, last review on Oct 10, 2016

  • Applies to:
  • Plesk 12.5 for Linux

According to Plesk 12.5 release notes dist-upgrade procedure on Debian 6, Debian 7 and Ubuntu 12 is supported.
How to perform dist-upgrade?
Note: dist-upgrade from Ubuntu 14 to Ubuntu 16 is supported by Plesk Onyx only.

Table of contents

General information

Dist-upgrade is not a simple process. To go through it you must have considerable experience in the system administration, the knowledge of the system and its components.
If you have never performed dist-upgrade before it is recommended to do the following first:

Note: According to Debian dist-upgrade documentation it is not recommended to use aptitude during upgrade from Debian 7 to Debian 8.
Preferred way to perform dist-upgrade on Ubuntu is using do-release-upgrade tool.

Ubuntu 12 to Ubuntu 14 - Repeat the process on the test server, but with Plesk 12.5 installed using OS documentation and instructions from this article.

  • Solve all potential problems and make sure that Plesk is working after the upgrade. Only after that run the upgrade on the production server.

Ubuntu 14 to Ubuntu 16 (Ubuntu 16 is not supported by Plesk 12.5)

During an upgrade from Ubuntu 14 to Ubuntu 16, system PHP 5.x shipped by OS vendor will be upgraded to PHP 7.x. So to avoid any PHP compatibility issues, before an upgrade, it is highly recommended to switch all sites having PHP handler 5x by OS vendor to corresponding custom PHP handlers. Please refer to these KB articles for details: KB #124991 KB #129167.

Note: Most of APS application will not work with PHP 7.x

Performing the dist-upgrade from Ubuntu 14 to to Ubuntu 16

  1. Run below script and follow the wizard:

    # /opt/psa/bin/

    The script logs all its actions in /var/log/plesk/install/plesk-distupgrade.log.

  2. During the script execution you will be asked to reboot the server. Reboot the server.

  3. After the server reboot, run the script once again.

Performing the dist-upgrade from Debian 6,7 and Ubuntu 12

Preparing server for upgrade

  1. Create a full server backup. Before you begin the upgrade, make a full server backup. Also notify your customers about upcoming downtime of one to three hours.

  2. Consider to remove sources list backup files which might be left from previous dist-upgrade:

    • /etc/apt/sources.list.saved_by_plesk_distupgrade
    • /etc/apt/sources.list.d/50sw_autoinstaller.list.saved_by_plesk_distupgrade
  3. Run pre-upgrade helper script (in this case dist-upgrade from Debian 7 to Debian 8) and prepare Plesk and the system for the upgrade:

    # /opt/psa/bin/

    The script logs all its actions in /var/log/plesk/install/plesk-distupgrade.log.

  4. Disable switching to systemd during OS upgrade. Create file /etc/apt/preferences.d/local-pin-init with the following content:

    # cat /etc/apt/preferences.d/local-pin-init 
    Package: systemd-sysv 
    Pin: release o=Debian 
    Pin-Priority: -1

Performing the dist-upgrade

  1. Update information about system packages:

    # apt-get update
  2. Upgrade the system:

    On Debian:

        # apt-get dist-upgrade

    On Ubuntu:

        # do-release-upgrade

    This command will perform a complete upgrade of the system, install the newest available versions of all packages and resolve all possible dependency changes between packages in different releases.

    During the upgrade the system might produce prompts like:

    Configuration file `/etc/mysql/my.cnf' 
     ==> Modified (by you or by a script) since installation. 
     ==> Package distributor has shipped an updated version. 
      What would you like to do about it ? Your options are: 
       Y or I : install the package maintainer's version 
       N or O : keep your currently-installed version
       D : show the differences between the versions 
       Z : start a shell to examine the situation 
     The default action is to keep your current version. 
    *** my.cnf (Y/I/N/O/D/Z) [default=N] ?

    Choose to replace configuration files with a new one (answer Y).

Finalizing the upgrade

  1. Run post-upgrade helper script:

    # /opt/psa/bin/

    The script logs all its actions in /var/log/plesk/install/plesk-distupgrade.log.

  2. Remove file /etc/apt/preferences.d/local-pin-init and install systemd-sysv package:

    # rm -f /etc/apt/preferences.d/local-pin-init
    # apt-get install systemd-sysv
  3. Reboot your server.

  4. Check that Plesk and all its services are working.

Potential issues

All known issues are described in #127355 Dist-upgrade: known issues

Search Words

debian 8 upgrade


ubuntu16 onyx



742559b1631652fadd74764ae8be475e 56797cefb1efc9130f7c48a7d1db0f0c a914db3fdc7a53ddcfd1b2db8f5a1b9c 29d1e90fd304f01e6420fbe60f66f838 e335d9adf7edffca6a8af8039031a4c7

Email subscription for changes to this article
Save as PDF