From 7a6180575cf1c0286aadd4135824764a77230c8c Mon Sep 17 00:00:00 2001
From: "Jay S. Bryant" <jungleboyj@electronicjungle.net>
Date: Sat, 8 Jul 2017 14:06:39 -0500
Subject: [PATCH] Migrate Cinder Scheduling CLI documentation

The next chapter in the Cinder documentation migration.

This change brings over the scheduling documentation from
openstack-manuals.

As with the other changes, this is just intended to make the
content accessible again.  Future patches will be proposed to
improve the content.

Change-Id: Idf0366bdf7bf1a3f5b67ea46c30bbf5d92120c3b
---
 doc/source/admin/cli-cinder-scheduling.rst | 58 ++++++++++++++++++++++
 doc/source/index.rst                       |  1 +
 2 files changed, 59 insertions(+)
 create mode 100644 doc/source/admin/cli-cinder-scheduling.rst

diff --git a/doc/source/admin/cli-cinder-scheduling.rst b/doc/source/admin/cli-cinder-scheduling.rst
new file mode 100644
index 00000000000..d33dd7c9937
--- /dev/null
+++ b/doc/source/admin/cli-cinder-scheduling.rst
@@ -0,0 +1,58 @@
+===============================
+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
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 0be8067baf3..58ac485fbaa 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -69,6 +69,7 @@ Command Line Interface Documentation
    admin/cli-manage-volumes
    admin/cli-set-quotas
    admin/cli-cinder-quotas
+   admin/cli-cinder-scheduling
 
 Drivers
 =======