1 =========================================
2 Install Virtualization for Block Device
3 =========================================
5 If you intend to use Ceph Block Devices and the Ceph Storage Cluster as a
6 backend for Virtual Machines (VMs) or :term:`Cloud Platforms` the QEMU/KVM and
7 ``libvirt`` packages are important for enabling VMs and cloud platforms.
8 Examples of VMs include: QEMU/KVM, XEN, VMWare, LXC, VirtualBox, etc. Examples
9 of Cloud Platforms include OpenStack, CloudStack, OpenNebula, etc.
12 .. ditaa:: +---------------------------------------------------+
14 +------------------------+--------------------------+
18 +---------------------------------------------------+
20 +---------------------------------------------------+
22 +------------------------+-+------------------------+
24 +------------------------+ +------------------------+
30 QEMU KVM can interact with Ceph Block Devices via ``librbd``, which is an
31 important feature for using Ceph with cloud platforms. Once you install QEMU,
32 see `QEMU and Block Devices`_ for usage.
38 QEMU packages are incorporated into Ubuntu 12.04 Precise Pangolin and later
39 versions. To install QEMU, execute the following::
41 sudo apt-get install qemu
47 To install QEMU, execute the following:
50 #. Update your repositories. ::
54 #. Install QEMU for Ceph. ::
56 sudo yum install qemu-kvm qemu-kvm-tools qemu-img
58 #. Install additional QEMU packages (optional)::
60 sudo yum install qemu-guest-agent qemu-guest-agent-win32
66 To build QEMU from source, use the following procedure::
68 cd {your-development-directory}
69 git clone git://git.qemu.org/qemu.git
71 ./configure --enable-rbd
79 To use ``libvirt`` with Ceph, you must have a running Ceph Storage Cluster, and
80 you must have installed and configured QEMU. See `Using libvirt with Ceph Block
87 ``libvirt`` packages are incorporated into Ubuntu 12.04 Precise Pangolin and
88 later versions of Ubuntu. To install ``libvirt`` on these distributions,
89 execute the following::
91 sudo apt-get update && sudo apt-get install libvirt-bin
97 To use ``libvirt`` with a Ceph Storage Cluster, you must have a running Ceph
98 Storage Cluster and you must also install a version of QEMU with ``rbd`` format
99 support. See `Install QEMU`_ for details.
102 ``libvirt`` packages are incorporated into the recent CentOS/RHEL distributions.
103 To install ``libvirt``, execute the following::
105 sudo yum install libvirt
111 To build ``libvirt`` from source, clone the ``libvirt`` repository and use
112 `AutoGen`_ to generate the build. Then, execute ``make`` and ``make install`` to
113 complete the installation. For example::
115 git clone git://libvirt.org/libvirt.git
121 See `libvirt Installation`_ for details.
125 .. _libvirt Installation: http://www.libvirt.org/compiling.html
126 .. _AutoGen: http://www.gnu.org/software/autogen/
127 .. _QEMU and Block Devices: ../../rbd/qemu-rbd
128 .. _Using libvirt with Ceph Block Device: ../../rbd/libvirt