From ee28c80439078204c310a72378d1f86bd6ec3fc3 Mon Sep 17 00:00:00 2001
From: Doug Tidwell <doug_tidwell@yahoo.com>
Date: Thu, 7 May 2026 10:24:46 -0400
Subject: [PATCH 1/2] Update add_remove_replica.md

---
 .../add_remove_replica.md                     | 30 +++++++------------
 1 file changed, 10 insertions(+), 20 deletions(-)

diff --git a/content/en/altinity-kb-setup-and-maintenance/altinity-kb-data-migration/add_remove_replica.md b/content/en/altinity-kb-setup-and-maintenance/altinity-kb-data-migration/add_remove_replica.md
index 5b95cc1694..a92a9a6cd7 100644
--- a/content/en/altinity-kb-setup-and-maintenance/altinity-kb-data-migration/add_remove_replica.md
+++ b/content/en/altinity-kb-setup-and-maintenance/altinity-kb-data-migration/add_remove_replica.md
@@ -18,17 +18,13 @@ To add some ClickHouse® replicas to an existing cluster if -30TB then better to
 
 [Core Settings | ClickHouse Docs](https://clickhouse.com/docs/en/operations/settings/settings/#max_replicated_fetches_network_bandwidth_for_server)
 
-💡 Do the **Gbps to Bps** math correctly. For 10G —> 1250MB/s —> 1250000000 B/s and change `max_replicated_*` settings accordingly:
+💡 Do the **Gbps to Bps** math correctly. For 10G —> 1250MB/s —> 1250000000 B/s and change the `max_replicated_*` settings accordingly (_changing these settings restarts the server_):
 
 - Nodes replicating from:
 
 ```xml
 <clickhouse>
-	<profiles>
-		<default>
-			<max_replicated_sends_network_bandwidth_for_server>50000</max_replicated_sends_network_bandwidth_for_server>
-		</default>
-	</profiles>
+  <max_replicated_sends_network_bandwidth_for_server>50000</max_replicated_sends_network_bandwidth_for_server>
 </clickhouse>
 ```
 
@@ -36,11 +32,7 @@ To add some ClickHouse® replicas to an existing cluster if -30TB then better to
 
 ```xml
 <clickhouse>
-	<profiles>
-		<default>
-			<max_replicated_fetches_network_bandwidth_for_server>50000</max_replicated_fetches_network_bandwidth_for_server>
-		</default>
-	</profiles>
+  <max_replicated_fetches_network_bandwidth_for_server>50000</max_replicated_fetches_network_bandwidth_for_server>
 </clickhouse>
 ```
 
@@ -185,17 +177,15 @@ FORMAT TSVRaw;
     - increase moves from 8 to 16
 
 ```xml
-<yandex>
-    <profiles>
-        <default>        
-            <max_replicated_fetches_network_bandwidth_for_server>625000000</max_replicated_fetches_network_bandwidth_for_server>
-            <background_fetches_pool_size>4</background_fetches_pool_size>
-            <background_move_pool_size>16</background_move_pool_size>
-        </default>
-    </profiles>
-</yandex>
+<clickhouse>
+  <max_replicated_fetches_network_bandwidth_for_server>625000000</max_replicated_fetches_network_bandwidth_for_server>
+  <background_fetches_pool_size>4</background_fetches_pool_size>
+  <background_move_pool_size>16</background_move_pool_size>
+</clickhouse>
 ```
 
+*Changing these settings restarts the server.*
+
 - Also to monitor this with:
 
 ```sql

From 9ee0f6bb4e2866b75c93ab626486eeb74e923bfa Mon Sep 17 00:00:00 2001
From: Doug Tidwell <doug_tidwell@yahoo.com>
Date: Thu, 7 May 2026 11:14:40 -0400
Subject: [PATCH 2/2] Update add_remove_replica.md

---
 .../altinity-kb-data-migration/add_remove_replica.md        | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/content/en/altinity-kb-setup-and-maintenance/altinity-kb-data-migration/add_remove_replica.md b/content/en/altinity-kb-setup-and-maintenance/altinity-kb-data-migration/add_remove_replica.md
index a92a9a6cd7..5b7011ab24 100644
--- a/content/en/altinity-kb-setup-and-maintenance/altinity-kb-data-migration/add_remove_replica.md
+++ b/content/en/altinity-kb-setup-and-maintenance/altinity-kb-data-migration/add_remove_replica.md
@@ -18,7 +18,7 @@ To add some ClickHouse® replicas to an existing cluster if -30TB then better to
 
 [Core Settings | ClickHouse Docs](https://clickhouse.com/docs/en/operations/settings/settings/#max_replicated_fetches_network_bandwidth_for_server)
 
-💡 Do the **Gbps to Bps** math correctly. For 10G —> 1250MB/s —> 1250000000 B/s and change the `max_replicated_*` settings accordingly (_changing these settings restarts the server_):
+💡 Do the **Gbps to Bps** math correctly. For 10G —> 1250MB/s —> 1250000000 B/s. Change the `max_replicated_*` settings accordingly and add them to a file in `/etc/clickhouse-server/config.d/` (e.g., `config.d/replication-limits.xml`) and restart ClickHouse:
 
 - Nodes replicating from:
 
@@ -176,6 +176,8 @@ FORMAT TSVRaw;
     - reduce fetches from 8 to 4
     - increase moves from 8 to 16
 
+Add these settings to a file in `/etc/clickhouse-server/config.d/` (e.g., `config.d/replication-limits.xml`) and restart ClickHouse:
+
 ```xml
 <clickhouse>
   <max_replicated_fetches_network_bandwidth_for_server>625000000</max_replicated_fetches_network_bandwidth_for_server>
@@ -184,8 +186,6 @@ FORMAT TSVRaw;
 </clickhouse>
 ```
 
-*Changing these settings restarts the server.*
-
 - Also to monitor this with:
 
 ```sql