From ccbf3bfe22a4624a48bdbdac130f6501a15d82fa Mon Sep 17 00:00:00 2001 From: andydugas Date: Wed, 23 Apr 2014 12:31:30 -0700 Subject: [PATCH] Added topic for configuring datastore backend for Glance I added a new file describing how to configure datastore backends for Glance in vCenter and the glance conf file. Also added an include so the new topic appears as a child topic. Change-Id: I9cb90ff4b4b0689dc9e85d40681044dfeb5029d1 Closes-Bug: #1311814 --- .../section_image-service-backend-vmware.xml | 167 ++++++++++++++++++ .../section_image-service-backends.xml | 2 +- 2 files changed, 168 insertions(+), 1 deletion(-) create mode 100644 doc/config-reference/image-service/section_image-service-backend-vmware.xml diff --git a/doc/config-reference/image-service/section_image-service-backend-vmware.xml b/doc/config-reference/image-service/section_image-service-backend-vmware.xml new file mode 100644 index 0000000000..9b029c11ca --- /dev/null +++ b/doc/config-reference/image-service/section_image-service-backend-vmware.xml @@ -0,0 +1,167 @@ + +
+ Configure vCenter data stores for the Image Service back + end + + To use vCenter data stores for the Image Service back end, + you must update the glance-api.conf file, + as follows: + + + Add data store parameters to the VMware + Datastore Store Options section. + + + Specify vSphere as the back end. + + + + You must configure any configured Image Service data + stores for the Compute service. + + 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 + . + If you intend to use multiple data stores for the + back end, use the SPBM feature. + + In the DEFAULT section, set the + default_store parameter to + vsphere, as shown in this code + sample: + [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 + The following table describes the parameters in the + VMware Datastore Store Options + section: + + The following block of text shows a sample + configuration: + # ============ 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 = ADMINISTRATOR + +# Server password (string value) +vmware_server_password = password + +# 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 = DATACENTER + +# Datastore associated with the datacenter (string value) +vmware_datastore_name = datastore1 + +# 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 = 5 + +# Absolute path of the folder containing the images in the datastore +# (string value) +vmware_store_image_dir = /openstack_glance + +# Allow to perform insecure SSL requests to the target system (boolean value) +vmware_api_insecure = False +
+ Configure vCenter data stores for the back end + You can specify a vCenter data store for the back end by + setting the vmware_datastore_name + parameter value to the vCenter name of the data store. + This configuration limits the back end to a single data + store. + Alternatively, you can specify a SPBM policy, which can + comprise multiple vCenter data stores. Both approaches are + described. + + SPBM requires vCenter Server 5.5 or later. + + + To configure a single data store + + If present, comment or delete the + vmware_pbm_wsdl_location + and vmware_pbm_policy + parameters. + + + Uncomment and define the + vmware_datastore_name + parameter with the name of the vCenter data + store. + + + Complete the other vCenter configuration + parameters as appropriate. + + + + To configure multiple data stores using + SPBM + + In vCenter, tag the data stores to be used for + the back end. + + For details about creating tags in vSphere, + see the vSphere documentation. + + + + Return to the + glance-api.conf + file. + + + Comment or delete the + vmware_datastore_name + parameter. + + + Uncomment and define the + vmware_pbm_policy + parameter by entering the same value as the tag + you defined and applied to the data stores in + vCenter. + + + Uncomment and define the + vmware_pbm_wsdl_location + parameter by entering the location of the PBM + service WSDL file. For example, + file:///opt/SDK/spbm/wsdl/pbmService.wsdl. + + If you do not set this parameter, the + storage policy cannot be used to place images + in the data store. + + Complete the other vCenter configuration + parameters as appropriate. + + +
+
diff --git a/doc/config-reference/image-service/section_image-service-backends.xml b/doc/config-reference/image-service/section_image-service-backends.xml index c82a233406..2c0a062fbe 100644 --- a/doc/config-reference/image-service/section_image-service-backends.xml +++ b/doc/config-reference/image-service/section_image-service-backends.xml @@ -20,5 +20,5 @@ - +