Jira Migration

We've disabled the Add & Migrate Jira Connection button in Integration Settings while we improve our migration process. You can still work directly with our teams to migrate your Jira instance. Please reach out to our Support team for assistance whenever you're ready to migrate.

qTest Project Admins can migrate data from an existing Jira instance to a new Jira instance, allowing old data to stay in sync.

The migration is dependent on the Jira project key and Jira issue keys remaining the same between cloud and server instances. If the keys are changed then the migration will not work.

To migrate data from an existing Jira instance to a new Jira instance:

  1. Click the Gear icon, and then select the Integration Settings option from the drop down. The Jira connection screen displays the current Jira instance connected to the qTest Project.

  2. Click the Add & Migrate Jira Connection button.

    The Add & Migrate Jira Connection button is only enabled when there is at least one existing Jira connection.

  3. The Add Jira Connection dialog appears. Enter the details for the new Jira instance. For more information on connecting to Jira Server or Jira Cloud, refer to Connect to Jira Server or Connect to Jira Cloud.

  4. Click the Test Jira Connection button to test the connection.

  5. Click the Save & Configure button to save the information. The newly added Jira instance connection appears in the Connection list.

  6. Hover your cursor in the Actions column for the new connection, and then click the Wrench icon to access the Configure Connection screen.

  7. Configure the Jira Defect mapping by following steps in Configure Jira Defects.

  8. Configure the Jira Requirement mappings, by following steps in Import and Use Requirements from Jira.

  9. In the Need to migrate your Jira data from an existing connection? section, click the Retrieve & Migrate Jira Data button to start the migration of existing Jira linked issues to the new connection based on their Issue Key ID. Defects will be migrated in the background.

    If you no longer want to be able to migrate existing Jira data to this connection, click the Ignore button. A warning message displays: "Are you sure that you want to ignore migrating Jira data?" Click the OK button and the Need to migrate your Jira data from an existing connection? section will be hidden.

  10. Click the OK button to close the dialog.