From dc6cadc34a1e669099424d39c05f3ae79def3a23 Mon Sep 17 00:00:00 2001 From: John Wilkins Date: Tue, 11 Jun 2013 14:46:35 -0700 Subject: [PATCH] doc: Added a hostname resolution section for local host execution. Signed-off-by: John Wilkins --- doc/start/quick-start-preflight.rst | 29 ++++++++++++++++++++++++++--- 1 file changed, 26 insertions(+), 3 deletions(-) diff --git a/doc/start/quick-start-preflight.rst b/doc/start/quick-start-preflight.rst index 74c1f0d2765ce..468e21e4b13a4 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 -- 2.39.5