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

 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;

Glossary of Types of Links Resolved by Atlassian Support

Supported

Not supported

Other Notes

There are several feature requests currently open over natively handling such URL transformations: 

MIG-42 - Getting issue details... STATUS

MIG-98 - Getting issue details... STATUS

MIG-237 - Getting issue details... STATUS

MIG-449 - Getting issue details... STATUS

MIG-507 - Getting issue details... STATUS