f2615992a4
The `nomad operator raft` and `nomad operator snapshot state` subcommands for inspecting on-disk raft state were hidden and undocumented. Expose and document these so that advanced operators have support for these tools.
47 lines
1.3 KiB
Plaintext
47 lines
1.3 KiB
Plaintext
---
|
|
layout: docs
|
|
page_title: 'Commands: operator raft state'
|
|
description: |
|
|
Display Raft server state.
|
|
---
|
|
|
|
# Command: operator raft state
|
|
|
|
The `raft state` command is used to display the server state obtained by
|
|
replaying raft log entries persisted in the Nomad [data directory] in
|
|
JSON format.
|
|
|
|
This command requires file system permissions to access the data
|
|
directory on disk. The Nomad server locks access to the data
|
|
directory, so this command cannot be run on a data directory that is
|
|
being used by a running Nomad server.
|
|
|
|
~> **Warning:** This is a low-level debugging tool and not subject to
|
|
Nomad's usual backward compatibility guarantees.
|
|
|
|
## Usage
|
|
|
|
```plaintext
|
|
nomad operator raft state [options] <path to data dir>
|
|
```
|
|
|
|
## Raft State Options
|
|
|
|
- `-last-index=<last_index>`: Set the last log index to be applied, to
|
|
drop spurious log entries not properly committed. If the
|
|
`last_index` option is zero or negative, it's treated as an offset
|
|
from the last index seen in raft.
|
|
|
|
## Examples
|
|
|
|
The output of this command can be very large, so it's recommended that
|
|
you redirect the output to a file for later examination with other
|
|
tools.
|
|
|
|
```shell-session
|
|
$ sudo nomad operator raft state /var/nomad/data > ~/raft-state.json
|
|
$ jq . < ~/raft-state.json
|
|
```
|
|
|
|
[data directory]: /docs/configuration#data_dir
|