From: John Wilkins <john.wilkins@inktank.com>
Date: Tue, 11 Jun 2013 21:46:35 +0000 (-0700)
Subject: doc: Added a hostname resolution section for local host execution.
X-Git-Tag: v0.65~105
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=dc6cadc34a1e669099424d39c05f3ae79def3a23;p=ceph.git

doc: Added a hostname resolution section for local host execution.

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 74c1f0d2765c..468e21e4b13a 100644
--- a/doc/start/quick-start-preflight.rst
+++ b/doc/start/quick-start-preflight.rst
@@ -106,7 +106,7 @@ To install ``ceph-deploy``, execute the following::
 Ensure Connectivity
 ===================
 
-Ensure that your Admin node has connectivity to the network and to your Server
+Ensure that your admin node has connectivity to the network and to your Server
 node (e.g., ensure ``iptables``, ``ufw`` or other tools that may prevent
 connections, traffic forwarding, etc. to allow what you need).
 
@@ -116,15 +116,38 @@ connections, traffic forwarding, etc. to allow what you need).
 Once you have completed this pre-flight checklist, you are ready to begin using
 ``ceph-deploy``.
 
+
+Hostname Resolution
+===================
+
+Ensure that your admin node can resolve the server node's hostname. ::
+
+	ping {server-node}
+
+If you execute ``ceph-deploy`` against the localhost, ``ceph-deploy``
+must be able to resolve its IP address. Consider adding the IP address
+to your ``/etc/hosts`` file such that it resolves to the hostname. ::
+
+	hostname
+	host -4 {hostname}
+	sudo vim /etc/hosts
+
+	{ip-address} {hostname}
+
+	ceph-deploy {command} {hostname}
+
+.. tip:: The ``ceph-deploy`` tool will not resolve to ``localhost``. Use
+   the hostname.
+
 Summary
 =======
 
 Once you have passwordless ``ssh`` connectivity, passwordless ``sudo``,
 installed ``ceph-deploy``, and you have ensured appropriate connectivity,
-proceed to the `Object Store Quick Start`_.
+proceed to the `Storage Cluster Quick Start`_.
 
 .. tip:: The ``ceph-deploy`` utility can install Ceph packages on remote 
    machines from the admin node!
 
-.. _Object Store Quick Start: ../quick-ceph-deploy
+.. _Storage Cluster Quick Start: ../quick-ceph-deploy
 .. _OS Recommendations: ../../install/os-recommendations
\ No newline at end of file