Troubleshooting JIRA Startup Failed Error

Still need help?

The Atlassian Community is here for you.

Ask the community

Overview

There have been a few other knowledge base articles that talk about this error in detail, which I will point out to further in, but this page will be a general guide on how to troubleshoot this, and consolidate the information from the various other KB pages.

Symptoms

When you try to startup your JIRA applications, they don't start. Instead, you are met with an error that states 'JIRA Startup Failed' :

JIRA Startup Failed

You cannot access JIRA at present. Look at the table below to identify the reasons:

Description

The following plugins are required by JIRA, but have not been started:

* Atlassian JIRA - Plugins - Project Config Plugin (com.atlassian.jira.jira-project-config-plugin)
* Embedded Gadgets Plugin (com.atlassian.gadgets.embedded)
* Gadget Dashboard Plugin (com.atlassian.gadgets.dashboard)
* Opensocial Plugin (com.atlassian.gadgets.opensocial)
* Gadget Directory Plugin (com.atlassian.gadgets.directory)
* Atlassian JIRA - Plugins - Gadgets Plugin (com.atlassian.jira.gadgets)

 

Please note that the disabled plugins are usually random, and does not have a specific pattern to it.

Cause + Resolution

There are a variety of causes, each with their own unique resolution methods : 



 


 Memory Allocation 

Cause

During the startup process, the bundled plugins are unpacked from the $JIRA_INSTALL/atlassian-jira/WEB-INF/classes/atlassian-bundled-plugins.zip file into $JIRA_HOME/plugins/.bundled-plugins, while the $JIRA_HOME/plugins/installed-plugins are extracted to $JIRA_HOME/plugins/.osgi-plugins. 

This process is rather resource-intensive, and if the required resources are not available, the plugins timeout during the unpacking, and causes JIRA applications to be unusable. 


Resolution

You would have to increase the memory of your JIRA applications instance. The amount to be increased depends on the size of your instance, so there really isn't a pre-determined value that you have to increase to. Depending on whether you are using JIRA applications in Linux, JIRA applications in Windows as a standalone application, or JIRA applications as a Windows service, each of them have a different method used to increase the memory. All three of those methods are described in detail in this KB - Increasing JIRA Memory.


Anti-Virus

Cause

JIRA applications and anti-virus software are known to be mortal enemies - It's hard to have both of them at the same place at the same time. During startup, JIRA applications create quite a number of temporary files that it has to read from. If an anti-virus software goes through all of  these files (which are usually in the JIRA_INSTALLATION or the JIRA_HOME directory), it can hinder or stop the startup process from proceeding normally. 

 

Resolution

Exclude your JIRA INSTALLATION DIRECTORY and your JIRA HOME DIRECTORY from being scanned by the anti-virus. However, sometimes, even though an exception has been added, the problem might still persists, in those cases, please try disabling your anti-virus entirely. Further information regarding the correlation between anti-virus and JIRA application performance can be viewed in this KB - Crashes and Performance Issues Troubleshooting.

 

Corrupted Plugin Caches

Cause

It is possible the plugin caches of your JIRA application instance enter into a corrupted state. These corrupted caches can disrupt your JIRA application operations, as well as cause your JIRA applications to not be able to startup. to time, the plugin caches of your JIRA application instance can get corrupted. These corrupted caches can disrupt your JIRA application operations, as well as cause your JIRA applications to not be able to startup.

 

Resolution

You would have to clear and recreate your plugin caches from scratch. To do this, restart JIRA and the plugin caches will be recreated.


Incompatible JAVA version

Cause

JIRA applications require JAVA to run, and earlier versions of JIRA applications are not compatible with JAVA 7 (JDK 1.7) such as JIRA 5.1.x. Running JIRA 5.0.x with JAVA 7 will cause some issues with the plugins.


Resolution

Please ensure that you are running on the supported version of JAVA. You may refer to JIRA Supported Platforms page and choose the JIRA application version you are on accordingly.


Plugins disabled in database

Cause

In some cases, the plugins are unable to be started up as it is actually disabled in the database. To enable and subsequently use them, some SQL manipulation would have to be done.


Resolution

Some SQL queries are required here to enable the plugins, which are documented in detail in this KB - JIRA Does Not Start Due to Disabled Plugin

Please note that if the query in step 2 does not return any results, then this solution does not apply to your current situation.

 

Plugins require more time to startup

Cause

As the extraction of the plugins are a rather resource-intensive process, sometimes a shortage of resources can cause the process of the extraction to take longer (but there are still enough resources to startup the instance instead of shutting it down completely). 

 

Resolution

You would have to edit some parameters so that JIRA provides more time for the plugins to be extracted, instead of cutting it off and assuming that it failed to startup. To do so, please insert the following into your JIRA application startup parameter using the methods mentioned here - Setting Properties and Options on Startup:

 

-Datlassian.plugins.enable.wait=300

(warning) Please restart the instance after adding the parameter in order to apply the changes to your JIRA applications.

 

JIRA applications are locked

Cause

As the extraction of the plugins are a rather resource-intensive process, sometimes a shortage of resources can cause the process of the extraction to take longer (but there are still enough resources to startup the instance instead of shutting it down completely). 

  1.  JIRA applications were shut down incorrectly, or failed to shut down.
  2. A second instance of JIRA applications, pointing to the same database, was started. This can happen in the case of a test instance of JIRA applications pointing to the production database.
  3. In rarer circumstances, especially after a plugin installation, JIRA applications can run out of PermGen memory on startup. See JIRA Crashes Due to 'java.lang.OutOfMemoryError PermGen Space Error.

Resolution

Delete the JIRA application lock file. See How do I unlock my JIRA home directory? for instructions.

Last modified on Feb 19, 2016

Was this helpful?

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