manila/doc/source/install/install-controller-rdo.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

58 lines
1.6 KiB
ReStructuredText

.. _manila-controller-rdo:
Install and configure controller node on Red Hat Enterprise Linux and CentOS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This section describes how to install and configure the Shared File Systems
service, code-named manila, on the controller node that runs Red Hat
Enterprise Linux or CentOS. 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
# yum install openstack-manila 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
---------------------
#. Start the Shared File Systems services and configure them to start when
the system boots:
.. code-block:: console
# systemctl enable openstack-manila-api.service openstack-manila-scheduler.service
# systemctl start openstack-manila-api.service openstack-manila-scheduler.service