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

     1  ---
     2  layout: "docs"
     3  page_title: "Commands: operator raft list-peers"
     4  sidebar_current: "docs-commands-operator-raft-list-peers"
     5  description: >
     6    Display the current Raft peer configuration.
     7  ---
     8  
     9  # Command: operator raft list-peers
    10  
    11  The Raft list-peers command is used to display the current Raft peer
    12  configuration.
    13  
    14  See the [Outage Recovery](/guides/outage.html) guide for some examples of how
    15  this command is used. For an API to perform these operations programmatically,
    16  please see the documentation for the [Operator](/api/operator.html)
    17  endpoint.
    18  
    19  ## Usage
    20  
    21  ```
    22  nomad operator raft list-peers [options]
    23  ```
    24  
    25  ## General Options
    26  
    27  <%= partial "docs/commands/_general_options" %>
    28  
    29  ## List Peers Options
    30  
    31  * `-stale`: The stale argument defaults to "false" which means the leader
    32  provides the result. If the cluster is in an outage state without a leader, you
    33  may need to set `-stale` to "true" to get the configuration from a non-leader
    34  server.
    35  
    36  ## Examples
    37  
    38  An example output with three servers is as follows:
    39  
    40  ```
    41  $ nomad operator raft list-peers
    42  Node                   ID               Address          State     Voter
    43  nomad-server01.global  10.10.11.5:4647  10.10.11.5:4647  follower  true
    44  nomad-server02.global  10.10.11.6:4647  10.10.11.6:4647  leader    true
    45  nomad-server03.global  10.10.11.7:4647  10.10.11.7:4647  follower  true
    46  ```
    47  
    48  - `Node` is the node name of the server, as known to Nomad, or "(unknown)" if
    49  the node is stale and not known.
    50  
    51  - `ID` is the ID of the server. This is the same as the `Address` but may  be
    52  upgraded to a GUID in a future version of Nomad.
    53  
    54  - `Address` is the IP:port for the server.
    55  
    56  - `State` is either "follower" or "leader" depending on the server's role in the
    57  Raft configuration.
    58  
    59  - `Voter` is "true" or "false", indicating if the server has a vote in the Raft
    60  configuration. Future versions of Nomad may add support for non-voting servers.