It is recommended that you install vFabric RabbitMQ on a computer running Ubuntu by first installing
the vFabric Debian package repository and then using
apt-get to perform the RabbitMQ installation.
Verify that your system meets the supported configurations described in Supported Configurations and System Requirements.
On the Ubuntu computer, start a terminal either as the
root user or as an unprivileged user who has
Install the vFabric Debian package repository using the following
Important: Run the entire
wget command on a single line. Be sure you include
| sh at the end, or the installation fails.
prompt# wget -q -O - http://packages.gopivotal.com/ | sh
If necessary, use
sudo to run the preceding commands if you are not logged in as the
root user. Use the following
prompt$ sudo su - -c "wget -q -O - http://packages.gopivotal.com/ | sh"
The command performs the following tasks:
Imports the vFabric GNU Privacy Guard (GPG) key.
Installs the vFabric Debian package repository.
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.
prompt# apt-cache search vfabric rabbitmq-server - vFabric RabbitMQ Server vfabric-rabbitmq-java-client-bin - The RabbitMQ Java Client Library vfabric-repo-precise - vFabric EULA and APT repo configuration utility vfabric-tc-server-standard - Commercial Java application server based on Apache Tomcat vfabric-web-server - VMware vFabric Web Server vfabric-web-server-devel - VMware vFabric Web Server Libraries and Headers ...
From the Ubuntu computer on which you will install vFabric RabbitMQ, log in as the
root user (or as an unprivileged user who has
sudo privileges) and start a terminal.
Execute the following
prompt# apt-get install rabbitmq-server
apt-get command begins the install process, resolves dependencies, and displays the packages it will install.
If necessary, use
sudo to run the preceding command if you are not logged in as the
prompt$ sudo apt-get install rabbitmq-server
apt-get install 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
If the user does not already exist, adds a
rabbitmq non-interactive user (in the group
rabbitmq). The RabbitMQ server process runs as the
You cannot log in directly as the
rabbitmq user because interactive login is disabled.
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:
prompt# invoke-rc.d rabbitmq-server restart
To ensure RabbitMQ Server is running, launch the management console in your browser using the following URL:
If your browser is on the same computer as the RabbitMQ server you can use
Enter the default credentials that were created at installation: user
guest and password
Use the management console to manage exchanges, queues, bindings, virtual hosts, users and permissions.
Read the Next Steps section for a high-level roadmap to subsequent tasks.