"Manage Apps" or "Manage add-ons" menu does not populate after upgrading the Universal Plugin Manager
Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.
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
Problem
After updating Confluence UPM the Manage apps (or Manage add-ons in older versions) page displays, but no add-ons are listed and the filters do not work correctly. There are no errors in the atlassian-confluence.log and the only error present is a Javascript error on the browser:
com.atlassian.upm.atlassian-universal-plugin-manager-plugin:upm-requirejs.js:3045 Uncaught SyntaxError: Unexpected token ILLEGAL
l.template @ com.atlassian.upm.atlassian-universal-plugin-manager-plugin:upm-requirejs.js:3045
(anonymous function) @ com.atlassian.upm.atlassian-universal-plugin-manager-plugin:upm-manage-templates.js?locale=XX-XX:1342
Cause
There is an add-on that is not compatible with the new version of the UPM.
Workaround
The workaround is to install a previous version of UPM, enable 'Safe Mode' prior to upgrading, and then upgrade to avoid add-on compatibility issues.
- Shutdown Confluence
- Ensure the user running Confluence has full read/write privileges to the confluence-home directory.
Remove the following directories
This will remove the plugin cache files only and will not permanently remove any plugins. These directories will be recreated during the next Confluence startup. However, some third-party plugins may store metadata in these directories, so we recommend creating a temporary backup of the directories.
<confluence-home>/bundled-plugins
<confluence-home>/plugins-cache
<confluence-home>/plugins-osgi-cache
<confluence-home>/plugins-temp
<confluence-home>/bundled-plugins_language
- Generate a backup for your database.
Delete the pluginkey from the database. For the UPM, the sql statement would resemble:
delete from plugindata where pluginkey like 'com.atlassian.upm.atlassian-universal-plugin%';
This will remove 1 OR 2 plugins. Both are safe to delete from the database. Also, this is the syntax for postgreSQL and may have to be modified to work on your specific database setup.
- Start Confluence
- If the default version of UPM is not found in the Manage Add-Ons page, Manually install the UPM that is a previous version than the one you updated to. The versions and downloads can be found here.
- Once confirmed working, put the UPM into Safe Mode.
- Exit Safe Mode, but but ensure to click the option "Exit safe mode but do not restore the previous configuration", which should allow all your other user-installed plugins to remain disabled.
- Upgrade the UPM to the version that caused the issue.
- Enable the third party add-ons one by one.
Resolution
The resolution is to find the add-on causing the Javascript error in the first place and disable it.
- Navigate to the Manage Add-Ons page.
- Enable the Google Javascript Console.
- Reload the page and see if there are any errors such as 'Unexpected token ILLEGAL'.
Expand the error details in the console.
See if there are any errors such as:
com.atlassian.upm.atlassian-universal-plugin-manager-plugin:upm-requirejs.js:3045 (anonymous function) @ com.atlassian.upm.atlassian-universal-plugin-manager-plugin:upm-manage-templates.js?locale=xx-xx 1342
- Note the language after locale. For example, locale=en-US.
- Go to the Manage Add-Ons page and disable the language add-on displayed in step 6. In this example the add-on is Confluence English (United States) Language Pack.