Immediately after migration from 4.3 to 5.0 tomcat fails to start: Unrecognized VM option 'UseConcMarkSweepGC'

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

Environment

SUSE Manager 5.0

Situation

After the migration process from 4.3 to 5.0 successfully completed and on first start of the SUSE Manager (SUMA) 5.0 container, this will fail due to tomcat failing to start with, excerpt:

2024-08-06T08:15:53.383929+00:00 uyuni-server server[683]: options used: -Dcatalina.base=/usr/share/tomcat -Dcatalina.home=/usr/share/tomcat -Djava.endorsed.dirs= -Djava.io.tmpdir=/var/cache/tomcat/temp -Djava.util.logging.config.file=/usr/share/tomcat/conf/logging.properties -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager
2024-08-06T08:15:53.383941+00:00 uyuni-server server[683]: arguments used: start
2024-08-06T08:15:53.396344+00:00 uyuni-server server[683]: Unrecognized VM option 'UseConcMarkSweepGC'
2024-08-06T08:15:53.396628+00:00 uyuni-server server[683]: Error: Could not create the Java Virtual Machine.
2024-08-06T08:15:53.396648+00:00 uyuni-server server[683]: Error: A fatal exception has occurred. Program will exit.
2024-08-06T08:15:53.397607+00:00 uyuni-server systemd[1]: tomcat.service: Main process exited, code=exited, status=1/FAILURE
2024-08-06T08:15:53.397650+00:00 uyuni-server systemd[1]: tomcat.service: Failed with result 'exit-code'.

Resolution

Remove the unsupported tomcat options, the following line / two options:

--add-modules java.annotation,com.sun.xml.bind
-XX:-UseConcMarkSweepGC

Alternatively open a support case with support to get a Program Temporary Fix (PTF) to prevent the issue.
NOTE: The PTF needs to be installed on the target 5.0 server BEFORE the migration is started.

Cause

Tomcat options migrated from the source 4.3 server are not supported with the new tomcat version on SUSE Manager 5.0.

Additional Information

To remove the problematic options, either edit the '/var/lib/containers/storage/volumes/etc-tomcat/_data/tomcat.conf' file directly from the SLE Micro 5.5 host.

Or, enter the container with 'mgrctl term' then edit '/etc/tomcat/tomcat.conf'.

Be aware that the following files may also have been migrated over if present on the source server, and these files should also be adjusted if present:

/var/lib/containers/storage/volumes/etc-tomcat/_data/conf.d/remote_debug.conf
/var/lib/containers/storage/volumes/etc-sysconfig/_data/tomcat

NOTE: Custom tomcat settings should ideally be specified only in the file '/var/lib/containers/storage/volumes/etc-tomcat/_data/conf.d/tomcat_java_opts.conf'

At the time of writing this TID, the default 'JAVA_OPTS=' line in the '/var/lib/containers/storage/volumes/etc-tomcat/_data/tomcat.conf' file on a newly installed SUMA 5.0 server is as follows:

JAVA_OPTS="-Djavax.sql.DataSource.Factory=org.apache.commons.dbcp.BasicDataSourceFactory --add-opens java.annotation/javax.annotation.security=ALL-UNNAMED"

Also see: https://github.com/uyuni-project/uyuni/issues/8946

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.