release-notes/3.11.0.md
RabbitMQ 3.11 is a new feature release.
This release series is no longer covered by community support.
This release includes several new features and optimizations, graduates (makes mandatory) a number of feature flags, bumps minimum required version to Erlang 25 for ARM64 CPU feature parity.
The areas that have seen the biggest improvements in this release are
See Compatibility Notes below to learn about breaking or potentially breaking changes in this release.
RabbitMQ releases are distributed via GitHub, Cloudsmith, and PackageCloud.
This release requires Erlang 25.0 or later. This introduces feature parity for x86- and ARM64-based CPUs: Erlang 25 offers the JIT and modern Flame Graph profiling tooling for both of those major CPU architectures.
Provisioning Latest Erlang Releases explains what package repositories and tools can be used to provision latest patch versions of Erlang 25.x.
See the Upgrading guide for documentation on upgrades and RabbitMQ change log for release notes of other releases.
RabbitMQ 3.11.0 will require all feature flags introduced in RabbitMQ 3.8 to be enabled before upgrading. If that is not the case, the upgrade process will not proceed.
RabbitMQ 3.11.0 nodes can run alongside 3.10.x nodes. 3.11.x-specific features can only be made available when all nodes in the cluster
upgrade to 3.11.0 or any other patch release in the series.
While operating in mixed version mode, some aspects of the system may not behave as expected. The list of known behavior changes is covered below. Once all nodes are upgraded to 3.11.0, these irregularities will go away.
Mixed version clusters are a mechanism that allows rolling upgrade and are not meant to be run for extended periods of time (no more than a few hours).
RabbitMQ 3.11.0 will require all feature flags from the 3.8.x release series to be enabled before upgrading. If the feature flags are not enabled, RabbitMQ 3.11 and later nodes will refuse to start.
Starting with this release, RabbitMQ requires Erlang 25.0 or later versions. Nodes will fail to start on older Erlang releases.
Erlang 25 as our new baseline means much improved performance on ARM64 architectures, profiling with flame graphs across all architectures, and the most recent TLS 1.3 implementation available to all RabbitMQ 3.11 users.
Nodes now default to 65536 concurrent client connections instead of using the effective kernel open file handle limit. Users who want to override this default, that is, have nodes that should support more concurrent connections and open files, now have to perform an additional configuration step:
systemd or similar tooling) for the OS user used by RabbitMQ to 100KERL_MAX_PORTS environment variable to 100KThis change was introduced because of a change in several Linux distributions: they now use a default open file handle limit so high, they cause a significant (say, 1.5 GiB) memory preallocated the Erlang runtime.
For example, RHEL 9 and CentOS Stream 9 are examples of such distributions. The new default comes from modern systemd.
See rabbitmq/rabbitmq-server#5684 and docker-library/rabbitmq#545 for details.
Client libraries that were compatible with RabbitMQ 3.10.x will be compatible with 3.11.0.
Any questions about this release, upgrades or RabbitMQ in general are welcome on the RabbitMQ mailing list.
Release notes are kept under rabbitmq-server/release-notes.
Some features flags have graduated to always enabled. This means that they must be enabled before upgrading to 3.11. If that is not the case, the upgrade process will not proceed.
More efficient connection tracking. This means less CPU load in environments where high connection churn cannot be avoided.
In part contributed by @gomoripeti.
GitHub issue: #5610
10% to 20% throughput gain for publishers that use the default exchange.
GitHub issue: #4606
When a virtual host is added, it now can be configured with default queue type.
In part contributed by @adamncasey.
Durable classic queues could get "lost" under certain conditions when a node failed.
GitHub issue: #4563
Nodes could get stuck when performing a rolling restart on Kubernetes where DNS hostname resolution was not available early on node boot. For example, this is the case with a popular default caching setting of CoreDNS.
GitHub issue: #5438
More robust free disk space monitoring implementation for Windows.
GitHub issue: #5738
RabbitMQ now supports partitioned streams (super streams). Super streams are a way to scale out by partitioning a large stream into smaller streams.
Stream protocol clients and RabbitMQ nodes now have a mechanism of exchanging their capabilities (sets of supported commands).
GitHub issue: #5308
New stream protocol command that allows certain stream metadata to be inspected by applications.
GitHub issue: #5412
Single Active Consumer support for streams.
GitHub issue: #3754
Consumers now have access to their committed offset information.
GitHub issue: #5307
OAuth 2 plugin now supports more identity providers and OpenID Connect.
GitHub issue: #4749
OAuth 2 plugin now supports Rich Authorization Requests.
GitHub issue: #5234
Some counters on the Overview page have been moved to global counters introduced in RabbitMQ 3.9.
GitHub issue: #5463
Management UI OAuth 2 integration supports more identity providers and OpenID Connect.
GitHub issue: #4749
HTTP API responses that render a large rest sets are now more efficient thanks to a more efficient JSON serialiser library used internally. Peak memory footprint of such queries is also double digit percent lower compared to v3.10.x.
GitHub issue: #5356
New endpoints that can list and close connections of a specific user.
Contributed by @NuwanSameera.
GitHub issue: #5319
A way to configure an authentication timeout, much like in some other protocols RabbitMQ supports.
Contributed by @gomoripeti.
GitHub issue: #5755
A way to configure an authentication timeout, much like in some other protocols RabbitMQ supports.
Contributed by @gomoripeti.
GitHub issue: #5755
Dynamic Shovels that use the "on publish" mode now use flow control internally to avoid balooning Shovel memory usage when the publishing side outpaces its target node.
Contributed by @gomoripeti.
GitHub issue: #5715
ra upgraded to 2.3.0osiris upgraded to 1.3.0prometheus upgraded to 4.9.0jsx was replaced with thoasTo obtain source code of the entire distribution, please download the archive named rabbitmq-server-3.11.0.tar.xz
instead of the source tarball produced by GitHub.