RHEL: Install vFabric RabbitMQ from an RPM

VMware recommends that you install vFabric RabbitMQ on a Red Hat Linux Enterprise (RHEL) computer by first installing the VMware RPM repository and then using yum to perform the actual installation. See Install vFabric RabbitMQ from the VMware RPM Repository.

You can also download the RPM from the VMware Download page and install it on your RHEL computer using the rpm command, as described in Install vFabric RabbitMQ from a Downloaded RPM. This installation option is necessary if you are installing a version of RabbitMQ that is not yet certified for vFabric Suite, which means that it has not yet been added to the VMware RPM repository.

Install vFabric RabbitMQ from the VMware RPM Repository

VMware recommends that you install RabbitMQ on RHEL computers using the VMware RPM repository.

Prerequisites

  • Verify that your system meets the supported configurations described in Supported Configurations and System Requirements.

  • Install the vFabric repository RPM, which makes it easier for you to browse the vFabric RPMs, including the vFabric RabbitMQ RPM. The vFabric repository contains all RPMs that are certified with this release of vFabric Suite. You install the vFabric repository RPM on each RHEL computer on which you want to install one or more vFabric components, such as vFabric RabbitMQ.

    1. On the RHEL computer, start a terminal as the root user or as an unprivileged user who has sudo privileges.

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

      If necessary, use sudo to run the preceding commands if you are not the root user.

      The command performs the following tasks:

      • Imports the vFabric GNU Privacy Guard (GPG) key.

      • Installs the vFabric 5.2 repository RPM.

      • Launches the VMware End User License Agreement (EULA) acceptance and repository configuration script.

      • Outputs the EULA for you to read; you must answer yes to accept the terms and continue.

    3. Use the yum search vfabric or yum search vmware command to view the list of vFabric components that you can install from the VMware repository. For example (output truncated for clarity):

      prompt# yum search vfabric
      ...
      ======================================== Matched: vfabric ========================================
      vfabric-rabbitmq-java-client-bin.noarch : The RabbitMQ Java Client Library
      vfabric-rabbitmq-server.x86_64 : The RabbitMQ server
      vfabric-tc-server-standard.noarch : VMware vFabric tc Server Standard
      vfabric-web-server.x86_64 : VMware vFabric Web Server
      ...

      The vFabric RabbitMQ RPM is called vfabric-rabbitmq-server.

  • Install Erlang.

Procedure

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

  2. Execute the following yum command to install vFabric RabbitMQ server. (If necessary, use sudo to run the command if you are not logged in as the root user.)

    prompt# yum install vfabric-rabbitmq-server

    The yum command begins the install process, resolves dependencies, and displays the packages it will install.

    The yum command automatically chooses the appropriate RPM package based on your architecture (32- or 64-bit).

  3. Enter y at the prompt to begin the actual installation.

    If the installation is successful, you see a Complete! message at the end.

What the yum install command does

The yum install command:

  • Installs vFabric RabbitMQ into the /opt/vmware/vfabric-rabbitmq directory and sets the owner of the directory, along with all child directories and files, to root:root.

  • If the user does not already exist, adds a rabbitmq non-interactive user (in the group vfabric). The RabbitMQ server process runs as the rabbitmq user.

    You cannot log in directly as the rabbitmq user because interactive login is disabled.

What to do next

Install vFabric RabbitMQ from a Downloaded RPM

You can install vFabric RabbitMQ on RHEL by downloading the RPM from the VMware download center and executing the rpm command. This procedure is necessary if you want to install a version of RabbitMQ that has not yet been certified for vFabric Suite.

Prerequisites

Procedure

  1. Log in to the RHEL computer on which you will install vFabric RabbitMQ as the root user (or as an unprivileged user who has sudo privileges.)

  2. Download the RabbitMQ RPM file from the VMware Download page and save it to a directory on your computer. The RPM file is called vfabric-web-server-version.architecture.rpm.

    Chose the architecture (32- or 64-bit) appropriate for your computer.

  3. Start a terminal and change to the directory in which you downloaded the RPM.

  4. Execute the following rpm command to install RabbitMQ:

    prompt# rpm -ivhf vfabric-rabbitmq-server-version.architecture.rpm
  5. In the previous section, see What the yum install command does for post-installation information, such as the installation directory. (The yum install command corresponds to the rpm command in this procedure.)

See What to do next for the suggested next steps.