/release-notes/3.8.3.md

https://github.com/rabbitmq/rabbitmq-server · Markdown · 305 lines · 154 code · 151 blank · 0 comment · 0 complexity · 03a62316a23a21482d7a2108f746799d MD5 · raw file 

    

  1. ## RabbitMQ 3.8.3
    2. 

  2. 

  3. RabbitMQ `3.8.3` is a maintenance release.
    4. 

  4. 

  5. 

  6. ### Erlang/OTP Compatibility Notes
    7. 

  7. 

  8. This release [**requires Erlang/OTP 21.3**](https://www.rabbitmq.com/which-erlang.html) or later.
    9. 

  9. `22.x` series is recommended.
    10. 

  10. 

  11. [Provisioning Latest Erlang Releases](https://www.rabbitmq.com/which-erlang.html#erlang-repositories) explains what package repositories and tools can be used to provision latest patch versions of Erlang `21.3.x` and `22.x`.
    12. 

  12. 

  13. 

  14. ### Compatibility Notes
    15. 

  15. 

  16. #### Upgrading to Erlang 21.x or Later Versions
    17. 

  17. 

  18. When upgrading to this release from `3.7.6` or an older version, extra care has to be taken.
    19. 

  19. 

  20. Since CLI tools from RabbitMQ releases older than 3.7.7 will fail on Erlang 21 or later, RabbitMQ **must be upgraded at the same time as Erlang**.
    21. 

  21. Alternatively the node can be upgraded to `3.7.18` first, then Erlang 21.x or 22.x, then to RabbitMQ 3.8.x.
    22. 

  22. 

  23. #### Upgrade Doc Guides and Change Log
    24. 

  24. 

  25. See [3.8.0 release notes](https://github.com/rabbitmq/rabbitmq-server/releases/tag/v3.8.0) upgrade and compatibility notes first if upgrading from an earlier release.
    26. 

  26. 

  27. See the [Upgrading guide](https://www.rabbitmq.com/upgrade.html) for general documentation on upgrades and [RabbitMQ change log](https://www.rabbitmq.com/changelog.html) for release notes of other releases.
    28. 

  28. 

  29. ### Getting Help
    30. 

  30. 

  31. Any questions about this release, upgrades or RabbitMQ in general are welcome on the [RabbitMQ mailing list](https://groups.google.com/forum/#!forum/rabbitmq-users).
    32. 

  32. 

  33. 

  34. 

  35. ## Changes
    36. 

  36. 

  37. 

  38. ### Core Server
    39. 

  39. 

  40. #### Bug Fixes
    41. 

  41. 

  42.  * Reduced scheduled GC activity in connection socket writer to one run per 1 GiB of data transferred, with an option to change the value or disable scheduled run entirely.
    43. 

  43.    More frequent binary heap GC runs seem unneccesary on Erlang 22.
    44. 

  44. 

  45.    Contributed by Aleksander Nycz.
    46. 

  46. 

  47.    GitHub issue: [rabbitmq/rabbitmq-common#343](https://github.com/rabbitmq/rabbitmq-common/pull/343)
    48. 

  48. 

  49.  * Eliminated an inefficiency in recovery of quorum queues with a backlog of messages.
    50. 

  50. 

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

  52. 

  53.  * In a case where a node hosting a quorum queue replica went offline and was removed from the cluster,
    54. 

  54.    and later came back, quorum queues could enter a loop of Raft leader elections.
    55. 

  55. 

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

  57. 

  58.  * Quorum queues with a dead lettering could fail to recover.
    59. 

  59. 

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

  61. 

  62.  * The node now can recover even if virtual host recovery terms file was corrupted.
    63. 

  63. 

  64.    Contributed by @tomyouyou.
    65. 

  65. 

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

  67. 

  68.  * Autoheal could fail to finish if one of its state transitions initiated by a remote node timed out.
    69. 

  69. 

  70.    Contributed by @tomyouyou.
    71. 

  71. 

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

  73. 

  74.  * Syslog client is now started even when Syslog logging is configured only for some log sinks.
    75. 

  75. 

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

  77. 

  78.  * Policies that quorum queues ignored were still listed as applied to them.
    79. 

  79. 

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

  81. 

  82.  * If a quorum queue leader rebalancing operation timed out, CLI tools failed with an exception instead of a sensible internal API response.
    83. 

  83. 

  84.    Contributed by Gabriele Santomaggio.
    85. 

  85. 

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

  87. 

  88.  * Handle timeout error on the rebalance function.
    89. 

  89. 

  90.    Contributed by Gabriele Santomaggio.
    91. 

  91. 

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

  93. 

  94.  * Handle and raise protocol error for absent queues assumed to be alive.
    95. 

  95. 

  96.    Contributed by Ayanda Dube.
    97. 

  97. 

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

  99. 

  100. #### Enhancements
    101. 

  101. 

  102.  * Some Proxy protocol errors are now logged at debug level.
    103. 

  103.    This reduces log noise in environments where TCP load balancers and proxies perform health checks by opening a TCP connection but never sending any data.
    104. 

  104. 

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

  106. 

  107.  * Quorum queue deletion operation no longer supports the "if unused" and "if empty" options.
    108. 

  108.    They are typically used for transient queues don't make much sense for quorum ones.
    109. 

    110. 

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

  111. 

  112.  * Do not treat applications that do not depend on rabbit as plugins.
    113. 

  113.    This is especially important for applications that should not be stopped before rabbit is stopped.
    114. 

  114. 

  115.    GitHub Issue: [rabbitmq/rabbitmq-server#2212](https://github.com/rabbitmq/rabbitmq-server/pull/2212)
    116. 

  116. 

  117.  * RabbitMQ nodes will now gracefully shutdown when receiving a `SIGTERM` signal.
    118. 

  118.    Previously the runtime would invoke a default handler that terminates the VM giving RabbitMQ no chance to execute its shutdown steps.
    119. 

  119. 

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

  121. 

  122.  * Every cluster now features a persistent internal cluster ID that can be used by core features or plugins.
    123. 

  123.    Unlike the human-readable cluster name, the value cannot be overriden by the user.
    124. 

  124. 

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

  126. 

  127.  * Speedup execution of boot steps by a factor of 2N, where N is the number of attributes per step.
    128. 

  128. 

  129.    Contributed by Ayanda Dube.
    130. 

  130. 

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

  132. 

  133. 

  134. ### CLI Tools
    135. 

  135. 

  136. #### Bug Fixes
    137. 

  137. 

  138.  * `rabbitmq-diagnostics status` failed to display the results when executed against a node that had high VM watermark set as an absolute value (using `vm_memory_high_watermark.absolute`).
    139. 

  139. 

  140.    GitHub issue: [rabbitmq/rabbitmq-cli#395](https://github.com/rabbitmq/rabbitmq-cli/issues/395)
    141. 

  141. 

  142. #### Enhancements
    143. 

  143. 

  144.  * New health checks that can be used to determine if it's a good moment to shut down a node for an upgrade.
    145. 

    146. 

  146.    ``` sh
    147. 

  147.    # Exits with a non-zero code if target node hosts leader replica of at least one queue
    148. 

  148.    # that has out-of-sync mirror.
    149. 

  149.    rabbitmq-diagnostics check_if_node_is_mirror_sync_critical
    150. 

    151. 

  151.    # Exits with a non-zero code if one or more quorum queues will lose online quorum
    152. 

  152.    # should target node be shut down
    153. 

  153.    rabbitmq-diagnostics check_if_node_is_quorum_critical
    154. 

  154.    ```
    155. 

  155. 

  156.    GitHub issue: [rabbitmq/rabbitmq-cli#389](https://github.com/rabbitmq/rabbitmq-cli/issues/389)
    157. 

  157. 

  158.  * Some proxy protocol errors are now logged at debug level.
    159. 

  159.  * This reduces log noise in environments where TCP load balancers and proxies perform health checks by opening a TCP connection but never sending any data.
    160. 

  160. 

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

  162. 

  163. 

  164. ### Management and Management Agent Plugins
    165. 

  165. 

  166. #### Bug Fixes
    167. 

  167. 

  168.  * Consumer section on individual page was unintentionally hidden.
    169. 

  169. 

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

  171. 

  172.  * Fix queue-type select by adding unsafe-inline CSP policy.
    173. 

  173. 

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

  175. 

  176. #### Enhancements
    177. 

  177. 

  178.  * An undocumented "automagic login" feature on the login form was removed.
    179. 

  179. 

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

  181. 

  182.  * A new `POST /login` endpoint can be used by custom management UI login forms to authenticate the user and set the cookie.
    183. 

  183. 

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

  185. 

  186.  * A new `POST /rebalance/queues` endpoint that is the HTTP API equivalent of `rabbitmq-queues rebalance`
    187. 

  187. 

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

  189. 

  190.  * Warning about a missing `handle.exe` in `PATH` on Windows is now only logged every 10 minutes.
    191. 

  191. 

  192.    GitHub issue: [rabbitmq/rabbitmq-management-agent#90](https://github.com/rabbitmq/rabbitmq-management-agent/issues/90)
    193. 

  193. 

  194.  * `rabbitmqadmin declare queue` now supports a new `queue_type` parameter to simplify declaration of quorum queues.
    195. 

  195. 

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

  197. 

  198.  * HTTP API request log entries now includes acting user.
    199. 

  199. 

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

  201. 

  202.  * [Content Security Policy headers](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP) are now also set for static assets such as JavaScript files.
    203. 

  203. 

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

  205. 

  206. 

  207. ### Prometheus Plugin
    208. 

  208. 

  209. #### Enhancements
    210. 

  210. 

  211.  * Add option to aggregate metrics for channels, queues & connections. Metrics are now aggregated by default (safe by default).
    212. 

  212.    This new behaviour can be disabled via `prometheus.return_per_object_metrics = true` config.
    213. 

  213. 

  214.    GitHub issue: [rabbitmq/rabbitmq-prometheus#28](https://github.com/rabbitmq/rabbitmq-prometheus/issues/28)
    215. 

  215. 

  216. 

  217. ### Kubernetes Peer Discovery Plugin
    218. 

  218. 

  219. #### Enhancements
    220. 

  220. 

  221.  * The plugin will now notify [Kubernetes API](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.16/#event-v1-core) of node startup and peer stop/unavailability events.
    222. 

  222. 

  223.    Contributed by Gabriele Santomaggio.
    224. 

  224. 

  225.    GitHub issue: [rabbitmq/rabbitmq-peer-discovery-k8s#61](https://github.com/rabbitmq/rabbitmq-peer-discovery-k8s/pull/61)
    226. 

  226. 

  227. 

  228. ### Etcd Peer Discovery Plugin
    229. 

  229. 

  230. #### Bug Fixes
    231. 

  231. 

  232.  * Only run healthcheck when backend is configured.
    233. 

  233. 

  234.    GitHub issue: [rabbitmq/rabbitmq-peer-discovery-etcd#21](https://github.com/rabbitmq/rabbitmq-peer-discovery-etcd/pull/21)
    235. 

  235. 

  236. 

  237. ### Federation Plugin
    238. 

  238. 

  239. #### Bug Fixes
    240. 

  240. 

  241.  * Use vhost to delete federated exchange.
    242. 

  242. 

  243.    [Reported by Brett Janer](https://groups.google.com/forum/#!topic/rabbitmq-users/nfulekZc_OQ/discussion).
    244. 

  244. 

  245.    GitHub issue: [rabbitmq/rabbitmq-federation#99](https://github.com/rabbitmq/rabbitmq-federation/pull/99)
    246. 

  246. 

  247. #### Enhancements
    248. 

  248. 

  249.  * "Command" operations such as binding propagation now use a separate channel for all links, preventing latency spikes for asynchronous operations (such as message publishing) (a head-of-line blocking problem).
    250. 

  250. 

  251.    Contributed by Grigory Starinkin.
    252. 

  252. 

  253.    GitHub issue: [rabbitmq/rabbitmq-federation#97](https://github.com/rabbitmq/rabbitmq-federation/pull/97)
    254. 

  254. 

  255. 

  256. ### Auth Backend OAuth 2 Plugin
    257. 

  257. 

  258.  * Additional scopes can be fetched from a predefined JWT token field.
    259. 

  259.    Those scopes will be combined with the standard scopes field.
    260. 

  260. 

  261.    Contributed by @papugamichal.
    262. 

  262. 

  263.    GitHub issue: [rabbitmq/rabbitmq-auth-backend-oauth2#41](https://github.com/rabbitmq/rabbitmq-auth-backend-oauth2/pull/41)
    264. 

  264. 

  265. 

  266. ### Trust Store Plugin
    267. 

  267. 

  268. #### Enhancements
    269. 

  269. 

  270.  * HTTPS certificate provider will not longer terminate if upstream service response contains invalid JSON.
    271. 

  271. 

  272.    GitHub issue: [rabbitmq/rabbitmq-trust-store#73](https://github.com/rabbitmq/rabbitmq-trust-store/issues/73)
    273. 

  273. 

  274. 

  275. ### MQTT Plugin
    276. 

  276. 

  277. #### Enhancements
    278. 

  278. 

  279.  * Avoid blocking when registering or unregistering a client ID.
    280. 

  280. 

  281.    GitHub issue: [rabbitmq/rabbitmq-mqtt#226](https://github.com/rabbitmq/rabbitmq-mqtt/pull/226)
    282. 

  282. 

  283. 

  284. ### AMQP 1.0 Client Plugin
    285. 

  285. 

  286. #### Enhancements
    287. 

  287. 

  288.  * Handle heartbeat in `close_sent/2`.
    289. 

  289. 

  290.    GitHub issue: [rabbitmq/rabbitmq-amqp1.0-client#44](https://github.com/rabbitmq/rabbitmq-amqp1.0-client/pull/44)
    291. 

  291. 

  292. 

  293. 

  294. ## Source code archives
    295. 

  295. 

  296. **Warning**: The source code archive provided by GitHub only contains the source of the broker, not the plugins or the client libraries.
    297. 

  297. Please download the archive named `rabbitmq-server-3.8.3.tar.xz`.
    298. 

  298. 

  299. 

  300. 

  301. ## Dependency upgrades
    302. 

  302. 

  303.  * observer-cli was upgraded [from v1.5.2 to v1.5.3](https://github.com/zhongwencool/observer_cli/compare/1.5.2...1.5.3)
    304. 

  304.  * prometheus.erl was upgraded [from v4.4.0 to v4.5.0](https://github.com/deadtrickster/prometheus.erl/compare/v4.4.0...v4.5.0)
    305. 

  305.  * ra was upgraded [from v1.0.5 to v1.0.8](https://github.com/rabbitmq/ra/compare/v1.0.5...v1.0.8)
    306.