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 12/18] ha-manager: crs: use headings for the scheduling points
Date: Thu,  9 Apr 2026 13:41:38 +0200	[thread overview]
Message-ID: <20260409114224.323102-13-d.kral@proxmox.com> (raw)
In-Reply-To: <20260409114224.323102-1-d.kral@proxmox.com>

This is in preparation to be able to extend the existing entries with
more information and allows users to make permalinks to the specific
scheduling points.

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

diff --git a/ha-manager.adoc b/ha-manager.adoc
index 716e77e..7d4bc44 100644
--- a/ha-manager.adoc
+++ b/ha-manager.adoc
@@ -1474,38 +1474,45 @@ CRS Scheduling Points
 In every HA Manager round, the CRS checks whether any HA resources need a new
 node placement, which can be caused by any of the following scheduling points:
 
-- HA resource recovery (always active). When a node with active HA resources
-  fails, all its HA resources need to be recovered to other nodes. The CRS
-  algorithm will be used here to balance that recovery over the remaining nodes.
+HA resource recovery (always active)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-- HA rule config changes (always active). If a rule emposes different
-  constraints on the HA resources, the HA stack will use the CRS algorithm to
-  find a new target node for the HA resources affected by these rules depending
-  on the type of the new rules:
+When a node with active HA resources fails, all its HA resources need to be
+recovered to other nodes. The CRS algorithm will be used here to balance that
+recovery over the remaining nodes.
 
-** Node affinity rules: If a node affinity rule is created or HA resources/nodes
-   are added to an existing node affinity rule, the HA stack will use the CRS
-   algorithm to ensure that these HA resources are assigned according to their
-   node and priority constraints.
+HA rule config changes (always active)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-** Positive resource affinity rules: If a positive resource affinity rule is
-   created or HA resources are added to an existing positive resource affinity
-   rule, the HA stack will use the CRS algorithm to ensure that these HA
-   resources are moved to a common node.
+If a rule emposes different constraints on the HA resources, the HA stack will
+use the CRS algorithm to find a new target node for the HA resources affected
+by these rules depending on the type of the new rules:
 
-** Negative resource affinity rules: If a negative resource affinity rule is
-   created or HA resources are added to an existing negative resource affinity
-   rule, the HA stack will use the CRS algorithm to ensure that these HA
-   resources are moved to separate nodes.
+- Node affinity rules: If a node affinity rule is created or HA resources/nodes
+  are added to an existing node affinity rule, the HA stack will use the CRS
+  algorithm to ensure that these HA resources are assigned according to their
+  node and priority constraints.
 
-- HA resources stopped -> start transition (opt-in). Requesting that a stopped
-  HA resource should be started is an good opportunity to check for the best
-  suited node as per the CRS algorithm, as moving stopped HA resources is
-  cheaper to do than moving them started, especially if their disk volumes
-  reside on shared storage. You can enable this by setting the
-  **`ha-rebalance-on-start`** CRS option in the datacenter config. You can
-  change that option also in the Web UI, under `Datacenter` -> `Options` ->
-  `Cluster Resource Scheduling`.
+- Positive resource affinity rules: If a positive resource affinity rule is
+  created or HA resources are added to an existing positive resource affinity
+  rule, the HA stack will use the CRS algorithm to ensure that these HA
+  resources are moved to a common node.
+
+- Negative resource affinity rules: If a negative resource affinity rule is
+  created or HA resources are added to an existing negative resource affinity
+  rule, the HA stack will use the CRS algorithm to ensure that these HA
+  resources are moved to separate nodes.
+
+HA resources stopped -> start transition (opt-in)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Requesting that a stopped HA resource should be started is an good opportunity
+to check for the best suited node as per the CRS algorithm, as moving stopped
+HA resources is cheaper to do than moving them started, especially if their
+disk volumes reside on shared storage. You can enable this by setting the
+**`ha-rebalance-on-start`** CRS option in the datacenter config. You can change
+that option also in the Web UI, under `Datacenter` -> `Options` -> `Cluster
+Resource Scheduling`.
 
 ifdef::manvolnum[]
 include::pve-copyright.adoc[]
-- 
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 ` Daniel Kral [this message]
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 ` [PATCH docs 14/18] ha-manager: crs: add more information about rebalance on start in its section Daniel Kral
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-13-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