From e73e8789be06ca31374271e67814aa65c8155a7b Mon Sep 17 00:00:00 2001 From: Matt Crees Date: Mon, 19 May 2025 11:59:03 +0100 Subject: [PATCH 1/2] Document RabbitMQ queue migrations in 2025.1 --- doc/source/operations/upgrading-openstack.rst | 28 ++++++++++++++++++- 1 file changed, 27 insertions(+), 1 deletion(-) diff --git a/doc/source/operations/upgrading-openstack.rst b/doc/source/operations/upgrading-openstack.rst index 891829e05..ebf6a4dc7 100644 --- a/doc/source/operations/upgrading-openstack.rst +++ b/doc/source/operations/upgrading-openstack.rst @@ -41,7 +41,33 @@ RabbitMQ 4.0 RabbitMQ is being upgraded to 4.0 in Epoxy. Existing transient queues must be migrated on Caracal prior to upgrading. -.. TODO(mattcrees): Add link to docs when they exist +.. warning:: + + This migration will stop all services using RabbitMQ and cause an extended + API outage while queues are migrated. It should only be performed in a + pre-agreed maintenance window. + + If you are using Azimuth or the ClusterAPI driver for Magnum, you should + make sure to pause reconsiliation of all clusters before the API outage + window. See the `Azimuth docs + `__ + for instructions. + +Set the following variables in your kolla globals file (i.e. +$KAYOBE_CONFIG_PATH/kolla/globals.yml or $KAYOBE_CONFIG_PATH/environments/$KAYOBE_ENVIRONMENT/kolla/globals.yml): + +.. code-block:: yaml + + om_enable_queue_manager: true + om_enable_rabbitmq_quorum_queues: true + om_enable_rabbitmq_transient_quorum_queue: true + om_enable_rabbitmq_stream_fanout: true + +Then execute the migration script: + +.. code-block:: bash + + $KAYOBE_CONFIG_PATH/../../tools/rabbitmq-queue-migration.sh stackhpc.linux collection ------------------------- From c0a23efa7c5b98ceac430d90920ea6cfccb3b6d8 Mon Sep 17 00:00:00 2001 From: Matt Crees Date: Wed, 21 May 2025 13:37:56 +0100 Subject: [PATCH 2/2] Update doc/source/operations/upgrading-openstack.rst Co-authored-by: Jack Hodgkiss --- doc/source/operations/upgrading-openstack.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/source/operations/upgrading-openstack.rst b/doc/source/operations/upgrading-openstack.rst index 263dbf0ff..c964de11b 100644 --- a/doc/source/operations/upgrading-openstack.rst +++ b/doc/source/operations/upgrading-openstack.rst @@ -48,7 +48,7 @@ migrated on Caracal prior to upgrading. pre-agreed maintenance window. If you are using Azimuth or the ClusterAPI driver for Magnum, you should - make sure to pause reconsiliation of all clusters before the API outage + make sure to pause reconciliation of all clusters before the API outage window. See the `Azimuth docs `__ for instructions.