From 73fdd751f02b5213c2a839dab0a382b2d7b39999 Mon Sep 17 00:00:00 2001 From: Dmitriy Rabotyagov Date: Tue, 12 Nov 2024 20:28:38 +0100 Subject: [PATCH] [doc] Document requirement for RabbitMQ upgrade Needed-By: https://review.opendev.org/c/openstack/openstack-ansible-rabbitmq_server/+/934826 Needed-By: https://review.opendev.org/c/openstack/openstack-ansible-rabbitmq_server/+/934060 Change-Id: Ia282d19a10a346eb0a86580bfc42f3efeaac5871 --- doc/source/admin/upgrades/major-upgrades.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/doc/source/admin/upgrades/major-upgrades.rst b/doc/source/admin/upgrades/major-upgrades.rst index dfc63eae81..0217cb1c4e 100644 --- a/doc/source/admin/upgrades/major-upgrades.rst +++ b/doc/source/admin/upgrades/major-upgrades.rst @@ -202,6 +202,21 @@ Upgrade infrastructure We can now go ahead with the upgrade of all the infrastructure components. To ensure that rabbitmq and mariadb are upgraded, we pass the appropriate flags. +.. warning:: + + Please make sure you are running RabbitMQ version 3.13 or later before + proceeding to this step. + Upgrade of RabbitMQ to version 4.0 (default for 2024.2) from prior version + will result in playbook failure. + + At this point you can minorly upgrade RabbitMQ with the following command: + + ``openstack-ansible openstack.osa.rabbitmq_server -e rabbitmq_upgrade=true -e rabbitmq_package_version=3.13.7-1`` + + Also ensure that you have migrated from mirrored queues (HA queues) to + Quorum queues before the upgrade, as mirrored queues are no longer supported + after upgrade. + .. code-block:: console # openstack-ansible openstack.osa.setup_infrastructure -e 'galera_upgrade=true' -e 'rabbitmq_upgrade=true' -e package_state=latest