Skip to content

Commit 6bb3875

Browse files
authored
Update jvm-settings.md
1 parent 6e14170 commit 6bb3875

File tree

1 file changed

+9
-14
lines changed

1 file changed

+9
-14
lines changed

docs/reference/elasticsearch/jvm-settings.md

Lines changed: 9 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -81,7 +81,15 @@ If you’re using the RPM or Debian packages, you can specify `ES_JAVA_OPTS` in
8181

8282
## Set the JVM heap size [set-jvm-heap-size]
8383

84-
By default, {{es}} automatically sets the JVM heap size based on a node’s [roles](/reference/elasticsearch/configuration-reference/node-settings.md#node-roles) and total memory. Using the default sizing is recommended for most production environments.
84+
By default, {{es}} automatically sets the JVM heap size based on a node’s [roles](/reference/elasticsearch/configuration-reference/node-settings.md#node-roles) and total memory. Using the default sizing is recommended for most production environments. The default heap sizing uses the following formulas:
85+
86+
* Master-only node
87+
* 60% of total system memory, up to a maximum of 31 GB.
88+
* Machine Learning-only node
89+
* 40% of the first 16 gigabytes plus 10% of memory above that when total system memory is more than 16 gigabytes, up to a maximum of 31 GB.
90+
* Data-only node
91+
* 40% of total system memory when less than 1 GB, with a minimum of 128 MB.
92+
* 50% of total system memory when 1 GB or more, with a maximum of 31 GB.
8593

8694
To override the default heap size, set the minimum and maximum heap size settings, `Xms` and `Xmx`. The minimum and maximum values must be the same.
8795

@@ -128,19 +136,6 @@ If you are running {{es}} as a Windows service, you can change the heap size usi
128136
::::
129137

130138

131-
## Default JVM heap sizes [default-jvm-sizes]
132-
133-
If heap sizes are not specifically set, {{es}} will calculate JVM heap sizing based on the total amount of system memory, depending on the node's role.
134-
135-
* Master-only node
136-
* 60% of total system memory, up to a maximum of 31 GB.
137-
* Machine Learning-only node
138-
* 40% of the first 16 gigabytes plus 10% of memory above that when total system memory is more than 16 gigabytes, up to a maximum of 31 GB.
139-
* Data-only node
140-
* 40% of total system memory when less than 1 GB, with a minimum of 128 MB.
141-
* 50% of total system memory when 1 GB or more, with a maximum of 31 GB.
142-
143-
144139
## JVM heap dump path setting [heap-dump-path-setting]
145140

146141
By default, {{es}} configures the JVM to dump the heap on out of memory exceptions to the default logs directory. On [RPM](docs-content://deploy-manage/deploy/self-managed/install-elasticsearch-with-rpm.md) and [Debian](docs-content://deploy-manage/deploy/self-managed/install-elasticsearch-with-debian-package.md) packages, the logs directory is `/var/log/elasticsearch`. On [Linux and MacOS](docs-content://deploy-manage/deploy/self-managed/install-elasticsearch-from-archive-on-linux-macos.md) and [Windows](docs-content://deploy-manage/deploy/self-managed/install-elasticsearch-with-zip-on-windows.md) distributions, the `logs` directory is located under the root of the {{es}} installation.

0 commit comments

Comments
 (0)