docs: Update LVM configuration

Our documentation uses iscsi_protocol and iscsi_helper to initialize the
LVM backend in multiple places, but this configuration option was being
deprecated in Pike and was removed in Queens.

This patch replaces these configuration options with their target_*
counterparts so the documentation is valid for all cinderlib supported
releases.
This commit is contained in:
Gorka Eguileor 2018-08-29 13:07:39 +02:00
parent 959b8e5105
commit 1ae465e50b
7 changed files with 26 additions and 26 deletions

View File

@ -197,8 +197,8 @@ Now we can use this LVM backend in *cinderlib*:
lvm = cl.Backend(volume_driver='cinder.volume.drivers.lvm.LVMVolumeDriver',
volume_group='cinder-volumes',
iscsi_protocol='iscsi',
iscsi_helper='lioadm',
target_protocol='iscsi',
target_helper='lioadm',
volume_backend_name='lvm_iscsi')
vol = lvm.create_volume(size=1)

View File

@ -139,8 +139,8 @@ control LVM and do the attach) and execute:
# Initialize the LVM driver
lvm = cl.Backend(volume_driver='cinder.volume.drivers.lvm.LVMVolumeDriver',
volume_group='cinder-volumes',
iscsi_protocol='iscsi',
iscsi_helper='lioadm',
target_protocol='iscsi',
target_helper='lioadm',
volume_backend_name='lvm_iscsi')
# Show the LVM backend stats

View File

@ -79,8 +79,8 @@ LVM
lvm = cinderlib.Backend(
volume_driver='cinder.volume.drivers.lvm.LVMVolumeDriver',
volume_group='cinder-volumes',
iscsi_protocol='iscsi',
iscsi_helper='lioadm',
target_protocol='iscsi',
target_helper='lioadm',
volume_backend_name='lvm_iscsi',
)

View File

@ -131,8 +131,8 @@ know when instantiating the driver by passing the
lvm = cinderlib.Backend(
volume_driver='cinder.volume.drivers.lvm.LVMVolumeDriver',
volume_group='cinder-volumes',
iscsi_protocol='iscsi',
iscsi_helper='lioadm',
target_protocol='iscsi',
target_helper='lioadm',
volume_backend_name='lvm_iscsi',
use_multipath_for_image_xfer=True,
)

View File

@ -71,8 +71,8 @@ example of how to save everything to the database:
lvm = cl.Backend(volume_driver='cinder.volume.drivers.lvm.LVMVolumeDriver',
volume_group='cinder-volumes',
iscsi_protocol='iscsi',
iscsi_helper='lioadm',
target_protocol='iscsi',
target_helper='lioadm',
volume_backend_name='lvm_iscsi')
vol = lvm.create_volume(1)
@ -89,8 +89,8 @@ And how to load it back:
lvm = cl.Backend(volume_driver='cinder.volume.drivers.lvm.LVMVolumeDriver',
volume_group='cinder-volumes',
iscsi_protocol='iscsi',
iscsi_helper='lioadm',
target_protocol='iscsi',
target_helper='lioadm',
volume_backend_name='lvm_iscsi')
with open('cinderlib.txt', 'r') as f:
@ -128,8 +128,8 @@ database URLs format`_ as the value of the `connection` key.
lvm = cl.Backend(volume_driver='cinder.volume.drivers.lvm.LVMVolumeDriver',
volume_group='cinder-volumes',
iscsi_protocol='iscsi',
iscsi_helper='lioadm',
target_protocol='iscsi',
target_helper='lioadm',
volume_backend_name='lvm_iscsi')
vol = lvm.create_volume(1)
@ -144,8 +144,8 @@ Using it later is exactly the same:
lvm = cl.Backend(volume_driver='cinder.volume.drivers.lvm.LVMVolumeDriver',
volume_group='cinder-volumes',
iscsi_protocol='iscsi',
iscsi_helper='lioadm',
target_protocol='iscsi',
target_helper='lioadm',
volume_backend_name='lvm_iscsi')
print lvm.volumes
@ -215,8 +215,8 @@ The invocation with a class plugin would look something like this:
lvm = cl.Backend(volume_driver='cinder.volume.drivers.lvm.LVMVolumeDriver',
volume_group='cinder-volumes',
iscsi_protocol='iscsi',
iscsi_helper='lioadm',
target_protocol='iscsi',
target_helper='lioadm',
volume_backend_name='lvm_iscsi')
@ -247,8 +247,8 @@ An example code of how to migrate from SQLite to MySQL could look like this:
# Setup backends we want to migrate
lvm = cl.Backend(volume_driver='cinder.volume.drivers.lvm.LVMVolumeDriver',
volume_group='cinder-volumes',
iscsi_protocol='iscsi',
iscsi_helper='lioadm',
target_protocol='iscsi',
target_helper='lioadm',
volume_backend_name='lvm_iscsi')
# Get all the data into memory

View File

@ -43,8 +43,8 @@ LVM
- volume_backend_name: lvm
volume_driver: cinder.volume.drivers.lvm.LVMVolumeDriver
volume_group: cinder-volumes
iscsi_protocol: iscsi
iscsi_helper: lioadm
target_protocol: iscsi
target_helper: lioadm
Ceph

View File

@ -94,8 +94,8 @@ The contents of the default configuration, excluding the comments, are:
- volume_backend_name: lvm
volume_driver: cinder.volume.drivers.lvm.LVMVolumeDriver
volume_group: cinder-volumes
iscsi_protocol: iscsi
iscsi_helper: lioadm
target_protocol: iscsi
target_helper: lioadm
But like the name implies, `backends` can have multiple drivers configured, and
the functional tests will run the tests on them all.
@ -110,8 +110,8 @@ would look like this:
backends:
- volume_driver: cinder.volume.drivers.lvm.LVMVolumeDriver
volume_group: cinder-volumes
iscsi_protocol: iscsi
iscsi_helper: lioadm
target_protocol: iscsi
target_helper: lioadm
volume_backend_name: lvm
- volume_backend_name: xtremio