How to adjust the Tomcat Java heap memory on GroupWise 18 WebAccess (Linux)

  • 7024559
  • 10-Apr-2020
  • 10-Apr-2020

Environment

GroupWise 18.0.X Classic WebAccess
GroupWise 18.1.X Classic WebAccess
GroupWise 18.2.X Classic WebAccess

Situation

How to adjust the Tomcat Java heap size on GroupWise 18 WebAccess (Linux)

Adjusting the Java heap size can help with performance issues in certain situations. If your WebAccess server is experiencing performance problems, adjusting the Heap size is a suggested change to make.

Resolution

To change the Tomcat Java Heap size in GroupWise 18 Tomcat:
  1. Open /etc/grpwise-tomcat/grpwise-tomcat.conf in a text editor
  2. Locate the JAVA_OPTS line
  3. Adjust the minimum and maximum heap size parameter as follows: -Xms1024m -Xmx2048m (NOTE: These numbers are a good starting point. The values used on any given server may differ, and should be adjusted to provide the best performance accordingly.)
  4. Save the grpwise-tomcat.conf file
  5. Restart tomcat with the 'rcgrpwise-tomcat restart' command 


Additional Information

To verify tomcat took the Java heap change do the following. Do this prior to making the Java memory adjustment as well as after to compare the values.
  1. Open a terminal window on the WebAccess server
  2. ps aux | grep tomcat
    •  Take note of the pid number
  3. top -p <pid number>
    1.  Take note of the VIRT column; this is the current allowed memory.
  4. Adjust the Java memory per the steps above.
  5. After adjusting the Java memory and restarting tomcat do steps 1 and 2 again to verify the HEAP memory was allocated. The VIRT column memory size will increase if the Java memory was allocated correctly.