How to clear Jira Data Center / Server plugin cache
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
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
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