From commits-return-7906-archive-asf-public=cust-asf.ponee.io@zookeeper.apache.org Mon Aug 5 23:51:47 2019 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [207.244.88.153]) by mx-eu-01.ponee.io (Postfix) with SMTP id 64403180181 for ; Tue, 6 Aug 2019 01:51:47 +0200 (CEST) Received: (qmail 35467 invoked by uid 500); 5 Aug 2019 23:51:46 -0000 Mailing-List: contact commits-help@zookeeper.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@zookeeper.apache.org Delivered-To: mailing list commits@zookeeper.apache.org Received: (qmail 35456 invoked by uid 99); 5 Aug 2019 23:51:46 -0000 Received: from ec2-52-202-80-70.compute-1.amazonaws.com (HELO gitbox.apache.org) (52.202.80.70) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 05 Aug 2019 23:51:46 +0000 Received: by gitbox.apache.org (ASF Mail Server at gitbox.apache.org, from userid 33) id 7D39585EEB; Mon, 5 Aug 2019 23:51:46 +0000 (UTC) Date: Mon, 05 Aug 2019 23:51:46 +0000 To: "commits@zookeeper.apache.org" Subject: [zookeeper] branch master updated: ZOOKEEPER-3373: need change description for "Single System Image" guarantee in document MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Message-ID: <156504910638.30769.12353856455792222840@gitbox.apache.org> From: hanm@apache.org X-Git-Host: gitbox.apache.org X-Git-Repo: zookeeper X-Git-Refname: refs/heads/master X-Git-Reftype: branch X-Git-Oldrev: 8fbeec0db8010461ddeae88d15c3a0b1e59a3c64 X-Git-Newrev: f252c769206a9ed9688998a1608bcbd2840a90f4 X-Git-Rev: f252c769206a9ed9688998a1608bcbd2840a90f4 X-Git-NotificationType: ref_changed_plus_diff X-Git-Multimail-Version: 1.5.dev Auto-Submitted: auto-generated 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: 数组越界 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: 数组越界 Reviewers: maoling , Andor Molnár , Michael Han 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