Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

On this page:

Table of Contents

Before you start:

Migrate

...

from Jira Server/

...

Data Center to Jira Cloud

...

Moving projects and issues from Jira Server to Jira Cloud is one of the most demanded and complex administrative tasks in Jira right now.

...

 Configuration Manager Cloud Migration

...

Tool paired with Configuration Manager for Jira Cloud solves this challenge for you.

...

These apps working together allow you to transfer your projects and issues from Jira Server or Data Center instances to Jira Cloud

...

sites. The apps detect and report configuration conflicts and errors that block your migration.

...

Using the approach described in this document, you can also perform configuration tasks such as merging multiple Jira Server or Data Center instances into a single Jira Cloud site.

Image Removed

The video below demonstrates an end-to-end migration with the Cloud Migration Tool and Configuration Manager for Jira Cloud pair.

...

We aim to allow you to migrate your projects from a Jira on-premise instance to a Jira Cloud site fully and transparently with no data or configuration loss.

Info

What Jira configuration are we able to migrate?

See the complete list of supported configuration elements we're able to migrate today and our roadmap for information on what's coming soon.

Migration flow

Migrating projects from Jira Server/Data Center to Jira Cloud

...

Install the CMJ Cloud Migration Tool app on your Jira Server or Data Center instances.

...

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 Jira Server instance to a Jira Cloud site). Learn more about the installation instructions.

...

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 cloud. 
Learn more about creating connections.

...

Select the projects you want to migrate using the Add projects to the migration link. Boards related to the selected projects will be automatically added to the migration.

...

You can click Add boards to include boards not associated with the selected projects.

...

After adding projects and boards to the migration, click Analyze to move to the Analyze changes phase. Learn more about the analysis process.

...

In the Analyze changes phase, review the report of the changes that will be introduced to the cloud. This phase shows you the projects, configuration elements, and users migrated to the cloud.
Learn more about managing and migrating users with Cloud Migration Tool.

...

It also detects and shows any warnings, errors, or conflicts between the server and cloud configurations. Remember that warnings don't block migrations, but conflicts and errors do. Therefore, you first need to resolve any detected conflicts.
Learn more about 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.

...

Click Migrate to start the migration.

...

After the migration finishes successfully, you can review a full report of the migrated configuration.
On the final page of the migration, click the Access Report button to review the report.
You can also see 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.
(info) Your projects and issues on the source Jira are still present and unchanged.

...

After the migration is complete, you can invite your teams to Jira Cloud.

Info

App compatibility

Make sure to have all your Jira Server/Data Center apps also installed on 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.
The CMM assigned to the MOVE ticket will be able to help you decide on what tools and overall strategies make the most sense for your organization.

Test your migration

...

They also suggest and offer actions to resolve problems and optimize configurations.

Visit the document below to learn how to migrate your Jira Server/Data Center projects and issues to Jira Cloud.

...