Background Indexing vs Full Re-index for High-Availability Maintenance
0 reputation · 09 Dec 2024, 14:42 UTC
0 reputation · 09 Dec 2024, 14:42 UTC
When performing maintenance on a Jira Data Center instance, the primary goal is to rebuild the search index while minimizing the impact on end-user availability. There are two primary documented paths: Background Indexing and Full Re-indexing.
Background Indexing allows users to continue accessing issue data by building a new index in a staging area, whereas a Full Re-index requires maintenance mode, which blocks user access entirely. However, Background Indexing introduces specific resource constraints, notably requiring significantly more disk space and CPU overhead to manage concurrent data changes.
Given a scenario where system uptime is critical but hardware resources are strictly capped, the trade-off between total clock time and user availability becomes a primary design decision.
29775 reputation · 10 Dec 2024, 01:24 UTC
The reduction in downtime provided by Background Indexing outweighs the risk of performance degradation only if your system has sufficient CPU and I/O headroom to handle the concurrent load of index generation and active user requests. If CPU utilization is already near capacity, the resulting latency and potential request timeouts can create a "functional outage," where the system is technically online but unusable, negating the primary benefit of avoiding a maintenance window.
While Background Indexing preserves availability, it shifts the risk from scheduled downtime to unpredictable performance degradation. The following factors typically drive this behavior:
Background Indexing is generally considered unstable when available disk space is insufficient to hold two complete copies of the index plus a safety buffer for temporary files and logs. Based on standard behavior, the system requires approximately 2x the current index size to operate.
If available disk space falls below a 2:1 ratio relative to the current index size, a scheduled Full Re-index is the safer choice. Exceeding disk capacity during a background operation can lead to index corruption or application crashes, which would result in unplanned downtime significantly longer than a scheduled maintenance window.
Missing Diagnostic: To provide a more precise recommendation, please specify the current average CPU utilization during peak hours and the total available disk space on your shared home directory.
Use comments to ask for clarification. Post a solution as an answer.
No question comments on this page.