kafka-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From gwens...@apache.org
Subject kafka git commit: KAFKA-2645: Document potentially breaking changes in the release note…
Date Tue, 27 Oct 2015 14:43:30 GMT
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 <granthenke@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 <granthenke@gmail.com>
Authored: Tue Oct 27 07:43:19 2015 -0700
Committer: Gwen Shapira <cshapi@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.


Mime
View raw message