qpid-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "ASF GitHub Bot (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (DISPATCH-1381) Create documentation for configuring fallback destinations
Date Mon, 15 Jul 2019 19:08:00 GMT

    [ https://issues.apache.org/jira/browse/DISPATCH-1381?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16885529#comment-16885529
] 

ASF GitHub Bot commented on DISPATCH-1381:
------------------------------------------

ted-ross commented on 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


> Create documentation for configuring fallback destinations
> ----------------------------------------------------------
>
>                 Key: DISPATCH-1381
>                 URL: https://issues.apache.org/jira/browse/DISPATCH-1381
>             Project: Qpid Dispatch
>          Issue Type: Improvement
>          Components: Documentation
>            Reporter: Ben Hardesty
>            Priority: Major
>
> The Dispatch Router documentation should be updated to describe how to configure fallback
destinations for an address (DISPATCH-1337).



--
This message was sent by Atlassian JIRA
(v7.6.14#76016)

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


Mime
View raw message