9d85195361
* Fix links to ACL guides * Managing Nomad guide links; links in jsx pages * job updates guide URLS * node-drain guide URLS * outage recovery guide links * fix guide links - sentinel * fix guide links - namespaces * fix guide links - quotas * fix guide links - autopilot * more guide links. * more guide links - continued. * Updating redirects for learn * Getting Started * Load Balancing Guides * update redirects for ui guide * Consolidate spark redirects to point to GH repo * operating job update part 1 * finish operating job links; operations guides links. * finish guide redirects * coalesce EOL redirects for spark guides. * one last link * Checked links and found a few more stray links * Found more .htmls * Fixup links for new HC websites * Post-merge fixups * linkcheck caught missing ids
46 lines
1.5 KiB
Plaintext
46 lines
1.5 KiB
Plaintext
---
|
|
layout: docs
|
|
page_title: 'Commands: operator raft remove-peer'
|
|
sidebar_title: raft remove-peer
|
|
description: |
|
|
Remove a Nomad server from the Raft configuration.
|
|
---
|
|
|
|
# Command: operator raft remove-peer
|
|
|
|
Remove the Nomad server with given address from the Raft configuration.
|
|
|
|
There are rare cases where a peer may be left behind in the Raft quorum even
|
|
though the server is no longer present and known to the cluster. This command
|
|
can be used to remove the failed server so that it is no longer affects the Raft
|
|
quorum. If the server still shows in the output of the [`nomad server members`]
|
|
command, it is preferable to clean up by running [`nomad server force-leave`]
|
|
instead of this command.
|
|
|
|
See the [Outage Recovery] guide for some examples of how this command is used.
|
|
For an API to perform these operations programmatically, please see the
|
|
documentation for the [Operator] endpoint.
|
|
|
|
## Usage
|
|
|
|
```plaintext
|
|
nomad operator raft remove-peer [options]
|
|
```
|
|
|
|
## General Options
|
|
|
|
@include 'general_options.mdx'
|
|
|
|
## Remove Peer Options
|
|
|
|
- `-peer-address`: Remove a Nomad server with given address from the Raft
|
|
configuration. The format is "IP:port"
|
|
|
|
- `-peer-id`: Remove a Nomad server with the given ID from the Raft
|
|
configuration. The format is "id"
|
|
|
|
[`nomad server force-leave`]: /docs/commands/server/force-leave 'Nomad server force-leave command'
|
|
[`nomad server members`]: /docs/commands/server/members 'Nomad server members command'
|
|
[operator]: /api-docs/operator 'Nomad Operator API'
|
|
[outage recovery]: https://learn.hashicorp.com/tutorials/nomad/outage-recovery
|