bharathv commented on a change in pull request #3469: URL: https://github.com/apache/hbase/pull/3469#discussion_r667215647
########## 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: Ack. ########## 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: You cannot, the bug doesn't let you upgrade. During the upgrade, 1.7.0 binaries try to parse the table descriptors and it blows up (META to begin with). -- 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: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
