Cloud
Data Center 11.3
Versions

Migrating to OpenSearch without downtime

Configuring OpenSearch for Jira

On this page

Related content

  • No related content found

Still need help?

The Atlassian Community is here for you.

Ask the community

This document explains how to migrate the search index from Lucene to OpenSearch while minimizing downtime.

Jira cluster requirements

You need a Jira cluster with two or more nodes running on Lucene, using Jira 11.2 or later. OpenSearch is not supported on earlier Jira versions. For example:

  • node-a

  • node-b

Migration steps

To migrate from Lucene to OpenSearch:

  1. Add a new dark Jira node configured with OpenSearch to the cluster:

    • Create a new node (for example, node-os), but don't include it in the LoadBalancer Jira group.

    • Configure the new node to use OpenSearch in the jira.properties file.

    • Start Jira on the node-os node.

  2. Enable the feature flag com.atlassian.jira.migrate.lucene.to.opensearch.enabled. More about managing dark features.

  3. On node-os, go to /secure/admin/IndexAdmin.jspa and select Re-index.

  4. Add additional Jira nodes as needed (for example, node-os-a and node-os-b) to the cluster and the LoadBalancer.

    • Drain and remove node-a and node-b from the LoadBalancer, then terminate them.

  5. Disable the feature flag com.atlassian.jira.migrate.lucene.to.opensearch.

  6. (Optional) Terminate node-os.

Last modified on Nov 13, 2025

Was this helpful?

Yes
No
Provide feedback about this article

Related content

  • No related content found
Powered by Confluence and Scroll Viewport.