How to clear Jira Data Center / Server plugin cache

Still need help?

The Atlassian Community is here for you.

Ask the community

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

Summary


When performing significant changes related to apps, there are cases when the app shows inconsistent behavior or issues getting enabled during startup.

One of the possible reasons for this is problems with the plugin cache.

Environment

Jira 7.x, Jira 8.x, Jira 9.x, Jira 10.x

Solution

Clear out Jira's plugin cache. Instructions depend on whether you run Jira in a Data Center cluster as below.

Jira DC

To clear the plugin cache in a Jira DC cluster, you'll need to perform a rolling restart of all cluster nodes:

  1. Stop Jira. One Node at a time.
  2. Clear the plugin cache on all the nodes and on the shared-home:
    • Delete JIRA_HOME/plugins/.bundled-plugins; ( This folder will be re-created in the next start-up ) for each Node;
    • Delete JIRA_HOME/plugins/.osgi-plugins; ( This folder will be re-created in the next start-up ) for each Node;
    • Delete SHARED_HOME/plugins/.bundled-plugins; ( This folder will be re-created in the next start-up )
    • Delete SHARED_HOME/plugins/.osgi-plugins; ( This folder will be re-created in the next start-up )
    • Delete the content of JIRA_INSTALL/work directory (only the content, keep the folder empty) for each Node;
    • Delete the content of JIRA_INSTALL/temp directory (only the content, keep the folder empty) for each Node.
  3. Start Node 1.
  4. Start the other Nodes, one Node at a time.

Jira Server

To clear the plugin cache on a Server or single-node DC instance:

  1. Stop Jira.
  2. Clear the plugin cache by removing the following directories:
    • Delete JIRA_HOME/plugins/.bundled-plugins; ( This folder will be re-created in the next start-up );
    • Delete JIRA_HOME/plugins/.osgi-plugins; ( This folder will be re-created in the next start-up );
    • Delete the content of JIRA_INSTALL/work directory (only the content, keep the folder empty);
    • Delete the content of JIRA_INSTALL/temp directory (only the content, keep the folder empty).
  3. Start Jira.

Jira with Kubernetes Helm Charts

Please see How to Clear Jira's Plugin Cache in a Kubernetes Helm Chart Installation


If you continue to have start-up issues, Please see this KB Jira startup fails with message that required plugins are not started


Last modified on Sep 25, 2024

Was this helpful?

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