dfbe3ea418
The OpenStack install guide team has recommended that projects that are not part of the starter-kit:compute [1] (and a few other projects like Cinder and Horizon) maintain their install guide in-tree. [2] [1] http://governance.openstack.org/reference/tags/starter-kit_compute.html [2] http://git.openstack.org/cgit/openstack/docs-specs/tree/specs/newton/project-specific-installguides.rst Change-Id: I2b49fcfd99b3be40bb1ae7d7b8348abdb5b58b90 Co-Authored-By: Denis Cavalcante <dencaval@gmail.com> Implements: blueprint manila-in-tree-install-guide Partially-implements: blueprint projectspecificinstallguides
209 lines
9.4 KiB
ReStructuredText
209 lines
9.4 KiB
ReStructuredText
Prerequisites
|
|
-------------
|
|
|
|
Before you install and configure the Shared File Systems 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` database:
|
|
|
|
.. code-block:: console
|
|
|
|
CREATE DATABASE manila;
|
|
|
|
* Grant proper access to the ``manila`` database:
|
|
|
|
.. code-block:: console
|
|
|
|
GRANT ALL PRIVILEGES ON manila.* TO 'manila'@'localhost' \
|
|
IDENTIFIED BY 'MANILA_DBPASS';
|
|
GRANT ALL PRIVILEGES ON manila.* TO 'manila'@'%' \
|
|
IDENTIFIED BY 'MANILA_DBPASS';
|
|
|
|
Replace ``MANILA_DBPASS`` with a suitable password.
|
|
|
|
* Exit the database access client.
|
|
|
|
#. Source the ``admin`` credentials to gain access to admin CLI commands:
|
|
|
|
.. code-block:: console
|
|
|
|
$ . admin-openrc.sh
|
|
|
|
#. To create the service credentials, complete these steps:
|
|
|
|
* Create a ``manila`` user:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack user create --domain default --password-prompt manila
|
|
User Password:
|
|
Repeat User Password:
|
|
+-----------+----------------------------------+
|
|
| Field | Value |
|
|
+-----------+----------------------------------+
|
|
| domain_id | e0353a670a9e496da891347c589539e9 |
|
|
| enabled | True |
|
|
| id | 83a3990fc2144100ba0e2e23886d8acc |
|
|
| name | manila |
|
|
+-----------+----------------------------------+
|
|
|
|
* Add the ``admin`` role to the ``manila`` user:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack role add --project service --user manila admin
|
|
|
|
.. note::
|
|
|
|
This command provides no output.
|
|
|
|
* Create the ``manila`` and ``manilav2`` service entities:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack service create --name manila \
|
|
--description "OpenStack Shared File Systems" share
|
|
+-------------+----------------------------------+
|
|
| Field | Value |
|
|
+-------------+----------------------------------+
|
|
| description | OpenStack Shared File Systems |
|
|
| enabled | True |
|
|
| id | 82378b5a16b340aa9cc790cdd46a03ba |
|
|
| name | manila |
|
|
| type | share |
|
|
+-------------+----------------------------------+
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack service create --name manilav2 \
|
|
--description "OpenStack Shared File Systems" sharev2
|
|
+-------------+----------------------------------+
|
|
| Field | Value |
|
|
+-------------+----------------------------------+
|
|
| description | OpenStack Shared File Systems |
|
|
| enabled | True |
|
|
| id | 30d92a97a81a4e5d8fd97a32bafd7b88 |
|
|
| name | manilav2 |
|
|
| type | sharev2 |
|
|
+-------------+----------------------------------+
|
|
|
|
.. note::
|
|
|
|
The Shared File Systems services require two service entities.
|
|
|
|
#. Create the Shared File Systems service API endpoints:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack endpoint create --region RegionOne \
|
|
share public http://controller:8786/v1/%\(tenant_id\)s
|
|
+--------------+-----------------------------------------+
|
|
| Field | Value |
|
|
+--------------+-----------------------------------------+
|
|
| enabled | True |
|
|
| id | 0bd2bbf8d28b433aaea56a254c69f69d |
|
|
| interface | public |
|
|
| region | RegionOne |
|
|
| region_id | RegionOne |
|
|
| service_id | 82378b5a16b340aa9cc790cdd46a03ba |
|
|
| service_name | manila |
|
|
| service_type | share |
|
|
| url | http://controller:8786/v1/%(tenant_id)s |
|
|
+--------------+-----------------------------------------+
|
|
|
|
$ openstack endpoint create --region RegionOne \
|
|
share internal http://controller:8786/v1/%\(tenant_id\)s
|
|
+--------------+-----------------------------------------+
|
|
| Field | Value |
|
|
+--------------+-----------------------------------------+
|
|
| enabled | True |
|
|
| id | a2859b5732cc48b5b083dd36dafb6fd9 |
|
|
| interface | internal |
|
|
| region | RegionOne |
|
|
| region_id | RegionOne |
|
|
| service_id | 82378b5a16b340aa9cc790cdd46a03ba |
|
|
| service_name | manila |
|
|
| service_type | share |
|
|
| url | http://controller:8786/v1/%(tenant_id)s |
|
|
+--------------+-----------------------------------------+
|
|
|
|
$ openstack endpoint create --region RegionOne \
|
|
share admin http://controller:8786/v1/%\(tenant_id\)s
|
|
+--------------+-----------------------------------------+
|
|
| Field | Value |
|
|
+--------------+-----------------------------------------+
|
|
| enabled | True |
|
|
| id | f7f46df93a374cc49c0121bef41da03c |
|
|
| interface | admin |
|
|
| region | RegionOne |
|
|
| region_id | RegionOne |
|
|
| service_id | 82378b5a16b340aa9cc790cdd46a03ba |
|
|
| service_name | manila |
|
|
| service_type | share |
|
|
| url | http://controller:8786/v1/%(tenant_id)s |
|
|
+--------------+-----------------------------------------+
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack endpoint create --region RegionOne \
|
|
sharev2 public http://controller:8786/v2/%\(tenant_id\)s
|
|
+--------------+-----------------------------------------+
|
|
| Field | Value |
|
|
+--------------+-----------------------------------------+
|
|
| enabled | True |
|
|
| id | d63cc0d358da4ea680178657291eddc1 |
|
|
| interface | public |
|
|
| region | RegionOne |
|
|
| region_id | RegionOne |
|
|
| service_id | 30d92a97a81a4e5d8fd97a32bafd7b88 |
|
|
| service_name | manilav2 |
|
|
| service_type | sharev2 |
|
|
| url | http://controller:8786/v2/%(tenant_id)s |
|
|
+--------------+-----------------------------------------+
|
|
|
|
$ openstack endpoint create --region RegionOne \
|
|
sharev2 internal http://controller:8786/v2/%\(tenant_id\)s
|
|
+--------------+-----------------------------------------+
|
|
| Field | Value |
|
|
+--------------+-----------------------------------------+
|
|
| enabled | True |
|
|
| id | afc86e5f50804008add349dba605da54 |
|
|
| interface | internal |
|
|
| region | RegionOne |
|
|
| region_id | RegionOne |
|
|
| service_id | 30d92a97a81a4e5d8fd97a32bafd7b88 |
|
|
| service_name | manilav2 |
|
|
| service_type | sharev2 |
|
|
| url | http://controller:8786/v2/%(tenant_id)s |
|
|
+--------------+-----------------------------------------+
|
|
|
|
$ openstack endpoint create --region RegionOne \
|
|
sharev2 admin http://controller:8786/v2/%\(tenant_id\)s
|
|
+--------------+-----------------------------------------+
|
|
| Field | Value |
|
|
+--------------+-----------------------------------------+
|
|
| enabled | True |
|
|
| id | e814a0cec40546e98cf0c25a82498483 |
|
|
| interface | admin |
|
|
| region | RegionOne |
|
|
| region_id | RegionOne |
|
|
| service_id | 30d92a97a81a4e5d8fd97a32bafd7b88 |
|
|
| service_name | manilav2 |
|
|
| service_type | sharev2 |
|
|
| url | http://controller:8786/v2/%(tenant_id)s |
|
|
+--------------+-----------------------------------------+
|
|
|
|
.. note::
|
|
|
|
The Shared File Systems services require endpoints for each service
|
|
entity.
|