doc: Added admonishments to use separate host for clients.

fixes: 3264

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

diff --git a/doc/start/quick-cephfs.rst b/doc/start/quick-cephfs.rst
index f2df3d552cc781322cc8d1ec0e95e9fec9cb22d5..dde10c28d664704c357a1088135e06884238f2d0 100644 (file)
--- a/doc/start/quick-cephfs.rst
+++ b/doc/start/quick-cephfs.rst
@@ -9,8 +9,10 @@ execute this quick start on a separate host if you have the Ceph packages and
 the ``/etc/ceph/ceph.conf`` file installed with the appropriate IP address
 and host name settings modified in the ``/etc/ceph/ceph.conf`` file.
 
+.. important:: Mount the Ceph FS file system on a separate host from your Ceph cluster.
+
 Kernel Driver
--------------
+=============
 
 Mount Ceph FS as a kernel driver. :: 
 
@@ -18,7 +20,7 @@ Mount Ceph FS as a kernel driver. ::
        sudo mount -t ceph {ip-address-of-monitor}:6789:/ /mnt/mycephfs
        
 Filesystem in User Space (FUSE)
--------------------------------
+===============================
 
 Mount Ceph FS as with FUSE. Replace {username} with your username. ::
 

diff --git a/doc/start/quick-rbd.rst b/doc/start/quick-rbd.rst
index 9244276d8ae10b8e8f30e97ead8b8aea9b226b38..c8b06a1aba2bafb9ff9cb66678f585ba556cd7ac 100644 (file)
--- a/doc/start/quick-rbd.rst
+++ b/doc/start/quick-rbd.rst
@@ -7,23 +7,25 @@ execute this quick start on a separate host if you have the Ceph packages and
 the ``/etc/ceph/ceph.conf`` file installed with the appropriate IP address
 and host name settings modified in the ``/etc/ceph/ceph.conf`` file.
 
-Create a RADOS Block Device image. :: 
+.. important:: Mount the RBD device on a separate host from your Ceph cluster.
+
+#. Create a RADOS Block Device image. :: 
 
        rbd create foo --size 4096      
 
-Load the ``rbd`` client module. ::
+#. Load the ``rbd`` client module. ::
 
        sudo modprobe rbd
 
-Map the image to a block device. :: 
+#. Map the image to a block device. :: 
 
        sudo rbd map foo --pool rbd --name client.admin
        
-Use the block device. In the following example, create a file system. :: 
+#. Use the block device. In the following example, create a file system. :: 
 
        sudo mkfs.ext4 -m0 /dev/rbd/rbd/foo
        
-Mount the file system. ::
+#. Mount the file system. ::
 
        sudo mkdir /mnt/myrbd
        sudo mount /dev/rbd/rbd/foo /mnt/myrbd

diff --git a/doc/start/quick-start.rst b/doc/start/quick-start.rst
index 726e4ad6811abf6d331bbfb3fc8dbbe2c88446b1..32a57125d5789ac2f92c2fb7f17a0f95251099bb 100644 (file)
--- a/doc/start/quick-start.rst
+++ b/doc/start/quick-start.rst
@@ -11,13 +11,15 @@ recent Debian/Ubuntu operating system. The intent is to help you exercise
 Ceph functionality without the deployment overhead associated with a 
 production-ready storage cluster.
 
+.. important:: Once you have your cluster running, mount block devices and filesystems using a separate host.
+
 Install Debian/Ubuntu
----------------------
+=====================
 
 Install a recent release of Debian or Ubuntu (e.g., 12.04 precise). 
 
 Add Ceph Packages
------------------
+=================
 
 To get the latest Ceph packages, add a release key to APT, add a source
 location to your ``/etc/apt/sources.list``, update your system and 
@@ -28,7 +30,7 @@ install Ceph. ::
        sudo apt-get update && sudo apt-get install ceph
        
 Add a Configuration File
-------------------------
+========================
 
 Execute ``hostname -s`` on the command line to retrieve the name of your 
 host. Then, replace ``{hostname}`` in the sample configuration file
@@ -43,7 +45,8 @@ and one metadata server on your local machine.
    :language: ini
    
 Deploy the Configuration
-------------------------
+========================
+
 To deploy the configuration, create a directory for each daemon as follows::
 
        sudo mkdir /var/lib/ceph/osd/ceph-0
@@ -55,7 +58,7 @@ To deploy the configuration, create a directory for each daemon as follows::
        sudo mkcephfs -a -c /etc/ceph/ceph.conf -k ceph.keyring
 
 Start the Ceph Cluster
-----------------------
+======================
 
 Once you have deployed the configuration, start the Ceph cluster. ::