On this page:
Before you start: |
Migrate projects and issues from Jira Server/
DCData Center to Jira Cloud
The video below demonstrates an end-to-end migration with the Cloud Migration Tool.
We aim to allow you to migrate your projects from a Jira on-prem premise instance to a Jira Cloud site fully and transparently with no data or configuration loss.
Info |
---|
What Jira configuration configurations are we able to migrate? See Check the complete list of supported configuration elements to see what 's able to can be migrated today and . Also, visit our roadmap for information on what's coming soon. |
Migration flow
MigratingMigrate projects from Jira Server/Data Center to Jira Cloud
Info |
---|
Prerequisites First, check the Prerequisites and Licensing requirements for migration to Jira Cloud. |
Install theCMJ Configuration Manager Cloud Migration Tool app on your Jira Server or Data Center instancesinstance.
Install the Configuration Manager for Jira (CMJ) Cloud app on your destination Jira Cloud site (this app allows you to establish the end-to-end connection from a a seamless connection between the Jira Server/DC instance to a and the Jira Cloud site). Learn more about the installation instructions.
You need to have site admin or org admin permissions to be able to establish a connection between the Cloud Migration Tool and Configuration Manager for Jira Cloud. Check the Prerequisites.Status colour Yellow title Prerequisite Log in to your Jira Server or Data Center instance with the Jira System Administrators' global permission.
Open the Cloud Migration Tool's Manage Migrations page and create a migration with the New Migration button.
On the migration wizard's Connect phase, name your migration and connect to your Jira Cloud site. Choose an existing connection if you already have one, or create a new connection to your cloudCloud site. Learn more about creating a connection to your Jira Cloud site.
Click Select to move to the select Select projects phase of the migration.
Select the projects that you want to migrate using the Add projects to the migration link. Boards related linked to the selected projects will be automatically added to the migration.
You can add boards notClick the Add boards button to include boards that aren't associated with the selected projects to the migration scope. Click Add boards to include boards in the migration.
After adding projects and boards to the migration, click Analyze to move to the Analyze changes phase.
In the Analyze changes phase, review Review the report of the changes introduced to the cloud in the Analyze changes phase. The Analyze changes page of the wizard UI shows you the projects, configuration elements, and users that will be migrated to the cloudCloud site.
Learn more about managing and migrating users with Cloud Migration Tool.It also detects and shows Go through any warnings, errors, or conflicts between the server and cloud configurations detected by the analysis. Remember that warnings don't block migrations, but conflicts and errors do. Therefore, you first need to resolve any detected conflicts.
After resolving
Learn more about your capabilities the options offered in the Analyze changes phase of the migration.If you’ve resolved any errors, rerun the analysis with the Rerun analysis button at the bottom of the page.
If the new analysis detects no errors, you can click Migrate to run Click Migrate to start the migration.
After Once the migration completes successfullyis complete, you can review a full report of the migrated configuration.
On the final page of the migration, click the Access Report button to review see the report.
You can also view if any warnings and errors have been encountered during the migration of issues and issue links. Learn more about the migration report.Navigate to your Jira Cloud site to browse your projects, issues, and workflows.
Invite
Your projects and issues on the source Jira are still present and remain unchanged.
After the migration is complete, you can invite your teams to Jira Cloud.
Info |
---|
App compatibility Make sure to have the same apps installed on Jira Server/Data Center on and Jira Cloud. Note that 3rd party apps' server and cloud versions will work differently in most cases. Please get in touch with the 3rd party app vendors regarding the migration procedure of the app data. |
Tips & Tricks
Atlassian MOVE ticket
Atlassian recommends submitting a MOVE ticket once you've committed to planning your migration. They will assign a dedicated cloud migration manager (CMM) to your ticket to assist you throughout the entire migration.
CMM assigned to the MOVE ticket will be able to help you decide on what tools and overall strategies make the most sense The CMM can help you choose the best tools and strategies for your organization.
Test your migration
For more information on testing the Jira Server to Cloud migrations, you might want to take a look at Atlassian's Test your server to cloud migration document.