Enabling the JIRA Agile plugin gives the error "The call to the JIRA server did not complete within the timeout period. We are unsure of the result of this operation."

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

Symptoms

This problem may occur after upgrading the JIRA Agile plugin and will prevent it from being enabled.

Enabling the JIRA Agile plugin shows the following error:

The call to the JIRA server did not complete within the timeout period. We are unsure of the result of this operation.

The following appears in the atlassian-jira.log:

Caused by: java.lang.IllegalStateException: Can only register services while bundle is active or activating.
    at org.apache.felix.framework.Felix.registerService(Felix.java:2817)
    at org.apache.felix.framework.BundleContextImpl.registerService(BundleContextImpl.java:251)

or:

/rest/plugins/1.0/com.pyxis.greenhopper.jira-key [atlassian.plugin.manager.DefaultPluginManager] There was an error loading the descriptor 'JIRA Agile Help' of plugin 'com.pyxis.greenhopper.jira'. Disabling.
java.lang.RuntimeException: Unable to enable web fragment
    at com.atlassian.plugin.web.descriptors.AbstractWebFragmentModuleDescriptor.enabled(AbstractWebFragmentModuleDescriptor.java:133)
    at com.atlassian.plugin.web.descriptors.DefaultWebItemModuleDescriptor.enabled(DefaultWebItemModuleDescriptor.java:72)
    at com.atlassian.plugin.web.descriptors.DefaultAbstractWebFragmentModuleDescriptor.enabled(DefaultAbstractWebFragmentModuleDescriptor.java:34)
...
Caused by: java.lang.IllegalStateException: Cannot create object because the plugin container is unavailable for bundle 'com.pyxis.greenhopper.jira'
    at com.atlassian.plugin.osgi.factory.OsgiPluginInstalledHelper.getRequiredContainerAccessor(OsgiPluginInstalledHelper.java:219)
    at com.atlassian.plugin.osgi.factory.OsgiPlugin.autowire(OsgiPlugin.java:372)
    at com.atlassian.plugin.osgi.factory.OsgiPlugin.autowire(OsgiPlugin.java:362)


Cause

There are two known causes for this issue:

  1. The inconsistency of OSGI plugin caches triggered from inappropriate shutdown of Tomcat.
  2. The Tomcat user not have the correct permissions to access the directory.

Resolution

Option #1

  1. Stop JIRA;
  2. Remove the below directories, that hold plug-in caches:

    <JIRA_HOME>/plugins/.osgi-plugins/
    <JIRA_HOME>/plugins/.bundled-plugins/

    (info) Those directories will be recreated upon JIRA's next startup.

  3. Ensure that the user which runs JIRA has the correct permissions on these directories (recursively);
  4. Start JIRA;
(info) We have a bug that is being tracked for this behaviour under JRASERVER-27438 - JIRA fails to start if it can't delete the Felix OSGI cache - please vote and watch it for future updates from our developers on a permanent solution.

Option #2

If the above solution does not work, then you're probably facing a timeout problem that is impeding JIRA Agile to completely startup with JIRA. To resolve that, you'll have to increase the timeout JIRA imposes in the plugin loading process.

  1. Stop JIRA;
  2. Following these instructions, add the below argument to JIRA's startup parameters:

    -Datlassian.plugins.enable.wait=300
  3. Start JIRA;

JIRA Agile should now be enabled during startup.

Last modified on Jan 28, 2025

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.