Skip to content

Commit 6c16b4d

Browse files
4.0.1 release notes: clarify that Blue/Green deployments are an option for 3.13.x clusters with Khepri enabled
1 parent 62a4c0a commit 6c16b4d

File tree

1 file changed

+10
-1
lines changed

1 file changed

+10
-1
lines changed

release-notes/4.0.1.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -195,7 +195,9 @@ for release notes of individual releases.
195195
This release series only supports upgrades from `3.13.x`.
196196

197197
This release requires **all feature flags** in the 3.x series (specifically `3.13.x`) to be enabled before upgrading,
198-
there is no upgrade path from 3.12.14 (or a later patch release) straight to `4.0.0`.
198+
there is no direct upgrade path from 3.12.14 (or a later patch release) straight to a `4.0.x` version.
199+
200+
[Blue/Green Deployment](https://www.rabbitmq.com/docs/blue-green-upgrade)-style upgrades are avaialble for migrations from 3.12.14 to `4.0.x`.
199201

200202
### Required Feature Flags
201203

@@ -204,6 +206,13 @@ This release [graduates](https://www.rabbitmq.com/docs/feature-flags#graduation)
204206
All users must enable all stable [feature flags] before upgrading to 4.0 from
205207
the latest available 3.13.x patch release.
206208

209+
### Migrating 3.13.x Clusters with Khepri Enabled
210+
211+
Khepri was an experimental feature in the `3.13.x` series. There is no direct upgrade path for clusters on `3.13.x` with Khepri enabled to `4.0.x`,
212+
because internal data model used to store various metadata (users, virtual hosts, queues, streams, policies, and so on) has changed dramatically.
213+
214+
Such clusters should be [migrated using the Blue/Green deployment strategy](https://www.rabbitmq.com/docs/blue-green-upgrade).
215+
207216
### Mixed version cluster compatibility
208217

209218
RabbitMQ 4.0.0 nodes can run alongside `3.13.x` nodes. `4.0.x`-specific features can only be made available when all nodes in the cluster

0 commit comments

Comments
 (0)