1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168
|
RabbitMQ `3.12.2` is a maintenance release in the `3.12.x` [release series](https://www.rabbitmq.com/versions.html).
Please refer to the upgrade section from the [3.12.0 release notes](https://github.com/rabbitmq/rabbitmq-server/releases/tag/v3.12.0)
if upgrading from a version prior to 3.12.0.
This release requires Erlang 25 and supports Erlang versions up to `26.0.x`.
[RabbitMQ and Erlang/OTP Compatibility Matrix](https://www.rabbitmq.com/which-erlang.html) has more details on
Erlang version requirements for RabbitMQ.
### Minimum Supported Erlang Version
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 [v3.12.0 release notes](https://github.com/rabbitmq/rabbitmq-server/releases/tag/v3.12.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.12.x/release-notes).
### Core Server
#### Enhancements
* Free disk space monitor on Windows is now more selective in what errors are
logged.
GitHub issue: [#8837](https://github.com/rabbitmq/rabbitmq-server/pull/8837)
#### Bug Fixes
* Queue recovery on node restart in certain conditions could run into an exception
GitHub issue: [#8746](https://github.com/rabbitmq/rabbitmq-server/issues/8746)
* `file_handle_cache` operations are now safer when handling non-existent keys.
GitHub issue: [#8784](https://github.com/rabbitmq/rabbitmq-server/issues/8784)
* Fixed a potential resource leak in at-least-once dead lettering from quorum queues.
GitHub issue: [#8799](https://github.com/rabbitmq/rabbitmq-server/pull/8799)
### CLI Tools
#### Enhancements
* A new command, `rabbitmqctl deactivate_free_disk_space_monitoring`, can be used to (temporarily or permanently) disable
free disk space monitoring on a node.
To re-activate it, use `rabbitmqctl activate_free_disk_space_monitoring`.
GitHub issue: [#8801](https://github.com/rabbitmq/rabbitmq-server/pull/8801)
### AMQP 1.0 Plugin
#### Bug Fixes
* AMQP 1.0 clients that try to publish in a way that results in the message not being routed
anywhere are now notified with a more sensible settlement status.
GitHub issue: [#7823](https://github.com/rabbitmq/rabbitmq-server/issues/7823)
### Prometheus Plugin
#### Enhancements
* Prometheus scraping API endpoints now support optional authentication.
Contributed by @SimonUnge (AWS).
GitHub issue: [#8661](https://github.com/rabbitmq/rabbitmq-server/pull/8661)
* The plugin now filters out values that are `undefined` or `NaN`, simply excluding
them from the API endpoint response.
Previously, if a metric was not computed for any reason (e.g. free disk space monitor
was disabled on the node), its value could end up being rendered as `undefined` or `NaN`,
two values that Prometheus scrapers cannot handle (for numerical types such as gauges).
GitHub issue: [#8740](https://github.com/rabbitmq/rabbitmq-server/issues/8740)
### Management Plugin
#### Bug Fixes
* It was not possible to close a table column selection pane on
screens that had little vertical space.
Contributed by @Antsthebul.
GitHub issue: [#8701](https://github.com/rabbitmq/rabbitmq-server/pull/8701)
### STOMP Plugin
#### Bug Fixes
* This is a **potentially breaking change**.
The plugin will now enforce maximum STOMP frame size. Frames larger than that
size will be rejected. The default maximum size is 4 MiB. It can be increased or decreased:
``` ini
# increase maximum supported STOMP frame size to 10 MiB
stomp.max_frame_size = 10485760
```
To reduce it from the default 4 MiB to 2 MiB:
``` ini
# 2 MiB
stomp.max_frame_size = 2097152
```
GitHub issue: [#8802](https://github.com/rabbitmq/rabbitmq-server/pull/8802)
### Shovel Plugin
#### Bug Fixes
* Shovel will gracefully stop when its destination (target) does not exist.
Such shovels will then be periodically restarted to retry.
Contributed by @markus812498 (CloudAMQP).
GitHub issue: [#8697](https://github.com/rabbitmq/rabbitmq-server/pull/8697)
### Web MQTT Plugin
#### Enhacements
* It is now possible to opt in to deactivate file handle cache use in the plugin:
``` ini
web_mqtt.use_file_handle_cache = false
```
GitHub issue: [#8790](https://github.com/rabbitmq/rabbitmq-server/pull/8790)
### Web STOMP Plugin
#### Enhacements
* It is now possible to opt in to deactivate file handle cache use in the plugin:
``` ini
web_stomp.use_file_handle_cache = false
```
GitHub issue: [#8790](https://github.com/rabbitmq/rabbitmq-server/pull/8790)
## Dependency Upgrades
* `ra` was upgraded to [`2.6.3`](https://github.com/rabbitmq/ra/releases)
## Source Code Archives
To obtain source code of the entire distribution, please download the archive named `rabbitmq-server-3.12.2.tar.xz`
instead of the source tarball produced by GitHub.
|