Install and configure a share node

Install and configure a share node

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

Install and configure components


Default configuration files vary by distribution. You might need to add these sections and options rather than modifying existing sections and options. Also, an ellipsis (...) in the configuration snippets indicates potential default configuration options that you should retain.

  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:

      connection = mysql+pymysql://manila:MANILA_DBPASS@controller/manila

      Replace MANILA_DBPASS with the password you chose for the Share File System database.

    • In the [DEFAULT] and [oslo_messaging_rabbit] sections, configure RabbitMQ message queue access:

      rpc_backend = rabbit
      rabbit_host = controller
      rabbit_userid = openstack
      rabbit_password = RABBIT_PASS

      Replace RABBIT_PASS with the password you chose for the openstack account in RabbitMQ.

    • In the [DEFAULT] section, set the following config values:

      default_share_type = default_share_type
      rootwrap_config = /etc/manila/rootwrap.conf
    • In the [DEFAULT] and [keystone_authtoken] sections, configure Identity service access:

      auth_strategy = keystone
      memcached_servers = controller:11211
      auth_uri = http://controller:5000
      auth_url = http://controller:35357
      auth_type = password
      project_domain_name = default
      user_domain_name = default
      project_name = service
      username = manila
      password = MANILA_PASS

      Replace MANILA_PASS with the password you chose for the manila user in the Identity service.

    • In the [DEFAULT] section, configure the my_ip option:


      Replace MANAGEMENT_INTERFACE_IP_ADDRESS with the IP address of the management network interface on your share node, typically for the first node in the example architecture.

    • In the [oslo_concurrency] section, configure the lock path:

      lock_path = /var/lib/manila/tmp

Configure share server management support options

The share node can support two modes, with and without the handling of share servers. The mode depends on driver support.

Option 1 deploys the service without driver support for share management. In this mode, the service does not do anything related to networking. The operator must ensure network connectivity between instances and the NFS server. This option uses LVM driver that requires LVM and NFS packages as well as an additional disk for the manila-share LVM volume group.

Option 2 deploys the service with driver support for share management. In this mode, the service requires Compute (nova), Networking (neutron) and Block storage (cinder) services for managing share servers. The information used for creating share servers is configured as share networks. This option uses the generic driver with the handling of share servers capacity and requires attaching the selfservice network to a router.


A bug prevents using both driver options on the same share node. For more information, see LVM Driver section at the Configuration Reference.

Choose one of the following options to configure the share driver. Afterwards, return here and proceed to Finalize installation.

Finalize installation

  • Start the Share File Systems service including its dependencies and configure them to start when the system boots:

    # systemctl enable openstack-manila-share.service
    # systemctl start openstack-manila-share.service
Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.