From 9ae039c2cf998b380fb9ee735ffba67babfdaf1e Mon Sep 17 00:00:00 2001 From: Konrad 'ktoso' Malawski Date: Tue, 5 Aug 2014 14:16:46 +0200 Subject: [PATCH] =doc #15565 improved wording in cluster-usage docs --- akka-docs/rst/java/cluster-usage.rst | 22 +++++++++++----------- akka-docs/rst/scala/cluster-usage.rst | 19 ++++++++++--------- 2 files changed, 21 insertions(+), 20 deletions(-) diff --git a/akka-docs/rst/java/cluster-usage.rst b/akka-docs/rst/java/cluster-usage.rst index 70036b6f70..e05edc346f 100644 --- a/akka-docs/rst/java/cluster-usage.rst +++ b/akka-docs/rst/java/cluster-usage.rst @@ -82,22 +82,22 @@ otherwise it can take up to the configured ``seed-node-timeout`` until the nodes can join. Once more than two seed nodes have been started it is no problem to shut down the first -seed node. If the first seed node is restarted it will first try join the other +seed node. If the first seed node is restarted, it will first try to join the other seed nodes in the existing cluster. -If you don't configure the seed nodes you need to join manually, using :ref:`cluster_jmx_java` -or :ref:`cluster_command_line_java`. You can join to any node in the cluster. It doesn't -have to be configured as a seed node. +If you don't configure seed nodes you need to join the cluster programmatically or manually. -Joining can also be performed programatically with ``Cluster.get(system).join``. Note that -you can only join to an existing cluster member, which means that for bootstrapping some +Manual joining can be performed by using ref:`cluster_jmx_java` or :ref:`cluster_command_line_java`. +Joining programatically can be performed with ``Cluster.get(system).join``. + +You can join to any node in the cluster. It does not have to be configured as a seed node. +Note that you can only join to an existing cluster member, which means that for bootstrapping some node must join itself. -You may also use ``Cluster.get(system).joinSeedNodes``, which is attractive when dynamically -discovering other nodes at startup by using some external tool or API. When using -``joinSeedNodes`` you should not include the node itself except for the node that is -supposed to be the first seed node, and that should be placed first in parameter to -``joinSeedNodes``. +You may also use ``Cluster.get(system).joinSeedNodes`` to join programmatically, +which is attractive when dynamically discovering other nodes at startup by using some external tool or API. +When using ``joinSeedNodes`` you should not include the node itself except for the node that is +supposed to be the first seed node, and that should be placed first in parameter to ``joinSeedNodes``. Unsuccessful join attempts are automatically retried after the time period defined in configuration property ``retry-unsuccessful-join-after``. When using ``seed-nodes`` this diff --git a/akka-docs/rst/scala/cluster-usage.rst b/akka-docs/rst/scala/cluster-usage.rst index 0c5d6e9360..b1a1d25f5b 100644 --- a/akka-docs/rst/scala/cluster-usage.rst +++ b/akka-docs/rst/scala/cluster-usage.rst @@ -76,20 +76,21 @@ otherwise it can take up to the configured ``seed-node-timeout`` until the nodes can join. Once more than two seed nodes have been started it is no problem to shut down the first -seed node. If the first seed node is restarted it will first try join the other +seed node. If the first seed node is restarted, it will first try to join the other seed nodes in the existing cluster. -If you don't configure the seed nodes you need to join manually, using :ref:`cluster_jmx_scala` -or :ref:`cluster_command_line_scala`. You can join to any node in the cluster. It doesn't -have to be configured as a seed node. +If you don't configure seed nodes you need to join the cluster programmatically or manually. -Joining can also be performed programatically with ``Cluster(system).join``. Note that -you can only join to an existing cluster member, which means that for bootstrapping some +Manual joining can be performed by using ref:`cluster_jmx_scala` or :ref:`cluster_command_line_scala`. +Joining programatically can be performed with ``Cluster(system).join``. + +You can join to any node in the cluster. It does not have to be configured as a seed node. +Note that you can only join to an existing cluster member, which means that for bootstrapping some node must join itself. -You may also use ``Cluster(system).joinSeedNodes``, which is attractive when dynamically -discovering other nodes at startup by using some external tool or API. When using -``joinSeedNodes`` you should not include the node itself except for the node that is +You may also use ``Cluster(system).joinSeedNodes`` to join programmatically, +which is attractive when dynamically discovering other nodes at startup by using some external tool or API. +When using ``joinSeedNodes`` you should not include the node itself except for the node that is supposed to be the first seed node, and that should be placed first in parameter to ``joinSeedNodes``.