Roughly every quarter of a year a new minor version of Cawemo is released. This document guides you through the process of migrating from one Cawemo version to the next.

Migrate from version 1.4 to 1.5

Cawemo 1.5 integrates Camunda Account, our new Identity and Access Management (IAM) component that requires users to be migrated from Cawemo to Camunda Account. Cawemo 1.5 will then use Camunda Account to manage its users.

Migration steps

1. Stop Cawemo
2. Make a database backup
3. Update your .env and docker-compose.yml file by working through steps 1 to 4 of the installation instructions. Make sure that you do not start Cawemo yet.

4. Start the Camunda Account backend service only with:

   docker-compose up -d backend
   

5. Make sure that the Camunda Account backend has started successfully by checking that

   docker-compose ps backend
   

   returns Up (healthy) in the State column. This is based on the health check and takes around 30 seconds.

6. Migrate the users from the Cawemo database to Camunda Account as described below.

7. Once the user migration has been finished, start all other services (see step 5) with:

   docker-compose up -d
   

Migrate user data from Cawemo to Camunda Account

We provide a migration script that will copy the existing Cawemo users to the Camunda Account database.

Make sure you are logged in to the Camunda Docker registry (required only once):

$ docker login registry.camunda.cloud
Username: your_username
Password: ******
Login Succeeded

Run the Dockerized migration script with your updated .env file:

docker run -it --rm --env-file .env \
  registry.camunda.cloud/cawemo-ee/cawemo-iam-user-migration:1.5.0

You should see the following output in the end, indicating a successful migration:

data migration completed successfully

Migrate from an older version to 1.5

If you are still using an older version of Cawemo (< 1.4), you need to migrate to version 1.4 first before you can migrate to version 1.5:

1. Stop Cawemo
2. Make a database backup
3. Update your docker-compose.yml and .env file according to the installation instructions for version 1.4.
4. Start Cawemo again
5. Proceed with the steps listed above