How to clear Jira Data Center / Server plugin cache
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:
- Stop Jira. One Node at a time.
- 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.
- Start Node 1.
- Start the other Nodes, one Node at a time.
Jira Server
To clear the plugin cache on a Server or single-node DC instance:
- Stop Jira.
- 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).
- 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