e05b261af7
In this patch: - adjusted VersionsController to return only v3 - removed cinder.api.v2.router - adjustments to cinder.tests.unit.api.contrib to use /v3 only - moved cinder.api.v2.snapshot_metadata (and tests) to cinder.api.v3 - moved cinder.api.v2.types (and view, tests) to cinder.api.v3 - updated versions response in api-ref - removed unnecessary config option - updated various sample config files - removed experimental tempest-cinder-v2-api job - updated some docs - updated non-voting rally job config Some cinder.api.v2 modules are left because the v3 classes depend on them, but with the v2 router removed, these are unreachable via the /v2 path. Depends-on: https://review.opendev.org/c/openstack/rally-openstack/+/794891 (changes rally to use Block Storage API v3) Depends-on: https://review.opendev.org/c/openstack/requirements/+/794894 (corrects regression in upper-constraint on Sphinx) Change-Id: I2093d77db9beec7543c7524d2cd273e79dd5fd5d
284 lines
9.3 KiB
ReStructuredText
284 lines
9.3 KiB
ReStructuredText
Install and configure controller node
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
This section describes how to install and configure the Block
|
|
Storage service, code-named cinder, on the controller node. This
|
|
service requires at least one additional storage node that provides
|
|
volumes to instances.
|
|
|
|
Prerequisites
|
|
-------------
|
|
|
|
Before you install and configure the Block Storage service, you
|
|
must create a database, service credentials, and API endpoints.
|
|
|
|
#. To create the database, complete these steps:
|
|
|
|
|
|
#. Use the database access client to connect to the database
|
|
server as the ``root`` user:
|
|
|
|
.. code-block:: console
|
|
|
|
# mysql
|
|
|
|
#. Create the ``cinder`` database:
|
|
|
|
.. code-block:: console
|
|
|
|
MariaDB [(none)]> CREATE DATABASE cinder;
|
|
|
|
#. Grant proper access to the ``cinder`` database:
|
|
|
|
.. code-block:: console
|
|
|
|
MariaDB [(none)]> GRANT ALL PRIVILEGES ON cinder.* TO 'cinder'@'localhost' \
|
|
IDENTIFIED BY 'CINDER_DBPASS';
|
|
MariaDB [(none)]> GRANT ALL PRIVILEGES ON cinder.* TO 'cinder'@'%' \
|
|
IDENTIFIED BY 'CINDER_DBPASS';
|
|
|
|
Replace ``CINDER_DBPASS`` with a suitable password.
|
|
|
|
#. Exit the database access client.
|
|
|
|
#. Source the ``admin`` credentials to gain access to admin-only
|
|
CLI commands:
|
|
|
|
.. code-block:: console
|
|
|
|
$ . admin-openrc
|
|
|
|
#. To create the service credentials, complete these steps:
|
|
|
|
#. Create a ``cinder`` user:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack user create --domain default --password-prompt cinder
|
|
|
|
User Password:
|
|
Repeat User Password:
|
|
+---------------------+----------------------------------+
|
|
| Field | Value |
|
|
+---------------------+----------------------------------+
|
|
| domain_id | default |
|
|
| enabled | True |
|
|
| id | 9d7e33de3e1a498390353819bc7d245d |
|
|
| name | cinder |
|
|
| options | {} |
|
|
| password_expires_at | None |
|
|
+---------------------+----------------------------------+
|
|
|
|
#. Add the ``admin`` role to the ``cinder`` user:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack role add --project service --user cinder admin
|
|
|
|
.. note::
|
|
|
|
This command provides no output.
|
|
|
|
#. Create the ``cinderv3`` service entity:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack service create --name cinderv3 \
|
|
--description "OpenStack Block Storage" volumev3
|
|
|
|
+-------------+----------------------------------+
|
|
| Field | Value |
|
|
+-------------+----------------------------------+
|
|
| description | OpenStack Block Storage |
|
|
| enabled | True |
|
|
| id | ab3bbbef780845a1a283490d281e7fda |
|
|
| name | cinderv3 |
|
|
| type | volumev3 |
|
|
+-------------+----------------------------------+
|
|
|
|
.. note::
|
|
|
|
Beginning with the Xena release, the Block Storage services
|
|
require only one service entity. For prior releases, please
|
|
consult the documentation for that specific release.
|
|
|
|
#. Create the Block Storage service API endpoints:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack endpoint create --region RegionOne \
|
|
volumev3 public http://controller:8776/v3/%\(project_id\)s
|
|
|
|
+--------------+------------------------------------------+
|
|
| Field | Value |
|
|
+--------------+------------------------------------------+
|
|
| enabled | True |
|
|
| id | 03fa2c90153546c295bf30ca86b1344b |
|
|
| interface | public |
|
|
| region | RegionOne |
|
|
| region_id | RegionOne |
|
|
| service_id | ab3bbbef780845a1a283490d281e7fda |
|
|
| service_name | cinderv3 |
|
|
| service_type | volumev3 |
|
|
| url | http://controller:8776/v3/%(project_id)s |
|
|
+--------------+------------------------------------------+
|
|
|
|
$ openstack endpoint create --region RegionOne \
|
|
volumev3 internal http://controller:8776/v3/%\(project_id\)s
|
|
|
|
+--------------+------------------------------------------+
|
|
| Field | Value |
|
|
+--------------+------------------------------------------+
|
|
| enabled | True |
|
|
| id | 94f684395d1b41068c70e4ecb11364b2 |
|
|
| interface | internal |
|
|
| region | RegionOne |
|
|
| region_id | RegionOne |
|
|
| service_id | ab3bbbef780845a1a283490d281e7fda |
|
|
| service_name | cinderv3 |
|
|
| service_type | volumev3 |
|
|
| url | http://controller:8776/v3/%(project_id)s |
|
|
+--------------+------------------------------------------+
|
|
|
|
$ openstack endpoint create --region RegionOne \
|
|
volumev3 admin http://controller:8776/v3/%\(project_id\)s
|
|
|
|
+--------------+------------------------------------------+
|
|
| Field | Value |
|
|
+--------------+------------------------------------------+
|
|
| enabled | True |
|
|
| id | 4511c28a0f9840c78bacb25f10f62c98 |
|
|
| interface | admin |
|
|
| region | RegionOne |
|
|
| region_id | RegionOne |
|
|
| service_id | ab3bbbef780845a1a283490d281e7fda |
|
|
| service_name | cinderv3 |
|
|
| service_type | volumev3 |
|
|
| url | http://controller:8776/v3/%(project_id)s |
|
|
+--------------+------------------------------------------+
|
|
|
|
|
|
Install and configure components
|
|
--------------------------------
|
|
|
|
#. Install the packages:
|
|
|
|
.. code-block:: console
|
|
|
|
# apt install cinder-api cinder-scheduler
|
|
|
|
#. Edit the ``/etc/cinder/cinder.conf`` file and complete the
|
|
following actions:
|
|
|
|
#. In the ``[database]`` section, configure database access:
|
|
|
|
.. path /etc/cinder/cinder.conf
|
|
.. code-block:: ini
|
|
|
|
[database]
|
|
# ...
|
|
connection = mysql+pymysql://cinder:CINDER_DBPASS@controller/cinder
|
|
|
|
Replace ``CINDER_DBPASS`` with the password you chose for the
|
|
Block Storage database.
|
|
|
|
#. In the ``[DEFAULT]`` section, configure ``RabbitMQ``
|
|
message queue access:
|
|
|
|
.. path /etc/cinder/cinder.conf
|
|
.. code-block:: ini
|
|
|
|
[DEFAULT]
|
|
# ...
|
|
transport_url = rabbit://openstack:RABBIT_PASS@controller
|
|
|
|
Replace ``RABBIT_PASS`` with the password you chose for the
|
|
``openstack`` account in ``RabbitMQ``.
|
|
|
|
#. In the ``[DEFAULT]`` and ``[keystone_authtoken]`` sections,
|
|
configure Identity service access:
|
|
|
|
.. path /etc/cinder/cinder.conf
|
|
.. code-block:: ini
|
|
|
|
[DEFAULT]
|
|
# ...
|
|
auth_strategy = keystone
|
|
|
|
[keystone_authtoken]
|
|
# ...
|
|
www_authenticate_uri = http://controller:5000
|
|
auth_url = http://controller:5000
|
|
memcached_servers = controller:11211
|
|
auth_type = password
|
|
project_domain_name = default
|
|
user_domain_name = default
|
|
project_name = service
|
|
username = cinder
|
|
password = CINDER_PASS
|
|
|
|
Replace ``CINDER_PASS`` with the password you chose for
|
|
the ``cinder`` user in the Identity service.
|
|
|
|
.. note::
|
|
|
|
Comment out or remove any other options in the
|
|
``[keystone_authtoken]`` section.
|
|
|
|
#. In the ``[DEFAULT]`` section, configure the ``my_ip`` option to
|
|
use the management interface IP address of the controller node:
|
|
|
|
.. path /etc/cinder/cinder.conf
|
|
.. code-block:: ini
|
|
|
|
[DEFAULT]
|
|
# ...
|
|
my_ip = 10.0.0.11
|
|
|
|
#. In the ``[oslo_concurrency]`` section, configure the lock path:
|
|
|
|
.. path /etc/cinder/cinder.conf
|
|
.. code-block:: ini
|
|
|
|
[oslo_concurrency]
|
|
# ...
|
|
lock_path = /var/lib/cinder/tmp
|
|
|
|
#. Populate the Block Storage database:
|
|
|
|
.. code-block:: console
|
|
|
|
# su -s /bin/sh -c "cinder-manage db sync" cinder
|
|
|
|
.. note::
|
|
|
|
Ignore any deprecation messages in this output.
|
|
|
|
Configure Compute to use Block Storage
|
|
--------------------------------------
|
|
|
|
#. Edit the ``/etc/nova/nova.conf`` file and add the following
|
|
to it:
|
|
|
|
.. path /etc/nova/nova.conf
|
|
.. code-block:: ini
|
|
|
|
[cinder]
|
|
os_region_name = RegionOne
|
|
|
|
Finalize installation
|
|
---------------------
|
|
|
|
#. Restart the Compute API service:
|
|
|
|
.. code-block:: console
|
|
|
|
# service nova-api restart
|
|
|
|
#. Restart the Block Storage services:
|
|
|
|
.. code-block:: console
|
|
|
|
# service cinder-scheduler restart
|
|
# service apache2 restart
|