mirror of
https://github.com/taigrr/nats.docs
synced 2025-01-18 04:03:23 -08:00
updating docs
This commit is contained in:
ainsley
@@ -2387,7 +2387,7 @@
|
||||
<script>
|
||||
var gitbook = gitbook || [];
|
||||
gitbook.push(function() {
|
||||
gitbook.page.hasChanged({"page":{"title":"Channels","level":"6.3","depth":1,"next":{"title":"Message Log","level":"6.3.1","depth":2,"path":"nats_streaming/channels/message-log.md","ref":"nats_streaming/channels/message-log.md","articles":[]},"previous":{"title":"Client Connections","level":"6.2","depth":1,"path":"nats_streaming/client-connections.md","ref":"nats_streaming/client-connections.md","articles":[]},"dir":"ltr"},"config":{"plugins":["prism","-sharing","-highlight","include-html","toggle-chapters","anchors","edit-link"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"prism":{"lang":{"ascii":"markup","text":"markup"}},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"include-html":{},"fontsettings":{"theme":"white","family":"sans","size":2},"edit-link":{"label":"","base":"https://github.com/nats-io/docs/edit/master"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"anchors":{},"toggle-chapters":{}},"theme":"default","author":"The NATS Maintainers","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"NATS","gitbook":"*","description":"Administrative, developer and conceptual documentation for the NATS messaging system."},"file":{"path":"nats_streaming/channels/channels.md","mtime":"2019-05-30T22:52:52.326Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-07-25T22:29:27.003Z"},"basePath":"../..","book":{"language":""}});
|
||||
gitbook.page.hasChanged({"page":{"title":"Channels","level":"6.3","depth":1,"next":{"title":"Message Log","level":"6.3.1","depth":2,"path":"nats_streaming/channels/message-log.md","ref":"nats_streaming/channels/message-log.md","articles":[]},"previous":{"title":"Client Connections","level":"6.2","depth":1,"path":"nats_streaming/client-connections.md","ref":"nats_streaming/client-connections.md","articles":[]},"dir":"ltr"},"config":{"plugins":["prism","-sharing","-highlight","include-html","toggle-chapters","anchors","edit-link"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"prism":{"lang":{"ascii":"markup","text":"markup"}},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"include-html":{},"fontsettings":{"theme":"white","family":"sans","size":2},"edit-link":{"label":"","base":"https://github.com/nats-io/docs/edit/master"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"anchors":{},"toggle-chapters":{}},"theme":"default","author":"The NATS Maintainers","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"NATS","gitbook":"*","description":"Administrative, developer and conceptual documentation for the NATS messaging system."},"file":{"path":"nats_streaming/channels/channels.md","mtime":"2019-05-30T22:52:52.326Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-08-13T14:26:56.704Z"},"basePath":"../..","book":{"language":""}});
|
||||
});
|
||||
</script>
|
||||
</div>
|
||||
|
||||
@@ -2386,7 +2386,7 @@
|
||||
<script>
|
||||
var gitbook = gitbook || [];
|
||||
gitbook.push(function() {
|
||||
gitbook.page.hasChanged({"page":{"title":"Message Log","level":"6.3.1","depth":2,"next":{"title":"Subscriptions","level":"6.3.2","depth":2,"path":"nats_streaming/channels/subscriptions/subscriptions.md","ref":"nats_streaming/channels/subscriptions/subscriptions.md","articles":[{"title":"Regular","level":"6.3.2.1","depth":3,"path":"nats_streaming/channels/subscriptions/regular.md","ref":"nats_streaming/channels/subscriptions/regular.md","articles":[]},{"title":"Durable","level":"6.3.2.2","depth":3,"path":"nats_streaming/channels/subscriptions/durable.md","ref":"nats_streaming/channels/subscriptions/durable.md","articles":[]},{"title":"Queue Group","level":"6.3.2.3","depth":3,"path":"nats_streaming/channels/subscriptions/queue-group.md","ref":"nats_streaming/channels/subscriptions/queue-group.md","articles":[]},{"title":"Redelivery","level":"6.3.2.4","depth":3,"path":"nats_streaming/channels/subscriptions/redelivery.md","ref":"nats_streaming/channels/subscriptions/redelivery.md","articles":[]}]},"previous":{"title":"Channels","level":"6.3","depth":1,"path":"nats_streaming/channels/channels.md","ref":"nats_streaming/channels/channels.md","articles":[{"title":"Message Log","level":"6.3.1","depth":2,"path":"nats_streaming/channels/message-log.md","ref":"nats_streaming/channels/message-log.md","articles":[]},{"title":"Subscriptions","level":"6.3.2","depth":2,"path":"nats_streaming/channels/subscriptions/subscriptions.md","ref":"nats_streaming/channels/subscriptions/subscriptions.md","articles":[{"title":"Regular","level":"6.3.2.1","depth":3,"path":"nats_streaming/channels/subscriptions/regular.md","ref":"nats_streaming/channels/subscriptions/regular.md","articles":[]},{"title":"Durable","level":"6.3.2.2","depth":3,"path":"nats_streaming/channels/subscriptions/durable.md","ref":"nats_streaming/channels/subscriptions/durable.md","articles":[]},{"title":"Queue Group","level":"6.3.2.3","depth":3,"path":"nats_streaming/channels/subscriptions/queue-group.md","ref":"nats_streaming/channels/subscriptions/queue-group.md","articles":[]},{"title":"Redelivery","level":"6.3.2.4","depth":3,"path":"nats_streaming/channels/subscriptions/redelivery.md","ref":"nats_streaming/channels/subscriptions/redelivery.md","articles":[]}]}]},"dir":"ltr"},"config":{"plugins":["prism","-sharing","-highlight","include-html","toggle-chapters","anchors","edit-link"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"prism":{"lang":{"ascii":"markup","text":"markup"}},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"include-html":{},"fontsettings":{"theme":"white","family":"sans","size":2},"edit-link":{"label":"","base":"https://github.com/nats-io/docs/edit/master"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"anchors":{},"toggle-chapters":{}},"theme":"default","author":"The NATS Maintainers","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"NATS","gitbook":"*","description":"Administrative, developer and conceptual documentation for the NATS messaging system."},"file":{"path":"nats_streaming/channels/message-log.md","mtime":"2019-05-30T22:52:52.326Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-07-25T22:29:27.003Z"},"basePath":"../..","book":{"language":""}});
|
||||
gitbook.page.hasChanged({"page":{"title":"Message Log","level":"6.3.1","depth":2,"next":{"title":"Subscriptions","level":"6.3.2","depth":2,"path":"nats_streaming/channels/subscriptions/subscriptions.md","ref":"nats_streaming/channels/subscriptions/subscriptions.md","articles":[{"title":"Regular","level":"6.3.2.1","depth":3,"path":"nats_streaming/channels/subscriptions/regular.md","ref":"nats_streaming/channels/subscriptions/regular.md","articles":[]},{"title":"Durable","level":"6.3.2.2","depth":3,"path":"nats_streaming/channels/subscriptions/durable.md","ref":"nats_streaming/channels/subscriptions/durable.md","articles":[]},{"title":"Queue Group","level":"6.3.2.3","depth":3,"path":"nats_streaming/channels/subscriptions/queue-group.md","ref":"nats_streaming/channels/subscriptions/queue-group.md","articles":[]},{"title":"Redelivery","level":"6.3.2.4","depth":3,"path":"nats_streaming/channels/subscriptions/redelivery.md","ref":"nats_streaming/channels/subscriptions/redelivery.md","articles":[]}]},"previous":{"title":"Channels","level":"6.3","depth":1,"path":"nats_streaming/channels/channels.md","ref":"nats_streaming/channels/channels.md","articles":[{"title":"Message Log","level":"6.3.1","depth":2,"path":"nats_streaming/channels/message-log.md","ref":"nats_streaming/channels/message-log.md","articles":[]},{"title":"Subscriptions","level":"6.3.2","depth":2,"path":"nats_streaming/channels/subscriptions/subscriptions.md","ref":"nats_streaming/channels/subscriptions/subscriptions.md","articles":[{"title":"Regular","level":"6.3.2.1","depth":3,"path":"nats_streaming/channels/subscriptions/regular.md","ref":"nats_streaming/channels/subscriptions/regular.md","articles":[]},{"title":"Durable","level":"6.3.2.2","depth":3,"path":"nats_streaming/channels/subscriptions/durable.md","ref":"nats_streaming/channels/subscriptions/durable.md","articles":[]},{"title":"Queue Group","level":"6.3.2.3","depth":3,"path":"nats_streaming/channels/subscriptions/queue-group.md","ref":"nats_streaming/channels/subscriptions/queue-group.md","articles":[]},{"title":"Redelivery","level":"6.3.2.4","depth":3,"path":"nats_streaming/channels/subscriptions/redelivery.md","ref":"nats_streaming/channels/subscriptions/redelivery.md","articles":[]}]}]},"dir":"ltr"},"config":{"plugins":["prism","-sharing","-highlight","include-html","toggle-chapters","anchors","edit-link"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"prism":{"lang":{"ascii":"markup","text":"markup"}},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"include-html":{},"fontsettings":{"theme":"white","family":"sans","size":2},"edit-link":{"label":"","base":"https://github.com/nats-io/docs/edit/master"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"anchors":{},"toggle-chapters":{}},"theme":"default","author":"The NATS Maintainers","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"NATS","gitbook":"*","description":"Administrative, developer and conceptual documentation for the NATS messaging system."},"file":{"path":"nats_streaming/channels/message-log.md","mtime":"2019-05-30T22:52:52.326Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-08-13T14:26:56.704Z"},"basePath":"../..","book":{"language":""}});
|
||||
});
|
||||
</script>
|
||||
</div>
|
||||
|
||||
@@ -2341,9 +2341,9 @@
|
||||
<section class="normal markdown-section">
|
||||
|
||||
<h1 id="durable"><a name="durable" class="plugin-anchor" href="#durable"><i class="fa fa-link" aria-hidden="true"></i></a>Durable</h1>
|
||||
<p>If an application wishes to resume message consumption from where it previously stopped, it needs to create a durable subscription. It does so by providing a durable name, which is combined with the client ID provided when the client created its connection. The server then maintain the state for this subscription even after the client connection is closed.</p>
|
||||
<p>If an application wishes to resume message consumption from where it previously stopped, it needs to create a durable subscription. It does so by providing a durable name, which is combined with the client ID provided when the client created its connection. The server then maintains the state for this subscription even after the client connection is closed.</p>
|
||||
<p><strong><em>Note: The starting position given by the client when restarting a durable subscription is ignored.</em></strong></p>
|
||||
<p>When the application wants to stop receiving messages on a durable subscription, it should close - but <em>not unsubscribe</em>- this subscription. If a given client library does not have the option to close a subscription, the application should close the connection instead.</p>
|
||||
<p>When the application wants to stop receiving messages on a durable subscription, it should close - but <em>not unsubscribe</em> - this subscription. If a given client library does not have the option to close a subscription, the application should close the connection instead.</p>
|
||||
<p>When the application wants to delete the subscription, it must unsubscribe it. Once unsubscribed, the state is removed and it is then possible to re-use the durable name, but it will be considered a brand new durable subscription, with the start position being the one given by the client when creating the durable subscription.</p>
|
||||
|
||||
|
||||
@@ -2388,7 +2388,7 @@
|
||||
<script>
|
||||
var gitbook = gitbook || [];
|
||||
gitbook.push(function() {
|
||||
gitbook.page.hasChanged({"page":{"title":"Durable","level":"6.3.2.2","depth":3,"next":{"title":"Queue Group","level":"6.3.2.3","depth":3,"path":"nats_streaming/channels/subscriptions/queue-group.md","ref":"nats_streaming/channels/subscriptions/queue-group.md","articles":[]},"previous":{"title":"Regular","level":"6.3.2.1","depth":3,"path":"nats_streaming/channels/subscriptions/regular.md","ref":"nats_streaming/channels/subscriptions/regular.md","articles":[]},"dir":"ltr"},"config":{"plugins":["prism","-sharing","-highlight","include-html","toggle-chapters","anchors","edit-link"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"prism":{"lang":{"ascii":"markup","text":"markup"}},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"include-html":{},"fontsettings":{"theme":"white","family":"sans","size":2},"edit-link":{"label":"","base":"https://github.com/nats-io/docs/edit/master"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"anchors":{},"toggle-chapters":{}},"theme":"default","author":"The NATS Maintainers","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"NATS","gitbook":"*","description":"Administrative, developer and conceptual documentation for the NATS messaging system."},"file":{"path":"nats_streaming/channels/subscriptions/durable.md","mtime":"2019-05-30T22:52:52.326Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-07-25T22:29:27.003Z"},"basePath":"../../..","book":{"language":""}});
|
||||
gitbook.page.hasChanged({"page":{"title":"Durable","level":"6.3.2.2","depth":3,"next":{"title":"Queue Group","level":"6.3.2.3","depth":3,"path":"nats_streaming/channels/subscriptions/queue-group.md","ref":"nats_streaming/channels/subscriptions/queue-group.md","articles":[]},"previous":{"title":"Regular","level":"6.3.2.1","depth":3,"path":"nats_streaming/channels/subscriptions/regular.md","ref":"nats_streaming/channels/subscriptions/regular.md","articles":[]},"dir":"ltr"},"config":{"plugins":["prism","-sharing","-highlight","include-html","toggle-chapters","anchors","edit-link"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"prism":{"lang":{"ascii":"markup","text":"markup"}},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"include-html":{},"fontsettings":{"theme":"white","family":"sans","size":2},"edit-link":{"label":"","base":"https://github.com/nats-io/docs/edit/master"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"anchors":{},"toggle-chapters":{}},"theme":"default","author":"The NATS Maintainers","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"NATS","gitbook":"*","description":"Administrative, developer and conceptual documentation for the NATS messaging system."},"file":{"path":"nats_streaming/channels/subscriptions/durable.md","mtime":"2019-08-13T14:25:46.279Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-08-13T14:26:56.704Z"},"basePath":"../../..","book":{"language":""}});
|
||||
});
|
||||
</script>
|
||||
</div>
|
||||
|
||||
@@ -2342,7 +2342,7 @@
|
||||
|
||||
<h1 id="queue-group-in-nats-streaming"><a name="queue-group-in-nats-streaming" class="plugin-anchor" href="#queue-group-in-nats-streaming"><i class="fa fa-link" aria-hidden="true"></i></a>Queue Group in NATS Streaming</h1>
|
||||
<p>When consumers want to consume from the same channel but each receive a different message, as opposed to all receiving the same messages, they need to create a queue subscription. When a queue group name is specified, the server will send each messages from the log to a single consumer in the group. The distribution of these messages is not specified, therefore applications should not rely on an expected delivery scheme.</p>
|
||||
<p>After the first queue member is created, any other member joining the group will receive messages based on where the server is in the message log for that particular group. That means that starting position given by joining members is ignored by the server.</p>
|
||||
<p>After the first queue member is created, any other member joining the group will receive messages based on where the server is in the message log for that particular group. That means that the starting position given by joining members is ignored by the server.</p>
|
||||
<p>When the last member of the group leaves (subscription unsubscribed/closed/or connection closed), the group is removed from the server. The next application creating a subscription with the same name will create a new group, starting at the start position given in the subscription request.</p>
|
||||
<p>A queue subscription can also be durable. For that, the client needs to provide a queue and durable name. The behavior is, as you would expect, a combination of queue and durable subscription. Though unlike a durable subscription, the client ID is not part of the queue group name since the client ID must be unique, and would prevent more than one connection to participate in the queue group. The main difference between a queue subscription and a durable one, is that when the last member leaves the group, the state of the group will be maintained by the server. Later, when a member rejoins the group, the delivery will resume.</p>
|
||||
<p><strong><em>Note: For a durable queue subscription, the last member to </em> unsubscribe <em> (not simply close) causes the group to be removed from the server.</em></strong></p>
|
||||
@@ -2389,7 +2389,7 @@
|
||||
<script>
|
||||
var gitbook = gitbook || [];
|
||||
gitbook.push(function() {
|
||||
gitbook.page.hasChanged({"page":{"title":"Queue Group","level":"6.3.2.3","depth":3,"next":{"title":"Redelivery","level":"6.3.2.4","depth":3,"path":"nats_streaming/channels/subscriptions/redelivery.md","ref":"nats_streaming/channels/subscriptions/redelivery.md","articles":[]},"previous":{"title":"Durable","level":"6.3.2.2","depth":3,"path":"nats_streaming/channels/subscriptions/durable.md","ref":"nats_streaming/channels/subscriptions/durable.md","articles":[]},"dir":"ltr"},"config":{"plugins":["prism","-sharing","-highlight","include-html","toggle-chapters","anchors","edit-link"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"prism":{"lang":{"ascii":"markup","text":"markup"}},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"include-html":{},"fontsettings":{"theme":"white","family":"sans","size":2},"edit-link":{"label":"","base":"https://github.com/nats-io/docs/edit/master"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"anchors":{},"toggle-chapters":{}},"theme":"default","author":"The NATS Maintainers","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"NATS","gitbook":"*","description":"Administrative, developer and conceptual documentation for the NATS messaging system."},"file":{"path":"nats_streaming/channels/subscriptions/queue-group.md","mtime":"2019-06-25T14:14:34.661Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-07-25T22:29:27.003Z"},"basePath":"../../..","book":{"language":""}});
|
||||
gitbook.page.hasChanged({"page":{"title":"Queue Group","level":"6.3.2.3","depth":3,"next":{"title":"Redelivery","level":"6.3.2.4","depth":3,"path":"nats_streaming/channels/subscriptions/redelivery.md","ref":"nats_streaming/channels/subscriptions/redelivery.md","articles":[]},"previous":{"title":"Durable","level":"6.3.2.2","depth":3,"path":"nats_streaming/channels/subscriptions/durable.md","ref":"nats_streaming/channels/subscriptions/durable.md","articles":[]},"dir":"ltr"},"config":{"plugins":["prism","-sharing","-highlight","include-html","toggle-chapters","anchors","edit-link"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"prism":{"lang":{"ascii":"markup","text":"markup"}},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"include-html":{},"fontsettings":{"theme":"white","family":"sans","size":2},"edit-link":{"label":"","base":"https://github.com/nats-io/docs/edit/master"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"anchors":{},"toggle-chapters":{}},"theme":"default","author":"The NATS Maintainers","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"NATS","gitbook":"*","description":"Administrative, developer and conceptual documentation for the NATS messaging system."},"file":{"path":"nats_streaming/channels/subscriptions/queue-group.md","mtime":"2019-08-13T14:25:46.280Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-08-13T14:26:56.704Z"},"basePath":"../../..","book":{"language":""}});
|
||||
});
|
||||
</script>
|
||||
</div>
|
||||
|
||||
@@ -2342,9 +2342,9 @@
|
||||
|
||||
<h1 id="redelivery"><a name="redelivery" class="plugin-anchor" href="#redelivery"><i class="fa fa-link" aria-hidden="true"></i></a>Redelivery</h1>
|
||||
<p>When the server sends a message to a consumer, it expects to receive an ACK from this consumer. The consumer is the one specifying how long the server should wait before resending all unacknowledged messages to the consumer.</p>
|
||||
<p>When the server restarts and recovers unacknowledged messages for a subscription, it will first attempt to redelivery those messages before sending new messages. However, if during the initial redelivery some messages don't make it to the client, the server cannot know that and will enable delivery of new messages.</p>
|
||||
<p>When the server restarts and recovers unacknowledged messages for a subscription, it will first attempt to redeliver those messages before sending new messages. However, if during the initial redelivery some messages don't make it to the client, the server cannot know that and will enable delivery of new messages.</p>
|
||||
<p><strong><em>So it is possible for an application to receive redelivered messages mixed with new messages. This is typically what happens outside of the server restart scenario.</em></strong></p>
|
||||
<p>For queue subscriptions, if a member has unacknowledged messages, when this member <code>AckWait</code> (which is the duration given to the server before the server should attempt to redeliver unacknowledged messages) time elapses, the messages are redelivered to any other member in the group (including itself).</p>
|
||||
<p>For queue subscriptions, if a member has unacknowledged messages, when this member's <code>AckWait</code> (which is the duration given to the server before the server should attempt to redeliver unacknowledged messages) time elapses, the messages are redelivered to any other member in the group (including itself).</p>
|
||||
<p>If a queue member leaves the group, its unacknowledged messages are redistributed to other queue members.</p>
|
||||
|
||||
|
||||
@@ -2389,7 +2389,7 @@
|
||||
<script>
|
||||
var gitbook = gitbook || [];
|
||||
gitbook.push(function() {
|
||||
gitbook.page.hasChanged({"page":{"title":"Redelivery","level":"6.3.2.4","depth":3,"next":{"title":"Store Interface","level":"6.4","depth":1,"path":"nats_streaming/store-interface.md","ref":"nats_streaming/store-interface.md","articles":[]},"previous":{"title":"Queue Group","level":"6.3.2.3","depth":3,"path":"nats_streaming/channels/subscriptions/queue-group.md","ref":"nats_streaming/channels/subscriptions/queue-group.md","articles":[]},"dir":"ltr"},"config":{"plugins":["prism","-sharing","-highlight","include-html","toggle-chapters","anchors","edit-link"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"prism":{"lang":{"ascii":"markup","text":"markup"}},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"include-html":{},"fontsettings":{"theme":"white","family":"sans","size":2},"edit-link":{"label":"","base":"https://github.com/nats-io/docs/edit/master"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"anchors":{},"toggle-chapters":{}},"theme":"default","author":"The NATS Maintainers","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"NATS","gitbook":"*","description":"Administrative, developer and conceptual documentation for the NATS messaging system."},"file":{"path":"nats_streaming/channels/subscriptions/redelivery.md","mtime":"2019-05-30T22:52:52.326Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-07-25T22:29:27.003Z"},"basePath":"../../..","book":{"language":""}});
|
||||
gitbook.page.hasChanged({"page":{"title":"Redelivery","level":"6.3.2.4","depth":3,"next":{"title":"Store Interface","level":"6.4","depth":1,"path":"nats_streaming/store-interface.md","ref":"nats_streaming/store-interface.md","articles":[]},"previous":{"title":"Queue Group","level":"6.3.2.3","depth":3,"path":"nats_streaming/channels/subscriptions/queue-group.md","ref":"nats_streaming/channels/subscriptions/queue-group.md","articles":[]},"dir":"ltr"},"config":{"plugins":["prism","-sharing","-highlight","include-html","toggle-chapters","anchors","edit-link"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"prism":{"lang":{"ascii":"markup","text":"markup"}},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"include-html":{},"fontsettings":{"theme":"white","family":"sans","size":2},"edit-link":{"label":"","base":"https://github.com/nats-io/docs/edit/master"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"anchors":{},"toggle-chapters":{}},"theme":"default","author":"The NATS Maintainers","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"NATS","gitbook":"*","description":"Administrative, developer and conceptual documentation for the NATS messaging system."},"file":{"path":"nats_streaming/channels/subscriptions/redelivery.md","mtime":"2019-08-13T14:25:46.280Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-08-13T14:26:56.704Z"},"basePath":"../../..","book":{"language":""}});
|
||||
});
|
||||
</script>
|
||||
</div>
|
||||
|
||||
@@ -2385,7 +2385,7 @@
|
||||
<script>
|
||||
var gitbook = gitbook || [];
|
||||
gitbook.push(function() {
|
||||
gitbook.page.hasChanged({"page":{"title":"Regular","level":"6.3.2.1","depth":3,"next":{"title":"Durable","level":"6.3.2.2","depth":3,"path":"nats_streaming/channels/subscriptions/durable.md","ref":"nats_streaming/channels/subscriptions/durable.md","articles":[]},"previous":{"title":"Subscriptions","level":"6.3.2","depth":2,"path":"nats_streaming/channels/subscriptions/subscriptions.md","ref":"nats_streaming/channels/subscriptions/subscriptions.md","articles":[{"title":"Regular","level":"6.3.2.1","depth":3,"path":"nats_streaming/channels/subscriptions/regular.md","ref":"nats_streaming/channels/subscriptions/regular.md","articles":[]},{"title":"Durable","level":"6.3.2.2","depth":3,"path":"nats_streaming/channels/subscriptions/durable.md","ref":"nats_streaming/channels/subscriptions/durable.md","articles":[]},{"title":"Queue Group","level":"6.3.2.3","depth":3,"path":"nats_streaming/channels/subscriptions/queue-group.md","ref":"nats_streaming/channels/subscriptions/queue-group.md","articles":[]},{"title":"Redelivery","level":"6.3.2.4","depth":3,"path":"nats_streaming/channels/subscriptions/redelivery.md","ref":"nats_streaming/channels/subscriptions/redelivery.md","articles":[]}]},"dir":"ltr"},"config":{"plugins":["prism","-sharing","-highlight","include-html","toggle-chapters","anchors","edit-link"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"prism":{"lang":{"ascii":"markup","text":"markup"}},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"include-html":{},"fontsettings":{"theme":"white","family":"sans","size":2},"edit-link":{"label":"","base":"https://github.com/nats-io/docs/edit/master"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"anchors":{},"toggle-chapters":{}},"theme":"default","author":"The NATS Maintainers","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"NATS","gitbook":"*","description":"Administrative, developer and conceptual documentation for the NATS messaging system."},"file":{"path":"nats_streaming/channels/subscriptions/regular.md","mtime":"2019-05-30T22:52:52.327Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-07-25T22:29:27.003Z"},"basePath":"../../..","book":{"language":""}});
|
||||
gitbook.page.hasChanged({"page":{"title":"Regular","level":"6.3.2.1","depth":3,"next":{"title":"Durable","level":"6.3.2.2","depth":3,"path":"nats_streaming/channels/subscriptions/durable.md","ref":"nats_streaming/channels/subscriptions/durable.md","articles":[]},"previous":{"title":"Subscriptions","level":"6.3.2","depth":2,"path":"nats_streaming/channels/subscriptions/subscriptions.md","ref":"nats_streaming/channels/subscriptions/subscriptions.md","articles":[{"title":"Regular","level":"6.3.2.1","depth":3,"path":"nats_streaming/channels/subscriptions/regular.md","ref":"nats_streaming/channels/subscriptions/regular.md","articles":[]},{"title":"Durable","level":"6.3.2.2","depth":3,"path":"nats_streaming/channels/subscriptions/durable.md","ref":"nats_streaming/channels/subscriptions/durable.md","articles":[]},{"title":"Queue Group","level":"6.3.2.3","depth":3,"path":"nats_streaming/channels/subscriptions/queue-group.md","ref":"nats_streaming/channels/subscriptions/queue-group.md","articles":[]},{"title":"Redelivery","level":"6.3.2.4","depth":3,"path":"nats_streaming/channels/subscriptions/redelivery.md","ref":"nats_streaming/channels/subscriptions/redelivery.md","articles":[]}]},"dir":"ltr"},"config":{"plugins":["prism","-sharing","-highlight","include-html","toggle-chapters","anchors","edit-link"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"prism":{"lang":{"ascii":"markup","text":"markup"}},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"include-html":{},"fontsettings":{"theme":"white","family":"sans","size":2},"edit-link":{"label":"","base":"https://github.com/nats-io/docs/edit/master"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"anchors":{},"toggle-chapters":{}},"theme":"default","author":"The NATS Maintainers","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"NATS","gitbook":"*","description":"Administrative, developer and conceptual documentation for the NATS messaging system."},"file":{"path":"nats_streaming/channels/subscriptions/regular.md","mtime":"2019-05-30T22:52:52.327Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-08-13T14:26:56.704Z"},"basePath":"../../..","book":{"language":""}});
|
||||
});
|
||||
</script>
|
||||
</div>
|
||||
|
||||
@@ -2345,7 +2345,7 @@
|
||||
<p>If there are messages in the log for this channel, messages will be sent to the consumer when the subscription is created. The server will send up to the maximum number of inflight messages as given by the client when creating the subscription.</p>
|
||||
<p>When receiving ACKs from the consumer, the server will then deliver more messages, if more are available.</p>
|
||||
<p>A subscription can be created to start at any point in the message log, either by message sequence, or by time.</p>
|
||||
<p>Following pages describe all types of subscription.</p>
|
||||
<p>The following pages describe all the types of subscriptions.</p>
|
||||
|
||||
|
||||
</section>
|
||||
@@ -2389,7 +2389,7 @@
|
||||
<script>
|
||||
var gitbook = gitbook || [];
|
||||
gitbook.push(function() {
|
||||
gitbook.page.hasChanged({"page":{"title":"Subscriptions","level":"6.3.2","depth":2,"next":{"title":"Regular","level":"6.3.2.1","depth":3,"path":"nats_streaming/channels/subscriptions/regular.md","ref":"nats_streaming/channels/subscriptions/regular.md","articles":[]},"previous":{"title":"Message Log","level":"6.3.1","depth":2,"path":"nats_streaming/channels/message-log.md","ref":"nats_streaming/channels/message-log.md","articles":[]},"dir":"ltr"},"config":{"plugins":["prism","-sharing","-highlight","include-html","toggle-chapters","anchors","edit-link"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"prism":{"lang":{"ascii":"markup","text":"markup"}},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"include-html":{},"fontsettings":{"theme":"white","family":"sans","size":2},"edit-link":{"label":"","base":"https://github.com/nats-io/docs/edit/master"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"anchors":{},"toggle-chapters":{}},"theme":"default","author":"The NATS Maintainers","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"NATS","gitbook":"*","description":"Administrative, developer and conceptual documentation for the NATS messaging system."},"file":{"path":"nats_streaming/channels/subscriptions/subscriptions.md","mtime":"2019-05-30T22:52:52.327Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-07-25T22:29:27.003Z"},"basePath":"../../..","book":{"language":""}});
|
||||
gitbook.page.hasChanged({"page":{"title":"Subscriptions","level":"6.3.2","depth":2,"next":{"title":"Regular","level":"6.3.2.1","depth":3,"path":"nats_streaming/channels/subscriptions/regular.md","ref":"nats_streaming/channels/subscriptions/regular.md","articles":[]},"previous":{"title":"Message Log","level":"6.3.1","depth":2,"path":"nats_streaming/channels/message-log.md","ref":"nats_streaming/channels/message-log.md","articles":[]},"dir":"ltr"},"config":{"plugins":["prism","-sharing","-highlight","include-html","toggle-chapters","anchors","edit-link"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"prism":{"lang":{"ascii":"markup","text":"markup"}},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"include-html":{},"fontsettings":{"theme":"white","family":"sans","size":2},"edit-link":{"label":"","base":"https://github.com/nats-io/docs/edit/master"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"anchors":{},"toggle-chapters":{}},"theme":"default","author":"The NATS Maintainers","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"NATS","gitbook":"*","description":"Administrative, developer and conceptual documentation for the NATS messaging system."},"file":{"path":"nats_streaming/channels/subscriptions/subscriptions.md","mtime":"2019-08-13T14:25:46.280Z","type":"markdown"},"gitbook":{"version":"3.2.3","time":"2019-08-13T14:26:56.704Z"},"basePath":"../../..","book":{"language":""}});
|
||||
});
|
||||
</script>
|
||||
</div>
|
||||
|
||||
Reference in New Issue
Block a user