From 8ff8d82405260ba5ceb984d49e148a8863993d6d Mon Sep 17 00:00:00 2001
From: Devon Campbell <devon@edgedb.com>
Date: Wed, 14 Feb 2024 07:52:40 -0500
Subject: [PATCH] Mention `--ignore-other-tenants` for upgrades

for when a PG cluster backs multiple versions of EdgeDB
---
 docs/changelog/2_x.rst | 6 ++++++
 docs/changelog/3_x.rst | 6 ++++++
 docs/changelog/4_x.rst | 6 ++++++
 3 files changed, 18 insertions(+)

diff --git a/docs/changelog/2_x.rst b/docs/changelog/2_x.rst
index bf90b535af3..4e90a24e378 100644
--- a/docs/changelog/2_x.rst
+++ b/docs/changelog/2_x.rst
@@ -70,6 +70,12 @@ the DSN of the newly created instance handy.
    Once the restore is complete, update your application to connect to the new
    instance.
 
+.. note::
+
+    If your Postgres cluster is also backing other versions of EdgeDB, make
+    sure you start your new instance with the ``--ignore-other-tenants``
+    option when bootstrapping your new instance.
+
 This process will involve some downtime, specifically during steps 2 and 3. We
 are working on an in-place upgrade workflow that will reduce the amount of
 downtime involved and avoid the need to spin up a new instance. We'll publish
diff --git a/docs/changelog/3_x.rst b/docs/changelog/3_x.rst
index 8392779d1d8..361b50e896f 100644
--- a/docs/changelog/3_x.rst
+++ b/docs/changelog/3_x.rst
@@ -140,6 +140,12 @@ dump-and-restore process.
 
    This process will involve some downtime, specifically during steps 2 and 3.
 
+.. note::
+
+    If your Postgres cluster is also backing other versions of EdgeDB, make
+    sure you start your new instance with the ``--ignore-other-tenants``
+    option when bootstrapping your new instance.
+
 **Pre-1.0 Instances**
 
 If you're still running pre-1.0 EdgeDB instances (e.g., 1.0-beta3) and want to
diff --git a/docs/changelog/4_x.rst b/docs/changelog/4_x.rst
index ad000f1508f..af99a68579e 100644
--- a/docs/changelog/4_x.rst
+++ b/docs/changelog/4_x.rst
@@ -100,6 +100,12 @@ dump-and-restore process.
 
    This process will involve some downtime, specifically during steps 2 and 3.
 
+.. note::
+
+    If your Postgres cluster is also backing other versions of EdgeDB, make
+    sure you start your new instance with the ``--ignore-other-tenants``
+    option when bootstrapping your new instance.
+
 
 New features
 ============