4bf765758c
This patch works several files that were not in common use back into the documents they should live with. The intended end result of this activity is to make common as lean as possible so it can be more easily translated. Also: Don't include configdrive table in user-guide since it's not relevant for audience Change-Id: Iacd5c68c639e60e8c711cb18351543e477444299
93 lines
4.8 KiB
XML
93 lines
4.8 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>Configure the Oslo RPC messaging system</title>
|
|
<para>OpenStack projects use AMQP, an open standard for messaging
|
|
middleware. OpenStack services that run on 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>Configure RabbitMQ</title>
|
|
<para>OpenStack Oslo RPC uses <application>RabbitMQ</application>
|
|
by default. Use these options to configure the
|
|
<application>RabbitMQ</application> message system. 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, you must
|
|
set it to
|
|
<literal>nova.openstack.common.rpc.impl_kombu</literal>.</para>
|
|
<programlisting language="ini">rpc_backend=nova.openstack.common.rpc.impl_kombu</programlisting>
|
|
<para>You can use these additional options to configure the
|
|
<application>RabbitMQ</application> messaging system. You can
|
|
configure messaging communication for different installation
|
|
scenarios, tune retries for RabbitMQ, and define the size of the
|
|
RPC thread pool. To monitor notifications through RabbitMQ, you
|
|
must set the <option>notification_driver</option> option to
|
|
<literal>nova.notifier.rabbit_notifier</literal> in the
|
|
<filename>nova.conf</filename> file. The default for sending
|
|
usage data is sixty seconds plus a random number of seconds from
|
|
zero to sixty.</para>
|
|
<xi:include href="../../common/tables/nova-rabbitmq.xml"/>
|
|
<xi:include href="../../common/tables/nova-kombu.xml"/>
|
|
</section>
|
|
<section xml:id="configuration-qpid">
|
|
<title>Configure Qpid</title>
|
|
<para>Use these options to configure the
|
|
<application>Qpid</application> messaging system for OpenStack
|
|
Oslo RPC. <application>Qpid</application> is not the default
|
|
messaging system, so you must enable it by setting the
|
|
<option>rpc_backend</option> option in the
|
|
<filename>nova.conf</filename> file.</para>
|
|
<programlisting language="ini">rpc_backend=nova.openstack.common.rpc.impl_qpid</programlisting>
|
|
<para>This critical option points the compute nodes to the
|
|
<application>Qpid</application> broker (server). Set
|
|
<option>qpid_hostname</option> to the host name where the
|
|
broker runs in the <filename>nova.conf</filename> file.</para>
|
|
<note>
|
|
<para>The <option>--qpid_hostname</option> option accepts a host
|
|
name or IP address value.</para>
|
|
</note>
|
|
<programlisting language="ini">qpid_hostname=hostname.example.com</programlisting>
|
|
<para>If the <application>Qpid</application> broker listens on a
|
|
port other than the AMQP default of <literal>5672</literal>, you
|
|
must set the <option>qpid_port</option> option to that
|
|
value:</para>
|
|
<programlisting language="ini">qpid_port=12345</programlisting>
|
|
<para>If you configure the <application>Qpid</application> broker
|
|
to require authentication, you must add a user name 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. To enable SSL, set
|
|
the <option>qpid_protocol</option> option:</para>
|
|
<programlisting language="ini">qpid_protocol=ssl</programlisting>
|
|
<para>This table lists additional options that you use to
|
|
configure the Qpid messaging driver for OpenStack Oslo RPC.
|
|
These options are used infrequently.</para>
|
|
<xi:include href="../../common/tables/nova-qpid.xml"/>
|
|
</section>
|
|
<section xml:id="configuration-zeromq">
|
|
<title>Configure ZeroMQ</title>
|
|
<para>Use these options to configure the
|
|
<application>ZeroMQ</application> messaging system for
|
|
OpenStack Oslo RPC. <application>ZeroMQ</application> is not the
|
|
default messaging system, so you must enable it by setting the
|
|
<option>rpc_backend</option> option in the
|
|
<filename>nova.conf</filename> file.</para>
|
|
<xi:include href="../../common/tables/nova-zeromq.xml"/>
|
|
</section>
|
|
<section xml:id="common-messaging-configuration">
|
|
<title>Configure messaging</title>
|
|
<para>Use these options to configure the
|
|
<application>RabbitMQ</application> and
|
|
<application>Qpid</application> messaging drivers.</para>
|
|
<xi:include href="../../common/tables/nova-rpc.xml"/>
|
|
</section>
|
|
</section>
|