openstack-manuals/doc/install-guide/source/manila-share-install.rst

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

1. Install the packages:

   obs

   # zypper install openstack-manila-share python-PyMySQL

   rdo

   # yum install openstack-manila-share python2-PyMySQL

   ubuntu

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

     ubuntu or obs

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

     rdo

     [database]
     ...
     connection = mysql://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:

     [DEFAULT]
     ...
     rpc_backend = rabbit
     
     [oslo_messaging_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]
     ...
     default_share_type = default_share_type
     rootwrap_config = /etc/manila/rootwrap.conf

   • In the [DEFAULT] and [keystone_authtoken] sections, configure Identity service access:

     [DEFAULT]
     ...
     auth_strategy = keystone
     
     [keystone_authtoken]
     ...
     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:

     [DEFAULT]
     ...
     my_ip = MANAGEMENT_INTERFACE_IP_ADDRESS

     Replace MANAGEMENT_INTERFACE_IP_ADDRESS with the IP address of the management network interface on your share node, typically 10.0.0.41 for the first node in the example architecture <overview-example-architectures>.

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

     [oslo_concurrency]
     ...
     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.

Warning

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 manila-share-finalize-install.

manila-share-install-dhss-false-option1.rst manila-share-install-dhss-true-option2.rst

Finalize installation

obs

• 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

rdo

• 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

ubuntu

• Start the Share File Systems service including its dependencies:

  # service manila-share restart