Apply cookiecutter to newly split project
This tempest plugin is being split out of the main manila 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..511e8f4
--- /dev/null
+++ b/doc/source/install/common_prerequisites.rst
@@ -0,0 +1,75 @@
+Prerequisites
+-------------
+
+Before you install and configure the openstack 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 ``manila-tempest-plugin`` database:
+
+ .. code-block:: none
+
+ CREATE DATABASE manila-tempest-plugin;
+
+ * Grant proper access to the ``manila-tempest-plugin`` database:
+
+ .. code-block:: none
+
+ GRANT ALL PRIVILEGES ON manila-tempest-plugin.* TO 'manila-tempest-plugin'@'localhost' \
+ IDENTIFIED BY 'MANILA-TEMPEST-PLUGIN_DBPASS';
+ GRANT ALL PRIVILEGES ON manila-tempest-plugin.* TO 'manila-tempest-plugin'@'%' \
+ IDENTIFIED BY 'MANILA-TEMPEST-PLUGIN_DBPASS';
+
+ Replace ``MANILA-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 ``manila-tempest-plugin`` user:
+
+ .. code-block:: console
+
+ $ openstack user create --domain default --password-prompt manila-tempest-plugin
+
+ * Add the ``admin`` role to the ``manila-tempest-plugin`` user:
+
+ .. code-block:: console
+
+ $ openstack role add --project service --user manila-tempest-plugin admin
+
+ * Create the manila-tempest-plugin service entities:
+
+ .. code-block:: console
+
+ $ openstack service create --name manila-tempest-plugin --description "openstack" openstack
+
+#. Create the openstack service API endpoints:
+
+ .. code-block:: console
+
+ $ openstack endpoint create --region RegionOne \
+ openstack public http://controller:XXXX/vY/%\(tenant_id\)s
+ $ openstack endpoint create --region RegionOne \
+ openstack internal http://controller:XXXX/vY/%\(tenant_id\)s
+ $ openstack endpoint create --region RegionOne \
+ openstack admin http://controller:XXXX/vY/%\(tenant_id\)s