Skip to content

Commit

Permalink
Update vault-ha-upgrade.mdx to not step-down during upgrades (#24457)
Browse files Browse the repository at this point in the history
Due to the reported issue under #24441, we identified that there are users issuing step-down during the upgrade, which is unintended.

We modified the documentation to make it clear that step-down should not be attempted, in addition rephrased the sentence with "step-down" word and exclude that term to avoid confusion.
  • Loading branch information
jpenghashi committed May 1, 2024
1 parent e6a4b82 commit e17b57f
Showing 1 changed file with 9 additions and 2 deletions.
11 changes: 9 additions & 2 deletions website/content/docs/upgrading/vault-ha-upgrade.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -68,12 +68,19 @@ active duty.

To complete the cluster upgrade:

1. Properly shut down the remaining (active) node
1. Properly shut down the remaining (active) node via `SIGINT` or `SIGTERM`

<Warning title="Important">

DO NOT attempt to issue a [step-down](/vault/docs/commands/operator/step-down)
operation at any time during the upgrade process.

</Warning>

<Note>

It is important that you shut the node down properly.
This will perform a step-down and release the HA lock, allowing a standby
This will release the current leadership and the HA lock, allowing a standby
node to take over with a very short delay.
If you kill Vault without letting it release the lock, a standby node will
not be able to take over until the lock's timeout period has expired. This
Expand Down

0 comments on commit e17b57f

Please sign in to comment.