Versions Compared

Version Old Version 15 New Version 16
Changes made by

Piotr Koszela

Piotr Koszela

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Contents:

Table of Contents
minLevel2
maxLevel3
outlinefalse
stylenone
typelist
printablefalse

...

  • What If Scenario is not migrated.

  • JQL can be incomplete and may require manual changes. JQL is used in Scope definition → Additional Filtering and Quick Filters.

How to prepare for migration

The steps below are necessary to migrate the plugins to Jira Cloud. Ensure you have all the plugins (BigPicture, BigTemplate) installed on your Jira Cloud before you begin.

Jira Data Center

When you migrate from Jira Data Center to Jira Cloud, you will be asked to reinstall BigPicture to prepare a JCMA dump.

The reinstallation ensures data consistency in the dump by deactivating BigPicture on other nodes (Jira instances in a Jira Data Center cluster). The reinstallation prevents other nodes from making modifications to the database during database dump creation.

Expand
titleBigPicture reinstallation

To reinstall BigPicture:

  1. Uninstall the app.

  2. Go to the BigPicture Marketplace page.

  3. Download the JAR file for exactly the same version:

    download-versions.png

  4. Install the app with the file.

    upload-app.pngImage Added

Expand
titleSee the steps
Info

Creating a JCMA snapshot will restart the App and may take a significant amount of time and resources, so the process is recommended during non-business hours. Do not interrupt the process or disable the App until the JCMA snapshot is complete.

  1. Prepare a JCMA snapshot in BigPicture on Jira On-premise:

    1. Navigate to BigPicture App Configuration > Advanced > Database dumps > New dump > JCMA dump.

      Screenshot of the App configuration page.

    2. Enter a unique Migration name, as you will later need to identify this snapshot in JCMA and complete the Description field.
      The provided Migration name can be edited later.

      Screenshot of creating a new JCMA snapshot.

  2. For BigPicture on Jira Cloud:

    1. Navigate to Apps > BigPicture App Configuration > Advanced > Technical info > Others > Data migration.

    2. Enable the Allow JCMA migration option.

      Screenshot of enabling the Allow JCMA migration toggle switch.

  3. On Jira On-premise:

    1. Navigate to Jira Administration > System > Import and Export > Migrate to cloud > Assess your apps.

    2. Assign the Needed in cloud status for each App.

    3. Click Done.

      Screenshot of assessing apps before the migration.

...

Expand
titleSee the steps

  1. Go to App Configuration > Advanced > Technical info.

  2. Under the Others > Data migration section, enable the Allow JCMA migration toggle switch. 

  3. Under the Pending data migration section, click the Trigger pending migration button.

    Screenshot of the Trigger pending migration button on the BigPicture App configuration page.

  4. After refreshing the page, you will see a message that the migration is in progress.

    Screenshot of the message that migration is in progress.

  5. Now, you can return to the Migration dashboard on Jira On-premise and track the progress.

    Screenshot of the Migrations dashboard in Jira.

How to repeat migration

Warning

It is not recommended to reset Jira Cloud to solve migration problems. However, if there is no other way and you decide to reset Jira Cloud, you have to uninstall BigPicture first. Once BigPicture is uninstalled, you can reset Jira Cloud.

In case of any mistakes during the migration process in JCMA (for example, forgetting to provide the correct Migration name of your JCMA snapshot), you can run the migration process again.

...

Once the migration process is finished, it is recommended to check the following:

In Jira:

  • Review imported groups

Expand
titleSee the steps

You will see a message that imported groups need your review. Click on the banner to start reviewing or navigate to Directory > Groups.

Screenshot of reviewing imported users and groups in Jira.

You can select a group to review their pending product roles.

Screenshot of reviewing imported groups in Jira.

You can approve or deny a group.

Screenshot of reviewing imported groups in Jira.

When ready, the status Reviewed will appear next to a group. 

Screenshot of confirming the imported groups in Jira.

  • Verify permissions

  • Check migrated custom fields

Expand
titleSee the steps

Migrated custom fields can be recognized by the (migrated) additional note.
To find out more about duplicates, refer to the Jira Cloud Migration Assistant duplicates and tracking entities article.

Screenshot of checking migrated custom fields in Jira.
Info

Duplicated fields after migration in Jira Cloud
During migration with JCMA to Jira Cloud you can see duplicated custom fields, Migrated and Locked ones. Custom fields marked as Migrated are used for default field mapping in Jira Cloud.

In BigPicture:

  • Field mapping in App Configuration > General > Fields

  • Scope definition in Boxes

  • Content of Boxes such as tasks, projects, etc.

  • Editing and assigning tasks (it can be necessary to correct permissions)

  • Individual resources 

  • Permissions assigned in App Administration > Security

BigTemplate migration

Note

The migration using JCMA is available for BigTemplate version 8.17.1 and later.

You can migrate BigTemplate alone or together with BigPicture using JCMA. As a result, the BigTemplate database and all files with templates are migrated to your Jira Cloud.

How to prepare BigTemplate for migration

Make sure you have BigTemplate installed on your Jira Cloud before you begin. 

  1. A JCMA snapshot for BigTemplate on Jira On-premise is created automatically.

  2. On Jira On-premise:

    1. Go to the Jira Administration > System > Import and Export > Migrate to cloud > Assess your apps section.

    2. Assign the Needed in cloud status for BigTemplate.

    3. Click Done.

BigTemplate migration process

...