From bb7c3b75a3240c8d9c3f4980adc8f4feb6ac9ca3 Mon Sep 17 00:00:00 2001 From: Sean Chittenden Date: Wed, 20 Apr 2016 18:46:01 -0400 Subject: [PATCH 1/2] Fix broken markdown --- website/source/docs/agent/options.html.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/source/docs/agent/options.html.markdown b/website/source/docs/agent/options.html.markdown index aabc31e232..4a66aa63d6 100644 --- a/website/source/docs/agent/options.html.markdown +++ b/website/source/docs/agent/options.html.markdown @@ -516,7 +516,7 @@ Consul will not enable TLS for the HTTP API unless the `https` port has been ass is implemented and enforced (i.e. DNS answers are always sorted and therefore never random), clients may need to set this value to `1` to preserve the expected randomized distribution behavior (note: - [https://tools.ietf.org/html/rfc3484](RFC 3484) has been obsoleted by + [RFC 3484](https://tools.ietf.org/html/rfc3484) has been obsoleted by [RFC 6724](https://tools.ietf.org/html/rfc6724) and as a result it should be increasingly uncommon to need to change this value with modern resolvers). From 0c7f697244b5dcdc8d69d4c63faa8299f3b1fca1 Mon Sep 17 00:00:00 2001 From: Sean Chittenden Date: Thu, 21 Apr 2016 14:24:41 -0700 Subject: [PATCH 2/2] Tweak discussion regarding reaping to advise against adjusting these values. --- website/source/docs/agent/basics.html.markdown | 10 ++++++---- website/source/docs/faq.html.markdown | 12 ++++++++---- 2 files changed, 14 insertions(+), 8 deletions(-) diff --git a/website/source/docs/agent/basics.html.markdown b/website/source/docs/agent/basics.html.markdown index f610cf69eb..e86fe8958c 100644 --- a/website/source/docs/agent/basics.html.markdown +++ b/website/source/docs/agent/basics.html.markdown @@ -135,7 +135,9 @@ 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 (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 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 configurable +interval of 72 hours (changing the reap interval is *not* recommended due to +its consequences during outage situations). 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 60281b52c5..31d73791f4 100644 --- a/website/source/docs/faq.html.markdown +++ b/website/source/docs/faq.html.markdown @@ -59,10 +59,14 @@ the current state of the catalog can lag behind until the state is reconciled. ## Q: Are _failed_ or _left_ nodes ever removed? -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 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 configurable +interval of 72 hours. Reaping is similar to leaving, causing all associated +services to be deregistered. Changing the reap interval for aesthetic +reasons to trim the number of _failed_ or _left_ nodes is not advised (nodes +in the _failed_ or _left_ state do not cause any additional burden on +Consul). ## Q: Does Consul support delta updates for watchers or blocking queries?