all lists on lists.proxmox.com
 help / color / mirror / Atom feed
From: Daniel Kral <d.kral@proxmox.com>
To: pve-devel@lists.proxmox.com
Subject: [PATCH docs 14/18] ha-manager: crs: add more information about rebalance on start in its section
Date: Thu,  9 Apr 2026 13:41:40 +0200	[thread overview]
Message-ID: <20260409114224.323102-15-d.kral@proxmox.com> (raw)
In-Reply-To: <20260409114224.323102-1-d.kral@proxmox.com>

The information which node is considered as the best suited for an HA
resource was only described in the static-load scheduler section.

To define it both, add the description for the basic load scheduler and
move the description from the static-load scheduler section to the
description of the HA resource rebalance on start section.

The important notice about the technology preview is merged and also
moved to the rebalance-on-start section, as the technology preview only
really applies to this functionality instead of the whole static-load
scheduler mode.

The link macros for the scheduler modes are needed for the references in
the new paragraphs and are the same as the ones, which were previously
auto-generated.

Signed-off-by: Daniel Kral <d.kral@proxmox.com>
---
 ha-manager.adoc | 34 ++++++++++++++++++++--------------
 1 file changed, 20 insertions(+), 14 deletions(-)

diff --git a/ha-manager.adoc b/ha-manager.adoc
index 682e254..979e5e1 100644
--- a/ha-manager.adoc
+++ b/ha-manager.adoc
@@ -1438,6 +1438,7 @@ round, which should take no longer than 10 seconds.
 NOTE: There are plans to add modes for (static and dynamic) load-balancing in
 the future.
 
+[[_basic_scheduler]]
 Basic Scheduler
 ^^^^^^^^^^^^^^^
 
@@ -1445,28 +1446,15 @@ The number of active HA resources on each node is used to choose the
 best-fitting node for an HA resource. Non-HA-managed resources are currently
 not counted.
 
+[[_static_scheduler]]
 Static-Load Scheduler
 ^^^^^^^^^^^^^^^^^^^^^
 
-IMPORTANT: The static mode is still a technology preview.
-
 Static usage information from HA resources on each node is used to choose the
 best-fitting node for an HA resource. This includes the configured CPU and
 memory quotas for the HA resources. Usage of non-HA-managed resources is
 currently not considered.
 
-For this selection, each node in turn is considered as if the HA resource was
-already running on it, using CPU and memory usage from the associated guest
-configuration. Then for each such alternative, CPU and memory usage of all nodes
-are considered, with memory being weighted much more, because it's a truly
-limited resource. For both, CPU and memory, highest usage among nodes (weighted
-more, as ideally no node should be overcommitted) and average usage of all nodes
-(to still be able to distinguish in case there already is a more highly
-committed node) are considered.
-
-IMPORTANT: The more HA resources the more possible combinations there are, so
-it's currently not recommended to use it if you have thousands of HA resources.
-
 [[ha_manager_crs_scheduling_points]]
 CRS Scheduling Points
 ~~~~~~~~~~~~~~~~~~~~~
@@ -1510,9 +1498,27 @@ When starting an HA resource with rebalance on start enabled, the CRS will
 select the node best suited for the HA resource. If the selected node is not
 the current node, the HA resource will be migrate to the selected node.
 
+For the xref:_basic_scheduler[basic scheduler mode], the node with the least
+resources count is considered as the best suited node.
+
+For the xref:_static_scheduler[static-load scheduler mode], each node in turn
+is considered as if the HA resource was already running on it, using CPU and
+memory usage from the associated guest configuration. Then for each such
+alternative, CPU and memory usage of all nodes are considered, with memory
+being weighted much more, because it's a truly limited resource. For both, CPU
+and memory, highest usage among nodes (weighted more, as ideally no node should
+be overcommitted) and average usage of all nodes (to still be able to
+distinguish in case there already is a more highly committed node) are
+considered.
+
 This setting can be enabled with the CRS option `ha-rebalance-on-start` in the
 web interface under `Datacenter` -> `Options` -> `Cluster Resource Scheduling`.
 
+IMPORTANT: For the static-load scheduler mode, this functionality is still in
+technology preview. The more HA resources the more possible combinations there
+are, so it's currently not recommended to use it if you have thousands of HA
+resources.
+
 ifdef::manvolnum[]
 include::pve-copyright.adoc[]
 endif::manvolnum[]
-- 
2.47.3





  parent reply	other threads:[~2026-04-09 11:44 UTC|newest]

Thread overview: 22+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-04-09 11:41 [PATCH-SERIES manager/docs 00/18] crs docs updates + load balancer ui and docs followup Daniel Kral
2026-04-09 11:41 ` [PATCH manager 01/18] ui: form/CRSOptions: add missing edit modal title Daniel Kral
2026-04-09 11:41 ` [PATCH manager 02/18] ui: form/CRSOptions: rename HA Scheduling to Scheduling Mode Daniel Kral
2026-04-09 11:41 ` [PATCH manager 03/18] ui: form/CRSOptions: replace HA service term with HA resource Daniel Kral
2026-04-09 11:41 ` [PATCH manager 04/18] ui: form/CRSOptions: use view model for auto rebalancing option Daniel Kral
2026-04-09 11:41 ` [PATCH manager 05/18] ui: form/CRSOptions: allow auto rebalancing only for static and dynamic mode Daniel Kral
2026-04-09 11:41 ` [PATCH docs 06/18] ha-manager: crs: replace service term with HA resource Daniel Kral
2026-04-09 11:41 ` [PATCH docs 07/18] ha-manager: crs: remove note about manual changes to datacenter config Daniel Kral
2026-04-10  8:17   ` Shannon Sterz
2026-04-10 11:18     ` Daniel Kral
2026-04-10 11:37       ` Shannon Sterz
2026-04-09 11:41 ` [PATCH docs 08/18] ha-manager: crs: improve introduction Daniel Kral
2026-04-09 11:41 ` [PATCH docs 09/18] ha-manager: crs: introduce crs scheduling mode section Daniel Kral
2026-04-09 11:41 ` [PATCH docs 10/18] ha-manager: crs: generalize the description for basic and static load modes Daniel Kral
2026-04-09 11:41 ` [PATCH docs 11/18] ha-manager: crs: remove HA group config from scheduling points list Daniel Kral
2026-04-09 11:41 ` [PATCH docs 12/18] ha-manager: crs: use headings for the scheduling points Daniel Kral
2026-04-09 11:41 ` [PATCH docs 13/18] ha-manager: crs: reword the rebalance on start scheduling point Daniel Kral
2026-04-09 11:41 ` Daniel Kral [this message]
2026-04-09 11:41 ` [PATCH docs 15/18] ha-manager: crs: change crs modes to include all active guests Daniel Kral
2026-04-09 11:41 ` [PATCH docs 16/18] ha-manager: crs: add dynamic load scheduler Daniel Kral
2026-04-09 11:41 ` [PATCH docs 17/18] screenshots: update crs datacenter options screenshot Daniel Kral
2026-04-09 11:41 ` [PATCH docs 18/18] ha-manager: crs: add load balancer section Daniel Kral

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20260409114224.323102-15-d.kral@proxmox.com \
    --to=d.kral@proxmox.com \
    --cc=pve-devel@lists.proxmox.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.
Service provided by Proxmox Server Solutions GmbH | Privacy | Legal