From d93628c1b088eb1d47f66ae45bf20eca8ccb7668 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Maciej=20B=C4=85k?= Date: Tue, 31 Mar 2026 19:18:55 +0200 Subject: [PATCH 1/2] Changes to clickhouse-keeper.md: add embedded keeper section --- .../altinity-kb-zookeeper/clickhouse-keeper.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/content/en/altinity-kb-setup-and-maintenance/altinity-kb-zookeeper/clickhouse-keeper.md b/content/en/altinity-kb-setup-and-maintenance/altinity-kb-zookeeper/clickhouse-keeper.md index f0f8151c5e..89940b68fe 100644 --- a/content/en/altinity-kb-setup-and-maintenance/altinity-kb-zookeeper/clickhouse-keeper.md +++ b/content/en/altinity-kb-setup-and-maintenance/altinity-kb-zookeeper/clickhouse-keeper.md @@ -70,14 +70,16 @@ Increasing the number of nodes offers no significant advantages (unless you need ## clickhouse-keeper-client -In clickhouse-keeper-client, paths are now parsed more strictly and must be passed as string literals. In practice, this means using single quotes around paths—for example, ls '/' instead of ls /, and get '/clickhouse/path' instead of get /clickhouse/path. +In clickhouse-keeper-client, paths are now parsed more strictly and must be passed as string literals. In practice, this means using single quotes around paths—for example, `ls '/'` instead of `ls /`, and `get '/clickhouse/path'` instead of `get /clickhouse/path`. + +## Embedded Keeper + +To use the embedded ClickHouse Keeper, add the `` section to the ClickHouse server configuration. In this setup, a separate client-side `` section is not required. If your ClickHouse servers use an external ClickHouse Keeper or ZooKeeper ensemble instead, see the section below. ## Example of a simple cluster The Keeper ensemble size must be odd because it requires a majority (50% + 1 nodes) to form a quorum. A 2-node Keeper setup will lose quorum after a single node failure, so the recommended number of Keeper replicas is 3. -On `hostname1` and `hostname2` below, ClickHouse can use the embedded Keeper cluster from ``, so a separate client-side `` section is not required. If your ClickHouse servers connect to an external Keeper or ZooKeeper ensemble, see [ClickHouse config for Keeper]({{< ref "clickhouse-keeper-clickhouse-config" >}}). - ### hostname1 ```xml From 81d4afa9ff9de80eb6f17becc68571565bbe7223 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Maciej=20B=C4=85k?= Date: Tue, 31 Mar 2026 19:18:55 +0200 Subject: [PATCH 2/2] Changes to clickhouse-keeper.md: add embedded keeper section --- .../altinity-kb-zookeeper/clickhouse-keeper.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/content/en/altinity-kb-setup-and-maintenance/altinity-kb-zookeeper/clickhouse-keeper.md b/content/en/altinity-kb-setup-and-maintenance/altinity-kb-zookeeper/clickhouse-keeper.md index 2ebd2cfdfc..89940b68fe 100644 --- a/content/en/altinity-kb-setup-and-maintenance/altinity-kb-zookeeper/clickhouse-keeper.md +++ b/content/en/altinity-kb-setup-and-maintenance/altinity-kb-zookeeper/clickhouse-keeper.md @@ -72,12 +72,14 @@ Increasing the number of nodes offers no significant advantages (unless you need In clickhouse-keeper-client, paths are now parsed more strictly and must be passed as string literals. In practice, this means using single quotes around paths—for example, `ls '/'` instead of `ls /`, and `get '/clickhouse/path'` instead of `get /clickhouse/path`. +## Embedded Keeper + +To use the embedded ClickHouse Keeper, add the `` section to the ClickHouse server configuration. In this setup, a separate client-side `` section is not required. If your ClickHouse servers use an external ClickHouse Keeper or ZooKeeper ensemble instead, see the section below. + ## Example of a simple cluster The Keeper ensemble size must be odd because it requires a majority (50% + 1 nodes) to form a quorum. A 2-node Keeper setup will lose quorum after a single node failure, so the recommended number of Keeper replicas is 3. -On `hostname1` and `hostname2` below, ClickHouse can use the embedded Keeper cluster from ``, so a separate client-side `` section is not required. If your ClickHouse servers connect to an external Keeper or ZooKeeper ensemble, see [ClickHouse config for Keeper]. - ### hostname1 ```xml