Langue: en

Version: 385279 (fedora - 01/12/10)

Section: 8 (Commandes administrateur)


rbdtool - manage rados block device (RBD) images


rbdtool [ -m monaddr ] [ -p | --pool pool ] [ --create imgname [ -s sizeinmb ] ] [ --delete imgname ] [ --list ]


rbdtool is a utility for manipulating rados block device (RBD) images, used by the Linux rbd driver and the rbd storage driver for Qemu/KVM. RBD images are simple block devices that are striped over objects and stored in a RADOS object store. The size of the objects the image is striped over must be a power of two.


-p pool, --pool pool
Interact with the given pool. Required by most commands.
will list all rbd images listed in the rbd_directory object.
--create imgname
will create a new rbd image. You must also specify the size via --size.
--size size_in_mb
specifies the size (in megabytes) of the new rbd image.
--order bits
specifies the object size expressed as a number of bits, such that the object size is 1 << order. The default is 22 (4 MB).
-c ceph.conf, --conf=ceph.conf
Use ceph.conf configuration file instead of the default /etc/ceph/ceph.conf to determine monitor addresses during startup.
-m monaddress[:port]
Connect to specified monitor (instead of looking through ceph.conf).


To create a new rbd image that is 100 GB:
rbdtool -p mypool --create myimage --size 100000

To use a non-default object size (8 MB):

rbdtool -p mypool --create myimage --size 100000 --order 23

To delete an rbd image (be careful!):

rbdtool -p mypool --delete myimage


rbdtool is part of the Ceph distributed file system. Please refer to the Ceph wiki at http://ceph.newdream.net/wiki for more information.


ceph(8),rados(8) src/