openstack-manuals/doc/install-guide/source/environment-messaging.rst
Matthew Kassawara 5ee72cfa36 [install] Fix various minor problems
Fix the following minor problems to reduce work after
stable/liberty branching:

1) RDO: Revert Python MySQL library from PyMySQL to MySQL-python
   due to lack of support for the former.
2) RDO: Explicitly install 'ebtables' and 'ipset' packages due
   to dependency problems.
3) General: Change numbered list to bulleted list for lists with
   only one item.
4) General: Restructure horizon content to match other services.
   More duplication of content, but sometimes RST conditionals
   are terrible and distro packages should use the same
   configuration files.
5) General: Restructure NoSQL content to match SQL content.
6) General: Improve clarity of NTP content.

Change-Id: I2620250aa27c7d41b525aa2646ad25e0692140c4
Closes-Bug: #1514760
Closes-Bug: #1514683
Implements: bp installguide-liberty
2015-11-13 07:49:53 -07:00

2.9 KiB

Message queue

OpenStack uses a 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, Qpid, and ZeroMQ. 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.

Install and configure components

  1. Install the package:

    ubuntu or debian

    # apt-get install rabbitmq-server

    rdo

    # yum install rabbitmq-server

    obs

    # zypper install rabbitmq-server

rdo or obs

  1. Start the message queue service and configure it to start when the system boots:

    # systemctl enable rabbitmq-server.service
    # systemctl start rabbitmq-server.service

    obs

    In case the message queue service does not start and returns a nodedown error, perform the following actions:

    • Copy the /usr/lib/systemd/system/epmd.socket file to the /etc/systemd/system directory.

    • Edit the /etc/systemd/system/epmd.socket file to contain the following:

      [Socket]
      ...
      ListenStream=MANAGEMENT_INTERFACE_IP_ADDRESS:4369

      Replace MANAGEMENT_INTERFACE_IP_ADDRESS with the IP address of the management network interface on your controller node.

    • Start the message queue service again.

  2. Add the openstack user:

    # rabbitmqctl add_user openstack RABBIT_PASS
      Creating user "openstack" ...

    Replace RABBIT_PASS with a suitable password.

  3. Permit configuration, write, and read access for the openstack user:

    # rabbitmqctl set_permissions openstack ".*" ".*" ".*"
      Setting permissions for user "openstack" in vhost "/" ...

ubuntu or debian

  1. Add the openstack user:

    # rabbitmqctl add_user openstack RABBIT_PASS
      Creating user "openstack" ...

    Replace RABBIT_PASS with a suitable password.

  2. Permit configuration, write, and read access for the openstack user:

    # rabbitmqctl set_permissions openstack ".*" ".*" ".*"
      Setting permissions for user "openstack" in vhost "/" ...