Upgrading an OpenSearch Cluster

Search with OpenSearch supports several concurrent versions of OpenSearch.

When you create a cluster, by default, it's based on the latest supported version of OpenSearch. For existing clusters using older versions, you can upgrade the cluster to use the functionality available in the latest version of OpenSearch.

The upgrade process depends on whether you're doing a major version upgrade or a minor version upgrade. A major version upgrade is indicated by a change in the first number in the build number, for example, 1.2.4 to 2.3.0. A minor version upgrade is indicated by a change in the second number in the build number, for example, 2.3.0 to 2.11. For more information about OpenSearch releases, see Supported Versions.

When you're doing a major version upgrade, use the upgrade process described in this topic. For minor version upgrades, you can use the inline upgrade functionality described in Inline Upgrade for OpenSearch Clusters.

  1. Create a new cluster with the same node configuration as the cluster that you want to upgrade. See Creating an OpenSearch Cluster.

  2. Create a backup of the old cluster that you want to upgrade.

    You can create the cluster backup by using the Snapshot API or by using the process described in Creating an OpenSearch Cluster Backup.

  3. Restore the backup to the new cluster that you created in step 1.

    The restore process depends on how you created the cluster backup.