installguide-cookiecutter/{{cookiecutter.repo_name}}/install-guide/source/install.rst

Install and configure

This section describes how to install and configure the {{service}} service, code-named {{codename}}, on the controller node.

This section assumes that you already have a working OpenStack environment with at least the following components installed: Compute, Image Service, Identity.

Prerequisites

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

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 {{codename}} database:

     CREATE DATABASE {{codename}};
     
     * Grant proper access to the ``{{codename}}`` database:
     
     .. code-block:: console
     
        GRANT ALL PRIVILEGES ON {{codename}}.* TO '{{codename}}'@'localhost' \
          IDENTIFIED BY '{{codename|upper}}_DBPASS';
        GRANT ALL PRIVILEGES ON {{codename}}.* TO '{{codename}}'@'%' \
          IDENTIFIED BY '{{codename|upper}}_DBPASS';
     
     Replace ``{{codename|upper}}_DBPASS`` with a suitable password.

     • Exit the database access client.

2. Source the admin credentials to gain access to admin-only CLI commands:

   $ source admin-openrc.sh

3. To create the service credentials, complete these steps:

   • Create the {{codename}} user:

     $ openstack user create --domain default --password-prompt {{codename}}

Install and configure components

Finalize installation