From 5d2320170cefed1aac78832864d040da9befdb52 Mon Sep 17 00:00:00 2001
From: hc-github-team-secure-vault-core
 <82990506+hc-github-team-secure-vault-core@users.noreply.github.com>
Date: Fri, 23 Jun 2023 11:55:15 -0400
Subject: [PATCH] backport of commit a71cdb616567fbcd05c257ba3535d1e2297a9647
 (#21445)

Co-authored-by: Jason O'Donnell <2160810+jasonodonnell@users.noreply.github.com>
---
 .../content/docs/upgrading/upgrade-to-1.13.x.mdx |  2 ++
 .../content/docs/upgrading/upgrade-to-1.14.x.mdx |  2 +-
 .../known-issues/update-primary-addrs-panic.mdx  | 16 ++++++++++++++++
 .../partials/update-primary-addrs-panic.mdx      | 16 ++++++++++++++++
 4 files changed, 35 insertions(+), 1 deletion(-)
 create mode 100644 website/content/partials/known-issues/update-primary-addrs-panic.mdx
 create mode 100644 website/content/partials/update-primary-addrs-panic.mdx

diff --git a/website/content/docs/upgrading/upgrade-to-1.13.x.mdx b/website/content/docs/upgrading/upgrade-to-1.13.x.mdx
index f43bfb05d..95329d127 100644
--- a/website/content/docs/upgrading/upgrade-to-1.13.x.mdx
+++ b/website/content/docs/upgrading/upgrade-to-1.13.x.mdx
@@ -161,3 +161,5 @@ Affects Vault 1.13.0+
 @include 'update-primary-known-issue.mdx'
 
 @include 'pki-double-migration-bug.mdx'
+
+@include 'update-primary-addrs-panic.mdx'
\ No newline at end of file
diff --git a/website/content/docs/upgrading/upgrade-to-1.14.x.mdx b/website/content/docs/upgrading/upgrade-to-1.14.x.mdx
index e157a7d63..9877bcd3b 100644
--- a/website/content/docs/upgrading/upgrade-to-1.14.x.mdx
+++ b/website/content/docs/upgrading/upgrade-to-1.14.x.mdx
@@ -36,4 +36,4 @@ There are no major changes to announce at this time.
 
 @include 'known-issues/update-primary-data-loss.mdx'
 
-
+@include 'known-issues/update-primary-addrs-panic.mdx'
\ No newline at end of file
diff --git a/website/content/partials/known-issues/update-primary-addrs-panic.mdx b/website/content/partials/known-issues/update-primary-addrs-panic.mdx
new file mode 100644
index 000000000..d7e63828e
--- /dev/null
+++ b/website/content/partials/known-issues/update-primary-addrs-panic.mdx
@@ -0,0 +1,16 @@
+### Using 'update_primary_addrs' on a demoted cluster causes Vault to panic ((#update-primary-addrs-panic))
+
+#### Affected versions
+
+- 1.13.3, 1.13.4 & 1.14.0
+
+#### Issue
+
+If the [`update_primary_addrs`](/vault/api-docs/system/replication/replication-performance#update_primary_addrs)
+parameter is used on a recently demoted cluster, Vault will panic due to no longer 
+having information about the primary cluster.
+
+#### Workaround
+
+Instead of using `update_primary_addrs` on the recently demoted cluster, instead provide an 
+[activation token](/vault/api-docs/system/replication/replication-performance#token-1).
\ No newline at end of file
diff --git a/website/content/partials/update-primary-addrs-panic.mdx b/website/content/partials/update-primary-addrs-panic.mdx
new file mode 100644
index 000000000..d7e63828e
--- /dev/null
+++ b/website/content/partials/update-primary-addrs-panic.mdx
@@ -0,0 +1,16 @@
+### Using 'update_primary_addrs' on a demoted cluster causes Vault to panic ((#update-primary-addrs-panic))
+
+#### Affected versions
+
+- 1.13.3, 1.13.4 & 1.14.0
+
+#### Issue
+
+If the [`update_primary_addrs`](/vault/api-docs/system/replication/replication-performance#update_primary_addrs)
+parameter is used on a recently demoted cluster, Vault will panic due to no longer 
+having information about the primary cluster.
+
+#### Workaround
+
+Instead of using `update_primary_addrs` on the recently demoted cluster, instead provide an 
+[activation token](/vault/api-docs/system/replication/replication-performance#token-1).
\ No newline at end of file