1RBDTOOL(8)                  System Manager's Manual                 RBDTOOL(8)
2
3
4

NAME

6       rbdtool - manage rados block device (RBD) images
7

SYNOPSIS

9       rbdtool  [  -m  monaddr  ] [ -p | --pool pool ] [ --create imgname [ -s
10       sizeinmb ] ] [ --delete imgname ] [ --list ]
11
12

DESCRIPTION

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

OPTIONS

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

EXAMPLES

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

AVAILABILITY

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

SEE ALSO

64       ceph(8),rados(8) src/
65
66
67
68                                                                    RBDTOOL(8)
Impressum