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.
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
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
to
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).
Step 2: Release Notes and Migration Notes
Follow our Release Notes and Migration Notes and implement the necessary changes described there