From c038c3f653389685d4f1f89527d72c15c6e62b50 Mon Sep 17 00:00:00 2001 From: John Wilkins Date: Mon, 8 Oct 2012 10:48:27 -0700 Subject: [PATCH] doc: Added admonishments to use separate host for clients. fixes: 3264 Signed-off-by: John Wilkins --- doc/start/quick-cephfs.rst | 6 ++++-- doc/start/quick-rbd.rst | 12 +++++++----- doc/start/quick-start.rst | 13 ++++++++----- 3 files changed, 19 insertions(+), 12 deletions(-) diff --git a/doc/start/quick-cephfs.rst b/doc/start/quick-cephfs.rst index f2df3d552cc78..dde10c28d6647 100644 --- 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 9244276d8ae10..c8b06a1aba2ba 100644 --- 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 726e4ad6811ab..32a57125d5789 100644 --- 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. :: -- 2.39.5