Migration from Jira Cloud to Jira Data Center
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: Migrating from Jira Cloud to Data Center applications | Administering Jira applications Data Center 10.1 | Atlassian Documentation.
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.