Skip to content

multi-arch: note on new config and improvements #491

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Apr 25, 2025
Merged

multi-arch: note on new config and improvements #491

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
3cf528c
multi-arch: note on new config and improvements
shwstppr Mar 19, 2025
d441fdd
fix
shwstppr Mar 19, 2025
01a5b45
arm64 systemvm template note
shwstppr Apr 24, 2025
b0379a8
additional note
shwstppr Apr 24, 2025
1117ee6
fix formatting
shwstppr Apr 24, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 6 additions & 5 deletions source/_global.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
62 changes: 52 additions & 10 deletions source/adminguide/systemvm.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -46,6 +46,42 @@ 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
---------------------------------------
Expand All @@ -58,18 +94,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

Expand All @@ -89,6 +126,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 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.

Accessing System VMs
Expand Down
3 changes: 3 additions & 0 deletions source/installguide/configuration.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 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
~~~~~~~~~~~~~~~~~~~~~~~~
Expand Down