summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorOleksii Zamiatin <ozamiatin@mirantis.com>2016-01-25 15:00:38 +0200
committerOleksii Zamiatin <ozamiatin@mirantis.com>2016-01-26 14:26:24 +0200
commit08dd23d1d412cfdd8d3a8923a5245daba2e89a3d (patch)
treef716cdee45797b14130c9774083c9f2ef1e1fcd6 /doc
parenta053593c13321f89074288be7f72b9b59045854a (diff)
downloadoslo-messaging-08dd23d1d412cfdd8d3a8923a5245daba2e89a3d.tar.gz
[zmq] Reduce proxy for direct messaging
Since the change I643a111fca8bac32f41ced232d54ff2a2ebcbf77 we don't need proxy for direct types because any message woud be sent before server listening to the target appears on name server registry, so DEALER wouldn't block. Change-Id: I3c0f3e6930a4092cac5a6e18529d98e6d6e65f32
Diffstat (limited to 'doc')
-rw-r--r--doc/source/zmq_driver.rst18
1 files changed, 7 insertions, 11 deletions
diff --git a/doc/source/zmq_driver.rst b/doc/source/zmq_driver.rst
index 0ab7903..9f9a74d 100644
--- a/doc/source/zmq_driver.rst
+++ b/doc/source/zmq_driver.rst
@@ -138,28 +138,24 @@ stored in Redis is that the key is a base topic and the corresponding values are
hostname arrays to be sent to.
-Proxy to avoid blocking (optional)
-----------------------------------
+Proxy for fanout publishing
+---------------------------
-Each machine running OpenStack services, or sending RPC messages, may run the
-'oslo-messaging-zmq-broker' daemon. This is needed to avoid blocking
-if a listener (server) appears after the sender (client).
+Each machine running OpenStack services, or sending RPC messages, should run
+the 'oslo-messaging-zmq-broker' daemon.
Fanout-based patterns like CAST+Fanout and notifications always use proxy
as they act over PUB/SUB, 'use_pub_sub' - defaults to True. If not using
PUB/SUB (use_pub_sub = False) then fanout will be emulated over direct
DEALER/ROUTER unicast which is possible but less efficient and therefore
-is not recommended.
-
-Running direct RPC methods like CALL and CAST over a proxy is controlled by
-the option 'direct_over_proxy' which is True by default.
+is not recommended. In a case of direct DEALER/ROUTER unicast proxy is not
+needed.
-These options can be set in [DEFAULT] section.
+This option can be set in [DEFAULT] section.
For example::
use_pub_sub = True
- direct_over_proxy = False
In case of using the broker all publishers (clients) talk to servers over