From 2d89ce1e0c2d4171c161db0fcb2ccfbee85dafee Mon Sep 17 00:00:00 2001
From: "Mikhail f. Shiryaev" <mr.felixoid@gmail.com>
Date: Thu, 23 May 2019 13:55:31 +0200
Subject: [PATCH 1/3] Update ru and en ZK documentation

---
 .../en/operations/server_settings/settings.md |  4 +-
 .../ru/operations/server_settings/settings.md | 41 +++++++++++++++----
 2 files changed, 37 insertions(+), 8 deletions(-)

diff --git a/docs/en/operations/server_settings/settings.md b/docs/en/operations/server_settings/settings.md
index 8b4285c422e..6db6e2a4229 100644
--- a/docs/en/operations/server_settings/settings.md
+++ b/docs/en/operations/server_settings/settings.md
@@ -685,7 +685,8 @@ This parameter section contains the following parameters:
 
     The `index` attribute specifies an order of node, when trying to connect to ZooKeeper cluster.
 
-- `session_timeout` — Maximum timeout for client session in milliseconds.
+- `session_timeout_ms` — Maximum timeout for client session in milliseconds (default: 30000).
+- `operation_timeout_ms` — Maximum timeout for operation in milliseconds (default: 10000).
 - `root` — ZNode, that is used as root for znodes used by ClickHouse server. Optional.
 - `identity` — User and password, required by ZooKeeper to give access to requested znodes. Optional.
 
@@ -702,6 +703,7 @@ This parameter section contains the following parameters:
         <port>2181</port>
     </node>
     <session_timeout_ms>30000</session_timeout_ms>
+    <operation_timeout_ms>10000</operation_timeout_ms>
     <!-- Optional. Chroot suffix. Should exist. -->
     <root>/path/to/zookeeper/node</root>
     <!-- Optional. Zookeeper digest ACL string. -->
diff --git a/docs/ru/operations/server_settings/settings.md b/docs/ru/operations/server_settings/settings.md
index a3f610ea3fa..54c9f3dbc18 100644
--- a/docs/ru/operations/server_settings/settings.md
+++ b/docs/ru/operations/server_settings/settings.md
@@ -669,31 +669,58 @@ TCP порт для защищённого обмена данными с кли
 
 Конфигурация серверов ZooKeeper.
 
+Содержит параметры для взаимодействия ClickHouse с кластером [ZooKeeper](http://zookeeper.apache.org/).
+
 ClickHouse использует ZooKeeper для хранения метаданных о репликах при использовании реплицированных таблиц.
 
 Параметр можно не указывать, если реплицированные таблицы не используются.
 
-Подробно читайте в разделе "[Репликация](../../operations/table_engines/replication.md)".
+Содержит следующие параметры:
+
+- `node` — нода ZooKeeper. Может содержать несколько узлов.
+
+    Пример:
+
+    ```xml
+    <node index="1">
+        <host>example_host</host>
+        <port>2181</port>
+    </node>
+    ```
+
+    Аттрибут `index` указывает на порядок, в котором следует обращаться к узлам ZooKeeper.
+
+- `session_timeout_ms` — максимальный таймаут для сессии в миллисекундах (default: 30000).
+- `operation_timeout_ms` — максимальный таймаут для операции в миллисекундах (default: 10000).
+- `root` — корневая znode, которая используется сервером ClickHouse для всех остальных znode. Опционально.
+- `identity` — пара `usename:password` для авторизации в кластере ZooKeeper. Опционально.
 
 **Пример**
 
 ```xml
 <zookeeper>
-    <node index="1">
+    <node>
         <host>example1</host>
         <port>2181</port>
     </node>
-    <node index="2">
+    <node>
         <host>example2</host>
         <port>2181</port>
     </node>
-    <node index="3">
-        <host>example3</host>
-        <port>2181</port>
-    </node>
+    <session_timeout_ms>30000</session_timeout_ms>
+    <operation_timeout_ms>10000</operation_timeout_ms>
+    <!-- Optional. Chroot suffix. Should exist. -->
+    <root>/path/to/zookeeper/node</root>
+    <!-- Optional. Zookeeper digest ACL string. -->
+    <identity>user:password</identity>
 </zookeeper>
 ```
 
+**См. также:**
+
+- [Репликация](../../operations/table_engines/replication.md).
+- [ZooKeeper Programmer's Guide](http://zookeeper.apache.org/doc/current/zookeeperProgrammers.html)
+
 ## use_minimalistic_part_header_in_zookeeper {#server-settings-use_minimalistic_part_header_in_zookeeper}
 
 Способ хранения заголовков кусков данных в ZooKeeper.

From d33de11fd93b94d9f8dcc3302e69c7d911b9cad6 Mon Sep 17 00:00:00 2001
From: alexey-milovidov <milovidov@yandex-team.ru>
Date: Sat, 25 May 2019 15:09:21 +0300
Subject: [PATCH 2/3] Update settings.md

---
 docs/ru/operations/server_settings/settings.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/ru/operations/server_settings/settings.md b/docs/ru/operations/server_settings/settings.md
index 54c9f3dbc18..f0d928f46be 100644
--- a/docs/ru/operations/server_settings/settings.md
+++ b/docs/ru/operations/server_settings/settings.md
@@ -688,7 +688,7 @@ ClickHouse использует ZooKeeper для хранения метадан
     </node>
     ```
 
-    Аттрибут `index` указывает на порядок, в котором следует обращаться к узлам ZooKeeper.
+    Аттрибут `index` не используется в ClickHouse. Он присутствует в примере в связи с тем, что на серверах могут быть установлены другие программы, которые могут считывать тот же конфигурационный файл.
 
 - `session_timeout_ms` — максимальный таймаут для сессии в миллисекундах (default: 30000).
 - `operation_timeout_ms` — максимальный таймаут для операции в миллисекундах (default: 10000).

From 2058d737f662d8d32fe7187048fd5ff241afc340 Mon Sep 17 00:00:00 2001
From: alexey-milovidov <milovidov@yandex-team.ru>
Date: Sat, 25 May 2019 15:10:56 +0300
Subject: [PATCH 3/3] Update settings.md

---
 docs/en/operations/server_settings/settings.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/en/operations/server_settings/settings.md b/docs/en/operations/server_settings/settings.md
index 6db6e2a4229..11f5fd14f6f 100644
--- a/docs/en/operations/server_settings/settings.md
+++ b/docs/en/operations/server_settings/settings.md
@@ -683,7 +683,7 @@ This parameter section contains the following parameters:
     </node>
     ```
 
-    The `index` attribute specifies an order of node, when trying to connect to ZooKeeper cluster.
+    The `index` attribute is not used in ClickHouse. The only reason for this attribute is to allow some other programs to use the same configuraton.
 
 - `session_timeout_ms` — Maximum timeout for client session in milliseconds (default: 30000).
 - `operation_timeout_ms` — Maximum timeout for operation in milliseconds (default: 10000).