402c7b4526
Consistently use the controller host name for Qpid. Files from the old basic install guide which are slated for removal were left untouched. Change-Id: I7e0c6a8239a8179db303cfa18821e7f7f799d5c5
75 lines
3.4 KiB
XML
75 lines
3.4 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<section xml:id="installing-rabbitmq"
|
|
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">
|
|
<title>Installing a Messaging Server</title>
|
|
<para>Install the messaging queue server. Typically this is
|
|
<phrase os="ubuntu;opensuse">RabbitMQ</phrase><phrase os="centos;rhel;fedora">Qpid</phrase>
|
|
but <phrase os="ubuntu;opensuse">Qpid</phrase><phrase os="centos;rhel;fedora">RabbitMQ</phrase>
|
|
and ZeroMQ (0MQ) are also available.</para>
|
|
<screen os="ubuntu"><prompt>$</prompt> <userinput>sudo apt-get install rabbitmq-server</userinput></screen>
|
|
<screen os="opensuse"><prompt>$</prompt> <userinput>sudo zypper install rabbitmq-server</userinput></screen>
|
|
<procedure os="centos;rhel;fedora"><title>To install a messaging queue server:</title>
|
|
<step>
|
|
<para>
|
|
All steps in this procedure require the privileges of the
|
|
<systemitem>root</systemitem> user. If you are not logged
|
|
in as the <systemitem>root</systemitem> user then either escalate
|
|
your privileges using the <command>su</command> command or
|
|
prefix each command with <command>sudo</command>, depending on the
|
|
configuration of your system.
|
|
</para>
|
|
</step>
|
|
<step>
|
|
<para>
|
|
Install the Qpid message broker and supporting utilities that will
|
|
be needed in subsequent procedures.
|
|
</para>
|
|
<screen><prompt>#</prompt> <userinput>yum install qpid-cpp-server memcached openstack-utils</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>
|
|
Disable Qpid authentication by setting the value of the
|
|
<literal>auth</literal> configuration key to <literal>no</literal>
|
|
in the <filename>/etc/qpidd.conf</filename> file.
|
|
</para>
|
|
<screen><prompt>#</prompt> <userinput>echo "auth=no" >> /etc/qpidd.conf</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>
|
|
Start the Qpid message broker.
|
|
</para>
|
|
<screen><prompt>#</prompt> service qpidd start</screen>
|
|
</step>
|
|
<step>
|
|
<para>
|
|
Configure the Qpid message broker to start automatically in future.
|
|
</para>
|
|
<screen><prompt>#</prompt> <userinput>chkconfig qpidd on</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>
|
|
Configure Nova to use the Qpid message broker for remote procedure
|
|
calls by setting the value of the <literal>rpc_backend</literal>
|
|
configuration key in <filename>/etc/nova/nova.conf</filename>.
|
|
</para>
|
|
<screen><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf \
|
|
DEFAULT rpc_backend nova.rpc.impl_qpid</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>
|
|
Configure Nova to use the Qpid message broker by setting the value of
|
|
the <literal>qpid_hostname</literal> configuration key in
|
|
<filename>/etc/nova/nova.conf</filename>.
|
|
</para>
|
|
<screen><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf \
|
|
DEFAULT qpid_hostname <replaceable>controller</replaceable></userinput></screen>
|
|
<para>
|
|
Replace <replaceable>controller</replaceable> with the IP address or
|
|
host name of your message broker.
|
|
</para>
|
|
</step>
|
|
</procedure>
|
|
</section>
|