dfbe3ea418
The OpenStack install guide team has recommended that projects that are not part of the starter-kit:compute [1] (and a few other projects like Cinder and Horizon) maintain their install guide in-tree. [2] [1] http://governance.openstack.org/reference/tags/starter-kit_compute.html [2] http://git.openstack.org/cgit/openstack/docs-specs/tree/specs/newton/project-specific-installguides.rst Change-Id: I2b49fcfd99b3be40bb1ae7d7b8348abdb5b58b90 Co-Authored-By: Denis Cavalcante <dencaval@gmail.com> Implements: blueprint manila-in-tree-install-guide Partially-implements: blueprint projectspecificinstallguides
104 lines
2.9 KiB
ReStructuredText
104 lines
2.9 KiB
ReStructuredText
.. _share-node-install-rdo:
|
|
|
|
Install and configure a share node running Red Hat Enterprise Linux and CentOS
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
This section describes how to install and configure a share node for the
|
|
Shared File Systems service. For simplicity, this configuration references one
|
|
storage node with the generic driver managing the share servers. The
|
|
generic backend manages share servers using compute, networking and block
|
|
services for provisioning shares.
|
|
|
|
Note that installation and configuration vary by distribution. This section
|
|
describes the instructions for a share node running Red Hat Enterprise Linux
|
|
or CentOS.
|
|
|
|
Install and configure components
|
|
--------------------------------
|
|
|
|
#. Install the packages:
|
|
|
|
.. code-block:: console
|
|
|
|
# yum install openstack-manila-share python2-PyMySQL
|
|
|
|
#. 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://manila:MANILA_DBPASS@controller/manila
|
|
|
|
|
|
Replace ``MANILA_DBPASS`` with the password you chose for
|
|
the Shared File Systems database.
|
|
|
|
.. include:: common/share-node-common-configuration.rst
|
|
|
|
Two driver modes
|
|
----------------
|
|
|
|
.. include:: common/share-node-share-server-modes.rst
|
|
|
|
Choose one of the following options to configure the share driver:
|
|
|
|
.. include:: common/dhss-false-mode-intro.rst
|
|
|
|
Prerequisites
|
|
-------------
|
|
|
|
.. note::
|
|
|
|
Perform these steps on the storage node.
|
|
|
|
#. Install the supporting utility packages:
|
|
|
|
* Install LVM and NFS server packages:
|
|
|
|
.. code-block:: console
|
|
|
|
# yum install lvm2 nfs-utils nfs4-acl-tools portmap
|
|
|
|
* Start the LVM metadata service and configure it to start when the
|
|
system boots:
|
|
|
|
.. code-block:: console
|
|
|
|
# systemctl enable lvm2-lvmetad.service
|
|
# systemctl start lvm2-lvmetad.service
|
|
|
|
.. include:: common/dhss-false-mode-configuration.rst
|
|
|
|
.. include:: common/dhss-true-mode-intro.rst
|
|
|
|
Prerequisites
|
|
-------------
|
|
|
|
Before you proceed, verify operation of the Compute, Networking, and Block
|
|
Storage services. This options requires implementation of Networking option 2
|
|
and requires installation of some Networking service components on the storage
|
|
node.
|
|
|
|
* Install the Networking service components:
|
|
|
|
.. code-block:: console
|
|
|
|
# yum install openstack-neutron openstack-neutron-linuxbridge ebtables
|
|
|
|
.. include:: common/dhss-true-mode-configuration.rst
|
|
|
|
Finalize installation
|
|
---------------------
|
|
#. Prepare manila-share as start/stop service. Start the Shared File Systems
|
|
service including its dependencies and configure them to start when the
|
|
system boots:
|
|
|
|
.. code-block:: console
|
|
|
|
# systemctl enable openstack-manila-share.service target.service
|
|
# systemctl start openstack-manila-share.service target.service
|