This page tells you how to upgrade the Universal Plugin Manager (UPM). It contains the following topics:
Background
The UPM is itself a plugin. To upgrade the UPM, you need to install a new version of the UPM JAR file. Of course, the tool used to install and manage plugins is the UPM itself.
Upgrading the UPM (from version 1.5 or lower)
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:
- Download the latest version of the UPM plugin from the Atlassian Plugin Exchange.
- Log in to your Atlassian application as a user with administrator permissions.
- Click Administration from the dashboard.
- Go to the Plugins section.
This is the UPM. - Navigate to the Install tab.
- Click Upload Plugin.
- Browse to the UPM plugin JAR that you downloaded in step 1 and select it.
- Press Upload.
Restart the application.
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.)
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:
- Log in to your application as a system administrator.
- Go to the plugins section on your application's administration screen. This is the Universal Plugin Manager.
- If a new version of UPM is available from the Atlassian Plugin Exchange, you will see this banner:
- Click the "click here" link. UPM downloads and installs the new version in one step. You do not need to restart the application.
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:
- Download the latest version of the UPM plugin from the Atlassian Plugin Exchange.
- Copy the plugin JAR file into your JIRA home directory:
<JIRA-HOME>\plugins\installed-plugins
- Restart JIRA.
Fallback method for upgrading the UPM in Confluence:
- Download the latest version of the UPM plugin from the Atlassian Plugin Exchange.
Go to this URL on your Confluence site:
http://<YOUR_CONFLUENCE_SITE>/admin/viewplugins.action
- 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.
- Restart Confluence.
Fallback method for upgrading the UPM in FishEye:
- Download the latest version of the UPM plugin from the Atlassian Plugin Exchange.
- Shutdown your FishEye instance;
- Open the
$FISHEYE_INST/plugins/bundled-plugins.zip
; - Delete (not extract) the existing
atlassian-universal-plugin-manager-plugin-x.x.x.jar
from the zip file; - Drag and drop the new plugin version from the folder it was downloaded to into the zip file;
- Close the zip file;
- Delete the
$FISHEYE_INST/var/plugins/bundled/atlassian-universal-plugin-manager-plugin-x.x.x.jar
file; - 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:
- Obtain the UPM JAR from the Atlassian Plugin Exchange.
- 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. - Wait a few minutes for the installation to finish in the background, then do a hard refresh of the page.
- Go to the Manage Existing tab.
- 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: