How to migrate all dashboards with the Jira Cloud Migration Assistant (JCMA)
Platform notice: Server and Data Center only. This article only applies to Atlassian products on the server and data center platforms.
Purpose
The purpose of this document is to provide instructions on how Jira dashboards can be migrated via Jira Cloud Migration Assistant (JCMA) to Atlassian Jira Cloud. For a comprehensive list of all objects that JCMA will/will not migrate see here: What gets migrated with the Jira Cloud Migration Assistant.
- To manage dark features you need to be a Jira administrator
- Available from JCMA RELEASE 1.6.2
- DO NOT ENABLE THIS FEATURE FOR EVERY MIGRATION PLAN
- The recommendation is to migrate dashboards as the last part of the migration, using a dummy project to initiate migration
Dashboard migration assumes that all dependencies such as projects, filters, software boards, sprints…etc are already migrated to the cloud. Otherwise, dashboard migration may not work properly and dashboard gadget failure may occur.
Related articles:
How to migrate all boards and filters with the Jira Cloud Migration Assistant (JCMA)
Summary
JCMA dashboard migration currently supports:
Dashboard, dashboard share permissions, gadgets, and gadget user preference migration.
Re-migration
No duplicate dashboards will occur due to re-migration.
Gadgets may be duplicated. (See caveats for exceptions)
Duplicate dashboard names will result in failure to migrate.
If gadget references (project, filter, custom field, etc) are deleted, dashboard re-migration will reconstruct the broken gadget without manual intervention.
Admin can delete a dashboard or its gadget to re-migrate. JCMA migration will create all missing items.
Solution
Jira dashboard migration is not enabled in JCMA by default. Dashboards may be migrated from Jira Server/Datacenter by using a dark feature. See Enable Dark Feature in Jira for instructions on how to use dark features
This should be the last step in the migration process, executed AFTER all projects are migrated, by using a dummy project to initiate migration.
- Navigate to URL: <Jira_URL>/secure/admin/SiteDarkFeatures!default.jspa
- Input dark feature: com.atlassian.jira.migration.dashboard-migration.feature.enabled
- Click Add
Caveats
No system dashboard support means admin will not be able to migrate their system dashboards from the server to the cloud.
No third party gadget support yet you could get the boards themselves migrated.
No support for favorite board feature.
Crucible Charts, Fisheye Charts, Bubble chart, Introduction gadget, and Fisheye Recent ChangeSets gadgets are not supported.
Some gadgets which used custom fields may not work completely but users can open them and fix them after migration.
Minor display differences may cause but they are not blocker in operation point of the view.
Known issues
MIG-1088 - Getting issue details... STATUS