You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _tuning-your-cluster/replication-plugin/settings.md
+14-5Lines changed: 14 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,7 +9,7 @@ redirect_from:
9
9
10
10
# Replication settings
11
11
12
-
The replication plugin adds several settings to the standard OpenSearch cluster settings.
12
+
The replication plugin adds several settings to the standard OpenSearch cluster and index settings.
13
13
The settings are dynamic, so you can change the default behavior of the plugin without restarting your cluster. To learn more about static and dynamic settings, see [Configuring OpenSearch]({{site.url}}{{site.baseurl}}/install-and-configure/configuring-opensearch/index/).
14
14
15
15
You can mark settings as `persistent` or `transient`.
@@ -25,17 +25,26 @@ PUT _cluster/settings
25
25
}
26
26
```
27
27
28
-
These settings manage the resources consumed by remote recoveries. We don’t recommend changing these settings; the defaults should work well for most use cases.
28
+
These settings manage the resources consumed by remote recoveries. We don't recommend changing these settings; the defaults should work well for most use cases.
29
+
30
+
## Cluster-level settings
31
+
32
+
You can specify these settings at the cluster level to control the default behavior of replication across all indexes in the cluster. These settings apply globally unless overridden by index-level settings.
29
33
30
34
Setting | Default | Description
31
35
:--- | :--- | :---
32
-
`plugins.replication.follower.index.recovery.chunk_size` | 10 MB | The chunk size requested by the follower cluster during file transfer. Specify the chunk size as a value and unit, for example, 10 MB, 5 KB. See [Supported units]({{site.url}}{{site.baseurl}}/opensearch/units/).
33
-
`plugins.replication.follower.index.recovery.max_concurrent_file_chunks` | 4 | The number of file chunk requests that can be sent in parallel for each recovery.
34
-
`plugins.replication.follower.index.ops_batch_size` | 50000 | The number of operations that can be fetched at a time during the syncing phase of replication.
35
36
`plugins.replication.follower.concurrent_readers_per_shard` | 2 | The number of concurrent requests from the follower cluster per shard during the syncing phase of replication.
36
37
`plugins.replication.autofollow.fetch_poll_interval` | 30s | How often auto-follow tasks poll the leader cluster for new matching indexes.
37
38
`plugins.replication.follower.metadata_sync_interval` | 60s | How often the follower cluster polls the leader cluster for updated index metadata.
38
39
`plugins.replication.translog.retention_lease.pruning.enabled` | true | If enabled, prunes the translog based on retention leases on the leader index.
39
40
`plugins.replication.translog.retention_size` | 512 MB | Controls the size of the translog on the leader index.
40
41
`plugins.replication.replicate.delete_index` | false | If enabled, the follower index is automatically deleted whenever the corresponding leader index is deleted.
42
+
`plugins.replication.follower.index.ops_batch_size` | 50000 | The number of operations that can be fetched at a time during the sync phase of replication.
43
+
44
+
## Index-level settings
41
45
46
+
You can specify these settings when creating a follower index or update them for existing follower indexes. These settings control the behavior of individual indexes during replication.
47
+
48
+
Setting | Default | Description
49
+
:--- |:------| :---
50
+
`index.plugins.replication.follower.ops_batch_size` | 50000 | The number of operations that can be fetched at a time during the sync phase of replication for the specific index. This setting overrides the cluster-level setting.
0 commit comments