Multi-Arch zones documentation (#440)

* Clusters and hosts arch type

* Templates and isos

* Add hosts and cluster allocation page

Author: nvazquez

source/_static/images/deploy-vm-arch-types.png

@@ -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
+

source/adminguide/arch_types.rst

@@ -139,6 +139,7 @@ Managing VM and Volume Allocation
    :maxdepth: 4
 
    host_and_storage_tags
+   arch_types
 
 Managing Networks and Traffic
 -----------------------------

source/adminguide/index.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

source/adminguide/templates.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
 ''''''''''''''''''''''''''''''''''''''