manila/doc/source/install/install-share-obs.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

2.4 KiB

Install and configure a share node running openSUSE and SUSE Linux Enterprise

This section describes how to install and configure a share node for the Shared File Systems service.

Note that installation and configuration vary by distribution. This section describes the instructions for a share node running openSUSE and SUSE Linux Enterprise.

Install and configure components

  1. Install the packages:

    # zypper install openstack-manila-share python-PyMySQL
  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.

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:

      # zypper install lvm2 nfs-kernel-server

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:

    # zypper install --no-recommends openstack-neutron-linuxbridge-agent

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 tgtd.service
    # systemctl start openstack-manila-share.service tgtd.service