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
next prev 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 a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox