RabbitMQ - Upgrade

PaaS upgrade workflow

Request

The update of a RabbitMQ PaaS is the responsibility of cegedim.cloud and can be requested via a request ticket submitted from ITCare, specifying a time slot for the operation.

Please specify if the operation is to be carried out outside of business hours in order to plan an RFC.

It is recommended that you upgrade your non-production environments first in order to estimate the downtime generated by the operation and to test your applications using the new engine version.

Process

The upgrade of RabbitMQ (single-instance or high-availability) takes place in two fully automated steps.

• Update the Operating system first if required

  • Multiple updates depending on the scenario: Debian 9 → Debian 10 → Debian 11 -> Debian 12

• Update of the RabbitMQ engine in the target version

Depending on the source and target versions of RabbitMQ, it may be necessary to first migrate the operating system to a version supported by cegedim.cloud (for more information, check OS / RabbitMQ support matrix).

All stable feature flags must be enabled before and after each upgrade.

Impacts

• Debian version upgrades must be performed sequentially. For instance, it is not possible to upgrade directly from Debian 9 to Debian 11 or 12. An intermediate upgrade to Debian 10 is required before proceeding to subsequent versions.

• RabbitMQ version upgrades must be performed sequentially. For instance, it is not possible to upgrade directly from 3.10 to 3.12 or 3.13. An intermediate upgrade to 3.11 is required before proceeding to subsequent versions.

Time references

As a general guideline, the estimated durations for each step of the upgrade, are as follows:

• Debian upgrade: 10 minutes on average

• RabbitMQ upgrade: 30 minutes for a FARM with 3 nodes on average

• A 3-minute delay will be applied between the upgrade of each node to allow RabbitMQ to recover properly

OS / RabbitMQ support matrix

Linux distributions supported by cegedim.cloud depending on the RabbitMQ version:

RabbitMQ version	Debian distribution
RabbitMQ 3.9.X	Debian 9
RabbitMQ 3.10.X	Debian 10
RabbitMQ 3.11.X	Debian 10
RabbitMQ 3.12.X	Debian 11
RabbitMQ 3.13.X	Debian 12

Supported RabbitMQ update paths

For the OS upgrade, the upgrade will be performed node by node across the different RabbitMQ nodes, with no specific order.

RabbitMQ upgrade will be applied to all nodes in the RabbitMQ cluster, starting with the first node in ascending order.

Below are the update paths supported by cegedim.cloud:

Source Version	RabbitMQ 3.9.X	RabbitMQ 3.10.X	RabbitMQ 3.11.X	RabbitMQ 3.12.X	RabbitMQ 3.13.X
RabbitMQ 3.9.X	✅ Debian 9	✅ * Debian 9 → Debian 10	✅ * Debian 9 → Debian 10	✅ ** Debian 9 → Debian 10 → Debian 11	✅*** Debian 9 → Debian 10 → Debian 11 → Debian 12
RabbitMQ 3.10.X		✅ Debian 10	✅ Debian 10	✅ * Debian 10 → Debian 11	✅** Debian 10 → Debian 11 → Debian 12
RabbitMQ 3.11.X			✅ Debian 10	✅ * Debian 10 → Debian 11	✅** Debian 10 → Debian 11 → Debian 12
RabbitMQ 3.12.X				✅* Debian 10 → Debian 11	✅** Debian 10 → Debian 11 → Debian 12
RabbitMQ 3.13.X					✅* Debian 11 → Debian 12

* An operating system upgrade is required

** Two operating system upgrades are required

*** Three operating system upgrades are required