From e9f23105aa025c2d85c752f3a6dbb3fd6bf00637 Mon Sep 17 00:00:00 2001
From: Chen <dstbtgagt@foxmail.com>
Date: Fri, 14 Apr 2017 11:31:08 +0900
Subject: [PATCH] Add info about RabbitMQ requirement on quickstart

Add info about hostname resolution requirement for RabbitMQ on
quickstart page, corresponding to the docimpact resulted from
a previous merged commit https://review.openstack.org/#/c/294713/.

Closes-Bug: #1559809

Change-Id: I671e7d897412859f606ea88e78ac63605bd8824b
---
 doc/quickstart.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/doc/quickstart.rst b/doc/quickstart.rst
index bafd3cce37..ae2ccecaf6 100644
--- a/doc/quickstart.rst
+++ b/doc/quickstart.rst
@@ -532,6 +532,12 @@ services can be run on specific hosts. This documentation describes deploying
 an *all-in-one* setup. To setup *multinode* see the
 `Multinode Deployment of Kolla <https://docs.openstack.org/project-deploy-guide/kolla-ansible/ocata/multinode.html>`_.
 
+.. note::
+
+    For *multinode* deployment of kolla, check if all the hostnames are
+    resolvable. RabbitMQ can't work with IP addresses, so we need to make
+    sure that all RabbitMQ cluster hosts can resolve each other's hostnames.
+
 Each method is represented as an Ansible inventory file. More information on
 the Ansible inventory file can be found in the Ansible `inventory introduction
 <https://docs.ansible.com/intro_inventory.html>`_.