From 43dafff152f211d545d18de9f3e5bc569af97f35 Mon Sep 17 00:00:00 2001 From: Patrik Nordwall Date: Tue, 15 Mar 2016 14:49:25 +0100 Subject: [PATCH] =cls #19917 Clarify docs about sharding ddata --- akka-docs/rst/dev/index.rst | 1 - akka-docs/rst/java/cluster-sharding.rst | 13 ++++++++++--- akka-docs/rst/scala/cluster-sharding.rst | 13 ++++++++++--- 3 files changed, 20 insertions(+), 7 deletions(-) diff --git a/akka-docs/rst/dev/index.rst b/akka-docs/rst/dev/index.rst index e7bb054720..3ebc1996a2 100644 --- a/akka-docs/rst/dev/index.rst +++ b/akka-docs/rst/dev/index.rst @@ -9,5 +9,4 @@ Information for Akka Developers io-layer developer-guidelines documentation - team diff --git a/akka-docs/rst/java/cluster-sharding.rst b/akka-docs/rst/java/cluster-sharding.rst index f176be3d02..dd16239cff 100644 --- a/akka-docs/rst/java/cluster-sharding.rst +++ b/akka-docs/rst/java/cluster-sharding.rst @@ -184,11 +184,18 @@ Distributed Data Mode Instead of using :ref:`persistence-java` it is possible to use the :ref:`distributed_data_java` module as storage for the state of the sharding coordinator. In such case the state of the -``ShardCoordinator`` will be replicated inside a cluster by the Distributed Data module with +``ShardCoordinator`` will be replicated inside a cluster by the :ref:`distributed_data_java` module with ``WriteMajority``/``ReadMajority`` consistency. -This mode can be enabled by setting configuration property ``akka.cluster.sharding.state-store-mode`` -as ``ddata``. +This mode can be enabled by setting configuration property:: + + akka.cluster.sharding.state-store-mode = ddata + +It is using the Distributed Data extension that must be running on all nodes in the cluster. +Therefore you should add that extension to the configuration to make sure that it is started +on all nodes:: + + akka.extensions += "akka.cluster.ddata.DistributedData" 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 diff --git a/akka-docs/rst/scala/cluster-sharding.rst b/akka-docs/rst/scala/cluster-sharding.rst index 711fbf821d..6bdbc78634 100644 --- a/akka-docs/rst/scala/cluster-sharding.rst +++ b/akka-docs/rst/scala/cluster-sharding.rst @@ -187,11 +187,18 @@ Distributed Data Mode Instead of using :ref:`persistence-scala` it is possible to use the :ref:`distributed_data_scala` module as storage for the state of the sharding coordinator. In such case the state of the -``ShardCoordinator`` will be replicated inside a cluster by the Distributed Data module with +``ShardCoordinator`` will be replicated inside a cluster by the :ref:`distributed_data_scala` module with ``WriteMajority``/``ReadMajority`` consistency. -This mode can be enabled by setting configuration property ``akka.cluster.sharding.state-store-mode`` -as ``ddata``. +This mode can be enabled by setting configuration property:: + + akka.cluster.sharding.state-store-mode = ddata + +It is using the Distributed Data extension that must be running on all nodes in the cluster. +Therefore you should add that extension to the configuration to make sure that it is started +on all nodes:: + + akka.extensions += "akka.cluster.ddata.DistributedData" 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