In this guide, we’ll walk you through the step-by-step process of migrating boards, dashboards, and filters using the Jira Cloud Migration Assistant (JCMA).

Atlassian’s Recommended JCMA Migration Strategy – Version 1.9.17

1. Pre-load Attachments: Begin by ensuring that all attachments associated with your Jira projects are pre-loaded as the first migration.

2. Pre-load Users: Make sure user accounts are pre-loaded as the second migration.

3. Migrate All Projects: Start the migration by moving all your projects to the new environment.

4. Run Checks on Knowledge Base (KB): Run necessary checks on the Knowledge Base, with a focus on boards and filters, to verify the integrity of your data. More can be found here.

5. Enable Dark Features for Boards and Filters: Enable the following dark features in your source Jira instance:

  • com.atlassian.jira.migration.export.all.filters
  • com.atlassian.jira.migration.export.multiprojects.boards

To manage dark features, access the following URL as a Jira administrator account:

<BASE_URL>/secure/admin/SiteDarkFeatures!default.jspa

6. Create a Dummy Project: In your source Jira server, create a dummy project with a single issue.

7. Run a JCMA Migration Plan for the Dummy Project: Using the Jira Cloud Migration Assistant, execute a migration plan for the dummy project.

8. Disable Dark Features for Boards and Filters: Once the migration of boards and filters is complete, disable the previously enabled dark features.

9. Enable Dark Feature for Dashboards: To migrate dashboards, enable the following dark feature in your source Jira instance:

  • com.atlassian.jira.migration.dashboard-migration.feature.enabled

10. Create Another Dummy Project: In your source Jira server, create another dummy project with a single issue, similar to step 6.

11. Run a JCMA Migration Plan for the Second Dummy Project: Execute a migration plan for the second dummy project to ensure that dashboards migrate successfully.

12. Disable Dark Feature for Dashboards: Once the migration of dashboards is complete, disable the dark feature for dashboards.

13. Check the Cloud Site: After completing the migration process, thoroughly check your new cloud site to ensure that boards, filters, and dashboards have been successfully migrated and is functioning as expected.

Enabling Dark Features for Migration

For your reference, here are the dark features you need to enable during the migration process:

Boards and Filters:

  • com.atlassian.jira.migration.export.all.filters
  • com.atlassian.jira.migration.export.multiprojects.boards

Dashboards:

  • com.atlassian.jira.migration.dashboard-migration.feature