openstack-manuals/doc/config-reference/compute/section_xapi-install.xml
Lars Kurth bb15ae4df4 Add documentation for Xen via libvirt to config-reference
To do this I had do some changes to existing Xen documentation:

Apply minimal changes to filenames, enabling later addition of
hypervisor support using Xen+libvirt, renaming XenServer files
using git mv
- section_introduction-to-xen.xml > section_hypervisor_xen_xapi.xml
- section_xen-install.xml > section_xapi-install.xml
- section_compute-configure-xen.xml > section_compute-configure-xapi.xml

All XenServer docs can now be identified using xapi in the filename.

Renamed relevant occurances of Xen to XenServer in XenServer docs and
the Hypervisor page and replaced outdated references to Xen.org with
XenProject.org

Changed URL from introduction-to-xen.html to xen_libvirt.html in
doc/common/section_kvm_enable.xml (did not include references in .po
and .pot files in locale, which are autogenerated)

All of the new Xen via Libvirt documentation is in a new page called
section_hypervisor_xen_libvirt.html

Change-Id: I6a6de021ef4e5de4fe28aa971411e07b656c969c
Closes-Bug: #1253565
Signed-off-by: Lars Kurth <lars.kurth@xenproject.org>
Co-Authored-By: Jim Fehlig <jfehlig@suse.com>
Co-Authored-By: Anthony Perard <anthony.perard@citrix.com>
2015-07-13 08:54:45 -04:00

118 lines
4.5 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<section xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
version="5.0"
xml:id="xenapi-install">
<title xml:id="xenapi-install.title">Install XenServer</title>
<para>
Before you can run OpenStack with XenServer, you must install the
hypervisor on
<link
xlink:href="http://docs.vmd.citrix.com/XenServer/6.2.0/1.0/en_gb/installation.html#sys_requirements">
an appropriate server
</link>
.
</para>
<note>
<para>
Xen is a type 1 hypervisor: When your server starts, Xen is the
first software that runs. Consequently, you must install XenServer
before you install the operating system where you want to run
OpenStack code. You then install
<systemitem class="service">nova-compute</systemitem> into a
dedicated virtual machine on the host.
</para>
</note>
<para>
Use the following link to download XenServer's installation media:
<itemizedlist>
<listitem>
<para>
<link
xlink:href="http://xenserver.org/open-source-virtualization-download.html">
http://xenserver.org/open-source-virtualization-download.html
</link>
</para>
</listitem>
</itemizedlist>
</para>
<para>
When you install many servers, you might find it easier to perform
<link
xlink:href="http://docs.vmd.citrix.com/XenServer/6.2.0/1.0/en_gb/installation.html#pxe_boot_install">
PXE boot installations
</link>
. You can also package any post-installation changes that you want to
make to your XenServer by following the instructions of
<link
xlink:href="http://docs.vmd.citrix.com/XenServer/6.2.0/1.0/en_gb/supplemental_pack_ddk.html">
creating your own XenServer supplemental pack
</link>
.
</para>
<important>
<para>
Make sure you use the EXT type of storage repository (SR). Features
that require access to VHD files (such as copy on write, snapshot
and migration) do not work when you use the LVM SR. Storage
repository (SR) is a XAPI-specific term relating to the physical
storage where virtual disks are stored.
</para>
<para>
On the XenServer installation screen, choose the
<guilabel>XenDesktop Optimized</guilabel>
option. If you use an answer file, make sure you use
<literal>srtype="ext"</literal>
in the
<literal>installation</literal>
tag of the answer file.
</para>
</important>
<section xml:id="xenapi-post-install">
<title>Post-installation steps</title>
<para>
The following steps need to be completed after the hypervisor's
installation:
</para>
<procedure>
<step>
<para>
For resize and migrate functionality, enable password-less
SSH authentication and set up the
<literal>/images</literal>
directory on dom0.
</para>
</step>
<step>
<para>
Install the XAPI plug-ins.
</para>
</step>
<step>
<para>
To support AMI type images, you must set up
<literal>/boot/guest</literal>
symlink/directory in dom0.
</para>
</step>
<step>
<para>
Create a paravirtualized virtual machine that can run
<systemitem class="service">nova-compute</systemitem>.
</para>
</step>
<step>
<para>
Install and configure
<systemitem class="service">nova-compute</systemitem>
in the above virtual machine.
</para>
</step>
</procedure>
<xi:include href="section_xapi-install-plugins.xml"/>
<xi:include href="section_xapi-ami-setup.xml"/>
<xi:include href="section_xapi-resize-setup.xml"/>
</section>
</section>