Skip to content

Commit 76c8d12

Browse files
authored
[DOCS] Fix upgrade docs for 8.x (#84076) (#84306)
The current upgrade docs contain some language that's only applicable to 8.0. This updates the docs so they're usable in other 8.x branches. (cherry picked from commit 2437e7d)
1 parent 92a65be commit 76c8d12

File tree

2 files changed

+19
-17
lines changed

2 files changed

+19
-17
lines changed

docs/reference/upgrade.asciidoc

Lines changed: 16 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,19 @@
11
[[setup-upgrade]]
22
= Upgrade {es}
33

4-
{es} clusters can usually be upgraded one node at a time so
5-
upgrading does not interrupt service. To upgrade to 8.0 or later,
6-
**you must first upgrade to {prev-major-last}**, even if you opt to
7-
do a full-cluster restart instead of a rolling upgrade.
8-
9-
This enables you to use the **Upgrade Assistant** to identify and resolve issues,
10-
reindex indices created before 7.0, and then perform a rolling upgrade.
11-
12-
You must resolve all critical issues before proceeding with the upgrade.
13-
14-
For upgrade instructions, see {stack-ref}/upgrading-elastic-stack.html[Upgrading to Elastic {version}].
4+
{es} clusters can usually be upgraded one node at a time so upgrading does not
5+
interrupt service. For upgrade instructions, refer to
6+
{stack-ref}/upgrading-elastic-stack.html[Upgrading to Elastic {version}].
7+
8+
.Upgrade from 7.x
9+
IMPORTANT: To upgrade to {version} from 7.16 or an earlier version, **you must
10+
first upgrade to {prev-major-last}**, even if you opt to do a full-cluster
11+
restart instead of a rolling upgrade. This enables you to use the **Upgrade
12+
Assistant** to identify and resolve issues, reindex indices created before 7.0,
13+
and then perform a rolling upgrade. You must resolve all critical issues before
14+
proceeding with the upgrade. For instructions, refer to
15+
{stack-ref}/upgrading-elastic-stack.html#prepare-to-upgrade[Prepare to upgrade
16+
from 7.x].
1517

1618
[discrete]
1719
[[upgrade-index-compatibility]]
@@ -29,9 +31,9 @@ that need to be reindexed or removed.
2931
[[upgrade-rest-api-compatibility]]
3032
=== REST API compatibility
3133

32-
REST API compatibility in a per-request opt-in feature that can help REST clients
33-
mitigate non compatible (breaking) changes to the REST API.
34-
See <<rest-api-compatibility>> for additional information.
34+
<<rest-api-compatibility,REST API compatibility>> is a per-request opt-in
35+
feature that can help REST clients mitigate non-compatible (breaking) changes to
36+
the REST API.
3537

3638
[discrete]
3739
[[upgrade-fips-java17]]

x-pack/docs/en/security/fips-java17.asciidoc

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
1-
{es} 8.0 requires Java 17 or later.
1+
{es} {version} requires Java 17 or later.
22
There is not yet a FIPS-certified security module for Java 17
3-
that you can use when running {es} 8.0 in FIPS 140-2 mode.
3+
that you can use when running {es} {version} in FIPS 140-2 mode.
44
If you run in FIPS 140-2 mode, you will either need to request
5-
an exception from your security organization to upgrade to {es} 8.0,
5+
an exception from your security organization to upgrade to {es} {version},
66
or remain on {es} 7.x until Java 17 is certified.
77
ifeval::["{release-state}"=="released"]
88
Alternatively, consider using {ess} in the FedRAMP-certified GovCloud region.

0 commit comments

Comments
 (0)