3.13.1 release notes (backport #10884)

release-notes/3.13.1.md

@@ -0,0 +1,156 @@
+## RabbitMQ 3.13.1
+
+RabbitMQ `3.13.1` is a maintenance release in the `3.13.x` [release series](https://www.rabbitmq.com/release-information).
+This series [is covered](https://www.rabbitmq.com/release-information) by community support through Feb 28, 2025 and extended commercial support through Aug 31, 2025.
+
+Please refer to the upgrade section from the [3.13.0 release notes](https://github.com/rabbitmq/rabbitmq-server/releases/tag/v3.13.0)
+if upgrading from a version prior to 3.13.0.
+
+This release requires Erlang 26 and supports Erlang versions up to `26.2.x`.
+[RabbitMQ and Erlang/OTP Compatibility Matrix](https://www.rabbitmq.com/docs/which-erlang) has more details on
+Erlang version requirements for RabbitMQ.
+
+
+### Minimum Supported Erlang Version
+
+As of 3.13.0, RabbitMQ requires Erlang 26. Nodes **will fail to start** on older Erlang releases.
+
+Users upgrading from 3.12.x (or older releases) on Erlang 25 to 3.13.x on Erlang 26
+(both RabbitMQ *and* Erlang are upgraded at the same time) **must** consult
+the [v3.12.0 release notes](https://github.com/rabbitmq/rabbitmq-server/releases/tag/v3.12.0) and
+[v3.13.0 release notes](https://github.com/rabbitmq/rabbitmq-server/releases/tag/v3.13.0) first.
+
+
+## Changes Worth Mentioning
+
+Release notes can be found on GitHub at [rabbitmq-server/release-notes](https://github.com/rabbitmq/rabbitmq-server/tree/v3.13.x/release-notes).
+
+
+### Core Broker
+
+#### Bug Fixes
+
+ * Classic queue v2 message store compaction could fail behind under high enough load,
+   significantly increasing node's disk space footprint.
+
+   GitHub issues: [#10696](https://github.com/rabbitmq/rabbitmq-server/pull/10696), [#10681](https://github.com/rabbitmq/rabbitmq-server/discussions/10681)
+
+ * Improved quorum queue safety in mixed version clusters.
+
+   GitHub issue: [#10664](https://github.com/rabbitmq/rabbitmq-server/pull/10664)
+
+ * When Khepri was enabled and virtual host recovery failed, subsequent recovery
+   attempts also failed.
+
+   GitHub issue: [#10742](https://github.com/rabbitmq/rabbitmq-server/pull/10742)
+
+ * Messages published without any headers set on them did not have a header property
+   set on them. This change compared to 3.12.x was not intentional.
+
+   GitHub issues: [#10623](https://github.com/rabbitmq/rabbitmq-server/pull/10623), [#10620](https://github.com/rabbitmq/rabbitmq-server/discussions/10620)
+
+ * Free disk space monitor on Windows ran into an exception if external call
+   to `win32sysinfo.exe` timed out.
+
+   GitHub issue: [#10597](https://github.com/rabbitmq/rabbitmq-server/issues/10597)
+
+#### Enhancements
+
+ * `channel_max_per_node` is a new per-node limit that allows to put a cap on the number
+   of AMQP 0-9-1 channels that can be concurrently open by all clients connected to a node.
+
+   This is a guardrail mean to protect nodes from [application-level channel leaks](https://www.rabbitmq.com/docs/channels#channel-leaks).
+
+   Contributed by @illotum (AWS).
+
+   GitHub issue: [#10754](https://github.com/rabbitmq/rabbitmq-server/pull/10754)
+
+
+### Stream Plugin
+
+#### Bug Fixes
+
+ * Avoids a Windows-specific stream log corruption that affected some deployments.
+
+   GitHub issue: [#10822](https://github.com/rabbitmq/rabbitmq-server/pull/10822)
+
+ * When a [super stream](https://www.rabbitmq.com/blog/2022/07/13/rabbitmq-3-11-feature-preview-super-streams) cannot be created because of a duplicate partition name,
+   a more informative error message is now used.
+
+   GitHub issue: [#10535](https://github.com/rabbitmq/rabbitmq-server/issues/10535)
+
+
+### CLI Tools
+
+#### Bug Fixes
+
+ * `rabbitmq-plugins list --formatter=json --silent` will no longer emit any warnings
+   when some of the plugins in the [enabled plugins file](https://www.rabbitmq.com/docs/plugins#enabled-plugins-file) are missing.
+
+   Contributed by @Ayanda-D.
+
+   GitHub issue: [#10870](https://github.com/rabbitmq/rabbitmq-server/pull/10870)
+
+
+### OAuth 2 Plugin
+
+#### Bug Fixes
+
+ * Configuring a JWKS URL without specifying a CA certificate resulted
+   in an exception with Erlang 26's TLS implementation.
+
+   GitHub issue: [#8547](https://github.com/rabbitmq/rabbitmq-server/issues/8547)
+
+
+### Management Plugin
+
+#### Bug Fixes
+
+ * Set default `sort` query parameter value for better compatibility with an external
+   Prometheus scraper. Note that the [built-in Prometheus plugin](https://www.rabbitmq.com/docs/prometheus)
+   is the recommended way of [monitoring](https://www.rabbitmq.com/docs/monitoring) RabbitMQ using Prometheus-compatible tools.
+
+   GitHub issue: [#10610](https://github.com/rabbitmq/rabbitmq-server/pull/10610)
+
+ * When a tab (Connections, Queues and Streams, etc) is switched, a table configuration pane
+   from the previously selected tab is now hidden.
+
+   Contributed by @ackepenek.
+
+   GitHub issue: [#10799](https://github.com/rabbitmq/rabbitmq-server/pull/10799)
+
+#### Enhancements
+
+ * `GET /api/queues/{vhost}/{name}` now supports `enable_queue_totals` as well as `disable_stats`.
+   This combination of query parameters can be used to retrieve message counters while
+   greatly reducing the number of metrics returned by the endpoints.
+
+   Contributed by @aaron-seo (AWS).
+
+   GitHub issue: [#10839](https://github.com/rabbitmq/rabbitmq-server/pull/10839)
+
+
+### Federation Plugin
+
+#### Enhancements
+
+ * Exchange federation now can be configured to use a custom queue type for their internal buffers.
+
+   To use a quorum queue, set the `queue-type` federation policy key to `quorum`.
+
+   GitHub issues: [#4683](https://github.com/rabbitmq/rabbitmq-server/issues/4683), [#10663](https://github.com/rabbitmq/rabbitmq-server/pull/10663)
+
+ * `rabbitmq_federation_running_link_count` is a new metric provided via Prometheus.
+
+   GitHub issue: [#10345](https://github.com/rabbitmq/rabbitmq-server/issues/10345)
+
+
+### Dependency Changes
+
+ * `osiris` was updated to [`1.8.1`](https://github.com/rabbitmq/osiris/releases)
+ * `khepri` was upgraded to [`0.13.0`](https://github.com/rabbitmq/khepri/releases)
+
+## Source Code Archives
+
+To obtain source code of the entire distribution, please download the archive named `rabbitmq-server-3.13.1.tar.xz`
+instead of the source tarball produced by GitHub.