After a successful Server to Cloud Migration, URL links are broken in the new Cloud instance
Platform Notice: Cloud, Server, and Data Center - This article applies equally to all platforms.
Summary
After migrating Jira Server and Confluence Server to the Atlassian Cloud, URL links appear broken as the links are still referencing the old server URLs.
Environment
Atlassian Cloud, recently migrated from Jira Server and/or Confluence Server
Cause
This issue is surfaced at a cause of the product differences between Atlassian Server URLs and the Atlassian Cloud URL structures. In addition to this, some content objects do not retain the same primary key as they had in Server (example: Page IDs for Confluence). Current migration tooling does not handle fixing these links natively and so a post-migration task is needed to update these references in bulk. The Atlassian Migration Support team can provide assistance for running these link fixes as part of post-migration tasks.
Solution
As this is a time-consuming and manual task, we execute the link fixing procedure exclusively after Production migrations, during business hours in your support region.
Before asking Atlassian Support to execute these link fixes, please run the JIRA Macro Repair tool on the following URL:
<YourSiteName>.atlassian.net/wiki/admin/jim-validator/view.action
Migration support will need to collect some needed information in order to run the necessary updates:
- Previous Base URL of Jira Server
- Previous Base URL of Confluence Server
- Mapping of Page IDs from Confluence Server which can be fetched via this database query:
SELECT c.title,
c.contentid,
s.spacekey
FROM content c
JOIN spaces s ON s.spaceid=c.spaceid
WHERE c.contenttype='PAGE'
AND c.prevver IS NULL
AND c.content_status='current'
AND c.title !=''
AND c.title IS NOT NULL
ORDER BY s.spacekey, c.title;
SELECT c.title,
c.contentid,
s.spacekey
FROM CONTENT c
JOIN SPACES s ON s.spaceid=c.spaceid
WHERE c.contenttype='PAGE'
AND c.prevver IS NULL
AND c.content_status='current'
AND c.title !=''
AND c.title IS NOT NULL;
SELECT c.TITLE,
c.CONTENTID,
s.SPACEKEY
FROM CONTENT c
JOIN SPACES s ON s.SPACEID=c.SPACEID
WHERE c.CONTENTTYPE='PAGE'
AND c.PREVVER IS NULL
AND c.CONTENT_STATUS='current'
AND c.TITLE !=''
AND c.TITLE IS NOT NULL;
SELECT C.TITLE,
C.CONTENTID,
S.SPACEKEY
FROM CONTENT C
JOIN SPACES S ON (S.SPACEID = C.SPACEID)
WHERE C.CONTENTTYPE='PAGE'
AND C.PREVVER IS NULL
AND C.CONTENT_STATUS = 'current'
AND LENGTH (C.TITLE) > 0;
- Please provide the SQL results as a comma separated csv file.
- By providing the above metadata from the Confluence Source instance, Migration Support will be able to build a one-to-one mapping of the old content IDs to their new counterpart IDs in Atlassian Cloud to run the replaces in bulk.
Glossary of Types of Links Resolved by Atlassian Support
Supported
Type of Link | Example (when applicable) |
---|---|
Confluence Server Links Referencing Page ID | https://confluence.acmecorp.com/pages/view.action?pageId=123456 |
Confluence Server Links Referencing Page Title | www.acme-confluence.com/wiki/spaces/ACME/pages/123456/Hello+World |
Confluence Server Links nested in Jira Server Ticket Descriptions, Comments | Links may vary |
Confluence Server Links linked to Jira Tickets via Remote Links that appear as "mentioned on" | Links may vary |
Confluence Server Links with Page Title ("Pretty") Format | https://confluence.acmecorp.com/display/SPACEKEY/Page+Title |
Confluence Tiny URLs | https://confluence.acmecorp.com/x/a4OcE |
Jira Issue Links nested in Confluence Body Content of Pages | https://www.acme-jira.com/browse/ACME-1 https://www.acme-jira.com/projects/ACME/issue/ACME-1 https://www.acme-jira.com/issues/ACME |
Jira Issue Links Nested in Other Jira Issue Descriptions | https://www.acme-jira.com/browse/ACME-1 https://www.acme-jira.com/projects/ACME/issue/ACME-1 https://www.acme-jira.com/issues/ACME |
Confluence Links Embedded in Jira Sprint Reports |
Not supported
Type of Link | Example (when applicable) |
---|---|
Jira Macros nested in Confluence Pages | Run the Jira Macro Repair |
Confluence links containing anchors and other customizations | http://myconfluence.com/display/spacekey/Page+name#pagename-anchorname |
Historical pages | |
Blogposts |
Other Notes
There are several feature requests currently open over natively handling such URL transformations:
- MIG-42Getting issue details... STATUS
- MIG-98Getting issue details... STATUS
- MIG-237Getting issue details... STATUS
- MIG-449Getting issue details... STATUS
- MIG-507Getting issue details... STATUS