@@ -64,6 +64,20 @@ Once all nodes are upgraded to 3.13.0, these irregularities will go away.
64
64
Mixed version clusters are a mechanism that allows rolling upgrade and are not meant to be run for extended
65
65
periods of time (no more than a few hours).
66
66
67
+ ### Recommended Post-upgrade Procedures
68
+
69
+ #### Switch Classic Queues to CQv2
70
+
71
+ We recommend switching classic queues to CQv2 after ** all cluster nodes** have been upgrades,
72
+ at first using policies, and then eventually using a setting in ` rabbitmq.conf ` . Upgrading
73
+ classic queues to CQv2 at boot time using the configuration file setting can be
74
+ potentially unsafe in environments where deprecated classic mirrored queues still exist.
75
+
76
+ For new clusters, adopting CQv2 from the start is highly recommended:
77
+
78
+ ``` ini
79
+ classic_queue.default_version = 2
80
+ ```
67
81
68
82
69
83
## Compatibility Notes
@@ -245,6 +259,19 @@ Release notes are kept under [rabbitmq-server/release-notes](https://github.com/
245
259
246
260
GitHub issue: [ #9797 ] ( https://github.com/rabbitmq/rabbitmq-server/pull/9797 )
247
261
262
+ * Classic queue storage v2 (CQv2) has matured and is now recommended for all users.
263
+
264
+ We recommend switching classic queues to CQv2 after ** all cluster nodes** have been upgrades,
265
+ at first using policies, and then eventually using a setting in ` rabbitmq.conf ` . Upgrading
266
+ classic queues to CQv2 at boot time using the configuration file setting can be
267
+ potentially unsafe in environments where deprecated classic mirrored queues still exist.
268
+
269
+ For new clusters, adopt CQv2 from the start by setting ` classic_queue.default_version ` in ` rabbitmq.conf ` :
270
+
271
+ ``` ini
272
+ classic_queue.default_version = 2
273
+ ```
274
+
248
275
* Non-mirrored classic queues: optimizations of storage for larger (greater than 4 kiB) messages.
249
276
250
277
GitHub issue: [ #6090 ] ( https://github.com/rabbitmq/rabbitmq-server/pull/6090 ) , [ #8507 ] ( https://github.com/rabbitmq/rabbitmq-server/pull/8507 )
0 commit comments