From: Alfredo Deza <alfredo.deza@inktank.com>
Date: Tue, 12 Nov 2013 20:27:12 +0000 (-0500)
Subject: document the new SSH copy-key functionality
X-Git-Tag: v1.3.2~2
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=7534a50a63ba16dbbdb5eb4d198b5833fefe7d48;p=ceph-deploy.git

document the new SSH copy-key functionality

Signed-off-by: Alfredo Deza <alfredo.deza@inktank.com>
---

diff --git a/docs/source/index.rst b/docs/source/index.rst
index 201a0fe..f288695 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -122,6 +122,27 @@ This would be the same expectation for any action that warrants a connection to
 a remote host.
 
 
+SSH Keys
+--------
+Ideally, all nodes will be pre-configured to have their passwordless access
+from the machine executing ``ceph-deploy`` but you can also take advantage of
+automatic detection of this when calling the ``new`` subcommand.
+
+Once called, it will try to establish an SSH connection to the hosts passed
+into the ``new`` subcommand, and determine if it can (or cannot) connect
+without a password prompt.
+
+If it can't proceed, it will try to copy *existing* keys to the remote host, if
+those do not exist, then passwordless ``rsa`` keys will be generated for the
+current user and those will get used.
+
+This feature can be overridden in the ``new`` subcommand like::
+
+    ceph-deploy new --no-ssh-copykey
+
+.. versionadded:: 1.3.2
+
+
 Managing an existing cluster
 ============================