placement/doc/source/install/install-rdo.rst
Balazs Gibizer dbd0386711 Fix domain name in install doc
Based on the keystone install docs [1][2][3] the domain created by the
bootstrap is named 'Default' (with the id 'default'). This patch fixes
the placement install docs accordingly.

[1] https://docs.openstack.org/keystone/stein/install/keystone-install-obs.html#finalize-the-installation
[2] https://docs.openstack.org/keystone/stein/install/keystone-install-rdo.html#finalize-the-installation
[3] https://docs.openstack.org/keystone/stein/install/keystone-install-ubuntu.html#finalize-the-installation

Story: #2006652
Task: #36894
Change-Id: Ia2a4b982d6146a275f433a73b6a8a13acab1e00a
2019-10-02 18:21:38 +02:00

3.2 KiB

Install and configure Placement for Red Hat Enterprise Linux and CentOS

This section describes how to install and configure the placement service when using Red Hat Enterprise Linux or CentOS packages.

Prerequisites

Before you install and configure the placement service, you must create a database, service credentials, and API endpoints.

Create Database

  1. To create the database, complete these steps:
    • Use the database access client to connect to the database server as the root user:

      $ mysql -u root -p
    • 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

  1. Install the packages:

    # yum install openstack-placement-api
  2. 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.

      Note

      The value of user_name, password, project_domain_name and user_domain_name need to be in sync with your keystone config.

  3. Populate the placement database:

    # su -s /bin/sh -c "placement-manage db sync" placement

    Note

    Ignore any deprecation messages in this output.

Finalize installation

  • Restart the httpd service:

    # systemctl restart httpd