manila/doc/source/install/install-controller-ubuntu.rst
Tom Barron 66194ce622 doc migration: install guide
There is little material on manila in the centralized Install
Guide to migrate as outlined in the migration spec [1], so copy
from our local install guide.  After we complete this migration,
we can remove the job that builds the local install guide and
remove it from the manila tree.

[1] https://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html

Change-Id: Ibe3588c3f4560c037cf109058fc357234e70a846
Partial-Bug: #1706181
Needed-By: I04237021943bb7501acb9cfb7252be2cbf07ac4b
Depends-On: I7924d94b82e7c8d9716bad7a219fc38c57970773
Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454
2017-08-24 17:55:39 +00:00

1.7 KiB

Install and configure controller node on Ubuntu

This section describes how to install and configure the Shared File Systems service, code-named manila, on the controller node that runs Ubuntu. This service requires at least one additional share node that manages file storage back ends.

Install and configure components

  1. Install the packages:

    # apt-get install manila-api manila-scheduler python-manilaclient
  2. Edit the /etc/manila/manila.conf file and complete the following actions:

    • In the [database] section, configure database access:

      [database]
      ...
      connection = mysql+pymysql://manila:MANILA_DBPASS@controller/manila

      Replace MANILA_DBPASS with the password you chose for the Shared File Systems database.

  1. Populate the Shared File Systems database:

    # su -s /bin/sh -c "manila-manage db sync" manila

    Note

    Ignore any deprecation messages in this output.

Finalize installation

  1. Restart the Shared File Systems services:

    # service manila-scheduler restart
    # service manila-api restart
  2. By default, the Ubuntu packages create an SQLite database. Because this configuration uses an SQL database server, you can remove the SQLite database file:

    # rm -f /var/lib/manila/manila.sqlite