Fail to start cloudstack-management after upgrade from 4.19.1.1 to 4.20.1

[levindecaro]

Due to a Java version update, there are essential steps that need to be taken after version 4.20.1 and Java 17. Specifically, the /etc/default/cloudstack-management file needs to be merged or updated with the .rpmnew file. Failure to do so will result in a startup failure. It is recommended to update the upgrade guide from the document website.

[DaanHoogland]

What enterprise linux distro are you using @levindecaro?
Can you describe that versions you were upgrading from (ACS and java)?
Can you describe the conflicts the .rpmnew file contained in comparison to the installed version?

[levindecaro]

@DaanHoogland

Sorry for lack of key information.

This issue happens on OL9, from

• java-11-openjdk-headless-11.0.22.0.7-2.0.1.el9.x86_64 to java-17-openjdk-17.0.15.0.6-2.0.1.el9.x86_64
• ACS 4.19.1.1 to 4.20.1.0

[root@cloudstack-1 ~]# diff /etc/default/cloudstack-management /etc/default/cloudstack-management.rpmnew
18c18
< JAVA_OPTS="-Djava.security.properties=/etc/cloudstack/management/java.security.ciphers -Djava.awt.headless=true -Dcom.sun.management.jmxremote=false -Xmx2G -XX:+UseParallelGC -XX:MaxGCPauseMillis=500 -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/var/log/cloudstack/management/ -XX:ErrorFile=/var/log/cloudstack/management/cloudstack-management.err "
---
> JAVA_OPTS="-Djava.security.properties=/etc/cloudstack/management/java.security.ciphers -Djava.awt.headless=true -Xmx2G -XX:+UseParallelGC -XX:MaxGCPauseMillis=500 -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/var/log/cloudstack/management/ -XX:ErrorFile=/var/log/cloudstack/management/cloudstack-management.err --add-opens=java.base/java.lang=ALL-UNNAMED --add-exports=java.base/sun.security.x509=ALL-UNNAMED"
20c20
< CLASSPATH="/usr/share/cloudstack-management/lib/*:/etc/cloudstack/management:/usr/share/cloudstack-common:/usr/share/cloudstack-management/setup:/usr/share/cloudstack-management:/usr/share/java/mysql-connector-java.jar"
---
> CLASSPATH="/usr/share/cloudstack-management/lib/*:/etc/cloudstack/management:/usr/share/cloudstack-common:/usr/share/cloudstack-management/setup:/usr/share/cloudstack-management:/usr/share/java/mysql-connector-java.jar:/usr/share/cloudstack-mysql-ha/lib/*"
27c27
< ################################################################################################
---
> ################################################################################################

[DaanHoogland]

Thanks @levindecaro np,

I think we can add a small paragraph about this in the documentation. There is nothing really preventable in it, at first glance. Would you have a preference as to where you would expect to read this?

[levindecaro]

@DaanHoogland Appreciated for your update, i think it could be place right after apt-get install cloudstack-usage for .dpkg-dist and yum upgrade cloudstack-management for .rpmnew , thank you very much.

[weizhouapache]

a doc PR has been merged to address this issue
apache/cloudstack-documentation#544