summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJohn Wilkins <john.wilkins@inktank.com>2013-05-23 11:45:14 -0700
committerJohn Wilkins <john.wilkins@inktank.com>2013-05-23 11:45:14 -0700
commit75600c6aafa0b8958803c4ef472c6d0f6fc7e431 (patch)
treea2900674d34334dd2773aa69ec80973a4322542b /doc
parent8b2fbf21b8d51e2eb6e017ecef7384b5afb4ce55 (diff)
downloadceph-75600c6aafa0b8958803c4ef472c6d0f6fc7e431.tar.gz
doc: Updates for ceph-deploy and cuttlefish.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/start/quick-rbd.rst24
1 files changed, 16 insertions, 8 deletions
diff --git a/doc/start/quick-rbd.rst b/doc/start/quick-rbd.rst
index 7300547e5ea..e15d3366e31 100644
--- a/doc/start/quick-rbd.rst
+++ b/doc/start/quick-rbd.rst
@@ -2,12 +2,17 @@
Block Device Quick Start
==========================
-To use this guide, you must have executed the procedures in the `5-minute
-Quick Start`_ guide first. Execute this quick start on the client machine.
+To use this guide, you must have executed the procedures in the `Object Store
+Quick Start`_ guide first. Ensure your :term:`Ceph Storage Cluster` is in an
+``active + clean`` state before working with the :term:`Ceph Block Device`.
+Execute this quick start on the admin node.
+
+.. note:: The Ceph Block Device is also known as :term:`RBD` or :term:`RADOS`
+ Block Device.
#. Create a block device image. ::
- rbd create foo --size 4096
+ rbd create foo --size 4096 [-m {mon-IP}] [-k /path/to/ceph.client.admin.keyring]
#. Load the ``rbd`` client module. ::
@@ -15,22 +20,25 @@ Quick Start`_ guide first. Execute this quick start on the client machine.
#. Map the image to a block device. ::
- sudo rbd map foo --pool rbd --name client.admin
+ sudo rbd map foo --pool rbd --name client.admin [-m {mon-IP}] [-k /path/to/ceph.client.admin.keyring]
#. Use the block device. In the following example, create a file system. ::
sudo mkfs.ext4 -m0 /dev/rbd/rbd/foo
+ This may take a few moments.
+
#. Mount the file system. ::
- sudo mkdir /mnt/myrbd
- sudo mount /dev/rbd/rbd/foo /mnt/myrbd
+ sudo mkdir /mnt/ceph-block-device
+ sudo mount /dev/rbd/rbd/foo /mnt/ceph-block-device
+ cd /mnt/ceph-block-device
.. note:: Mount the block device on the client machine,
not the server machine. See `FAQ`_ for details.
See `block devices`_ for additional details.
-.. _5-minute Quick Start: ../quick-start
+.. _Object Store Quick Start: ../quick-ceph-deploy
.. _block devices: ../../rbd/rbd
-.. _FAQ: ../../faq#try-ceph
+.. _FAQ: http://wiki.ceph.com/03FAQs/01General_FAQ#How_Can_I_Give_Ceph_a_Try.3F