openstack/openstack-manuals
Code Issues Proposed changes

Merge "[config-ref] cleanup Compute Xen libvirt chapter"

Browse Source
This commit is contained in:
Jenkins 2016-11-07 14:45:38 +00:00 committed by Gerrit Code Review
commit dfa53d5a82
1 changed files with 25 additions and 35 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

60
doc/config-reference/source/compute/hypervisor-xen-libvirt.rst
View File

@ -15,12 +15,14 @@ Installing Xen with libvirt
~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~
At this stage we recommend using the baseline that we use for the At this stage we recommend using the baseline that we use for the
`Xen Project OpenStack CI Loop <http://wiki.xenproject.org/wiki/ `Xen Project OpenStack CI Loop
OpenStack_CI_Loop_for_Xen-Libvirt>`_, which contains the most recent <http://wiki.xenproject.org/wiki/OpenStack_CI_Loop_for_Xen-Libvirt>`_,
which contains the most recent
stability fixes to both Xen and libvirt. stability fixes to both Xen and libvirt.
`Xen 4.5.1 <http://www.xenproject.org/downloads/xen-archives/xen-45-series/ `Xen 4.5.1
xen-451.html>`_ (or newer) and `libvirt 1.2.15 <http://libvirt.org/sources/>`_ <http://www.xenproject.org/downloads/xen-archives/xen-45-series/xen-451.html>`_
(or newer) and `libvirt 1.2.15 <http://libvirt.org/sources/>`_
(or newer) contain the minimum required OpenStack improvements for Xen. (or newer) contain the minimum required OpenStack improvements for Xen.
Although libvirt 1.2.15 works with Xen, libvirt 1.3.2 or newer is recommended. Although libvirt 1.2.15 works with Xen, libvirt 1.3.2 or newer is recommended.
The necessary Xen changes have also been backported to the Xen 4.4.3 stable The necessary Xen changes have also been backported to the Xen 4.4.3 stable
@ -31,8 +33,9 @@ packages.
The latest releases of Xen and libvirt packages that fulfil the above The latest releases of Xen and libvirt packages that fulfil the above
minimum requirements for the various openSUSE distributions can always be minimum requirements for the various openSUSE distributions can always be
found and installed from the `Open Build Service <https://build.opensuse.org/ found and installed from the `Open Build Service
project/show/Virtualization>`_ Virtualization project. <https://build.opensuse.org/project/show/Virtualization>`_
Virtualization project.
To install these latest packages, add the Virtualization repository to your To install these latest packages, add the Virtualization repository to your
software management stack and get the newest packages from there. software management stack and get the newest packages from there.
More information about the latest Xen and libvirt packages are available More information about the latest Xen and libvirt packages are available
@ -40,13 +43,13 @@ More information about the latest Xen and libvirt packages are available
`here <https://build.opensuse.org/package/show/Virtualization/libvirt>`__. `here <https://build.opensuse.org/package/show/Virtualization/libvirt>`__.
Alternatively, it is possible to use the Ubuntu LTS 14.04 Xen Package Alternatively, it is possible to use the Ubuntu LTS 14.04 Xen Package
**4.4.1-0ubuntu0.14.04.4** (Xen 4.4.1) and apply the patches outlined **4.4.1-0ubuntu0.14.04.4** (Xen 4.4.1) and apply the patches outlined `here
`here <http://wiki.xenproject.org/wiki/OpenStack_CI_Loop_for_Xen-Libvirt <http://wiki.xenproject.org/wiki/OpenStack_CI_Loop_for_Xen-Libvirt#Baseline>`__.
#Baseline>`__.
You can also use the Ubuntu LTS 14.04 libvirt package **1.2.2 You can also use the Ubuntu LTS 14.04 libvirt package **1.2.2
libvirt_1.2.2-0ubuntu13.1.7** as baseline and update it to libvirt version libvirt_1.2.2-0ubuntu13.1.7** as baseline and update it to libvirt version
1.2.15, or 1.2.14 with the patches outlined `here <http://wiki.xenproject.org/ 1.2.15, or 1.2.14 with the patches outlined `here
wiki/OpenStack_CI_Loop_for_Xen-Libvirt#Baseline>`__ applied. <http://wiki.xenproject.org/wiki/OpenStack_CI_Loop_for_Xen-Libvirt#Baseline>`__
applied.
Note that this will require rebuilding these packages partly from source. Note that this will require rebuilding these packages partly from source.
For further information and latest developments, you may want to consult For further information and latest developments, you may want to consult
@ -118,34 +121,24 @@ Use the following as a guideline for configuring Xen for use in OpenStack:
In OpenStack, customer VMs may run in either PV or HVM mode. In OpenStack, customer VMs may run in either PV or HVM mode.
The mode is a property of the operating system image used by the VM, and The mode is a property of the operating system image used by the VM, and
is changed by adjusting the image metadata stored in the Image service. is changed by adjusting the image metadata stored in the Image service.
The image metadata can be changed using the :command:`nova` or The image metadata can be changed using the :command:`openstack` commands.
:command:`glance` commands.
To choose one of the HVM modes (HVM, HVM with PV Drivers or PVHVM), To choose one of the HVM modes (HVM, HVM with PV Drivers or PVHVM),
use :command:`nova` or :command:`glance` to set the ``vm_mode`` use :command:`openstack` to set the ``vm_mode`` property to ``hvm``.
property to ``hvm``.
To choose one of the HVM modes (HVM, HVM with PV Drivers or PVHVM), To choose one of the HVM modes (HVM, HVM with PV Drivers or PVHVM),
use one of the following two commands: use one of the following two commands:
.. code-block:: console .. code-block:: console
$ nova image-meta img-uuid set vm_mode=hvm $ openstack image set --property vm_mode=hvm IMAGE
.. code-block:: console
$ glance image-update img-uuid --property vm_mode=hvm
To chose PV mode, which is supported by NetBSD, FreeBSD and Linux, To chose PV mode, which is supported by NetBSD, FreeBSD and Linux,
use one of the following two commands use one of the following two commands
.. code-block:: console .. code-block:: console
$ nova image-meta img-uuid set vm_mode=xen $ openstack image set --property vm_mode=xen IMAGE
.. code-block:: console
$ glance image-update img-uuid --property vm_mode=xen
.. note:: .. note::
@ -165,19 +158,15 @@ Use the following as a guideline for configuring Xen for use in OpenStack:
launching instances of the image. Image metadata such as ``vm_mode``, launching instances of the image. Image metadata such as ``vm_mode``,
``hypervisor_type``, architecture, and others can be set when importing ``hypervisor_type``, architecture, and others can be set when importing
the image to the Image service. The metadata can also be changed using the image to the Image service. The metadata can also be changed using
the :command:`nova` or :command:`glance` commands: the :command:`openstack` commands:
.. code-block:: console .. code-block:: console
$ nova image-meta img-uuid set hypervisor_type=xen vm_mode=hvm $ openstack image set --property hypervisor_type=xen vm_mode=hvm IMAGE
.. code-block:: console
$ glance image-update img-uuid --property hypervisor_type=xen --property vm_mode=hvm
For more more information on image metadata, refer to the For more more information on image metadata, refer to the
`OpenStack Virtual Image Guide <http://docs.openstack.org/image-guide/ `OpenStack Virtual Image Guide
image-metadata.html>`__. <http://docs.openstack.org/image-guide/image-metadata.html>`__.
#. **Libguestfs file injection**: OpenStack compute nodes can use `libguestfs #. **Libguestfs file injection**: OpenStack compute nodes can use `libguestfs
<http://libguestfs.org/>`_ to inject files into an instance's image prior <http://libguestfs.org/>`_ to inject files into an instance's image prior
@ -204,8 +193,9 @@ across other issues, you should first consult the following log files:
* ``/var/log/xen/qemu-dm-${instancename}.log``, * ``/var/log/xen/qemu-dm-${instancename}.log``,
* ``/var/log/xen/xen-hotplug.log``, * ``/var/log/xen/xen-hotplug.log``,
* ``/var/log/xen/console/guest-${instancename}`` * ``/var/log/xen/console/guest-${instancename}``
(to enable see `Enabling Guest Console Logs <http://wiki.xen.org/wiki/ (to enable see `Enabling Guest Console Logs
Reporting_Bugs_against_Xen#Guest_console_logs>`_) and <http://wiki.xen.org/wiki/Reporting_Bugs_against_Xen#Guest_console_logs>`_)
and
* Host Console Logs (read `Enabling and Retrieving Host Console Logs * Host Console Logs (read `Enabling and Retrieving Host Console Logs
<http://wiki.xen.org/wiki/Reporting_Bugs_against_Xen#Host_console_logs>`_). <http://wiki.xen.org/wiki/Reporting_Bugs_against_Xen#Host_console_logs>`_).