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 and install RabbitMQ on a supported 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 are required for 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 user name 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. You can configure the AMQP service to encrypt these messages by using SSL. You can also configure the service to verify the broker certificate by using the default JCEKS trust store of the Java runtime environment on the vCloud Director cell, typically at $VCLOUD_HOME/jre/lib/security/cacerts.

To enable SSL with the vCloud Director AMQP service:

  1. In the vCloud Director Web console, click the Administration tab, and click Extensibility.

  2. Click Extensibility, and click the Settings tab.

  3. In the AMQP Broker Settings section, select Use SSL.

  4. Either select the Аccept all certificates check box or provide one of the following:

  • an SSL certificate pathname

  • a JCEKS trust store pathname and password