diff --git a/website/content/docs/upgrading/index.mdx b/website/content/docs/upgrading/index.mdx index 526cec496..5df805138 100644 --- a/website/content/docs/upgrading/index.mdx +++ b/website/content/docs/upgrading/index.mdx @@ -114,3 +114,20 @@ Upgrading installations of Vault which participate in [Enterprise Replication](/ - Verify functionality of each secondary instance after upgrading - When satisfied with functionality of upgraded secondary instances, upgrade the primary instance + +Upgrades of multiple replicated clusters can be complicated. Here is an +example. + +![Upgrading multiple replicated clusters](/img/vault-replication-upgrade.png) + +In the above scenario, the ideal upgrade procedure would be as follows, +verifying functionality after each cluster upgrade. + +1. Upgrade Clusters B and D, using the HA upgrade process above. These clusters + have no downstream clusters, so they should be upgraded first, but the + ordering of B vs D does not matter. +2. Upgrade Cluster C, which now has an upgraded downstream cluster (Cluster D). + Because Cluster C is a cluster, it should also use the HA upgrade process. +3. Finally, upgrade Cluster A. All clusters downstream of A will already be + upgraded. It should be upgraded last, as it is a Performance Primary and a DR + Primary. diff --git a/website/public/img/vault-replication-upgrade.png b/website/public/img/vault-replication-upgrade.png new file mode 100644 index 000000000..2ed520fdc --- /dev/null +++ b/website/public/img/vault-replication-upgrade.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:86fdd419305f428390163120dea94aeeb969aa479e27fb6b6de339c3f27f91db +size 40558