From: Daniel Kral <d.kral@proxmox.com>
To: pve-devel@lists.proxmox.com
Subject: [PATCH docs 2/2] ha-manager: add requirements for ha-managed vms and containers
Date: Mon, 4 May 2026 13:11:55 +0200 [thread overview]
Message-ID: <20260504111159.183163-3-d.kral@proxmox.com> (raw)
In-Reply-To: <20260504111159.183163-1-d.kral@proxmox.com>
The HA Manager implicitly requires certain conditions that VMs and
containers need to fulfill to be handled correctly by the HA Manager.
Make the most important conditions explicit by writing them out in the
HA resources section and add a paragraph what role HA rules play here to
accomodate for HA resources, which do not meet all of these
requirements.
Signed-off-by: Daniel Kral <d.kral@proxmox.com>
---
ha-manager.adoc | 20 ++++++++++++++++++++
1 file changed, 20 insertions(+)
diff --git a/ha-manager.adoc b/ha-manager.adoc
index 6bf4e69..599622a 100644
--- a/ha-manager.adoc
+++ b/ha-manager.adoc
@@ -135,6 +135,26 @@ consists of the resource type and a type-specific ID, which is the VMID
for VMs and containers. For example, for the VM with VMID `100`, the
service ID is `vm:100`.
+In general, HA resources need to be setup in such a way, so that they are
+able to run on any cluster node. Therefore, a VM or container should meet
+the following requirements before it is added as an HA resource:
+
+* use options, which are compatible on all nodes
+
+* only use shared storage, which are available on all nodes
+
+* only use network interfaces, which are available on all nodes
+
+* only use device passthroughs, which are available on all nodes
+
+If a VM or container cannot fully meet these requirements, it can still
+be possible to configure them as HA resources by encoding the deviations
+from these requirements as xref:ha_manager_rules[HA rules]. For example,
+if the device passthrough for an HA resource is only available to some
+of the cluster nodes, then the HA resource must be constrained to these
+cluster nodes by a strict
+xref:ha_manager_node_affinity_rules[node affinity rule].
+
Management Tasks
----------------
--
2.47.3
next prev parent reply other threads:[~2026-05-04 11:12 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-05-04 11:11 [PATCH docs 0/2] add requirements for HA-managed resources Daniel Kral
2026-05-04 11:11 ` [PATCH docs 1/2] ha-manager: reword ha resources section Daniel Kral
2026-05-04 11:11 ` Daniel Kral [this message]
2026-05-04 18:40 ` applied: [PATCH docs 0/2] add requirements for HA-managed resources Thomas Lamprecht
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=20260504111159.183163-3-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