zookeeper-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From h...@apache.org
Subject [zookeeper] branch master updated: ZOOKEEPER-3373: need change description for "Single System Image" guarantee in document
Date Mon, 05 Aug 2019 23:51:46 GMT
This is an automated email from the ASF dual-hosted git repository.

hanm pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/zookeeper.git


The following commit(s) were added to refs/heads/master by this push:
     new f252c76  ZOOKEEPER-3373: need change description for "Single System Image" guarantee
in document
f252c76 is described below

commit f252c769206a9ed9688998a1608bcbd2840a90f4
Author: 数组越界 <ihavenoemail@163.com>
AuthorDate: Mon Aug 5 16:51:41 2019 -0700

    ZOOKEEPER-3373: need change description for "Single System Image" guarantee in document
    
    In website, "Single System Image" is "A client will see the same view of the service regardless
of the server that it connects to."
    
    I want to change it to "Once connected, a client will see the same view of the service
even if it switchs to another server"
    
    Because the old one is a little misleading, if cluster has a outdated follower and a normal
follower, I do not think a client will see the same view of the service regardless of the
server that it connects to at its first connection.
    
    Author: 数组越界 <ihavenoemail@163.com>
    
    Reviewers: maoling <maoling199210191@sina.com>, Andor Molnár <andor@apache.org>,
Michael Han <hanm@apache.org>
    
    Closes #931 from kabike/ZOOKEEPER-3373
---
 zookeeper-docs/src/main/resources/markdown/zookeeperOver.md        | 4 +++-
 zookeeper-docs/src/main/resources/markdown/zookeeperProgrammers.md | 4 +++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/zookeeper-docs/src/main/resources/markdown/zookeeperOver.md b/zookeeper-docs/src/main/resources/markdown/zookeeperOver.md
index 6ea96cb..1c00609 100644
--- a/zookeeper-docs/src/main/resources/markdown/zookeeperOver.md
+++ b/zookeeper-docs/src/main/resources/markdown/zookeeperOver.md
@@ -159,7 +159,9 @@ synchronization, it provides a set of guarantees. These are:
 * Atomicity - Updates either succeed or fail. No partial
   results.
 * Single System Image - A client will see the same view of the
-  service regardless of the server that it connects to.
+  service regardless of the server that it connects to. i.e., a
+  client will never see an older view of the system even if the
+  client fails over to a different server with the same session.
 * Reliability - Once an update has been applied, it will persist
   from that time forward until a client overwrites the update.
 * Timeliness - The clients view of the system is guaranteed to
diff --git a/zookeeper-docs/src/main/resources/markdown/zookeeperProgrammers.md b/zookeeper-docs/src/main/resources/markdown/zookeeperProgrammers.md
index 0d3797a..e7577b4 100644
--- a/zookeeper-docs/src/main/resources/markdown/zookeeperProgrammers.md
+++ b/zookeeper-docs/src/main/resources/markdown/zookeeperProgrammers.md
@@ -1054,7 +1054,9 @@ guarantees:
 
 * *Single System Image* :
     A client will see the same view of the service regardless of
-    the server that it connects to.
+    the server that it connects to. i.e., a client will never see an
+    older view of the system even if the client fails over to a
+    different server with the same session.
 
 * *Reliability* :
     Once an update has been applied, it will persist from that


Mime
View raw message