Skip to content

Commit ec5ab2b

Browse files
lcawldroberts195
andauthored
[DOCS] Add known issue for zero memory on Debian 8 (#1545)
Co-authored-by: David Roberts <[email protected]>
1 parent b39fbd3 commit ec5ab2b

File tree

1 file changed

+37
-1
lines changed

1 file changed

+37
-1
lines changed

docs/en/stack/ml/anomaly-detection/troubleshooting.asciidoc

Lines changed: 37 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ answers for frequently asked questions.
1212
* <<ml-mappingclash>>
1313
* <<ml-jobnames>>
1414
* <<ml-upgradedf>>
15+
* <<ml-debian8-memory>>
1516

1617
[[ml-rollingupgrade]]
1718
=== Machine learning features unavailable after rolling upgrade
@@ -113,4 +114,39 @@ If you do not fix or delete the {dfeed} before the upgrade, in order to successf
113114
start the failing nodes you must downgrade the nodes then fix the problem per
114115
above.
115116

116-
See also {stack-ref}/upgrading-elastic-stack.html[Upgrading the Elastic Stack].
117+
See also {stack-ref}/upgrading-elastic-stack.html[Upgrading the Elastic Stack].
118+
119+
[[ml-debian8-memory]]
120+
=== Suboptimal job assignment on Debian 8
121+
122+
Where possible, {ml} jobs are assigned to nodes based on the memory requirement
123+
of the job and the memory available on the node. However, in certain cases, the
124+
amount of memory on a node cannot be accurately determined and jobs are assigned
125+
by balancing the number of jobs per {ml} node. It may lead to a situation where
126+
all the jobs with high memory requirements are on one node and the less
127+
memory-intensive jobs on another.
128+
129+
One particular case of this problem is that {es} fails to determine the amount
130+
of memory on a machine that is running Debian 8 with the default Cgroups setup
131+
and certain updates of Java versions earlier than Java 15. For example, Java
132+
8u271 is known to be affected while Java 8u272 is not. Java 15 was fixed from
133+
its initial release.
134+
135+
If you are running {es} on Debian 8 with an old version of Java and have not
136+
already modified the Cgroups setup then it is recommended to do one of the
137+
following:
138+
139+
* Upgrade Java to version 15.
140+
* Upgrade to the latest Java update for the version of Java you are running.
141+
* Enable the "memory" Cgroup by editing `/etc/default/grub` and adding:
142+
+
143+
--
144+
[source,sh]
145+
--------------------------------------------------
146+
GRUB_CMDLINE_LINUX_DEFAULT="quiet cgroup_enable=memory swapaccount=1"
147+
--------------------------------------------------
148+
149+
Update your GRUB configuration by running `sudo update-grub`, then reboot the
150+
machine.
151+
152+
--

0 commit comments

Comments
 (0)