Migrate Jira Software configuration
On this page: |
Migrate Jira Software configuration
By pairing our Cloud Migration Tool and CMJ Cloud apps, you can migrate Jira Software projects together with boards, filters, and sprints from a Jira Server/Data Center instance to a Jira Cloud site.
We do not modify existing boards, filters, and sprints in the cloud site. This way, we ensure that the Jira Software configuration from the server instance will be added to the cloud without overwriting the existing configuration there.
As the Cloud Migration Tool is still in development, we advise checking the complete list of Jira configuration elements weāre currently able to migrate.
Below, you'll find the built-in principles for migrating boards, filters, and sprints to a new or existing Jira Cloud site with the latest version of theĀ Cloud Migration Tool.
Boards
Jira Server and Jira Cloud boards are matched by name, type, and project key for project boards or user key for user boards.
Boards associated with a project through a filter are migrated. A boardās entire configuration is migrated, including quick filters, swimlanes, etc.
Boards for sprints referenced in issues or an issueās history are also migrated.
We donāt modify existing boards in the Jira Cloud site. This means that a board from the Jira Server instance wonāt be migrated if it matches an existing board in the Jira Cloud site.
Filters
Jira Server and Cloud filters are matched by their name and owner.
Filters associated with boards being migrated are migrated too.Ā
We donāt modify existing filters in the Jira Cloud site. This means that a filter from the Jira Server instance wonāt be migrated if it matches an existing filter in the Jira Cloud site.
Before filters are migrated, their JQL entry is validated.
How do we handle invalid JQLs in filters?
If the JQL entry of a filter being migrated isnāt valid on the Jira Cloud site, the JQL is migrated to the Cloud as is. Therefore, after the migration, you need to check all filters to ensure everything works as expected.
There are many reasons why a JQL entry may not be valid. For example, it might contain unsupported JQL functions or custom fields.
Sprints
Jira Server and Cloud sprints are matched by their boards, name, state, start date, and end date attributes. If there are multiple sprints with the same attributes, they are also matched by their order.
Sprints that are part of boards being migrated are migrated too.
Sprints referenced in issues or an issue's history are migrated, even if these sprints donāt have an associated board.
Sprints that do not belong to any board are migrated.
We donāt modify existing sprints in the Jira Cloud site. This means that a sprint from the Jira Server instance wonāt be migrated if it matches an existing sprint in the Jira Cloud site.