qpid-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From GitBox <...@apache.org>
Subject [GitHub] [qpid-dispatch] ted-ross commented on a change in pull request #532: DISPATCH-1381: Create procedure for handling undeliverable messages
Date Mon, 15 Jul 2019 19:07:54 GMT
ted-ross commented on a change in pull request #532: DISPATCH-1381: Create procedure for handling
undeliverable messages
URL: https://github.com/apache/qpid-dispatch/pull/532#discussion_r303590310
 
 

 ##########
 File path: docs/books/user-guide/routing.adoc
 ##########
 @@ -551,6 +551,87 @@ autoLink {
 For information about additional attributes, see link:{qdrouterdConfManPageUrl}#_autolink[autoLink]
in the `qdrouterd.conf` man page.
 --
 
+=== Handling Undeliverable Messages for an Address
+
+You handle undeliverable messages for an address by configuring _fallback destinations_.
+A fallback destination is a queue on a broker that stores messages that are not directly
routable to any consumers.
+
+During normal message delivery,
+{RouterName} delivers messages to the consumers that are attached to the router network.
+However, if no consumers are reachable,
+the messages are diverted to any fallback destinations that were configured for the address.
+When a consumer reconnects and becomes reachable again,
+it receives the messages stored at the fallback destination.
+
+[NOTE]
+====
+{RouterName} does not preserve delivery order for messages stored at a fallback destination.
When a consumer reconnects, it will receive the stored messages interleaved with any new messages
sent by producers.
 
 Review comment:
   To be more accurate: message delivery is preserved in the queue and the queue will deliver
those messages in the same order in which they were received.  However, new messages produced
while the queue is draining will be interleaved with the draining messages.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@qpid.apache.org
For additional commands, e-mail: dev-help@qpid.apache.org


Mime
View raw message