1RBDTOOL(8) System Manager's Manual RBDTOOL(8)
2
3
4
6 rbdtool - manage rados block device (RBD) images
7
9 rbdtool [ -m monaddr ] [ -p | --pool pool ] [ --create imgname [ -s
10 sizeinmb ] ] [ --delete imgname ] [ --list ]
11
12
14 rbdtool is a utility for manipulating rados block device (RBD) images,
15 used by the Linux rbd driver and the rbd storage driver for Qemu/KVM.
16 RBD images are simple block devices that are striped over objects and
17 stored in a RADOS object store. The size of the objects the image is
18 striped over must be a power of two.
19
21 -p pool, --pool pool
22 Interact with the given pool. Required by most commands.
23
24 --list will list all rbd images listed in the rbd_directory object.
25
26 --create imgname
27 will create a new rbd image. You must also specify the size via
28 --size.
29
30 --size size_in_mb
31 specifies the size (in megabytes) of the new rbd image.
32
33 --order bits
34 specifies the object size expressed as a number of bits, such
35 that the object size is 1 << order. The default is 22 (4 MB).
36
37 -c ceph.conf, --conf=ceph.conf
38 Use ceph.conf configuration file instead of the default
39 /etc/ceph/ceph.conf to determine monitor addresses during
40 startup.
41
42 -m monaddress[:port]
43 Connect to specified monitor (instead of looking through
44 ceph.conf).
45
47 To create a new rbd image that is 100 GB:
48
49 rbdtool -p mypool --create myimage --size 100000
50
51 To use a non-default object size (8 MB):
52
53 rbdtool -p mypool --create myimage --size 100000 --order 23
54
55 To delete an rbd image (be careful!):
56
57 rbdtool -p mypool --delete myimage
58
60 rbdtool is part of the Ceph distributed file system. Please refer to
61 the Ceph wiki at http://ceph.newdream.net/wiki for more information.
62
64 ceph(8),rados(8) src/
65
66
67
68 RBDTOOL(8)