2017-09-08 02:10:34 +00:00
|
|
|
---
|
2020-01-18 00:18:09 +00:00
|
|
|
layout: docs
|
|
|
|
|
page_title: operator step-down - Command
|
2017-09-08 02:10:34 +00:00
|
|
|
description: |-
|
|
|
|
|
The "operator step-down" forces the Vault server at the given address to step
|
|
|
|
|
down from active duty.
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# operator step-down
|
|
|
|
|
|
2021-07-14 19:10:07 +00:00
|
|
|
The `operator step-down` forces the active Vault node within an [HA cluster](/docs/concepts/ha)
|
|
|
|
|
to step down from active duty. When executed against a non-active node, i.e. a
|
|
|
|
|
standby or [performance standby](/docs/enterprise/performance-standby) node,
|
|
|
|
|
the request will be forwarded to the active node. While the
|
|
|
|
|
affected node will have a delay before attempting to acquire
|
|
|
|
|
the leader lock again, if no other Vault nodes acquire the
|
|
|
|
|
lock beforehand, it is possible for the same node to re-acquire
|
|
|
|
|
the lock and become active again.
|
2017-09-08 02:10:34 +00:00
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
|
|
Force a Vault server to step down as the leader:
|
|
|
|
|
|
2020-05-21 17:18:17 +00:00
|
|
|
```shell-session
|
2017-09-08 02:10:34 +00:00
|
|
|
$ vault operator step-down
|
|
|
|
|
Success! Stepped down: http://127.0.0.1:8200
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
2020-01-22 20:05:41 +00:00
|
|
|
There are no flags beyond the [standard set of flags](/docs/commands)
|
2017-09-08 02:10:34 +00:00
|
|
|
included on all commands.
|
