How to identify the minimum version of Jira Data Center required when migrating from Jira Cloud

Summary

When migrating from Jira Cloud to Jira Data Center (DC) the best version to migrate to is the most recent Jira DC version, available from https://www.atlassian.com/software/jira/download/data-center. If you're not able to use the latest version for some reason you can use the following workaround to identify what the minimum required version of Jira DC is when migrating from Jira Cloud to Jira DC.

Solution

• Take a backup of your Jira Cloud instance and download the zip file - it's not necessary to back up the attachments or other files at this stage.

• Unzip entities.xml from your backup file.

• Search through the entities.xml file for jira.downgrade.minimum.version. On a linux system you can use the following grep command:

  1 grep jira.downgrade.minimum.version entities.xml

• The result similar of the following is shown:

  1 <OSPropertyEntry id="14" entityName="jira.properties" entityId="1" propertyKey="jira.downgrade.minimum.version" type="5"/>

• Based on the above result, now grep the OSPropertyString of the same id (the example return id="14")

  1 grep '<OSPropertyString id="14"' entities.xml

• Result similar of the following will be returned

  1 <OSPropertyString id="14" value="7.1.9"/>

• This indicates you need Jira DC 7.1.9 to downgrade from this version of Jira Cloud. You can download older versions from https://www.atlassian.com/software/jira/download-archives.

• Please note: this version can change at any time, and we are not able to lock your Jira Cloud instance to a specific version of Jira DC.