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.
Refer to the section Export User Custom Field Data for detailed instructions on exporting data in a JSON file.
Step 2: Importing app data in Jira Data Center
Once you have the entities.xml file extracted from the Jita 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
Click Start Import to begin the import process
NOTE:
You can check the "Merge data" checkbox if you are importing additional new custom fields from a previous import. This will allow the process to import the new custom fields and their associated properties.
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.
You can migrate the Project Team data from Jira Cloud to Jira Data Center. The migration process involves creating a backup of the Cloud instance, exporting the data, and then importing the exported data into Jira Data Center.
Backup Creation for Jira Cloud:
Log in as a Jira admin
Navigate to Jira Settings > System
In the IMPORT AND EXPORT section, select Backup manager
Click on Create backup for cloud. Once the backup is complete, click Download cloud backup
Extract the zip archive on your local computer. The entities.xml file is required for the migration
Exporting Data from Jira Cloud
Log in as a Jira admin
Navigate to Jira Settings > Apps > Project Team > Data Export page
Click the Start Export button to begin the export process
Refer to the section Export User Custom Field Data for detailed instructions on exporting data as a JSON file.
Once you have the entities.xml file extracted from the backup archive and the JSON file generated from Export Data you can proceed with the migration application data to Jira Data Center.
Follow these steps to migrate the user custom field definitions and their values from Jira Cloud to Jira Data Center:
Log in to your Jira Data Center instance
Navigate to Administration > Project Team> Import From Cloud page
At Project Team Exported Data From Cloud, choose the JSON file generated on Jira Cloud
At Jira Cloud Exported Entity XML File, choose the entities.xml file extracted from the backup for Cloud archive
The entities.xml file may exceed the default attachment size limit in Jira. To address this:
Navigate to Administration > System
Under the Advanced section, select Attachments
Click Edit Settings and change the attachment size limit to 400MB (404857600 bytes).
After the import, revert to the original attachment size limit.
Click Start Import
Check the Merge data checkbox if you are importing additional new custom fields from a previous import. This will allow the process to import the new custom fields and their associated properties.
For users not found in the local system, a Download button will appear on the page. Click it to download the list of users not found in the system.
By following these instructions, you can successfully migrate your Project Team data from Jira Cloud to Jira Data Center.