Skip to content

Commit deac123

Browse files
Link to the new CMQ => QQ Blue-Green Deployment migration blog post
1 parent 7894910 commit deac123

File tree

6 files changed

+51
-2
lines changed

6 files changed

+51
-2
lines changed

docs/quorum-queues/index.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,7 @@ Topics covered in this document include:
6969
* [Performance](#performance) characteristics of quorum queues
7070
* [Performance tuning](#performance-tuning), both for workloads with [small messages](#performance-tuning-small-messages) and [large messages](#performance-tuning-large-messages)
7171
* [Poison message handling](#poison-message-handling) (failure-redelivery loop protection)
72+
* [Migrating from Mirrored Classic Queues](#migrate-from-cmqs)
7273
* Options to Relax [Property Equivalence](#relaxed-property-equivalence)
7374
* [Configurable settings](#configuration) of quorum queues
7475

@@ -1089,6 +1090,14 @@ The more members a quorum queue has, the lower its throughput generally will
10891090
be since more work has to be done to memberte data and achieve consensus.
10901091

10911092

1093+
## Migrating from RabbitMQ 3.13.x with Mirrored Classic Queues to Quorum Queues Using Blue-Green Deployment {#migrate-from-cmqs}
1094+
1095+
[`rabbitmqadmin` v2](./management-cli) provides commands for automating migration from 3.13.x clusters
1096+
that use classic mirrored queues to quorum queues using the [Blue-Green Deployment strategy](./blue-green-upgrade).
1097+
1098+
See [Using Blue-Green Upgrade Strategy to Migrate from Classic Mirrored Queues to Quorum Queues](/blog/2025/07/29/latest-benefits-of-rmq-and-migrating-to-qq-along-the-way).
1099+
1100+
10921101
## Configurable Settings {#configuration}
10931102

10941103
There are a few new configuration parameters that can be tweaked using

versioned_docs/version-3.13/ha/index.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,12 +32,18 @@ This guide covers a feature that had been [**deprecated since 2021**](/blog/2021
3232
**Non-replicated** classic queues continue being supported and developed.
3333
:::
3434

35+
:::tip
36+
37+
`rabbitmqadmin` v2 provides [modern tooling for migrating away from Classic Mirrored Queues to Quorum Queues](https://www.rabbitmq.com/blog/2025/07/29/latest-benefits-of-rmq-and-migrating-to-qq-along-the-way)
38+
39+
:::
40+
3541
## Wait, There's a Better Way: Modern Replicated Queue Type and Streams {#interstitial}
3642

3743
This guide covers a [**long time deprecated**](/blog/2021/08/21/4.0-deprecation-announcements) and [**in 4.x, removed**](https://github.com/rabbitmq/rabbitmq-server/pull/9815) legacy feature: mirroring (queue contents replication) of classic queues.
3844
[Quorum queues](./quorum-queues) and/or [streams](./streams) should be used instead of mirrored classic queues.
3945

40-
Quorum queues are a more advanced queue type, which offers high availability using replication and focuses on data safety. Quorum queues [support message TTL](/blog/2022/05/05/rabbitmq-3.10-release-overview) and provide [higher throughput and more stable latency](/blog/2022/05/16/rabbitmq-3.10-performance-improvements) compared to mirrored classic queues. Please [migrate from Mirrored Classic Queues to Quorum Queues](./migrate-mcq-to-qq) now.
46+
Quorum queues are a more advanced queue type, which offers high availability using replication and focuses on data safety. Quorum queues [support message TTL](/blog/2022/05/05/rabbitmq-3.10-release-overview) and provide [higher throughput and more stable latency](/blog/2022/05/16/rabbitmq-3.10-performance-improvements) compared to mirrored classic queues. Please migrate from Mirrored Classic Queues to Quorum Queues, either [using the Blue-Green Deployment strategy](/blog/2025/07/29/latest-benefits-of-rmq-and-migrating-to-qq-along-the-way) or [within the same virtual host](./migrate-mcq-to-qq).
4147

4248
[Streams](./streams) is an [alternative messaging data structure](/blog/2021/07/13/rabbitmq-streams-overview) supported by RabbitMQ.
4349
Just like quorum queues, streams are replicated.

versioned_docs/version-3.13/migrate-mcq-to-qq.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,13 @@ import TabItem from '@theme/TabItem';
2424

2525
# Migrate your RabbitMQ Mirrored Classic Queues to Quorum Queues
2626

27+
:::important
28+
29+
`rabbitmqadmin` v2 offers [modern tooling for migrating from 3.13.x clusters](/blog/2025/07/29/latest-benefits-of-rmq-and-migrating-to-qq-along-the-way) with Mirrored Classic Queues to 4.x clusters with Quorum Queues
30+
using the [Blue-Green Deployment strategy](./blue-green-upgrade)
31+
32+
:::
33+
2734
Which is better: mirrored classic queues or quorum queues? [Quorum queues](./quorum-queues) are the much better choice and they will be [the only option starting with RabbitMQ version 4.0](https://blog.rabbitmq.com/posts/2021/08/4.0-deprecation-announcements/).
2835
This information explains why, the reasons why you should migrate from mirrored classic queues to quorum queues, the ways to handle features during the migration, and includes procedures for some of the migration routes you can take.
2936

versioned_docs/version-3.13/quorum-queues/index.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,7 @@ Topics covered in this information include:
6565
* [Performance](#performance) characteristics of quorum queues
6666
* [Performance tuning](#performance-tuning), both for workloads with [small messages](#performance-tuning-small-messages) and [large messages](#performance-tuning-large-messages)
6767
* [Poison message handling](#poison-message-handling) (failure-redelivery loop protection)
68+
* [Migrating from Mirrored Classic Queues](#migrate-from-cmqs)
6869
* [Configurable settings](#configuration) of quorum queues
6970

7071
and more.
@@ -825,7 +826,7 @@ log entries it does not have from the leader, including the dropped ones. Quorum
825826
will therefore remain consistent.
826827

827828

828-
## Quorum Queue Performance Characteristics {#performance}
829+
### Quorum Queue Performance Characteristics {#performance}
829830

830831
Quorum queues are designed to trade latency for throughput and have been tested
831832
and compared against durable [classic mirrored queues](./ha) in 3, 5 and 7 node configurations at several
@@ -852,6 +853,14 @@ The more replicas a quorum queue has, the lower its throughput generally will
852853
be since more work has to be done to replicate data and achieve consensus.
853854

854855

856+
## Migrating from RabbitMQ 3.13.x with Mirrored Classic Queues to Quorum Queues Using Blue-Green Deployment {#migrate-from-cmqs}
857+
858+
[`rabbitmqadmin` v2](./management-cli) provides commands for automating migration from 3.13.x clusters
859+
that use classic mirrored queues to quorum queues using the [Blue-Green Deployment strategy](./blue-green-upgrade).
860+
861+
See [Using Blue-Green Upgrade Strategy to Migrate from Classic Mirrored Queues to Quorum Queues](/blog/2025/07/29/latest-benefits-of-rmq-and-migrating-to-qq-along-the-way).
862+
863+
855864
## Configurable Settings {#configuration}
856865

857866
There are a few new configuration parameters that can be tweaked using

versioned_docs/version-4.0/quorum-queues/index.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,7 @@ Topics covered in this document include:
6969
* [Performance](#performance) characteristics of quorum queues
7070
* [Performance tuning](#performance-tuning), both for workloads with [small messages](#performance-tuning-small-messages) and [large messages](#performance-tuning-large-messages)
7171
* [Poison message handling](#poison-message-handling) (failure-redelivery loop protection)
72+
* [Migrating from Mirrored Classic Queues](#migrate-from-cmqs)
7273
* Options to Relax [Property Equivalence](#relaxed-property-equivalence)
7374
* [Configurable settings](#configuration) of quorum queues
7475

@@ -1087,6 +1088,14 @@ The more replicas a quorum queue has, the lower its throughput generally will
10871088
be since more work has to be done to replicate data and achieve consensus.
10881089

10891090

1091+
## Migrating from RabbitMQ 3.13.x with Mirrored Classic Queues to Quorum Queues Using Blue-Green Deployment {#migrate-from-cmqs}
1092+
1093+
[`rabbitmqadmin` v2](./management-cli) provides commands for automating migration from 3.13.x clusters
1094+
that use classic mirrored queues to quorum queues using the [Blue-Green Deployment strategy](./blue-green-upgrade).
1095+
1096+
See [Using Blue-Green Upgrade Strategy to Migrate from Classic Mirrored Queues to Quorum Queues](/blog/2025/07/29/latest-benefits-of-rmq-and-migrating-to-qq-along-the-way).
1097+
1098+
10901099
## Configurable Settings {#configuration}
10911100

10921101
There are a few new configuration parameters that can be tweaked using

versioned_docs/version-4.1/quorum-queues/index.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,7 @@ Topics covered in this document include:
6969
* [Performance](#performance) characteristics of quorum queues
7070
* [Performance tuning](#performance-tuning), both for workloads with [small messages](#performance-tuning-small-messages) and [large messages](#performance-tuning-large-messages)
7171
* [Poison message handling](#poison-message-handling) (failure-redelivery loop protection)
72+
* [Migrating from Mirrored Classic Queues](#migrate-from-cmqs)
7273
* Options to Relax [Property Equivalence](#relaxed-property-equivalence)
7374
* [Configurable settings](#configuration) of quorum queues
7475

@@ -1087,6 +1088,14 @@ The more replicas a quorum queue has, the lower its throughput generally will
10871088
be since more work has to be done to replicate data and achieve consensus.
10881089

10891090

1091+
## Migrating from RabbitMQ 3.13.x with Mirrored Classic Queues to Quorum Queues Using Blue-Green Deployment {#migrate-from-cmqs}
1092+
1093+
[`rabbitmqadmin` v2](./management-cli) provides commands for automating migration from 3.13.x clusters
1094+
that use classic mirrored queues to quorum queues using the [Blue-Green Deployment strategy](./blue-green-upgrade).
1095+
1096+
See [Using Blue-Green Upgrade Strategy to Migrate from Classic Mirrored Queues to Quorum Queues](/blog/2025/07/29/latest-benefits-of-rmq-and-migrating-to-qq-along-the-way).
1097+
1098+
10901099
## Configurable Settings {#configuration}
10911100

10921101
There are a few new configuration parameters that can be tweaked using

0 commit comments

Comments
 (0)