Migrating from classic queues to quorum queues on Amazon MQ for RabbitMQ - Amazon MQ
Migrating from classic mirrored queues to quorum queues with a new virtual hostMigrating from classic mirrored queues to quorum queues in place
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Migrating from classic queues to quorum queues on Amazon MQ for RabbitMQ

You can migrate your classic mirrored queues to quorum queues on Amazon MQ brokers on version 3.13 or above by creating a new virtual host on the same cluster, or by migrating in place.

Migrating from classic mirrored queues to quorum queues with a new virtual host

  1. In your existing cluster, create a new virtual host (vhost) with the default queue type as quorum.

  2. Create the Federation plugin from the new vhost with the URI pointing to the old vhost using classic mirrored queues.

  3. Using rabbitmqadmin, export the definitions from the old vhost to a new file. You must make changes to the schema file so it is compatible with quorum queues. For the full list of changes you need to make to the file, see Moving definitions in the RabbitMQ quorum queues documentation. After applying the necessary changes to the file, reimport the definitions to the new vhost.

  4. Create a new policy in the new vhost. For recommendations on Amazon MQ policy configurations for quorum queues, see Policy configurations for quorum queues for Amazon MQ for RabbitMQ . Then, start the Federation you created earlier from the old vhost to the new vhost.

  5. Point consumers and producers to the new vhost.

  6. Configure the Shovel plug in to move any remaining messages. Once a queue is empty, delete the Shovel.

Migrating from classic mirrored queues to quorum queues in place

  1. Stop the consumers and producers.

  2. Create a new temporary quorum queue.

  3. Configure the Shovel plug in to move any messages from the old classic mirrored queue to the new temporary quorum queue. After all messages are moved to the temporary quorum queue, delete the Shovel.

  4. Delete the source classic mirrored queue. Then, recreate a quorum queue with the same name and bindings as the source classic mirrored queue.

  5. Create a new Shovel to move the messages from the temporary quorum queue to the new quorum queue.