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.