Repository: kafka Updated Branches: refs/heads/trunk e6f9b9e47 -> fc4ef4791
KAFKA-2645: Document potentially breaking changes in the release note⦠â¦s for 0.9.0 Author: Grant Henke <granthe...@gmail.com> Reviewers: Gwen Shapira, Guozhang Wang Closes #337 from granthenke/docs Project: http://git-wip-us.apache.org/repos/asf/kafka/repo Commit: http://git-wip-us.apache.org/repos/asf/kafka/commit/fc4ef479 Tree: http://git-wip-us.apache.org/repos/asf/kafka/tree/fc4ef479 Diff: http://git-wip-us.apache.org/repos/asf/kafka/diff/fc4ef479 Branch: refs/heads/trunk Commit: fc4ef479109fbae12470e44f8c12fe9e5f41e179 Parents: e6f9b9e Author: Grant Henke <granthe...@gmail.com> Authored: Tue Oct 27 07:43:19 2015 -0700 Committer: Gwen Shapira <csh...@gmail.com> Committed: Tue Oct 27 07:43:19 2015 -0700 ---------------------------------------------------------------------- docs/configuration.html | 6 +++--- docs/documentation.html | 10 +++++----- docs/upgrade.html | 28 +++++++++++++++++++++++----- 3 files changed, 31 insertions(+), 13 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/kafka/blob/fc4ef479/docs/configuration.html ---------------------------------------------------------------------- diff --git a/docs/configuration.html b/docs/configuration.html index c3cc13e..41cf995 100644 --- a/docs/configuration.html +++ b/docs/configuration.html @@ -5,9 +5,9 @@ The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at - + http://www.apache.org/licenses/LICENSE-2.0 - + Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -445,7 +445,7 @@ ZooKeeper also allows you to add a "chroot" path which will make all kafka data </tr> <tr> <td>inter.broker.protocol.version</td> - <td>0.8.3</td> + <td>0.9.0</td> <td>Version of the protocol brokers will use to communicate with each other. This will default for the current version of the broker, but may need to be set to older versions during a rolling upgrade process. In that scenario, upgraded brokers will use the older version of the protocol and therefore will be able to communicate with brokers that were not yet upgraded. See <a href="#upgrade">upgrade section</a> for more details.</td> </tr> </tbody></table> http://git-wip-us.apache.org/repos/asf/kafka/blob/fc4ef479/docs/documentation.html ---------------------------------------------------------------------- diff --git a/docs/documentation.html b/docs/documentation.html index 8f9b081..860f276 100644 --- a/docs/documentation.html +++ b/docs/documentation.html @@ -5,9 +5,9 @@ The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at - + http://www.apache.org/licenses/LICENSE-2.0 - + Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -17,10 +17,10 @@ <!--#include virtual="../includes/header.html" --> -<h1>Kafka 0.8.2 Documentation</h1> -Prior releases: <a href="/07/documentation.html">0.7.x</a>, <a href="/08/documentation.html">0.8.0</a>, <a href="/081/documentation.html">0.8.1.X</a>. +<h1>Kafka 0.9.0 Documentation</h1> +Prior releases: <a href="/07/documentation.html">0.7.x</a>, <a href="/08/documentation.html">0.8.0</a>, <a href="/081/documentation.html">0.8.1.X</a>, <a href="/082/documentation.html">0.8.2.X</a>. </ul> - + <ul class="toc"> <li><a href="#gettingStarted">1. Getting Started</a> <ul> http://git-wip-us.apache.org/repos/asf/kafka/blob/fc4ef479/docs/upgrade.html ---------------------------------------------------------------------- diff --git a/docs/upgrade.html b/docs/upgrade.html index 4b7033a..69bcdc1 100644 --- a/docs/upgrade.html +++ b/docs/upgrade.html @@ -5,9 +5,9 @@ The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at - + http://www.apache.org/licenses/LICENSE-2.0 - + Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. @@ -17,13 +17,13 @@ <h3><a id="upgrade">1.5 Upgrading From Previous Versions</a></h3> -<h4>Upgrading from 0.8.0, 0.8.1.X or 0.8.2.X to 0.8.3.0</h4> +<h4>Upgrading from 0.8.0, 0.8.1.X or 0.8.2.X to 0.9.0.0</h4> -0.8.3.0 has an inter-broker protocol change from previous versions. For a rolling upgrade: +0.9.0.0 has an inter-broker protocol change from previous versions. For a rolling upgrade: <ol> <li> Update server.properties file on all brokers and add the following property: inter.broker.protocol.version=0.8.2.X </li> <li> Upgrade the brokers. This can be done a broker at a time by simply bringing it down, updating the code, and restarting it. </li> - <li> Once the entire cluster is upgraded, bump the protocol version by editing inter.broker.protocol.version and setting it to 0.8.3.0.</li> + <li> Once the entire cluster is upgraded, bump the protocol version by editing inter.broker.protocol.version and setting it to 0.9.0.0.</li> <li> Restart the brokers one by one for the new protocol version to take effect </li> </ol> @@ -31,6 +31,24 @@ Note: If you are willing to accept downtime, you can simply take all the brokers Note: Bumping the protocol version and restarting can be done any time after the brokers were upgraded. It does not have to be immediately after. +<h5>Potential breaking changes in 0.9.0.0</h5> + +<ul> + <li> Java 1.6 is no longer supported. </li> + <li> Tools packaged under <em>org.apache.kafka.clients.tools.*</em> have been moved to <em>org.apache.kafka.tools.*</em>. All included scripts will still function as usual, only custom code directly importing these classes will be affected. </li> + <li> The default Kafka JVM performance options (KAFKA_JVM_PERFORMANCE_OPTS) have been changed in kafka-run-class.sh. </li> + <li> The kafka-topics.sh script (kafka.admin.TopicCommand) now exits with non-zero exit code on failure. </li> + <li> The kafka-topics.sh script (kafka.admin.TopicCommand) will now print a warning when topic names risk metric collisions due to the use of a '.' or '_' in the topic name, and error in the case of an actual collision. </li> + <li> By default all command line tools will print all logging messages to stderr instead of stout. </li> +</ul> + +<h5>Deprecations in 0.9.0.0</h5> + +<ul> + <li> Altering topic configuration from the kafka-topics.sh script (kafka.admin.TopicCommand) has been deprecated. Going forward, please use the kafka-configs.sh script (kafka.admin.ConfigCommand) for this functionality. </li> + <li> The kafka-consumer-offset-checker.sh (kafka.tools.ConsumerOffsetChecker) has been deprecated. Going forward, please use kafka-consumer-groups.sh (kafka.admin.ConsumerGroupCommand) for this functionality. </li> +</ul> + <h4>Upgrading from 0.8.1 to 0.8.2.0</h4> 0.8.2.0 is fully compatible with 0.8.1. The upgrade can be done one broker at a time by simply bringing it down, updating the code, and restarting it.
