How To Disable Automatic Re-indexes After Upgrading

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.

Problem

When upgrading JIRA, an automated re-index happens. For larger organizations that need to minimize downtime this can be a significant hassle, and a way to work around it is needed.

Resolution

Due to JRASERVER-65568, this workaround will only work on Jira before 7.3.0 and Jira 8.0+.

  1. Edit or create <jira-home>/jira-config.propertiesEdit the jira-config.properties file in Jira server.
  2. Add the line upgrade.reindex.allowed=false.
  3. To save further time, you may also want to add the line jira.autoexport=false to disable the automatic export that is generated as part of the upgrade process.
  4. Restart JIRA before your upgrade to ensure the properties are picked up. 

After your upgrade, you may encounter a persistent "While upgrading Jira an upgrade task made changes that require reindexing" message while automatic reindexing on upgrades is disabled.

If you do, once your upgrade(s) are complete, remove the "upgrade.reindex.allowed=false" variable and restart Jira.

Last modified on Nov 18, 2019

Was this helpful?

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