Project Configurator for Jira Server and DC

Use Case 3 - Migrating from Jira Server to Data Center with Project Configurator

Suppose you have multiple Jira Server instances that you want to move to Jira Data Center, but you need to retain all your project data, including configuration, history, and user mappings. You want to identify one of your Jira Sever instances to convert to Data Center, then merge your servers with your new instance as seamlessly and as easily as possible.

Assumptions

It is assumed you have installed Jira Data Center and configured your instance according to Atlasssian’s DC installation guide. It is also expected that you are familiar with the concepts of migrating and merging Jira instances as described in the following Atlassian guides: Migrating Jira Instances and Merging Jira Instances.

Setup & Best Practice

Migrating from Jira Server to Jira Data Center involves upgrading an existing instance to the new Data Center setup and merging your remaining instances into the Data Center instance. While we?ve tried to make Project Configurator as easy to use as possible, there are a number of things you should do to ensure your data is safely and successfully imported:

  • Ensure Project Configurator is installed on both your source and target instances. You can install Project Configurator either through the UPM or by downloading the app from the Atlassian Marketplace. Apply your license to the target instance only—​Project Configurator will allow you to export without applying a license to the source instance. You must have Jira Administration permissions to complete this process.

  • Ensure the same apps are installed on both the source and target instances. You should also ensure all your instances are on the same Jira version and in the same language and locale.

  • All user accounts must be the same in both the source and target instances whether or not they are used in the target instance.

  • Make full backups of your source and target database, including attachments.

  • Read the supported object types list to verify the objects you wish to migrate are supported.

  • Disable Outgoing Mail to not spam users. For each instance, run the Object Dependencies Report to identify all objects that are directly or indirectly part of the configuration of any project in your instance and where they are being used or referenced by other configuration objects.

  • After you have moved your first instance, verify that conflicts don?t exist between your source and target instances, and if they do, decide how each of them should be handled.

  • Simulate the import on a staging environment to check the system load and to ensure your target Jira instance performs the way you expect.

  • Perform the configuration promotion out of office hours. The larger the amount of data, the longer the process takes. This could mean running the process over multiple days, splitting your projects across multiple export/imports.

Exporting

  1. Open your SOURCE Jira instance.

  2. Select Add-ons from the Jira Administration menu, then select Export Projects under Project Configurator in the left sidebar.

  3. Make your selection (select multiple projects using the Ctrl or Command keys) on the Export Projects page. To export all projects, select the Select All Projects checkbox.

  4. Choose Complete Project from the Export Mode options.

  5. Click Export Options to refine any of the export settings. It is worth noting the default settings will work well for 90% of exports.

  6. Click Export Complete Project. The app downloads a zip file for the selected projects. The export could take some time, depending on the number, complexity, and size of the selected projects. When complete, a summary of the export is displayed, including the location in the SOURCE server where the exported zip file has been placed.

  7. Note the location and the file name for use in the importing process.

  8. Repeat this process for each of your source instances.

Importing

  1. Create a folder called projectconfigurator under JIRA_HOME/import in the Data Center TARGET Jira installation.

  2. Copy the zip file created in the export to that folder.

  3. Open a Jira session as a system administrator on the TARGET instance.

  4. Select Add-ons from the Jira Administration menu, then select Import Projects under Project Configurator in the left sidebar.

  5. Type the name of the exported file (include the .zip extension) into the Project File input box on the Import Projects page.

  6. Click Import Options.

  7. Select Run First a Simulated Configuration Import, then click Import Complete Project. The following page displays the configuration changes that will be applied to TARGET instance to migrate the projects.

  8. Review the proposed changes, and, if you are happy with them, click Next. When the process is finished, your project(s) will be in the TARGET instance, including their configuration, issues, and attachments.

  9. Repeat this process for each of your export files.