Skip to content

Latest commit

 

History

History
364 lines (277 loc) · 12.2 KB

README.md

File metadata and controls

364 lines (277 loc) · 12.2 KB
Raw

Zero-dependency Erlang RPM for RabbitMQ

This is a (virtually) zero dependency 64-bit Erlang RPM package that provides just enough to run RabbitMQ. It may be easier to install than other Erlang RPMs in most environments. It may or may not be suitable for running other Erlang-based software or 3rd party RabbitMQ plugins.

This package has an implicit OpenSSL/libcrypto dependency (see below).

Team RabbitMQ also packages recent Erlang/OTP releases for Debian.

Provided Erlang/OTP Versions

The package currently targets Erlang/OTP 21.x, 20.3.x, 19.3.x. Only 64-bit packages are provided.

Some earlier releases are available but highly discouraged due to known bugs that are catastrophic to RabbitMQ.

Implicit OpenSSL/libcrypto Dependency

This package intentionally does not include OpenSSL/libcrypto. It must be provisioned separately. Recent Erlang versions require a modern OpenSSL version, currently this means 1.0.2 or later.

Supported CentOS Versions

Please note the implicit OpenSSL/libcrypto dependency section above.

  • CentOS 7
  • CentOS 6

Release Artifacts

Yum repositories are available at rabbitmq/erlang on Package Cloud and rabbitmq-erlang org on Bintray. See the repository setup instructions below.

For direct RPM package downloads, see GitHub releases.

Signing Keys

Packages provisioned from PackageCloud are signed by the PackageCloud repository key. Other sources use the standard RabbitMQ signing key.

Package Cloud

Erlang 21.x

Note that Erlang/OTP 21 is supported by RabbitMQ starting with version 3.7.7.

Package Cloud supports a variety of options for RPM package installation: from Yum configuration to shell scripts to Chef and Puppet.

See Package Cloud repository installation page for details.

To use the most recent version on CentOS 7:

# In /etc/yum.repos.d/rabbitmq_erlang.repo
[rabbitmq_erlang]
name=rabbitmq_erlang
baseurl=https://packagecloud.io/rabbitmq/erlang/el/7/$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/rabbitmq/erlang/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300

[rabbitmq_erlang-source]
name=rabbitmq_erlang-source
baseurl=https://packagecloud.io/rabbitmq/erlang/el/7/SRPMS
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/rabbitmq/erlang/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300

To install the package:

yum install erlang

To use the most recent version on CentOS 6:

# In /etc/yum.repos.d/rabbitmq_erlang.repo
[rabbitmq_erlang]
name=rabbitmq_erlang
baseurl=https://packagecloud.io/rabbitmq/erlang/el/6/$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/rabbitmq/erlang/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300

[rabbitmq_erlang-source]
name=rabbitmq_erlang-source
baseurl=https://packagecloud.io/rabbitmq/erlang/el/6/SRPMS
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/rabbitmq/erlang/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300

To install the package:

yum install erlang

Bintray Yum Repositories

To use the Bintray Yum repositories, here are the .repo configuration files:

Erlang 21.x

Note that Erlang/OTP 21 is supported by RabbitMQ starting with version 3.7.7.

To use Erlang 21.x on CentOS 7:

# In /etc/yum.repos.d/rabbitmq-erlang.repo
[rabbitmq-erlang]
name=rabbitmq-erlang
baseurl=https://dl.bintray.com/rabbitmq-erlang/rpm/erlang/21/el/7
gpgcheck=1
gpgkey=https://dl.bintray.com/rabbitmq/Keys/rabbitmq-release-signing-key.asc
repo_gpgcheck=0
enabled=1

To use Erlang 21.x on CentOS 6:

# In /etc/yum.repos.d/rabbitmq-erlang.repo
[rabbitmq-erlang]
name=rabbitmq-erlang
baseurl=https://dl.bintray.com/rabbitmq-erlang/rpm/erlang/21/el/6
gpgcheck=1
gpgkey=https://dl.bintray.com/rabbitmq/Keys/rabbitmq-release-signing-key.asc
repo_gpgcheck=0
enabled=1

To install the package:

yum install erlang

Erlang 20.3.x

Note that Erlang/OTP 20 is supported by RabbitMQ starting with version 3.6.11.

To use Erlang 20.3.x on CentOS 7:

# In /etc/yum.repos.d/rabbitmq-erlang.repo
[rabbitmq-erlang]
name=rabbitmq-erlang
baseurl=https://dl.bintray.com/rabbitmq-erlang/rpm/erlang/20/el/7
gpgcheck=1
gpgkey=https://dl.bintray.com/rabbitmq/Keys/rabbitmq-release-signing-key.asc
repo_gpgcheck=0
enabled=1

To use Erlang 20.3.x on CentOS 6:

# In /etc/yum.repos.d/rabbitmq-erlang.repo
[rabbitmq-erlang]
name=rabbitmq-erlang
baseurl=https://dl.bintray.com/rabbitmq-erlang/rpm/erlang/20/el/6
gpgcheck=1
gpgkey=https://dl.bintray.com/rabbitmq/Keys/rabbitmq-release-signing-key.asc
repo_gpgcheck=0
enabled=1

To install the package:

yum install erlang

Erlang 19.x

To use Erlang 19.x on CentOS 7:

# In /etc/yum.repos.d/rabbitmq-erlang.repo
[rabbitmq-erlang]
name=rabbitmq-erlang
baseurl=https://dl.bintray.com/rabbitmq-erlang/rpm/erlang/19/el/7
gpgcheck=1
gpgkey=https://dl.bintray.com/rabbitmq/Keys/rabbitmq-release-signing-key.asc
repo_gpgcheck=0
enabled=1

To use Erlang 19.x on CentOS 6:

# In /etc/yum.repos.d/rabbitmq-erlang.repo
[rabbitmq-erlang]
name=rabbitmq-erlang
baseurl=https://dl.bintray.com/rabbitmq-erlang/rpm/erlang/19/el/6
gpgcheck=1
gpgkey=https://dl.bintray.com/rabbitmq/Keys/rabbitmq-release-signing-key.asc
repo_gpgcheck=0
enabled=1

To install the package:

yum install erlang

Available Erlang Applications

This package removes certain Erlang/OTP components that are non-essential for running RabbitMQ but can greatly complicate installation process by bringing in complicated dependencies.

Only the following OTP applications are provided:

  • asn1
  • compiler
  • crypto
  • eldap
  • erl_interface
  • erts
  • hipe
  • inets
  • kernel
  • mnesia
  • os_mon
  • public_key
  • reltool
  • runtime_tools
  • sasl
  • snmp
  • ssl
  • stdlib
  • syntax_tools
  • xmerl

Building from Source

With Docker

cd docker

#
# Use build-image-and-rpm.sh to execute all scripts:
# build a Centos 7 image and build the RPM using it
#
./build-image-and-rpm.sh 7 --no-cache

#
# To only build a CentOS 7 Docker image with necessary toolchain
#
 ./build-docker-image.sh 7 --no-cache

#
# To only build the RPM using an already built and available image
#
./build-rpm-in-docker 7

then find the result under docker/build-dir-{CentOSVersion}/RPMS/x86_64/, e.g. build-dir-7/RPMS/x86_64/.

For CentOS 6, replace the 7 in the examples above with a 6.

Without Docker

You must be running an RPM-based distro (CentOS 7 or equivalent RHEL is highly recommended) for this to work.

sudo make

and see RPMS/x86_64/. Note that all artifacts created this way may be owned by root due to the use of sudo.

Patched Files

The patches applied affect the following files:

Older Versions

The directory versions contains the patch files used for the older versions. Git repository history can be useful as well.

Copyright and License

(c) 2011-current Pivotal Software, Inc.

Released under the Apache Software License 2.0, same as Erlang/OTP starting with 18.0.