doc: Clean up pre-flight documentation

Mention recent Ceph releases.
Move important message about sudo and ceph-deploy closer to the use of
ceph-deploy.
Mention files created by ceph-deploy comment
Separate apt-get from yum command

Signed-off-by: Kevin Dalley <kevin@kelphead.org>

diff --git a/doc/start/quick-start-preflight.rst b/doc/start/quick-start-preflight.rst
index 18cad204ad113435ba9fdb192baef7bcc553a72a..ac89c1ed1e8ea2ff1507e96bfc9ba11fe4f83ca8 100644 (file)
--- a/doc/start/quick-start-preflight.rst
+++ b/doc/start/quick-start-preflight.rst
@@ -4,7 +4,7 @@
 
 .. versionadded:: 0.60
 
-Thank you for trying Ceph! We recommend setting up a ``ceph-deploy`` admin node
+Thank you for trying Ceph! We recommend setting up a ``ceph-deploy`` admin :term:`node`
 and a 3-node :term:`Ceph Storage Cluster` to explore the basics of Ceph. This
 **Preflight Checklist** will help you prepare a ``ceph-deploy`` admin node and
 three Ceph Nodes (or virtual machines) that will host your Ceph Storage Cluster.
@@ -23,11 +23,6 @@ Ceph Deploy Setup
 Add Ceph repositories to the ``ceph-deploy`` admin node. Then, install
 ``ceph-deploy``. 
 
-.. important:: Do not call ``ceph-deploy`` with ``sudo`` or run it as ``root`` 
-   if you are logged in as a different user, because it will not issue ``sudo`` 
-   commands needed on the remote host.
-
-
 Advanced Package Tool (APT)
 ---------------------------
 
@@ -38,7 +33,8 @@ For Debian and Ubuntu distributions, perform the following steps:
        wget -q -O- 'https://ceph.com/git/?p=ceph.git;a=blob_plain;f=keys/release.asc' | sudo apt-key add -
 
 #. Add the Ceph packages to your repository. Replace ``{ceph-stable-release}``
-   with a stable Ceph release (e.g., ``cuttlefish``, ``dumpling``, etc.). 
+   with a stable Ceph release (e.g., ``cuttlefish``, ``dumpling``,
+   ``emperor``, ``firefly``, etc.). 
    For example::
        
        echo deb http://ceph.com/debian-{ceph-stable-release}/ $(lsb_release -sc) main | sudo tee /etc/apt/sources.list.d/ceph.list
@@ -89,14 +85,30 @@ following steps:
 
 Ceph Node Setup
 ===============
+.. important:: Do not call ``ceph-deploy`` with ``sudo`` or run it as ``root`` 
+   if you are logged in as a different user, because it will not issue ``sudo`` 
+   commands needed on the remote host.
 
 If you are using ``ceph-deploy`` version 1.1.3 and beyond, ``ceph-deploy``
 will attempt to create the SSH key and copy it to the initial monitor nodes 
-automatically when you create the new cluster. For example:: 
+automatically when you create the new cluster.
+
+Start from your ``ceph-deploy`` admin node. The admin node needs to
+have password-less SSH access to each Ceph Node listed below.
+
+For example:: 
 
        ceph-deploy new node1
 
-For other Ceph Nodes (and for initial monitors prior to ``ceph-deploy`` v1.1.3)
+This command will create the following files in the current direction
+of the admin node:
+
+- ``ceph.conf``
+- ``ceph.log``
+- ``ceph.mon.keyring``
+
+For other Ceph Nodes in this example
+(and for initial monitors prior to ``ceph-deploy`` v1.1.3)
 perform the following steps:
 
 #. Create a user on each Ceph Node. :: 
@@ -105,7 +117,7 @@ perform the following steps:
        sudo useradd -d /home/ceph -m ceph
        sudo passwd ceph
 
-#. Add ``root`` privileges for the user on each Ceph Node. :: 
+#. Add ``sudo`` privileges for the user on each Ceph Node. :: 
 
        echo "ceph ALL = (root) NOPASSWD:ALL" | sudo tee /etc/sudoers.d/ceph
        sudo chmod 0440 /etc/sudoers.d/ceph
@@ -114,6 +126,9 @@ perform the following steps:
 #. Install an SSH server (if necessary) on each Ceph Node:: 
 
        sudo apt-get install openssh-server
+
+   or:: 
+
        sudo yum install openssh-server