open-consul/website/pages/docs/install/glossary.mdx

77 lines
3.1 KiB
Plaintext
Raw Normal View History

---
2020-04-07 18:55:19 +00:00
layout: docs
page_title: Glossary
sidebar_title: Glossary
2020-04-07 18:55:19 +00:00
description: >-
This page collects brief definitions of some of the technical terms used in
the documentation.
---
# Consul Glossary
This page collects brief definitions of some of the technical terms used in the documentation for Consul and Consul Enterprise, as well as some terms that come up frequently in conversations throughout the Consul community.
2020-04-06 20:27:35 +00:00
## Agent
An agent is the long running daemon on every member of the Consul cluster.
2020-04-06 20:27:35 +00:00
It is started by running `consul agent`. The agent is able to run in either _client_
or _server_ mode. Since all nodes must be running an agent, it is simpler to refer to
the node as being either a client or server, but there are other instances of the agent. All
agents can run the DNS or HTTP interfaces, and are responsible for running checks and
keeping services in sync.
## Client
A client is an agent that forwards all RPCs to a server. The client is relatively
stateless. The only background activity a client performs is taking part in the LAN gossip
pool. This has a minimal resource overhead and consumes only a small amount of network
bandwidth.
2020-04-06 20:27:35 +00:00
## Server
A server is an agent with an expanded set of responsibilities including
participating in the Raft quorum, maintaining cluster state, responding to RPC queries,
exchanging WAN gossip with other datacenters, and forwarding queries to leaders or
remote datacenters.
2020-04-06 20:27:35 +00:00
## Datacenter
We define a datacenter to be a networking environment that is
private, low latency, and high bandwidth. This excludes communication that would traverse
the public internet, but for our purposes multiple availability zones within a single EC2
region would be considered part of a single datacenter.
2020-04-06 20:27:35 +00:00
## Consensus
When used in our documentation we use consensus to mean agreement upon
the elected leader as well as agreement on the ordering of transactions. Since these
transactions are applied to a
[finite-state machine](https://en.wikipedia.org/wiki/Finite-state_machine), our definition
of consensus implies the consistency of a replicated state machine. Consensus is described
2020-04-06 20:27:35 +00:00
in more detail on [Wikipedia](<https://en.wikipedia.org/wiki/Consensus_(computer_science)>),
2020-04-09 23:46:54 +00:00
and our implementation is described [here](/docs/internals/consensus).
2020-04-06 20:27:35 +00:00
## Gossip
Consul is built on top of [Serf](https://www.serf.io/) which provides a full
[gossip protocol](https://en.wikipedia.org/wiki/Gossip_protocol) that is used for multiple purposes.
Serf provides membership, failure detection, and event broadcast. Our use of these
2020-04-09 23:46:54 +00:00
is described more in the [gossip documentation](/docs/internals/gossip). It is enough to know
that gossip involves random node-to-node communication, primarily over UDP.
2020-04-06 20:27:35 +00:00
## LAN Gossip
Refers to the LAN gossip pool which contains nodes that are all
located on the same local area network or datacenter.
2020-04-06 20:27:35 +00:00
## WAN Gossip
Refers to the WAN gossip pool which contains only servers. These
servers are primarily located in different datacenters and typically communicate
over the internet or wide area network.
2020-04-06 20:27:35 +00:00
## RPC
Remote Procedure Call. This is a request / response mechanism allowing a
2019-10-31 19:14:08 +00:00
client to make a request of a server.