b95a163c91
Nowadays, dnf should be used as yum has been deprecated. Change-Id: Id5682194d308d6763eac08e34bcd11cae504507c Closes-Bug: #2091583
224 lines
6.7 KiB
ReStructuredText
224 lines
6.7 KiB
ReStructuredText
Install and configure (Red Hat)
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
This section describes how to install and configure the Image service,
|
|
code-named glance, on the controller node. For simplicity, this
|
|
configuration stores images on the local file system.
|
|
|
|
Prerequisites
|
|
-------------
|
|
|
|
Before you install and configure the Image 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 -u root -p
|
|
|
|
.. end
|
|
|
|
* Create the ``glance`` database:
|
|
|
|
.. code-block:: console
|
|
|
|
MariaDB [(none)]> CREATE DATABASE glance;
|
|
|
|
.. end
|
|
|
|
* Grant proper access to the ``glance`` database:
|
|
|
|
.. code-block:: console
|
|
|
|
MariaDB [(none)]> GRANT ALL PRIVILEGES ON glance.* TO 'glance'@'localhost' \
|
|
IDENTIFIED BY 'GLANCE_DBPASS';
|
|
MariaDB [(none)]> GRANT ALL PRIVILEGES ON glance.* TO 'glance'@'%' \
|
|
IDENTIFIED BY 'GLANCE_DBPASS';
|
|
|
|
.. end
|
|
|
|
Replace ``GLANCE_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
|
|
|
|
.. end
|
|
|
|
#. To create the service credentials, complete these steps:
|
|
|
|
* Create the ``glance`` user:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack user create --domain default --password-prompt glance
|
|
|
|
User Password:
|
|
Repeat User Password:
|
|
+---------------------+----------------------------------+
|
|
| Field | Value |
|
|
+---------------------+----------------------------------+
|
|
| domain_id | default |
|
|
| enabled | True |
|
|
| id | 3f4e777c4062483ab8d9edd7dff829df |
|
|
| name | glance |
|
|
| options | {} |
|
|
| password_expires_at | None |
|
|
+---------------------+----------------------------------+
|
|
|
|
.. end
|
|
|
|
* Add the ``admin`` role to the ``glance`` user and
|
|
``service`` project:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack role add --project service --user glance admin
|
|
|
|
.. end
|
|
|
|
.. note::
|
|
|
|
This command provides no output.
|
|
|
|
* Create the ``glance`` service entity:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack service create --name glance \
|
|
--description "OpenStack Image" image
|
|
|
|
+-------------+----------------------------------+
|
|
| Field | Value |
|
|
+-------------+----------------------------------+
|
|
| description | OpenStack Image |
|
|
| enabled | True |
|
|
| id | 8c2c7f1b9b5049ea9e63757b5533e6d2 |
|
|
| name | glance |
|
|
| type | image |
|
|
+-------------+----------------------------------+
|
|
|
|
.. end
|
|
|
|
#. Create the Image service API endpoints:
|
|
|
|
.. code-block:: console
|
|
|
|
$ openstack endpoint create --region RegionOne \
|
|
image public http://controller:9292
|
|
|
|
+--------------+----------------------------------+
|
|
| Field | Value |
|
|
+--------------+----------------------------------+
|
|
| enabled | True |
|
|
| id | 340be3625e9b4239a6415d034e98aace |
|
|
| interface | public |
|
|
| region | RegionOne |
|
|
| region_id | RegionOne |
|
|
| service_id | 8c2c7f1b9b5049ea9e63757b5533e6d2 |
|
|
| service_name | glance |
|
|
| service_type | image |
|
|
| url | http://controller:9292 |
|
|
+--------------+----------------------------------+
|
|
|
|
$ openstack endpoint create --region RegionOne \
|
|
image internal http://controller:9292
|
|
|
|
+--------------+----------------------------------+
|
|
| Field | Value |
|
|
+--------------+----------------------------------+
|
|
| enabled | True |
|
|
| id | a6e4b153c2ae4c919eccfdbb7dceb5d2 |
|
|
| interface | internal |
|
|
| region | RegionOne |
|
|
| region_id | RegionOne |
|
|
| service_id | 8c2c7f1b9b5049ea9e63757b5533e6d2 |
|
|
| service_name | glance |
|
|
| service_type | image |
|
|
| url | http://controller:9292 |
|
|
+--------------+----------------------------------+
|
|
|
|
$ openstack endpoint create --region RegionOne \
|
|
image admin http://controller:9292
|
|
|
|
+--------------+----------------------------------+
|
|
| Field | Value |
|
|
+--------------+----------------------------------+
|
|
| enabled | True |
|
|
| id | 0c37ed58103f4300a84ff125a539032d |
|
|
| interface | admin |
|
|
| region | RegionOne |
|
|
| region_id | RegionOne |
|
|
| service_id | 8c2c7f1b9b5049ea9e63757b5533e6d2 |
|
|
| service_name | glance |
|
|
| service_type | image |
|
|
| url | http://controller:9292 |
|
|
+--------------+----------------------------------+
|
|
|
|
.. end
|
|
|
|
#. Register quota limits (optional):
|
|
|
|
.. include:: register-quotas.rst
|
|
|
|
Install and configure components
|
|
--------------------------------
|
|
|
|
.. include:: note_configuration_vary_by_distribution.txt
|
|
|
|
|
|
|
|
|
|
#. Install the packages:
|
|
|
|
.. code-block:: console
|
|
|
|
# dnf install openstack-glance
|
|
|
|
.. end
|
|
|
|
|
|
|
|
#. Edit the ``/etc/glance/glance-api.conf`` file and complete the
|
|
following actions:
|
|
|
|
.. include:: edit-glance-api-conf.rst
|
|
|
|
3. Populate the Image service database:
|
|
|
|
.. code-block:: console
|
|
|
|
# su -s /bin/sh -c "glance-manage db_sync" glance
|
|
|
|
.. end
|
|
|
|
.. note::
|
|
|
|
Ignore any deprecation messages in this output.
|
|
|
|
|
|
Finalize installation
|
|
---------------------
|
|
|
|
|
|
* Start the Image services and configure them to start when
|
|
the system boots:
|
|
|
|
.. code-block:: console
|
|
|
|
# systemctl enable openstack-glance-api.service
|
|
# systemctl start openstack-glance-api.service
|
|
|
|
.. end
|
|
|
|
|