From 77c91cdb6c050df71fdb6c39dd624ae6057eeb66 Mon Sep 17 00:00:00 2001 From: David Turner Date: Fri, 7 Feb 2025 11:06:08 +0000 Subject: [PATCH 1/2] 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/reference/upgrade.asciidoc | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/reference/upgrade.asciidoc b/docs/reference/upgrade.asciidoc index d5057d9b87d85..7594fcabac3f0 100644 --- a/docs/reference/upgrade.asciidoc +++ b/docs/reference/upgrade.asciidoc @@ -25,6 +25,18 @@ proceeding with the upgrade. For instructions, refer to {stack-ref}/upgrading-elastic-stack.html#prepare-to-upgrade[Prepare to upgrade from 7.x]. +[discrete] +[[upgrade-newer-releases]] +=== Out-of-order releases + +Elastic maintains several minor versions of {es} 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. + [discrete] [[upgrade-index-compatibility]] === Index compatibility From 69aa192bfdc81ecd27eccc2577252bf9eb97f687 Mon Sep 17 00:00:00 2001 From: David Turner Date: Fri, 7 Feb 2025 11:56:26 +0000 Subject: [PATCH 2/2] Fix up to match stack docs --- docs/reference/upgrade.asciidoc | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/docs/reference/upgrade.asciidoc b/docs/reference/upgrade.asciidoc index 7594fcabac3f0..8577ddbef579a 100644 --- a/docs/reference/upgrade.asciidoc +++ b/docs/reference/upgrade.asciidoc @@ -29,10 +29,13 @@ from 7.x]. [[upgrade-newer-releases]] === Out-of-order releases -Elastic maintains several minor versions of {es} 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}. +Elastic maintains several minor versions of {es} 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}. 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.