From 6f28e8166ad3689480dfb909124d67722b608845 Mon Sep 17 00:00:00 2001 From: vbotbuildovich <62446873+vbotbuildovich@users.noreply.github.com> Date: Fri, 22 May 2026 12:46:59 +0000 Subject: [PATCH 1/3] auto-docs: Update property docs for v26.1.9 --- antora.yml | 4 +- docs-data/property-overrides.json | 3 + ...a-property-changes-v26.1.7-to-v26.1.8.json | 43 --------------- ...a-property-changes-v26.1.8-to-v26.1.9.json | 43 +++++++++++++++ ....json => redpanda-properties-v26.1.9.json} | 26 +++++++++ .../properties/cluster-properties.adoc | 55 +++++++++++++++++++ 6 files changed, 129 insertions(+), 45 deletions(-) delete mode 100644 docs-data/redpanda-property-changes-v26.1.7-to-v26.1.8.json create mode 100644 docs-data/redpanda-property-changes-v26.1.8-to-v26.1.9.json rename modules/reference/attachments/{redpanda-properties-v26.1.8.json => redpanda-properties-v26.1.9.json} (99%) diff --git a/antora.yml b/antora.yml index f8607e1ab1..d5bd56ef68 100644 --- a/antora.yml +++ b/antora.yml @@ -17,8 +17,8 @@ asciidoc: # Fallback versions # We try to fetch the latest versions from GitHub at build time # -- - full-version: 26.1.8 - latest-redpanda-tag: 'v26.1.8' + full-version: 26.1.9 + latest-redpanda-tag: 'v26.1.9' latest-console-tag: 'v3.3.1' latest-release-commit: 'ebee215fdb2b8004735c6f800e532564cdcc05e1' latest-operator-version: 'v2.3.8-24.3.6' diff --git a/docs-data/property-overrides.json b/docs-data/property-overrides.json index c45533cf89..dd0828afe2 100644 --- a/docs-data/property-overrides.json +++ b/docs-data/property-overrides.json @@ -879,6 +879,9 @@ "description": "Enable creating shadow links from this cluster to a remote source cluster for data replication.", "config_scope": "cluster" }, + "features_auto_finalization": { + "version": "v26.1.9" + }, "fetch_max_read_concurrency": { "version": "v25.3.3" }, diff --git a/docs-data/redpanda-property-changes-v26.1.7-to-v26.1.8.json b/docs-data/redpanda-property-changes-v26.1.7-to-v26.1.8.json deleted file mode 100644 index 4f7d42a771..0000000000 --- a/docs-data/redpanda-property-changes-v26.1.7-to-v26.1.8.json +++ /dev/null @@ -1,43 +0,0 @@ -{ - "comparison": { - "oldVersion": "v26.1.7", - "newVersion": "v26.1.8", - "timestamp": "2026-05-14T16:16:34.287Z" - }, - "summary": { - "newProperties": 1, - "changedDefaults": 0, - "changedDescriptions": 0, - "changedTypes": 0, - "deprecatedProperties": 0, - "removedDeprecatedProperties": 0, - "removedProperties": 0, - "emptyDescriptions": 2 - }, - "details": { - "newProperties": [ - { - "name": "iceberg_rest_catalog_credentials_host", - "type": "string", - "default": null, - "description": "The hostname to connect to for retrieving role based credentials for the Iceberg REST catalog. Derived from iceberg_rest_catalog_credentials_source if not set. Only required when using IAM role based access on AWS; does not apply to OAuth-based authentication schemes. Independent of cloud_storage_credentials_host." - } - ], - "changedDefaults": [], - "changedDescriptions": [], - "changedTypes": [], - "deprecatedProperties": [], - "removedDeprecatedProperties": [], - "removedProperties": [], - "emptyDescriptions": [ - { - "name": "redpanda.remote.allowgaps", - "type": "boolean" - }, - { - "name": "redpanda.virtual.cluster.id", - "type": "string" - } - ] - } -} \ No newline at end of file diff --git a/docs-data/redpanda-property-changes-v26.1.8-to-v26.1.9.json b/docs-data/redpanda-property-changes-v26.1.8-to-v26.1.9.json new file mode 100644 index 0000000000..3305b105a7 --- /dev/null +++ b/docs-data/redpanda-property-changes-v26.1.8-to-v26.1.9.json @@ -0,0 +1,43 @@ +{ + "comparison": { + "oldVersion": "v26.1.8", + "newVersion": "v26.1.9", + "timestamp": "2026-05-22T12:46:58.695Z" + }, + "summary": { + "newProperties": 1, + "changedDefaults": 0, + "changedDescriptions": 0, + "changedTypes": 0, + "deprecatedProperties": 0, + "removedDeprecatedProperties": 0, + "removedProperties": 0, + "emptyDescriptions": 2 + }, + "details": { + "newProperties": [ + { + "name": "features_auto_finalization", + "type": "boolean", + "default": true, + "description": "Whether the cluster active logical version is advanced automatically once all nodes have been upgraded (true), or only in response to an explicit request via the Admin API (false). When false, the cluster remains able to downgrade to the previous version until finalization is requested. Setting this to false is an Enterprise feature and requires a valid license. Note: if upgrade was performed with this set to false and the cluster is ready to finalize, flipping this to true does not reliably trigger finalization. Leave this set to false and use the Admin API to finalize; once the upgrade is complete this can be set back to true to restore automatic finalization for future upgrades." + } + ], + "changedDefaults": [], + "changedDescriptions": [], + "changedTypes": [], + "deprecatedProperties": [], + "removedDeprecatedProperties": [], + "removedProperties": [], + "emptyDescriptions": [ + { + "name": "redpanda.remote.allowgaps", + "type": "boolean" + }, + { + "name": "redpanda.virtual.cluster.id", + "type": "string" + } + ] + } +} \ No newline at end of file diff --git a/modules/reference/attachments/redpanda-properties-v26.1.8.json b/modules/reference/attachments/redpanda-properties-v26.1.9.json similarity index 99% rename from modules/reference/attachments/redpanda-properties-v26.1.8.json rename to modules/reference/attachments/redpanda-properties-v26.1.9.json index 5b72a71753..02a8431b14 100644 --- a/modules/reference/attachments/redpanda-properties-v26.1.8.json +++ b/modules/reference/attachments/redpanda-properties-v26.1.9.json @@ -6177,6 +6177,31 @@ "type": "boolean", "visibility": "tunable" }, + "features_auto_finalization": { + "c_type": "bool", + "cloud_byoc_only": false, + "cloud_editable": false, + "cloud_readonly": false, + "cloud_supported": false, + "config_scope": "cluster", + "default": true, + "defined_in": "src/v/config/configuration.cc", + "description": "Whether the cluster active logical version is advanced automatically once all nodes have been upgraded (true), or only in response to an explicit request via the Admin API (false). When false, the cluster remains able to downgrade to the previous version until finalization is requested. Setting this to false is an Enterprise feature and requires a valid license. Note: if upgrade was performed with this set to false and the cluster is ready to finalize, flipping this to true does not reliably trigger finalization. Leave this set to false and use the Admin API to finalize; once the upgrade is complete this can be set back to true to restore automatic finalization for future upgrades.", + "enterprise_constructor": "restricted_only", + "enterprise_restricted_value": [ + "false" + ], + "enterprise_value": [ + "false" + ], + "is_deprecated": false, + "is_enterprise": true, + "name": "features_auto_finalization", + "needs_restart": false, + "nullable": false, + "type": "boolean", + "visibility": "user" + }, "fetch_max_bytes": { "c_type": "size_t", "cloud_byoc_only": false, @@ -7190,6 +7215,7 @@ "needs_restart": true, "nullable": true, "type": "string", + "version": "v26.1.8", "visibility": "user" }, "iceberg_rest_catalog_credentials_source": { diff --git a/modules/reference/partials/properties/cluster-properties.adoc b/modules/reference/partials/properties/cluster-properties.adoc index 998af7ce72..79a2e58ddc 100644 --- a/modules/reference/partials/properties/cluster-properties.adoc +++ b/modules/reference/partials/properties/cluster-properties.adoc @@ -6266,6 +6266,57 @@ endif::[] |=== +=== features_auto_finalization + +Whether the cluster active logical version is advanced automatically once all nodes have been upgraded (true), or only in response to an explicit request via the Admin API (false). When false, the cluster remains able to downgrade to the previous version until finalization is requested. Setting this to false is an Enterprise feature and requires a valid license. Note: if upgrade was performed with this set to false and the cluster is ready to finalize, flipping this to true does not reliably trigger finalization. Leave this set to false and use the Admin API to finalize; once the upgrade is complete this can be set back to true to restore automatic finalization for future upgrades. + +ifndef::env-cloud[] +.Enterprise license required +[NOTE] +==== +The following values require an Enterprise license: `false` + +For license details, see xref:get-started:licensing/index.adoc[Redpanda Licensing]. +==== +endif::[] + +[cols="1s,2a"] +|=== +| Property | Value + +| Type +| `boolean` + + + +| Default +| +ifdef::env-cloud[] +Available in the Redpanda Cloud Console +endif::[] +ifndef::env-cloud[] +`true` +endif::[] + +| Nullable +| No + +| Requires restart +| No + +ifndef::env-cloud[] +| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore] +| Yes +endif::[] + +ifndef::env-cloud[] +| Visibility +| User +endif::[] + +|=== + + === fetch_max_bytes Maximum number of bytes returned in a fetch request. @@ -8378,6 +8429,10 @@ endif::[] === iceberg_rest_catalog_credentials_host +ifndef::env-cloud[] +*Introduced in v26.1.8* +endif::[] + The hostname to connect to for retrieving role based credentials for the Iceberg REST catalog. Derived from iceberg_rest_catalog_credentials_source if not set. Only required when using IAM role based access on AWS; does not apply to OAuth-based authentication schemes. Independent of cloud_storage_credentials_host. [cols="1s,2a"] From f10556d735bcb8e942b43f599d619faf8abc652f Mon Sep 17 00:00:00 2001 From: JakeSCahill Date: Mon, 1 Jun 2026 08:48:12 +0100 Subject: [PATCH 2/3] fix: Remove redundant license info from features_auto_finalization description The description already has a separate NOTE block for the enterprise license requirement, so the inline mention was redundant. Added a description override in property-overrides.json and updated all generated files to use the cleaner description. Co-Authored-By: Claude Opus 4.5 --- docs-data/property-overrides.json | 3 ++- docs-data/redpanda-property-changes-v26.1.8-to-v26.1.9.json | 2 +- modules/reference/attachments/redpanda-properties-v26.1.9.json | 2 +- modules/reference/partials/properties/cluster-properties.adoc | 2 +- 4 files changed, 5 insertions(+), 4 deletions(-) diff --git a/docs-data/property-overrides.json b/docs-data/property-overrides.json index 7d97b88fe2..869d862104 100644 --- a/docs-data/property-overrides.json +++ b/docs-data/property-overrides.json @@ -882,7 +882,8 @@ "config_scope": "cluster" }, "features_auto_finalization": { - "version": "v26.1.9" + "version": "v26.1.9", + "description": "Whether the cluster active logical version is advanced automatically once all nodes have been upgraded (true), or only in response to an explicit request via the Admin API (false). When false, the cluster remains able to downgrade to the previous version until finalization is requested. Note: if upgrade was performed with this set to false and the cluster is ready to finalize, flipping this to true does not reliably trigger finalization. Leave this set to false and use the Admin API to finalize; once the upgrade is complete this can be set back to true to restore automatic finalization for future upgrades." }, "fetch_max_read_concurrency": { "version": "v25.3.3" diff --git a/docs-data/redpanda-property-changes-v26.1.8-to-v26.1.9.json b/docs-data/redpanda-property-changes-v26.1.8-to-v26.1.9.json index 3305b105a7..9ee522cace 100644 --- a/docs-data/redpanda-property-changes-v26.1.8-to-v26.1.9.json +++ b/docs-data/redpanda-property-changes-v26.1.8-to-v26.1.9.json @@ -20,7 +20,7 @@ "name": "features_auto_finalization", "type": "boolean", "default": true, - "description": "Whether the cluster active logical version is advanced automatically once all nodes have been upgraded (true), or only in response to an explicit request via the Admin API (false). When false, the cluster remains able to downgrade to the previous version until finalization is requested. Setting this to false is an Enterprise feature and requires a valid license. Note: if upgrade was performed with this set to false and the cluster is ready to finalize, flipping this to true does not reliably trigger finalization. Leave this set to false and use the Admin API to finalize; once the upgrade is complete this can be set back to true to restore automatic finalization for future upgrades." + "description": "Whether the cluster active logical version is advanced automatically once all nodes have been upgraded (true), or only in response to an explicit request via the Admin API (false). When false, the cluster remains able to downgrade to the previous version until finalization is requested. Note: if upgrade was performed with this set to false and the cluster is ready to finalize, flipping this to true does not reliably trigger finalization. Leave this set to false and use the Admin API to finalize; once the upgrade is complete this can be set back to true to restore automatic finalization for future upgrades." } ], "changedDefaults": [], diff --git a/modules/reference/attachments/redpanda-properties-v26.1.9.json b/modules/reference/attachments/redpanda-properties-v26.1.9.json index 02a8431b14..d7e047a705 100644 --- a/modules/reference/attachments/redpanda-properties-v26.1.9.json +++ b/modules/reference/attachments/redpanda-properties-v26.1.9.json @@ -6186,7 +6186,7 @@ "config_scope": "cluster", "default": true, "defined_in": "src/v/config/configuration.cc", - "description": "Whether the cluster active logical version is advanced automatically once all nodes have been upgraded (true), or only in response to an explicit request via the Admin API (false). When false, the cluster remains able to downgrade to the previous version until finalization is requested. Setting this to false is an Enterprise feature and requires a valid license. Note: if upgrade was performed with this set to false and the cluster is ready to finalize, flipping this to true does not reliably trigger finalization. Leave this set to false and use the Admin API to finalize; once the upgrade is complete this can be set back to true to restore automatic finalization for future upgrades.", + "description": "Whether the cluster active logical version is advanced automatically once all nodes have been upgraded (true), or only in response to an explicit request via the Admin API (false). When false, the cluster remains able to downgrade to the previous version until finalization is requested. Note: if upgrade was performed with this set to false and the cluster is ready to finalize, flipping this to true does not reliably trigger finalization. Leave this set to false and use the Admin API to finalize; once the upgrade is complete this can be set back to true to restore automatic finalization for future upgrades.", "enterprise_constructor": "restricted_only", "enterprise_restricted_value": [ "false" diff --git a/modules/reference/partials/properties/cluster-properties.adoc b/modules/reference/partials/properties/cluster-properties.adoc index e395bb2177..539f797aec 100644 --- a/modules/reference/partials/properties/cluster-properties.adoc +++ b/modules/reference/partials/properties/cluster-properties.adoc @@ -6268,7 +6268,7 @@ endif::[] === features_auto_finalization -Whether the cluster active logical version is advanced automatically once all nodes have been upgraded (true), or only in response to an explicit request via the Admin API (false). When false, the cluster remains able to downgrade to the previous version until finalization is requested. Setting this to false is an Enterprise feature and requires a valid license. Note: if upgrade was performed with this set to false and the cluster is ready to finalize, flipping this to true does not reliably trigger finalization. Leave this set to false and use the Admin API to finalize; once the upgrade is complete this can be set back to true to restore automatic finalization for future upgrades. +Whether the cluster active logical version is advanced automatically once all nodes have been upgraded (true), or only in response to an explicit request via the Admin API (false). When false, the cluster remains able to downgrade to the previous version until finalization is requested. Note: if upgrade was performed with this set to false and the cluster is ready to finalize, flipping this to true does not reliably trigger finalization. Leave this set to false and use the Admin API to finalize; once the upgrade is complete this can be set back to true to restore automatic finalization for future upgrades. ifndef::env-cloud[] .Enterprise license required From 8ccd89b60934bb95285f7abba3a29584700a0497 Mon Sep 17 00:00:00 2001 From: JakeSCahill Date: Mon, 1 Jun 2026 09:57:20 +0100 Subject: [PATCH 3/3] style: Improve features_auto_finalization description for style guide compliance - Use active voice instead of passive voice - Address the reader with "you" (second person) - Replace informal "flipping" with "setting this property" - Improve overall readability while preserving technical accuracy Co-Authored-By: Claude Opus 4.5 --- docs-data/property-overrides.json | 2 +- docs-data/redpanda-property-changes-v26.1.8-to-v26.1.9.json | 2 +- modules/reference/attachments/redpanda-properties-v26.1.9.json | 2 +- modules/reference/partials/properties/cluster-properties.adoc | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs-data/property-overrides.json b/docs-data/property-overrides.json index 869d862104..85b9ec4ced 100644 --- a/docs-data/property-overrides.json +++ b/docs-data/property-overrides.json @@ -883,7 +883,7 @@ }, "features_auto_finalization": { "version": "v26.1.9", - "description": "Whether the cluster active logical version is advanced automatically once all nodes have been upgraded (true), or only in response to an explicit request via the Admin API (false). When false, the cluster remains able to downgrade to the previous version until finalization is requested. Note: if upgrade was performed with this set to false and the cluster is ready to finalize, flipping this to true does not reliably trigger finalization. Leave this set to false and use the Admin API to finalize; once the upgrade is complete this can be set back to true to restore automatic finalization for future upgrades." + "description": "Controls whether Redpanda advances the cluster's active logical version automatically after you upgrade all nodes (`true`), or only when you explicitly request finalization through the Admin API (`false`). When set to `false`, you can downgrade to the previous version until you request finalization. Note: If you performed the upgrade with this set to `false` and the cluster is ready to finalize, setting this property to `true` does not reliably trigger finalization. Keep this set to `false` and use the Admin API to finalize. After the upgrade completes, you can set this back to `true` to restore automatic finalization for future upgrades." }, "fetch_max_read_concurrency": { "version": "v25.3.3" diff --git a/docs-data/redpanda-property-changes-v26.1.8-to-v26.1.9.json b/docs-data/redpanda-property-changes-v26.1.8-to-v26.1.9.json index 9ee522cace..d44a130e30 100644 --- a/docs-data/redpanda-property-changes-v26.1.8-to-v26.1.9.json +++ b/docs-data/redpanda-property-changes-v26.1.8-to-v26.1.9.json @@ -20,7 +20,7 @@ "name": "features_auto_finalization", "type": "boolean", "default": true, - "description": "Whether the cluster active logical version is advanced automatically once all nodes have been upgraded (true), or only in response to an explicit request via the Admin API (false). When false, the cluster remains able to downgrade to the previous version until finalization is requested. Note: if upgrade was performed with this set to false and the cluster is ready to finalize, flipping this to true does not reliably trigger finalization. Leave this set to false and use the Admin API to finalize; once the upgrade is complete this can be set back to true to restore automatic finalization for future upgrades." + "description": "Controls whether Redpanda advances the cluster's active logical version automatically after you upgrade all nodes (`true`), or only when you explicitly request finalization through the Admin API (`false`). When set to `false`, you can downgrade to the previous version until you request finalization. Note: If you performed the upgrade with this set to `false` and the cluster is ready to finalize, setting this property to `true` does not reliably trigger finalization. Keep this set to `false` and use the Admin API to finalize. After the upgrade completes, you can set this back to `true` to restore automatic finalization for future upgrades." } ], "changedDefaults": [], diff --git a/modules/reference/attachments/redpanda-properties-v26.1.9.json b/modules/reference/attachments/redpanda-properties-v26.1.9.json index d7e047a705..b3c4b5fb6b 100644 --- a/modules/reference/attachments/redpanda-properties-v26.1.9.json +++ b/modules/reference/attachments/redpanda-properties-v26.1.9.json @@ -6186,7 +6186,7 @@ "config_scope": "cluster", "default": true, "defined_in": "src/v/config/configuration.cc", - "description": "Whether the cluster active logical version is advanced automatically once all nodes have been upgraded (true), or only in response to an explicit request via the Admin API (false). When false, the cluster remains able to downgrade to the previous version until finalization is requested. Note: if upgrade was performed with this set to false and the cluster is ready to finalize, flipping this to true does not reliably trigger finalization. Leave this set to false and use the Admin API to finalize; once the upgrade is complete this can be set back to true to restore automatic finalization for future upgrades.", + "description": "Controls whether Redpanda advances the cluster's active logical version automatically after you upgrade all nodes (`true`), or only when you explicitly request finalization through the Admin API (`false`). When set to `false`, you can downgrade to the previous version until you request finalization. Note: If you performed the upgrade with this set to `false` and the cluster is ready to finalize, setting this property to `true` does not reliably trigger finalization. Keep this set to `false` and use the Admin API to finalize. After the upgrade completes, you can set this back to `true` to restore automatic finalization for future upgrades.", "enterprise_constructor": "restricted_only", "enterprise_restricted_value": [ "false" diff --git a/modules/reference/partials/properties/cluster-properties.adoc b/modules/reference/partials/properties/cluster-properties.adoc index 539f797aec..b9836dd2c3 100644 --- a/modules/reference/partials/properties/cluster-properties.adoc +++ b/modules/reference/partials/properties/cluster-properties.adoc @@ -6268,7 +6268,7 @@ endif::[] === features_auto_finalization -Whether the cluster active logical version is advanced automatically once all nodes have been upgraded (true), or only in response to an explicit request via the Admin API (false). When false, the cluster remains able to downgrade to the previous version until finalization is requested. Note: if upgrade was performed with this set to false and the cluster is ready to finalize, flipping this to true does not reliably trigger finalization. Leave this set to false and use the Admin API to finalize; once the upgrade is complete this can be set back to true to restore automatic finalization for future upgrades. +Controls whether Redpanda advances the cluster's active logical version automatically after you upgrade all nodes (`true`), or only when you explicitly request finalization through the Admin API (`false`). When set to `false`, you can downgrade to the previous version until you request finalization. Note: If you performed the upgrade with this set to `false` and the cluster is ready to finalize, setting this property to `true` does not reliably trigger finalization. Keep this set to `false` and use the Admin API to finalize. After the upgrade completes, you can set this back to `true` to restore automatic finalization for future upgrades. ifndef::env-cloud[] .Enterprise license required