Skip to content

Commit b1c2fc6

Browse files
authored
1 parent 574b540 commit b1c2fc6

File tree

3 files changed

+27
-19
lines changed

3 files changed

+27
-19
lines changed

source/includes/extracts-troubleshooting.yaml

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -230,21 +230,18 @@ content: |
230230
231231
.. warning:: Do not change other Java options
232232
233-
Changing any option values other than ``-Xmx``,
234-
``-Xms``, and ``-Xmn`` could have an unexpected impact
233+
Changing any option values other than ``-Xmx`` and
234+
``-Xms`` could have an unexpected impact
235235
on the |application|. Do not change other values
236236
without consulting MongoDB Support.
237237
238238
239-
3. Change the ``-Xmx``, ``-Xms``, and ``Xmn`` values:
239+
3. Change the ``-Xmx`` and ``-Xms`` values:
240240
241241
- Change the ``-Xmx`` and ``-Xms`` values to a larger
242242
value. You should set both parameters to the same value
243243
to remove any performance impact from the VM constantly
244244
reclaiming memory from the heap.
245-
246-
- Change the ``-Xmn`` value to a quarter of the value
247-
that you specified for the ``-Xmx`` and ``-Xms`` keys.
248245
249246
Specify the values as ``#k|m|g``: a number followed
250247
by:
@@ -256,7 +253,7 @@ content: |
256253
.. example::
257254
258255
To set the Java Heap to 12 :abbr:`GB (Gigabytes)`,
259-
set the values to: ``-Xmx12g -Xms12g -Xmn3g``.
256+
set the values to: ``-Xmx12g -Xms12g``.
260257
261258
- id: windows
262259
name: Windows Hosts

source/reference/troubleshooting/system.txt

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -50,21 +50,21 @@ hosts:
5050

5151
.. warning:: **Do not change other Java options**
5252

53-
Changing any option values other than ``-Xmx``,
54-
``-Xms``, and ``-Xmn`` could have an unexpected impact
53+
Changing any option values other than ``-Xmx`` and
54+
``-Xms`` could have an unexpected impact
5555
on the |application|. Do not change other values
5656
without consulting MongoDB Support.
57+
Starting with |onprem| 7.0, |onprem| adopted a Garbage-First
58+
Garbage Collector (G1GC) method for the JVM. Don't use ``-Xmn``
59+
to set the size of the heap for the young generation.
5760

58-
3. Change the ``-Xmx``, ``-Xms``, and ``Xmn`` values:
61+
3. Change the ``-Xmx`` and ``-Xms`` values:
5962

6063
- Change the ``-Xmx`` and ``-Xms`` values to a larger
6164
value. You should set both parameters to the same value
6265
to remove any performance impact from the VM constantly
6366
reclaiming memory from the heap.
6467

65-
- Change the ``-Xmn`` value to a quarter of the value
66-
that you specified for the ``-Xmx`` and ``-Xms`` keys.
67-
6868
Specify the values as ``#k|m|g``: a number followed
6969
by:
7070

@@ -75,7 +75,7 @@ hosts:
7575
.. example::
7676

7777
To set the Java Heap to 12 :abbr:`GB (Gigabytes)`,
78-
set the values to: ``-Xmx12g -Xms12g -Xmn3g``.
78+
set the values to: ``-Xmx12g -Xms12g``.
7979

8080
4. Restart each host running |a-mms| instance on which you made these
8181
changes.

source/tutorial/monitoring-large-deployments.txt

Lines changed: 16 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Configure Ops Manager to Monitor Large Deployments
1111
:class: singlecol
1212

1313
To monitor deployments with more than 2,000 hosts located in
14-
globally-distributed datacenters, configure your |onprem| instance
14+
globally-distributed data centers, configure your |onprem| instance
1515
with these advanced settings.
1616

1717
Allocate more RAM to Ops Manager Hosts
@@ -21,13 +21,24 @@ Allocate more RAM to Ops Manager Hosts
2121
editor.
2222

2323
2. Find a line where the ``JAVA_MMS_UI_OPTS`` variable defines the
24-
``-Xms``, ``-Xmx``, and ``-Xmn`` parameters.
24+
``-Xms`` and ``-Xmx`` parameters.
2525

2626
3. Update the ``-Xms`` and ``-Xmx`` values from the default of 4352 MB
2727
to 8192 MB or more if the hosts have extra free memory.
2828

29-
4. Update the ``-Xmn`` value from the default of 1500 MB to a quarter
30-
of the value that you specified for ``-Xms`` and ``-Xmx``.
29+
.. note:: Don't Set Young Generation's Heap Size Explicitly Using ``-Xmn``.
30+
31+
Starting with |onprem| 7.0, |onprem| adopted a Garbage-First (G1)
32+
garbage collector method for the JVM. We recommend that you don't
33+
set the young generation's heap size explicitly to any fixed value
34+
using ``-Xmn``. Setting a fixed value with ``-Xmn`` interferes with
35+
the G1 garbage collector's default behavior. If you set this value,
36+
this prevents the G1 garbage collector from expanding and contracting
37+
the young generation space as needed, which causes the collector to
38+
stop respecting the pause time value for garbage collections.
39+
40+
You can set the values for ``Xmx`` and ``Xms`` to be the same, and
41+
retain the pause at its default value: ``-XX:MaxGCPauseMillis=200``.
3142

3243
To learn about how to resolve this error in greater detail, see our
3344
troubleshooting entry on the
@@ -76,4 +87,4 @@ ingestion:
7687
mms.monitoring.rrd.rawsystem.batch.size=1000
7788

7889
3. Save the properties file.
79-
4. Restart Ops Manager.
90+
4. Restart |onprem|.

0 commit comments

Comments
 (0)