From 186d579c9d0ee041e877bf0698a43d1516cc0585 Mon Sep 17 00:00:00 2001 From: Nicolae Vartolomei Date: Wed, 31 Jul 2024 13:01:49 +0100 Subject: [PATCH] config: update docs for cloud_storage_azure_hierarchical_namespace_enabled Since https://github.com/redpanda-data/redpanda/pull/17840/ we should be able to always infer the correct setting. Update the docs accordingly to avoid confusing users into thinking that they must set this setting if `cloud_storage_azure_shared_key` is not set. (cherry picked from commit f32c5419d9e8a8f68f3e9951a104648c16721008) --- src/v/config/configuration.cc | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/src/v/config/configuration.cc b/src/v/config/configuration.cc index 84179000d29b0..503616fdbdf64 100644 --- a/src/v/config/configuration.cc +++ b/src/v/config/configuration.cc @@ -2159,12 +2159,13 @@ configuration::configuration() , cloud_storage_azure_hierarchical_namespace_enabled( *this, "cloud_storage_azure_hierarchical_namespace_enabled", - "Whether or not Azure Hierarchical Namespaces are enabled on the " - "cloud_storage_azure_storage_account. If this property is not set, " - "cloud_storage_azure_shared_key must be set, and each node will try to " - "determine at startup if HNS is enabled. Setting this property to True " - "will disable the check and assume HNS is active. Setting to False will " - "disable the check and assume that HNS is not active.", + "Force Redpanda to use or not use an \"Azure Data Lake Storage Gen2 " + "hierarchical namespace\" compliant client. When this property is not " + "set, each node infers at startup if HNS is enabled. When set to True, " + "this property disables the check and assumes HNS is enabled. When set " + "to False, this property disables the check and assumes HNS is not " + "enabled. This setting should be used only in emergencies where Redpanda " + "fails to detect the correct HNS status.", {.needs_restart = needs_restart::yes, .visibility = visibility::tunable}, std::nullopt) , cloud_storage_upload_ctrl_update_interval_ms(