Project: RabbitMQ (App Definition and Development / Streaming & Messaging)
File: 3.6.2.md

RabbitMQ `3.6.2` is a maintenance release that includes a [new statistics collector in the management plugin](https://github.com/rabbitmq/rabbitmq-management/issues/41). Because this version includes significant changes to the management plugin, it should not be deployed into clusters with mixed `3.6.x` node versions unless all nodes that have the management plugin enabled run `3.6.2`. Otherwise HTTP API requests will fail with exceptions in some scenarios and parts of management UI may not be updated. There are no other known incompatibilities with earlier `3.6.x` releases. Standalone Mac OS X package now requires OpenSSL 1.0.x to be provided by the system, for example, from Homebrew. Starting with `3.6.2`, RabbitMQ Debian and RPM packages have an optional . When installing using `dpkg`, this dependency won't be automatically installed. To install it manually, use sudo apt-get install socat Channel operations that time out no longer produce noisy crash reports in RabbitMQ log files GitHub issue: Channel operation timeout default is bumped to 15 seconds GitHub issue: Windows service will pick up RabbitMQ config file regardless of whether it was present during service installation GitHub issue: Erlang distribution failures for `rabbitmqctl` and cross-node links will provide more detail when running on Erlang 19 (scheduled for release in Q3 2016). GitHub issue: `rabbitmqctl list_consumers` now lists all consumers on a given queue Previously it would only list one. Contributed by Alexey Lebedeff (Mirantis). GitHub issue: `rabbitmqctl list_queues` now correctly outputs rows for unavailable queues Contributed by Alexey Lebedeff (Mirantis). GitHub issue: `rabbitmqctl setdiskfreelimit memrelative` erroneously rejected values greater than `1.0` GitHub issue: Messages with an invalid client-provided `x-death` header value caused queue process termination GitHub issue: Messages with priorities higher than queue max are now assigned max configured priority and no longer cause an unhandled exception that results in queue process restart GitHub issue: Policy-related `rabbitmqctl` commands could return unformatted messages GitHub issue: `RABBITMQIOTHREADPOOLSIZE` is no longer ignored by `rabbitmq-server.bat` GitHub issue: Deleting a vhost in parallel with updating a policy in it resulted in unhandled exceptions GitHub issues: , , Connections now emit stats unconditionally when they are blocked and unblocked by resource alarms. This makes management UI and HTTP API-reported data to be more up-to-date GitHub issue: New (node-local) health check command `rabbitmqctl nodehealthcheck` is a new command that performs basic health check of a node GitHub issue: Automatic restart policy enabled for Windows service GitHub issue: Default number of async I/O VM threads is now calculated based on the number of available CPU cores GitHub issue: `rabbitmqctl list_queues` now supports new flags, `--offline` and `--online`, that limit result to only unavailable or available queues (queue leaders, to be more precise) Contributed by Alexey Lebedeff (Mirantis). GitHub issue: RabbitMQ will no longer log a warning about disabled kernel polling on Windows The runtime does not support kernel polling (I/O completion ports) on Windows, so there is nothing the user can do about it. GitHub issue: Queue index is now updated in batches when messages are requeued GitHub issue: Samples (stats) for abnormally terminated connections and channels will now be cleaned up more aggressively GitHub issue: Cluster name could be returned by HTTP API as a non-string value GitHub issue: Improved IE 11 compatibility GitHub issue: Management plugin has a new, better parallelised event collector which is less likely to fall behind. GitHub issues: , , , , Clients now can provide a human-readable connection name that will be displayed in the management UI. Currently Java, .NET and Erlang clients support this. In order to use this feature, set the `connection_name` key in client

Note that this name doesn't have to be unique and cannot be used as a connection identifier, for example, in HTTP API requests. GitHub issue: `GET /api/nodes/{node}/memory` and `GET /api/nodes/{node}/memory/relative` are new HTTP API endpoints that return memory usage breakdown in absolute (same as `rabbitmqctl status`) and relative terms. GitHub issue: HTTPS related improvements in `rabbitmqadmin`. GitHub issues: , , . Policies now can be listed (read) by the users tagged with `management` and `monitoring` As well as those tagged with `policymaker` and `administrator`, of course. GitHub issue: Effective rates mode is now displayed for cluster nodes by default GitHub issue: Resource alarms are handled correctly by MQTT connections GitHub issues: Session [pre-existing] presence is now correctly communicated to clients GitHub issue: Connections now emit stats unconditionally when they are blocked and unblocked by resource alarms. This makes management UI and HTTP API-reported data to be more up-to-date. GitHub issue: More connection details for MQTT connections reported to management UI GitHub issue: Resource alarms are handled correctly by STOMP connections GitHub issues: , Connections now emit stats unconditionally when they are blocked and unblocked by resource alarms. This makes management UI and HTTP API-reported data to be more up-to-date. GitHub issue: More connection details for STOMP connections reported to management UI GitHub issue: More connection details for STOMP-over-WebSockets connections reported to management UI GitHub issue: The plugin now sends a protocol header (`Sec-WebSocket-Protocol`) response when client presents it. GitHub issue: More connection details for MQTT-over-WebSockets connections reported to management UI GitHub issue: Plugin deactivation now correctly stops TCP listener GitHub issue: Compatibility with SQL Server 2014 CLR restored GitHub issue: Autorecovering connections now respect all provided hostnames when reconnecting. GitHub issue: `ConnectionFactory#CreateConnection` now respects all provided hostnames when automatic connection recovery is disabled. GitHub issue: Certain channel failures resulted in a race condition during process [tree] shutdown. GitHub issue: LDAP connection pool is now more resilient to TCP connection closure/loss on Erlang/OTP 18.3 GitHub issue: Non-existent group in `tag_queries` shouldn't terminate authorisation GitHub issue: `attribute` query should not fail when multiple values are returned GitHub issue: Virtual host is now available as a variable in `tag_queries` GitHub issue: Default LDAP connection pool size was increased from `10` to `64` GitHub issue: The plugin now uses HTTP 1.1 and keep-alive connections for requests. GitHub issue: It is now possible to configure the plugin to use `POST` requests instead of `GET`, so that no sensitive information is logged. GitHub issue: The plugin now supports HTTP client TLS options, so authenticating apps can use HTTPS GitHub issue: Vhost access requests now include client IP address GitHub issue: Contributed by Abdulrazak Alkl. Policy events now include a vhost field GitHub issue: Binding events now include a vhost field GitHub issue: Millesecond resolution timestamp of events is now back as a message header GitHub issue: `user.authentication.success` no longer has the `vhost` field since vhost is only available at a later point. `connection.created` events should be used to track successful connections if vhost information is desired. GitHub issue: 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.1, see http://rabbitmq.com/passwords.html. To upgrade a RabbitMQ cluster, follow the instructions . All nodes that have RabbitMQ management plugin enabled must be upgraded in lock step. 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.2.tar.gz`.