Docker

Docker’s infrastructure enables you to do automate various kinds of infrastructure setups. Consequently, the kind of major migration steps are various too and highly dependent on your concrete setup. However, here are the major steps to do when migrating a docker based Axon Ivy Engine to another major version.

Preparation

  1. Switch your setup to the axonivy-engine tag you are aiming for. (e.g., from 8.0.36 to 10.0.17)

  2. Stop the running Axon Ivy Engine instance.

Migration

  1. Do a backup of the system database and all of your data of your Axon ivy Engine. If you run your Axon Ivy Engine in a Virtual Machine, then you can take a snapshot.

  2. Use the Migration Wizard to migrate your Axon Ivy Engine. The migration wizard is responsible to copy the configuration, error pages, dropins and many more to the new place. It will also update the schema of the system database. You can start using the wizard by starting the new Axon Ivy Engine. Browse to the Axon Ivy Engine URI (e.g., http://localhost:8080) and click on Setup Wizard > Migration Wizard.

  3. Restart your Axon Ivy Engine.

  4. Apply the Post Migration Steps.