← Back to branch summary

~ubuntu-branches/ubuntu/quantal/ceph/quantal

« back to all changes in this revision

Viewing changes to doc/rbd/qemu-rbd.rst

  • Committer: Package Import Robot
  • Author(s): James Page
  • Date: 2012-07-16 09:56:24 UTC
  • mfrom: (0.3.11)
  • mto: This revision was merged to the branch mainline in revision 17.
  • Revision ID: package-import@ubuntu.com-20120716095624-azr2w4hbhei1rxmx
Tags: upstream-0.48
Import upstream version 0.48

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/rbd/qemu-rbd.rst
 
1
==============
 
2
 QEMU and RBD
 
3
==============
 
4
 
 
5
Ceph integrates with the QEMU virtual machine. For details on QEMU, see 
 
6
`QEMU Open Source Processor Emulator`_. For QEMU documentation, see
 
7
`QEMU Manual`_. 
 
8
   
 
9
Installing QEMU on Ubuntu 12.04Precise
 
10
--------------------------------------
 
11
QEMU packages are incorporated into the Ubuntu 12.04 precise distribution. To 
 
12
install QEMU on precise, execute the following:: 
 
13
 
 
14
        sudo apt-get install qemu
 
15
 
 
16
Installing QEMU on Earlier Versions of Ubuntu
 
17
---------------------------------------------
 
18
For Ubuntu distributions 11.10 oneiric and earlier, you must install 
 
19
the 0.15 version of QEMU or later. To build QEMU from source, use the
 
20
following procedure::
 
21
 
 
22
        cd {your-development-directory}
 
23
        git clone git://git.qemu.org/qemu.git
 
24
        cd qemu
 
25
        ./configure --enable-rbd
 
26
        make; make install
 
27
 
 
28
Creating RBD Images with QEMU
 
29
-----------------------------
 
30
You can create an RBD image from QEMU. You must specify ``rbd``, 
 
31
the pool name, and the name of the image you wish to create. You must also
 
32
specify the size of the image. ::
 
33
 
 
34
        qemu-img create -f rbd rbd:{pool-name}/{image-name} {size}
 
35
 
 
36
For example::
 
37
 
 
38
        qemu-img create -f rbd rbd:data/foo 10G
 
39
 
 
40
Resizing RBD Images with QEMU
 
41
-----------------------------
 
42
You can resize an RBD image from QEMU. You must specify ``rbd``, 
 
43
the pool name, and the name of the image you wish to resize. You must also
 
44
specify the size of the image.
 
45
 
 
46
        qemu-img resize -f rbd rbd:{pool-name}/{image-name} {size}
 
47
 
 
48
For example::
 
49
 
 
50
        qemu-img resize -f rbd rbd:data/foo 10G
 
51
 
 
52
 
 
53
Retrieving RBD Image Information with QEMU
 
54
------------------------------------------
 
55
You can retrieve RBD image information from QEMU. You must 
 
56
specify ``rbd``, the pool name, and the name of the image. ::
 
57
 
 
58
        qemu-img info -f rbd rbd:{pool-name}/{image-name}
 
59
 
 
60
For example::
 
61
 
 
62
        qemu-img info -f rbd rbd:data/foo
 
63
 
 
64
   
 
65
.. _QEMU Open Source Processor Emulator: http://wiki.qemu.org/Main_Page
 
66
.. _QEMU Manual: http://wiki.qemu.org/Manual