Install and configure for Red Hat Enterprise Linux and CentOS

This section describes how to install and configure the congress service for Red Hat Enterprise Linux 7 and CentOS 7.

Prerequisites

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

     CREATE DATABASE congress_tempest_plugin;
     

   • Grant proper access to the congress_tempest_plugin database:

     GRANT ALL PRIVILEGES ON congress_tempest_plugin.* TO 'congress_tempest_plugin'@'localhost' \
       IDENTIFIED BY 'CONGRESS_TEMPEST_PLUGIN_DBPASS';
     GRANT ALL PRIVILEGES ON congress_tempest_plugin.* TO 'congress_tempest_plugin'@'%' \
       IDENTIFIED BY 'CONGRESS_TEMPEST_PLUGIN_DBPASS';
     

     Replace CONGRESS_TEMPEST_PLUGIN_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 congress_tempest_plugin user:

     $ openstack user create --domain default --password-prompt congress_tempest_plugin
     

   • Add the admin role to the congress_tempest_plugin user:

     $ openstack role add --project service --user congress_tempest_plugin admin
     

   • Create the congress_tempest_plugin service entities:

     $ openstack service create --name congress_tempest_plugin --description "congress" congress
     

4. Create the congress service API endpoints:

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

Install and configure components

1. Install the packages:

   # yum install
   

2. Edit the /etc/congress_tempest_plugin/congress_tempest_plugin.conf file and complete the following actions:

   • In the [database] section, configure database access:

     [database]
     ...
     connection = mysql+pymysql://congress_tempest_plugin:CONGRESS_TEMPEST_PLUGIN_DBPASS@controller/congress_tempest_plugin
     

Finalize installation

Start the congress services and configure them to start when the system boots:

# systemctl enable openstack-congress_tempest_plugin-api.service

# systemctl start openstack-congress_tempest_plugin-api.service