openstack-manuals/doc/config-reference/image-service/section_image-service-backend-vmware.xml
Christian Berendt d7c3f88004 Fix usage of option and parameter
Change-Id: I78e99862dbf16829342d4e618f09e5d75b6debdf
2015-04-23 22:02:08 +02:00

118 lines
4.9 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>glance_store</literal> section, set the
<option>default_store</option> option to
<userinput>vsphere</userinput>, as shown in this code
sample:</para>
<programlisting language="ini">[glance_store]
# 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 <option>vmware_datastore_name</option>
parameter value to the vCenter name of the data store.
This configuration limits the back end to a single data
store.</para>
<procedure>
<title>To configure a single data store</title>
<step>
<para>If present, comment or delete the
<option>vmware_pbm_wsdl_location</option>
and <option>vmware_pbm_policy</option>
parameters.</para>
</step>
<step>
<para>Uncomment and define the
<option>vmware_datastore_name</option>
parameter with the name of the vCenter data
store.</para>
</step>
<step>
<para>Complete the other vCenter configuration
parameters as appropriate.</para>
</step>
</procedure>
</section>
</section>