Skip to content

Commit e21a3bd

Browse files
Re-arrange 4.0 release notes
1 parent 8c60cf7 commit e21a3bd

File tree

1 file changed

+16
-16
lines changed

1 file changed

+16
-16
lines changed

release-notes/4.0.0.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -25,14 +25,14 @@ Some key improvements in this release are listed below.
2525

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

28-
## Release Artifacts
29-
30-
RabbitMQ releases are distributed via [GitHub](https://github.com/rabbitmq/rabbitmq-server/releases).
31-
[Debian](https://rabbitmq.com/install-debian.html) and [RPM packages](https://rabbitmq.com/install-rpm.html) are available via Cloudsmith mirrors.
32-
33-
[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)
34-
are other installation options. They are updated with a delay.
28+
## Breaking Changes and Compatibility Notes
3529

30+
* 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
31+
Instead, set the new RabbitMQ 4.0 settings `anonymous_login_user` and `anonymous_login_pass` (both values default to `guest`).
32+
For production scenarios, [disallow anonymous logins](https://www.rabbitmq.com/docs/next/production-checklist#anonymous-login)
33+
* RabbitMQ 3.13 `rabbitmq.conf` setting `rabbitmq_amqp1_0.default_vhost` is unsupported in RabbitMQ 4.0.
34+
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)
35+
* 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`
3636

3737
## Erlang/OTP Compatibility Notes
3838

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

4444

45+
## Release Artifacts
46+
47+
RabbitMQ releases are distributed via [GitHub](https://github.com/rabbitmq/rabbitmq-server/releases).
48+
[Debian](https://rabbitmq.com/install-debian.html) and [RPM packages](https://rabbitmq.com/install-rpm.html) are available via Cloudsmith mirrors.
49+
50+
[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)
51+
are other installation options. They are updated with a delay.
52+
53+
4554
## Upgrading to 4.0
4655

4756
### Documentation guides on upgrades
@@ -81,15 +90,6 @@ TBD
8190

8291
TBD
8392

84-
## Breaking Changes
85-
86-
* 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.
87-
Instead, set the new RabbitMQ 4.0 settings `anonymous_login_user` and `anonymous_login_pass` (both values default to `guest`).
88-
For production scenarios, [disallow anonymous logins](https://www.rabbitmq.com/docs/next/production-checklist#anonymous-login).
89-
* RabbitMQ 3.13 `rabbitmq.conf` setting `rabbitmq_amqp1_0.default_vhost` is unsupported in RabbitMQ 4.0.
90-
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).
91-
* 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
92-
9393
### Dependency Changes
9494

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

0 commit comments

Comments
 (0)