This article describes the process for migrating the Zendesk Support for Jira integration when moving Jira instances, such as migrating from Jira Server to a Jira Cloud instance.
Requirements
You must maintain Jira issue key data when transferring Jira issues between Jira accounts. Additionally, your Jira instance must be public (not behind a firewall) for Zendesk to migrate your links between Jira instances.
Migrating the Zendesk Support for Jira integration
Migrating the integration consists of installing and configuring the Zendesk integration in the new Jira instance, then using the migration tool in Jira to update links from the old instance to the new one.
To migrate the Zendesk Support for Jira integration
- Following Atlassian's recommendations, create a new Jira instance and
migrate your data from the old Jira instance. For more information, see
Migrate your Atlassian Server to
Cloud. Important: Ensure that you maintain the Jira issue ID and issue key data during the migration.
- In Jira administration, disconnect the current Zendesk Support for Jira
integration.
- Click the Settings cog, then select Apps > Manage apps > Zendesk Support for JIRA > Configure > Settings.
- On the Settings page, click Disconnect at Zendesk Support URL.
- Click Save.
- Install and configure the Zendesk Support for Jira integration on the new instance. See Setting up the Zendesk Support for Jira integration.
- After installing the integration on the new Jira instance, migrate links
from the disconnected Jira instance to the new instance.
- In Jira administration, navigate to Apps > Manage
apps > Zendesk Support for JIRA >
Configure > Link Migration. The previously
connected Jira instances display in a list.
- Click Migrate links for each previously connected Jira instance. The link transfer processes and restores the ticket links.
- In Jira administration, navigate to Apps > Manage
apps > Zendesk Support for JIRA >
Configure > Link Migration. The previously
connected Jira instances display in a list.
You can track the migration process here. It may take up to an hour, depending on the number of links. You can continue using all other integration features while the migration progresses. When the migration is complete, the previously connected Jira instance displays 100% complete.