Apply cookiecutter to newly split project
This tempest plugin is being split out of the main keystone project in
accordance with Queens goal "Split Tempest Plugins into Separate
Repos/Projects"[1]. This patch applies the standard boilerplate files
for OpenStack projects so that it can stand on its own.
[1] https://governance.openstack.org/tc/goals/queens/split-tempest-plugins.html
diff --git a/doc/source/install/common_prerequisites.rst b/doc/source/install/common_prerequisites.rst
new file mode 100644
index 0000000..45be927
--- /dev/null
+++ b/doc/source/install/common_prerequisites.rst
@@ -0,0 +1,75 @@
+Prerequisites
+-------------
+
+Before you install and configure the volume service,
+you must create a database, service credentials, and API endpoints.
+
+#. To create the database, complete these steps:
+
+ * Use the database access client to connect to the database
+ server as the ``root`` user:
+
+ .. code-block:: console
+
+ $ mysql -u root -p
+
+ * Create the ``cinder_tempest_plugin`` database:
+
+ .. code-block:: none
+
+ CREATE DATABASE cinder_tempest_plugin;
+
+ * Grant proper access to the ``cinder_tempest_plugin`` database:
+
+ .. code-block:: none
+
+ GRANT ALL PRIVILEGES ON cinder_tempest_plugin.* TO 'cinder_tempest_plugin'@'localhost' \
+ IDENTIFIED BY 'CINDER_TEMPEST_PLUGIN_DBPASS';
+ GRANT ALL PRIVILEGES ON cinder_tempest_plugin.* TO 'cinder_tempest_plugin'@'%' \
+ IDENTIFIED BY 'CINDER_TEMPEST_PLUGIN_DBPASS';
+
+ Replace ``CINDER_TEMPEST_PLUGIN_DBPASS`` with a suitable password.
+
+ * Exit the database access client.
+
+ .. code-block:: none
+
+ exit;
+
+#. Source the ``admin`` credentials to gain access to
+ admin-only CLI commands:
+
+ .. code-block:: console
+
+ $ . admin-openrc
+
+#. To create the service credentials, complete these steps:
+
+ * Create the ``cinder_tempest_plugin`` user:
+
+ .. code-block:: console
+
+ $ openstack user create --domain default --password-prompt cinder_tempest_plugin
+
+ * Add the ``admin`` role to the ``cinder_tempest_plugin`` user:
+
+ .. code-block:: console
+
+ $ openstack role add --project service --user cinder_tempest_plugin admin
+
+ * Create the cinder_tempest_plugin service entities:
+
+ .. code-block:: console
+
+ $ openstack service create --name cinder_tempest_plugin --description "volume" volume
+
+#. Create the volume service API endpoints:
+
+ .. code-block:: console
+
+ $ openstack endpoint create --region RegionOne \
+ volume public http://controller:XXXX/vY/%\(tenant_id\)s
+ $ openstack endpoint create --region RegionOne \
+ volume internal http://controller:XXXX/vY/%\(tenant_id\)s
+ $ openstack endpoint create --region RegionOne \
+ volume admin http://controller:XXXX/vY/%\(tenant_id\)s