luxolus
/
open-consul
2
0
Fork 0
Code Issues 1 Pull Requests Packages Releases Wiki Activity

website: Clarify outage vs forced server removal

This commit is contained in:
Armon Dadgar 2014-06-05 22:46:11 -07:00
parent 1fb6f3a344
commit a47db238bb
2 changed files with 21 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
website/source/docs/guides/outage.html.markdown
View File

@ -11,6 +11,12 @@ Do not panic! This is a critical first step. Depending on your
take only a single server failure for cluster unavailability. Recovery take only a single server failure for cluster unavailability. Recovery
requires an operator to intervene, but is straightforward. requires an operator to intervene, but is straightforward.
<div class="alert alert-block alert-warning">
This page covers recovery from Consul becoming unavailable due to a majority
of server nodes in a datacenter being lost. If you are just looking to
add or remove a server [see this page](/docs/guides/servers.html).
</div>
If you had only a single server and it has failed, simply restart it. If you had only a single server and it has failed, simply restart it.
Note that a single server configuration requires the `-bootstrap` flag. Note that a single server configuration requires the `-bootstrap` flag.
If that server cannot be recovered, you need to bring up a new server. If that server cannot be recovered, you need to bring up a new server.

15
website/source/docs/guides/servers.html.markdown
View File

@ -102,3 +102,18 @@ The leader should also emit various logs including:
At this point the node has been gracefully removed from the cluster, and At this point the node has been gracefully removed from the cluster, and
will shut down. will shut down.
## Forced Removal
In some cases, it may not be possible to gracefully remove a server. For example,
if the server simply fails, then there is no ability to issue a leave. Instead,
the cluster will detect the failure and replication will continuously retry.
If the server can be recovered, it is best to bring it back online and then gracefully
leave the cluster. However, if this is not a possibility, then the `force-leave` command
can be used to force removal of a server.
This is done by invoking that command with the name of the failed node. At this point,
the cluster leader will mark the node as having left the cluster and it will stop attempting
to replicate.