manila/doc/source/install/install-share-ubuntu.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.6 KiB

Install and configure a share node running Ubuntu

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 Ubuntu.

Install and configure components

  1. Install the packages:

    # apt-get install 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:

      # apt-get 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:

    # apt-get install neutron-plugin-linuxbridge-agent

Finalize installation

  1. Prepare manila-share as start/stop service. Start the Shared File Systems service including its dependencies:

    # service manila-share restart
  2. By default, the Ubuntu packages create an SQLite database. Because this configuration uses an SQL database server, remove the SQLite database file:

    # rm -f /var/lib/manila/manila.sqlite