Updating the Universal Plugin Manager

Checking the UPM software version

If the Atlassian application instance is connected to the Internet, it automatically checks whether a more recent version of the UPM is available and presents a notice on the page if so.

You can see what version of the UPM software is currently running by checking the version number at the bottom of the plugins administration page.

Updating UPM software automatically

To update the UPM software to its latest version from the UPM interface:

1. As a system administrator, go to the plugins installation page. If you have UPM version 2.7 and later, this is the Manage Plugin page.
   If a software update for UPM is available, a banner similar to the following appears. 
   

   
   Note that the content of the UPM update banner varies slightly between different versions of the UPM. However, the banner should include a link for updating the UPM software.

2. Click the link for updating the UPM software in the banner. 
   UPM downloads and applies the new version of the UPM. You do not need to restart the application after the update. However, when updating from certain versions, you will need to refresh the browser page to see the changes. In this case, a message appears advising you to refresh your browser.

In UPM 2.7.4 and later, the banner offers links for three options:

• Update now: immediately downloads and applies the update to the UPM software.
• Skip this update: keeps the current version of the UPM software and suppresses future reminders about the availability of the current latest version. The reminder appears when subsequent versions become available.
• Remind me next time: closes the banner for now, but it will appear again the next time you go to the Manage Plugins page. 

Updating UPM by file upload

If not connected to the Internet or in certain troubleshooting scenarios, you may need to update the software by uploading the UPM JAR file to the Atlassian application. You need to follow these steps to update the Universal Plugin Manager for JIRA, Confluence, FishEye or Crucible from versions 1.5 and lower.

To update the UPM:

1. Download the latest version of the UPM plugin from the Atlassian Marketplace.
2. As an administrator in the Atlassian application, go to plugins administration page.
3. Navigate to the Install tab.
4. Click Upload Plugin.
5. Browse to the UPM plugin JAR that you downloaded and select it.

6. Press Upload to apply the update.
   A dialog appears indicating that the installation is being performed.

   Depending on the UPM version you are replacing, the installation process may appear to fail in various ways, such as appearing to hang, returning immediately, or by finishing and showing an error message. In most cases, the installation actually succeeds, but appears to fail due to issues with older UPM versions. If you think you have encountered this situation, wait a few minutes for the installation to finish and then refresh the browser. Check the footer at the bottom of the page to verify the UPM version.

7. When prompted, refresh the browser or restart the application.

   If you are updating the UPM in Confluence 3.4.x, you need to restart Confluence a second time. (See bug report CONF-22323. Note that this bug affects Confluence versions 3.4.x only.)

The UPM version is now up-to-date.

Updating or reverting UPM by JAR file replace

If for any reason you cannot update UPM through the Atlassian application administration page, you can update UPM file by replacing the UPM file in the directory instead.

This procedure also applies if you need to revert UPM to an earlier version. This is the only way to revert UPM to an earlier version.

Before starting, get the version of the UPM plugin that you want to install from Atlassian Marketplace. Then follow the instructions appropriate to your application.

JIRA

To update the UPM file on disk in JIRA:

1. Shut down JIRA.
2. Remove the existing UPM JAR file from this directory in your JIRA home directory:
   plugins\installed-plugins
   The name of the JAR file may be prepended with a number, such as: 
   846688264762062110.atlassian-universal-plugin-manager-plugin-2.7.6.jar
3. Copy the new UPM JAR file into the same directory.
4. Restart JIRA.

Confluence

Confluence stores plugins, such as UPM, in its database. Rather than attempting to remove the plugin from the database, you can use the Confluence plugin servlet, which presents a secondary web interface for managing plugins.

To update the UPM file in Confluence:

1. Go to this URL on your Confluence site:

   http://<confluence_site>/admin/viewplugins.action

   The installed version of the Confluence Plugin Manager appears.

2. Click Browse and find the UPM plugin JAR and upload the JAR into Confluence.
3. Restart Confluence.

FishEye

To update the UPM file on disk in FishEye:

1. Shut down your FishEye instance.
2. Using an archive management tool, open the following archive in your FishEye installation directory:
plugins/bundled-plugins.zip

3. Delete (do not extract) the existing atlassian-universal-plugin-manager-plugin-x.x.x.jar from the zip file.
4. Add the new plugin version from the folder it was downloaded to into the zip file.
5. Close the zip file.
6. Delete the following file from you FishEye installation directory:
var/plugins/bundled/atlassian-universal-plugin-manager-plugin-x.x.x.jar file.
7. Start your instance again.

Stash

To update the UPM file on disk in Stash:

1. Shut down Stash.
2. Remove the existing UPM JAR file from this directory in the Stash home directory:
   plugins\installed-plugins
The name of the JAR file may be prepended with a number, such as:
   846688264762062110.atlassian-universal-plugin-manager-plugin-2.7.6.jar
3. Copy the latest UPM JAR file into the same directory.
4. Restart Stash.