2017-02-25 00:55:44 +00:00
|
|
|
---
|
|
|
|
layout: "docs"
|
|
|
|
page_title: "Commands: Operator Autopilot"
|
|
|
|
sidebar_current: "docs-commands-operator-autopilot"
|
|
|
|
description: >
|
|
|
|
The operator autopilot subcommand is used to view and modify Consul's Autopilot configuration.
|
|
|
|
---
|
|
|
|
|
|
|
|
# Consul Operator Autopilot
|
|
|
|
|
|
|
|
Command: `consul operator autopilot`
|
|
|
|
|
|
|
|
The Autopilot operator command is used to interact with Consul's Autopilot subsystem. The
|
2017-03-30 04:14:26 +00:00
|
|
|
command can be used to view or modify the current Autopilot configuration. See the
|
2019-05-15 15:49:41 +00:00
|
|
|
[Autopilot Guide](https://learn.hashicorp.com/consul/day-2-operations/autopilot) for more information about Autopilot.
|
2017-02-25 00:55:44 +00:00
|
|
|
|
|
|
|
```text
|
|
|
|
Usage: consul operator autopilot <subcommand> [options]
|
|
|
|
|
|
|
|
The Autopilot operator command is used to interact with Consul's Autopilot
|
|
|
|
subsystem. The command can be used to view or modify the current configuration.
|
|
|
|
|
|
|
|
Subcommands:
|
|
|
|
|
|
|
|
get-config Display the current Autopilot configuration
|
|
|
|
set-config Modify the current Autopilot configuration
|
|
|
|
```
|
|
|
|
|
|
|
|
## get-config
|
|
|
|
|
|
|
|
This command displays the current Raft peer configuration.
|
|
|
|
|
|
|
|
Usage: `consul operator autopilot get-config [options]`
|
|
|
|
|
|
|
|
#### API Options
|
|
|
|
|
|
|
|
<%= partial "docs/commands/http_api_options_client" %>
|
|
|
|
<%= partial "docs/commands/http_api_options_server" %>
|
|
|
|
|
|
|
|
The output looks like this:
|
|
|
|
|
|
|
|
```
|
2017-02-28 22:23:14 +00:00
|
|
|
CleanupDeadServers = true
|
2017-03-01 22:04:40 +00:00
|
|
|
LastContactThreshold = 200ms
|
|
|
|
MaxTrailingLogs = 250
|
|
|
|
ServerStabilizationTime = 10s
|
2017-03-21 23:36:44 +00:00
|
|
|
RedundancyZoneTag = ""
|
|
|
|
DisableUpgradeMigration = false
|
2017-07-18 21:01:21 +00:00
|
|
|
UpgradeMigrationTag = ""
|
2017-02-25 00:55:44 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
## set-config
|
|
|
|
|
|
|
|
Modifies the current Autopilot configuration.
|
|
|
|
|
|
|
|
Usage: `consul operator autopilot set-config [options]`
|
|
|
|
|
|
|
|
#### API Options
|
|
|
|
|
|
|
|
<%= partial "docs/commands/http_api_options_client" %>
|
|
|
|
<%= partial "docs/commands/http_api_options_server" %>
|
|
|
|
|
|
|
|
#### Command Options
|
|
|
|
|
2017-02-28 22:23:14 +00:00
|
|
|
* `-cleanup-dead-servers` - Specifies whether to enable automatic removal of dead servers
|
2017-02-25 00:55:44 +00:00
|
|
|
upon the successful joining of new servers to the cluster. Must be one of `[true|false]`.
|
|
|
|
|
2017-03-21 23:36:44 +00:00
|
|
|
* `-last-contact-threshold` - Controls the maximum amount of time a server can go without contact
|
2017-03-10 00:43:07 +00:00
|
|
|
from the leader before being considered unhealthy. Must be a duration value such as `200ms`.
|
2017-03-01 22:04:40 +00:00
|
|
|
|
2017-03-21 23:36:44 +00:00
|
|
|
* `-max-trailing-logs` - Controls the maximum number of log entries that a server can trail
|
2017-03-01 22:04:40 +00:00
|
|
|
the leader by before being considered unhealthy.
|
|
|
|
|
2020-02-03 09:59:53 +00:00
|
|
|
* `-min-quorum` - Sets the minimum number of servers required in a cluster
|
|
|
|
before autopilot is allowed to prune dead servers.
|
|
|
|
|
2017-03-21 23:36:44 +00:00
|
|
|
* `-server-stabilization-time` - Controls the minimum amount of time a server must be stable in
|
2017-03-01 22:04:40 +00:00
|
|
|
the 'healthy' state before being added to the cluster. Only takes effect if all servers are
|
|
|
|
running Raft protocol version 3 or higher. Must be a duration value such as `10s`.
|
|
|
|
|
2017-03-21 23:36:44 +00:00
|
|
|
* `-disable-upgrade-migration` - (Enterprise-only) Controls whether Consul will avoid promoting
|
|
|
|
new servers until it can perform a migration. Must be one of `[true|false]`.
|
|
|
|
|
|
|
|
* `-redundancy-zone-tag`- (Enterprise-only) Controls the [`-node-meta`](/docs/agent/options.html#_node_meta)
|
|
|
|
key name used for separating servers into different redundancy zones.
|
|
|
|
|
2017-07-18 21:01:21 +00:00
|
|
|
* `-upgrade-version-tag` - (Enterprise-only) Controls the [`-node-meta`](/docs/agent/options.html#_node_meta)
|
|
|
|
tag to use for version info when performing upgrade migrations. If left blank, the Consul version will be used.
|
|
|
|
|
2017-02-25 00:55:44 +00:00
|
|
|
The output looks like this:
|
|
|
|
|
|
|
|
```
|
|
|
|
Configuration updated!
|
|
|
|
```
|
|
|
|
|
|
|
|
The return code will indicate success or failure.
|