Skip to content

Commit 32060b2

Browse files
committed
Update doc to use RabbitMQ 4.1
1 parent 0c07f0d commit 32060b2

File tree

1 file changed

+28
-3
lines changed

1 file changed

+28
-3
lines changed

doc/source/operations/upgrading-openstack.rst

Lines changed: 28 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -35,11 +35,21 @@ Notable changes in the |current_release| Release
3535
There are many changes in the OpenStack |current_release| release described in
3636
the release notes for each project. Here are some notable ones.
3737

38-
RabbitMQ 4.0
38+
RabbitMQ 4.1
3939
------------
4040

41-
RabbitMQ is being upgraded to 4.0 in Epoxy. Existing transient queues must be
42-
migrated on Caracal prior to upgrading.
41+
.. warning::
42+
43+
This section must be followed prior to upgrading to OpenStack Epoxy.
44+
45+
From Epoxy release, OpenStack requires RabbitMQ 4.0 or 4.1.
46+
StackHPC Kayobe Config sets RabbitMQ 4.1 as a default for Epoxy release.
47+
RabbitMQ 4.0 or greater requires durable queues.
48+
Existing transient queues must be migrated to durable queues with Queue Manager.
49+
RabbitMQ 3.13 needs to be upgraded to 4.1.
50+
51+
Queue Migration
52+
~~~~~~~~~~~~~~~
4353

4454
.. warning::
4555

@@ -69,6 +79,21 @@ Then execute the migration script:
6979
7080
$KAYOBE_CONFIG_PATH/../../tools/rabbitmq-queue-migration.sh
7181
82+
RabbitMQ Upgrade
83+
~~~~~~~~~~~~~~~~
84+
85+
After queue migration is finished, upgrade RabbitMQ to 4.1 by running following command
86+
87+
.. code-block:: bash
88+
89+
kayobe kolla ansible run rabbitmq-upgrade 4.1
90+
91+
.. note::
92+
93+
Until Kolla-Ansible bug `LP#2118452 <https://bugs.launchpad.net/kolla-ansible/+bug/2118452>`__
94+
is fixed, add ``--kolla-skip-tags rabbitmq-version-check`` to avoid Kolla-Ansible incorrectly
95+
stopping RabbitMQ upgrade from 3.13 to 4.1.
96+
7297
stackhpc.linux collection
7398
-------------------------
7499

0 commit comments

Comments
 (0)