Block Device Quick Start
Ensure your Ceph Storage Cluster is in an active + clean
state
before working with the Ceph Block Device.
You may use a virtual machine for your ceph-client
node, but do not
execute the following procedures on the same physical node as your Ceph
Storage Cluster nodes (unless you use a VM). See FAQ for details.
Create a Block Device Pool
On the admin node, use the
ceph
tool to create a pool (we recommend the name ‘rbd’).On the admin node, use the
rbd
tool to initialize the pool for use by RBD:rbd pool init <pool-name>
Configure a Block Device
On the
ceph-client
node, create a block device image.rbd create foo --size 4096 --image-feature layering [-m {mon-IP}] [-k /path/to/ceph.client.admin.keyring] [-p {pool-name}]
On the
ceph-client
node, map the image to a block device.sudo rbd map foo --name client.admin [-m {mon-IP}] [-k /path/to/ceph.client.admin.keyring] [-p {pool-name}]
Use the block device by creating a file system on the
ceph-client
node.sudo mkfs.ext4 -m0 /dev/rbd/{pool-name}/foo This may take a few moments.
Mount the file system on the
ceph-client
node.sudo mkdir /mnt/ceph-block-device sudo mount /dev/rbd/{pool-name}/foo /mnt/ceph-block-device cd /mnt/ceph-block-device
Optionally configure the block device to be automatically mapped and mounted at boot (and unmounted/unmapped at shutdown) - see the rbdmap manpage.
See block devices for additional details.