Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Div
idPageTOC

On this page

Table of Contents
maxLevel2
excludeTable of Contents

Style
/*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 except for older versions of 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 app information and license information. This is the information that 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

No Format
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: 


 

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

Include Page
_StandardPluginErrorResolution
_StandardPluginErrorResolution



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.    

No Format
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

No Format
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

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

Include Page
_StandardPluginErrorResolution
_StandardPluginErrorResolution

...

App does not enable - unsupported version of Java

If you have an error in your application log like: Unsupported major.minor version 51.0It 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 TBLSQL, 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

Tip
titleUpdate UPM to recent level

It is strongly recommended that users update to the latest UPM level before installing new plugins or upgrades.


Tip
titleAlways review your plugins after installation

After installing a add-onan app, review your add-on your app list to ensure add-ons apps are properly enabled (UPM-2893). Note additional component add-ons apps that automatically got installed as an fyiFYI.

...