2016-08-30 02:09:57 +00:00
|
|
|
---
|
|
|
|
layout: "docs"
|
|
|
|
page_title: "Commands: Operator"
|
|
|
|
sidebar_current: "docs-commands-operator"
|
|
|
|
description: >
|
|
|
|
The operator command provides cluster-level tools for Consul operators.
|
|
|
|
---
|
|
|
|
|
|
|
|
# Consul Operator
|
|
|
|
|
|
|
|
Command: `consul operator`
|
|
|
|
|
|
|
|
The `operator` command provides cluster-level tools for Consul operators, such
|
|
|
|
as interacting with the Raft subsystem. This was added in Consul 0.7.
|
|
|
|
|
|
|
|
~> Use this command with extreme caution, as improper use could lead to a Consul
|
|
|
|
outage and even loss of data.
|
|
|
|
|
2016-11-16 09:01:51 +00:00
|
|
|
If ACLs are enabled then a token with operator privileges may be required in
|
2016-08-30 02:09:57 +00:00
|
|
|
order to use this command. Requests are forwarded internally to the leader
|
|
|
|
if required, so this can be run from any Consul node in a cluster. See the
|
|
|
|
[ACL](/docs/internals/acl.html#operator) internals guide for more information.
|
|
|
|
|
|
|
|
See the [Outage Recovery](/docs/guides/outage.html) guide for some examples of how
|
|
|
|
this command is used. For an API to perform these operations programatically,
|
|
|
|
please see the documentation for the [Operator](/docs/agent/http/operator.html)
|
|
|
|
endpoint.
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
2017-02-15 21:30:07 +00:00
|
|
|
```text
|
|
|
|
Usage: consul operator <subcommand> [options]
|
2016-08-30 02:09:57 +00:00
|
|
|
|
2017-02-15 21:30:07 +00:00
|
|
|
# ...
|
2016-08-30 02:09:57 +00:00
|
|
|
|
2017-02-15 21:30:07 +00:00
|
|
|
Subcommands:
|
2016-08-30 02:09:57 +00:00
|
|
|
|
2017-02-15 21:30:07 +00:00
|
|
|
raft Provides cluster-level tools for Consul operators
|
2016-08-30 02:09:57 +00:00
|
|
|
```
|
|
|
|
|
2017-02-15 21:30:07 +00:00
|
|
|
For more information, examples, and usage about a subcommand, click on the name
|
|
|
|
of the subcommand in the sidebar or one of the links below:
|
2016-08-30 20:15:37 +00:00
|
|
|
|
2017-02-15 21:30:07 +00:00
|
|
|
- [raft] (/docs/commands/operator/raft.html)
|