Tomcat Settings in SUMA 4.3

This document (000021141) is provided subject to the disclaimer at the end of this document.

Environment

SUSE Manager 4.3

Situation

After upgrading SUSE Manager from 4.1 or 4.2 to 4.3, tomcat might run out of memory errors even though the Xmx parameter has a large value already:

/var/log/tomcat/catalina.out:
java.lang.OutOfMemoryError: Java heap space

Resolution

After upgrading to SUMA 4.3, the tomcat settings have moved from /etc/sysconfig/tomcat to /etc/tomcat/conf.d/ and the Xmx memory setting should be set in /etc/tomcat/conf.d/tomcat_java_opts.conf accordingly.

Therefore remove old duplicate Java options from /etc/sysconfig/tomcat or /etc/tomcat/tomcat.conf and ensure
the Java options -Xmx and -Xms are only set in /etc/tomcat/conf.d/tomcat_java_opts.conf.

Note: To better handle this setting and to avoid future package update overwriting customised setting, kindly keep /etc/tomcat/conf.d/tomcat_java_opts.conf as is, and create new file with desired configuration. For example:

create a new file /etc/tomcat/conf.d/zz-custom_java_opts.conf
   with the following content:
JAVA_OPTS="$JAVA_OPTS -Xmx6G"

Please note that it could be also possible that SUSE Manager managing many clients and having many channels actually causes tomcat to run out of memory, in which case increase the memory Xmx setting as needed.

Cause

The tomcat settings location in SUMA 4.3 has moved to /etc/tomcat/conf.d/tomcat_java_opts.conf.

Disclaimer

This Support Knowledgebase provides a valuable tool for SUSE customers and parties interested in our products and solutions to acquire information, ideas and learn from one another. Materials are provided for informational, personal or non-commercial use within your organization and are presented "AS IS" WITHOUT WARRANTY OF ANY KIND.