The instructions on this page describe how to upgrade an existing application link. You may want to upgrade an application link in either of the two situations below:
- Your local application has been upgraded from a version that does not include UAL (Unified Application Links) to a version that does. For example, you may have configured Trusted Apps or OAuth in a JIRA 4.2 instance (does not include UAL) and then upgraded to JIRA 4.3 (includes UAL).
- Your non-UAL remote application has been upgraded to a version that includes UAL (Unified Application Links). For example, you had set up an application link in a FishEye 2.4 instance (includes UAL) to JIRA 4.2 instance (does not include UAL), and then upgrade to JIRA 4.3 (includes UAL).
Upgrading an Application Link (Local App Upgraded to Include UAL)
When you upgrade from an application that does not include UAL to application that does, you will have the option of converting any Trusted Apps or OAuth links to UAL links. The advantage of converting your links to UAL links are that link configuration will be simplified in future.
To upgrade an application link when your local application has been upgraded to include UAL:
- After your application upgrade, navigate to the administration console.
- Click 'Application Links'. The 'Configure Application Links' screen will be displayed with the following message:
"There are existing Trusted Applications or OAuth relationships that should be upgraded to Application Links. Click here to upgrade."
- Click the 'Click here to upgrade' link. The 'Existing Trust Relationships' screen will be displayed showing all Trusted Apps and OAuth relationships that can be upgraded to UAL links.
- Click the 'Upgrade to Application Link' link next to the desired trust relationship. The 'Upgrade to Application Link' wizard will be displayed.
- Complete the wizard. The process will be similar to adding a new link (described on Adding an Application Link), except that most fields should be pre-filled.
Screenshots above: Upgrading an application link for local application
Upgrading an Application Link (Remote App Upgraded to Include UAL)
When an application link is created between a UAL-enabled application and a remote legacy application (either a non-Atlassian product, or an older version of an Atlassian product that did not ship with UAL), this link is configured to run in "legacy mode". While there is no distinguishable difference to a user, connecting and configuring non-UAL application links is a little different. For example:
- Setting up OAuth requires manual configuration by the administrator. In OAuth authentication for UAL-to-UAL links, exchange of the consumer keys and public keys is done automatically.
- The Trusted Applications protocol (Atlassian-specific) will not be available for authentication.
If you upgrade your remote application to a version that does include UAL, the application link will continue to work. However, upgrading your link may simplify link configuration and make additional authentication protocols available (as mentioned above).
To upgrade an application link when your remote application has been upgraded to include UAL:
- After you have upgraded your remote application to a version that includes UAL, navigate to the administration console of your local application. A warning will be displayed, requesting that you upgrade the link to full-UAL mode (see 'Upgrading an application link - Warning message' screenshot below).
- Click 'Upgrade' in the warning message to start the upgrade wizard.
- Complete the upgrade wizard to upgrade your link to full-UAL mode (see 'Upgrading an application link wizard' screenshot below). The wizard will be similar to the one used when you first added the link. Note the following:
- You will be prompted to make your application link into a reciprocal link. You will need to provide administrator credentials for your remote application, if you choose to do so.
- If you make your application link into a reciprocal link, you will also be able to make any entity links (for the application link) into reciprocal links. For example, you may be able to link your JIRA project to a FishEye repository and also make a link from your FishEye repository back to the JIRA project.
Screenshot above: Upgrading an application link for remote application
Screenshot above: Upgrading an application link wizard