Project: RabbitMQ (App Definition and Development / Streaming & Messaging)
File: 3.12.1.md

RabbitMQ `3.12.1` is a maintenance release in the `3.12.x` . Please refer to the upgrade section from the if upgrading from a version prior to 3.12.0. This release requires Erlang 25 and supports Erlang versions up to `26.0.x`. has more details on Erlang version requirements for RabbitMQ. As of 3.12.0, RabbitMQ requires Erlang 25. Nodes will fail to start on older Erlang releases. Users upgrading from 3.11.x (or older releases) on Erlang 25 to 3.12.x on Erlang 26 (both RabbitMQ and Erlang are upgraded at the same time) must consult the first. Release notes can be found on GitHub at . Declaration of a classic queue could run into an exception. GitHub issue: Classic queues v1 (CQv1) that had a backlog of messages stored by 3.9 and earlier versions could run into an exception during queue index recovery after an upgrade to 3.10.x or any later series. CQv2 and queues without a backlog were not affected. Contributed by @gomoripeti (CloudAMQP). GitHub issue: Nodes that had a large number of quorum queues could observe accumulation of Erlang processes under significant load. A follow-up change to . GitHub issue: Feature flag discovery on a newly added node could discover an incomplete inventory of feature flags. GitHub issue: Feature flag discovery operations will now be retried multiple times in case of network failures. GitHub issue: Nodes in clusters that had quorum queues and non-mirrored classic queues on stopped (or failed) nodes could run into an exception. The same exception could affect `rabbitmqctl list_queues`. GitHub issue: Proxy Protocol v2 LOCAL packets were not supported. GitHub issue: When a quorum queue does not find its local replica data files on boot, it will now log a warning. GitHub issue: An attempt to clear limits of a non-existent virtual host failed with a 500 status code. GitHub issue: Management UI will now display node maintenance status. Contributed by @SimonUnge (AWS). GitHub issue: The "Queues" tab in the UI was renamed to "Queue and Streams" to better reflect its contents. GitHub issue: New HTTP API endpoints for quorum queue replica management, equivalent to the `rabbitmq-queues` commands that manage replicas. ``` POST /api/queues/quorum/{vhost}/{name}/replicas/add DELETE /api/queues/quorum/{vhost}/{name}/replicas/remove POST /api/queues/quorum/replicas/on/{node}/grow DELETE /api/queues/quorum/replicas/on/{node}/shrink ``` GitHub issue: Stream client connections that authenticated using x.509 certificates failed. GitHub issue: Only set OAuth 2 client's CA certificate file setting when it is defined. GitHub issue: The plugin will now accept JWT tokens without a `scope`. Such tokens would only be useful when the plugin is used exclusively for authentication and not authorization. GitHub issue: `oauth2` is now an accepted alias for the OAuth 2 authentication and authorization backend: ``` auth_backends.1 = oauth2 ``` Previously the only option for OAuth 2 was using a full module name, `rabbitauthbackend_oauth2`. GitHub issue: STOMP plugin log entries had an extra line feed character. GitHub issue: `ra` was upgraded to To obtain source code of the entire distribution, please download the archive named `rabbitmq-server-3.12.1.tar.xz` instead of the source tarball produced by GitHub.