Plan your Cloud migration
Documents to help you prepare to migrate your Atlassian Server or Data Center products.
Run pre-migration checks, review, and run a Jira migration
After you create a migration plan, the Jira Cloud Migration Assistant runs a set of pre-migration checks to make sure your data can be migrated to cloud.
It checks that, for example:
Cloud products are installed in the destination site
Users and customers have unique and valid email addresses
You don’t exceed your user or storage limit
Run pre-migration checks
To run pre-migration checks:
Progress through your migration plan until you reach the Pre-migration checks screen
View the details of your migration plan from the Migrations dashboard
Save time while running your pre-migration checks
Upgrade to the latest version of Jira Cloud Migration Assistant to avoid rerunning time-consuming pre-migration checks. In the latest version, the results of successful pre-migration checks are stored to improve efficiency. These results are then used to speed up future checks, thus saving time.
Note:
It's recommended to run the pre-migration checks at least a few days before the migration day. This'll ensure that:
any modifications made to the data are validated and stored in the cache
the duration of running the pre-migration check is minimised, saving time on the migration day
The cached results are stored only for 30 days, beyond which they are automatically removed and all checks run again.
The pre-migration checks are divided into the following groups:
System
Users and groups
Customers
Projects
Cross-project boards and filters
Advanced Roadmaps plans
You can expand each check to see information on how to fix the related problems.
Learn how to solve common problems shown by checks
Review your migration
After you’ve reviewed and fixed the checks, you can proceed to reviewing your migration.
To review your migration:
Progress through your migration plan until you reach the Review migration screen
View the details of your migration plan from the Migrations dashboard
When reviewing the migration, it’s useful to download the pre-migration report. It shows problems that require your attention, but also provides many details on the data that you’re migrating.
Learn how to view the details of your migration plan
Run or save your migration
After you reviewed the details of your migration, you can run or save it. In both cases, it will be saved to the dashboard where you can see the details and monitor the progress if you decided to run it.
To run your migration, select Run.
To save your migration for later, select Save.
You’ll be moved to the Migrations dashboard where you can see your migration and monitor the progress.
Next steps
Once you’re done, check the details of your migration or see how it’s progressing.
Learn how to view the details and monitor the progress
More information and support
We have a number of channels available to help you with your migration.
For more migration planning information and FAQs, visit the Atlassian Cloud Migration Center.
Have a technical issue or need more support with strategy and best practices? Get in touch.
Looking for peer advice? Ask the Atlassian Community.
Want expert guidance? Work with an Atlassian Partner.
Support for Atlassian Server products ends in February, 2024. Learn more about the Server end of support timeline.
Was this helpful?
Still need help?
The Atlassian Community is here for you.