QpidSupport

Table of contents:

= Qpid Support = This page discusses how to use Apache Qpid as the messaging backend for Nova. Using Qpid with Nova would be in place of using RabbitMQ. Qpid support will be first introduced in the Essex release, assuming that this patch goes in.

= Dependency Installation = For Nova to use Qpid, you must install a couple of things. You need Qpid's Python client library on any machine running Nova services. You also need at least one instance of the Qpid broker running somewhere.

Fedora
To install the Qpid Python client library:

`   # yum install python-qpid`

To install the Qpid broker:

`   # yum install qpid-cpp-server`

To start the Qpid broker:

`   # systemctl start qpidd.service`

To have the Qpid broker started at boot time:

`   # chkconfig qpidd on`

Ubuntu
Qpid made it into Ubuntu in the most recent LTS, Ubuntu Precise (12.04).

= Nova Configuration =

All of the options discussed in this section should be set in the `/etc/nova/nova.conf` file.

Options You Will Use
The current default for Nova (as of Diablo and Essex, at least) is to use the backend that utilizes RabbitMQ as the message broker. You must modify the Nova configuration to tell it to use the Qpid backend. To do this, add the following line to `nova.conf` for Folsom:

`   --rpc_backend=nova.openstack.common.rpc.impl_qpid`

By default, the nova services will attempt to connect to the broker on `localhost`. If you would like to change the Qpid broker host, use the following option:

`   --qpid_hostname=hostname.example.com`

Options You Might Use
If the Qpid broker is listening on a port other than the AMQP default of `5672`, you will need to set this option:

`   --qpid_port=12345`

If you configure the Qpid broker to require authentication, you will need to add a username and password to the configuration.

`   --qpid_username=username`

`   --qpid_password=password`

By default, TCP is used as the transport. If you would like to enable SSL, set the following option:

`   --qpid_protocol=ssl`

Options You Probably Won't Use
The following table lists options that are available but are less commonly used than the options discussed above.

{| border="1" cellpadding="2" cellspacing="0"
 * Option
 * Default
 * `--qpid_sasl_mechanisms`
 * `--qpid_reconnect`
 * True
 * `--qpid_reconnect_timeout`
 * 0
 * `--qpid_reconnect_limit`
 * 0
 * `--qpid_reconnect_interval_min`
 * 0
 * `--qpid_reconnect_interval_max`
 * 0
 * `--qpid_reconnect_interval`
 * 0
 * `--qpid_heartbeat`
 * 5
 * `--qpid_tcp_nodelay`
 * True
 * 0
 * `--qpid_reconnect_interval`
 * 0
 * `--qpid_heartbeat`
 * 5
 * `--qpid_tcp_nodelay`
 * True
 * `--qpid_tcp_nodelay`
 * True
 * True