Skip to content

Commit 4aa5175

Browse files
authored
[7.17][doc] Add known issue to all versions affected by GC behaviour change (#102124)
* Added known issue for changes to GC in JDK 20/21 * Updated reference/link
1 parent 803e013 commit 4aa5175

File tree

6 files changed

+59
-0
lines changed

6 files changed

+59
-0
lines changed

docs/reference/release-notes/7.17.10.asciidoc

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,27 @@
33

44
Also see <<breaking-changes-7.17,Breaking changes in 7.17>>.
55

6+
[[known-issues-7.17.10]]
7+
[discrete]
8+
=== Known issues
9+
10+
// tag::no-preventive-gc-issue[]
11+
* High Memory Pressure due to a GC JVM setting change
12+
+
13+
This version of Elasticsearch is bundled with JDK 20. In JDK 20
14+
https://bugs.openjdk.org/browse/JDK-8293861[Preventive GC is disabled by default].
15+
This may lead to increased memory pressure and an increased number of CircuitBreakerExceptions when retrieving large
16+
documents under some load patterns. (issue: {es-issue}99592[#99592])
17+
+
18+
If this change affects your use of Elasticsearch, consider re-enabling the previous behaviour
19+
by adding the JVM arguments `-XX:+UnlockDiagnosticVMOptions -XX:+G1UsePreventiveGC` (reference:
20+
https://www.oracle.com/java/technologies/javase/20-relnote-issues.html#JDK-8293861[JDK 20 release notes]). It is
21+
important to note that this workaround is temporary and works only with JDK 20, which is bundled with Elasticsearch up
22+
to version 7.17.13 inclusive. Successive versions are bundling JDK 21+, where this setting
23+
https://bugs.openjdk.org/browse/JDK-8297639[has been removed]. Specifying those JVM arguments will prevent the
24+
JVM (and therefore Elasticsearch Nodes) from starting.
25+
// end::no-preventive-gc-issue[]
26+
627
[[bug-7.17.10]]
728
[float]
829
=== Bug fixes

docs/reference/release-notes/7.17.11.asciidoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,11 @@ coming[7.17.11]
55

66
Also see <<breaking-changes-7.17,Breaking changes in 7.17>>.
77

8+
[[known-issues-7.17.11]]
9+
[discrete]
10+
=== Known issues
11+
include::7.17.10.asciidoc[tag=no-preventive-gc-issue]
12+
813
[[bug-7.17.11]]
914
[float]
1015
=== Bug fixes

docs/reference/release-notes/7.17.12.asciidoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,11 @@
33

44
Also see <<breaking-changes-7.17,Breaking changes in 7.17>>.
55

6+
[[known-issues-7.17.12]]
7+
[discrete]
8+
=== Known issues
9+
include::7.17.10.asciidoc[tag=no-preventive-gc-issue]
10+
611
[[bug-7.17.12]]
712
[float]
813
=== Bug fixes

docs/reference/release-notes/7.17.13.asciidoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,11 @@
33

44
Also see <<breaking-changes-7.17,Breaking changes in 7.17>>.
55

6+
[[known-issues-7.17.13]]
7+
[discrete]
8+
=== Known issues
9+
include::7.17.10.asciidoc[tag=no-preventive-gc-issue]
10+
611
[float]
712
[[security-updates-7.17.13]]
813
=== Security updates

docs/reference/release-notes/7.17.14.asciidoc

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,24 @@
33

44
Also see <<breaking-changes-7.17,Breaking changes in 7.17>>.
55

6+
[[known-issues-7.17.14]]
7+
[discrete]
8+
=== Known issues
9+
10+
// tag::no-preventive-gc-issue[]
11+
* High Memory Pressure due to a GC change in JDK 21
12+
+
13+
This version of Elasticsearch is bundled with JDK 21. In JDK 21
14+
https://bugs.openjdk.org/browse/JDK-8297639[Preventive GC has been removed].
15+
This may lead to increased memory pressure and an increased number of CircuitBreakerExceptions when retrieving large
16+
documents under some particular load. (issue: {es-issue}99592[#99592])
17+
+
18+
If you needed to explicitly <<known-issues-7.17.10,enable Preventive GC for your workload in a previous Elasticsearch
19+
version>>, we recommend you avoid to upgrade to this version, as the settings to enable Preventive GC have been removed
20+
from JDK 21.
21+
// end::no-preventive-gc-issue[]
22+
23+
624
[[bug-7.17.14]]
725
[float]
826
=== Bug fixes

docs/reference/release-notes/7.17.15.asciidoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,11 @@
33

44
Also see <<breaking-changes-7.17,Breaking changes in 7.17>>.
55

6+
[[known-issues-7.17.15]]
7+
[discrete]
8+
=== Known issues
9+
include::7.17.14.asciidoc[tag=no-preventive-gc-issue]
10+
611
[[bug-7.17.15]]
712
[float]
813
=== Bug fixes

0 commit comments

Comments
 (0)