Upgrade from Release 8 EHP 3 to 8 EHP 4

Introduction

This documentation is divided into 2 parts:

Part 1 describes the actual update of the containers and comes in two options
- Option 1 in case you use our recommended docker compose setup.
- Option 2 in case you have a custom setup. It describes the relevant changes that come with Release 8 EHP 4 in a generic way.
Part 2 describes steps which have to be done independently of the container orchestration mode.

Make sure you read our Release Notes and Migration Notes for Simplifier 8 EHP 4 before you start upgrading your instance.

Part 1: Upgrading Simplifier

Option 1: Upgrade using default docker compose

Step 1 – Shutdown Simplifier Instance

Go to the directory where you placed the docker-compose file. Switch into that folder:

cd docker-compose

To stop Simplifier, run

docker compose down

Step 2 – Get Simplifier setup files

Hint: If you have changed docker-compose.yml, make a backup of docker-compose.yml and add your changes to the new version.

You could use

git stash

and

git stash pop

for this.

To make a copy and revert your changes:

git stash
git restore simplifier-standalone.yml

Update the content and switch to the new release branch:

git pull
git checkout --track origin/release/8.4

Step 3 Edit .env

Open your .env file with your favourite editor, like vim or nano. Look for the following line:

SIMPLIFIER_VERSION=8.3

and change it to

SIMPLIFIER_VERSION=8.4

Save the file and leave the editor.

Step 4

A new folder is necessary, which acts as a shared volume.

mkdir /var/lib/simplifier/shared

Step 5

Start Simplifier

docker compose up -d

Option 2: Generic upgrade instructions, if you are not using our default docker compose setup

To upgrade to Simplifier 8 EHP 4, shut down Simplifer and change the container image name from

simplifierag/simplifier:8.3
simplifierag/launchpad:8.3
simplifierag/workflow-designtime:8.3
simplifierag/workflow-runtime:8.3

simplifierag/simplifier:8.4
simplifierag/launchpad:8.4
simplifierag/workflow-designtime:8.4
simplifierag/workflow-runtime:8.4

A new folder is necessary, which acts as a shared volume. E.g. you can create /var/lib/simplifier/shared:

mkdir /var/lib/simplifier/shared

You have to mount this path to the simplifier container and to the workflow designtime container.

For the Simplifier container:

/var/lib/simplifier/shared:/opt/simplifier/shared

For the workflow designtime container:

/var/lib/simplifier/shared:/home/workflowDesigntime/shared

You can change /var/lib/simplifier/shared to whatever folder you prefer. You must leave the mount targets /opt/simplifier/shared and /home/workflowDesigntime/shared unchanged!

Part 2: Doings after upgrade

Step 1: Update Simplifier Standard Content

Download the latest Standard Content from Marketplace and import it to your Simplifier Instance. Make sure using import scenarios ‘Overwrite all’ or ‘Skip unchanged’ (recommended).