Oracle Cloud Infrastructure Documentation

Manually Upgrading an OpenSearch Cluster

Upgrade an OpenSearch cluster yourself instead of relaying on the automatic software upgrade capability.

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.

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 OpenSearch Cluster Software Upgrades.

From the Console

  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.