From c286fcc433b21531fed97d2d200615514ce397e6 Mon Sep 17 00:00:00 2001 From: Meggie Date: Mon, 12 Jul 2021 13:13:45 -0400 Subject: [PATCH] Add replication example to upgrade docs (#12040) --- website/content/docs/upgrading/index.mdx | 17 +++++++++++++++++ .../public/img/vault-replication-upgrade.png | Bin 0 -> 40558 bytes 2 files changed, 17 insertions(+) create mode 100644 website/public/img/vault-replication-upgrade.png diff --git a/website/content/docs/upgrading/index.mdx b/website/content/docs/upgrading/index.mdx index 526cec496f..5df8051381 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 0000000000000000000000000000000000000000..9ec513ebde100f4ed718995d500ed852db8f4654 GIT binary patch literal 40558 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