Installing vFabric RabbitMQ

Installation procedures for vFabric RabbitMQ server differ according to the operating system you are using.

Subtopics

RHEL: Install vFabric RabbitMQ from an RPM

RHEL: Start and Stop the RabbitMQ Server

RHEL: Install vFabric RabbitMQ Client Libraries from an RPM

SLES: Install vFabric RabbitMQ

Ubuntu: Install vFabric RabbitMQ from the vFabric Debian Package Repository

Ubuntu: Start and Stop the RabbitMQ Server

Ubuntu: Install vFabric RabbitMQ Client Libraries from the vFabric Debian Package Repository

Windows: Install vFabric RabbitMQ Server

Windows: Start and Stop the RabbitMQ Server

Windows: Install vFabric RabbitMQ Client Libraries

Activate a vFabric RabbitMQ License

Upgrade vFabric RabbitMQ

Troubleshooting Installation Problems

RHEL: Install vFabric RabbitMQ from a RPM

You can install vFabric RabbitMQ on Red Hat Linux Enterprise (RHEL) computers using the Pivotal RPM repository. See Install vFabric RabbitMQ from a Downloaded RPM.

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.

Install vFabric RabbitMQ from the RPM Repository

Prerequisites

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

  • Install Erlang.

  • Install the Pivotal vFabric repository RPM, which makes it easy to browse for the RPMs. Install the repository on each RHEL computer on which you want to install vFabric RabbitMQ.

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

    2. Install the Pivotal repository RPM using the following wget command.

      prompt# wget -q -O - packages.gopivotal.com | sh

      The command works for both RHEL 5 and RHEL 6.

      The command performs the following tasks:

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

      • Installs the Pivotal vFabric repository RPM.

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

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

    3. Enter the command yum search vfabric to view the list of vFabric components that you can install from the 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
      ...

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. Execute the following yum command:

    prompt# yum install vfabric-rabbitmq-server
  3. Respond to the prompts to complete RabbitMQ installation.

What the yum command does

The yum command:

  • Installs vFabric RabbitMQ into the /opt/vmware/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 rabbitmq). 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

  • Activate a local license as described in Activate a vFabric RabbitMQ License.

  • Start and Stop the vFabric RabbitMQ Server to ensure that you installed it correctly.

  • Ensure that the RabbitMQ management plugin is enabled by running the following command:

    prompt# cd /opt/vmware/rabbitmq/bin
    prompt# ./rabbitmq-plugins list

    Check that there is an [E] next to rabbitmq_management, which indicates the plugin is enabled, as shown:

    ...
    [E] rabbitmq_management               3.2.[x]
    [e] rabbitmq_management_agent         3.2.[x]
    [E] rabbitmq_management_visualiser    3.2.[x]
    ...

    If the management plugin is not enabled, enable it with the following command:

    prompt# ./rabbitmq-plugins enable rabbitmq_management

    Restart the RabbitMQ server for the changes to take effect.

  • To ensure RabbitMQ Server is running, launch the management console in your browser using the following URL:

    http://host:15672

    If your browser is on the same computer as the RabbitMQ server you can use http://localhost:15672.

    Enter the default credentials that were created at installation: user guest and password guest.

    Use the management console to manage exchanges, queues, bindings, virtual hosts, users and permissions.

  • Install the vFabric RabbitMQ Java Client Libraries.

  • Read the Next Steps section for a high-level roadmap to subsequent tasks.

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.

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