How to migrate all dashboards with the Jira Cloud Migration Assistant (JCMA)

Still need help?

The Atlassian Community is here for you.

Ask the community


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.

Summary

JCMA dashboard migration currently supports:

  1. Dashboard, dashboard share permissions, gadgets, and gadget user preference migration.

  2. Re-migration

    1. No duplicate dashboards will occur due to re-migration.

    2. Gadgets may be duplicated. (See caveats for exceptions)

  3. Duplicate dashboard names will result in failure to migrate.

  4. If gadget references (project, filter, custom field, etc) are deleted, dashboard re-migration will reconstruct the broken gadget without manual intervention.

  5. 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

(warning)This should be the last step in the migration process, executed AFTER all projects are migrated, by using a dummy project to initiate migration.

  1. Navigate to URL: <Jira_URL>/secure/admin/SiteDarkFeatures!default.jspa
  2. Input dark feature: com.atlassian.jira.migration.dashboard-migration.feature.enabled
  3. Click Add

Caveats

  1. No system dashboard support means admin will not be able to migrate their system dashboards from the server to the cloud.

  2. No third party gadget support yet you could get the boards themselves migrated.

  3. No support for favorite board feature.

  4. Crucible Charts, Fisheye Charts, Bubble chart, Introduction gadget, and Fisheye Recent ChangeSets gadgets are not supported.

  5. Some gadgets which used custom fields may not work completely but users can open them and fix them after migration.

  6. Minor display differences may cause but they are not blocker in operation point of the view.

Known issues

MIG-1088 - Getting issue details... STATUS


DescriptionHow to migrate all dashboards with the Jira Cloud Migration Assistant
ProductJira, Jira Software, Jira Service Management

Last modified on Nov 29, 2022

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.