You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hbase.apache.org by st...@apache.org on 2014/08/07 17:24:41 UTC
git commit: HBASE-11629 Operational concerns for Replication should
call out ZooKeeper (Misty Stanley Jones)
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 <st...@apache.org>
Authored: Thu Aug 7 08:24:32 2014 -0700
Committer: stack <st...@apache.org>
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>