Summary

After migrating the Jira Server and Confluence Server to the Atlassian Cloud or migrating from Atlassian Cloud to Atlassian Cloud, URL links appear broken as the links are still referencing the source URLs.

Environment

Atlassian Cloud, recently migrated from Jira Server and/or Confluence Server or from a different Atlassian Cloud site

Cause

Current migration tooling does not handle fixing these links natively so a post-migration task is needed to update these references in bulk. Some content objects don't retain the same ID values as they had on the source (for example: Page IDs for Confluence). The Atlassian Migration Support team can provide assistance for running these link fixes as part of post-migration tasks.

Solution

Migration support will need to collect some needed information in order to run the necessary updates: 

1. Previous Base URL of Jira Instance.
2. Jira Server ID:
   1. Log in as a user with the Jira System Administrator global permission.
   2. From the top navigation bar select Administration  > System.  Select System info on the left menu to open the System info page.
   3. The Server ID is displayed in the Jira Info section of the page.
3. Previous Base URL of Confluence Instance
4. Confluence Server ID:
   1. Log in as a Confluence administrator
   2. Click on the Settings icon and choose General Configuration
   3. Click on the License Details link (under ‘Administration’)
   4. Your Server ID is listed in the Server ID field
5. For server-to-cloud migrations only, generate a mapping of Page IDs from the 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

Our current fixes will only update the link types listed below. If the Page ID of a Confluence page is present in the link, it will be updated to the current page in Atlassian Cloud. Link patterns that are not listed, as well as links that include ID values for Jira or Confluence entities, will not be updated. The table below provides examples of links that are supported because either they don't contain any ID value or they only include a Page ID value.

Not Supported

Any link type or location that is not listed under Supported list above is not supported. In addition, any historical page, draft, or blog post is also not in the scope of these fixes.

Other Notes

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

MIG-1457 - Getting issue details... STATUS

MIG-1626 - Getting issue details... STATUS

MIG-1625 - Getting issue details... STATUS

MIG-1519 - Getting issue details... STATUS

MIG-1432 - Getting issue details... STATUS

MIG-1616 - Getting issue details... STATUS

MIG-1487 - Getting issue details... STATUS

MIG-1499 - Getting issue details... STATUS

MIG-1458 - Getting issue details... STATUS

MIG-1627 - Getting issue details... STATUS