From 88b2df8ec561296a2a7d742513109489ca7ed4e9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Vin=C3=ADcius=20Ferr=C3=A3o?=
 <2031761+viniciusferrao@users.noreply.github.com>
Date: Sun, 11 Oct 2026 11:50:49 -0300
Subject: [PATCH] docs(test): describe package upgrade logging cases
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Vinícius Ferrão <2031761+viniciusferrao@users.noreply.github.com>
---
 xCAT-test/native/README.md | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/xCAT-test/native/README.md b/xCAT-test/native/README.md
index f56b6ce10..7e6dd96e5 100644
--- a/xCAT-test/native/README.md
+++ b/xCAT-test/native/README.md
@@ -49,7 +49,8 @@ On Debian or Ubuntu, install `bubblewrap`, `debhelper`, `devscripts`, `fakeroot`
 ```
 prove xCAT-test/native/xcatd_debian_lifecycle.t \
       xCAT-test/native/xcatd_restart_callers.t \
-      xCAT-test/native/apache_package_lifecycle.t
+      xCAT-test/native/apache_package_lifecycle.t \
+      xCAT-test/native/package_upgrade_logging.t
 ```
 
 On EL8 or EL10, install `bubblewrap`, `rpm-build`, `systemd`, `chkconfig`,
@@ -59,7 +60,8 @@ On EL8 or EL10, install `bubblewrap`, `rpm-build`, `systemd`, `chkconfig`,
 ```
 prove xCAT-test/native/xcatd_rpm_lifecycle.t \
       xCAT-test/native/apache_rpm_configuration.t \
-      xCAT-test/native/apache_package_lifecycle.t
+      xCAT-test/native/apache_package_lifecycle.t \
+      xCAT-test/native/package_upgrade_logging.t
 ```
 
 These EL dependencies need EPEL plus PowerTools on EL8 or CRB on EL10.
@@ -74,6 +76,11 @@ The Debian Apache cases unpack built packages and execute their complete
 maintainer scripts. Restart-caller cases execute complete Debian scripts and
 RPM-rendered scriptlets without building the optional UI package.
 
+Upgrade logging cases run package transactions with a configuration-command
+fixture. They check output, warnings, PID relocation, temporary files and the
+different RPM and Debian failure policies. They do not run `xcatconfig` or
+build a Genesis image.
+
 The RPM Apache cases distinguish a root without `/proc` from a chroot with
 `/proc` mounted and a different PID 1 root. Debian and restart-caller cases
 check dispatch with and without `/proc`; these do not qualify chroot safety.