Table of Contents

  1. Feature comparison
  2. Migration considerations
  3. Migration steps

Feature comparison

In terms of core features and functionality, both the Server/Data Center and the Cloud app work the same.

Migration considerations

By migrating the app from server to cloud your Confluence pages will maintain their entire history of retrospective sessions, along with the topics and action items generated for each one.


Please consider that to ensure the Agile Retros app data is migrated successfully, Confluence spaces and users need to be migrated as well, either before or at the same time. If users associated to retrospective sessions are not also migrated, some information will not be preserved to its entirety.

Scenarios for non-existent users in cloud

When migrating the app, participants' roles and permissions for each session are preserved. However, it may be the case that certain users will not be migrated to cloud and in those cases the app will work as follows:

ScenarioBehavior after migration
The creator of a retrospective does not exist in cloud or its user is deactivatedThe retrospective creator role will be assigned to the Confluence space creator
The user who is appointed as the "Preset moderator" does not exist in cloud or its user is deactivatedThe moderator role will be assigned to the Confluence space creator
One or more retrospective participants do not exist in cloudIn the participants list will be listed all existing users and will display the number of non-existent users
The author of an idea inside a retrospective session does not exist in cloudThe idea will be preserved, but it will display a blank user avatar.
One or more votes in a retrospective belong to a user that does not exist in cloudThe total number of votes for each idea will be preserved.
The assignee of an action item does not exist in cloudThe action item will be preserved but it will appear as unassigned.
The action item was transformed into a Jira issue of a project that does not exist in cloud.The action item will be preserved with the original issue key, but its link may not direct to the issue.

Scenario: Confluence Spaces were already migrated

If Confluence Spaces were migrated already, you can run a migration of the app without selecting those Spaces and you will successfully migrate your retrospectives history.

Scenario: Only certain spaces' retrospectives need to be migrated

If only certain Confluence Spaces are chosen to be migrated, only the retrospectives sessions belonging to those spaces will be migrated.

Scenario: The Agile Retrospectives app migration is executed more than once

If the app was previously migrated and another migration is executed, the following rules apply:

  • If the migrated retrospective sessions in the cloud site have not been modified, the migration will overwrite those sessions with the ones being migrated from server.
  • If a migrated retrospective session in the cloud site has been modified, the new migration will NOT overwrite that session.

Migration steps

Follow these steps to enable the app's migration from your server to your cloud instance:

Execute Scripts

1) Before migrating you will need to execute some scripts depending on your database. Please download the following .zip file

2) According to your database, please run the corresponding "update-macro-name" script.

Note: If after the migration is done you wish to use the Agile Retros app again in your server instance, you will then need to run the "rollback-update-macro-name" script.

Run Migration

Once the script is ran, you can now proceed to run these migrations steps.

1) Before you begin, make sure you have the Confluence cloud migration assistant app installed. You can get it from the from the Marketplace.

2) Go to Confluence administration and select "General configuration" from the menu

3) Click on the "Migration assistant" option located under the ATLASSIAN CLOUD section

4) You will see the Migration Assistant home. Click on "Assess your apps"

5) Locate the Agile Retrospectives app on the list of User installed apps and open the Status dropdown menu to select "Needed in cloud" and click on "Done".

6) On the Migration Assistant home. Click on "Prepare your apps".

7) From the 'Choose your destination cloud site" dropdown menu select the Confluence cloud instance you are migrating to. If it does not appear on the menu, click on "Choose cloud site".

8) Click on "Continue"

9) From the "Migrate to" dropdown, select your cloud site. Make sure to check the "Allow Atlassian to access migration data" option and then click "Confirm".

10) Click on "Continue".

11) Make sure you have the Agile Retrospectives app installed in cloud. If it is, we recommend you re-install it to ensure you're on the latest version. If it is not already installed, please install it and click on "Continue".

12) Click on "Done" to agree to app migration.

13) On the migration assistant home, click on "Review all email domains".

14) Review your domains to select which are trusted and click on "Done".

15) You are now ready to migrate the app. Click on "Migrate your data" to continue.

16) You will see the Migrations dashboard. Click on "Create new migration"

17) Click on "Connect to cloud"

18) Name your migration and click on "Choose migration options"

19) You will see everything you can migrate. For each option click on "Select" or "Skip" to decide what you will migrate to cloud. Click on "Next".

20) Select the spaces you want to migrate and click on "Add to migration". Note: If you select specific spaces for the migration, only the retrospectives belonging to pages in those spaces will be migrated

21) Click on "Review migration"

22) Click on "Run now"

23) In the migrations dashboard, you will see your migration in progress.

24) Once the migration is complete, you can check your cloud site and validate your retrospectives were successfully migrated.

Retrospectives in Server site

Retrospectives in Cloud site

As you can see, both retrospective sessions display the same information in both server and cloud instances.

If you have any questions or require support from our end don't hesitate to contact us. Reach out via our helpdesk, we'd be happy to help :)