How to increase the Java Heap Memory of a PASOE Tomcat JVM?

How to increase the Java Heap Memory of a PASOE Tomcat JVM?
 

After monitoring the PASOE Instance via Tomcat Manager, it was clear that the amount of Java Heap Memory was not enough to handle the load of requests getting to PASOE Tomcat versus the amount of Java objects that were being allocated.
The Free memory and Total memory got the same value in Tomcat Manager Server Status page.

 

Note: Ensure to backup the respective jvm.Properties file before editing it.

In order to increase the amount of Java Heap Memory for the JVM running PASOE Tomcat, edit the jvm.Properties file under <PASOE_Instance>/conf and change the following parameters to the appropriate values:

-Xms - sets the initial value for the Java Heap Memory
-Xmx - sets the maximum value for the Java Heap Memory

jvm.Properties sample file:
# This file contains a list of JVM command line options.
# You may insert any command line option, including -D.
# Each line should contain a single option to facilitate
# easier automated administration tools.
#
-Dfile.encoding=UTF-8 
-server 
-Xms4096m 
-Xmx8192m 
-XX:NewSize=64m 
-XX:MaxNewSize=64m 
-XX:PermSize=64m 
-XX:MaxPermSize=128m 
-XX:+DisableExplicitGC
-d64
-Dorg.apache.coyote.USE_CUSTOM_STATUS_MSG_IN_HEADER=false
-Dorg.apache.catalina.connector.CoyoteAdapter.ALLOW_BACKSLASH=false
-Dorg.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=false
-Dorg.apache.catalina.connector.RECYCLE_FACADES=false
-Dorg.apache.catalina.STRICT_SERVLET_COMPLIANCE=true
-Dorg.apache.tomcat.util.http.ServerCookie.FWD_SLASH_IS_SEPARATOR=false

In the above example, PASOE Tomcat JVM will start and allocate 4GB of Java Heap Memory (-Xms) and will allow a maximum of 8GB (-Xmx) if requested by the application load.

A PASOE instance restart is required to allow the PASOE Tomcat JVM to start using the new values set.

If the PASOE instance has been registered as a Windows Service, it will need to be unregistered and re-registered because the jvm.properties file is used to make registry entries for the Service startup parameters.

In order to unregister and re-register the service, open a proenv session, and change directory to the CATALINA_BASE\bin (<PAS for OE Instance directory>\bin) , and use the commands below.

To unregister:
pasman service [PAS Instance Name] unregister
or
tcman service [PAS Instance Name] unregister

To register:
pasman service oepas1 -I [PAS Instance Name] register
or
tcman service oepas1 -I [PAS Instance Name] register




 

Beginning in 12.x OpenEdge Management is a form of PASOE instance.

The method described in this article to increase the heap applies to OpenEdge Management as well.

The jvm.properties for the OEM is in the <OEM installation folder>/properties/jvm.properties.