/*TOC Macro Styles*/
#PageTOC {float:right; background:#f0f0f0; padding:20px 25px 6px 30px; color:#aaa; margin:0 0 20px 30px; -moz-border-radius: 12px;-webkit-border-radius: 12px; border-radius: 12px; -khtml-border-radius: 12px; text-align: left;}
#PageTOC h3 {color:#222; font-weight:normal; font-size:18px;margin:0 !important;padding:0  !important;line-height:.9em !important; font-style:italic;}
#PageTOC ul {padding:0 0 0 7px; list-style: none; }
#PageTOC ul li {padding:3px 0 0 20px} 

Overview

These are some generic tips and techniques to help resolve add-on app installation or licensing problems. In many cases, installation problems are not specific to the add-onapp, but instead, relate to general usage or issues with theAtlassian Universal Plugin Manager (UPM) or  or the underlying plugin system. Generally speaking, most recent versions of add-ons apps on this site are built using Atlassian's plugin 2 framework and all paid add-ons apps use Atlassian licensing support. Installation is provided by UPM. Licensing support is also provided by UPM. If these tips don't resolve your issue, it is likely you will need to open an Atlassian support ticket. 

If you see in product license errors, go to UPM and look at the details add-on details app information and license information. This is the information that needs to must be reported to support.

License

...

problems

LICENSE_EXPIRED

...

error

Manage add-ons shows the add-on apps shows the app with the follow error:

License is for an older version and maintenance has expired.

This will show shows in situations where the installed add-on installed app was built after the expiry date of your maintenance support. This is a valid error. You either need to get a more current license or un-install the add-on , or, uninstall the app and install an earlier version that is within your maintenance window.

If this is not your situation, in some cases this error may show incorrectly on JIRA Jira versions before JIRA Jira 6.4 and Confluence versions before Confluence 5.7. This is a UPM bug bug UPM-4565. 

Alternatives:

1. Update JIRA Jira or Confluence to a release where the bug is fixed. At ; at least JIRA Jira 6.4 or Confluence 5.7.
2. Renew the maintenance for the add-onapp.
3. Use a temporary evaluation license until you can resolve the issue.

...

Incompatible with

...

product license

After upgrading the Confluence license or upgrading the Universal Plugin Manager add-onapp, one or more add-ons apps stop working. When reviewing the add-ons apps in the Universal Plugin Manager, the text "Incompatible with Product License (wrong type)" is seen in the License Status field.

or Or, functions report the following error message: Notify your Confluence administrator that "Bob Swift Atlassian Add-ons Apps ..." requires a valid license. Reason: TYPE_MISMATCH.

1. Update UPM to the latest level and retry - this will solve solves many cases (UPM-4783).
2. Make sure you check all your other add-ons apps for similar problems! 
3. If you still have issues, contact contact sales@atlassian.com to  to have them generate compatible licenses for all the add-ons apps that need it. While you are waiting, consider:
   1. Reverting your Confluence license change until till Atlassian generates new and compatible licenses.
   2. Get an evaluation license until a permanent license is available.
4. See this this Confluence Knowledge Base item. 

VERSION_MISMATCH

...

error

A license is invalid if the app's build date is greater than or equal to the license's maintenance expiration date. That isFor example, if the license says that support is only available through 1/1/2012, then an existing installation of a app version with a build date of 1/1/2011 will continue working continues to work indefinitely, but, if you install a new version built on 1/2/2012 or later, it will not work with the old license.

Installation

...

problems

Plugin disabled

Users may report macros no longer working in Confluence or similar problems with JIRA Jira or Bamboo. The plugin may have become disabled because of installation of other add-ons apps or for other reasons. See See UPM-2893 for for instance.

Resolution steps

1. Go to UPM.
2. Enable all the add-ons apps that should must be enabled.
3. If the plugin still cannot be enabled:
   1. Uninstall the plugin
   2. Re-install the plugin
   3. You may need to re-install the license
4. If the plugin still cannot be enabled:
   1. Consider restarting the server
   2. Look in your server logs for installation errors and errors and clues
   3. Depending on the information you find, either open a support issue with Atlassian support (UPM) or plugin vendor (something indicating it is specific to the plugin)

...

An error occurred while installing the

...

app

An error occurred while installing the add-onapp. Refer to the logs for more information.

This is an error with UPM 2.17.5 and fixed on 2.17.7. Unfortunately, some product releases contain the failing UPM including at least JIRA Jira 6.3.4 and Confluence 5.6. See See UPM-4581.

In this particular case, the add-on app actually installs successfully and the error message can be ignored. The workaround is to update UPM to the latest level before installing any add-onsapps.

Plugin cannot be enabled

...

No Format
Unable to start the following add-onsapps ...

In some cases, the following Atlassian knowledge base item may help: How to Clear Confluence Plugins Cache.

LazyReference$InitializationException

 After  After installing or removing add-ons apps in Confluence, there can be errors reported like:  

com.atlassian.util.concurrent.LazyReference$InitializationException: java.lang.IllegalStateException: Cannot autowire object because the Spring context is unavailable.

java.lang.LinkageError

This is a UPM/plugin framework issue with mismatched class versions of some license management code. Likely It most likely is related to some other UPM or add-on or app upgrade or install that has occurred. Reference is UPM-3306.    

javax.servlet.ServletException: Servlet execution threw an exception
    at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:313)

caused by: java.lang.LinkageError: loader constraint violation: when resolving interface method "com.atlassian.upm.api.license.PluginLicenseManager.getLicense()Lcom/atlassian/upm/api/util/Option;" the class loader (instance of org/apache/felix/framework/ModuleImpl$ModuleClassLoader) of the current class, com/atlassian/upm/license/storage/lib/ThirdPartyPluginLicenseStorageManagerImpl$1, and the class loader (instance of org/apache/felix/framework/ModuleImpl$ModuleClassLoader) for resolved class, com/atlassian/upm/api/license/PluginLicenseManager, have different Class objects for the type com/atlassian/upm/api/util/Option used in the signature
    at com.atlassian.upm.license.storage.lib.ThirdPartyPluginLicenseStorageManagerImpl$1.call(ThirdPartyPluginLicenseStorageManagerImpl.java:61)

Include Page
_StandardPluginErrorResolution _StandardPluginErrorResolution

...

Service proxy has been destroyed

org.springframework.osgi.service.importer.ServiceProxyDestroyedException: service proxy has been destroyed

Include Page
_StandardPluginErrorResolution _StandardPluginErrorResolution

...

Other OSGI plugin related problems

Include Page
_StandardPluginErrorResolution _StandardPluginErrorResolution

...

...

App not working after upgrade

The add-onapp failed to enable. org.osgi.framework.BundleException: Unresolved constraint in bundle

...

App does not enable - unsupported version of Java

If you have an error in your application log like: Unsupported major.minor version 51.0. It means your server is running with Java 1.6 and needs Java 1.7. All recent add-ons apps require Java 1.7 - see Compatibility for  for more information. Look in your System Information screen and verify the Java version the server is running.

...

Table problems

Tables missing Common table capabilities expected from TBL, SQL, or similar add-onsapps. 

 Resolution Steps

1. Go to UPM and look for the TBLSORT the Table Library for Bob Swift Apps as: Bob Swift Software - Table Sorter Libraryor or Bob Swift Atlassian AddApps - ons - Table Library.

2. Make sure it is enabled! If not, enable it!

...

...

Installation

...

tips

...