summaryrefslogtreecommitdiff
path: root/doc/start/quick-rbd.rst
blob: 7300547e5ea2a7fb2fa93fb8c3d07e75ed951a46 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
==========================
 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.

#. Create a 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

.. 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
.. _block devices: ../../rbd/rbd
.. _FAQ: ../../faq#try-ceph