64b6c9261e
Current folder name New folder name Book title ---------------------------------------------------------- basic-install DELETE cli-guide DELETE common common NEW admin-guide-cloud Cloud Administrators Guide docbkx-example DELETE openstack-block-storage-admin DELETE openstack-compute-admin DELETE openstack-config config-reference OpenStack Configuration Reference openstack-ha high-availability-guide OpenStack High Availabilty Guide openstack-image image-guide OpenStack Virtual Machine Image Guide openstack-install install-guide OpenStack Installation Guide openstack-network-connectivity-admin admin-guide-network OpenStack Networking Administration Guide openstack-object-storage-admin DELETE openstack-security security-guide OpenStack Security Guide openstack-training training-guide OpenStack Training Guide openstack-user user-guide OpenStack End User Guide openstack-user-admin user-guide-admin OpenStack Admin User Guide glossary NEW OpenStack Glossary bug: #1220407 Change-Id: Id5ffc774b966ba7b9a591743a877aa10ab3094c7 author: diane fleming
120 lines
5.2 KiB
XML
120 lines
5.2 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<section xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
|
|
xml:id="configuring-rpc">
|
|
<?dbhtml stop-chunking?>
|
|
<title>Configuring the Oslo RPC Messaging System</title>
|
|
|
|
<para>OpenStack projects use an open standard for messaging middleware
|
|
known as AMQP. This messaging middleware enables the OpenStack
|
|
services which will exist across multiple servers to talk to each other.
|
|
OpenStack Oslo RPC supports three implementations of AMQP:
|
|
<application>RabbitMQ</application>,
|
|
<application>Qpid</application>, and
|
|
<application>ZeroMQ</application>.</para>
|
|
|
|
<section xml:id="configuration-rabbitmq">
|
|
<title>Configuration for RabbitMQ</title>
|
|
|
|
<para>OpenStack Oslo RPC uses <application>RabbitMQ</application> by
|
|
default. This section discusses the configuration options that are
|
|
relevant when <application>RabbitMQ</application> is used. The
|
|
<literal>rpc_backend</literal> option is not required as long as
|
|
<application>RabbitMQ</application> is the default messaging system.
|
|
However, if it is included the configuration, it must be set to
|
|
<literal>nova.openstack.common.rpc.impl_kombu</literal>.</para>
|
|
|
|
|
|
<programlisting language="ini">rpc_backend=nova.openstack.common.rpc.impl_kombu</programlisting>
|
|
|
|
<para>The following tables describe the rest of the options that
|
|
can be used when <application>RabbitMQ</application> is used
|
|
as the messaging system. You can configure the messaging
|
|
communication for different installation scenarios as well as
|
|
tune RabbitMQ's retries and the size of the RPC thread pool.
|
|
If you want to monitor notifications through RabbitMQ, you
|
|
must set the <literal>notification_driver</literal> option in
|
|
<filename>nova.conf</filename> to
|
|
<literal>nova.notifier.rabbit_notifier</literal>. The default
|
|
for sending usage data is 60 seconds plus a randomized 0-60 seconds.
|
|
</para>
|
|
|
|
<xi:include href="tables/nova-rabbitmq.xml"/>
|
|
<xi:include href="tables/nova-kombu.xml"/>
|
|
</section>
|
|
|
|
<section xml:id="configuration-qpid">
|
|
<title>Configuration for Qpid</title>
|
|
|
|
<para>This section discusses the configuration options that are relevant
|
|
if <application>Qpid</application> is used as the messaging system for
|
|
OpenStack Oslo RPC. <application>Qpid</application> is not the default
|
|
messaging system, so it must be enabled by setting the
|
|
<literal>rpc_backend</literal> option in
|
|
<filename>nova.conf</filename>.</para>
|
|
|
|
<programlisting language="ini">rpc_backend=nova.openstack.common.rpc.impl_qpid</programlisting>
|
|
|
|
<para>This next critical option points the compute nodes to the
|
|
<application>Qpid</application> broker (server). Set
|
|
<literal>qpid_hostname</literal> in <filename>nova.conf</filename> to
|
|
be the hostname where the broker is running.</para>
|
|
|
|
<note>
|
|
<para>The -<literal>-qpid_hostname</literal> option accepts a value in
|
|
the form of either a hostname or an IP address.</para>
|
|
</note>
|
|
|
|
<programlisting language="ini">qpid_hostname=hostname.example.com</programlisting>
|
|
|
|
<para>If the <application>Qpid</application> broker is listening on a
|
|
port other than the AMQP default of <literal>5672</literal>, you will
|
|
need to set the <literal>qpid_port</literal> option:</para>
|
|
|
|
<programlisting language="ini">qpid_port=12345</programlisting>
|
|
|
|
<para>If you configure the <application>Qpid</application> broker to
|
|
require authentication, you will need to add a username and password to
|
|
the configuration:</para>
|
|
|
|
<programlisting language="ini">qpid_username=username
|
|
qpid_password=password</programlisting>
|
|
|
|
<para>By default, TCP is used as the transport. If you would like to
|
|
enable SSL, set the <literal>qpid_protocol</literal> option:</para>
|
|
|
|
<programlisting language="ini">qpid_protocol=ssl</programlisting>
|
|
|
|
<para>The following table lists the rest of the options used by the Qpid
|
|
messaging driver for OpenStack Oslo RPC. It is not common that these
|
|
options are used.</para>
|
|
|
|
<xi:include href="tables/nova-qpid.xml"/>
|
|
|
|
</section>
|
|
<section xml:id="configuration-zeromq">
|
|
<title>Configuration Options for ZeroMQ</title>
|
|
<para>This section discusses the configuration options that are relevant
|
|
if <application>ZeroMQ</application> is used as the messaging system for
|
|
OpenStack Oslo RPC. <application>ZeroMQ</application> is not the default
|
|
messaging system, so it must be enabled by setting the
|
|
<literal>rpc_backend</literal> option in
|
|
<filename>nova.conf</filename>.</para>
|
|
|
|
|
|
<xi:include href="tables/nova-zeromq.xml"/>
|
|
</section>
|
|
|
|
<section xml:id="common-messaging-configuration">
|
|
<title>Common Configuration for Messaging</title>
|
|
|
|
<para>This section lists options that are common between both the
|
|
<application>RabbitMQ</application> and <application>Qpid</application>
|
|
messaging drivers.</para>
|
|
|
|
<xi:include href="tables/nova-rpc.xml"/>
|
|
</section>
|
|
</section>
|
|
|