From 6d98a7d772175321c3082cdcbf9820133e9f83e6 Mon Sep 17 00:00:00 2001
From: Michael Denny <michael.denny@hp.com>
Date: Thu, 25 Jun 2015 15:38:51 -0700
Subject: [PATCH] Global Cinder setting not seen by group conf

This patch documents how to configure Fiber Channel configuration
groups with copy image to volume multipathing option. Since
LVM doesn't support multipath I've used HP 3PAR and EMC as examples.

Change-Id: I3491046d0bd79a27df7c67472048fefa5d9a3f8e
Closes-Bug: #1326571
---
 .../source/blockstorage_multi_backend.rst     | 20 +++++++++++++++++++
 .../blockstorage/section_multi_backend.xml    | 15 ++++++++++++++
 2 files changed, 35 insertions(+)

diff --git a/doc/admin-guide-cloud-rst/source/blockstorage_multi_backend.rst b/doc/admin-guide-cloud-rst/source/blockstorage_multi_backend.rst
index 08505738d7..8d05074902 100644
--- a/doc/admin-guide-cloud-rst/source/blockstorage_multi_backend.rst
+++ b/doc/admin-guide-cloud-rst/source/blockstorage_multi_backend.rst
@@ -77,6 +77,26 @@ The capacity filter scheduler is enabled by default. The next section
 provides more information. In addition, this example presents a
 ``lvmdriver-3`` back end.
 
+.. note::
+
+   For Fiber Channel drivers that support multipath, the configuration group
+   requires the ``use_multipath_for_image_xfer=true`` option. In
+   the example below, you can see details for HP 3PAR and EMC Fiber
+   Channel drivers.
+
+.. code-block:: ini
+   :linenos:
+
+   [3par]
+   use_multipath_for_image_xfer = true
+   volume_driver = cinder.volume.drivers.san.hp.hp_3par_fc.HP3PARFCDriver
+   volume_backend_name = 3parfc
+
+   [emc]
+   use_multipath_for_image_xfer = true
+   volume_driver = cinder.volume.drivers.emc.emc_smis_fc.EMCSMISFCDriver
+   volume_backend_name = emcfc
+
 **Configure Block Storage scheduler multi back end**
 
 You must enable the `filter_scheduler` option to use
diff --git a/doc/admin-guide-cloud/blockstorage/section_multi_backend.xml b/doc/admin-guide-cloud/blockstorage/section_multi_backend.xml
index 583655af7c..fbd4ae6294 100644
--- a/doc/admin-guide-cloud/blockstorage/section_multi_backend.xml
+++ b/doc/admin-guide-cloud/blockstorage/section_multi_backend.xml
@@ -76,6 +76,21 @@ volume_backend_name=LVM_iSCSI_b</programlisting>
             scheduler is enabled by default. The next section provides
             more information. In addition, this example presents a
                 <literal>lvmdriver-3</literal> back end.</para>
+        <note>
+        <para>For Fiber Channel drivers that support multipath, the configuration group
+            requires the <literal>use_multipath_for_image_xfer=true</literal> option.
+            In the example below, you can see details for HP 3PAR and EMC Fiber Channel
+             drivers.</para>
+        <programlisting language="ini">[3par]
+use_multipath_for_image_xfer = true
+volume_driver = cinder.volume.drivers.san.hp.hp_3par_fc.HP3PARFCDriver
+volume_backend_name = 3parfc
+
+[emc]
+use_multipath_for_image_xfer = true
+volume_driver = cinder.volume.drivers.emc.emc_smis_fc.EMCSMISFCDriver
+volume_backend_name = emcfc</programlisting>
+        </note>
     </simplesect>
     <simplesect>
         <title>Configure Block Storage scheduler multi back