manila/install-guide/source/install-controller-ubuntu.rst

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