summaryrefslogtreecommitdiff
path: root/nova/conf/workarounds.py
diff options
context:
space:
mode:
Diffstat (limited to 'nova/conf/workarounds.py')
-rw-r--r--nova/conf/workarounds.py28
1 files changed, 26 insertions, 2 deletions
diff --git a/nova/conf/workarounds.py b/nova/conf/workarounds.py
index 4d315ebc81..366744ad23 100644
--- a/nova/conf/workarounds.py
+++ b/nova/conf/workarounds.py
@@ -290,12 +290,36 @@ Enabling this workaround option will cause Nova to use the legacy dm-crypt
based os-brick encryptor to decrypt the LUKSv1 volume.
Note that enabling this option while using volumes that do not provide a host
-block device such as Ceph will result in a failure to either boot from or
-attach the volume.
+block device such as Ceph will result in a failure to boot from or attach the
+volume to an instance. See the ``[workarounds]/rbd_block_device`` option for a
+way to avoid this for RBD.
Related options:
* ``compute_driver`` (libvirt)
+* ``rbd_block_device`` (workarounds)
+"""),
+ cfg.BoolOpt('rbd_volume_local_attach',
+ default=False,
+ help="""
+Attach RBD Cinder volumes to the compute as host block devices.
+
+When enabled this option instructs os-brick to connect RBD volumes locally on
+the compute host as block devices instead of natively through QEMU.
+
+This workaround does not currently support extending attached volumes.
+
+This can be used with the disable_native_luksv1 workaround configuration
+option to avoid the recently discovered performance issues found within the
+libgcrypt library.
+
+This workaround is temporary and will be removed during the W release once
+all impacted distributions have been able to update their versions of the
+libgcrypt library.
+
+Related options:
+* ``compute_driver`` (libvirt)
+* ``disable_qemu_native_luksv1`` (workarounds)
"""),
]