Skip to content

Latest commit

 

History

History
78 lines (63 loc) · 4.18 KB

framework-java_opts.md

File metadata and controls

78 lines (63 loc) · 4.18 KB

Java Options Framework

The Java Options Framework contributes arbitrary Java options to the application at runtime.

Detection Criterion java_opts set in the config/java_opts.yml file or the JAVA_OPTS environment variable set
Tags java-opts
Tags are printed to standard output by the buildpack detect script

Configuration

For general information on configuring the buildpack, refer to Configuration and Extension.

The framework can be configured by creating or modifying the config/java_opts.yml file in the buildpack fork.

Name Description
from_environment Whether to append the value of the JAVA_OPTS environment variable to the collection of Java options
java_opts The Java options to use when running the application. All values are used without modification when invoking the JVM. The options are specified as a single YAML scalar in plain style or enclosed in single or double quotes.

Any JAVA_OPTS from either the config file or environment variables that configure memory options will cause deployment to fail as they're not allowed. Memory options are configured by the buildpack and may not be modified.

Example

# JAVA_OPTS configuration
---
from_environment: false
java_opts: -Xloggc:$PWD/beacon_gc.log -verbose:gc

Memory Settings

The following JAVA_OPTS are restricted and will cause the application to fail deployment.

  • -Xms
  • -Xmx
  • -Xss
  • -XX:MaxMetaspaceSize
  • -XX:MaxPermSize
  • -XX:MetaspaceSize
  • -XX:PermSize

Allowed Memory Settings

Setting any of the allowed memory settings may require a change to the Memory Weightings. Where a value is shown it is the default value for that setting.

Argument Description
-Xmn <SIZE> Maximum size of young generation, known as the eden region. This could effect the total heap size Memory Weightings.
-XX:+UseGCOverheadLimit Use a policy that limits the proportion of the VM's time that is spent in GC before an java.lang.OutOfMemoryError error is thrown.
-XX:+UseLargePages Use large page memory. For details, see Java Support for Large Memory Pages.
-XX:-HeapDumpOnOutOfMemoryError Dump heap to file when java.lang.OutOfMemoryError is thrown.
-XX:HeapDumpPath=<PATH> Path to directory or filename for heap dump.
-XX:LargePageSizeInBytes=<SIZE> Sets the large page size used for the Java heap.
-XX:MaxDirectMemorySize=<SIZE> Upper limit on the maximum amount of allocatable direct buffer memory. This could effect the Memory Weightings.
-XX:MaxHeapFreeRatio=<RATIO> Maximum percentage of heap free after GC to avoid shrinking.
-XX:MaxNewSize=<SIZE> Maximum size of new generation. Since 1.4, MaxNewSize is computed as a function of NewRatio. This could effect the total heap size Memory Weightings.
-XX:MinHeapFreeRatio=<RATIO> Minimum percentage of heap free after GC to avoid expansion.
-XX:NewRatio=<RATIO> Ratio of old/new generation sizes. 2 is equal to approximately 66%.
-XX:NewSize=<SIZE> Default size of new generation. This could effect the total heap size Memory Weightings.
-XX:OnError="<CMD ARGS>;<CMD ARGS>" Run user-defined commands on fatal error.
-XX:OnOutOfMemoryError="<CMD ARGS>;<CMD ARGS>" Run user-defined commands when an java.lang.OutOfMemoryError is first thrown.
-XX:ReservedCodeCacheSize=<SIZE> Java 8 Only Maximum code cache size. Also know as -Xmaxjitcodesize. This could effect the Memory Weightings.
-XX:SurvivorRatio=<RATIO> Ratio of eden/survivor space. Solaris only.
-XX:TargetSurvivorRatio=<RATIO> Desired ratio of survivor space used after scavenge.
-XX:ThreadStackSize=<SIZE> Thread stack size. (0 means use default stack size).