[GitHub] [kafka] ableegoldman commented on a change in pull request #11184: KAFKA-13172: Add downgrade guidance note for 3.0

[GitBox <gi...@apache.org>]

ableegoldman commented on a change in pull request #11184:
URL: https://github.com/apache/kafka/pull/11184#discussion_r683876709



##########
File path: docs/streams/upgrade-guide.html
##########
@@ -52,6 +52,15 @@ <h1>Upgrade Guide and API Changes</h1>
         <li> restart all new ({{fullDotVersion}}) application instances </li>
     </ul>
 
+    <p>
+        Since 3.0.0 release, Kafka Streams uses a newer RocksDB version which bumped its footer version persisted on files.
+        This means that old versioned RocksDB would not be able to recognize the bytes written by that newer versioned RocksDB,
+        and hence it is harder to downgrade Kafka Streams with version 3.0.0 or newer to older versions in-flight.
+        Users need to wipe out the local RocksDB state stores written by the new versioned Kafka Streams before swapping in the
+        older versioned Kafka Streams bytecode, which when then restore the state stores with the old versioned footer from the

Review comment:
       ```suggestion
           older versioned Kafka Streams bytecode, which would then restore the state stores with the old versioned footer from the
   ```




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: jira-unsubscribe@kafka.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org