Chris Dent c32d5a3809 Rename and restructure install docs

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

2019-03-19 15:59:38 +00:00

3.0 KiB

Raw Blame History

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:
```
# mysql
```

Create the placement database:

MariaDB [(none)]> CREATE DATABASE placement;

Grant proper access to the database:

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

Install and configure components

Install the packages:
```
# apt install placement-api
```
Edit the /etc/placement/placement.conf file and complete the following actions:
- In the [placement_database] section, configure database access:
```
[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:
```
[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:
```
# 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.
```
# service apache2 restart
```

3.0 KiB Raw Blame History