# Prerequisites

Before you install and configure the Shared File Systems service, you must create a database, service credentials, and API endpoints.

1. To create the database, complete these steps:

   - Use the database access client to connect to the database server as the `root` user:

         $ mysql -u root -p

   - Create the manila database:

         CREATE DATABASE manila;

   - Grant proper access to the `manila` database:

         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.

2. Source the `admin` credentials to gain access to admin CLI commands:

       $ . admin-openrc.sh

3. To create the service credentials, complete these steps:

   - Create a `manila` user:

         $ openstack user create --domain default --password-prompt manila
         User Password:
         Repeat User Password:
         +---------------------+----------------------------------+
         | Field               | Value                            |
         +---------------------+----------------------------------+
         | domain_id           | e0353a670a9e496da891347c589539e9 |
         | enabled             | True                             |
         | id                  | 83a3990fc2144100ba0e2e23886d8acc |
         | name                | manila                           |
         | options             | {}                               |
         | password_expires_at | None                             |
         +---------------------+----------------------------------+

   - Add the `admin` role to the `manila` user:

         $ openstack role add --project service --user manila admin

     Note

     This command provides no output.

   - Create the `manila` and `manilav2` service entities:

         $ 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                            |
           +-------------+----------------------------------+

         $ openstack service create --name manilav2 \
           --description "OpenStack Shared File Systems V2" sharev2
           +-------------+----------------------------------+
           | Field       | Value                            |
           +-------------+----------------------------------+
           | description | OpenStack Shared File Systems V2 |
           | enabled     | True                             |
           | id          | 30d92a97a81a4e5d8fd97a32bafd7b88 |
           | name        | manilav2                         |
           | type        | sharev2                          |
           +-------------+----------------------------------+

     Note

     The Shared File Systems services require two service entities.

4. Create the Shared File Systems service API endpoints:

       $ openstack endpoint create --region RegionOne \
         sharev2 public http://controller:8786/v2
         +--------------+----------------------------------+
         | 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        |
         +--------------+----------------------------------+

       $ openstack endpoint create --region RegionOne \
         sharev2 internal http://controller:8786/v2
         +--------------+----------------------------------+
         | 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        |
         +--------------+----------------------------------+

       $ openstack endpoint create --region RegionOne \
         sharev2 admin http://controller:8786/v2
         +--------------+----------------------------------+
         | 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        |
         +--------------+----------------------------------+

   Note

   The Shared File Systems services require endpoints for each service entity.

this page last updated: 2026-04-22 07:00:00

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

found an error? report a bug