From 9ed3c633c53eab5e5e103f2b15ec5048b2205aea Mon Sep 17 00:00:00 2001 From: Roland Kuhn Date: Tue, 4 Mar 2014 17:38:27 +0100 Subject: [PATCH] =doc #3905 describe symmetric remoting requirement --- akka-docs/rst/general/remoting.rst | 6 ++++-- akka-docs/rst/java/remoting.rst | 8 ++++++-- akka-docs/rst/scala/remoting.rst | 8 ++++++-- 3 files changed, 16 insertions(+), 6 deletions(-) diff --git a/akka-docs/rst/general/remoting.rst b/akka-docs/rst/general/remoting.rst index 3b2cc58554..901f722a4e 100644 --- a/akka-docs/rst/general/remoting.rst +++ b/akka-docs/rst/general/remoting.rst @@ -64,8 +64,10 @@ design decisions: #. The role of the communicating systems are symmetric in regards to connection patterns: there is no system that only accepts connections, and there is no system that only initiates connections. -The consequence of these decisions is that it is not possible to safely create pure client-server setups -with predefined roles (violates assumption 2) and using setups involving NAT (violates assumption 1). +The consequence of these decisions is that it is not possible to safely create +pure client-server setups with predefined roles (violates assumption 2) and +using setups involving Network Address Translation or Load Balancers (violates +assumption 1). For client-server setups it is better to use HTTP or Akka I/O. diff --git a/akka-docs/rst/java/remoting.rst b/akka-docs/rst/java/remoting.rst index 85b48e1a44..135e35e52f 100644 --- a/akka-docs/rst/java/remoting.rst +++ b/akka-docs/rst/java/remoting.rst @@ -6,8 +6,12 @@ For an introduction of remoting capabilities of Akka please see :ref:`remoting`. -As explained in that chapter Akka remoting is designed for communication in a -peer-to-peer fashion and it has limitations for client-server setups. +.. note:: + + As explained in that chapter Akka remoting is designed for communication in a + peer-to-peer fashion and it has limitations for client-server setups. In + particular Akka Remoting does not work with Network Address Translation and + Load Balancers, among others. Preparing your ActorSystem for Remoting ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/akka-docs/rst/scala/remoting.rst b/akka-docs/rst/scala/remoting.rst index 53cbff2e11..bbd59bd429 100644 --- a/akka-docs/rst/scala/remoting.rst +++ b/akka-docs/rst/scala/remoting.rst @@ -7,8 +7,12 @@ For an introduction of remoting capabilities of Akka please see :ref:`remoting`. -As explained in that chapter Akka remoting is designed for communication in a -peer-to-peer fashion and it has limitations for client-server setups. +.. note:: + + As explained in that chapter Akka remoting is designed for communication in a + peer-to-peer fashion and it has limitations for client-server setups. In + particular Akka Remoting does not work with Network Address Translation and + Load Balancers, among others. Preparing your ActorSystem for Remoting