Error after updating module groupID

Question

When deploying a newer version of a module, Jahia throws following error

2020-05-08 12:54:13,216: ERROR [fileinstall-\digital-factory-data\modules] org.jahia.osgi.BundleUtils: 
A different Jahia Module with the Id test-module already exists

Cause

For the new version of the module, the parent groupID was modified in pom.xml. This makes Jahia consider the module as a new one, but with same name.

Solution

If you need to update the group ID of an existing module and deploy it, you will need to

- undeploy the current version of the module. you do not need to purge contents created by the module.

- deploy the new version. definitions will be correctly linked to existing contents