On your Jira Data Center instance, click the gear icon (Figure 1 - 1) and then select System (Figure 1 - 2).

Figure 1 - Access

A menu will appear on the left side of the screen. There, click External System Import (Figure 2 - 1). On the Jira import wizard screen, select the Zephyr for Jira Importer option (Figure 1 - 3).

Figure 2 - Access

If you see the following error message (Figure 3), it's because Zephyr is using the same Issue Link Types between Test<=>Defect and Requirement<=>Test.

Figure 3 - Message

Figure 4 - Settings

Xray needs to have different relations so that it can understand the different cases. Thus, you need to change the Linktype for Test → Defect relation to something different from the value LinkType for Requirement → Test. For example, you can leave LinkType for Requirement → Test with Relates (Figure 4 - 3) and change the Linktype for Test → Relation to Defect (Figure 4 - 2).

These relations are configurable in Add-ons > Zephyr for Jira > General Configuration > Issue and Remote Links Configuration (Figure 4 - 1).

After ensuring that the Link Types are configured with distinct values, you may proceed once again with the migration process. 

The importer modal (Figure 5) will show you some brief information that we advise you to read carefully.

Once you're ready, click Being Import (Figure 5 - 1).

Figure 5 - Import

Choose the project where to perform the migration (Figure 6 - 1). This will be the project where the Xray entities will be created. 

You may refine the process by (un)checking some boxes:

• Links between requirements and tests to respective Xray Issue Link Type used for requirement coverage (Figure 6 - 2): creates the link Xray uses for tracking coverage between Tests and requirements; by default, Xray uses the Tests Issue Link Type.
  
• Zephyr Cycles to Xray Test Plans (Figure 6 - 3): creates Test Plans based on Zephyr Cycles.
• Zephyr Ad Hoc Cycles to Xray Test Plans (Figure 6 - 4): creates Test Plans based on Zephyr Ad Hoc Cycles.

If the Zephyr Cycles to Xray Test Plans (Figure 6 - 3) and Zephyr Ad Hoc Cycles to Xray Test Plans (Figure 6 - 4) options are unchecked then no Test Plans will be created; nevertheless, Test Executions will always be created if Zephyr Executions exist. 

Once you're finished, click Next (Figure 6 - 5).

Figure 6 - Project

Map Zephyr's Test Statuses to Xray counterparts using the dropdown menus (Figure 7 - 1).

Once you're finished, click Next (Figure 7 - 2).

Figure 7 - Mapping

Map Zephyr's Test Step Statuses using the dropdown menus (Figure 8 - 1).

Once you're finished, click Next (Figure 8 - 2).

Figure 8 - Mapping

A final confirmation dialog presents information about the total number of Xray entities that will be created (Figure 9 - 1).

Once you're ready, click Begin Import (Figure 9 - 2).

Figure 9 - Confirmation

Once the migration process ends, a brief summary is shown mentioning the total number of Xray Issues created and any warnings that occurred during the process (Figure 10 - 1).

You can immediately start a new importing process by clicking Import another project (Figure 10 - 2).

Figure 10 - Concluded

Please have a look at the following section for some additional steps before concluding the migration process.

On the top menu of your Jira Data Center instance, click Issues (Figure 11 - 1) and then select Search for issues (Figure 11 - 2).

Figure 11 - Search

Search for the importation using the search bar (Figure 12 - 1).

Reset the TestRunStatus custom field of the migrated Tests (Figure 12 - 1). You can use the link provided on the final screen mentioned earlier to quickly obtain the created Tests.

You will be redirected to the Issues search page.

Figure 12 - Reset

Click the Save as button (Figure 13 - 1) to save this search as a filter (you will need it afterwards).

A modal opens (Figure 13). Enter a filter name (Figure 13 - 2) and click Save when you're finished (Figure 13 - 3).

Figure 13 - Modal

Click Tools (Figure 14 - 1) and select all 1 issue(s) (Figure 14 - 2) to perform a bulk change operation on the Test Issues.

Figure 14 - Bulk

The Bulk Operation screen will open (Figure 15). Select the Issue(s) and then Reset the Test Run Status Custom fields option (Figure 15 - 1).

Figure 15 - Reset

Reset the Requirement Status custom field of the requirements linked to the migrated Tests: use the testRequirements JQL function using the name of the previously saved filter as an argument (Figure 16 - 1).

Figure 16 - Saved

Go back to your Data Center Jira instance screen click Tools (Figure 17 - 1), and select all 1 issue(s) (Figure 17 - 2) to perform a bulk change operation on the Requirement Issues.

Figure 17 - Bulk

The Bulk Operation screen will open (Figure 18). Select the Issue(s) and then Reset the Requirement Status Custom fields option (Figure 18 - 1).

Figure 18 - Reset