1423480fb6
The following spec defines what each project's doc/source directory is supposed to look like: https://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html I had not yet moved existing content to follow this design. This patch does that, moving the devref to the 'contributor' directory. It also moves the CLI related documentation into the 'cli' directory. I have updated the autodoc generation to now create the api documentation in 'doc/source/contributor/api'. This patch also creates a template for future documentation contribution. I have created all of the directories recommended by the spec and have included documentation as to what should go in each directory. The index file is updated to point at the new locations for existing content. 'doc/.gitignore' is updated so that it won't complain about the automatically generated 'doc/contributor/api' directory. Change-Id: I55c50fa0b7c1d06c91e40dbcfd11b1c8e8378aa6
59 lines
1.7 KiB
ReStructuredText
59 lines
1.7 KiB
ReStructuredText
===============================
|
|
Manage Block Storage scheduling
|
|
===============================
|
|
|
|
As an administrative user, you have some control over which volume
|
|
back end your volumes reside on. You can specify affinity or
|
|
anti-affinity between two volumes. Affinity between volumes means
|
|
that they are stored on the same back end, whereas anti-affinity
|
|
means that they are stored on different back ends.
|
|
|
|
For information on how to set up multiple back ends for Cinder,
|
|
refer to :ref:`multi_backend`.
|
|
|
|
Example Usages
|
|
~~~~~~~~~~~~~~
|
|
|
|
#. Create a new volume on the same back end as Volume_A:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack volume create --hint same_host=Volume_A-UUID \
|
|
--size SIZE VOLUME_NAME
|
|
|
|
#. Create a new volume on a different back end than Volume_A:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack volume create --hint different_host=Volume_A-UUID \
|
|
--size SIZE VOLUME_NAME
|
|
|
|
#. Create a new volume on the same back end as Volume_A and Volume_B:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack volume create --hint same_host=Volume_A-UUID \
|
|
--hint same_host=Volume_B-UUID --size SIZE VOLUME_NAME
|
|
|
|
Or:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack volume create --hint same_host="[Volume_A-UUID, \
|
|
Volume_B-UUID]" --size SIZE VOLUME_NAME
|
|
|
|
#. Create a new volume on a different back end than both Volume_A and
|
|
Volume_B:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack volume create --hint different_host=Volume_A-UUID \
|
|
--hint different_host=Volume_B-UUID --size SIZE VOLUME_NAME
|
|
|
|
Or:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack volume create --hint different_host="[Volume_A-UUID, \
|
|
Volume_B-UUID]" --size SIZE VOLUME_NAME
|