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
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>127.0.0.1</replaceable></userinput></screen>
|
|
<para>
|
|
Replace <replaceable>127.0.0.1</replaceable> with the IP address or
|
|
host name of your message broker.
|
|
</para>
|
|
</step>
|
|
</procedure>
|
|
</section>
|