Installation and configuration¶
Installation¶
Important
Cinder SDS driver supports modules version 2.2 and higher, as well as OpenStack Antelope.
Important
First need to do setting up the environment. All commands are executed only from superuser.
Mode superuser:
sudo -i
Important
Installation is performed on all nodes with cinder-volume
service.
Install package:
from Python packages repository:
pip3 install cinder-sds-driver
Configuration¶
Important
It is recommended to increase the value of the rpc_response_timeout
parameter in the [DEFAULT]
section in configuration file /etc/cinder/cinder.conf
on all Cinder nodes and value of the agent_response_timeout
drivers parameter on nodes with cinder-volume
for correct execution of long-term operations on volumes.
Configure and start
aos-agent
service oflvm
type on nodes with cinder-volume, cinder-backup and nova-compute services.Specify the driver as the storage backend driver in the Cinder config file
/etc/cinder/cinder.conf
.Example of configuring
sanlock
backend:[sanlock] volume_driver = cinder_sds_driver.driver.SDSDriver agent_transport_url = amqp://aos:password@sanlock.stand.loc/aos volume_group = vol lvm_type = default lvm_mirrors = 0 volume_backend_name=sanlock agent_response_timeout = 60 [nova] token_auth_url = http://sanlock.stand.loc:5000 auth_section = keystone_authtoken auth_type = password
cinder-volume
service restart:# Debian: systemctl restart cinder-volume.service
Driver parameters¶
Driver extends standard LVM driver parameters in Cinder config file /etc/cinder/cinder.conf
with additional:
Section | Parameter | Description | Default value |
---|---|---|---|
[sanlock] |
agent_transport_url |
Connection parameters to the message server AMQP. Example: Important If there are special characters in the login and password, they should be replaced with the corresponding URL codes. Example: |
|
[sanlock] |
agent_response_timeout |
Maximum time to wait for a response from aos-agent service. |
60 |
[sanlock] |
agent_confirm_timeout |
Maximum time to wait for confirmation of response from aos-agent service. |
10 |
[nova] |
token_auth_url |
Nova service connection parameters. Example: http://sanlock.stand.loc:5000 . |
|
[nova] |
auth_section |
Section of Keystone configuration file used for authorization. | keystone_authtoken |
[nova] |
auth_type |
Authorization type. | password |
Important
It is necessary to fill in parameters of section [nova]
for the driver to work correctly.
Note
Section name [sanlock]
is the name of Cinder backend and may differ in each case.