rbdtool

Langue: en

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

Section: 8 (Commandes administrateur)

NAME

rbdtool - manage rados block device (RBD) images

SYNOPSIS

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

DESCRIPTION

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.

OPTIONS

-p pool, --pool pool
Interact with the given pool. Required by most commands.
--list
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).

EXAMPLES

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

AVAILABILITY

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

SEE ALSO

ceph(8),rados(8) src/