Skip to content

Commit 1dc9947

Browse files
committed
Simplify the remote publication description
Signed-off-by: Sooraj Sinha <soosinha@amazon.com>
1 parent 29d708c commit 1dc9947

File tree

1 file changed

+11
-12
lines changed

1 file changed

+11
-12
lines changed

_tuning-your-cluster/availability-and-recovery/remote-store/remote-cluster-state.md

+11-12
Original file line numberDiff line numberDiff line change
@@ -66,19 +66,18 @@ The remote cluster state functionality has the following limitations:
6666
- Unsafe bootstrap scripts cannot be run when the remote cluster state is enabled. When a majority of cluster-manager nodes are lost and the cluster goes down, the user needs to replace any remaining cluster manager nodes and reseed the nodes in order to bootstrap a new cluster.
6767

6868
## Remote cluster state publication
69-
Cluster state publication using remote - When it is enabled, the updated cluster state during any updates like creation of an index and
70-
put mappings will be published through remote store, that is, the cluster manager will provide the remote location
71-
and nodes will download the cluster state directly from remote location.
72-
As the cluster state grows over time and there are large number of nodes in the cluster, publishing the state over local transport
73-
tends to add lot of overhead in terms of CPU, memory and transport thread-pool. This will reduce the overhead on cluster manager node
74-
to publish the updated cluster state through remote store to every other node in the cluster instead of local transport.
75-
Remote cluster state publication can be enabled by configuring the experimental remote publication feature.
76-
Enable the feature flag for `remote_store.publication` feature by following the [experiment feature flag documentation]({{site.url}}{{site.baseurl}}/install-and-configure/configuring-opensearch/experimental/).
69+
The cluster manager node processes the updates to cluster state. It then, publishes the updated cluster state
70+
over the local transport layer to all the follower nodes. With remote cluster state enabled,
71+
cluster state is backed to remote store with every state update. The follower nodes can fetch the state
72+
from remote store directly and reducing the overhead on the cluster manager node for publication.
73+
This can be done by enabling the experimental remote publication feature.
7774

78-
The routing table is an object within the cluster state which contains the shard allocation details for each index.
79-
This object can become large in case of large number of shards in the cluster. Routing table is required to be stored in
80-
remote store for the remote publication to work. In order to enable remote persistence of routing table, the following repository must
81-
be configured:
75+
Enable the feature flag for `remote_store.publication` feature by following the [experiment feature flag documentation]({{site.url}}{{site.baseurl}}/install-and-configure/configuring-opensearch/experimental/).
76+
This doesn't change the publication flow and follower nodes will not send acknowledgement back to cluster manager
77+
until they download the updated cluster state from remote store and proceed as expected in current flow.
78+
Note that enabling remote cluster state is mandatory for remote publication to work.
79+
Also, RoutingTable which contains the shard allocation details for each index in the cluster state requires
80+
setting up the remote store repository. It can be configured as following:
8281

8382
```yml
8483
# Remote routing table repository settings

0 commit comments

Comments
 (0)