986a6a015f
The Sphinx build was issuing hundreds of warning for duplicate labels. The reason for this was because all of the tables we had were named as .rst files. This would cause Sphinx to process them twice and it would think there were duplicated sections. There were two ways this could be handled: 1) Exclude the tables directory from the docs build. 2) Name the files as they should have always been so they weren't build twice. Given that option 1 just masked the problem, I am implementing this patch using option 2. So, all the tables we are including in our documentation have been named from .rst to .inc and the .. include:: directives that use them have also been updated to use the new file name. Change-Id: If395eb652f7e3b789bcbd5e6d6d05954c23d8d8a
44 lines
1.2 KiB
ReStructuredText
44 lines
1.2 KiB
ReStructuredText
===
|
|
LVM
|
|
===
|
|
|
|
The default volume back end uses local volumes managed by LVM.
|
|
|
|
This driver supports different transport protocols to attach volumes,
|
|
currently iSCSI and iSER.
|
|
|
|
Set the following in your ``cinder.conf`` configuration file, and use
|
|
the following options to configure for iSCSI transport:
|
|
|
|
.. code-block:: ini
|
|
|
|
volume_driver = cinder.volume.drivers.lvm.LVMVolumeDriver
|
|
iscsi_protocol = iscsi
|
|
|
|
Use the following options to configure for the iSER transport:
|
|
|
|
.. code-block:: ini
|
|
|
|
volume_driver = cinder.volume.drivers.lvm.LVMVolumeDriver
|
|
iscsi_protocol = iser
|
|
|
|
.. include:: ../../tables/cinder-lvm.inc
|
|
|
|
.. caution::
|
|
|
|
When extending an existing volume which has a linked snapshot, the related
|
|
logical volume is deactivated. This logical volume is automatically
|
|
reactivated unless ``auto_activation_volume_list`` is defined in LVM
|
|
configuration file ``lvm.conf``. See the ``lvm.conf`` file for more
|
|
information.
|
|
|
|
If auto activated volumes are restricted, then include the cinder volume
|
|
group into this list:
|
|
|
|
.. code-block:: ini
|
|
|
|
auto_activation_volume_list = [ "existingVG", "cinder-volumes" ]
|
|
|
|
This note does not apply for thinly provisioned volumes
|
|
because they do not need to be deactivated.
|