openstack/kolla-ansible
Code Issues Proposed changes

XenAPI: Add guide document for XenServer

Browse Source 
Now we can support OpenStack services deployment on XenServer by
using Kolla. This commit is to amend the document.

Change-Id: I08613c1b77b22cf7d2e695f569497727d3a4c101
blueprint: xenserver-support
This commit is contained in:
jianghua wang 2017-09-30 10:34:03 +00:00 committed by Jianghua Wang
parent d753da058d
commit 5c9fe813fa
2 changed files with 103 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
doc/source/reference/index.rst
View File

@ -25,3 +25,4 @@ Projects Deployment References
skydive-guide
vmware-guide
tacker-guide
xenserver-guide

102
doc/source/reference/xenserver-guide.rst Normal file
View File

@ -0,0 +1,102 @@
.. _XenServer-guide:
==================
XenServer in Kolla
==================
Overview
========
Kolla can deploy the OpenStack services on XenServer hosts by choosing
``xenapi`` as the compute virt driver.
In XenServer, there is a privileged domain which is known as dom0;
and it can run a number of un-privileged domains which are known as
domUs or VMs.
Most OpenStack services (e.g. Keystone, Glance, Horizon) can run either
in the XenServer VMs or in separate baremetal hosts, but some services
(which make direct use of the hypervisor) must run in the XenServer VMs.
These services will interact with the XenServer host via XenAPI to perform
privileged operations. See the following list for such kind of services:
* ``nova-compute``
* ``neutron-openvswitch-agent-xenapi``
* ``ceilometer-compute``
.. note::
At the moment, only CentOS 7.x has been tested.
Preparation for compute node on XenServer hosts
===============================================
We need some bootstrap tasks particularly for XenAPI compute nodes. The
tasks are implemented in the package of ``python-os-xenapi`` and exposed
to kolla-ansible via a single command - ``xenapi_bootstrap``. This package
is contained in the ``RDO CloudSIG repository`` [`RDO repos`_] and will be
installed on compute nodes at nova deployment. So we need ensure this
repository is reachable from the compute nodes or cache the repository
locally.
Create a compute VM on each XenServer host which will be used to boot
instances on. The VM must meet the common requirements declared by
kolla-ansible for KVM/QEMU deployment.
Additionally you should install PV driver in the VM [`XenServer documents`_];
and create the HIMN(Host Internal Management Network) for each compute VM
by following these steps:
1. In XenCenter, from the menu choose "View -> Hidden Objects";
2. You will see HIMN in the host's 'Networking' page;
3. Create an interface on HIMN for the compute VM.
The remaining instructions are just the same as the preparations for
KVM/QEMU deployment.
Deployment
----------
Enable the virt type ``xenapi`` and configure connection options in
``/etc/kolla/globals.yml``:
.. code-block:: yaml
nova_compute_virt_type: "xenapi"
xenserver_username: "root"
xenserver_connect_protocol: "https"
.. note::
When using ``https`` as the connection protocol, please refer XenServer
user document to setup the signed SSL certificates to allow the secure
communications between dom0 and domU. Otherwise, please use ``http`` for
self-signed certificates.
You also need set the password for xenserver_username in
``/etc/kolla/passwords.yml``:
.. code-block:: yaml
xenserver_password: "root_password"
Then you can start kolla-ansible deployment just following the general
deployment instructions [`Quick Start`_].
References
==========
For more information on XenAPI OpenStack, see:
XenAPI OpenStack: https://docs.openstack.org/nova/latest/admin/configuration/hypervisor-xen-api.html
.. _RDO repos: https://www.rdoproject.org/what/repos/
.. _XenServer documents: https://docs.citrix.com/en-us/xenserver/current-release.html
.. _Quick Start: https://docs.openstack.org/kolla-ansible/latest/user/quickstart.html