Revised February 14, 2013.
Before installing vFabric RabbitMQ, verify that your system meets operating system and installation requirements.
AMQP Implementation and Support
Install Erlang: Software Requirement
The following table shows supported configurations for vFabric RabbitMQ. The operating system and processor architecture support also applies to other products in vFabric Suite. See vFabric Suite supported configurations.
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. For details, see vFabric Suite supported configurations.
Table 1. vFabric RabbitMQ Supported Configurations
| Operating System | Processor Architecture | Erlang1 | Production/Developer Support |
|---|---|---|---|
| RedHat Enterprise Linux (RHEL) 5 | x86_64, x86_32 | Erlang R14B and later | Production |
| RedHat Enterprise Linux (RHEL) 6 | x86_64, x86_32 | Erlang R14B and later | Production |
| Microsoft Windows Server 2008 | x86_64, x86_32 | Erlang R14B and later | Production |
| Microsoft Windows Server 2003 SP2 and newer | x86_32 | Erlang R14B and later | Production |
| Ubuntu (All stable, non-EOL releases) | x86_64 | Erlang R14B and later | Production |
| Microsoft Windows XP | x86_64, x86_32 | Erlang R14B and later | Developer |
| Microsoft Windows 7 | x86_64, x86_32 | Erlang R14B and later | Developer |
| MacOS X 10.6+ | x86_64 | Erlang R14B and later | Developer |
VMware supports Erlang R14B and later with vFabric RabbitMQ. Certain configurations require or run better with more recent versions of Erlang. For example:
To run vFabric RabbitMQ with SSL, use Erlang R15B02. You can use R14B (SSL 4.0.1) and later, but R15B02 is the most reliable version.
To run vFabric RabbitMQ on a 64-bit Windows VM, use Erlang 15B or later. Earlier versions are 32-bit only.
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.
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.
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 the vFabric RPM Repository
VMware recommends that you install Erlang on RHEL by first installing
the vFabric RPM repository and then using yum to perform the
actual installation. The vFabric RPM repository makes it easier for you to
browse the vFabric RPMs, including the Erlang and vFabric RabbitMQ RPMs. The
vFabric repository contains all RPMs that are certified with this release of
vFabric Suite.
Determine if the following software packages are installed on your RHEL computer: ncurses, zlib, openssl and glibc. You can use yum list to check; for example:package
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.
Install the vFabric repository RPM using the following
wget command, passing it the appropriate URL. The URL
differs depending on the version of RHEL you are using.
Important: You must run the
entire wget command on a single line. Be sure you include
| sh at the end, or the RPM installation
will not work.
For RHEL 5:
prompt# wget -q -O - http://repo.vmware.com/pub/rhel5/vfabric/5.2/vfabric-5.2-suite-installer | sh
For RHEL 6:
prompt# wget -q -O - http://repo.vmware.com/pub/rhel6/vfabric/5.2/vfabric-5.2-suite-installer | sh
See the Prerequisites section of Install vFabric RabbitMQ from the
vFabric RPM Repository for information on what this
wget command does.
Install Erlang with the yum install command:
prompt# yum install erlang
Enter y at the prompts to start the installation.
Depending on your environment, the install process may prompt for
further information; answer as appropriate. The yum command
automatically selects the architecture (32- or 64-bit) appropriate to
your computer. When the install successfully finishes, you see a
Complete! message.
Install Erlang on RHEL Using a Downloaded RPM
You can install the Erlang RPM by downloading it from the VMware download center if you prefer not to use the vFabric RPM repository.
Read the prerequisites from the previous section which also apply to this section.
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-, such as version.architecture.rpmerlang-R15B-02.1.el6.x86_64.rpm.
You can also download the Erlang RPM file from the Drivers and Tools tab of the vFabric Suite Download page.
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
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:
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 Ubuntu or Mac OS X
For Mac OS X, Ubuntu, and other Linux platforms, you can install Erlang from source. See Download Erlang.