Skip to content

Commit 34fcb2e

Browse files
Erlang Compat Guide: list RabbitMQ 3.10.x series as unsupported
1 parent e95c3b5 commit 34fcb2e

File tree

1 file changed

+68
-69
lines changed

1 file changed

+68
-69
lines changed

site/which-erlang.md

+68-69
Original file line numberDiff line numberDiff line change
@@ -207,6 +207,74 @@ For RabbitMQ releases that have reached end of life, see [Unsupported Series Com
207207
</ul>
208208
</td>
209209
</tr>
210+
</table>
211+
212+
As a guideline, most recent minor and patch versions of each supported Erlang/OTP series
213+
are recommended.
214+
215+
## <a id="erlang-repositories" class="anchor" href="#erlang-repositories">Provisioning Latest Erlang Releases</a>
216+
217+
Most recent versions can be obtained from a number of sources:
218+
219+
* Debian Erlang packages from Team RabbitMQ on [Cloudsmith and its mirror](install-debian.html#apt-cloudsmith) or [Launchpad](install-debian.html#apt-launchpad-erlang)
220+
* [Zero dependency Erlang RPM](https://github.com/rabbitmq/erlang-rpm) from Team RabbitMQ, also available [from a Cloudsmith mirror](install-rpm.html#cloudsmith)
221+
* As part of [RabbitMQ Docker image](https://github.com/docker-library/rabbitmq/)
222+
* [Erlang/OTP Version Tree](https://erlang.org/download/otp_versions_tree.html) provides binary builds of patch releases for Windows
223+
* [Erlang Solutions](https://packages.erlang-solutions.com/erlang/) package repositories
224+
* Building from source with [kerl](https://github.com/kerl/kerl)
225+
226+
## <a id="debian" class="anchor" href="#debian">Installing Erlang/OTP on Debian or Ubuntu</a>
227+
228+
Standard Debian and Ubuntu repositories provide Erlang/OTP but it is
229+
heavily sliced and diced into dozens of packages. In addition, unless the system
230+
has backport repositories enabled, the versions tend to be quite old.
231+
See [Debian and Ubuntu installation guide](./install-debian.html) for
232+
more information on the essential packages, dependencies, and alternative apt repositories.
233+
234+
## <a id="redhat" class="anchor" href="#redhat">Installing Erlang/OTP on RHEL, CentOS and Fedora</a>
235+
236+
There are multiple RPM packages available for Erlang/OTP. The recommended option is
237+
the [zero-dependency Erlang RPM](https://github.com/rabbitmq/erlang-rpm) from the RabbitMQ team.
238+
It closely follows the latest Erlang/OTP patch release schedule.
239+
240+
See [CentOS, RHEL and Fedora installation guide](./install-rpm.html) for more information on the available options.
241+
242+
243+
## <a id="clusters" class="anchor" href="#clusters">Erlang Versions in Clusters</a>
244+
245+
It is **highly recommended** that the same major version of
246+
Erlang is used across all [cluster nodes](upgrade.html#rolling-upgrades-version-limitations)
247+
(e.g. `25.x`).
248+
249+
RabbitMQ will check for internal protocol versions of
250+
Erlang and its distributed libraries when a node joins a
251+
cluster, refusing to cluster if there's a potentially
252+
incompatible combination detected.
253+
254+
Outside of a reasonably long upgrade time window, it is
255+
recommended that all nodes use exactly the same version of Erlang.
256+
257+
258+
## <a id="building-from-source" class="anchor" href="#building-from-source">Building Erlang from Source</a>
259+
260+
If a sufficiently recent Erlang package is not available for a given operating system,
261+
Erlang/OTP can be [built from source](http://www.erlang.org/doc/installation_guide/INSTALL.html).
262+
This requires a build environment that satisfies the Erlang build dependencies, such as a
263+
modern OpenSSL version.
264+
265+
[kerl](https://github.com/kerl/kerl) makes building Erlang/OTP releases from
266+
source, including specific tags from GitHub, a much more pleasant experience.
267+
268+
269+
## <a id="old-timers" class="anchor" href="#old-timers">Older RabbitMQ and Erlang Releases</a>
270+
271+
### <a id="eol-series" class="anchor" href="#eol-series">Unsupported RabbitMQ Series</a>
272+
273+
<table class="matrix">
274+
<th><a href="./changelog.html">Unsupported RabbitMQ Series</a></th>
275+
<th>Minimum required Erlang/OTP</th>
276+
<th>Maximum supported Erlang/OTP</th>
277+
<th>Notes</th>
210278

211279
<tr>
212280
<td>
@@ -383,75 +451,6 @@ For RabbitMQ releases that have reached end of life, see [Unsupported Series Com
383451
</td>
384452
</tr>
385453

386-
</table>
387-
388-
As a guideline, most recent minor and patch versions of each supported Erlang/OTP series
389-
are recommended.
390-
391-
## <a id="erlang-repositories" class="anchor" href="#erlang-repositories">Provisioning Latest Erlang Releases</a>
392-
393-
Most recent versions can be obtained from a number of sources:
394-
395-
* Debian Erlang packages from Team RabbitMQ on [Cloudsmith and its mirror](install-debian.html#apt-cloudsmith) or [Launchpad](install-debian.html#apt-launchpad-erlang)
396-
* [Zero dependency Erlang RPM](https://github.com/rabbitmq/erlang-rpm) from Team RabbitMQ, also available [from a Cloudsmith mirror](install-rpm.html#cloudsmith)
397-
* As part of [RabbitMQ Docker image](https://github.com/docker-library/rabbitmq/)
398-
* [Erlang/OTP Version Tree](https://erlang.org/download/otp_versions_tree.html) provides binary builds of patch releases for Windows
399-
* [Erlang Solutions](https://packages.erlang-solutions.com/erlang/) package repositories
400-
* Building from source with [kerl](https://github.com/kerl/kerl)
401-
402-
## <a id="debian" class="anchor" href="#debian">Installing Erlang/OTP on Debian or Ubuntu</a>
403-
404-
Standard Debian and Ubuntu repositories provide Erlang/OTP but it is
405-
heavily sliced and diced into dozens of packages. In addition, unless the system
406-
has backport repositories enabled, the versions tend to be quite old.
407-
See [Debian and Ubuntu installation guide](./install-debian.html) for
408-
more information on the essential packages, dependencies, and alternative apt repositories.
409-
410-
## <a id="redhat" class="anchor" href="#redhat">Installing Erlang/OTP on RHEL, CentOS and Fedora</a>
411-
412-
There are multiple RPM packages available for Erlang/OTP. The recommended option is
413-
the [zero-dependency Erlang RPM](https://github.com/rabbitmq/erlang-rpm) from the RabbitMQ team.
414-
It closely follows the latest Erlang/OTP patch release schedule.
415-
416-
See [CentOS, RHEL and Fedora installation guide](./install-rpm.html) for more information on the available options.
417-
418-
419-
## <a id="clusters" class="anchor" href="#clusters">Erlang Versions in Clusters</a>
420-
421-
It is **highly recommended** that the same major version of
422-
Erlang is used across all [cluster nodes](upgrade.html#rolling-upgrades-version-limitations)
423-
(e.g. `25.x`).
424-
425-
RabbitMQ will check for internal protocol versions of
426-
Erlang and its distributed libraries when a node joins a
427-
cluster, refusing to cluster if there's a potentially
428-
incompatible combination detected.
429-
430-
Outside of a reasonably long upgrade time window, it is
431-
recommended that all nodes use exactly the same version of Erlang.
432-
433-
434-
## <a id="building-from-source" class="anchor" href="#building-from-source">Building Erlang from Source</a>
435-
436-
If a sufficiently recent Erlang package is not available for a given operating system,
437-
Erlang/OTP can be [built from source](http://www.erlang.org/doc/installation_guide/INSTALL.html).
438-
This requires a build environment that satisfies the Erlang build dependencies, such as a
439-
modern OpenSSL version.
440-
441-
[kerl](https://github.com/kerl/kerl) makes building Erlang/OTP releases from
442-
source, including specific tags from GitHub, a much more pleasant experience.
443-
444-
445-
## <a id="old-timers" class="anchor" href="#old-timers">Older RabbitMQ and Erlang Releases</a>
446-
447-
### <a id="eol-series" class="anchor" href="#eol-series">Unsupported RabbitMQ Series</a>
448-
449-
<table class="matrix">
450-
<th><a href="./changelog.html">Unsupported RabbitMQ Series</a></th>
451-
<th>Minimum required Erlang/OTP</th>
452-
<th>Maximum supported Erlang/OTP</th>
453-
<th>Notes</th>
454-
455454
<tr>
456455
<td>
457456
<ul>

0 commit comments

Comments
 (0)