doc: Added host resolution commentary.

Signed-off-by: John Wilkins <john.wilkins@inktank.com>

diff --git a/doc/start/quick-start-preflight.rst b/doc/start/quick-start-preflight.rst
index 1e822edcafa5fbf158764a1566aa5daf831c7578..09c8987a2d6a51785e300abcf6a50cd3e4c31d9d 100644 (file)
--- a/doc/start/quick-start-preflight.rst
+++ b/doc/start/quick-start-preflight.rst
@@ -160,8 +160,11 @@ perform the following steps:
           User ceph
 
 
-#. Ensure connectivity using ``ping`` with hostnames (i.e., not IP addresses). 
-   Address hostname resolution issues and firewall issues as necessary.
+#. Ensure connectivity using ``ping`` with short hostnames (``hostname -s``). 
+   Address hostname resolution issues and firewall issues as necessary. 
+   **Note:** Hostnames should resolve to a network IP address, not to the 
+   loopback IP address (e.g., hostnames should resolve to an IP address other 
+   than ``127.0.0.1``).
 
 .. note:: If you use your admin node as one of the Ceph Nodes, you must perform
    these steps on the admin node too.