Documents to help you prepare to migrate your Atlassian Server or Data Center products.
You need to update product links on each of your cloud products separately. Before you start, you should identify all Server or Data Center instances whose URLs might be included in the links.
Before you begin
Here are some prerequisites:
You need to be an organization admin.
You need to be an admin of the product that has links you want to update.
You need to connect your products and destination of links with app links. If they live in the same site, the app links should be created automatically.
You can’t update links related to products migrated with the Jira site import or the Migrate all data at once option of the Jira migration assistant. You won’t see such products on the list at all. For these types, you need to use REST API. Learn how to update links with REST API
Access product links
You can update product links on the org level in admin.atlassian.com.
To access the page:
Go to admin.atlassian.com, and select your organization.
Select Settings > Product links.
You will see the following page:
Product: List of your cloud products for which you can update the links.
Last migrated: Last time data was migrated into a product.
Last updated: Last time a link update was started on a product. 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 product links
When you update links, you need to provide new destinations for existing links – the cloud products to which you migrated data from Server or Data Center instances. You can add all of them to a single update or divide among more updates.
To update product links:
Choose the product from the list, and select … > Update links. You’ll update links on this product only.
You’ll see a screen where you can add a new destination for existing links, like in the following example:
Here’s an explanation of fields that you need to fill in:
Cloud URL of the destination product that was migrated from Server or Data Center.
To update local links within your product, choose the URL that represents the same product as the one you’re updating.
Migrated from (Base URL)
The original server base URL of the migrated destination product.
(Optional) Migrated from a staging instance
Select this check box if the destination product 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. If you’d like to add another destination to the same update, select Add another product, and provide the details of another destination product.
Review product links updates
After adding destination products, select Review. You’ll see a summary of the changes.
If everything looks good, select Update links, which will start the update.
When you’re ready, check the status and results of your update. Learn how to check the status and results