Search for:

  • Article for your preferred language does not exist. Below is international version of the article.
Available article translations:

Parallels Plesk Panel upgrade guide

Article ID: 116078, created on May 14, 2013, last review on Oct 10, 2014

  • Parallels Plesk
  • Parallels Plesk Sitebuilder 4.5 for Linux/Unix

Choosing an upgrade strategy

There are two ways to upgrade Plesk. The choice between one or the other depends on the server environment (the OS, installed third-party software, and system resources):

  • In-place upgrade is performed using Parallels Installer on the same server. This strategy can be used if the OS installed on the server is supported by the target Plesk version and has not been discontinued under the terms of the Plesk Lifecycle Policy. However, if the server has hosting software that is not supported by the target Plesk version (for example, hMailServer, MDaemon, or Gene6 FTP Server), it is strongly recommended to do an upgrade by transfer.

  • Upgrade by transfer is the process of switching to the latest Plesk version by moving all of the hosting data and settings from the current Plesk server to a server with the latest version of Parallels Plesk installed. This strategy is preferred when upgrading servers with an OS that either falls under the end-of-life policy or is approaching the support termination date. Upgrade by transfer also allows you to minimize downtime of services on the production server, as websites stay online while the transfer is in progress.

This guide will help you to perform an in-place upgrade of Plesk. If upgrade by transfer is your preferred method, check our migration and transfer best practices guides:

Before we begin...

Before starting the upgrade, let's go through a short checklist to verify that an upgrade is possible and viable and make sure that the server has enough resources and satisfies all prerequisites:

  1. Make sure that the OS running on the server is still supported by the vendor and is not approaching its termination date (check the Parallels Plesk Panel Lifecycle Policy page). If the OS is close to its end of life, it is recommended to upgrade by transfer: set up the new server with a modern OS and the latest version of Plesk and use Parallels Plesk Migration & Transfer Manager to copy data from the old server.

  2. Read the release notes and verify that the server satisfies the target version's software requirements and that all software installed on the server is compatible with the target version. For example, if a server has hMailServer installed and set up as a mail server in Plesk, then upgrading to Plesk 11.0.9 and higher may be unsuccessful, as these versions do not support hMailServer. In such cases, an upgrade by transfer is strongly recommended.

  3. Check that the current version of Plesk supports upgrading to the target version. This information can be found in the "Earlier Versions Supported for Upgrade" section of the Plesk Release Notes.

  4. Check that there are at least 4 gigabytes of free disk space on the server in each of the following directories:

    • On Windows: C:\ParallelsInstaller and %plesk_dir%
    • On Linux: /root/parallels and /usr/local/psa (or /opt/psa on Debian and Ubuntu) and /tmp (if it mounted to separate partition)
  5. On Linux, verify that the system package manager (Yum on CentOS and RHEL, APT on Debian and Ubuntu) is properly configured and can fetch and install packages from the OS vendor's repositories.

  6. On Windows, determine which database provider is used to store the Plesk configuration database (article #3453). If the Plesk database provider is Jet, switch it to MySQL using the instructions provided in the article #5532. It will save time during the upgrade.

  7. Download and run the latest pre-upgrade checker (KB article #9436). Check all warnings returned by the script. If a problem is found, it is reported as a warning in the final report. The log file will have a full description of the issue with a link to a helpful KB article. Apply the solutions, then re-run the pre-upgrade checker until no warnings are reported or only non-critical issues (such as business logic warnings) are left.

  8. Read the sections "Notes on Installation, Upgrade, and Migration" and "Known Problems and Limitations" in the release notes of the target Plesk version and take the necessary actions.

  9. Plan the upgrade. Choose a time-frame when the server load is the lowest and the service downtime impact on hosting customers is minimal.

  10. Temporarily disable all scheduled maintenance tasks, as they may interfere with the upgrade process. (esp. on Windows)


Now that all checks have been successfully passed, it is time to start the upgrade.

Note: If Plesk is installed in a container using Parallels Virtuozzo Containers templates, consider performing an upgrade using templates. See full list of instructions in the article #117518.

If you are running Plesk 10.4.4, go to Tools & Settings > Updates and Upgrades and begin the upgrade using Parallels Installer's web interface. Otherwise, download the latest Autoinstaller for your OS and architecture from our website and run it:

  • On Windows:

  • On Linux:

    chmod +x ./plesk-installer

If an upgrade on Linux has been started while connected to the server via SSH, make sure that the connection is not interrupted before the upgrade process finishes. The best practice is to use the screen console screen manager, which allows multiple console sessions over a single SSH connection and keeps programs running in virtual terminals, even if the SSH connection is interrupted. You can get acquainted with this handy tool through this short introduction manual.

On Windows, a persistent connection is not a concern, as Windows preserves applications and keeps them running, even after a remote desktop session is disconnected.

IMPORTANT! When the upgrade process is running, do not interrupt Parallels Installer or reboot the server.

If something goes wrong ...

  1. If there is no output from Parallels Installer for a long time, it does not mean that the upgrade has stuck. Instead, some silent background operation might be taking a long time to run. Check what is happening on the server:

    • On Linux, run "ps axufww" and check the process tree that stems from the Parallels Installer process. See if any of these processes are running ("R" state). Run the command several times with an interval of 1-3 minutes and check if there is any change.

    • On Windows, download Process Explorer from Microsoft Technet, unpack it, and run it. Check the process tree and see if any child processes of ai.exe are consuming CPU or opening/closing files.
  2. If the upgrade fails, check for error messages in the output, as well as in the log files (C:\ParallelsInstaller\autoinstaller3.log on Windows or /tmp/autoinstaller3.log and /tmp/plesk_12.0.18_installation.log on Linux). Look up found messages in Parallels Knowledgebase for solutions.

  3. To continue a failed upgrade, re-run plesk-installer.exe on Windows, ./plesk-installer on Linux or use the following command:

    /usr/local/psa/bootstrapper/pp12.0.18-bootstrapper/ repair

See also

Search words:


c81e59b61af9dca603ba03b14aabe968 56797cefb1efc9130f7c48a7d1db0f0c bfe5815000fa4d6406f980c3dc0b4088 3ab1af55c4b84a70b6e8e87334f3a6ea ff34d28651ab50065276d6dd0caee9c0 76149d733533595e01a1c81494e34367

Was this article helpful?
Tell us how we may improve it.
Yes No
Server Virtualization
- Parallels Cloud Server
- Parallels Containers for Windows 6.0
- Parallels Virtuozzo Containers
- Parallels Automation
- Parallels Automation for Cloud Infrastructure
- Parallels Business Automation Standard
- Parallels Virtual Automation
- Parallels Plesk Panel Suite
- Web Presence Builder
- Parallels Plesk Automation
- Parallels Small Business Panel
- Value-added Services for Hosters
- Parallels Partner Storefront
Services & Resources
- Cloud Acceleration Services
- Professional Services
- Support Services
- Training & Certification