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

57 lines
1.4 KiB
ReStructuredText

.. _manila-controller-debian:
Install and configure controller node on Debian
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This section describes how to install and configure the Shared File Systems
service, code-named manila, on the controller node that runs a Debian
distribution. This service requires at least one additional share node that
manages file storage back ends.
.. include:: common/controller-node-prerequisites.rst
Install and configure components
--------------------------------
#. Install the packages:
.. code-block:: console
# apt-get install manila-api manila-scheduler python-manilaclient
#. Edit the ``/etc/manila/manila.conf`` file and complete the following
actions:
* In the ``[database]`` section, configure database access:
.. code-block:: ini
[database]
...
connection = mysql+pymysql://manila:MANILA_DBPASS@controller/manila
Replace ``MANILA_DBPASS`` with the password you chose for the Shared
File Systems database.
.. include:: common/controller-node-common-configuration.rst
#. Populate the Shared File Systems database:
.. code-block:: console
# su -s /bin/sh -c "manila-manage db sync" manila
.. note::
Ignore any deprecation messages in this output.
Finalize installation
---------------------
#. Restart the Shared File Systems services:
.. code-block:: console
# service manila-scheduler restart
# service manila-api restart