Updating add-ons

Add-on providers sometimes release version updates to their add-ons to incorporate bug fixes and new features. Add-on updates may be released at any time, independently of host application updates. In general, we recommend that you keep add-ons updated to their latest version.

If your connection to the Marketplace is enabled, the Manage Add-ons page helps you to keep your installed add-ons up to date. Notifications tell you when a new version of an installed update is available. Also, all add-ons for which updates are available appear in the 'Available Updates' section of the 'Manage add-ons' page. If you click on the add-on in the list, you can see what version is installed and what version is available.

New add-on updates may not be intended to be deployed on older versions of the Atlassian host application. Accordingly, the available updates list shows only those add-on updates that are supported for your application version.

From the Manage Add-ons page, you can update add-on individually or all at once.

This page describes add-on updates, which are not to be confused with updates to your Atlassian host application. When planning a version update of the host application software itself, you can check the compatibility of your installed add-ons against the target version. See Checking Add-on Compatibility for Application Upgrades for more information.

On this page:

Updating an add-on to a new version

To update an add-on:

  1. Log into your Atlassian application as a user with administrative privileges. 
  2. Click Administration from the upper right-hand corner.
  3. Click Manage Add-ons from the administration menu.
    Click Manage Add-ons from the Administration page
    The UPM loads. 
  4. Toggle the filter to display Action required add-ons.
    Choose Action required
  5. Locate the add-on you want to update.
  6. Click the Update button next to the add-on to update.
    The UPM downloads and applies the latest version of the add-on. When finished, a success message appears.

Updating all add-ons

To apply updates to all add-ons at once:

  1. Log into your Atlassian application as a user with administrative privileges. 
  2. Click Administration from the upper right-hand corner.
  3. Click Manage Add-ons from the administration menu.
    Click Manage Add-ons from the Administration page
    The UPM loads. 
  4. Toggle the filter to display Action required add-ons.
    Choose Action required
  5. Click the Update All button to update every add-on to the add-on to the latest version.


    UPM updates all eligible add-ons. Eligible add-ons include those that have a newer compatible version – a version that will continue working on your current system. Add-ons that aren't eligible include: 

    • Previously free add-ons that have changed to a paid model
    • Paid add-ons that don't allow newer versions, and are beyond the maintenance period in their current license

UPM loads a success message after update.

UPM displays a success message


Updating add-ons by file upload

Instead of updating an add-on automatically (that is, by using the Update button), you can update it by manually loading the updated JAR file to the application. The update procedure is identical to the one for installing add-ons by file upload. When you perform this procedure for an existing add-on, the old add-on version is removed from the file system, and the new one is added.

You do not normally need to remove the out-of-date add-on JAR from the system, as long as the add-on developer has incremented the version identifier within the add-on descriptor. If you have problems with the update that you think are related to version issue conflicts, contact the add-on developer.   

To update add-ons by file upload: 

  1. Log into your Atlassian application as a user with administrative privileges. 
  2. Click Administration from the upper right-hand corner.
  3. Click Manage Add-ons from the administration menu.
    Click Manage Add-ons from the Administration page
    The UPM loads. 
  4. Click Upload add-on.
    Click Upload add-on
    The following dialog loads: 
    Upload add-on dialog
  5. Download the add-on's latest JAR or OBR from the Atlassian Marketplace. 
  6. Click Choose File.
  7. Choose the JAR or OBR from your corresponding directory.
  8. Click Upload.
    The add-on uploads and installs.

    The latest version of the JAR or OBR will replace the outdated version of the add-on. 
See how to use a URL instead.

 Follow steps 1-4 above. Then:

  1. Obtain the add-on's URL from the Atlassian Marketplace.
    For example, the URL for UPM on the Marketplace is https://marketplace.atlassian.com/plugins/com.atlassian.upm.atlassian-universal-plugin-manager-plugin
  2. Add download/ before plugins. 
    In our example, this changes the URL from 
    https://marketplace.atlassian.com/plugins/com.atlassian.upm.atlassian-universal-plugin-manager-plugin
    to
    https://marketplace.atlassian.com/download/plugins/com.atlassian.upm.atlassian-universal-plugin-manager-plugin 
  3. Paste the URL into the From this URL textbox.
  4. Click Upload.
    The add-on uploads and installs.

For more information see Installing add-ons. 

Enabling automatic add-on updates

Administrators can subscribe to have certain updates of selected add-ons applied automatically by UPM. If the auto-update feature is enabled and an update to an add-on has been selected for auto-update by Atlassian, UPM automatically downloads it and installs it when it becomes available on the Marketplace. Only certain add-ons and versions are subject to automatic updates. In particular, the feature is intended to ensure that important updates are applied for system add-ons such as the UPM itself.

Automatic updates are disabled by default.

To enable automatic updates:

  1. Click the Settings link at the bottom of the page.
  2. Enable the Automatically Update Atlassian-Selected Add-ons option.
  3. Click Apply

When UPM applies an update automatically, it logs the event in the audit log and generates a notification.


Last modified on Jul 2, 2014

Was this helpful?

Yes
No
Provide feedback about this article

Not finding the help you need?

Ask the community

Powered by Confluence and Scroll Viewport.