a6bce01980
The XML root element of Docbook XML files should match the following format: <ELEMENT 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="THE_XML_ID_OF_THE_ELEMENT"> Change-Id: I02a75b63d0fb3ea4a7d015794b9229a94ddad279
187 lines
8.1 KiB
XML
187 lines
8.1 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="vmware-glance-backend">
|
|
<title>Configure vCenter data stores for the Image Service back
|
|
end</title>
|
|
<?dbhtml stop-chunking?>
|
|
<para>To use vCenter data stores for the Image Service back end,
|
|
you must update the <filename>glance-api.conf</filename> file,
|
|
as follows:</para>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<para>Add data store parameters to the <literal>VMware
|
|
Datastore Store Options</literal> section.</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>Specify vSphere as the back end.</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<note>
|
|
<para>You must configure any configured Image Service data
|
|
stores for the Compute service.</para>
|
|
</note>
|
|
<para>You can specify vCenter data stores directly by using the
|
|
data store name or Storage Policy Based Management (SPBM),
|
|
which requires vCenter Server 5.5 or later. For details, see
|
|
<xref linkend="glance-backend-DS"/>. <note>
|
|
<para>If you intend to use multiple data stores for the
|
|
back end, use the SPBM feature.</para>
|
|
</note></para>
|
|
<para>In the <literal>DEFAULT</literal> section, set the
|
|
<parameter>default_store</parameter> parameter to
|
|
<userinput>vsphere</userinput>, as shown in this code
|
|
sample:</para>
|
|
<programlisting language="ini">[DEFAULT]
|
|
# Which back end scheme should Glance use by default is not specified
|
|
# in a request to add a new image to Glance? Known schemes are determined
|
|
# by the known_stores option below.
|
|
# Default: 'file'
|
|
default_store = vsphere</programlisting>
|
|
<para>The following table describes the parameters in the
|
|
<literal>VMware Datastore Store Options</literal>
|
|
section:</para>
|
|
<xi:include href="../../common/tables/glance-vmware.xml"/>
|
|
<para>The following block of text shows a sample
|
|
configuration:</para>
|
|
<programlisting language="ini"># ============ VMware Datastore Store Options =====================
|
|
# ESX/ESXi or vCenter Server target system.
|
|
# The server value can be an IP address or a DNS name
|
|
# e.g. 127.0.0.1, 127.0.0.1:443, www.vmware-infra.com
|
|
vmware_server_host = 192.168.0.10
|
|
|
|
# Server username (string value)
|
|
vmware_server_username = <replaceable>ADMINISTRATOR</replaceable>
|
|
|
|
# Server password (string value)
|
|
vmware_server_password = <replaceable>password</replaceable>
|
|
|
|
# Inventory path to a datacenter (string value)
|
|
# Value optional when vmware_server_ip is an ESX/ESXi host: if specified
|
|
# should be `ha-datacenter`.
|
|
vmware_datacenter_path = <replaceable>DATACENTER</replaceable>
|
|
|
|
# Datastore associated with the datacenter (string value)
|
|
vmware_datastore_name = <replaceable>datastore1</replaceable>
|
|
|
|
# PBM service WSDL file location URL. e.g.
|
|
# file:///opt/SDK/spbm/wsdl/pbmService.wsdl Not setting this
|
|
# will disable storage policy based placement of images.
|
|
# (string value)
|
|
#vmware_pbm_wsdl_location =
|
|
|
|
# The PBM policy. If `pbm_wsdl_location` is set, a PBM policy needs
|
|
# to be specified. This policy will be used to select the datastore
|
|
# in which the images will be stored.
|
|
#vmware_pbm_policy =
|
|
|
|
# The interval used for polling remote tasks
|
|
# invoked on VMware ESX/VC server in seconds (integer value)
|
|
vmware_task_poll_interval = <replaceable>5</replaceable>
|
|
|
|
# Absolute path of the folder containing the images in the datastore
|
|
# (string value)
|
|
vmware_store_image_dir = <replaceable>/openstack_glance</replaceable>
|
|
|
|
# Allow to perform insecure SSL requests to the target system (boolean value)
|
|
vmware_api_insecure = <replaceable>False</replaceable></programlisting>
|
|
<section xml:id="glance-backend-DS">
|
|
<title>Configure vCenter data stores for the back end</title>
|
|
<para>You can specify a vCenter data store for the back end by
|
|
setting the <parameter>vmware_datastore_name</parameter>
|
|
parameter value to the vCenter name of the data store.
|
|
This configuration limits the back end to a single data
|
|
store.</para>
|
|
<para>Alternatively, you can specify a SPBM policy, which can
|
|
comprise multiple vCenter data stores. Both approaches are
|
|
described.</para>
|
|
<note>
|
|
<para>SPBM requires vCenter Server 5.5 or later.</para>
|
|
</note>
|
|
<procedure>
|
|
<title>To configure a single data store</title>
|
|
<step>
|
|
<para>If present, comment or delete the
|
|
<parameter>vmware_pbm_wsdl_location</parameter>
|
|
and <parameter>vmware_pbm_policy</parameter>
|
|
parameters.</para>
|
|
</step>
|
|
<step>
|
|
<para>Uncomment and define the
|
|
<parameter>vmware_datastore_name</parameter>
|
|
parameter with the name of the vCenter data
|
|
store.</para>
|
|
</step>
|
|
<step>
|
|
<para>Complete the other vCenter configuration
|
|
parameters as appropriate.</para>
|
|
</step>
|
|
</procedure>
|
|
<procedure>
|
|
<title>To configure multiple data stores using
|
|
SPBM</title>
|
|
<step>
|
|
<para>In vCenter, use tagging to identify the data
|
|
stores and define a storage policy:</para>
|
|
<substeps>
|
|
<step>
|
|
<para>Create the tag.</para>
|
|
</step>
|
|
<step>
|
|
<para>Apply the tag to the data stores to be
|
|
used by the SPBM policy.</para>
|
|
</step>
|
|
<step>
|
|
<para>Create a tag-based storage policy that
|
|
uses one or more tags to identify a set of
|
|
data stores.</para>
|
|
</step>
|
|
</substeps>
|
|
<note>
|
|
<para>For details about creating tags in vSphere,
|
|
see the <link
|
|
xlink:href="http://pubs.vmware.com/vsphere-55/index.jsp#com.vmware.vsphere.vcenterhost.doc/GUID-379F40D3-8CD6-449E-89CB-79C4E2683221.html">vSphere documentation</link>.
|
|
</para>
|
|
<para>For details about storage policies in
|
|
vSphere, see the <link
|
|
xlink:href="http://pubs.vmware.com/vsphere-55/index.jsp#com.vmware.vsphere.storage.doc/GUID-A8BA9141-31F1-4555-A554-4B5B04D75E54.html">vSphere documentation</link>.
|
|
</para>
|
|
</note>
|
|
</step>
|
|
<step>
|
|
<para>Return to the
|
|
<filename>glance-api.conf</filename>
|
|
file.</para>
|
|
</step>
|
|
<step>
|
|
<para>Comment or delete the
|
|
<parameter>vmware_datastore_name</parameter>
|
|
parameter.</para>
|
|
</step>
|
|
<step>
|
|
<para>Uncomment and define the
|
|
<parameter>vmware_pbm_policy</parameter>
|
|
parameter by entering the same value as the tag
|
|
you defined and applied to the data stores in
|
|
vCenter.</para>
|
|
</step>
|
|
<step>
|
|
<para>Uncomment and define the
|
|
<parameter>vmware_pbm_wsdl_location</parameter>
|
|
parameter by entering the location of the PBM
|
|
service WSDL file. For example,
|
|
<filename>file:///opt/SDK/spbm/wsdl/pbmService.wsdl</filename>.</para>
|
|
<note>
|
|
<para>If you do not set this parameter, the
|
|
storage policy cannot be used to place images
|
|
in the data store.</para>
|
|
</note>
|
|
<para>Complete the other vCenter configuration
|
|
parameters as appropriate.</para>
|
|
</step>
|
|
</procedure>
|
|
</section>
|
|
</section>
|