AMQP, the Advanced Message Queuing Protocol, is an open standard for message queuing that supports flexible messaging for enterprise systems. vCloud Director uses the RabbitMQ AMQP broker to provide the message bus used by extension services, object extensions, and notifications.

Procedure

  1. Download the RabbitMQ Server from https://www.rabbitmq.com/download.html.

    See the vCloud Director Release Notes for the list of supported RabbitMQ releases.

  2. Follow the RabbitMQ installation instructions to install RabbitMQ on any convenient host.

    The RabbitMQ server host must be reachable on the network by each vCloud Director cell.

  3. During the RabbitMQ installation, make a note of the values that you will need to supply when configuring vCloud Director to work with this RabbitMQ installation.
    • The fully-qualified domain name of the RabbitMQ server host, for example amqp.example.com.

    • A username and password that are valid for authenticating with RabbitMQ.

    • The port at which the broker listens for messages. The default is 5672.

    • The RabbitMQ virtual host. The default is "/".

What to do next

By default, the vCloud Director AMQP service sends unencrypted messages. If you configure it to encrypt these messages using SSL, it verifies the broker's certificate by using the default JCEKS trust store of the Java runtime environment on the vCloud Director cell, typically located in the cell's $VCLOUD_HOME/jre/lib/security/cacerts directory.

To use SSL with the vCloud Director AMQP service, select Use SSL on the AMQP Broker Settings section of the Extensibility page of the vCloud Director Web console, and provide either of the following:

  • an SSL certificate pathname

  • a JCEKS trust store pathname and password

If you do not need to validate the AMQP broker's certificate, you can select Accept all certificates.