Skip to content

Commit

Permalink
Re-arrange 4.0 release notes
Browse files Browse the repository at this point in the history
(cherry picked from commit e21a3bd)
  • Loading branch information
michaelklishin authored and mergify[bot] committed Aug 15, 2024
1 parent 9472ada commit 954bd11
Showing 1 changed file with 16 additions and 16 deletions.
32 changes: 16 additions & 16 deletions release-notes/4.0.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,14 +25,14 @@ Some key improvements in this release are listed below.

See Compatibility Notes below to learn about **breaking or potentially breaking changes** in this release.

## Release Artifacts

RabbitMQ releases are distributed via [GitHub](https://github.com/rabbitmq/rabbitmq-server/releases).
[Debian](https://rabbitmq.com/install-debian.html) and [RPM packages](https://rabbitmq.com/install-rpm.html) are available via Cloudsmith mirrors.

[Community Docker image](https://hub.docker.com/_/rabbitmq/), [Chocolatey package](https://community.chocolatey.org/packages/rabbitmq), and the [Homebrew formula](https://www.rabbitmq.com/docs/install-homebrew)
are other installation options. They are updated with a delay.
## Breaking Changes and Compatibility Notes

* RabbitMQ 3.13 [rabbitmq.conf](https://www.rabbitmq.com/docs/configure#config-file) settings `mqtt.default_user`, `mqtt.default_password`, and `amqp1_0.default_user` are unsupported in RabbitMQ 4.0
Instead, set the new RabbitMQ 4.0 settings `anonymous_login_user` and `anonymous_login_pass` (both values default to `guest`).
For production scenarios, [disallow anonymous logins](https://www.rabbitmq.com/docs/next/production-checklist#anonymous-login)
* RabbitMQ 3.13 `rabbitmq.conf` setting `rabbitmq_amqp1_0.default_vhost` is unsupported in RabbitMQ 4.0.
Instead `default_vhost` will be used to determine the default vhost an AMQP 1.0 client connects to(i.e. when the AMQP 1.0 client does not define the vhost in the `hostname` field of the `open` frame)
* RabbitMQ Shovels will be able connect to a RabbitMQ 4.0 node via AMQP 1.0 only when the Shovel runs on a RabbitMQ node >= `3.13.7`

## Erlang/OTP Compatibility Notes

Expand All @@ -42,6 +42,15 @@ This release [requires Erlang 26.2](https://www.rabbitmq.com/docs/which-erlang).
what package repositories and tools can be used to provision latest patch versions of Erlang 26.x.


## Release Artifacts

RabbitMQ releases are distributed via [GitHub](https://github.com/rabbitmq/rabbitmq-server/releases).
[Debian](https://rabbitmq.com/install-debian.html) and [RPM packages](https://rabbitmq.com/install-rpm.html) are available via Cloudsmith mirrors.

[Community Docker image](https://hub.docker.com/_/rabbitmq/), [Chocolatey package](https://community.chocolatey.org/packages/rabbitmq), and the [Homebrew formula](https://www.rabbitmq.com/docs/install-homebrew)
are other installation options. They are updated with a delay.


## Upgrading to 4.0

### Documentation guides on upgrades
Expand Down Expand Up @@ -81,15 +90,6 @@ TBD

TBD

## Breaking Changes

* RabbitMQ 3.13 [rabbitmq.conf](https://www.rabbitmq.com/docs/configure#config-file) settings `mqtt.default_user`, `mqtt.default_password`, and `amqp1_0.default_user` are unsupported in RabbitMQ 4.0.
Instead, set the new RabbitMQ 4.0 settings `anonymous_login_user` and `anonymous_login_pass` (both values default to `guest`).
For production scenarios, [disallow anonymous logins](https://www.rabbitmq.com/docs/next/production-checklist#anonymous-login).
* RabbitMQ 3.13 `rabbitmq.conf` setting `rabbitmq_amqp1_0.default_vhost` is unsupported in RabbitMQ 4.0.
Instead `default_vhost` will be used to determine the default vhost an AMQP 1.0 client connects to (i.e. when the AMQP 1.0 client does not define the vhost in the `hostname` field of the `open` frame).
* RabbitMQ shovels can connect to a RabbitMQ 4.0 node via AMQP 1.0 only when the shovel runs on a RabbitMQ node >= 3.13.7

### Dependency Changes

* Ra was [upgraded to `2.13.5`](https://github.com/rabbitmq/ra/releases)
Expand Down

0 comments on commit 954bd11

Please sign in to comment.