Supported Configurations and System Requirements
Before installing Pivotal RabbitMQ 3.5, verify that your system meets operating system and installation requirements.
The following table shows supported configurations for Pivotal RabbitMQ.
Table 1. Pivotal RabbitMQ Supported Configurations
|Operating System||Processor Architecture||Erlang1||Production/Development Support|
|CentOS 5||x86 (64-bit)||Erlang R14 and later||Production|
|CentOS 6||x86 (64-bit)||Erlang R14 and later||Production|
|MacOS X 10.6 and later||x86 (64-bit)||Erlang R14 and later||Development|
|Microsoft Windows Server 2012||x86 (64-bit)||Erlang R14 and later||Production|
|Microsoft Windows Server 2008||x86 (32-bit and 64-bit)||Erlang R14 and later||Production|
|Microsoft Windows Server 2003 SP2 and later||x86 (32-bit)||Erlang R14 and later||Production|
|RedHat Enterprise Linux (RHEL) 5||x86 (32-bit and 64-bit)||Erlang R14 and later||Production|
|RedHat Enterprise Linux (RHEL) 6||x86 (32-bit and 64-bit)||Erlang R14 and later||Production|
|SUSE Linux Enterprise Server (SLES) 11 SP3||x86 (64-bit)||Erlang R14 and later||Production|
|Ubuntu (All stable, non-EOL releases)||x86 (64-bit)||Erlang R14 and later||Production|
|Microsoft Windows XP||x86 (64-bit and 32-bit)||Erlang R14 and later||Development|
|Microsoft Windows 7||x86 (64-bit)||Erlang R14 and later||Development|
|Microsoft Windows 8||x86 (64-bit)||Erlang R14 and later||Development|
Pivotal supports Erlang R14 and later with Pivotal RabbitMQ. Certain configurations require or run better with more recent versions of Erlang. For example:
- To run Pivotal RabbitMQ with SSL, use Erlang R15B02. You can use R14 (SSL 4.0.1) and later, but R15B02 is the most reliable version.
- To run Pivotal RabbitMQ on a 64-bit Windows VM, use Erlang 15 or later. Earlier versions are 32-bit only.
For full details, see http://www.rabbitmq.com/which-erlang.html.
See also Install Erlang - Software Requirement.
Pivotal supports Erlang R14 and later for Pivotal RabbitMQ. However, certain configurations require or run better with more recent versions of Erlang. For example:
You can use the RabbitMQ client libraries and broker daemon (server) together to create an AMQP network, or use them individually with established networks. RabbitMQ implements version 0-9-1 of the specification, with legacy support for version 0-8 and 0-9. Pivotal RabbitMQ performs protocol negotiation with clients implementing 0-9-1, 0-9 and 0-8, in accordance with the specification. For more information about the Pivotal RabbitMQ implementation of AMQP, see Compatibility and Conformance.
Pivotal RabbitMQ also implements a number of Protocol Extensions.
The JMS Client for RabbitMQ feature is an implementation of the Java Message Service (JMS) 1.1 specification that uses the RabbitMQ Java client API. This feature allows new and existing JMS applications to connect with RabbitMQ brokers through Advanced Message Queueing Protocol (AMQP). JMS applications can interoperate with AMQP clients on diverse platforms, including non-Java platforms.
Install Erlang on each computer or VM on which you plan to install Pivotal RabbitMQ Server.
See the following sections for operating system-specific instructions for installing Erlang:
- Install Erlang on RHEL Using a Downloaded RPM
- Install Erlang on Ubuntu
- Install Erlang on Windows
- Install Erlang on Mac OS X
You install the Erlang RPM by downloading it from https://www.rabbitmq.com/releases/erlang/ and executing the
Determine if the following software packages are installed on your RHEL computer:
glibc. You can use
yum list packageto check; for example:
prompt# yum list ncurses
It is very likely that these packages are already installed. If they are not, and you use
yumto install the Pivotal Erlang package, the
yumcommand will install them as part of the dependency resolution. If you install using
rpmfrom a downloaded RPM file, you must install the packages yourself.
- From the RHEL computer or VM on which you will install Pivotal RabbitMQ, log in as the
rootuser and start a terminal window.
Download the Erlang RPM file from the RabbitMQ Release Artifacts page, and save it to a directory on your computer. The RPM file is called
erlang-version.architecture.rpm, such as erlang-17.4-1.el6.x86_64.rpm.
Choose the correct architecture (64-bit) and RHEL version (6 or 7) for your computer.
From your terminal, change to the directory in which you downloaded the RPM.
Execute the following
rpmcommand to install Erlang:
prompt# rpm -ivhf erlang-version.architecture.rpm
The following procedure describes how to ensure that you have the most recent version of Erlang installed on your Ubuntu computer. It uses the https://www.erlang-solutions.com/ distributions and includes instructions on configuring your computer to access their Debian package repository. For complete instructions on using the Erlang distributions from Erlang Solutions, see the https://www.erlang-solutions.com/downloads/erlang-otp/documentation.
- From the Ubuntu computer on which you will install Pivotal RabbitMQ, log in as the
rootuser (or as a user with
sudoprivileges) and start a terminal window.
Configure your computer to access the Erlang Solutions Debian package repository by editing the file
/etc/apt/sources.listand adding the line appropriate to your version of Ubuntu:
For Lucid (10.04 LTS):
deb http://packages.erlang-solutions.com/debian lucid contrib
For Precise (12.04 LTS):
deb http://packages.erlang-solutions.com/debian precise contrib
Run the following command to synchronize the metadata:
prompt# apt-get update
If you are not the
prompt$ sudo apt-get update
Install the Erlang package by running the following command:
prompt# apt-get install esl-erlang
- Download the latest http://www.erlang.org/download.html to the computer on which you will install Pivotal RabbitMQ. This is an EXE file with a name like
- Double-click the file you downloaded to start the installer and follow the instructions to complete the installation. You can take all the default values.
- Set the
ERLANG_HOMEenvironment variable to the directory where you installed Erlang:
- Choose Control Panel > System > Advanced system settings > Environment variables.
- Under System variables, click New…
- In the Variable name field, enter
- In the Variable value field, enter the full path to the Erlang installation directory. For example, if you ran the Erlang R15B2 installer and accepted the defaults, the path is
C:\Program Files (x86)\erl5.9.2.
- Click OK.
For Mac OS X and other Linux platforms, you can install Erlang from source. See http://www.erlang.org/download.html.