Versions Compared

Key

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

...

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

...

  • 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 archiveClick 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 option if you have imported the data once and want to re-import a file that now contains additional data. This will allow the process to import the new custom fields and their associated properties.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.

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

...

Note

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

Info

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.

...

  • .