From 92b86f0631c6e5d9334a87b782f2f8f083e35c23 Mon Sep 17 00:00:00 2001 From: Cameron Stokes Date: Thu, 6 Aug 2015 17:37:48 -0700 Subject: [PATCH] Added detail about left/failed nodes and 72h reaping Ref: https://groups.google.com/forum/#!searchin/consul-tool/left/consul-tool/KVl0u91uCdw/bfzrUO4r-1QJ --- website/source/docs/agent/basics.html.markdown | 10 +++++----- website/source/docs/faq.html.markdown | 11 +++++------ 2 files changed, 10 insertions(+), 11 deletions(-) diff --git a/website/source/docs/agent/basics.html.markdown b/website/source/docs/agent/basics.html.markdown index 5dd0d415a..387fd8b6a 100644 --- a/website/source/docs/agent/basics.html.markdown +++ b/website/source/docs/agent/basics.html.markdown @@ -133,9 +133,9 @@ this. When a node _leaves_, it specifies its intent to do so, and the cluster marks that node as having _left_. Unlike the _failed_ case, all of the services provided by a node are immediately deregistered. If the agent was -a server, replication to it will stop. To prevent an accumulation -of dead nodes, Consul will automatically reap _failed_ nodes out of the -catalog as well. This is currently done on a non-configurable interval of -72 hours. Reaping is similar to leaving, causing all associated services -to be deregistered. +a server, replication to it will stop. +To prevent an accumulation of dead nodes (nodes in either _failed_ or _left_ states), +Consul will automatically remove dead nodes out of the catalog. This process is +called _reaping_. This is currently done on a non-configurable interval of 72 hours. +Reaping is similar to leaving, causing all associated services to be deregistered. diff --git a/website/source/docs/faq.html.markdown b/website/source/docs/faq.html.markdown index 0ca36376b..e99644d6e 100644 --- a/website/source/docs/faq.html.markdown +++ b/website/source/docs/faq.html.markdown @@ -67,12 +67,12 @@ interact with the service catalog and are strongly consistent. Updates to the catalog may come via the gossip protocol which is eventually consistent, meaning the current state of the catalog can lag behind until the state is reconciled. -## Q: Are failed nodes ever removed? +## Q: Are _failed_ or _left_ nodes ever removed? -To prevent an accumulation of dead nodes, Consul will automatically reap failed -nodes out of the catalog. This is currently done on a non-configurable interval -of 72 hours. Reaping is similar to leaving, causing all associated services to -be deregistered. +To prevent an accumulation of dead nodes (nodes in either _failed_ or _left_ states), +Consul will automatically remove dead nodes out of the catalog. This process is +called _reaping_. This is currently done on a non-configurable interval of 72 hours. +Reaping is similar to leaving, causing all associated services to be deregistered. ## Q: Does Consul support delta updates for watchers or blocking queries? @@ -84,4 +84,3 @@ read and compute the delta client side. By design, Consul offloads this to clients instead of attempting to support the delta calculation. This avoids expensive state maintenance on the servers as well as race conditions between data updates and watch registrations. -