c32d5a3809
The concept/name of controller was copied over from nova when the docs were imported. That concept doesn't really fit in with placement and also does not describe what the docs are actually doing. We're not installing a controller, we're installing placement. Thus filenames and titles are updated and intro paragraphs clarified. Also, the endpoints.rst file is moved into a shared directory as it is not a standalone install doc. Note that the big warning remains on the top of the install docs because it is still true. These instructions and the packages they mention have not been verified. Story: 2005190 Change-Id: I5fcbc90eda3ef74dba2336ea3e5c9f53938c6378
124 lines
3.0 KiB
ReStructuredText
124 lines
3.0 KiB
ReStructuredText
Install and configure Placement for Ubuntu
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
This section describes how to install and configure the placement service
|
|
when using Ubuntu packages.
|
|
|
|
Prerequisites
|
|
-------------
|
|
|
|
Before you install and configure the placement service, you must create
|
|
a database, service credentials, and API endpoints.
|
|
|
|
Create Database
|
|
^^^^^^^^^^^^^^^
|
|
|
|
#. 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 ``placement`` database:
|
|
|
|
.. code-block:: console
|
|
|
|
MariaDB [(none)]> CREATE DATABASE placement;
|
|
|
|
* Grant proper access to the database:
|
|
|
|
.. code-block:: console
|
|
|
|
MariaDB [(none)]> GRANT ALL PRIVILEGES ON placement.* TO 'placement'@'localhost' \
|
|
IDENTIFIED BY 'PLACEMENT_DBPASS';
|
|
MariaDB [(none)]> GRANT ALL PRIVILEGES ON placement.* TO 'placement'@'%' \
|
|
IDENTIFIED BY 'PLACEMENT_DBPASS';
|
|
|
|
Replace ``PLACEMENT_DBPASS`` with a suitable password.
|
|
|
|
* Exit the database access client.
|
|
|
|
Configure User and Endpoints
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
.. include:: shared/endpoints.rst
|
|
|
|
Install and configure components
|
|
--------------------------------
|
|
|
|
.. include:: note_configuration_vary_by_distribution.rst
|
|
|
|
#. Install the packages:
|
|
|
|
.. code-block:: console
|
|
|
|
# apt install placement-api
|
|
|
|
#. Edit the ``/etc/placement/placement.conf`` file and complete the following
|
|
actions:
|
|
|
|
* In the ``[placement_database]`` section, configure database access:
|
|
|
|
.. path /etc/placement/placement.conf
|
|
.. code-block:: ini
|
|
|
|
[placement_database]
|
|
# ...
|
|
connection = mysql+pymysql://placement:PLACEMENT_DBPASS@controller/placement
|
|
|
|
Replace ``PLACEMENT_DBPASS`` with the password you chose for the placement
|
|
database.
|
|
|
|
* In the ``[api]`` and ``[keystone_authtoken]`` sections, configure Identity
|
|
service access:
|
|
|
|
.. path /etc/placement/placement.conf
|
|
.. code-block:: ini
|
|
|
|
[api]
|
|
# ...
|
|
auth_strategy = keystone
|
|
|
|
[keystone_authtoken]
|
|
# ...
|
|
auth_url = http://controller:5000/v3
|
|
memcached_servers = controller:11211
|
|
auth_type = password
|
|
project_domain_name = default
|
|
user_domain_name = default
|
|
project_name = service
|
|
username = placement
|
|
password = PLACEMENT_PASS
|
|
|
|
Replace ``PLACEMENT_PASS`` with the password you chose for the
|
|
``placement`` user in the Identity service.
|
|
|
|
.. note::
|
|
|
|
Comment out or remove any other options in the ``[keystone_authtoken]``
|
|
section.
|
|
|
|
#. Populate the ``placement`` database:
|
|
|
|
.. code-block:: console
|
|
|
|
# su -s /bin/sh -c "placement-manage db sync" placement
|
|
|
|
.. note::
|
|
|
|
Ignore any deprecation messages in this output.
|
|
|
|
|
|
Finalize installation
|
|
---------------------
|
|
|
|
* Reload the web server to adjust to get new configuration settings for
|
|
placement.
|
|
|
|
.. code-block:: console
|
|
|
|
# service apache2 restart
|