This is an automated email from the ASF dual-hosted git repository.
showuon pushed a commit to branch 3.9
in repository https://gitbox.apache.org/repos/asf/kafka.git
The following commit(s) were added to refs/heads/3.9 by this push:
new 3cabf333ced MINOR: Update doc for tiered storage GA (#17088)
3cabf333ced is described below
commit 3cabf333cedf556b94f799c542b22c699a1476c9
Author: Luke Chen <[email protected]>
AuthorDate: Thu Sep 5 19:26:23 2024 +0900
MINOR: Update doc for tiered storage GA (#17088)
Reviewers: Satish Duggana <[email protected]>
---
docs/ops.html | 7 +++----
docs/upgrade.html | 14 ++++++++++----
2 files changed, 13 insertions(+), 8 deletions(-)
diff --git a/docs/ops.html b/docs/ops.html
index 5d39899c444..8f8b0b95a41 100644
--- a/docs/ops.html
+++ b/docs/ops.html
@@ -4222,8 +4222,6 @@ listeners=CONTROLLER://:9093
Please check <a
href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-405%3A+Kafka+Tiered+Storage";>KIP-405</a>
for more information.
</p>
-<p><b>Note: Tiered storage is considered as an early access feature, and is
not recommended for use in production environments</b></p>
-
<h4 class="anchor-heading"><a id="tiered_storage_config"
class="anchor-link"></a><a href="#tiered_storage_config">Configuration</a></h4>
<h5 class="anchor-heading"><a id="tiered_storage_config_broker"
class="anchor-link"></a><a href="#tiered_storage_config_broker">Broker
Configurations</a></h5>
@@ -4365,14 +4363,15 @@ $ bin/kafka-topics.sh --create --topic tieredTopic
--bootstrap-server localhost:
<h4 class="anchor-heading"><a id="tiered_storage_limitation"
class="anchor-link"></a><a
href="#tiered_storage_limitation">Limitations</a></h4>
-<p>While the early access release of Tiered Storage offers the opportunity to
try out this new feature, it is important to be aware of the following
limitations:
+<p>While the Tiered Storage works for most use cases, it is still important to
be aware of the following limitations:
<ul>
<li>No support for compacted topics</li>
<li>Deleting tiered storage enabled topics is required before disabling
tiered storage at the broker level</li>
<li>Admin actions related to tiered storage feature are only supported on
clients from version 3.0 onwards</li>
+ <li>No support for log segments missing producer snapshot file. It can
happen when topic is created before v2.8.0.</li>
</ul>
-<p>For more information, please check <a
href="https://cwiki.apache.org/confluence/display/KAFKA/Kafka+Tiered+Storage+Early+Access+Release+Notes";>Tiered
Storage Early Access Release Note</a>.
+<p>For more information, please check <a
href="https://cwiki.apache.org/confluence/display/KAFKA/Kafka+Tiered+Storage+GA+Release+Notes";>Kafka
Tiered Storage GA Release Notes</a>.
</p>
</script>
diff --git a/docs/upgrade.html b/docs/upgrade.html
index 049a8b4f9ae..faa4862154a 100644
--- a/docs/upgrade.html
+++ b/docs/upgrade.html
@@ -28,13 +28,19 @@
For example, this could be done via the <code>KAFKA_OPTS</code>
environment variable like follows: <code>export
KAFKA_OPTS="-DZstdTempFolder=/opt/kafka/tmp
-Dorg.xerial.snappy.tempdir=/opt/kafka/tmp"</code>.
This is a known issue for version 3.8.0 as well.
</li>
- <li>In KRaft mode, the tiered storage feature can be dynamically
disabled and then re-enabled on topic level.
- See <a
href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-950%3A++Tiered+Storage+Disablement";>KIP-950</a>
for more details.</li>
- <li>Tiered storage quota is implemented. Users can set an "upper
bound" on the rate at which logs are copied/read to/from the remote storage.
- See <a
href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-956+Tiered+Storage+Quotas";>KIP-956</a>
for more details.</li>
<li><code>unclean.leader.election.enable</code> config is supported in
KRaft. Compared with ZK mode, there is one behavior change in KRaft mode
when dynamically enabling
<code>unclean.leader.election.enable</code> config. Please check
<a
href="https://kafka.apache.org/documentation/#brokerconfigs_unclean.leader.election.enable";>here</a>
for more details.</li>
+ <li>Tiered storage is now a production ready feature. You can check
+ <a
href="https://cwiki.apache.org/confluence/display/KAFKA/Kafka+Tiered+Storage+GA+Release+Notes";>Kafka
Tiered Storage GA Release Notes</a> for more details.
+ The below enhancements are added in this release.
+ <ul>
+ <li>In KRaft mode, the tiered storage feature can be
dynamically disabled and then re-enabled on topic level.
+ See <a
href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-950%3A++Tiered+Storage+Disablement";>KIP-950</a>
for more details.</li>
+ <li>With the tiered storage quota feature, users can define a
maximum limit on the rate at which log segments are transferred to or retrieved
from the remote storage.
+ See <a
href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-956+Tiered+Storage+Quotas";>KIP-956</a>
for more details.</li>
+ </ul>
+ </li>
</ul>
<h4><a id="upgrade_3_8_0" href="#upgrade_3_8_0">Upgrading to 3.8.0 from any
version 0.8.x through 3.7.x</a></h4>
