8bacea0a6f
* Removed plugin installation through creating a supplemental pack as the scripts used to build the pack are no longer part of compute. * Removed references to XCP, Kronos. * Amend XenServer download links. * Remove references to DevStack. * Remove boot from iso instructions as they are not tested. * Formatted the sources * Update links to XenServer 6.2 Partial-Bug: 1021224 Change-Id: I02d2906d1d5d697dfe709b4e2cc532f0f89983d9
56 lines
2.8 KiB
XML
56 lines
2.8 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="xapi-install-plugins">
|
|
<?dbhtml stop-chunking?>
|
|
<title>Install XAPI plug-ins</title>
|
|
<para>
|
|
When you use a XAPI managed hypervisor, you can install a Python script
|
|
(or any executable) on the host side, and execute that through XenAPI.
|
|
These scripts are called plug-ins. The OpenStack related XAPI plug-ins
|
|
live in OpenStack Compute's code repository. These plug-ins have to be
|
|
copied to dom0's filesystem, to the appropriate directory, where XAPI
|
|
can find them. It is important to ensure that the version of the
|
|
plug-ins are in line with the OpenStack Compute installation you are
|
|
using.
|
|
</para>
|
|
<para>
|
|
The plugins should typically be copied from the Nova installation
|
|
running in the Compute's DomU, but if you want to download the latest
|
|
version the following procedure can be used.
|
|
</para>
|
|
<section xml:id="manual_install">
|
|
<title>Manually installing the plug-ins</title>
|
|
<procedure>
|
|
<step>
|
|
<para>Create temporary files/directories:</para>
|
|
<screen><prompt>$</prompt> <userinput>NOVA_ZIPBALL=$(mktemp)</userinput>
|
|
<prompt>$</prompt> <userinput>NOVA_SOURCES=$(mktemp -d)</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>
|
|
Get the source from GitHub. The example assumes the master
|
|
branch is used, and the XenServer host is accessible
|
|
as xenserver. Match those parameters to your setup.
|
|
</para>
|
|
<screen><prompt>$</prompt> <userinput>NOVA_URL=https://github.com/openstack/nova/archive/master.zip</userinput>
|
|
<prompt>$</prompt> <userinput>wget -qO "$NOVA_ZIPBALL" "$NOVA_URL"</userinput>
|
|
<prompt>$</prompt> <userinput>unzip "$NOVA_ZIPBALL" -d "$NOVA_SOURCES"</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>Copy the plug-ins to the hypervisor:</para>
|
|
<screen><prompt>$</prompt> <userinput>PLUGINPATH=$(find $NOVA_SOURCES -path '*/xapi.d/plugins' -type d -print)</userinput>
|
|
<prompt>$</prompt> <userinput>tar -czf - -C "$PLUGINPATH" ./ |</userinput>
|
|
<prompt>></prompt> <userinput>ssh root@xenserver tar -xozf - -C /etc/xapi.d/plugins/</userinput></screen>
|
|
</step>
|
|
<step>
|
|
<para>Remove temporary files/directories:</para>
|
|
<screen><prompt>$</prompt> <userinput>rm "$NOVA_ZIPBALL"</userinput>
|
|
<prompt>$</prompt> <userinput>rm -rf "$NOVA_SOURCES"</userinput> </screen>
|
|
</step>
|
|
</procedure>
|
|
</section>
|
|
</section>
|