HBASE-18626 Handle the incompatible change about the replication TableCFs' config
Signed-off-by: Andrew Purtell <apurt...@apache.org> Project: http://git-wip-us.apache.org/repos/asf/hbase/repo Commit: http://git-wip-us.apache.org/repos/asf/hbase/commit/4cdca34a Tree: http://git-wip-us.apache.org/repos/asf/hbase/tree/4cdca34a Diff: http://git-wip-us.apache.org/repos/asf/hbase/diff/4cdca34a Branch: refs/heads/HBASE-19064 Commit: 4cdca34ace9e2e9a25cd5fbf7f76b7a8be4266d1 Parents: 0ef41f8 Author: Guanghao Zhang <zg...@apache.org> Authored: Sat Nov 18 15:33:08 2017 +0800 Committer: Sean Busbey <bus...@apache.org> Committed: Thu Mar 22 15:52:53 2018 -0500 ---------------------------------------------------------------------- src/main/asciidoc/_chapters/upgrading.adoc | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/hbase/blob/4cdca34a/src/main/asciidoc/_chapters/upgrading.adoc ---------------------------------------------------------------------- diff --git a/src/main/asciidoc/_chapters/upgrading.adoc b/src/main/asciidoc/_chapters/upgrading.adoc index fd8a86a..0747ffb 100644 --- a/src/main/asciidoc/_chapters/upgrading.adoc +++ b/src/main/asciidoc/_chapters/upgrading.adoc @@ -324,6 +324,26 @@ Quitting... == 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
