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.
Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Purpose
This document provides instructions on migrating Jira dashboards via Jira Cloud Migration Assistant (JCMA) to Atlassian 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.
- DO NOT ENABLE THIS FEATURE FOR EVERY MIGRATION PLAN.
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., were already migrated to the cloud. Otherwise, dashboard migration may fail with incomplete status, and dashboard gadget failure may occur. Follow How to migrate all boards and filters with the Jira Cloud Migration Assistant (JCMA) | Atlassian Cloud | Atlassian Documentation for cross-project boards and all filters migration. Note that dashboards may be migrated regardless of dependency issues but may not be adequately rendered in the cloud.
IMPORTANT: Support, CMMs, and customers should know that feature flags are experimental. We'll do our best to offer support if these feature flags break migrations. However, we can't guarantee fixes or incident responses. Feature flags don't cover all edge cases. If using these feature flags is your only option, test your migrations thoroughly with the feature flags enabled. You should consider manual workarounds when facing issues with feature flags.
- To manage dark features, you need to be a Jira administrator
- Available from JCMA RELEASE 1.6.2
Summary
JCMA dashboard migration currently supports the following:
- Dashboard, dashboard share permissions, gadgets, and gadget user preference migration.
- Re-migration
- Dashboards will not be duplicated due to re-migration.
- Gadgets may be duplicated. (See caveats for exceptions)
- Fix missing dependency from the previous migration
- Duplicate dashboard names will fail to migrate.
- If gadget references (project, filter, custom field, etc) are deleted, dashboard re-migration will reconstruct the broken gadget without manual intervention.
- The admin can delete a dashboard or 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 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
- Click Add
Limitations and Known Issues
No system dashboard support means admins cannot migrate their system dashboards from the server to the cloud.
- No system dashboard support means the admin cannot migrate their system dashboards from the server to the cloud.
- There is no third-party gadget support, yet you could get the boards themselves migrated.
- There is no support for the favorite board feature.
- Crucible Charts, Fisheye Charts, Bubble chart, Introduction gadget, and Fisheye Recent ChangeSets gadgets are not supported.
- Some gadgets that use custom fields may not completely work, but users can open and fix them after migration.
- Minor display differences may occur, but they are not blockers in operation.
- If JCMA fails to migrate some dashboards, the plan will be in
INCOMPLETE
status. JCMA does not show the progress of dashboard migration.
Error and Workarounds
During dashboard migration, JCMA tries to migrate everything it can. In the case of missing dependencies during the import phase, the related dashboard will still be migrated.
However, it might not render properly, depending on the errors. Validate migrated dashboards on the Cloud side.
The workaround is to either:
Manually fix the dashboard on the cloud side.
Contact support to debug the missing dependencies. Fix them on the server side and trigger a dummy project migration again so JCMA can fix the broken component during re-migration.