openstack/openstack-manuals
Code Issues Proposed changes

Converts section_volume_number_weighter.xml to RST

Browse Source 
- converts blockstorage/section_volume_number_weighter.xml
  to blockstorage_volume_number_weighter.rst

Change-Id: Id63cc760293a7e14db915d050dad79a74d63c340
This commit is contained in:
zhu.rong 2015-07-09 11:15:29 +08:00
parent 7f3042f00c
commit de30e1ee3e
2 changed files with 84 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
doc/admin-guide-cloud-rst/source/blockstorage-manage-volumes.rst
View File

@ -62,6 +62,7 @@ troubleshoot your installation and back up your Compute volumes.
.. include:: blockstorage_glusterfs_removal.rst
.. include:: blockstorage_volume_backups.rst
.. include:: blockstorage-lio-iscsi-support.rst
.. include:: blockstorage_volume_number_weighter.rst
.. include:: blockstorage-consistency-groups.rst
.. include:: blockstorage-driver-filter-weighing.rst
.. include:: blockstorage_ratelimit_volume_copy_bandwidth.rst
@ -78,6 +79,7 @@ troubleshoot your installation and back up your Compute volumes.
blockstorage_glusterfs_removal.rst
blockstorage_volume_backups.rst
blockstorage-lio-iscsi-support.rst
blockstorage_volume_number_weighter.rst
blockstorage-consistency-groups.rst
blockstorage-driver-filter-weighing.rst
blockstorage_ratelimit_volume_copy_bandwidth.rst
@ -86,4 +88,3 @@ troubleshoot your installation and back up your Compute volumes.
.. TODO (MZ) Convert and include the following sections
include: blockstorage/section_volume-migration.xml
include: blockstorage/section_volume-backups-export-import.xml
include: blockstorage/section_volume_number_weighter.xml

82
doc/admin-guide-cloud-rst/source/blockstorage_volume_number_weighter.rst Normal file
View File

@ -0,0 +1,82 @@
.. _volume_number_weighter:
.. highlight: ini
:linenothreshold: 5
Configure and use volume number weighter
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
OpenStack Block Storage enables you to choose a volume back end according
to ``free_capacity`` and ``allocated_capacity``. The volume number weighter
feature lets the scheduler choose a volume back end based on its volume
number in the volume back end. This can provide another means to improve
the volume back ends' I/O balance and the volumes' I/O performance.
Enable volume number weighter
-----------------------------
To enable a volume number weighter, set the
``scheduler_default_weighters`` to ``VolumeNumberWeigher`` flag in the
:file:`cinder.conf` file to define ``VolumeNumberWeigher``
as the selected weighter.
Configure multiple-storage back ends
------------------------------------
To configure ``VolumeNumberWeigher``, use ``LVMISCSIDriver``
as the volume driver.
This configuration defines two LVM volume groups: ``stack-volumes`` with
10 GB capacity and ``stack-volumes-1`` with 60 GB capacity.
This example configuration defines two back ends:
.. code-block:: ini
:linenos:
scheduler_default_weighers=VolumeNumberWeigher
enabled_backends=lvmdriver-1,lvmdriver-2
[lvmdriver-1]
volume_group=stack-volumes
volume_driver=cinder.volume.drivers.lvm.LVMISCSIDriver
volume_backend_name=LVM_iSCSI
[lvmdriver-2]
volume_group=stack-volumes-1
volume_driver=cinder.volume.drivers.lvm.LVMISCSIDriver
volume_backend_name=LVM_iSCSI
Volume type
-----------
Define a volume type in Block Storage::
$ cinder type-create lvm
Create an extra specification that links the volume type to a back-end name::
$ cinder type-key lvm set volume_backend_name=LVM_iSCSI
This example creates a lvm volume type with
``volume_backend_name=LVM_iSCSI`` as extra specifications.
Usage
-----
To create six 1-GB volumes, run the
:command:`cinder create --volume-type lvm 1` command six times::
$ cinder create --volume-type lvm 1
This command creates three volumes in ``stack-volumes`` and
three volumes in ``stack-volumes-1``.
List the available volumes::
# lvs
LV VG Attr LSize Pool Origin Data% Move Log Copy% Convert
volume-3814f055-5294-4796-b5e6-1b7816806e5d stack-volumes -wi-a---- 1.00g
volume-72cf5e79-99d2-4d23-b84e-1c35d3a293be stack-volumes -wi-a---- 1.00g
volume-96832554-0273-4e9d-902b-ad421dfb39d1 stack-volumes -wi-a---- 1.00g
volume-169386ef-3d3e-4a90-8439-58ceb46889d9 stack-volumes-1 -wi-a---- 1.00g
volume-460b0bbb-d8a0-4bc3-9882-a129a5fe8652 stack-volumes-1 -wi-a---- 1.00g
volume-9a08413b-0dbc-47c9-afb8-41032ab05a41 stack-volumes-1 -wi-a---- 1.00g