2016-08-30 02:09:57 +00:00
|
|
|
---
|
2020-09-01 15:14:13 +00:00
|
|
|
layout: commands
|
2020-04-07 18:55:19 +00:00
|
|
|
page_title: 'Commands: Operator'
|
|
|
|
description: |
|
2016-08-30 02:09:57 +00:00
|
|
|
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
|
2020-04-07 18:55:19 +00:00
|
|
|
outage and even loss of data.
|
2016-08-30 02:09:57 +00:00
|
|
|
|
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
|
2020-09-01 15:14:13 +00:00
|
|
|
if required, so this can be run from any Consul node in a cluster. See the
|
2022-09-06 15:35:01 +00:00
|
|
|
[ACL Guide](https://learn.hashicorp.com/tutorials/consul/access-control-setup-production) for more information.
|
2016-08-30 02:09:57 +00:00
|
|
|
|
2022-09-06 15:35:01 +00:00
|
|
|
See the [Outage Recovery](https://learn.hashicorp.com/tutorials/consul/recovery-outage) guide for some examples of how
|
2018-03-19 16:56:00 +00:00
|
|
|
this command is used. For an API to perform these operations programmatically,
|
2022-03-30 21:16:26 +00:00
|
|
|
please see the documentation for the [Operator](/api-docs/operator)
|
2016-08-30 02:09:57 +00:00
|
|
|
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-03-28 17:31:56 +00:00
|
|
|
area Provides tools for working with network areas (Enterprise-only)
|
2017-02-25 00:55:44 +00:00
|
|
|
autopilot Provides tools for modifying Autopilot configuration
|
|
|
|
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
|
|
|
|
2020-10-14 15:23:05 +00:00
|
|
|
- [area](/commands/operator/area) <EnterpriseAlert inline />
|
|
|
|
- [autopilot](/commands/operator/autopilot)
|
|
|
|
- [raft](/commands/operator/raft)
|