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.
Support for Server* products will end after 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
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+.
For Jira 9, you may refer to this - JRASERVER-74882Getting issue details... STATUS to add the additional JVM arguments.
- 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.
When using Jira on kubernetes these steps can be applied:
- Create a file named `jira-configmap.yaml` with the following content:
apiVersion: v1
kind: ConfigMap
metadata:
name: jira-configmap
data:
jira-config.properties: |
upgrade.reindex.allowed=false
2. Apply the ConfigMap to your Kubernetes cluster using the following command:
kubectl apply -f jira-config -map.yaml
3. Then, you need to mount this ConfigMap to your Jira pod. You can do this by modifying your Helm values. Create a file named `values.yaml` with the following content:
additionalVolumes:
- name: jira-config-properties
configMap:
name: jira-configmap
additionalVolumeMounts:
- name: jira-config-properties
mountPath: /var/atlassian/application-data/jira/jira-config.properties
subPath: jira-config.properties
4. Upgrade Jira using the Helm upgrade command, include the `-f` flag to specify your `values.yaml` file:
helm upgrade --set image.tag=<your Jira version> -f values.yaml <your release name> atlassian/jira-software
5. This will upgrade Jira and set `upgrade.reindex.allowed=false` in `jira-config.properties`.
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.