Versions Compared

Key

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

If you decide to migrate your Jira instance from Cloud to Data Center you can also migrate Project Team app data. The migration process consists in two major steps: export of app data from Jira Cloud, followed by import of app data into Jira Data Center.

This page describes the steps to export Project Team data from Cloud and how to import it in a Data Center instance.

Prerequisites

  • The Jira instance data (projects, issues, users, groups, etc) was already migrated from Cloud to Data Center according to the Atlassian procedure described in their official documentation: https://confluence.atlassian.com/adminjiraserver/migrating-from-jira-cloud-to-server-applications-938846963.html.

  • The Project Team app data import process requires the entities.xml file from Jira Cloud backup archive. Please extract this file and have it ready before you start the Project Team import process.

  • You need to migrate the Project Team app data before making eventual changes to the username values created for migrated Jira users. This is needed for the Project Team import process to be able map user’s cloud account ids with user’s data center usernames.The entities.xml file may exceed the configured attachment size limit in Jira and this will prevent its upload during the Project Team app data import process. To address this issue, you can temporarily increase the attachment size limit in Jira as follows:

    • Log in as an admin to your Jira Data Center instance

    • Navigate to Jira Administration > System

    • Under the Advanced section, select Attachments

    • Click Edit Settings and change the attachment size limit to a value larger than the size of the entities.xml file. Please note that this size is in bytes.

After import, you can revert to the original attachment size limit.

  • Ensure that you have the newest version of Project Team app installed in your Jira Data Center instance.

Step 1: Exporting app data from Jira Cloud

The first step in the migration process is to export Project Team app data from your Cloud instance in JSON format.

Follow these steps to export the app data in JSON format:

  • Log in Jira Cloud as a Jira admin

  • Navigate to Jira Settings > Apps > PROJECT TEAM > Data Export page

  • Click the Start Export button to begin the export process. This might take a while, depending on the number of users from your Jira instance.

...

  • When the export is finished, click download as JSON to export the data in a JSON file.

Step 2: Importing app data in Jira Data Center

Once you have the entities.xml file extracted from the Jira Cloud backup archive and the JSON file containing the exported app data from Cloud, you can proceed with the import of this data in the Jira Data Center instance.

Follow these steps to import the user custom field definitions and their values from Jira Cloud to Jira Data Center:

  • Log in as an admin to your Jira Data Center instance

  • Navigate to Administration > Project Team > Import From Cloud page

  • For Project Team Exported Data From Cloud, choose the JSON file generated previously

  • For Jira Cloud Exported Entity XML File, choose the entities.xml file extracted from the Jira backup for Cloud archive

  • You can check the Merge data option if you have imported the data once and want to re-import a file that now contains additional data. This will allow the new data to be imported, while the existing data will be preserved.

...

  • Click Start Import to begin the import process

  • The import process will display a progress bar tracking the import of custom fields and associated user properties

  • In case the application is unable to map some of the users from the import file to the local Data Center users directory, it will display a notification message and once the import process is completed it will show a Download button that allows you to download the list of these users.