Re: [PATCH docs 07/18] ha-manager: crs: remove note about manual changes to datacenter config

Daniel Kral
2026-04-10T11:18:04Z

On Fri Apr 10, 2026 at 10:17 AM CEST, Shannon Sterz wrote:
> On Thu Apr 9, 2026 at 1:41 PM CEST, Daniel Kral wrote:
>> It is generally discouraged to change the datacenter configuration
>> manually, so it should not be mentioned in the admin guide.
>>
>> If there is a CLI utility to change these options in the future it can
>> be added here.
>>
>> Signed-off-by: Daniel Kral <d.kral@proxmox.com>
>> ---
>> ha-manager.adoc | 6 +-----
>> 1 file changed, 1 insertion(+), 5 deletions(-)
>>
>> diff --git a/ha-manager.adoc b/ha-manager.adoc
>> index aa2d362..07f6958 100644
>> --- a/ha-manager.adoc
>> +++ b/ha-manager.adoc
>> @@ -1415,11 +1415,7 @@ Cluster Resource Scheduling
>> The cluster resource scheduler (CRS) mode controls how HA selects nodes for the
>> recovery of a service as well as for migrations that are triggered by a
>> shutdown policy. The default mode is `basic`, you can change it in the Web UI
>> -(`Datacenter` -> `Options`), or directly in `datacenter.cfg`:
>> -
>> -----
>> -crs: ha=static
>> -----
>> +(`Datacenter` -> `Options`).
>>
>> [thumbnail="screenshot/gui-datacenter-options-crs.png"]
>>
>
> maybe not super "nice" but we could add the `pvesh` invocation here
> instead? we seem to do that in other places that lack a dedicated cli
> (e.g., [1]). so something like:
>
> pvesh set /cluster/options --crs "ha=static"
>
> [1]: https://pve.proxmox.com/pve-docs/pve-admin-guide.html#_add_mapping_for_shared_directories

Thanks for the idea!

Though I'm not entirely sure... I looked for instances where we show how
to set datacenter config options in the documentation: We also do this
for the style configuration [0] and for setting the default console [1].

For the latter [1] I think it's alright as it's a single enum value, but
for the style configuration [0] it might be destructive as it can
replace the already existing tag-style options as it's a property
string.

Suggesting people the pvesh command would hide that the 'crs' option is
a property string and might override other existing options. It would be
a bit more user-friendly if there's an user interface like `git config`,
where options can be set individually without interfering with other
options.

Hope this isn't to pedantic. What do you think?

[0] https://pve.proxmox.com/pve-docs/pve-admin-guide.html#_style_configuration
[1] https://pve.proxmox.com/pve-docs/pve-admin-guide.html#_shell_interface_for_the_proxmox_ve_api