Customizing the IBM WebSphere Liberty jvm.options file

You can use the IBM WebSphere Liberty jvm.options file to set Java virtual machine (JVM) arguments.

About this task

JVM arguments are defined in the server.startup file for each application. However, you can use the IBM WebSphere Liberty jvm.options file to set JVM arguments if you prefer that location; for example, if you already use it for other purposes.

Important: The arguments in the server.startup file, override the arguments in the jvm.options file. If you add an argument to the jvm.options file, you must remove it from the server.startup file.

Procedure

  1. Go to the JazzInstallDir/server/liberty/servers/clm directory and open the jvm.options file for editing.
    Note: You must start the IBM WebSphere Liberty server at least one time to create the clm directory. For details, see Starting the IBM WebSphere Liberty server.
  2. Add JVM arguments by inserting one argument per line. Example:
    -Xmx4G
    -Xms4G
    -Xmn1G
    -Xgcpolicy:gencon
    
  3. Save and close the jvm.options file.
  4. If you are upgrading from an earlier version of Engineering Lifecycle Management:
    1. Go to the JazzInstallDir/server directory and open the server.startup file for editing.
    2. Remove or comment out the -Xcompressedrefs and -Xgc:preferredHeapBase=0x100000000" parameters from the file
    3. Save and close the server.startup file.
  5. For the changes to the jvm.options and server.startup files to take effect, restart the IBM WebSphere Liberty server.