[PATCH docs 13/18] ha-manager: crs: reword the rebalance on start scheduling point

Daniel Kral
2026-04-09T11:42:45Z

Make the action, which the CRS takes in the transition from the stopped
to request_start state, more apparent in the heading as well describe
what it does achieve in its description.

The crs option is not stylized as bold anymore, because it distracts
from the rest of the text and is already highlighted by the different
color as well as the use of a monospaced font.

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

diff --git a/ha-manager.adoc b/ha-manager.adoc
index 7d4bc44..682e254 100644
--- a/ha-manager.adoc
+++ b/ha-manager.adoc
@@ -1503,16 +1503,15 @@ by these rules depending on the type of the new rules:
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)
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+HA resource rebalance on start (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`.
+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.
+
+This setting can be enabled with the CRS option `ha-rebalance-on-start` in the
+web interface under `Datacenter` -> `Options` -> `Cluster Resource Scheduling`.

ifdef::manvolnum[]
include::pve-copyright.adoc[]
--
2.47.3