Skip to content

Commit

Permalink
Add a bit on testing upgrades in advance
Browse files Browse the repository at this point in the history
  • Loading branch information
jefferai committed Mar 9, 2019
1 parent fc64a47 commit a94a4b8
Showing 1 changed file with 16 additions and 4 deletions.
20 changes: 16 additions & 4 deletions website/source/docs/upgrading/index.html.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,17 @@ found in the sidebar._

**Always** back up your data before upgrading! Vault does not make
backwards-compatibility guarantees for its data store. If you need to roll back
to a previous version of Vault, it is always a good idea to roll back your data
store as well.
to a previous version of Vault, you should roll back your data store as well.

## Testing the Upgrade

It's always a good idea to try to ensure that the upgrade will be successful in
your environment. The ideal way to do this is to take a snapshot of your data
and load it into a test cluster. However, if you are issuing secrets to third
party resources (cloud credentials, database credentials, etc.) ensure that you
do not allow external network connectivity during testing, in case credentials
expire. This prevents the test cluster from trying to revoke these resources
along with the non-test cluster.

## Non-HA Installations

Expand Down Expand Up @@ -81,6 +90,9 @@ upgrade notes which are found in the navigation menu for this documentation.

Upgrading installations of Vault which participate in [Enterprise Replication](/docs/enterprise/replication/index.html) requires the following basic order of operations:

- **Upgrade the replication secondary instances first** using appropriate guidance from the previous sections depending on whether each secondary instance is Non-HA or HA
- **Upgrade the replication secondary instances first** using appropriate
guidance from the previous sections depending on whether each secondary
instance is Non-HA or HA
- Verify functionality of each secondary instance after upgrading
- When satisfied with functionality of upgraded secondary instances, upgrade the primary instance
- When satisfied with functionality of upgraded secondary instances, upgrade
the primary instance

0 comments on commit a94a4b8

Please sign in to comment.