whereto/doc/source/install/common_prerequisites.rst
2017-08-23 11:16:01 -04:00

1.9 KiB

Prerequisites

Before you install and configure the whereto 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 whereto database:

      CREATE DATABASE whereto;
    • Grant proper access to the whereto database:

      GRANT ALL PRIVILEGES ON whereto.* TO 'whereto'@'localhost' \
        IDENTIFIED BY 'WHERETO_DBPASS';
      GRANT ALL PRIVILEGES ON whereto.* TO 'whereto'@'%' \
        IDENTIFIED BY 'WHERETO_DBPASS';

      Replace WHERETO_DBPASS with a suitable password.

    • Exit the database access client.

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

    $ . admin-openrc
  3. To create the service credentials, complete these steps:

    • Create the whereto user:

      $ openstack user create --domain default --password-prompt whereto
    • Add the admin role to the whereto user:

      $ openstack role add --project service --user whereto admin
    • Create the whereto service entities:

      $ openstack service create --name whereto --description "whereto" whereto
  4. Create the whereto service API endpoints:

    $ openstack endpoint create --region RegionOne \
      whereto public http://controller:XXXX/vY/%\(tenant_id\)s
    $ openstack endpoint create --region RegionOne \
      whereto internal http://controller:XXXX/vY/%\(tenant_id\)s
    $ openstack endpoint create --region RegionOne \
      whereto admin http://controller:XXXX/vY/%\(tenant_id\)s