From 5b35438e650d0cb9ddc6c8a48c33b71ccfea4db0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bj=C3=B6rn=20Antonsson?= Date: Thu, 16 Aug 2012 17:00:06 +0200 Subject: [PATCH] Be clear about the fact that two actor systems can't have the same port. See #2389 (cherry picked from commit 0bd9aa1a6a48c84a73d7827b15a5178c1b616f43) --- akka-docs/java/remoting.rst | 5 +++++ akka-docs/scala/remoting.rst | 5 +++++ akka-remote/src/main/resources/reference.conf | 1 + 3 files changed, 11 insertions(+) diff --git a/akka-docs/java/remoting.rst b/akka-docs/java/remoting.rst index 82a736973f..4aa62a63be 100644 --- a/akka-docs/java/remoting.rst +++ b/akka-docs/java/remoting.rst @@ -43,6 +43,11 @@ As you can see in the example above there are four things you need to add to get communicate across the network. * Add port number - the port the actor system should listen on, set to 0 to have it chosen automatically +.. note:: + The port number needs to be unique for each actor system on the same machine even if the actor + systems have different names. This is because each actor system has its own network subsystem + listening for connections and handling messages as not to interfere with other actor systems. + The example above only illustrates the bare minimum of properties you have to add to enable remoting. There are lots of more properties that are related to remoting in Akka. We refer to the following reference file for more information: diff --git a/akka-docs/scala/remoting.rst b/akka-docs/scala/remoting.rst index ab49765fad..a165272ddb 100644 --- a/akka-docs/scala/remoting.rst +++ b/akka-docs/scala/remoting.rst @@ -40,6 +40,11 @@ As you can see in the example above there are four things you need to add to get communicate across the network. * Add port number - the port the actor system should listen on, set to 0 to have it chosen automatically +.. note:: + The port number needs to be unique for each actor system on the same machine even if the actor + systems have different names. This is because each actor system has its own network subsystem + listening for connections and handling messages as not to interfere with other actor systems. + The example above only illustrates the bare minimum of properties you have to add to enable remoting. There are lots of more properties that are related to remoting in Akka. We refer to the following reference file for more information: diff --git a/akka-remote/src/main/resources/reference.conf b/akka-remote/src/main/resources/reference.conf index 7ae3219c5d..3064f05ed2 100644 --- a/akka-remote/src/main/resources/reference.conf +++ b/akka-remote/src/main/resources/reference.conf @@ -107,6 +107,7 @@ akka { # (I) The default remote server port clients should connect to. # Default is 2552 (AKKA), use 0 if you want a random available port + # This port needs to be unique for each actor system on the same machine. port = 2552 # (O) The address of a local network interface (IP Address) to bind to when creating