This is an automated email from the ASF dual-hosted git repository.
dahn 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 9a5fb9db Log4j file details (#607)
9a5fb9db is described below
commit 9a5fb9dbaf67d2d8bfed51e8d9228994db19e140
Author: Harikrishna <[email protected]>
AuthorDate: Wed Dec 10 17:07:45 2025 +0530
Log4j file details (#607)
---
source/upgrading/upgrade/_log4j_file_check.rst | 26 ++++++++++++++++++++++++++
source/upgrading/upgrade/upgrade-4.20.rst | 2 ++
2 files changed, 28 insertions(+)
diff --git a/source/upgrading/upgrade/_log4j_file_check.rst
b/source/upgrading/upgrade/_log4j_file_check.rst
new file mode 100644
index 00000000..c8aa0021
--- /dev/null
+++ b/source/upgrading/upgrade/_log4j_file_check.rst
@@ -0,0 +1,26 @@
+.. 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.
+
+.. sub-section included in upgrade notes.
+
+.. note::
+
+ During upgrades from versions prior to 4.20, the logging configuration file
may not be migrated automatically to the new Log4j2 format - especially if the
original log4j configuration file was manually customized or modified.
+
+ It is strongly recommended to verify **before starting the Management
Server and the Usage Server** that the configuration file (e.g.
`log4j-cloud.xml`) under `/etc/cloudstack/management` and
`/etc/cloudstack/usage` respectively uses the Log4j2 format.
+
+ If the file still uses legacy Log4j (version 1) syntax or structure,
**manually replace or update** the configuration using the default Log4j2
configuration supplied with the latest package.
+
+ Failure to update may result in missing or incomplete log generation after
upgrade.
\ No newline at end of file
diff --git a/source/upgrading/upgrade/upgrade-4.20.rst
b/source/upgrading/upgrade/upgrade-4.20.rst
index 8a1073fc..c55bafd0 100644
--- a/source/upgrading/upgrade/upgrade-4.20.rst
+++ b/source/upgrading/upgrade/upgrade-4.20.rst
@@ -207,6 +207,8 @@ Setup the GPG public key if you wish to enable
``gpgcheck=1``:
$ sudo yum upgrade cloudstack-usage
+.. include:: _log4j_file_check.rst
+
.. _upg_hyp_414:
Upgrade Hypervisors
