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
|
=========================================
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 |
+------------------------+-+------------------------+
| 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
|