manila/install-guide/source/install-share-rdo.rst
Goutham Pacha Ravi dfbe3ea418 In-tree Install Guide
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
2016-08-12 08:06:38 -04:00

2.9 KiB

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

  1. Install the packages:

    # yum install openstack-manila-share python2-PyMySQL
  2. Edit the /etc/manila/manila.conf file and complete the following actions:

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

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

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

Two driver modes

Choose one of the following options to configure the share driver:

Prerequisites

Note

Perform these steps on the storage node.

  1. Install the supporting utility packages:
    • Install LVM and NFS server packages:

      # yum install lvm2 nfs-utils nfs4-acl-tools portmap
    • Start the LVM metadata service and configure it to start when the system boots:

      # systemctl enable lvm2-lvmetad.service
      # systemctl start lvm2-lvmetad.service

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:

    # yum install openstack-neutron openstack-neutron-linuxbridge ebtables

Finalize installation

  1. 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:

    # systemctl enable openstack-manila-share.service target.service
    # systemctl start openstack-manila-share.service target.service