Skip to content

Commit e57826f

Browse files
CQv2 upgrade recommendations for 3.13
1 parent a0c8dab commit e57826f

File tree

1 file changed

+27
-0
lines changed

1 file changed

+27
-0
lines changed

release-notes/3.13.0.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,20 @@ Once all nodes are upgraded to 3.13.0, these irregularities will go away.
6464
Mixed version clusters are a mechanism that allows rolling upgrade and are not meant to be run for extended
6565
periods of time (no more than a few hours).
6666

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+
```
6781

6882

6983
## Compatibility Notes
@@ -245,6 +259,19 @@ Release notes are kept under [rabbitmq-server/release-notes](https://github.com/
245259

246260
GitHub issue: [#9797](https://github.com/rabbitmq/rabbitmq-server/pull/9797)
247261

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+
248275
* Non-mirrored classic queues: optimizations of storage for larger (greater than 4 kiB) messages.
249276

250277
GitHub issue: [#6090](https://github.com/rabbitmq/rabbitmq-server/pull/6090), [#8507](https://github.com/rabbitmq/rabbitmq-server/pull/8507)

0 commit comments

Comments
 (0)