From 3fcc1437a9e1aefd789a5a08f5b4d7571e38874a Mon Sep 17 00:00:00 2001 From: David Turner Date: Fri, 7 Feb 2025 10:56:05 +0000 Subject: [PATCH 1/3] Add upgrade note about release date constraint We don't support (and will actively block) upgrades to chronologically-older versions. This commit adds a note in the docs about this. --- docs/en/install-upgrade/upgrading-stack.asciidoc | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/en/install-upgrade/upgrading-stack.asciidoc b/docs/en/install-upgrade/upgrading-stack.asciidoc index 4219c92ac..c1a8fb0a4 100644 --- a/docs/en/install-upgrade/upgrading-stack.asciidoc +++ b/docs/en/install-upgrade/upgrading-stack.asciidoc @@ -9,6 +9,17 @@ These steps vary based on your current version: * <> endif::[] +[NOTE] +==== +Elastic maintains several minor versions of the Elastic Stack at once, so +releases do not always happen in order of their version numbers. You can only +upgrade to {version} if the version you are currently running has an older +version number than {version} _and_ has an earlier release date than {version}. + +If you are currently running a version with an older version number but a later +release date than {version}, wait for a newer release before upgrading. +==== + IMPORTANT: Upgrading from a release candidate build, such as 8.0.0-rc1 or 8.0.0-rc2, is not supported. Pre-releases should only be used for testing in a temporary environment. From 34a615a89e5077f9562a3c28cdb4b8260eff3803 Mon Sep 17 00:00:00 2001 From: David Turner Date: Fri, 7 Feb 2025 11:18:37 +0000 Subject: [PATCH 2/3] Update docs/en/install-upgrade/upgrading-stack.asciidoc Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com> --- docs/en/install-upgrade/upgrading-stack.asciidoc | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/docs/en/install-upgrade/upgrading-stack.asciidoc b/docs/en/install-upgrade/upgrading-stack.asciidoc index c1a8fb0a4..f12bf9bad 100644 --- a/docs/en/install-upgrade/upgrading-stack.asciidoc +++ b/docs/en/install-upgrade/upgrading-stack.asciidoc @@ -9,12 +9,15 @@ These steps vary based on your current version: * <> endif::[] -[NOTE] +[IMPORTANT] ==== -Elastic maintains several minor versions of the Elastic Stack at once, so +Elastic maintains several minor versions of the Elastic Stack at once. This means releases do not always happen in order of their version numbers. You can only -upgrade to {version} if the version you are currently running has an older -version number than {version} _and_ has an earlier release date than {version}. +upgrade to {version} if the version you are currently running meets both these +conditions: + +* Has an older version number than {version} +* Has an earlier release date than {version} If you are currently running a version with an older version number but a later release date than {version}, wait for a newer release before upgrading. From 9fb7065ac1398a969687522bc0d27d46a7ed3548 Mon Sep 17 00:00:00 2001 From: David Turner Date: Fri, 7 Feb 2025 11:21:26 +0000 Subject: [PATCH 3/3] Tweaks & add title --- docs/en/install-upgrade/upgrading-stack.asciidoc | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/docs/en/install-upgrade/upgrading-stack.asciidoc b/docs/en/install-upgrade/upgrading-stack.asciidoc index f12bf9bad..8b6dcfd8c 100644 --- a/docs/en/install-upgrade/upgrading-stack.asciidoc +++ b/docs/en/install-upgrade/upgrading-stack.asciidoc @@ -10,14 +10,15 @@ These steps vary based on your current version: endif::[] [IMPORTANT] +.Out-of-order releases ==== -Elastic maintains several minor versions of the Elastic Stack at once. This means -releases do not always happen in order of their version numbers. You can only -upgrade to {version} if the version you are currently running meets both these -conditions: +Elastic maintains several minor versions of the Elastic Stack at once. This +means releases do not always happen in order of their version numbers. You can +only upgrade to {version} if the version you are currently running meets both +of these conditions: -* Has an older version number than {version} -* Has an earlier release date than {version} +* Has an older version number than {version}. +* Has an earlier release date than {version}. If you are currently running a version with an older version number but a later release date than {version}, wait for a newer release before upgrading.