ceph/doc/start/quick-rbd.rst
John Wilkins c038c3f653 doc: Added admonishments to use separate host for clients.
fixes: 3264

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2012-10-08 10:48:27 -07:00

32 lines
867 B
ReStructuredText

=================
RBD Quick Start
=================
To use RADOS block devices, you must have a running Ceph cluster. You may
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 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. ::
sudo modprobe rbd
#. 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. ::
sudo mkfs.ext4 -m0 /dev/rbd/rbd/foo
#. Mount the file system. ::
sudo mkdir /mnt/myrbd
sudo mount /dev/rbd/rbd/foo /mnt/myrbd