Choosing an upgrade strategy
There are two ways to upgrade Plesk. The choice between the one and the other depends on the server environment (the OS, installed third-party software, and system resources):
In-place upgrade is performed using Plesk 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.
Note: The support for 32-bit OSes in Plesk Onyx has been dropped. Check Known Problems, Limitations, and Important Facts for Plesk Onyx for more information.
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 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 perform an in-place upgrade of Plesk. If upgrade by transfer is your preferred method, check our migration and transfer best practices guides:
- Plesk for Windows: Migration Best Practices and Usecases
- Plesk for Linux: Migration Best Practices and Usecases
If you prefer to let Plesk professionals handle the migration or upgrade job for you please check out Plesk professional services options on our website: https://www.plesk.com/professional-services/
Before we begin...
Before starting the upgrade, let's go through a short checklist to verify an upgrade is possible and viable and make sure the server has enough resources and satisfies all prerequisites:
Make sure the OS running on the server is still supported by the vendor and is not approaching its termination date (check the Plesk 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 Plesk Migration & Transfer Manager to copy data from the old server.
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 12.0 and higher may be unsuccessful, as these versions do not support hMailServer. In such cases, an upgrade by transfer is strongly recommended.
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 Software Requirements for Plesk Onyx.
Check that there are at least 3 gigabytes of free disk space on the server in each of the following directories:
- On Windows:
Note: see #213903325 for the reference
- On Linux:
/opt/psaon Debian and Ubuntu) and
/tmp(if it is mounted to a separate partition)
- On Windows:
On Linux, verify that the system package manager (Yum on CentOS and RHEL, APT on Debian and Ubuntu) is configured properly and can fetch and install packages from the OS vendor's repositories.
On Windows, determine which database provider is used to store the Plesk configuration database (article #213922485). If the Plesk database provider is Jet or MS SQL, switch it to MySQL using the instructions provided in the article #213921345. It will save time during the upgrade.
Download and run the latest pre-upgrade checker (KB article #213371529). 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.
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.
Plan the upgrade. Choose a time-frame when the server load is the lowest and the service downtime impact on hosting customers is minimal.
Temporarily disable all scheduled maintenance tasks, as they may interfere with the upgrade process (especially, on Windows).
Now, when all checks have been passed successfully, it is time to start the upgrade.
Note: If Plesk is installed in a container using Virtuozzo containers templates, consider performing an upgrade using templates. See full list of instructions in the article #213389329.
If you are running Plesk 10.4.4 or later, go to Tools & Settings > Updates and Upgrades and begin the upgrade using Plesk Installer's web interface. Otherwise, download the latest Autoinstaller for your OS and architecture from our website and run it:
chmod +x ./plesk-installer
If you would like to upgrade Plesk to the latest version use option
--all-versions according to article #213415669.
If an upgrade on Linux has been started while you are connected to the server via SSH, make sure the connection is not interrupted before the upgrade process finishes. The best practice is using 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 Plesk Installer or reboot the server.
If something goes wrong ...
If there is no output from Plesk 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 axufwwcommand and check the process tree that stems from the Plesk 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.exeare consuming CPU or opening/closing files.
If the upgrade fails, check for error messages in the output, as well as in the log files (
C:\\ParallelsInstaller\\autoinstaller3.logon Windows or
/tmp/plesk_12.5.30_installation.logon Linux). Look up the found messages in Plesk Knowledgebase for solutions.
To continue a failed upgrade, re-run
plesk-installer.exeon Windows or .
/plesk-installeron Linux, or use the following command: