Skip to main content

Migrating to 0.5.0

Migration Guide​

Here you can find the needed steps to upgrade your current Witboost installation to v0.5.0. Please refer to the release notes for a detailed list of changes and improvements. This guide is intended for users who are currently running Witboost version 0.4.0 or earlier and wish to upgrade to version 0.5.0.

Follow these steps to migrate from the previous version to Witboost version 0.5.0:

Backup Your Data​

Before starting the migration, ensure you have a complete backup of your database and configuration files.

Update Dependencies​

Ensure all the dependencies in the Helm files are updated to their compatible versions for 0.5.0. Refer to the published Helm chart for details.

Upgrade Steps​

Core​

  • Change the URLs of the provisioning coordinator and of the marketplace plugin to refer the V1 version instead of the old URLs with the module version in it; as an example, in the UI configurations, simply change the configured URL from

http://datamesh-provisioningcoordinator.datamesh-provisioningcoordinator:8088/datamesh.provisioningcoordinator/0.6

to

http://datamesh-provisioningcoordinator.datamesh-provisioningcoordinator:8088/datamesh.provisioningcoordinator/v1

  • For templates, we introduced the input.sourcePath value in the publish phase which is a new reserved keyword. For old templates, check that they are not using it already in order not to break them. Be really careful NOT to use special characters(for example -) in the id of the publish phase in templates.

  • When domains are registered in the Marketplace database, they are now correctly registered with the same identifier defined inside the descriptor. This fix was introduced when domains had spaces or underscores, and entities were not correctly stored since the domain identifier does not include them. If you had this problem, in order to make this fix work you may need to refresh all the affected domain entities and check that the corresponding values on the Marketplace database are consistent. Refreshing the entities on the witboost UI will trigger the domain insert with the updated value.