This documentation relates to an earlier version of the Universal Plugin Manager.
View

Unknown macro: {spacejump}

or visit the current documentation home.

This page tells you how to upgrade the Universal Plugin Manager (UPM). It contains the following topics:

Background

The UPM is itself a plugin. Of course, the tool used to install and manage plugins is the UPM itself.

Upgrading the UPM (from version 1.6 or higher)

Starting with version 1.6, UPM supports a simpler procedure for upgrading itself. Note that this will only work if the currently installed version is at least 1.6; if you are upgrading from 1.5 to 1.6, you must use the old procedure described above.

To upgrade the UPM:

  1. Log in to your application as a system administrator.
  2. Go to the plugins section on your application's administration screen. This is the Universal Plugin Manager.
  3. If a new version of UPM is available from the Atlassian Plugin Exchange, you will see this banner:
  4. Click the "click here" link. UPM downloads and installs the new version in one step. You do not need to restart the application.

Upgrading the UPM (from version 1.5 or lower)

To upgrade the UPM, you need to install a new version of the UPM JAR file.  Follow the steps below to upgrade the Universal Plugin Manager in JIRA, Confluence, FishEye or Crucible, if the currently installed version is 1.5 or lower.

To upgrade the UPM:

  1. Download the latest version of the UPM plugin from the Atlassian Marketplace (formerly the Plugin Exchange).
  2. Log in to your Atlassian application as a user with administrator permissions.
  3. Click Administration from the dashboard.
  4. Go to the Plugins section.
    This is the UPM.
  5. Navigate to the Install tab.
  6. Click Upload Plugin.
  7. Browse to the UPM plugin JAR that you downloaded in step 1 and select it.
  8. Press Upload.

  9. Restart the application.
    You may need to restart twice.

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

Alternative ways of upgrading the UPM

If for some reason you cannot use one of the upgrade methods described above, you can use the following methods instead.

Fallback method for upgrading the UPM in JIRA:

  1. Download the latest version of the UPM plugin from the Atlassian Plugin Exchange.
  2. Copy the plugin JAR file into your JIRA home directory:
    <JIRA-HOME>\plugins\installed-plugins
  3. Restart JIRA.

Fallback method for upgrading the UPM in Confluence:

  1. Download the latest version of the UPM plugin from the Atlassian Plugin Exchange.

  2. Go to this URL on your Confluence site:

    http://<YOUR_CONFLUENCE_SITE>/admin/viewplugins.action
  3. The earlier version of the Confluence Plugin Manager appears. Click Browse, find the UPM plugin JAR that you downloaded in step 1, and upload the JAR into Confluence.
  4. Restart Confluence.

Fallback method for upgrading the UPM in FishEye:

  1. Download the latest version of the UPM plugin from the Atlassian Plugin Exchange.
  2. Shutdown your FishEye instance;
  3. Open the $FISHEYE_INST/plugins/bundled-plugins.zip;
  4. Delete (not extract) the existing atlassian-universal-plugin-manager-plugin-x.x.x.jar from the zip file;
  5. Drag and drop the new plugin version from the folder it was downloaded to into the zip file;
  6. Close the zip file;
  7. Delete the $FISHEYE_INST/var/plugins/bundled/atlassian-universal-plugin-manager-plugin-x.x.x.jar file;
  8. Start your instance again.

Troubleshooting

Upgrading the UPM without internet access – installation seems to fail

You can upgrade the UPM to version 1.5 to allow it to work better when there is no connection to the Atlassian Plugin Exchange (for example, because you have no Internet connection). Due to a bug in older versions of UPM, the installation will appear to fail when there is no connection to the Atlassian Plugin Exchange, but the installation should still actually work.

To upgrade your UPM plugin where you have no Internet connection:

  1. Obtain the UPM JAR from the Atlassian Plugin Exchange.
  2. Follow the instructions to upload the plugin.
    Depending on your UPM version, this could appear to fail in various ways, such as just returning immediately, or keeping an installation dialog up forever. In such cases, the installation is not actually failing but just looks that way due to problems with older UPM versions.
  3. Wait a few minutes for the installation to finish in the background, then do a hard refresh of the page.
  4. Go to the Manage Existing tab.
  5. You should see Atlassian Universal Plugin Manager Plugin version 1.5 under User-installed Plugins.

After you have successfully installed UPM 1.5 or later, future plugin installations should no longer appear to fail.

More troubleshooting

Please refer to the following sources of information:

  • No labels



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Tweet, blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.