How to manually reset UPM or manually upgrade UPM?
Platform Notice: Data Center - This article applies to Atlassian products on the Data Center platform.
Note that this knowledge base article was created for the Data Center version of the product. Data Center knowledge base articles for non-Data Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Purpose
Sometimes you're unable to access the Add-Ons in the Confluence Administration page because the Universal Plugin Manager (UPM) is somehow corrupted.
Or, the default upgrade process for UPM doesn't work.
Solution
- Try to clear the Plugin Cache first to see if it works.
- Update all incompatible plugins to the compatible version and disable those that are totally incompatible.
- If you're unable to update or if it still fails, try the steps below
Only perform the steps below as a last resort after ensuring that
- The Server Base URL is correct and it's the same with the URL that you're accessing Confluence with
- The proxy (if there is) and firewall have been configured correctly. Check your server.xml and if you have proxy or SSL, ensure the settings are there.
To manually reset the UPM :
We would need to delete some entry from the database.
Please backup your Confluence Home Directory, Installation Directory and your database before proceeding. This is very important because we're performing some database manipulation which might break Confluence if it's done incorrectly
If possible, try this out on a cloned test instance first.
- Go to Confluence Administration >> Manage Add-Ons and take note of your UPM version.
- Shut down Confluence.
Run this SQL query on your Confluence database
delete from plugindata where PLUGINKEY='com.atlassian.upm.atlassian-universal-plugin-manager-plugin'- Go to
<Confluence Installation Directory>/confluence/WEB-INF/atlassian-bundled-pluginsand search for allatlassian-universal-plugin-manager-pluginand delete the JAR file. By default, it's only 1 JAR file. - Then, clear the plugin cache again by deleting the following folders.
- <confluence-home>/bundled-plugins
- <confluence-home>/plugins-cache
- <confluence-home>/plugins-osgi-cache
- <confluence-home>/plugins-temp
- <confluence-home>/bundled-plugins_language (This may, or may not exist)
- Download the same UPM version in step 1 and ensure that it is compatible with your Confluence version.
- Go to
<Confluence Installation Directory>/confluence/WEB-INF/atlassian-bundled-pluginsand copy this JAR file into the folder. - Start up Confluence
To manually upgrade the UPM :
Try to update the UPM via file upload if the default method is not working. Ensure that the UPM version downloaded is compatible with your Confluence version
If it's not working, ensure that The Server Base URL is configured correctly.
Only if it's still not working, we would need to delete some entry from the database.
Please backup your Confluence Home Directory, Installation Directory and your database before proceeding. This is very important because we're performing some database manipulation which might break Confluence if it's done incorrectly
If possible, try this out on a cloned test instance first.
- Shut down Confluence.
Run this SQL query on your Confluence database
delete from plugindata where PLUGINKEY='com.atlassian.upm.atlassian-universal-plugin-manager-plugin'- Go to
<Confluence Installation Directory>/confluence/WEB-INF/atlassian-bundled-pluginsand search for allatlassian-universal-plugin-manager-pluginand delete the JAR file. By default, it's only 1 JAR file. - Then, clear the plugin cache again by deleting the following folders.
- <confluence-home>/bundled-plugins
- <confluence-home>/plugins-cache
- <confluence-home>/plugins-osgi-cache
- <confluence-home>/plugins-temp
- <confluence-home>/bundled-plugins_language (This may, or may not exist)
- Download the UPM version that you wish to upgrade to and ensure that it is compatible with your Confluence version.
- Place the newly downloaded UPM JAR into <Confluence Installation Directory>/confluence/WEB-INF/atlassian-bundled-plugins where the previous JAR file was deleted
- Start up Confluence