Complete migration walkthrough

Please install the latest version of our app on your DC and Cloud sites for a seamless migration.

1. Migration of spaces/apps, starting from DC/server

1.1 Assess your apps

First select the Atlassian Cloud Migration Assistant and begin assessing your apps:

image-20241030-082150.png
Overview of the Migration Assistant

Next, select that you will need Multivote and Enterprise Survey for Confluence in the cloud, click Done.

image-20241030-082430.png
Assess your apps - select that you need Multivote and Enterprise Survey in the Cloud

1.2 Assess your apps

Then it is time to prepare your apps.

image-20241030-082607.png
Prepare your apps

You will need to connect to your cloud site and will have to install Multivote & Enterprise Survey for Confluence on it (if you haven’t already 😉 )

image-20241030-082643.png
Select the cloud site you want to migrate your surveys to
image-20241030-082812.png
Install your apps on your cloud site if necessary

Finally, agree to the app migration and click on ‘Done’.

1.3 Review your email domains/Assess and prepare your users

Before you can start a migration, you have to review your email domains and assets and prepare your users. Please follow the Atlassian documentation here.

1.4 Migrate your data

Finally, click on ‘Migrate your data’ to start a new migration:

image-20241030-083013.png
Click on Migrate your data to start a new migration

This leads you to the migration dashboard. Click on ‘Create new migration’.

image-20241030-083048.png
Migration dashboard

This will guide you through the different steps, as shown below.

image-20241030-083233.png
Overview of the guide of the different steps in a migration

Click on ‘choose what to migrate’. Here you can choose your migration options, such as global templates, spaces, users and groups as well as apps, including the Multivote & Enterprise Survey for Confluence.

image-20241030-083428.png
Migration options

Finally, you can then hit the button ‘Check for errors’. This will trigger Atlassian’s pre-migration checks. At this stage, there is also a pre-migration check specific to Multivote & Enterprise Survey for Confluence. It checks whether your Surveys obey the size limitations of the Atlassian Cloud.

Screenshot 2024-12-18 at 11.19.13.png
App vendor check showing a warning

This pre-migration check is non-blocking. You can continue your migration despite warnings, but doubtful Surveys will not be migrated. You can click on ‘View app vendor checks’ and download a report about this check. The report is a CSV file containing the problematic Survey Title, Survey Id, and Survey Size.

Screenshot 2024-12-18 at 17.34.17.png
Pre-migration check report in CSV format

Find out more on how to resolve problems with too large Surveys on our troubleshooting page. After correcting potential errors, you can review your migration clicking on ‘Review Migration’ and then start it by clicking on ‘Run now’.

It may be that Multivote & Enterprise Survey for Confluence is listed in the success rate check with a warning:

image-20241216-102839.png

You can ignore this warning, as our migration assistant for Survey was only recently introduced and therefore has an unknown success rate.

The migration will then appear in your dashboard.

image-20241030-083814.png
Migration dashboard. Click on ‘view details’ to see more.

By clicking on ‘View details’, you can follow its progress.

image-20241031-070615.png
The progress of a migration. The different migration processes will appear sequentially after the previous one has been completed.

Please note that if the app data migration takes longer than 15 minutes, its status will be displayed as TIMED_OUT. The data migration will still continue though. Please check the logs for progress/completion.

image-20241031-070732.png
If the app migration has timed out, please check the logs

The last log message should contain “App migration settled by Cloud app with status SUCCESS, percent 100 and message : All events processed successfully for transferId: ”.

2. Migrating legacy macros to cloud macros

By default, auto-migration is enabled which makes the manual work of this step obsolete. Find out more at Auto-migration of macros. If you want to migrate all macros at once, follow the steps bellow.

Now the macros have to be migrated in Cloud. The Macro Migration Assistant page contains a handy overview to see all migrated or yet-to-be migrated pages.

You can find it by navigating to ⚙️->Settings → Apps → Multivote & Enterprise Survey → Macro Migration Assistant:

Screen Shot 2026-06-19 at 12.40.26-20260619-104026.png

Select the pages you want to migrate and click ‘Migrate selected pages’.

image-20251028-134440.png

After a short moment, you should see a success.

image-20251028-134453.png


Navigating to the survey page will now show you the Survey with its data.

image-20251028-134607.png


Navigating to the multivote page will now show you the Multivote with its data.

multi2.png


If you Survey or Multivote data is not migrated you will see this

image-20251028-133925.png

For possible reasons, please consult the migration troubleshooting page.