From 4ee3f80b0c7bb08541be903668d7ff5ef1c36851 Mon Sep 17 00:00:00 2001 From: smartu3 Date: Wed, 16 May 2018 10:32:58 +0800 Subject: [PATCH] Add doc about backend_default config Co-Authored-By: ycx Change-Id: Ifa33c1546d7b1a9a04cd505fbd697911d9649cca Closes-Bug: #1703977 --- .../admin/blockstorage-multi-backend.rst | 40 +++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/doc/source/admin/blockstorage-multi-backend.rst b/doc/source/admin/blockstorage-multi-backend.rst index a09b4d1e74e..49bdfdf17a9 100644 --- a/doc/source/admin/blockstorage-multi-backend.rst +++ b/doc/source/admin/blockstorage-multi-backend.rst @@ -96,6 +96,46 @@ provides more information. In addition, this example presents a volume_driver = cinder.volume.drivers.emc.emc_smis_fc.EMCSMISFCDriver volume_backend_name = emcfc +Configure shared volume driver backends +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +When configuring multiple volume backends, common configuration +parameters can be shared using the `[backend_default]` section. As +an example: + +.. code-block:: ini + + [DEFAULT] + enabled_backends=backend1,backend2,backend3 + + [backend_default] + image_volume_cache_enabled = True + volume_clear = none + iscsi_helper = tgtadm + volume_driver = cinder.volume.drivers.lvm.LVMVolumeDriver + + [backend1] + volume_group = cinder-volume-1 + image_volume_cache_enabled = False + + [backend2] + volume_group = cinder-volume-2 + + [backend3] + volume_group = cinder-volume-3 + +In this configuration, ``backend2`` and ``backend3`` have the same +``image_volume_cache_enabled`` as it is defined in the ``backend_default`` +section. In other words, ``backend2`` and ``backend3`` have enabled +the image cache features. ``image_volume_cache_enabled`` in ``backend1`` +is False, that means any overwritten configuration in a volume backend +will ignore the original value in ``backend_default``. + +.. note:: + + The ``backend_default`` section should be configured according to + your cloud environment or your backend driver information. + Configure Block Storage scheduler multi back end ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~