github.com/Ilhicas/nomad@v1.0.4-0.20210304152020-e86851182bc3/website/content/docs/commands/operator/raft-remove-peer.mdx (about)

     1  ---
     2  layout: docs
     3  page_title: 'Commands: operator raft remove-peer'
     4  sidebar_title: 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 server members`]
    17  command, it is preferable to clean up by running [`nomad server force-leave`]
    18  instead of this command.
    19  
    20  See the [Outage Recovery] guide for some examples of how this command is used.
    21  For an API to perform these operations programmatically, please see the
    22  documentation for the [Operator] endpoint.
    23  
    24  ## Usage
    25  
    26  ```plaintext
    27  nomad operator raft remove-peer [options]
    28  ```
    29  
    30  If ACLs are enabled, this command requires a management token.
    31  
    32  ## General Options
    33  
    34  @include 'general_options_no_namespace.mdx'
    35  
    36  ## Remove Peer Options
    37  
    38  - `-peer-address`: Remove a Nomad server with given address from the Raft
    39    configuration. The format is "IP:port"
    40  
    41  - `-peer-id`: Remove a Nomad server with the given ID from the Raft
    42    configuration. The format is "id"
    43  
    44  [`nomad server force-leave`]: /docs/commands/server/force-leave 'Nomad server force-leave command'
    45  [`nomad server members`]: /docs/commands/server/members 'Nomad server members command'
    46  [operator]: /api-docs/operator 'Nomad Operator API'
    47  [outage recovery]: https://learn.hashicorp.com/tutorials/nomad/outage-recovery