[kafka] branch 2.8 updated: MINOR: document restriction against running multiple Streams apps on same state.dir (#10187)

[gu...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

guozhang pushed a commit to branch 2.8
in repository https://gitbox.apache.org/repos/asf/kafka.git


The following commit(s) were added to refs/heads/2.8 by this push:
     new d304532  MINOR: document restriction against running multiple Streams apps on same state.dir (#10187)
d304532 is described below

commit d30453251cd7d8483553e47d1515798650c36909
Author: A. Sophie Blee-Goldman <so...@confluent.io>
AuthorDate: Tue Feb 23 08:39:19 2021 -0800

    MINOR: document restriction against running multiple Streams apps on same state.dir (#10187)
    
    Reviewers: Leah Thomas <lt...@confluent.io>, Almog Gavra <al...@confluent.io>, Guozhang Wang <wa...@gmail.com>
---
 docs/streams/upgrade-guide.html | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/streams/upgrade-guide.html b/docs/streams/upgrade-guide.html
index 38138e1..5b8d581 100644
--- a/docs/streams/upgrade-guide.html
+++ b/docs/streams/upgrade-guide.html
@@ -87,6 +87,11 @@
         More details about the new config <code>StreamsConfig#TOPOLOGY_OPTIMIZATION</code> can be found in <a href="https://cwiki.apache.org/confluence/display/KAFKA/KIP-295%3A+Add+Streams+Configuration+Allowing+for+Optional+Topology+Optimization">KIP-295</a>.
     </p>
 
+    <p>
+      Note: Kafka Streams does not support running multiple instances of the same application as different processes on the same physical state directory. Starting in 2.8.0 (as well as 2.7.1 and 2.6.2),
+      this restriction will be enforced. If you wish to run more than one instance of Kafka Streams, you must configure them with different values for <code>state.dir</code>.
+    </p>
+
     <h3><a id="streams_api_changes_280" href="#streams_api_changes_280">Streams API changes in 2.8.0</a></h3>
     <p>
         We extended <code>StreamJoined</code> to include the options <code>withLoggingEnabled()</code> and <code>withLoggingDisabled()</code> in