Hi Xiong, The release notes are also in Github (both github.com/apache/kafka/ and github.com/apache/kafka-site) and we can fix them with a PR. Regarding your findings, what you say makes sense, and indeed the `/tmp` folder might need exec permissions.
Would you be up for a PR? Best, On Mon, Feb 17, 2025 at 5:42 PM Xiong Benson <bo.xi...@outlook.com> wrote: > Dear Kafka devs, > > The Kafka's 3.8.1 release note mentioned [KAFKA-17227< > https://issues.apache.org/jira/browse/KAFKA-17227>] - Apache Kafka 3.8.0 > /tmp exec permission where it brings me to > https://kafka.apache.org/documentation/#upgrade_381_notable whose content > is specifically for the kafka cluster(server). But this is not precise > enough for the issue. > > Below are my summarized missing points that are not covered by > https://kafka.apache.org/documentation/#upgrade_381_notable based on our > tests. > [http://apache-kafka.org/images/apache-kafka.png]< > https://kafka.apache.org/documentation/#upgrade_381_notable> > Apache Kafka<https://kafka.apache.org/documentation/#upgrade_381_notable> > Apache Kafka: A Distributed Streaming Platform. > kafka.apache.org > When "enable.metrics.push" is set to true for the kafka client and there > is also the client metric subscription configured. > > 1. > If there is no additional setting configured for the kafka client, then > /tmp(controlled by System property:"java.io.tmpdir") folder must have exec > permission, otherwise ZstdOutputStreamNoFinalizer will fail the > initialization and may break the relevent thread resulting in kafka client > not functioning correct.(I've tested this with /tmp without exec permission) > 2. > Client needs to set System property:"ZstdTempFolder" to specify a folder > with exec permission, otherwise ZstdOutputStreamNoFinalizer will also fail > to initialize and may break client function(I haven't tested this but based > on reading code for com.github.luben.zstd.util.Native). > > Above 1. is the most common scenario that Kaka client users will work > with. This is not a corner case and /tmp is also a commonly used > directory, making it a notable change for Kafka client using client metric > collection feature. > > > I wonder if my above finding is correct? If it is the case, why this > information is not accurately stated in the release note nor notable change > note consider its notable impact? Is it possible to add it somewhere or > patch the release note and notable change note? > > Looking forward to your help for the answer! > > > Thanks, > Benson > > -- [image: Aiven] <https://www.aiven.io> *Josep Prat* Engineering Director, Streaming Services, *Aiven* josep.p...@aiven.io | +491715557497 aiven.io <https://www.aiven.io> | <https://www.facebook.com/aivencloud> <https://www.linkedin.com/company/aiven/> <https://twitter.com/aiven_io> *Aiven Deutschland GmbH* Alexanderufer 3-7, 10117 Berlin Geschäftsführer: Oskari Saarenmaa, Hannu Valtonen, Anna Richardson, Kenneth Chen Amtsgericht Charlottenburg, HRB 209739 B
