From 3cf528ce6e455135fd7e816d397a0247922b3406 Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Wed, 19 Mar 2025 14:31:51 +0530 Subject: [PATCH 1/5] multi-arch: note on new config and improvements Related https://github.com/apache/cloudstack/pull/10289 Signed-off-by: Abhishek Kumar --- source/installguide/configuration.rst | 3 +++ 1 file changed, 3 insertions(+) diff --git a/source/installguide/configuration.rst b/source/installguide/configuration.rst index 93101fdc47..60a643280a 100644 --- a/source/installguide/configuration.rst +++ b/source/installguide/configuration.rst @@ -287,6 +287,9 @@ and secondary storage. - `“Advanced Zone Configuration” <#advanced-zone-configuration>`_ +.. note:: + Since CloudStack 4.20.1, it is possible to specify the preferred architecture type for a zone for deployment of system VM including virtual routers. Zone setting - *system.vm.preferred.architecture* can be updated for this. The server will first try deployment on the preferred architecture and if it fails then will attempt on other architecture hosts. + Administrator can also register SYSTEM and ROUTING template with the same name for different architectures to allow deployment across them depending on the compute capacity. Basic Zone Configuration ~~~~~~~~~~~~~~~~~~~~~~~~ From d441fdddffc945d8e783aced5bf482b29c08703b Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Wed, 19 Mar 2025 14:57:22 +0530 Subject: [PATCH 2/5] fix Signed-off-by: Abhishek Kumar --- source/installguide/configuration.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/installguide/configuration.rst b/source/installguide/configuration.rst index 60a643280a..2767fa3968 100644 --- a/source/installguide/configuration.rst +++ b/source/installguide/configuration.rst @@ -289,7 +289,7 @@ and secondary storage. .. note:: Since CloudStack 4.20.1, it is possible to specify the preferred architecture type for a zone for deployment of system VM including virtual routers. Zone setting - *system.vm.preferred.architecture* can be updated for this. The server will first try deployment on the preferred architecture and if it fails then will attempt on other architecture hosts. - Administrator can also register SYSTEM and ROUTING template with the same name for different architectures to allow deployment across them depending on the compute capacity. + Administrator can also register ROUTING template with the same name for different architectures to allow deployment across them depending on the compute capacity. For other system VMs, server will attempt deployment using different architecture templates available. Basic Zone Configuration ~~~~~~~~~~~~~~~~~~~~~~~~ From 01a5b458776a4a5df253828cbfd7a4cfc4d5d6f6 Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Thu, 24 Apr 2025 17:10:26 +0530 Subject: [PATCH 3/5] arm64 systemvm template note Signed-off-by: Abhishek Kumar --- source/_global.rst | 11 +++---- source/adminguide/systemvm.rst | 52 +++++++++++++++++++++++++++------- 2 files changed, 48 insertions(+), 15 deletions(-) diff --git a/source/_global.rst b/source/_global.rst index f5819b21da..280926d36e 100644 --- a/source/_global.rst +++ b/source/_global.rst @@ -33,11 +33,12 @@ .. |sysvm64-name-ovm| replace:: systemvm-ovm-4.20.0-x86_64 .. Latest version systemvm template URL -.. |sysvm64-url-xen| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.0-x86_64-xen.vhd.bz2 -.. |sysvm64-url-kvm| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.0-x86_64-kvm.qcow2.bz2 -.. |sysvm64-url-vmware| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.0-x86_64-vmware.ova -.. |sysvm64-url-hyperv| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.0-x86_64-hyperv.vhd.zip -.. |sysvm64-url-ovm| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.0-x86_64-ovm.raw.bz2 +.. |sysvm64-url-xen| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.0-x86_64-xen.vhd.bz2 +.. |sysvm64-url-kvm| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.0-x86_64-kvm.qcow2.bz2 +.. |sysvm64-url-kvm-aarch64| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.0-aarch64-kvm.qcow2.bz2 +.. |sysvm64-url-vmware| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.0-x86_64-vmware.ova +.. |sysvm64-url-hyperv| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.0-x86_64-hyperv.vhd.zip +.. |sysvm64-url-ovm| replace:: http://download.cloudstack.org/systemvm/4.20/systemvmtemplate-4.20.0-x86_64-ovm.raw.bz2 .. Images diff --git a/source/adminguide/systemvm.rst b/source/adminguide/systemvm.rst index 756ae2f054..d29a60ccea 100644 --- a/source/adminguide/systemvm.rst +++ b/source/adminguide/systemvm.rst @@ -27,7 +27,7 @@ The System VM Template The System VMs come from a single Template. The System VM has the following characteristics: -- Debian 10.8(buster), 4.19.0 kernel with the latest security +- Debian 12(bookwork), 6.1.0 kernel with the latest security patches from the Debian security APT repository - Has a minimal set of packages installed thereby reducing the attack @@ -46,6 +46,37 @@ following characteristics: - Latest version of JRE from Sun/Oracle ensures improved security and speed +Starting with 4.20.0 release, the following architectures are supported for KVM +hypervisor: +- Intel/AMD 64-bit (x86_64) +- ARM 64-bit (aarch64) + +Other hypervisors only support Intel/AMD 64-bit (x86_64) + + +System VM Template bundled with packages +---------------------------------------- + +The System VM Template is bundled with the official release DEB and RPM +cloudstack-management packages for Intel/AMD 64-bit architecture and the +following hypervisors: +- KVM +- VMware +- XenServer + +Currently, the ARM 64-bit template(s) are not bundled with the packages. + +During zone deployment and upgrade, the required templates, i.e., the +templates for hypervisor and architecture which are in use in the zone +if not already present will be automatically registered and seeded on +the secondary storage. + +ARM 64-bit template(s) will be downloaded from the official repository +and the same workflow for the registration and seeding will be used. If +the automatic download and seeding of ARM 64-bit template fails, the +template can be manually registered in a multi-architecture zone or +will need manual registration and seeding in a ARM 64-bit only zone. + Changing the Default System VM Template --------------------------------------- @@ -58,18 +89,19 @@ of memory. .. cssclass:: table-striped table-bordered table-hover - ========== ================================================================================================ - Hypervisor Download Location - ========== ================================================================================================ - XenServer |sysvm64-url-xen| - KVM |sysvm64-url-kvm| - VMware |sysvm64-url-vmware| - Hyper-V |sysvm64-url-hyperv| - ========== ================================================================================================ + ========== ============ ================================================================================= + Hypervisor Architecture Download Location + ========== ============ ================================================================================= + XenServer x86_64 |sysvm64-url-xen| + KVM x86_64 |sysvm64-url-kvm| + KVM aarch64 |sysvm64-url-kvm-aarch64| + VMware x86_64 |sysvm64-url-vmware| + Hyper-V x86_64 |sysvm64-url-hyperv| + ========== ============ ================================================================================= #. As an administrator, log in to the CloudStack UI -#. Register the 64 bit Template. +#. Register the 64-bit Template. For example: KVM64bitTemplate From b0379a8baa3b7050013ab4506a33ad3952e741ed Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Thu, 24 Apr 2025 17:18:34 +0530 Subject: [PATCH 4/5] additional note Signed-off-by: Abhishek Kumar --- source/adminguide/systemvm.rst | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/source/adminguide/systemvm.rst b/source/adminguide/systemvm.rst index d29a60ccea..90d14b3689 100644 --- a/source/adminguide/systemvm.rst +++ b/source/adminguide/systemvm.rst @@ -89,15 +89,15 @@ of memory. .. cssclass:: table-striped table-bordered table-hover - ========== ============ ================================================================================= + ========== ============ ================================================================================== Hypervisor Architecture Download Location - ========== ============ ================================================================================= + ========== ============ ================================================================================== XenServer x86_64 |sysvm64-url-xen| KVM x86_64 |sysvm64-url-kvm| KVM aarch64 |sysvm64-url-kvm-aarch64| VMware x86_64 |sysvm64-url-vmware| Hyper-V x86_64 |sysvm64-url-hyperv| - ========== ============ ================================================================================= + ========== ============ ================================================================================== #. As an administrator, log in to the CloudStack UI @@ -121,6 +121,11 @@ of memory. Any new virtual router created in this Zone automatically picks up this Template. +#. When using multiple architectures in the Zone, same name can be used + for different architectures for the same hypervisor to allow deployment + across them depending on the compute capacity and the zone setting - + *system.vm.preferred.architecture* + #. Restart the Management Server. Accessing System VMs From 1117ee6f47c3764a34680aeb07e4b929a636489d Mon Sep 17 00:00:00 2001 From: Abhishek Kumar Date: Thu, 24 Apr 2025 17:33:28 +0530 Subject: [PATCH 5/5] fix formatting Signed-off-by: Abhishek Kumar --- source/adminguide/systemvm.rst | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/source/adminguide/systemvm.rst b/source/adminguide/systemvm.rst index 90d14b3689..d88561e079 100644 --- a/source/adminguide/systemvm.rst +++ b/source/adminguide/systemvm.rst @@ -48,7 +48,9 @@ following characteristics: Starting with 4.20.0 release, the following architectures are supported for KVM hypervisor: + - Intel/AMD 64-bit (x86_64) + - ARM 64-bit (aarch64) Other hypervisors only support Intel/AMD 64-bit (x86_64) @@ -60,8 +62,11 @@ System VM Template bundled with packages The System VM Template is bundled with the official release DEB and RPM cloudstack-management packages for Intel/AMD 64-bit architecture and the following hypervisors: + - KVM + - VMware + - XenServer Currently, the ARM 64-bit template(s) are not bundled with the packages. @@ -122,9 +127,9 @@ of memory. this Template. #. When using multiple architectures in the Zone, same name can be used - for different architectures for the same hypervisor to allow deployment - across them depending on the compute capacity and the zone setting - - *system.vm.preferred.architecture* + for the templates for the different architectures and same hypervisor + to allow deployment across them depending on the compute capacity and + the zone setting - *system.vm.preferred.architecture* #. Restart the Management Server.