e39304d4ae
The PDF build does not include content multiple times if the same file is included in a toctree more than once. That means we need to restructure the guide to handle the common parts differently. This approach merges some of the previously split sections back together using inline prose to indicate where minor variations apply for different operating systems but retaining separate files for cases where the differences are significant. Change-Id: I5d9ff549b05ca4ce54486719d70858589b8fcfa3 Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454 Signed-off-by: Doug Hellmann <doug@doughellmann.com>
57 lines
1.3 KiB
ReStructuredText
57 lines
1.3 KiB
ReStructuredText
Debian Message queue
|
|
~~~~~~~~~~~~~~~~~~~~
|
|
|
|
OpenStack uses a :term:`message queue` to coordinate operations and
|
|
status information among services. The message queue service typically
|
|
runs on the controller node. OpenStack supports several message queue
|
|
services including `RabbitMQ <https://www.rabbitmq.com>`__,
|
|
`Qpid <https://qpid.apache.org>`__, and `ZeroMQ <http://zeromq.org>`__.
|
|
However, most distributions that package OpenStack support a particular
|
|
message queue service. This guide implements the RabbitMQ message queue
|
|
service because most distributions support it. If you prefer to
|
|
implement a different message queue service, consult the documentation
|
|
associated with it.
|
|
|
|
The message queue runs on the controller node.
|
|
|
|
Install and configure components
|
|
--------------------------------
|
|
|
|
1. Install the package:
|
|
|
|
|
|
.. code-block:: console
|
|
|
|
# apt install rabbitmq-server
|
|
|
|
.. end
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2. Add the ``openstack`` user:
|
|
|
|
.. code-block:: console
|
|
|
|
# rabbitmqctl add_user openstack RABBIT_PASS
|
|
|
|
Creating user "openstack" ...
|
|
|
|
.. end
|
|
|
|
Replace ``RABBIT_PASS`` with a suitable password.
|
|
|
|
3. Permit configuration, write, and read access for the
|
|
``openstack`` user:
|
|
|
|
.. code-block:: console
|
|
|
|
# rabbitmqctl set_permissions openstack ".*" ".*" ".*"
|
|
|
|
Setting permissions for user "openstack" in vhost "/" ...
|
|
|
|
.. end
|
|
|