diff --git a/akka-cluster-sharding/src/main/scala/akka/cluster/sharding/ClusterShardingSettings.scala b/akka-cluster-sharding/src/main/scala/akka/cluster/sharding/ClusterShardingSettings.scala index 82ca284fd3..51597422b2 100644 --- a/akka-cluster-sharding/src/main/scala/akka/cluster/sharding/ClusterShardingSettings.scala +++ b/akka-cluster-sharding/src/main/scala/akka/cluster/sharding/ClusterShardingSettings.scala @@ -129,6 +129,9 @@ final class ClusterShardingSettings( def withTuningParameters(tuningParameters: ClusterShardingSettings.TuningParameters): ClusterShardingSettings = copy(tuningParameters = tuningParameters) + def withStateStoreMode(stateStoreMode: String): ClusterShardingSettings = + copy(stateStoreMode = stateStoreMode) + /** * The `role` of the `ClusterSingletonManagerSettings` is not used. The `role` of the * coordinator singleton will be the same as the `role` of `ClusterShardingSettings`. diff --git a/akka-docs/rst/java/cluster-sharding.rst b/akka-docs/rst/java/cluster-sharding.rst index dd16239cff..bdf7133ac8 100644 --- a/akka-docs/rst/java/cluster-sharding.rst +++ b/akka-docs/rst/java/cluster-sharding.rst @@ -200,6 +200,10 @@ on all nodes:: You must explicitly add the ``akka-distributed-data-experimental`` dependency to your build if you use this mode. It is possible to remove ``akka-persistence`` dependency from a project if it is not used in user code and ``remember-entities`` is ``off``. +Using it together with ``Remember Entities`` shards will be recreated after rebalancing, however will +not be recreated after a clean cluster start as the Sharding Coordinator state is empty after a clean cluster +start when using ddata mode. When ``Remember Entities`` is ``on`` Sharding Region always keeps data usig persistence, +no matter how ``State Store Mode`` is set. .. warning:: diff --git a/akka-docs/rst/scala/cluster-sharding.rst b/akka-docs/rst/scala/cluster-sharding.rst index 6bdbc78634..5dfcf421cf 100644 --- a/akka-docs/rst/scala/cluster-sharding.rst +++ b/akka-docs/rst/scala/cluster-sharding.rst @@ -203,6 +203,10 @@ on all nodes:: You must explicitly add the ``akka-distributed-data-experimental`` dependency to your build if you use this mode. It is possible to remove ``akka-persistence`` dependency from a project if it is not used in user code and ``remember-entities`` is ``off``. +Using it together with ``Remember Entities`` shards will be recreated after rebalancing, however will +not be recreated after a clean cluster start as the Sharding Coordinator state is empty after a clean cluster +start when using ddata mode. When ``Remember Entities`` is ``on`` Sharding Region always keeps data usig persistence, +no matter how ``State Store Mode`` is set. .. warning::