Repository: hbase Updated Branches: refs/heads/master 12d9697d9 -> 3fdc6a2b7
HBASE-11629 Operational concerns for Replication should call out ZooKeeper (Misty Stanley Jones) Project: http://git-wip-us.apache.org/repos/asf/hbase/repo Commit: http://git-wip-us.apache.org/repos/asf/hbase/commit/3fdc6a2b Tree: http://git-wip-us.apache.org/repos/asf/hbase/tree/3fdc6a2b Diff: http://git-wip-us.apache.org/repos/asf/hbase/diff/3fdc6a2b Branch: refs/heads/master Commit: 3fdc6a2b728c7280132bd31831f3838c24b0d0e3 Parents: 12d9697 Author: stack <[email protected]> Authored: Thu Aug 7 08:24:32 2014 -0700 Committer: stack <[email protected]> Committed: Thu Aug 7 08:24:32 2014 -0700 ---------------------------------------------------------------------- src/main/docbkx/developer.xml | 33 ++++++++++++++++++++++++++------- src/main/docbkx/ops_mgt.xml | 12 ++++++++++-- 2 files changed, 36 insertions(+), 9 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/hbase/blob/3fdc6a2b/src/main/docbkx/developer.xml ---------------------------------------------------------------------- diff --git a/src/main/docbkx/developer.xml b/src/main/docbkx/developer.xml index cf2ed10..91fb5f3 100644 --- a/src/main/docbkx/developer.xml +++ b/src/main/docbkx/developer.xml @@ -1569,13 +1569,32 @@ public class MyHBaseIntegrationTest { <para>We don't have many but what we have we list below. All are subject to challenge of course but until then, please hold to the rules of the road. </para> - <section xml:id="design.invariants.zk.data"> - <title>No permanent state in ZooKeeper</title> - <para>ZooKeeper state should transient (treat it like memory). If deleted, hbase - should be able to recover and essentially be in the same state<footnote><para>There are currently - a few exceptions that we need to fix around whether a table is enabled or disabled</para></footnote>. - </para> - </section> + <section xml:id="design.invariants.zk.data"> + <title>No permanent state in ZooKeeper</title> + <para>ZooKeeper state should transient (treat it like memory). If ZooKeeper state is + deleted, hbase should be able to recover and essentially be in the same + state.</para> + <itemizedlist> + <title>Exceptions</title> + <listitem> + <para>There are currently a few exceptions that we need to fix around + whether a table is enabled or disabled.</para> + </listitem> + <listitem> + <para>Replication data is currently stored only in ZooKeeper. Deleting + ZooKeeper data related to replication may cause replication to be + disabled. Do not delete the replication tree, + <filename>/hbase/replication/</filename>.</para> + <warning> + <para>Replication may be disrupted and data loss may occur if you delete + the replication tree (<filename>/hbase/replication/</filename>) from + ZooKeeper. Follow progress on this issue at <link + xlink:href="https://issues.apache.org/jira/browse/HBASE-10295"; + >HBASE-10295</link>.</para> + </warning> + </listitem> + </itemizedlist> + </section> </section> <!-- design.invariants --> http://git-wip-us.apache.org/repos/asf/hbase/blob/3fdc6a2b/src/main/docbkx/ops_mgt.xml ---------------------------------------------------------------------- diff --git a/src/main/docbkx/ops_mgt.xml b/src/main/docbkx/ops_mgt.xml index fdf4a6a..eb5c98c 100644 --- a/src/main/docbkx/ops_mgt.xml +++ b/src/main/docbkx/ops_mgt.xml @@ -1141,10 +1141,10 @@ false replicate and keeps track of the current position inside ZooKeeper to simplify failure recovery. That position, as well as the queue of WALs to process, may be different for every slave cluster.</para> - + <para>The clusters participating in replication can be of different sizes. The master cluster relies on randomization to attempt to balance the stream of replication on the slave clusters</para> - + <para>HBase supports master/master and cyclic replication as well as replication to multiple slaves.</para> @@ -1264,6 +1264,14 @@ false <para>HBase replication maintains its state in ZooKeeper. By default, the state is contained in the base node <filename>/hbase/replication</filename>. This node contains two child nodes, the <code>Peers</code> znode and the <code>RS</code> znode.</para> + <warning> + <para>Replication may be disrupted and data loss may occur if you delete the + replication tree (<filename>/hbase/replication/</filename>) from ZooKeeper. This is + despite the information about invariants at <xref + linkend="design.invariants.zk.data"/>. Follow progress on this issue at <link + xlink:href="https://issues.apache.org/jira/browse/HBASE-10295"; + >HBASE-10295</link>.</para> + </warning> </listitem> </varlistentry> <varlistentry>
