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.
|
