File: 3.6.11.md

package info (click to toggle)
rabbitmq-server 4.0.5-6
  • links: PTS, VCS
  • area: main
  • in suites: sid, trixie
  • size: 37,948 kB
  • sloc: erlang: 257,835; javascript: 22,466; sh: 2,796; makefile: 2,517; python: 1,966; xml: 646; cs: 335; java: 244; ruby: 212; php: 100; perl: 63; awk: 13
file content (236 lines) | stat: -rw-r--r-- 10,315 bytes parent folder | download | duplicates (2)
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
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
## RabbitMQ 3.6.11

RabbitMQ `3.6.11` is a maintenance release.

### Upgrades and Compatibility

See the ["Upgrading clusters" section of the documentation](https://www.rabbitmq.com/clustering.html#upgrading)
for general documentation on upgrades.

⚠️ This release [changes how nodes compute the amount of RAM they use](https://groups.google.com/forum/#!topic/rabbitmq-users/TVZt45O3WzU) (and report). Previously the value was underreported.
We recommend monitoring — or at least manually sampling — the [RSS of
the Erlang VM](http://www.linfo.org/ps.html) running RabbitMQ, comparing it to the value reported in the management UI
to compute the delta. Then adjust configured [VM high memory watermark](https://www.rabbitmq.com/alarms.html) an
possibly provisioning more RAM as needed.

This release has no other known incompatibilities with versions 3.6.7 through 3.6.10.
See the upgrade and compatibility sections in the [3.6.7 release notes](https://github.com/rabbitmq/rabbitmq-server/releases/tag/rabbitmq_v3_6_7) if upgrading from an earlier release.

⚠️  This is the first release that [supports Erlang/OTP 20](https://groups.google.com/forum/#!searchin/rabbitmq-users/OTP$2020%7Csort:relevance/rabbitmq-users/_imbAavBYjY/ninEKhMYAgAJ).


### Core Server

#### Bug Fixes

 * Node RAM consumption calculation strategy [has changed](https://groups.google.com/forum/#!topic/rabbitmq-users/TVZt45O3WzU)
   to a more precise one. Previously the value **was underreported**. It is possible to switch to the behavior in earlier versions
   if desired. This will **affect monitoring charts** and possibly **require bumping VM memory high watermark**
   or provisioning more RAM.

   GitHub issue: [rabbitmq-server#1223](https://github.com/rabbitmq/rabbitmq-server/issues/1223), [rabbitmq-server#1270](https://github.com/rabbitmq/rabbitmq-server/pull/1270)


 * Erlang/OTP 20 is [now supported](https://groups.google.com/forum/#!searchin/rabbitmq-users/OTP$2020%7Csort:relevance/rabbitmq-users/_imbAavBYjY/ninEKhMYAgAJ).

   GitHub issues: [rabbitmq-server#1243](https://github.com/rabbitmq/rabbitmq-server/issues/1243), [rabbitmq-server#1246](https://github.com/rabbitmq/rabbitmq-server/pull/1246), [rabbitmq-federation#58](https://github.com/rabbitmq/rabbitmq-federation/pull/58), [rabbitmq-management-agent#47](https://github.com/rabbitmq/rabbitmq-management-agent/pull/47), [rabbitmq-management#415](https://github.com/rabbitmq/rabbitmq-management/pull/415), [rabbitmq-stomp#115](https://github.com/rabbitmq/rabbitmq-stomp/issues/115)

 * `supervisor2`: supervisor could fail to restart failed child processes in some cases.
    This could affect multiple plugins, e.g. federation.

    Contributed by Aliaksey Artamonau (Couchbase).

   GitHub issues: [rabbitmq-common#201](https://github.com/rabbitmq/rabbitmq-common/pull/201),
                  [rabbitmq-server#1238](https://github.com/rabbitmq/rabbitmq-server/pull/1238)

 * Memory used by binary heap ("binaries") was reduced for some scenarios that involve mirrored queues.

   GitHub issue: [rabbitmq-common#208](https://github.com/rabbitmq/rabbitmq-common/issues/208)

 * Exclusive queues were not cleaned up when node failed or was considered unavailable by one of its
   peers.

   GitHub issue: [rabbitmq-server#1323](https://github.com/rabbitmq/rabbitmq-server/issues/1323)

 * `rabbitmq-service.bat start` and `rabbitmq-service.bat stop` did not report access violation
   errors.

   GitHub issue: [rabbitmq-server#1324](https://github.com/rabbitmq/rabbitmq-server/issues/1324)

 * When high VM memory watermarked is set to a value greater than 1.0,
   `1.0` will be used as effective value now instead of the default (`0.4`).

   GitHub issue: [rabbitmq-server#1285](https://github.com/rabbitmq/rabbitmq-server/issues/1285)

#### Enhancements

 * Total amount of RAM as seen by a node now can be overridden via config file.

   GitHub issue: [rabbitmq-server#1224](https://github.com/rabbitmq/rabbitmq-server/issues/1224)

 * Default value of `RABBITMQ_DISTRIBUTION_BUFFER_SIZE` is now `128000`. This makes inter-node communication
   throughput more stable on 1 GBbit/s (or greater) network links.

   GitHub issue: [rabbitmq-server#1306](https://github.com/rabbitmq/rabbitmq-server/issues/1306)

 * Plugins that are already expanded (unarhived from `.ez` archives on node boot) won't be
   expanded again.

   Contributed by Alex Lebedeff (Mirantis).

   GitHub issue: [rabbitmq-server#1226](https://github.com/rabbitmq/rabbitmq-server/pull/1226)


### Management plugin

#### Enhancements

 * Listing queues, exchanges, vhosts via HTTP API is now more efficient for common cases
   (e.g. when pagination is not used or only a subset of fields is requested).

   GitHub issue: [rabbitmq-management#402](https://github.com/rabbitmq/rabbitmq-management/issues/402)

 * Inter-node cluster link traffic information was missing.

   GitHub issue: [rabbitmq-management#434](https://github.com/rabbitmq/rabbitmq-management/issues/434)

 * Exclusive queues didn't have feature markers in the UI.

   GitHub issue: [rabbitmq-management#459](https://github.com/rabbitmq/rabbitmq-management/issues/459)

 * queue leader locator now has a feature marker in the UI.

   GitHub issue: [rabbitmq-management#468](https://github.com/rabbitmq/rabbitmq-management/pull/468)

 * It is now possible to pre-configure user permission at the time of its creation.

   GitHub issue: [rabbitmq-management#441](https://github.com/rabbitmq/rabbitmq-management/issues/441)

 * `rabbitmqadmin` now supports `--ssl-insecure` (`-k`), serving the same purpose as `-k` in curl

   GitHub issue: [rabbitmq-management#452](https://github.com/rabbitmq/rabbitmq-management/issues/452)

 * `rabbitmqadmin` now supports setting HTTP API endpoint hostname, port, username, and password
    using a URI.

    GitHub issue: [rabbitmq-management#437](https://github.com/rabbitmq/rabbitmq-management/issues/437)

 * HTTP API requests now are less likely to produce log noise.

    GitHub issue: [rabbitmq-web-dispatch#27](https://github.com/rabbitmq/rabbitmq-web-dispatch/issues/27)

#### Bug Fixes

  * queue leader migration no longer leaves statistics database records behind.

    GitHub issue: [rabbitmq-management#427](https://github.com/rabbitmq/rabbitmq-management/issues/427)

  * Consumer argument serialisation to JSON was fixed.

    GitHub issue: [rabbitmq-management#424](https://github.com/rabbitmq/rabbitmq-management/issues/424)

  * It is now again possible to create a user without a password (or password hash).
    Such users won't be able to sign in with [internal authentication backend](https://www.rabbitmq.com/access-control.html)
    but can be used with external authentication mechanisms (x509 certificates) and backends
    (LDAP, HTTP, etc).

    GitHib issue: [rabbitmq-management#383](https://github.com/rabbitmq/rabbitmq-management/issues/383)

  * Pagination combined with a user-provided set of columns returned no results.

    GitHub issue: [rabbitmq-management#404](https://github.com/rabbitmq/rabbitmq-management/issues/404)

  * Regular expressions used for filtering were not correctly escaped.

    GitHub issue: [rabbitmq-management#419](https://github.com/rabbitmq/rabbitmq-management/issues/419)

  * `rabbitmqadmin` now handles float rates.

    GitHub issue: [rabbitmq-management#457](https://github.com/rabbitmq/rabbitmq-management/issues/457)

  * `rabbitmqadmin` now ignores `SIGPIPE` signals and much less likely to terminate when its output is piped to
    another process.

    GitHub issue: [rabbitmq-management#438](https://github.com/rabbitmq/rabbitmq-management/issues/438)

  * HTTP requests with unintialised fields are less likely to crash log event handler.

    GitHub issue: [rabbitmq-web-dispatch#27](https://github.com/rabbitmq/rabbitmq-web-dispatch/issues/27)


### Federation Plugin

#### Bug Fixes

 * Federation links now recover better in certain scenarios, e.g. when one side of a link could be reset.

    GitHub issue: [rabbitmq-federation#59](https://github.com/rabbitmq/rabbitmq-federation/issues/59)


### STOMP Plugin

#### Bug Fixes

 * Erlang/OTP 20 is [now supported](https://groups.google.com/forum/#!searchin/rabbitmq-users/OTP$2020%7Csort:relevance/rabbitmq-users/_imbAavBYjY/ninEKhMYAgAJ).

   GitHub issue: [rabbitmq-stomp#115](https://github.com/rabbitmq/rabbitmq-stomp/issues/115)


### MQTT Plugin

#### Enhancements

 * No-op MQTT message retainer.

   GitHub issue: [rabbitmq-mqtt#136](https://github.com/rabbitmq/rabbitmq-mqtt/issues/136)

#### Bug Fixes

 * MQTT connection processes now use connection log level.

   GitHub issue: [rabbitmq-mqtt#142](https://github.com/rabbitmq/rabbitmq-mqtt/issues/142)


### Consistent Hashing Exchange

#### Bug Fixes

 * Bucket distribution is now consistent (doesn't change) between plugin and node restarts
   (assuming bindings haven't changed).

   GitHub issue: [rabbitmq-consistent-hash-exchange#32](https://github.com/rabbitmq/rabbitmq-consistent-hash-exchange/issues/32)


### Top Plugin

#### Bug Fixes

 * `rabbitmq-top` now gracefully covers scenarios when it is enabled only on a subset of cluster nodes.

   GitHub issue: [rabbitmq-top#23](https://github.com/rabbitmq/rabbitmq-top/issues/23)

 * Node drop down on ETS table tab redirected to the processes tab.

   GitHub issue: [rabbitmq-top#24](https://github.com/rabbitmq/rabbitmq-top/issues/24)


### Message Timestamp Plugin

#### Enhancements

  * Timestamp in milliseconds is also injected as a header (unless the header is present).

    GitHub issue: [rabbitmq-message-timestamp#16](https://github.com/rabbitmq/rabbitmq-message-timestamp/issues/16)


## Upgrading

To upgrade a non-clustered RabbitMQ simply install the new version. All configuration and persistent message data are retained.
When upgrading using definitions export/import from versions earlier than 3.6.0, see http://rabbitmq.com/passwords.html.

To upgrade a RabbitMQ cluster, follow the instructions [in RabbitMQ documentation](https://www.rabbitmq.com/clustering.html#upgrading).

## Source code archives

**Warning**: The source code archive provided by GitHub only contains the source of the broker,
not the plugins or the client libraries. Please download the archive named `rabbitmq-3.6.11.tar.gz`.