2014-10-14 00:46:41 +00:00
|
|
|
---
|
|
|
|
layout: "docs"
|
|
|
|
page_title: "Frequently Asked Questions"
|
|
|
|
sidebar_current: "docs-faq"
|
|
|
|
---
|
|
|
|
|
|
|
|
# Frequently Asked Questions
|
|
|
|
|
|
|
|
## Q: Why is virtual memory usage high?
|
|
|
|
|
|
|
|
Consul makes use of [LMDB](http://symas.com/mdb/) internally for various data
|
|
|
|
storage purposes. LMDB relies on using memory-mapping, a technique in which
|
|
|
|
a sparse file is represented as a contiguous range of memory. Consul configures
|
2015-03-05 22:56:41 +00:00
|
|
|
high limits for these file sizes and as a result relies on large chunks of
|
|
|
|
virtual memory to be allocated. However, in practice, the limits are much larger
|
2014-10-14 00:46:41 +00:00
|
|
|
than any realistic deployment of Consul would ever use, and the resident memory or
|
|
|
|
physical memory used is much lower.
|
|
|
|
|
2014-10-14 01:03:39 +00:00
|
|
|
## Q: What is Checkpoint? / Does Consul call home?
|
|
|
|
|
|
|
|
Consul makes use of a HashiCorp service called [Checkpoint](http://checkpoint.hashicorp.com)
|
2014-10-20 06:26:38 +00:00
|
|
|
which is used to check for updates and critical security bulletins.
|
2015-03-05 22:56:41 +00:00
|
|
|
Only anonymous information, which cannot be used to identify the user or host, is
|
|
|
|
sent to Checkpoint . An anonymous ID is sent which helps de-duplicate warning messages.
|
|
|
|
This anonymous ID can can be disabled. In fact, using the Checkpoint service is optional
|
2014-10-14 01:03:39 +00:00
|
|
|
and can be disabled.
|
|
|
|
|
|
|
|
See [`disable_anonymous_signature`](/docs/agent/options.html#disable_anonymous_signature)
|
|
|
|
and [`disable_update_check`](/docs/agent/options.html#disable_update_check).
|
|
|
|
|
2015-02-07 00:37:34 +00:00
|
|
|
## Q: How does Atlas integration work?
|
2015-02-07 00:34:07 +00:00
|
|
|
|
|
|
|
Consul makes use of a HashiCorp service called [SCADA](http://scada.hashicorp.com)
|
2015-03-05 22:56:41 +00:00
|
|
|
(Supervisory Control And Data Acquisition). The SCADA system allows clients to maintain
|
|
|
|
long-running connections to Atlas. Atlas can in turn provide auto-join facilities for
|
|
|
|
Consul agents (supervisory control) and an integrated dashboard showing the health of
|
|
|
|
all connected agents (data acquisition).
|
2015-02-07 00:34:07 +00:00
|
|
|
|
2015-03-05 22:56:41 +00:00
|
|
|
Standard ACLs can be applied to the SCADA connection, ensuring that Atlas is given only
|
|
|
|
those privileges that make sense for your deployment.
|
2014-10-14 01:03:39 +00:00
|
|
|
|
2015-03-05 22:56:41 +00:00
|
|
|
Using the SCADA service is optional. SCADA is only enabled by opt-in.
|
|
|
|
|
|
|
|
See the [Atlas integration guide](/docs/guides/atlas.html) for more details.
|
2015-03-09 17:01:50 +00:00
|
|
|
|
2015-03-09 17:10:22 +00:00
|
|
|
## Q: Does Consul rely on UDP Broadcast or Multicast?
|
2015-03-09 17:01:50 +00:00
|
|
|
|
2015-03-09 17:10:22 +00:00
|
|
|
Consul uses the [Serf](https://serfdom.io) gossip protocol which relies on
|
|
|
|
TCP and UDP unicast. Broadcast and Multicast are rarely available in a multi-tenant
|
2015-03-09 17:01:50 +00:00
|
|
|
or cloud network environment. For that reason, Consul and Serf were both
|
|
|
|
designed to avoid any dependence on those capabilities.
|
|
|
|
|
2015-03-09 18:46:59 +00:00
|
|
|
## Q: Is Consul eventually or strongly consistent?
|
|
|
|
|
|
|
|
Consul has two important subsystems, the service catalog and the gossip protocol.
|
|
|
|
The service catalog stores all the nodes, service instances, health check data,
|
|
|
|
ACLs, and Key/Value information. It is strongly consistent, and replicated
|
|
|
|
using the [consensus protocol](/docs/internals/consensus.html).
|
|
|
|
|
|
|
|
The [gossip protocol](/docs/internals/gossip.html) is used to track which
|
|
|
|
nodes are part of the cluster and to detect a node or agent failure. This information
|
|
|
|
is eventually consistent by nature. When the servers detects a change in membership,
|
|
|
|
or receive a health update, they update the service catalog appropriately.
|
|
|
|
|
|
|
|
Because of this split, the answer to the question is subtle. Almost all client APIs
|
|
|
|
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.
|
|
|
|
|
2015-03-18 16:56:12 +00:00
|
|
|
## Q: Are failed nodes ever removed?
|
|
|
|
|
|
|
|
To prevent an accumulation of dead nodes, Consul will automatically reap failed
|
2015-03-18 21:27:30 +00:00
|
|
|
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.
|
2015-05-04 21:23:33 +00:00
|
|
|
|
|
|
|
## Q: Does Consul support delta updates for watchers or blocking queries?
|
|
|
|
|
|
|
|
Consul does not currently support sending a delta or a change only response
|
|
|
|
to a watcher or a blocking query. The API simply allows for an edge-trigger
|
|
|
|
return with the full result. A client should keep the results of their last
|
|
|
|
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.
|
|
|
|
|