From 3c645fd98b21ca6acf0fc57d1a638c0bf2e0f3ab Mon Sep 17 00:00:00 2001 From: Pawel Wlodarczyk Date: Tue, 25 Nov 2025 10:07:23 +0000 Subject: [PATCH] Clarify upgrade path for OpenSearch versions Added note about upgrading to OpenSearch 2.19 before 3.x. Signed-off-by: Pawel Wlodarczyk --- _migrate-or-upgrade/rolling-upgrade/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/_migrate-or-upgrade/rolling-upgrade/index.md b/_migrate-or-upgrade/rolling-upgrade/index.md index 32533ee15f..80b002e2e1 100644 --- a/_migrate-or-upgrade/rolling-upgrade/index.md +++ b/_migrate-or-upgrade/rolling-upgrade/index.md @@ -22,6 +22,7 @@ This document serves as a high-level, platform-agnostic overview of the rolling Before making any changes to your OpenSearch cluster, is it highly recommended to back up your configuration files and create a [snapshot]({{site.url}}{{site.baseurl}}/tuning-your-cluster/availability-and-recovery/snapshots/snapshot-restore/) of the cluster state and indexes. **Important**: OpenSearch nodes **cannot be downgraded**. If you need to revert the upgrade, then you will need to perform a new installation of OpenSearch and restore the cluster from a snapshot. Take a snapshot and store it in a remote repository before beginning the upgrade procedure. Rolling upgrades are **only supported between major adjacent versions**, for example, from OpenSearch 1.x to 2.x but not 1.x to 3.x. +If you're running OpenSearch 1.3 or 2.x, you must first upgrade to OpenSearch 2.19 before upgrading to OpenSearch 3.x. {: .important} ## Performing the upgrade