68

Reference: https://bugs.java.com/bugdatabase/view_bug.do?bug_id=8186315

I'm really struggling to find out what MinRAMPercentage does, especially compared to InitialRAMPercentage.

I assumed that InitialRAMPercentage sets the amount of heap at startup, that MinRAMPercentage and MaxRAMPercentage set the bottom and top limit of heap that the JVM is allowed to shrink/grow to.

Apparently that is not the case. When I start a JVM (with UseContainerSupport, having these new memory setting parameters) like so:

java -XX:+UseContainerSupport -XX:InitialRAMPercentage=40.0 -XX:MinRAMPercentage=20.0 -XX:MaxRAMPercentage=80.0 -XX:+PrintFlagsFinal -version | grep Heap

InitialHeap and MaxHeap get set, there is no "Minimum Heap Size" value that I can find; Consequently, that MinRAMPercentage never seems to get used.

Super confused, and apparently, I'm not the only one; the OpenJ9 dudes seem to also not fully parse the intent of these options, as I've gathered here and here. They seem to have opted to simply not implement MinRAMPercentage afaics.

So: What is the real intended usage and effect of setting MinRAMPercentage?

2 Answers 2

102
+300

-XX:InitialRAMPercentage is used to calculate initial heap size when InitialHeapSize / -Xms is not set.

It sounds counterintuitive, but both -XX:MaxRAMPercentage and -XX:MinRAMPercentage are used to calculate maximum heap size when MaxHeapSize / -Xmx is not set:

  • For systems with small physical memory MaxHeapSize is estimated as

    phys_mem * MinRAMPercentage / 100  (if this value is less than 96M)
    
  • Otherwise (non-small physical memory) MaxHeapSize is estimated as

    MAX(phys_mem * MaxRAMPercentage / 100, 96M)
    

The exact formula is a bit more complicated as it also takes other factors into account.

Note: the algorithm for calculating initial and maximum heap size depends on the particular JVM version. The preferred way to control the heap size is to set Xmx and Xms explicitly.

See also this question.

6
  • How you explain this? Command: sudo docker run --memory='10m' adoptopenjdk/openjdk11 java -XX:+PrintFlagsFinal -version | grep MaxHeapSize Result: Picked up JAVA_TOOL_OPTIONS: -XX:+UseContainerSupport size_t MaxHeapSize = 8388608 {product} {ergonomic} openjdk version "11" 2018-09-25 OpenJDK Runtime Environment AdoptOpenJDK (build 11+28) OpenJDK 64-Bit Server VM AdoptOpenJDK (build 11+28, mixed mode) According your explanation MaxHeapSize should be 5M not 8M Mar 21, 2019 at 12:22
  • 5
    @MichałMielec As I've told, there are other factors, such as alignment and default generation sizes. They come on stage when the memory limit is so small.
    – apangin
    Mar 21, 2019 at 13:46
  • Isn't InitialHeapSize/MaxHeapSize always set and used as Xms/Xms if they are not provided explicitly? Apr 9, 2019 at 10:49
  • @freakman Not sure I understand what you mean. Please ask a separate question, describe your problem and provide an example.
    – apangin
    Apr 9, 2019 at 12:48
  • One thing I don't understand is why are there separate MinRAMPercentage and MaxRAMPercentage? What's the point of separating memory to 2 range of below and above 100 MB?
    – tkalvin
    Jun 12 at 8:49
1

Depends on your container memory also, So lets suppose you have container memory as 1 GB then in this case -XX:MaxRAMPercentage=80 will be used to determine the max heap ~ 800mb heap memory will be used

And suppose you have container memory less than 250mb then -XX:MinRAMPercentage=20.0 will be used ~ 50mb heap memory will be used

use this article to understand more XX:MinRAMPercentage,XX:MaxRAMPercentage

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.