Update from 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.

Procedure

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