github.com/smintz/nomad@v0.8.3/website/source/docs/commands/operator/raft-remove-peer.html.md.erb (about)

     1  ---
     2  layout: "docs"
     3  page_title: "Commands: operator raft remove-peer"
     4  sidebar_current: "docs-commands-operator-raft-remove-peer"
     5  description: >
     6    Remove a Nomad server from the Raft configuration.
     7  ---
     8  
     9  # Command: operator raft remove-peer
    10  
    11  Remove the Nomad server with given address from the Raft configuration.
    12  
    13  There are rare cases where a peer may be left behind in the Raft quorum even
    14  though the server is no longer present and known to the cluster. This command
    15  can be used to remove the failed server so that it is no longer affects the Raft
    16  quorum. If the server still shows in the output of the [`nomad
    17  server members`](/docs/commands/server/members.html) command, it is preferable
    18  to clean up by simply running [`nomad
    19  server force-leave`](/docs/commands/server/force-leave.html) instead of this
    20  command.
    21  
    22  See the [Outage Recovery](/guides/outage.html) guide for some examples of how
    23  this command is used. For an API to perform these operations programmatically,
    24  please see the documentation for the [Operator](/api/operator.html)
    25  endpoint.
    26  
    27  ## Usage
    28  
    29  ```
    30  nomad operator raft remove-peer [options]
    31  ```
    32  
    33  ## General Options
    34  
    35  <%= partial "docs/commands/_general_options" %>
    36  
    37  ## Remove Peer Options
    38  
    39  * `-peer-address`: Remove a Nomad server with given address from the Raft
    40  configuration. The format is "IP:port"
    41  
    42  * `-peer-id`: Remove a Nomad server with the given ID from the Raft 
    43  configuration. The format is "id"