How to clear Jira Data Center / Server plugin cache
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs 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
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.
Solution
Environment
Jira 7.x, Jira 8.x, Jira 9.x, Jira 10.x
Clear plugin cache for Jira Data Center cluster
To clear the plugin cache in a Jira Data Center 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
Clear plugin cache for Jira Server or single-node Data Center
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
Was this helpful?