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

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

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
```

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

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
```

5.5 KiB Raw Blame History

Install and configure a share node

Install and configure components

Configure share server management support options

Finalize installation

5.5 KiB

Raw Blame History