It is no longer required to download this script manually, it will be automatically downloaded and executed before an upgrade.
If it is required to run this script manually, download and run it as it is described in the "HOW TO USE" chapter.
The script allows you to check the environment before an upgrade or a migration. It checks for business logic issues and works for both the Linux and the Windows platforms. This tool could be launched prior to an upgrade in order to obtain a report on potential problems with the upgrade. Based on the report, a host can decide whether an upgrade is suitable for their situation.
How to use
Note: Enclose the
<plesk-db-admin-password> in quotes (e.g. "plesk-db-admin-password") to properly parse any special characters in the password.
Download the script:
# wget https://autoinstall.plesk.com/<Plesk_version>/examiners/panel_preupgrade_checker.phpwhere
<Plesk_version>is the desired version of Plesk you are willing to upgrade to.
For example, to check upgrade to Plesk Onyx 17.5, the link will be
For Plesk Obsidian retrieve the links to script with the following command:
# curl -s http://autoinstall.plesk.com/pool/ | sed -E 's/.*href\=\"(.*)\/\".*/https\:\/\/autoinstall.plesk.com\/pool\/\1\/examiners\/panel_preupgrade_checker.php/g' |grep PSA | sort -r
Run it like below:
# php -d safe_mode=Off panel_preupgrade_checker.php <plesk-db-admin-password>
Note: Pre-upgrade checker for Plesk 17.8 is not fully compatible with CentOS/RHEL 6 as by default PHP 5.3 is used.
As a workaround execute Pre-Upgrade checker specifying the PHP version manually:
# /opt/plesk/php/5.6/bin/php -d safe_mode=Off panel_preupgrade_checker.php `cat /etc/psa/.psa.shadow`
- Download the script from http://autoinstall-win.plesk.com/ selecting the desired Plesk version you are willing to upgrade to.
For example, to check the upgrade to Plesk Onyx 17.5, the link will be
Run it like below:
C:\> "%plesk_bin%\php.exe" -d safe_mode=Off panel_preupgrade_checker.php_ <plesk-db-admin-password>
Report Content Clarification
At the beginning of the report, it shows a general overview of the changes that a host should expect from the upgrade.
Also, the report gives an overview of potential problems you may encounter during a transition to the new Plesk version with the corresponding Knowledge Base articles.