RabbitMQ 3.7.12-rc.1

RabbitMQ 3.7.12 RC1

RabbitMQ 3.7.12-rc.1 is a preview of a maintenance release. It focuses on bug fixes and
minor usability improvements. This release requires Erlang/OTP 20.3
or later.

Erlang/OTP Compatibility Notes

Per the new Erlang version support policy in effect starting with January 2019,
this release no longer supports Erlang/OTP 19.3.
Make sure a supported Erlang version is used before upgrading.

Provisioning Latest Erlang Releases
explains what package repositories and tools can be used to provision latest patch versions of
Erlang 20.3.x and 21.x.

Compatibility Notes

Minimum Required Erlang Version

This release requires Erlang/OTP 20.3 or later.

rabbitmqctl shutdown Behavior with Remote Nodes

In earlier releases, when rabbitmqctl shutdown was used against a remote node, it would successfully
shut down the node but won't actually wait for its termination because the pid file path
reported by the remote node is not available locally. This is because rabbitmqctl shutdown was
meant to be used as a rabbitmqctl stop alternative that doesn't require the caller to know the
pid file path.

Starting with this version, rabbitmqctl shutdown will refuse to run against a remote node
by default. If the earlier behavior is desired and expected, it can be restored by passing --no-wait:

# will refuse to run against a remote node in --wait mode as of 3.7.12
# and --wait is on by default
rabbitmqctl shutdown -n [email protected] --longnames

# behaves the same way as in 3.7.0 through 3.7.11
rabbitmqctl shutdown -n [email protected] --longnames --no-wait

Upgrading to Erlang 21.x

When upgrading to this release and upgrading Erlang to 21.x at the same time, extra care has to be taken.
Since CLI tools from RabbitMQ releases older than 3.7.7 will fail on Erlang 21,
RabbitMQ must be upgraded before Erlang.

Upgrade Doc Guides and Change Log

See 3.7.0 release notes upgrade and
compatibility notes if upgrading from an earlier release.

See the Upgrading guide for general documentation on upgrades and
RabbitMQ change log for release notes of other releases.

Getting Help

Any questions about this release, upgrades or RabbitMQ in general are welcome on the
RabbitMQ mailing list.

CLI Tools

Bug Fixes

• rabbitmqctl and other CLI tools could fail when used with nodes using long node names.

  GitHub issue: rabbitmq/rabbitmq-cli#311

• rabbitmqctl --help now exits with exit code of 0. rabbitmqctl (no arguments) uses code
  64 (EX_USAGE).

  GitHub issue: rabbitmq/rabbitmq-cli#307

Enhancements

• rabbitmqctl shutdown now requires the user to opt in and provide --no-wait
  to be used with remote nodes. There are no behavior changes when the command is invoked
  against a locally running node. See also the compatibility note to this release.

  GitHub issue: rabbitmq/rabbitmq-cli#309

MQTT Plugin

Enhancements

• When a retained message is published, its topic is now correctly translated
  to use MQTT topic separators (a slash) regardless of the internal representation.

  Contributed by Ryan Sandbach.

  GitHub issue: rabbitmq/rabbitmq-mqtt#175

Bug Fixes

• Clearer and shorter log messages when a socket write fails.

  GitHub issue: rabbitmq/rabbitmq-mqtt#178

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.7.12.tar.gz.