Migrating the Zendesk Jira integration when moving Jira instances (Legacy)

To migrate your Jira integration when moving Jira instances, first create
a new Jira instance and transfer your data, ensuring issue key data is
maintained. Disconnect the current integration, then install and configure
it on the new instance. Use the migration tool to update links from the
old to the new instance. Track progress, which may take up to an hour,
without disrupting other features.




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.


This article covers the following topics:


Requirements


Migrating the Zendesk Support for Jira integration





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
&gt;
Manage apps >
Zendesk Support for JIRA
&gt;
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
&gt;
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.






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.




//
const fast_path_style = document.createElement('style');
fast_path_style.innerHTML = `#article-body .fastpath{font-size:.9em;background-color:#f3f3f3;border:1px solid #d3d3d3;padding:10px 10px 8px;margin-bottom:16px}#article-body .fastpath::before{content:none!important}`;
document.head.appendChild(fast_path_style);
//


//
const banner_style = document.createElement('style');
banner_style.innerHTML = `#styled-article-body{padding:0 0 0}#article-body #docs-wmp-link{text-align:right;font-size:.8em}#article-body .article-banners{margin-bottom:1rem}#article-body .article-banner{border:1px solid #ded7ca;background-color:#f6f0e6;margin:0 0 3px;line-height:1}#article-body .article-banner table{border-collapse:collapse;border:none;margin:0;width:auto}#article-body .article-banner td{padding:8px 6px 8px;border:none;font-size:.85em}#article-body .article-banner td:nth-child(2){border-left:1px solid #d0c9bd}#article-body .article-banner strong{font-weight:400;text-shadow:0 0 1px rgba(0,0,0,.5);letter-spacing:.5px}@media (min-width:1600px){#article-body .article-banner td{font-size:.8em}#article-body .docs-wmp-link{font-size:.7em}}`;
document.head.appendChild(banner_style);