Testing app migration platform without automated pathway


Recently, we started implementing the app migration assistant for our apps.
We are using the following approach/dependencies:

  1. OSGI dynamic dependencies: atlassian-app-cloud-migration-osgi v0.3.6
  2. CCMA v3.1.7
  3. feature flags migration-assistant.app-migration.feature is enabled in Confluence.
  4. Confluence server v7.10.2

We have the migration path already available online but when I create a new migration plan through the assistant UI, the migration cannot start due to missing automated pathway. Since we are still in the implementation phase, is there any way to test the migration platform without enabling the automated pathway or am I missing something here?


1 Like

Hi Behrouz,

As long as you have the followings in place, app migration platform lets you migrate apps.

  1. Have a listener implemented
  2. In AppAssessment flow, select ‘NeededInCloud’ - despite you have a path or not. And complete the flow once. This flow is not meant to be blocking at present, so you should be able to complete this.
  3. Make sure that App is installed on the cloudsite you would like to migrate too.

Also note that at present only those apps that have the same key on server and cloud can be migrate, so if serverAppKey and cloudAppKey are different then you can’t migrate.

Let me know if the above worked.


Hi Anshuman,
Thanks for your reply,

I had followed the steps you mentioned above,

I also implemented both listeners interfaces available in migration OSGi and none of them worked. (AppCloudMigrationListenerV1, AppCloudMigrationListener)

I attach a video showing the steps I followed to create a migration plan here:


Hi @AnshumanTiwari - was there anything else we needed to implement to be able to test? Currently, this was blocking our progress.

In case it is required, these are our related Atlassian Migration tickets - https://jira.atlassian.com/browse/MIG-464 (PDF) / https://jira.atlassian.com/browse/MIG-465 (Word)

Thanks, Thomas (K15t)

Hi @behrouz and @thomasr, from EAP, the completion of App Assessment is necessary for those migrations that have Apps involved.

Therefore, you need to make sure that every installed App should have a deterministic state either - ‘Needed in cloud’ or ‘Not needed in Cloud’ or ‘Use Alternative’. In App Assessment, please make sure that it is true for every app and then go through the flow.