Merge branch 'main' into update-Host-LXC-Installation-page-of-Instllation-Guide

Author: daviftorres

source/_static/images/ui-login-project-view.png

@@ -45,6 +45,10 @@ the default username is password.
 
 Domain -> If you are a root User, leave this field blank.
 
+.. note::
+
+   Since 4.21 it is possible to login to a specific Project view by enabling the 'displayProjectFieldOnLogin' setting on config.json (which is disabled by default). Please refer to: :ref:`enable-login-to-project-view`.
+
 If you are a User in the sub-domains, enter the full path to the domain,
 excluding the root domain.
 
@@ -660,6 +664,23 @@ For the UI to work with different servers, it is necessary to configure the Ngin
 
 |ui-multiple-server-management.png|
 
+.. _enable-login-to-project-view:
+
+Enable Login to Project View
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+User can use the file /etc/cloudstack/management/config.json to enable the Project field displayed on Login by the setting:
+
+============================= =================================================================
+Property                      Description
+============================= =================================================================
+displayProjectFieldOnLogin    Disabled by default. When enabled, login directly to Project view
+============================= =================================================================
+
+When the Project field is set and the Project exists, the user is directly directed to the Project view instead of the Default View.
+
+|ui-login-project-view.png|
+
 Known Limitations
 ~~~~~~~~~~~~~~~~~
 
@@ -684,3 +705,6 @@ The following features are no longer supported or available in the UI but are st
 
 .. |ui-multiple-server-management.png| image:: /_static/images/ui-multiple-server-management.png
    :alt: Custom plugin shown in UI with navigation
+
+.. |ui-login-project-view.png| image:: /_static/images/ui-login-project-view.png
+   :alt: Enabling the Project field on login

source/_static/images/zone-kvm-register-template.png

@@ -77,4 +77,63 @@ firstfitleastconsumed          Selects the first storage pool after sorting elig
 
       **volume.allocation.algorithm**: random (default)
 
-   Before 4.21.0, **vm.allocation.algorithm** was used for both VM as well as Volume allocation.
+   Before 4.21.0, **vm.allocation.algorithm** was used for both VM as well as Volume allocation.
+
+
+Cluster, Pod and Host Ordering
+==============================
+
+Overview
+--------
+
+`The host.capacityType.to.order.clusters` is a global advanced configuration parameter in Apache CloudStack that controls how pods, clusters, 
+and hosts are prioritized during Instance deployment, based on available CPU, RAM, or a weighted combination of both in Host.
+This configuration is specifically leveraged when the VM allocation algorithm is set to `firstfitleastconsumed`.
+
+Configuration
+-------------
+
+Key: `host.capacityType.to.order.clusters`
+
+.. cssclass:: table-striped table-bordered table-hover
+
+========= ========================
+Value      Behavior
+========= ========================
+CPU		  Prioritizes resources with the most available CPU.
+RAM		  Prioritizes resources with the most available memory.
+COMBINED	  Uses a weighted formula to balance CPU and RAM in prioritization.
+========= ========================
+
+**Additional Configuration for COMBINED**
+
+- Key: `host.capacityType.to.order.clusters.cputomemoryweight`
+- Type: Float(0.0 to 1.0)
+- Default: 0.5
+- Purpose: Determines the weight of CPU vs RAM in the combined capacity calculation.
+
+Capacity calculation formula:
+
+.. code:: bash
+
+   capacity = (host.capacityType.to.order.clusters.cputomemoryweight * CPU) + ((1 - host.capacityType.to.order.clusters.cputomemoryweight) * RAM)
+
+
+This allows flexible tuning of prioritization depending on workload sensitivity.
+
+Example Configuration
+---------------------
+
+.. code:: bash
+
+   host.capacityType.to.order.clusters: COMBINED
+   host.capacityType.to.order.clusters.cputomemoryweight: 0.7
+
+Above config prioritizes CPU at 70% weight and RAM at 30% when ranking pods, clusters, and hosts.
+
+.. note::
+   - `host.capacityType.to.order.clusters` is only respected for host ordering when:
+   .. code:: bash
+
+      vm.allocation.algorithm: firstfitleastconsumed
+   - When using COMBINED, make sure to tune cpu.to.memory.capacity.weight to reflect your environment’s resource constraints and workload profiles.

source/_static/images/zone-register-templates.png

@@ -47,6 +47,8 @@ follow these procedures:
 
 #. Add secondary storage to the zone. See :ref:`add-secondary-storage`.
 
+#. Register Templates to the zone. See :ref:`register-templates`.
+
 #. Initialize and test the new cloud. See :ref:`initialize-and-test`.
 
 When you have finished these steps, you will have a deployment with the
@@ -1750,6 +1752,29 @@ You can add  object storage pools at any time to add more capacity or providers
 
 See https://min.io/docs/minio/linux/index.html for MinIO Documentation
 
+
+.. _register-templates:
+
+Register Cloud Templates
+------------------------
+
+For "KVM" hypervisor, admin can register cloud templates after Zone is enabled, through the optional step "Register Template" 
+
+   #. After selecting kvm hypervisor:
+
+      |ZoneKVMRegisterTemplates.png: KVM Register Templates|
+
+   #. Register Template step in Zone wizard:
+
+      |ZoneRegisterTemplates.png: Zone Register Templates|
+
+**Notes**
+
+- Cloud image templates are hosted in http://download.cloudstack.org/templates/cloud-images/
+- Metadata for the available templates is stored on the management server at: `/usr/share/cloudstack-management/webapp/cloud-image-templates.json`
+- `MD5 <https://download.cloudstack.org/templates/cloud-images/md5sum.txt>`_ and `SHA512 <https://download.cloudstack.org/templates/cloud-images/sha512sum.txt>`_ checksums can be used to validate available cloud images for registration.
+   
+
 .. _initialize-and-test:
 
 Initialize and Test
@@ -1973,3 +1998,5 @@ zone      denied.routes                                              Routes that
 .. |add-Host.png: Adding a KVM Host| image:: /_static/images/add-Host.png
 .. |ConsoleButton.png: button to launch a console| image:: /_static/images/console-icon.png
 .. |AddObjectStore.png: Add Object Storage| image:: /_static/images/add-object-store.png
+.. |ZoneKVMRegisterTemplates.png: KVM Register Templates| image:: /_static/images/zone-kvm-register-template.png
+.. |ZoneRegisterTemplates.png: Zone Register Templates| image:: /_static/images/zone-register-templates.png

source/adminguide/ui.rst

@@ -48,7 +48,7 @@ Steps to Install the Usage Server
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 #. Package repository should already being configured. Refer to 
-   `Configure Package Repository <http://cloudstack-installation.readthedocs.org/en/latest/installation.html#configure-package-repository>`_
+   `Configure Package Repository <../installguide/management-server/_pkg_repo.html#configure-package-repository>`_
 
 #. Install package cloudstack-usage
 

source/adminguide/vm_volume_allocators.rst

@@ -50,6 +50,7 @@ and VMware with vSphere.
 -  Alma Linux 8, 9 with KVM
 -  Rocky Linux 8, 9 with KVM
 -  Red Hat Enterprise Linux 8, 9 with KVM
+-  Experimental support for Red Hat Enterprise Linux 10 with KVM
 -  openSUSE Leap 15 with KVM
 -  SUSE Linux Enterprise Server 15 with KVM
 -  XCP-ng 8.2.0