How To Disable Automatic Re-indexes After Upgrading
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+.
- Edit or create
<jira-home>/jira-config.properties
: Edit the jira-config.properties file in Jira server. - Add the line
upgrade.reindex.allowed=false
. - 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. - 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.