openstack/openstack-ansible
Code Issues Proposed changes

[doc] Document requirement for RabbitMQ upgrade

Browse Source 
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
This commit is contained in:
Dmitriy Rabotyagov 2024-11-12 20:28:38 +01:00
parent 56a970a588
commit 73fdd751f0
1 changed files with 15 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
doc/source/admin/upgrades/major-upgrades.rst
View File

@ -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