Files
cinder-tempest-plugin/doc/source/install/common_prerequisites.rst
Nishant Kumar 9d06ea9ff3 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
2017-07-22 07:23:48 -04:00

76 lines
2.1 KiB
ReStructuredText

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