gjacoby126 commented on a change in pull request #3469: URL: https://github.com/apache/hbase/pull/3469#discussion_r667214454
########## File path: src/main/asciidoc/_chapters/upgrading.adoc ########## @@ -799,6 +806,21 @@ To upgrade an existing HBase 1.x cluster, you should: * Upgrade RegionServers * (Eventually) Upgrade Clients +[[upgrade1.7.x]] +=== Upgrading to 1.7.1+ +HBase release 1.7.0 introduced an incompatible table metadata serialization format that broke the +minor release compatibility guarantees. The issue was reported in https://issues.apache.org/jira/browse/HBASE-26021[HBASE-26021] and the problematic serialization patch was reverted in +HBase 1.7.1. Some important notes about 1.7.x upgrades below. + +* If you are considering an upgrade to 1.7.x version, skip 1.7.0 completely and upgrade to 1.7.1+ +version. 1.7.0 was withdrawn and removed from the Apache sites. +* If you already installed a 1.7.0 cluster from scratch and are looking to migrate to 1.7.1+, you Review comment: What if I upgraded from 1.6 to 1.7.0 and am now running 1.7.0? ########## File path: src/main/asciidoc/_chapters/upgrading.adoc ########## @@ -799,6 +806,21 @@ To upgrade an existing HBase 1.x cluster, you should: * Upgrade RegionServers * (Eventually) Upgrade Clients +[[upgrade1.7.x]] +=== Upgrading to 1.7.1+ +HBase release 1.7.0 introduced an incompatible table metadata serialization format that broke the +minor release compatibility guarantees. The issue was reported in https://issues.apache.org/jira/browse/HBASE-26021[HBASE-26021] and the problematic serialization patch was reverted in +HBase 1.7.1. Some important notes about 1.7.x upgrades below. + +* If you are considering an upgrade to 1.7.x version, skip 1.7.0 completely and upgrade to 1.7.1+ +version. 1.7.0 was withdrawn and removed from the Apache sites. +* If you already installed a 1.7.0 cluster from scratch and are looking to migrate to 1.7.1+, you +cannot follow the regular rolling upgrade procedures due to broken compatibility contracts. +Instead shutdown the cluster and reboot with 1.7.1+ binaries. Newer versions detect any existing Review comment: tiny nit: double space between "the" and "cluster" -- 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: issues-unsubscr...@hbase.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org