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

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 an RPM

You 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 --nodeps vfabric-rabbitmq-server-version.architecture.rpm

What the rpm command does

The rpm 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 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

  • 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.1.5
    [e] rabbitmq_management_agent         3.1.5
    [E] rabbitmq_management_visualiser    3.1.5
    ...

    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.