This is an automated email from the ASF dual-hosted git repository.
sureshanaparti pushed a commit to branch 4.20
in repository https://gitbox.apache.org/repos/asf/cloudstack-documentation.git
The following commit(s) were added to refs/heads/4.20 by this push:
new 393997a7 Add a note for JAVA_OPTS if using Java 17 for ACS versions >=
4.20.0 (#544)
393997a7 is described below
commit 393997a70e5d8d03ee6ce38d4f115c390dfd8cd6
Author: Pearl Dsilva <[email protected]>
AuthorDate: Thu Aug 28 06:00:48 2025 -0400
Add a note for JAVA_OPTS if using Java 17 for ACS versions >= 4.20.0 (#544)
---
source/upgrading/index.rst | 1 +
source/upgrading/upgrade/upgrade_java_17_notes.rst | 43 ++++++++++++++++++++++
source/upgrading/upgrade/upgrade_notes.rst | 9 +++++
3 files changed, 53 insertions(+)
diff --git a/source/upgrading/index.rst b/source/upgrading/index.rst
index 7077b1b9..11631b56 100644
--- a/source/upgrading/index.rst
+++ b/source/upgrading/index.rst
@@ -42,6 +42,7 @@ Contents:
.. toctree::
:maxdepth: 1
+ upgrade/upgrade_java_17_notes
upgrade/mysql
upgrade/valid_source
upgrade/upgrade-4.20
diff --git a/source/upgrading/upgrade/upgrade_java_17_notes.rst
b/source/upgrading/upgrade/upgrade_java_17_notes.rst
new file mode 100644
index 00000000..a9a4c791
--- /dev/null
+++ b/source/upgrading/upgrade/upgrade_java_17_notes.rst
@@ -0,0 +1,43 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+.. CloudStack Release Notes documentation main file, created by
+ sphinx-quickstart on Fri Feb 7 16:00:59 2014.
+ You can adapt this file completely to your liking, but it should at least
+ contain the root `toctree` directive.
+
+|menu_acs_logo|
+
+
+Upgrading CloudStack
+====================
+
+Java version upgraded to Java 17
+---------------------------------
+
+As of Apache CloudStack 4.20, support for running with Java 17 has been added.
+In later versions, support for Java 11 will be removed.
+
+If you are running CloudStack with Java 17, for CloudStack versions 4.20 and
later:
+ * Verify /etc/default/cloudstack-management is consistent with
https://github.com/apache/cloudstack/blob/main/packaging/systemd/cloudstack-management.default;
Specifically, ensure that the following is present in the JAVA_OPTS:
+
+ .. code-block:: bash
+
+ --add-opens=java.base/java.lang=ALL-UNNAMED
--add-exports=java.base/sun.security.x509=ALL-UNNAMED
+
+ * Verify /etc/default/cloudstack-usage is also consistent with the same file
in the repository.
+ * Perform the same check for /etc/default/cloudstack-agent on the hypervisor
hosts.
+
+.. include:: _java_version.rst
\ No newline at end of file
diff --git a/source/upgrading/upgrade/upgrade_notes.rst
b/source/upgrading/upgrade/upgrade_notes.rst
index 6c763bb2..44935891 100644
--- a/source/upgrading/upgrade/upgrade_notes.rst
+++ b/source/upgrading/upgrade/upgrade_notes.rst
@@ -23,6 +23,15 @@ Java version upgraded to Java 17
As of Apache CloudStack 4.20, support for running with Java 17 has been added.
In later versions, support for Java 11 will be removed.
+If you are running CloudStack with Java 17, for CloudStack versions 4.20 and
later:
+ * Verify /etc/default/cloudstack-management is consistent with
https://github.com/apache/cloudstack/blob/main/packaging/systemd/cloudstack-management.default;
Specifically, ensure that the following is present in the JAVA_OPTS:
+
+ .. code-block:: bash
+
+ --add-opens=java.base/java.lang=ALL-UNNAMED
--add-exports=java.base/sun.security.x509=ALL-UNNAMED
+
+ * Verify /etc/default/cloudstack-usage is also consistent with the same file
in the repository.
+ * Perform the same check for /etc/default/cloudstack-agent on the hypervisor
hosts.
.. include:: _java_version.rst
