From 68ee26d34da3e47066e58f529ef51775529da6ff Mon Sep 17 00:00:00 2001 From: Guanghao Zhang Date: Sat, 18 Nov 2017 15:33:08 +0800 Subject: [PATCH] HBASE-18626 Handle the incompatible change about the replication TableCFs' config --- src/main/asciidoc/_chapters/upgrading.adoc | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/src/main/asciidoc/_chapters/upgrading.adoc b/src/main/asciidoc/_chapters/upgrading.adoc index 9c022100442..4256e475b42 100644 --- a/src/main/asciidoc/_chapters/upgrading.adoc +++ b/src/main/asciidoc/_chapters/upgrading.adoc @@ -175,6 +175,26 @@ In the minor version-particular sections below, we call out where the versions a == Upgrade Paths +[[upgrade1.4]] +=== Upgrading to 1.4+ + +==== Replication peer's TableCFs config + +Before 1.4, the table name can't include namespace for replication peer's TableCFs config. It was fixed by add TableCFs to ReplicationPeerConfig which was stored on Zookeeper. So when upgrade to 1.4, you have to update the original ReplicationPeerConfig data on Zookeeper firstly. There are four steps to upgrade when your cluster have a replication peer with TableCFs config. + +* Disable the replication peer. +* If master has permission to write replication peer znode, then rolling update master directly. If not, use TableCFsUpdater tool to update the replication peer's config. +[source,bash] +---- +$ bin/hbase org.apache.hadoop.hbase.replication.master.TableCFsUpdater update +---- +* Rolling update regionservers. +* Enable the replication peer. + +Notes: + +* Can't use the old client(before 1.4) to change the replication peer's config. Because the client will write config to Zookeeper directly, the old client will miss TableCFs config. And the old client write TableCFs config to the old tablecfs znode, it will not work for new version regionserver. + [[upgrade1.0]] === Upgrading from 0.98.x to 1.x