[pve-devel] [PATCH docs v2 3/5] update static files to include use-location-rules feature flag

Daniel Kral d.kral at proxmox.com
Fri Jun 20 16:31:41 CEST 2025


Signed-off-by: Daniel Kral <d.kral at proxmox.com>
---
This patch is more of a show-case how the static files changed.

changes since v1:
    - NEW!

 api-viewer/apidata.js      | 9 ++++++++-
 datacenter.cfg.5-opts.adoc | 6 +++++-
 2 files changed, 13 insertions(+), 2 deletions(-)

diff --git a/api-viewer/apidata.js b/api-viewer/apidata.js
index 9f0f28a..c52afc8 100644
--- a/api-viewer/apidata.js
+++ b/api-viewer/apidata.js
@@ -14800,13 +14800,20 @@ const apiSchema = [
                                     "conditional",
                                     "migrate"
                                  ],
+                                 "optional" : 1,
                                  "type" : "string",
                                  "verbose_description" : "Describes the policy for handling HA services on poweroff or reboot of a node. Freeze will always freeze services which are still located on the node on shutdown, those services won't be recovered by the HA manager. Failover will not mark the services as frozen and thus the services will get recovered to other nodes, if the shutdown node does not come up again quickly (< 1min). 'conditional' chooses automatically depending on the type of shutdown, i.e., on a reboot the service will be frozen but on a poweroff the service will stay as is, and thus get recovered after about 2 minutes. Migrate will try to move all running services to another node when a reboot or shutdown was triggered. The poweroff process will only continue once no running services are located on the node anymore. If the node comes up again, the service will be moved back to the previously powered-off node, at least if no other migration, reloaction or recovery took place."
+                              },
+                              "use-location-rules" : {
+                                 "default" : 0,
+                                 "description" : "Whether HA Location rules should be used instead of HA groups.",
+                                 "optional" : 1,
+                                 "type" : "boolean"
                               }
                            },
                            "optional" : 1,
                            "type" : "string",
-                           "typetext" : "shutdown_policy=<enum>"
+                           "typetext" : "[shutdown_policy=<enum>] [,use-location-rules=<1|0>]"
                         },
                         "http_proxy" : {
                            "description" : "Specify external http proxy which is used for downloads (example: 'http://username:password@host:port/')",
diff --git a/datacenter.cfg.5-opts.adoc b/datacenter.cfg.5-opts.adoc
index 7a42b12..8001870 100644
--- a/datacenter.cfg.5-opts.adoc
+++ b/datacenter.cfg.5-opts.adoc
@@ -56,7 +56,7 @@ Set the fencing mode of the HA cluster. Hardware mode needs a valid configuratio
 +
 WARNING: 'hardware' and 'both' are EXPERIMENTAL & WIP
 
-`ha`: `shutdown_policy=<enum>` ::
+`ha`: `[shutdown_policy=<enum>] [,use-location-rules=<1|0>]` ::
 
 Cluster wide HA settings.
 
@@ -64,6 +64,10 @@ Cluster wide HA settings.
 
 Describes the policy for handling HA services on poweroff or reboot of a node. Freeze will always freeze services which are still located on the node on shutdown, those services won't be recovered by the HA manager. Failover will not mark the services as frozen and thus the services will get recovered to other nodes, if the shutdown node does not come up again quickly (< 1min). 'conditional' chooses automatically depending on the type of shutdown, i.e., on a reboot the service will be frozen but on a poweroff the service will stay as is, and thus get recovered after about 2 minutes. Migrate will try to move all running services to another node when a reboot or shutdown was triggered. The poweroff process will only continue once no running services are located on the node anymore. If the node comes up again, the service will be moved back to the previously powered-off node, at least if no other migration, reloaction or recovery took place.
 
+`use-location-rules`=`<boolean>` ('default =' `0`);;
+
+Whether HA Location rules should be used instead of HA groups.
+
 `http_proxy`: `http://.*` ::
 
 Specify external http proxy which is used for downloads (example: 'http://username:password@host:port/')
-- 
2.39.5





More information about the pve-devel mailing list