From cf331d17c8395daed45a54dfeef758004bcfc6a3 Mon Sep 17 00:00:00 2001 From: KATO Tomoyuki Date: Fri, 4 Nov 2016 13:06:54 +0900 Subject: [PATCH] [config-ref] cleanup Compute Xen libvirt chapter Change-Id: I14dbcfcb7480d2e1da9f220f69a45be22095e266 --- .../source/compute/hypervisor-xen-libvirt.rst | 60 ++++++++----------- 1 file changed, 25 insertions(+), 35 deletions(-) diff --git a/doc/config-reference/source/compute/hypervisor-xen-libvirt.rst b/doc/config-reference/source/compute/hypervisor-xen-libvirt.rst index 9972847f66..ef56900e46 100644 --- a/doc/config-reference/source/compute/hypervisor-xen-libvirt.rst +++ b/doc/config-reference/source/compute/hypervisor-xen-libvirt.rst @@ -15,12 +15,14 @@ Installing Xen with libvirt ~~~~~~~~~~~~~~~~~~~~~~~~~~~ At this stage we recommend using the baseline that we use for the -`Xen Project OpenStack CI Loop `_, which contains the most recent +`Xen Project OpenStack CI Loop +`_, +which contains the most recent stability fixes to both Xen and libvirt. -`Xen 4.5.1 `_ (or newer) and `libvirt 1.2.15 `_ +`Xen 4.5.1 +`_ +(or newer) and `libvirt 1.2.15 `_ (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. 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 minimum requirements for the various openSUSE distributions can always be -found and installed from the `Open Build Service `_ Virtualization project. +found and installed from the `Open Build Service +`_ +Virtualization project. To install these latest packages, add the Virtualization repository to your software management stack and get the newest packages from there. 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 `__. 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 -`here `__. +**4.4.1-0ubuntu0.14.04.4** (Xen 4.4.1) and apply the patches outlined `here +`__. 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 -1.2.15, or 1.2.14 with the patches outlined `here `__ applied. +1.2.15, or 1.2.14 with the patches outlined `here +`__ +applied. Note that this will require rebuilding these packages partly from source. 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. 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. - The image metadata can be changed using the :command:`nova` or - :command:`glance` commands. + The image metadata can be changed using the :command:`openstack` commands. 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`` - property to ``hvm``. + use :command:`openstack` to set the ``vm_mode`` property to ``hvm``. To choose one of the HVM modes (HVM, HVM with PV Drivers or PVHVM), use one of the following two commands: .. code-block:: console - $ nova image-meta img-uuid set vm_mode=hvm - - .. code-block:: console - - $ glance image-update img-uuid --property vm_mode=hvm + $ openstack image set --property vm_mode=hvm IMAGE To chose PV mode, which is supported by NetBSD, FreeBSD and Linux, use one of the following two commands .. code-block:: console - $ nova image-meta img-uuid set vm_mode=xen - - .. code-block:: console - - $ glance image-update img-uuid --property vm_mode=xen + $ openstack image set --property vm_mode=xen IMAGE .. 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``, ``hypervisor_type``, architecture, and others can be set when importing 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 - $ nova image-meta img-uuid set hypervisor_type=xen vm_mode=hvm - - .. code-block:: console - - $ glance image-update img-uuid --property hypervisor_type=xen --property vm_mode=hvm + $ openstack image set --property hypervisor_type=xen vm_mode=hvm IMAGE For more more information on image metadata, refer to the - `OpenStack Virtual Image Guide `__. + `OpenStack Virtual Image Guide + `__. #. **Libguestfs file injection**: OpenStack compute nodes can use `libguestfs `_ 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/xen-hotplug.log``, * ``/var/log/xen/console/guest-${instancename}`` - (to enable see `Enabling Guest Console Logs `_) and + (to enable see `Enabling Guest Console Logs + `_) + and * Host Console Logs (read `Enabling and Retrieving Host Console Logs `_).