1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
=========================================
Install Virtualization for Block Device
=========================================
If you intend to use Ceph Block Devices and the Ceph Storage Cluster as a
backend for Virtual Machines (VMs) or :term:`Cloud Platforms` the QEMU/KVM and
``libvirt`` packages are important for enabling VMs and cloud platforms.
Examples of VMs include: QEMU/KVM, XEN, VMWare, LXC, VirtualBox, etc. Examples
of Cloud Platforms include OpenStack, CloudStack, OpenNebula, etc.
.. ditaa::
+---------------------------------------------------+
| libvirt |
+------------------------+--------------------------+
|
| configures
v
+---------------------------------------------------+
| QEMU |
+---------------------------------------------------+
| librbd |
+---------------------------------------------------+
| librados |
+------------------------+-+------------------------+
| OSDs | | Monitors |
+------------------------+ +------------------------+
Install QEMU
============
QEMU KVM can interact with Ceph Block Devices via ``librbd``, which is an
important feature for using Ceph with cloud platforms. Once you install QEMU,
see `QEMU and Block Devices`_ for usage.
Debian Packages
---------------
QEMU packages are incorporated into Ubuntu 12.04 Precise Pangolin and later
versions. To install QEMU, execute the following::
sudo apt-get install qemu
RPM Packages
------------
To install QEMU, execute the following:
#. Update your repositories. ::
sudo yum update
#. Install QEMU for Ceph. ::
sudo yum install qemu-kvm qemu-kvm-tools qemu-img
#. Install additional QEMU packages (optional)::
sudo yum install qemu-guest-agent qemu-guest-agent-win32
Building QEMU
-------------
To build QEMU from source, use the following procedure::
cd {your-development-directory}
git clone git://git.qemu.org/qemu.git
cd qemu
./configure --enable-rbd
make; make install
Install libvirt
===============
To use ``libvirt`` with Ceph, you must have a running Ceph Storage Cluster, and
you must have installed and configured QEMU. See `Using libvirt with Ceph Block
Device`_ for usage.
Debian Packages
---------------
``libvirt`` packages are incorporated into Ubuntu 12.04 Precise Pangolin and
later versions of Ubuntu. To install ``libvirt`` on these distributions,
execute the following::
sudo apt-get update && sudo apt-get install libvirt-bin
RPM Packages
------------
To use ``libvirt`` with a Ceph Storage Cluster, you must have a running Ceph
Storage Cluster and you must also install a version of QEMU with ``rbd`` format
support. See `Install QEMU`_ for details.
``libvirt`` packages are incorporated into the recent CentOS/RHEL distributions.
To install ``libvirt``, execute the following::
sudo yum install libvirt
Building ``libvirt``
--------------------
To build ``libvirt`` from source, clone the ``libvirt`` repository and use
`AutoGen`_ to generate the build. Then, execute ``make`` and ``make install`` to
complete the installation. For example::
git clone git://libvirt.org/libvirt.git
cd libvirt
./autogen.sh
make
sudo make install
See `libvirt Installation`_ for details.
.. _libvirt Installation: http://www.libvirt.org/compiling.html
.. _AutoGen: http://www.gnu.org/software/autogen/
.. _QEMU and Block Devices: ../../rbd/qemu-rbd
.. _Using libvirt with Ceph Block Device: ../../rbd/libvirt
|
