From cb3fda9b3c5bd2017786a12999401449b91746d2 Mon Sep 17 00:00:00 2001 From: Wei Zhou Date: Mon, 12 Feb 2024 09:38:32 +0100 Subject: [PATCH 1/3] systemvm: Update patch systemvm support matrix --- source/upgrading/upgrade/_sysvm_restart.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/upgrading/upgrade/_sysvm_restart.rst b/source/upgrading/upgrade/_sysvm_restart.rst index 30f32282fb..28e8337da5 100644 --- a/source/upgrading/upgrade/_sysvm_restart.rst +++ b/source/upgrading/upgrade/_sysvm_restart.rst @@ -64,12 +64,12 @@ Following matrix lists the versions of CloudStack that support live patching. +---------------------+-------------------------+--------------------------------+------------------------------------------+ | **ACS Version** | **Upgrade Version** | **Live Patching Support** | **Reason / Comment** | +---------------------+-------------------------+--------------------------------+------------------------------------------+ - | <=4.13 | 4.17+ | No | Update in the openJDK version | + | <=4.15 | 4.20+ | No | Debian 10 (buster) is EOL on 2024-06-30 | +---------------------+-------------------------+--------------------------------+------------------------------------------+ - | 4.14 | 4.17+ |Yes | May notice some issue with remove access | - | | | | VPN due to older version of Strongswan | + | >=4.16 | 4.19 | Yes | N/A | +---------------------+-------------------------+--------------------------------+------------------------------------------+ - | >=4.15 | 4.17+ |Yes | N/A | + | >=4.16 | 4.20 | Yes | May notice some issues due to the Debian | + | | | | upgrade from 11(bullseye) to 12(bookworm)| +---------------------+-------------------------+--------------------------------+------------------------------------------+ In addition to the support for live patching, users still have the facility to follow the legacy workflow From e31cd79ef0932a29a91bcbea9ed4e02a1abc5a54 Mon Sep 17 00:00:00 2001 From: Wei Zhou Date: Tue, 20 Feb 2024 13:20:41 +0100 Subject: [PATCH 2/3] add note for VR memory upgrade to 512 MiB --- source/upgrading/upgrade/_sysvm_restart.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/source/upgrading/upgrade/_sysvm_restart.rst b/source/upgrading/upgrade/_sysvm_restart.rst index 28e8337da5..ca265f227e 100644 --- a/source/upgrading/upgrade/_sysvm_restart.rst +++ b/source/upgrading/upgrade/_sysvm_restart.rst @@ -35,6 +35,12 @@ This will update the software packages, which were previously bundled in the sys agent.zip and cloud-scripts.tgz and restart the services that are present in the /var/cache/cloud/enabled_svcs file in the System VMs. +.. note:: + The System VM template has been upgrade to Debian 12.x in Apache CloudStack 4.20.0.0. + Due to it, the memory size of default system offerings has been changed to 512 MiB. + If you use custom system offerings, please check the memory size of the offerings. + If memory size is small (for example 256 MiB), the System VMs and virtual routers might have the "kernel panic" issue on boot. + .. note:: The following services will be restarted once a system VM is live patched: From f8e7b4d490e970b48cbe131cd13b916772beb52a Mon Sep 17 00:00:00 2001 From: Wei Zhou Date: Wed, 21 Feb 2024 13:21:44 +0100 Subject: [PATCH 3/3] Add notes for VR live-patch --- source/upgrading/upgrade/_sysvm_restart.rst | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/source/upgrading/upgrade/_sysvm_restart.rst b/source/upgrading/upgrade/_sysvm_restart.rst index ca265f227e..8b38a74bc4 100644 --- a/source/upgrading/upgrade/_sysvm_restart.rst +++ b/source/upgrading/upgrade/_sysvm_restart.rst @@ -45,15 +45,16 @@ in the System VMs. The following services will be restarted once a system VM is live patched: - +---------------------+-------------------------------+ - | **System VM** | **Services** | - +---------------------+-------------------------------+ - | SSVM | cloud, apache2, portmap | - +---------------------+-------------------------------+ - | CPVM | cloud | - +---------------------+-------------------------------+ - | VRs | haproxy, apache2, dnsmasq | - +---------------------+-------------------------------+ + +---------------------+-------------------------------+---------------------------------------------------+ + | **System VM** | **Services** | **Note** | + +---------------------+-------------------------------+---------------------------------------------------+ + | SSVM | cloud, apache2, portmap | | + +---------------------+-------------------------------+---------------------------------------------------+ + | CPVM | cloud | | + +---------------------+-------------------------------+---------------------------------------------------+ + | VRs | haproxy, apache2, dnsmasq | Please set setting `minreq.sysvmtemplate.version` | + | | | to proper value before live-patching | + +---------------------+-------------------------------+---------------------------------------------------+ With respect to VRs, a Network restart without cleanup is initiated to during live patching to ensure all rules are re-applied.