Re-indexing failed in Jira Data Center
Platform Notice: Data Center Only - This article only applies to Atlassian apps 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
Problem
Re-indexing failed on one of your nodes and the following error was displayed in Jira:
Re-indexing failed
Node node1 lost contact with the cluster while performing a re-index. The index on this node is most likely corrupted, and might affect the index on other nodes if it rejoins the cluster.
Ensure the node is turned off, or restart it, to prevent this.
Context
When you perform a full re-index in Jira Data Center, Jira deletes the index on the node on which you initiated the re-index, and rebuilds it from scratch. If you’re seeing this error message, it means that the node went down or lost contact with the cluster while re-indexing was still in progress. Until this failed re-index is accounted for, no further re-indexing tasks can be performed in the cluster.
Solution
Warning — isolate the failed node first: The node that lost contact likely has a corrupted index. If it is still alive and rejoins the cluster, it can distribute that bad index to healthy nodes. Before clicking "Clean up failed tasks", confirm the failed node is shut down or restarted so it cannot rejoin with a corrupt index.
You can fix this problem by clicking the Clean up failed tasks button below the error. This action will cancel the current re-indexing process and clean up any failed tasks, allowing you to re-index again. Once that’s done, you can safely re-index Jira using a different node.
Ensure the failed node is actually down (shut down or restart it) — Jira only knows it stopped communicating, not whether it died.
For more info on how to restart Jira, see Starting and stopping Jira applications.
Click Clean up failed tasks below the error to cancel the failed re-index and unblock the cluster.
Re-run the full re-index from a different, healthy node.
How to verify: After cleanup and re-index from a healthy node, confirm no node is stuck in MAINTENANCE and that re-indexing completes with "Reindex complete" in the log. Bring the previously-failed node back only after confirming the cluster index is healthy.
Was this helpful?