Upgrade PP 5.7 - 6.0 (Linux)


To upgrade your PoolParty installation, follow the steps described below.

PoolParty's automated upgrade process for GNU/Linux hosts makes this process a breeze.


In order to upgrade to a specific PoolParty release, you must ensure that your current PoolParty installation is at the immediate previous release. In other words, you cannot skip any intermediate releases when upgrading PoolParty.

Example: If your PoolParty installation is at version 5.4 and you want to end up at 6.0, you must perform the upgrade to 5.7 and then to 6.0.

With release 6.0 a 64-bit build of a Sun/Oracle Java 8 SE Development Kit is required to run PoolParty.


These instructions assume you are upgrading a PoolParty default installation for GNU/Linux with PoolParty installed at /opt/poolparty, unless otherwise stated.

Upgrade Process


On upgrade we will replace SesameSetup.xml in the config folder. Please note a backup of the original file will be made and this will be stored in /opt/poolparty/config/SesameSetup.old

STEP 1: Stop the PoolParty Server

STEP 2: Run the Installer PoolParty.run From a Terminal Window

This will open a dialogue in the terminal. By hitting Enter you start the process.

STEP 3: Start Upgrade Mode

In the next step choose to do an upgrade entering option '2' and hitting Enter.

STEP 4: Confirm the PoolParty Application Directory (PPAppDir) and the Location for the PoolParty Data Directory (PPDataDir)

In this step you can provide the path for your PoolParty application directory (default: /opt/poolparty).

Enter the path of your installation if different than /opt/poolparty and hit Enter or just hit Enter to use the default path.

If a PPDataDir is found in the PPAppDir the upgrade just skips the next step.

If your installation has a separate path for the PPDataDir enter the path and hit Enter.

STEP 5: Confirm Upgrade Settings are Correct

You will be presented with an overview of the settings you made. You can then finalize the upgrade process by hitting Enter.

STEP 6: Start the PoolParty Server

Post-Upgrade Tasks

Clear browser cache

You have to clear your browser cache after the upgrade as changes to CSS and javascript used in the PoolParty UI have been done.

Run Post Update Scripts

After you login into PoolParty for the first time after the upgrade, you have to run the PoolParty migration script:

  • https://<your-serverurl>/PoolParty/!/migrate/upgrade

The script lists all updates that will be done. Trigger the migration by clicking Start Migration.

A progress bar and an info box show the progress and status of the migration. When the process has been finished an overview of the migration steps per project is provided.

Recalculate Extraction Models

Changes to the configuration of the PoolParty extraction model have been done. You have to recalculate all extraction models after the upgrade.


You need to have the Superadministrator role assigned to be able to run those scripts.