From 49f41f6074dad318b923af5257d629e486bc4b97 Mon Sep 17 00:00:00 2001 From: Daniel Hilst <392820+dhilst@users.noreply.github.com> Date: Tue, 8 Sep 2026 17:54:11 -0300 Subject: [PATCH 1/7] feat(xcat-core): specify distro versions in support matrix The operating-system support table named distro families without defining which releases the claim covered, and it kept separate legacy CentOS and Windows rows that are outside the xCAT 2.19 CI target contract. This made the release matrix ambiguous and impossible to translate into a finite CI backlog. Signed-off-by: Daniel Hilst <392820+dhilst@users.noreply.github.com> --- docs/source/overview/support_matrix.rst | 45 ++++++++++++++----------- 1 file changed, 26 insertions(+), 19 deletions(-) diff --git a/docs/source/overview/support_matrix.rst b/docs/source/overview/support_matrix.rst index 6d360f634..ce8222fcd 100644 --- a/docs/source/overview/support_matrix.rst +++ b/docs/source/overview/support_matrix.rst @@ -1,24 +1,31 @@ Operating System & Hardware Support Matrix ========================================== -+-------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ -| | Power | Power | zVM | Power | x86_64 | x86_64 | x86_64 | aarch64 | riscv64 | -| | | LE | | KVM | | KVM | Esxi | | | -+=======+=======+=======+=====+=======+========+========+========+==========+==========+ -|RHEL | yes | yes | yes | yes | yes | yes | yes | yes | yes | -| | | | | | | | | | | -+-------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ -|SLES | yes | yes | yes | yes | yes | yes | yes | no | no | -| | | | | | | | | | | -+-------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ -|Ubuntu | no | yes | no | yes | yes | yes | yes | no | no | -| | | | | | | | | | | -+-------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ -|CentOS | no | no | no | no | yes | yes | yes | no | no | -| | | | | | | | | | | -+-------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ -|Windows| no | no | no | no | yes | yes | yes | no | no | -| | | | | | | | | | | -+-------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ ++--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ +| Distro | Version | Power | Power | zVM | Power | x86_64 | x86_64 | x86_64 | aarch64 | riscv64 | +| | | | LE | | KVM | | KVM | Esxi | | | ++========+=========+=======+=======+=====+=======+========+========+========+==========+==========+ +| EL | 8 | yes | yes | yes | yes | yes | yes | yes | yes | no | ++--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ +| EL | 9 | yes | yes | yes | yes | yes | yes | yes | yes | no | ++--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ +| EL | 10 | yes | yes | yes | yes | yes | yes | yes | yes | yes | ++--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ +| SLES | 12 | yes | yes | yes | yes | yes | yes | yes | no | no | ++--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ +| SLES | 15 | yes | yes | yes | yes | yes | yes | yes | no | no | ++--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ +| Ubuntu | 20.04 | no | yes | no | yes | yes | yes | yes | no | no | ++--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ +| Ubuntu | 22.04 | no | yes | no | yes | yes | yes | yes | no | no | ++--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ +| Ubuntu | 24.04 | no | yes | no | yes | yes | yes | yes | no | no | ++--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ +| Ubuntu | 26.04 | no | yes | no | yes | yes | yes | yes | no | no | ++--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ + +.. note:: + + EL: Enterprise Linux, such as: RHEL, Rocky Linux, Alma Linux, CentOS and Oracle Linux. riscv64 support covers EL10 compute nodes (Rocky Linux 10 and the RHEL 10 RISC-V developer preview) that boot through UEFI firmware and grub2. See :doc:`/guides/admin-guides/manage_clusters/riscv64/index` for details. From 63fded7f0f6633ee2ca8dc832430b6817c55bff7 Mon Sep 17 00:00:00 2001 From: Daniel Hilst <392820+dhilst@users.noreply.github.com> Date: Tue, 8 Sep 2026 17:58:02 -0300 Subject: [PATCH 2/7] feat(xcat-core): keep support scope in the matrix The standalone riscv64 paragraph duplicated a version restriction that the versioned matrix now expresses directly and described only compute-node behavior. Keeping it would leave two sources for the same support claim. Signed-off-by: Daniel Hilst <392820+dhilst@users.noreply.github.com> --- docs/source/overview/support_matrix.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/source/overview/support_matrix.rst b/docs/source/overview/support_matrix.rst index ce8222fcd..a9706942f 100644 --- a/docs/source/overview/support_matrix.rst +++ b/docs/source/overview/support_matrix.rst @@ -27,5 +27,3 @@ Operating System & Hardware Support Matrix .. note:: EL: Enterprise Linux, such as: RHEL, Rocky Linux, Alma Linux, CentOS and Oracle Linux. - -riscv64 support covers EL10 compute nodes (Rocky Linux 10 and the RHEL 10 RISC-V developer preview) that boot through UEFI firmware and grub2. See :doc:`/guides/admin-guides/manage_clusters/riscv64/index` for details. From 1f14c843e0c650461a40345e09ba5a2cb3c714aa Mon Sep 17 00:00:00 2001 From: Daniel Hilst <392820+dhilst@users.noreply.github.com> Date: Wed, 9 Sep 2026 06:35:41 -0300 Subject: [PATCH 3/7] feat(xcat-core): remove aarch64 from support matrix The aarch64 column advertises three EL targets that are outside the xCAT 2.19 campaign scope and creates unsupported campaign obligations. Remove the column so the documentation remains the exact source of truth for the release qualification backlog. Signed-off-by: Daniel Hilst <392820+dhilst@users.noreply.github.com> --- docs/source/overview/support_matrix.rst | 44 ++++++++++++------------- 1 file changed, 22 insertions(+), 22 deletions(-) diff --git a/docs/source/overview/support_matrix.rst b/docs/source/overview/support_matrix.rst index a9706942f..8d777ed60 100644 --- a/docs/source/overview/support_matrix.rst +++ b/docs/source/overview/support_matrix.rst @@ -1,28 +1,28 @@ Operating System & Hardware Support Matrix ========================================== -+--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ -| Distro | Version | Power | Power | zVM | Power | x86_64 | x86_64 | x86_64 | aarch64 | riscv64 | -| | | | LE | | KVM | | KVM | Esxi | | | -+========+=========+=======+=======+=====+=======+========+========+========+==========+==========+ -| EL | 8 | yes | yes | yes | yes | yes | yes | yes | yes | no | -+--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ -| EL | 9 | yes | yes | yes | yes | yes | yes | yes | yes | no | -+--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ -| EL | 10 | yes | yes | yes | yes | yes | yes | yes | yes | yes | -+--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ -| SLES | 12 | yes | yes | yes | yes | yes | yes | yes | no | no | -+--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ -| SLES | 15 | yes | yes | yes | yes | yes | yes | yes | no | no | -+--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ -| Ubuntu | 20.04 | no | yes | no | yes | yes | yes | yes | no | no | -+--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ -| Ubuntu | 22.04 | no | yes | no | yes | yes | yes | yes | no | no | -+--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ -| Ubuntu | 24.04 | no | yes | no | yes | yes | yes | yes | no | no | -+--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ -| Ubuntu | 26.04 | no | yes | no | yes | yes | yes | yes | no | no | -+--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+----------+ ++--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ +| Distro | Version | Power | Power | zVM | Power | x86_64 | x86_64 | x86_64 | riscv64 | +| | | | LE | | KVM | | KVM | Esxi | | ++========+=========+=======+=======+=====+=======+========+========+========+==========+ +| EL | 8 | yes | yes | yes | yes | yes | yes | yes | no | ++--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ +| EL | 9 | yes | yes | yes | yes | yes | yes | yes | no | ++--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ +| EL | 10 | yes | yes | yes | yes | yes | yes | yes | yes | ++--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ +| SLES | 12 | yes | yes | yes | yes | yes | yes | yes | no | ++--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ +| SLES | 15 | yes | yes | yes | yes | yes | yes | yes | no | ++--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ +| Ubuntu | 20.04 | no | yes | no | yes | yes | yes | yes | no | ++--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ +| Ubuntu | 22.04 | no | yes | no | yes | yes | yes | yes | no | ++--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ +| Ubuntu | 24.04 | no | yes | no | yes | yes | yes | yes | no | ++--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ +| Ubuntu | 26.04 | no | yes | no | yes | yes | yes | yes | no | ++--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ .. note:: From 2f0b59b21e8b734ce0c33e9ac9785b688712b5a6 Mon Sep 17 00:00:00 2001 From: Daniel Hilst <392820+dhilst@users.noreply.github.com> Date: Fri, 11 Sep 2026 06:55:29 -0300 Subject: [PATCH 4/7] Update docs/source/overview/support_matrix.rst MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Vinícius Ferrão --- docs/source/overview/support_matrix.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/overview/support_matrix.rst b/docs/source/overview/support_matrix.rst index 8d777ed60..3f1650f41 100644 --- a/docs/source/overview/support_matrix.rst +++ b/docs/source/overview/support_matrix.rst @@ -26,4 +26,4 @@ Operating System & Hardware Support Matrix .. note:: - EL: Enterprise Linux, such as: RHEL, Rocky Linux, Alma Linux, CentOS and Oracle Linux. + EL stands for Enterprise Linux, such as: Red Hat Enterprise Linux (RHEL), Rocky Linux, AlmaLinux, CentOS and Oracle Linux. From a25e89772d6ebae285d95b0fad45fb98952cd336 Mon Sep 17 00:00:00 2001 From: Daniel Hilst <392820+dhilst@users.noreply.github.com> Date: Fri, 11 Sep 2026 06:55:52 -0300 Subject: [PATCH 5/7] Update docs/source/overview/support_matrix.rst MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Vinícius Ferrão --- docs/source/overview/support_matrix.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/source/overview/support_matrix.rst b/docs/source/overview/support_matrix.rst index 3f1650f41..b7140f3ef 100644 --- a/docs/source/overview/support_matrix.rst +++ b/docs/source/overview/support_matrix.rst @@ -15,8 +15,6 @@ Operating System & Hardware Support Matrix +--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ | SLES | 15 | yes | yes | yes | yes | yes | yes | yes | no | +--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ -| Ubuntu | 20.04 | no | yes | no | yes | yes | yes | yes | no | -+--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ | Ubuntu | 22.04 | no | yes | no | yes | yes | yes | yes | no | +--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ | Ubuntu | 24.04 | no | yes | no | yes | yes | yes | yes | no | From a5df79078d86d5f40cff2f4aeca5fff3d1c374df Mon Sep 17 00:00:00 2001 From: Daniel Hilst <392820+dhilst@users.noreply.github.com> Date: Fri, 11 Sep 2026 12:25:45 -0300 Subject: [PATCH 6/7] docs(xcat-core): the support matrix names hypervisors where it must name architectures The Operating System & Hardware Support Matrix carried eight hardware columns: Power, Power LE, zVM, Power KVM, x86_64, x86_64 KVM, x86_64 Esxi and riscv64. Six of them name a platform or a hypervisor, not a build target. xCAT builds and ships one set of packages per architecture, so a reader cannot tell from the old table which artifact serves a cell, and the same artifact appears under three headings. Reduce the columns to the three architectures xCAT builds for: x86_64, ppc64le and riscv64. The x86_64, x86_64 KVM and x86_64 Esxi cells collapse into x86_64, and Power, Power LE and Power KVM collapse into ppc64le. Every collapsed group held one value per row, so no row changes meaning. The zVM column is removed: s390x is not a built architecture. Signed-off-by: Daniel Hilst <392820+dhilst@users.noreply.github.com> --- docs/source/overview/support_matrix.rst | 39 ++++++++++++------------- 1 file changed, 19 insertions(+), 20 deletions(-) diff --git a/docs/source/overview/support_matrix.rst b/docs/source/overview/support_matrix.rst index b7140f3ef..02e847bf2 100644 --- a/docs/source/overview/support_matrix.rst +++ b/docs/source/overview/support_matrix.rst @@ -1,26 +1,25 @@ Operating System & Hardware Support Matrix ========================================== -+--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ -| Distro | Version | Power | Power | zVM | Power | x86_64 | x86_64 | x86_64 | riscv64 | -| | | | LE | | KVM | | KVM | Esxi | | -+========+=========+=======+=======+=====+=======+========+========+========+==========+ -| EL | 8 | yes | yes | yes | yes | yes | yes | yes | no | -+--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ -| EL | 9 | yes | yes | yes | yes | yes | yes | yes | no | -+--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ -| EL | 10 | yes | yes | yes | yes | yes | yes | yes | yes | -+--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ -| SLES | 12 | yes | yes | yes | yes | yes | yes | yes | no | -+--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ -| SLES | 15 | yes | yes | yes | yes | yes | yes | yes | no | -+--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ -| Ubuntu | 22.04 | no | yes | no | yes | yes | yes | yes | no | -+--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ -| Ubuntu | 24.04 | no | yes | no | yes | yes | yes | yes | no | -+--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ -| Ubuntu | 26.04 | no | yes | no | yes | yes | yes | yes | no | -+--------+---------+-------+-------+-----+-------+--------+--------+--------+----------+ ++--------+---------+--------+---------+----------+ +| Distro | Version | x86_64 | ppc64le | riscv64 | ++========+=========+========+=========+==========+ +| EL | 8 | yes | yes | no | ++--------+---------+--------+---------+----------+ +| EL | 9 | yes | yes | no | ++--------+---------+--------+---------+----------+ +| EL | 10 | yes | yes | yes | ++--------+---------+--------+---------+----------+ +| SLES | 12 | yes | yes | no | ++--------+---------+--------+---------+----------+ +| SLES | 15 | yes | yes | no | ++--------+---------+--------+---------+----------+ +| Ubuntu | 22.04 | yes | yes | no | ++--------+---------+--------+---------+----------+ +| Ubuntu | 24.04 | yes | yes | no | ++--------+---------+--------+---------+----------+ +| Ubuntu | 26.04 | yes | yes | no | ++--------+---------+--------+---------+----------+ .. note:: From ba8233a60562f883c532eb4ec4536a0e9721a520 Mon Sep 17 00:00:00 2001 From: Daniel Hilst <392820+dhilst@users.noreply.github.com> Date: Fri, 25 Sep 2026 08:44:02 -0300 Subject: [PATCH 7/7] docs(xcat-core): the support matrix omits openEuler xcat2/xcat-core#7864 adds openEuler 20.03 LTS SP4, 22.03 LTS SP4 and 24.03 LTS SP4 on x86_64, for the management node, service nodes and stateful and stateless compute nodes. The support matrix does not list openEuler at all. Add one row per release, x86_64 only, and say which node roles the support covers. Widen the Version column to fit the release names. Signed-off-by: Daniel Hilst <392820+dhilst@users.noreply.github.com> --- docs/source/overview/support_matrix.rst | 47 +++++++++++++++---------- 1 file changed, 28 insertions(+), 19 deletions(-) diff --git a/docs/source/overview/support_matrix.rst b/docs/source/overview/support_matrix.rst index d64c18a92..7058d9a3a 100644 --- a/docs/source/overview/support_matrix.rst +++ b/docs/source/overview/support_matrix.rst @@ -1,30 +1,39 @@ Operating System & Hardware Support Matrix ========================================== -+--------+---------+--------+---------+----------+ -| Distro | Version | x86_64 | ppc64le | riscv64 | -+========+=========+========+=========+==========+ -| EL | 8 | yes | yes | no | -+--------+---------+--------+---------+----------+ -| EL | 9 | yes | yes | no | -+--------+---------+--------+---------+----------+ -| EL | 10 | yes | yes | yes | -+--------+---------+--------+---------+----------+ -| SLES | 12 | yes | yes | no | -+--------+---------+--------+---------+----------+ -| SLES | 15 | yes | yes | no | -+--------+---------+--------+---------+----------+ -| Ubuntu | 22.04 | yes | yes | no | -+--------+---------+--------+---------+----------+ -| Ubuntu | 24.04 | yes | yes | no | -+--------+---------+--------+---------+----------+ -| Ubuntu | 26.04 | yes | yes | no | -+--------+---------+--------+---------+----------+ ++-----------+---------------+---------+----------+-----------+ +| Distro | Version | x86_64 | ppc64le | riscv64 | ++===========+===============+=========+==========+===========+ +| EL | 8 | yes | yes | no | ++-----------+---------------+---------+----------+-----------+ +| EL | 9 | yes | yes | no | ++-----------+---------------+---------+----------+-----------+ +| EL | 10 | yes | yes | yes | ++-----------+---------------+---------+----------+-----------+ +| SLES | 12 | yes | yes | no | ++-----------+---------------+---------+----------+-----------+ +| SLES | 15 | yes | yes | no | ++-----------+---------------+---------+----------+-----------+ +| Ubuntu | 22.04 | yes | yes | no | ++-----------+---------------+---------+----------+-----------+ +| Ubuntu | 24.04 | yes | yes | no | ++-----------+---------------+---------+----------+-----------+ +| Ubuntu | 26.04 | yes | yes | no | ++-----------+---------------+---------+----------+-----------+ +| openEuler | 20.03 LTS SP4 | yes | no | no | ++-----------+---------------+---------+----------+-----------+ +| openEuler | 22.03 LTS SP4 | yes | no | no | ++-----------+---------------+---------+----------+-----------+ +| openEuler | 24.03 LTS SP4 | yes | no | no | ++-----------+---------------+---------+----------+-----------+ .. note:: EL stands for Enterprise Linux, such as: Red Hat Enterprise Linux (RHEL), Rocky Linux, AlmaLinux, CentOS and Oracle Linux. + openEuler support covers the management node, installed and diskless service nodes, and + stateful and stateless compute nodes. + riscv64 support covers EL 10 (Rocky Linux 10 and the RHEL 10 RISC-V developer preview), on nodes that boot through UEFI firmware and grub2. Both stateful and stateless nodes are supported, and the management node itself can run on riscv64. See