Update links after the migration
You need to update links on each of your cloud apps separately. Before you start, you should identify all Data Center instances whose URLs might exist on the app you’re updating.
Before you begin
Here are some prerequisites:
Permissions
You need to be an organization admin.
You need to be an admin of the app that has links you want to update.
App links
You need to connect your cloud apps and destination of links with app links. If they live in the same site, the app links should be created automatically.
Migration type
You can’t update links related to instances migrated with the Migrate all data at once option of the Jira migration assistant. You won’t see such instances on the list at all. For this type, you need to use REST API. Learn how to update links with REST API
Access link fixing
You can update links on the org level in admin.atlassian.com.
To access the page:
Go to Atlassian Administration. Select your organization if you have more than one.
Select Settings > Link fixing.
You will see the following page:
App: List of your cloud apps for which you can update the links.
Last migrated: Last time data was migrated into the app.
Last updated: Last time a link update was started on an app. If it’s earlier than the last migration, the status will change to Needs update.
Status: Status of updating links.
Actions: Action menu where you can start updating links.
Update links
When you update links on a given app, you will provide new link destinations. This will include:
The same app as the one you’re updating (to update local links)
Another app linked to it (to update remote links)
You can specify both of them in the same link update. We’ll explain how to do it below.
To update links:
Choose an app from the list, and select … > Update links. You’ll update links on this app only.
In the first Destination app section, select the same app as the one you’re updating, for example Jira. This will include all local links within Jira in your update.
Here’s an explanation of fields that you need to fill in:
Field | Description |
|---|---|
Destination URL | Cloud URL of the destination app where the links go. It can be the same app as the one you’re updating (local links) or a different one (remote links). |
Migrated from (Base URL) | The original server base URL of the destination app. |
(Optional) Migrated from a staging instance | Select this check box if the destination app was migrated from a staging or backup instance. |
(Optional) Production instance | The source production instance from which you created the staging or backup one, mentioned above. |
3. Next, select Add another app. In the new section that appears, add a remote app linked to Jira, for example Confluence. This will include all remote links from Jira to Confluence in your update.
The link update described above would update local links within Jira and outgoing remote links to Confluence. Reciprocal links won’t be updated at the same time, so you’ll need to run an equivalent update for Confluence later.
Review link updates
After adding destinations, select Review. You’ll see a summary of the changes.
If everything looks good, select Update links, which will start the update.
Next steps
When you’re ready, check the status and results of your update. Learn how to check the status and results
Was this helpful?