Skip to content

Commit 4c2450e

Browse files
authored
[DOCS] Add cgroup v2 startup failure note for ES 8.0.0–8.4.3 (#157588)
* docs: add cgroup v2 startup failure note for ES 8.0.0–8.4.3 * docs: add cgroup v2 known issue to release notes for ES 8.0.0–8.4.3 Use the tagged-region pattern (matching existing known-issue conventions) to surface the startup failure in each affected version's release notes rather than in the install/sysconfig pages, which are irrelevant to users already on 8.19. Adds a tagged region in 8.0.0.asciidoc and includes it in all affected patch release notes: 8.0.1 through 8.4.3 (18 files total). Also reverts the previous incorrect changes to install.asciidoc and sysconfig.asciidoc. Related: elastic/support-tech-lead#1913 KB: https://ela.st/es-may-fail-on-cgroup-v2
1 parent e9d633f commit 4c2450e

18 files changed

Lines changed: 40 additions & 0 deletions

docs/reference/release-notes/8.0.0.asciidoc

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,12 @@ bin/elasticsearch-create-enrollment-token -s kibana
3737
is due to https://github.com/FasterXML/jackson-core/issues/882[a bug in Jackson parser].
3838
Fixed in {es} 8.6.1 ({es-pull}92480[#91456])
3939
// end::jackson-filtering-bug[]
40+
// tag::cgroup-v2-startup-failure[]
41+
* {es} versions 8.0.0–8.4.3 fail to start on Linux hosts that use
42+
https://man7.org/linux/man-pages/man7/cgroups.7.html[cgroups] version 2 exclusively
43+
with the bundled JDK. Upgrade to 8.5.0 or later to resolve this.
44+
Refer to https://ela.st/es-may-fail-on-cgroup-v2[our KB article] for more guidance.
45+
// end::cgroup-v2-startup-failure[]
4046

4147

4248
[[breaking-8.0.0]]

docs/reference/release-notes/8.0.1.asciidoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ Also see <<breaking-changes-8.0,Breaking changes in 8.0>>.
77
=== Known issues
88

99
include::8.0.0.asciidoc[tag=jackson-filtering-bug]
10+
11+
include::8.0.0.asciidoc[tag=cgroup-v2-startup-failure]
1012
[[bug-8.0.1]]
1113
[float]
1214
=== Bug fixes

docs/reference/release-notes/8.1.0.asciidoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ Also see <<breaking-changes-8.1,Breaking changes in 8.1>>.
77
=== Known issues
88

99
include::8.0.0.asciidoc[tag=jackson-filtering-bug]
10+
11+
include::8.0.0.asciidoc[tag=cgroup-v2-startup-failure]
1012
[[breaking-8.1.0]]
1113
[float]
1214
=== Breaking changes

docs/reference/release-notes/8.1.1.asciidoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ Also see <<breaking-changes-8.1,Breaking changes in 8.1>>.
77
=== Known issues
88

99
include::8.0.0.asciidoc[tag=jackson-filtering-bug]
10+
11+
include::8.0.0.asciidoc[tag=cgroup-v2-startup-failure]
1012
[[bug-8.1.1]]
1113
[float]
1214
=== Bug fixes

docs/reference/release-notes/8.1.2.asciidoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ Also see <<breaking-changes-8.1,Breaking changes in 8.1>>.
77
=== Known issues
88

99
include::8.0.0.asciidoc[tag=jackson-filtering-bug]
10+
11+
include::8.0.0.asciidoc[tag=cgroup-v2-startup-failure]
1012
[[bug-8.1.2]]
1113
[float]
1214
=== Bug fixes

docs/reference/release-notes/8.1.3.asciidoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ Also see <<breaking-changes-8.1,Breaking changes in 8.1>>.
77
=== Known issues
88

99
include::8.0.0.asciidoc[tag=jackson-filtering-bug]
10+
11+
include::8.0.0.asciidoc[tag=cgroup-v2-startup-failure]
1012
[[bug-8.1.3]]
1113
[float]
1214
=== Bug fixes

docs/reference/release-notes/8.2.0.asciidoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@
77
=== Known issues
88

99
include::8.0.0.asciidoc[tag=jackson-filtering-bug]
10+
11+
include::8.0.0.asciidoc[tag=cgroup-v2-startup-failure]
1012
[[bug-8.2.0]]
1113
[float]
1214
=== Bug fixes

docs/reference/release-notes/8.2.1.asciidoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ Also see <<breaking-changes-8.2,Breaking changes in 8.2>>.
77
=== Known issues
88

99
include::8.0.0.asciidoc[tag=jackson-filtering-bug]
10+
11+
include::8.0.0.asciidoc[tag=cgroup-v2-startup-failure]
1012
[[bug-8.2.1]]
1113
[float]
1214
=== Bug fixes

docs/reference/release-notes/8.2.2.asciidoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ Also see <<breaking-changes-8.2,Breaking changes in 8.2>>.
77
=== Known issues
88

99
include::8.0.0.asciidoc[tag=jackson-filtering-bug]
10+
11+
include::8.0.0.asciidoc[tag=cgroup-v2-startup-failure]
1012
[[bug-8.2.2]]
1113
[float]
1214
=== Bug fixes

docs/reference/release-notes/8.2.3.asciidoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ Also see <<breaking-changes-8.2,Breaking changes in 8.2>>.
77
=== Known issues
88

99
include::8.0.0.asciidoc[tag=jackson-filtering-bug]
10+
11+
include::8.0.0.asciidoc[tag=cgroup-v2-startup-failure]
1012
[[bug-8.2.3]]
1113
[float]
1214
=== Bug fixes

0 commit comments

Comments
 (0)