This is an automated email from the ASF dual-hosted git repository.
nvazquez pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/cloudstack-documentation.git
The following commit(s) were added to refs/heads/main by this push:
new b383dc5 Multi-Arch zones documentation (#440)
b383dc5 is described below
commit b383dc5a75443ee3c238b9a49177a53fb0636556
Author: Nicolas Vazquez <nicovazque...@gmail.com>
AuthorDate: Mon Oct 14 07:46:34 2024 -0300
Multi-Arch zones documentation (#440)
* Clusters and hosts arch type
* Templates and isos
* Add hosts and cluster allocation page
---
source/_static/images/deploy-vm-arch-types.png | Bin 0 -> 126552 bytes
source/adminguide/arch_types.rst | 30 +++++++++++++++++++++++++
source/adminguide/index.rst | 1 +
source/adminguide/templates.rst | 6 ++++-
source/installguide/configuration.rst | 9 +++++++-
5 files changed, 44 insertions(+), 2 deletions(-)
diff --git a/source/_static/images/deploy-vm-arch-types.png
b/source/_static/images/deploy-vm-arch-types.png
new file mode 100644
index 0000000..ab16eb5
Binary files /dev/null and b/source/_static/images/deploy-vm-arch-types.png
differ
diff --git a/source/adminguide/arch_types.rst b/source/adminguide/arch_types.rst
new file mode 100644
index 0000000..eea29ad
--- /dev/null
+++ b/source/adminguide/arch_types.rst
@@ -0,0 +1,30 @@
+.. Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information#
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+
+Hosts/Cluster Arch Types Allocation
+===================================
+
+Since CloudStack 4.20.0, it is possible to add AMD 64 bits and ARM 64 bits
clusters (and hosts). A single zone can contain clusters (and hosts) of
different arch types (multi-arch zones).
+
+When a multi-arch zone is selected for VM deployment, CloudStack allows the
users to filter the templates/ISOs by their arch type.
+
+|deploy-vm-arch-types.png|
+
+Once a template/ISO is selected, only the clusters (and hosts) matching the
arch type will be considered for the VM allocation
+
+.. |deploy-vm-arch-types.png| image:: /_static/images/deploy-vm-arch-types.png
+ :alt: Filtering templates and ISOs by arch types
+
diff --git a/source/adminguide/index.rst b/source/adminguide/index.rst
index f597cdd..720e0cd 100644
--- a/source/adminguide/index.rst
+++ b/source/adminguide/index.rst
@@ -139,6 +139,7 @@ Managing VM and Volume Allocation
:maxdepth: 4
host_and_storage_tags
+ arch_types
Managing Networks and Traffic
-----------------------------
diff --git a/source/adminguide/templates.rst b/source/adminguide/templates.rst
index c981dc5..e92db41 100644
--- a/source/adminguide/templates.rst
+++ b/source/adminguide/templates.rst
@@ -281,6 +281,8 @@ To upload a Template:
- **Hypervisor**: The supported hypervisors are listed. Select the
desired one.
+ - **Arch**: The supported arch types are listed. Select the desired one.
+
- **Format**. The format of the Template upload file, such as VHD or
OVA.
@@ -328,7 +330,7 @@ Example GUI dialog of uploading Template/ISO from local
(browser) is given below
|upload-iso-from-local.png|
-Note that uploading multi-disk Templates is also supported.
+Note that uploading multi-disk Templates is also supported as well as
selecting the template/ISO arch type.
Sharing Templates and ISOs with other Accounts/projects
-------------------------------------------------------
@@ -545,6 +547,8 @@ part of a Template.
prominent for Users to select. The ISO will appear in the Featured
ISOs list. Only an administrator can make an ISO Featured.
+ - **Arch**: The supported arch types are listed. Select the desired one.
+
#. Click OK.
The Management Server will download the ISO. Depending on the size of
diff --git a/source/installguide/configuration.rst
b/source/installguide/configuration.rst
index 86cdda1..b50a94a 100644
--- a/source/installguide/configuration.rst
+++ b/source/installguide/configuration.rst
@@ -871,6 +871,9 @@ You need to tell CloudStack about the hosts that it will
manage. Hosts
exist inside clusters, so before you begin adding hosts to the cloud,
you must add at least one cluster.
+.. note::
+ Since CloudStack 4.20.0, it is possible to specify the hosts arch type
which must be homogeneous within the cluster. AMD 64 bits (x86_64) and ARM 64
bits (aarch64) arch types are supported. The pre-existing clusters are set to
arch type AMD 64 bits as well as new clusters in which the arch type is not
specified.
+
Add Cluster: KVM or XenServer
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -889,6 +892,8 @@ hosts and logged in to the CloudStack UI.
#. Choose the hypervisor type for this cluster.
+#. Choose the arch type of the hosts within the cluster.
+
#. Choose the pod in which you want to create the cluster.
#. Enter a name for the cluster. This can be text of your choosing and
@@ -1008,7 +1013,7 @@ Requirements for XenServer and KVM Hosts
Configuration requirements:
-- Each cluster must contain only hosts with the identical hypervisor.
+- Each cluster must contain only hosts with the identical hypervisor and arch
type.
- For XenServer, do not put more than 8 hosts in a cluster.
@@ -1017,6 +1022,8 @@ Configuration requirements:
For hardware requirements, see the installation section for your
hypervisor in the CloudStack Installation Guide.
+.. note::
+ Since CloudStack 4.20.0, the host arch type is auto detected when adding
the host into CloudStack and it must match the cluster arch type for the
operation to succeed.
XenServer Host Additional Requirements
''''''''''''''''''''''''''''''''''''''
