Subtopics

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.

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.

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:

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

Prerequisites

Determine if the following software packages are installed on your
RHEL computer: ncurses, zlib,
openssl and glibc. You can use yum list
package to check; for example:

prompt# yum list ncurses

It is very likely that these packages are already installed. If
they are not, and you use yum to install the VMware Erlang
package, the yum command will install them as part of the
dependency resolution. If you install using rpm from a
downloaded RPM file, you must install the packages yourself.

If you have previously installed Erlang on your RHEL computer, but
you want to now use VMware's Erlang distribution, you must first
completely remove your existing Erlang installation. You cannot upgrade
an existing Erlang installation to the one provided by VMware using
yum install or yum upgrade.

Procedure

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

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.

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

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.

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.

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

Run the following command to synchronize the metadata:

prompt# apt-get update

If you are not the root user:

prompt$ sudo apt-get update

Install the Erlang package by running the following command:

prompt# apt-get install esl-erlang

Install
Erlang on Windows

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.

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_HOME environment variable to the
directory where you installed Erlang:

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.