Supported Configurations and System Requirements

Revised January 23, 2014.

Before installing vFabric RabbitMQ, verify that your system meets operating system and installation requirements.

Subtopics

Supported Configurations

Erlang Support

AMQP Implementation and Support

Install Erlang: Software Requirement

Supported Configurations

The following table shows supported configurations for vFabric RabbitMQ.

Note

The table indicates whether the supported configuration is for production or development. Generally, production support means you can run your production application on the platform; developer support means you can develop on the platform but you should not run your production application on it.

Table 1. vFabric RabbitMQ Supported Configurations

Operating SystemProcessor ArchitectureErlang1Production/Development Support
CentOS 5x86 (64-bit) Erlang R14B and laterProduction
CentOS 6x86 (64-bit)Erlang R14B and laterProduction
Microsoft Windows Server 2003 SP2 and laterx86 (32-bit)Erlang R14B and laterProduction
Microsoft Windows Server 2008x86 (32-bit and 64-bit)Erlang R14B and laterProduction
Microsoft Windows Server 2012x86 (64-bit)Erlang R14B and laterProduction
RedHat Enterprise Linux (RHEL) 5x86 (32-bit and 64-bit)Erlang R14B and laterProduction
RedHat Enterprise Linux (RHEL) 6x86 (32-bit and 64-bit)Erlang R14B and laterProduction
SUSE Linux Enterprise Server (SLES) 11 SP3x86 (64-bit)Erlang R14B and laterProduction
Ubuntu (All stable, non-EOL releases)x86 (64-bit)Erlang R14B and laterProduction
MacOS X 10.6 and laterx86 (64-bit)Erlang R14B and laterDevelopment
Microsoft Windows XPx86 (64-bit and 32-bit)Erlang R14B and laterDevelopment
Microsoft Windows 7x86 (64-bit)Erlang R14B and laterDevelopment
Microsoft Windows 8x86 (64-bit)Erlang R14B and laterDevelopment

Erlang Support1

VMware supports Erlang R14B and later with vFabric RabbitMQ. Certain configurations require or run better with more recent versions of Erlang. For example:

For full details, see Erlang Versions.

If you are running vFabric RabbitMQ on a Red Hat Enterprise Linux (RHEL) computer or VM, VMware provides an Erlang RPM to simplify the installation process. See Install Erlang: Software Requirement.

AMQP Implementation and Support

VMware supports Erlang R14B and later for vFabric 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. vFabric 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 vFabric RabbitMQ implementation of AMQP, see Compatibility and Conformance.

vFabric RabbitMQ also implements a number of AMQP protocol extensions.

JMS Client Support

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: Software Requirement

Install Erlang on each computer or VM on which you plan to install vFabric RabbitMQ Server.

For users installing vFabric RabbitMQ on RHEL computers or VMs, VMware provides an RPM for simplifying the Erlang installation. Note, however, that the version of Erlang provided by VMware is slightly different from the community version. Compared to the community version, the version of Erlang provided by the VMware RPM is monolithic, has fewer dependencies, and has lower disk and memory overhead. Although many applications from Erlang Open Telecom Platform (OTP) have been removed, the following applications remain: asn1, compiler, crypto, erl_interface, erts, hipe, inets, kernel, mnesia, os_mon, otp_mibs, public_key, reltool, runtime_tools, sasl, snmp, ssl, stdlib, syntax_tools and xmerl.

See the following sections for operating system-specific instructions for installing Erlang:

Install Erlang on RHEL Using a Downloaded RPM

You install the Erlang RPM by downloading it from the VMware download center and executing the rpm command.

Prerequisites

Procedure

  1. From the RHEL computer or VM on which you will install vFabric RabbitMQ, log in as the root user and start a terminal window.

  2. Download the Erlang RPM file from the Drivers and Tools tab of the vFabric RabbitMQ Download page and save it to a directory on your computer. The RPM file is called erlang-version.architecture.rpm, such as erlang-R15B-02.1.el6.x86_64.rpm.

    Choose the architecture (32- or 64-bit) and RHEL version (5 or 6) appropriate for your computer.

  3. From your terminal, change to the directory in which you downloaded the RPM.

  4. Execute the following rpm command to install Erlang:

    prompt# rpm -ivhf erlang-version.architecture.rpm

    For example:

    prompt# rpm -ivhf erlang-R15B-02.1.el6.x86_64.rpm

Install Erlang on Ubuntu

The following procedure describes how to ensure that you have the most recent version of Erlang installed on your Ubuntu computer. It uses the Erlang Solutions 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 documentation.

  1. From the Ubuntu computer on which you will install vFabric RabbitMQ, log in as the root user (or as a user with sudo privileges) and start a terminal window.

  2. Configure your computer to access the Erlang Solutions Debian package repository by editing the file /etc/apt/sources.list and 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
  3. Run the following command to synchronize the metadata:

    prompt# apt-get update

    If you are not the root user:

    prompt$ sudo apt-get update
  4. Install the Erlang package by running the following command:

    prompt# apt-get install esl-erlang

Install Erlang on Windows

  1. Download the latest Erlang Windows Binary File to the computer on which you will install vFabric RabbitMQ. This is an EXE file with a name like otp_win32_R15B02.exe.

  2. 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.

  3. Set the ERLANG_HOME environment 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 ERLANG_HOME.

    • 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.

Install Erlang on Mac OS X

For Mac OS X and other Linux platforms, you can install Erlang from source. See Download Erlang.