[
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:
[email protected]
> 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: [email protected]
For additional commands, e-mail: [email protected]
