Upgrade PP 5.7 - 6.0 (Linux)
Upgrade PP 5.7 - 6.0 (Linux)
Introduction
To upgrade your PoolParty installation, follow the steps described below.
PoolParty's automated upgrade process for GNU/Linux hosts makes this process a breeze.
Note
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.
Note
These instructions assume you are upgrading a PoolParty default installation for GNU/Linux with PoolParty installed at /opt/poolparty, unless otherwise stated.
Upgrade Process
Note
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.
Note
You need to have the Superadministrator role assigned to be able to run those scripts.