mirror of
https://github.com/ceph/ceph
synced 2024-12-21 10:54:42 +00:00
0cb56e0f13
RTD does not support installing system packages, the only ways to install dependencies are setuptools and pip. while ditaa is a tool written in Java. so we need to find a native python tool allowing us to render ditaa images. plantweb is able to the web service for rendering the ditaa diagram. so let's use it as a fallback if "ditaa" is not around. also start a new line after the directive, otherwise planweb server will return 500 at seeing the diagram. Signed-off-by: Kefu Chai <kchai@redhat.com>
133 lines
3.8 KiB
ReStructuredText
133 lines
3.8 KiB
ReStructuredText
=========================================
|
|
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
|