Install and configure for Ubuntu

This section describes how to install and configure the congress service for Ubuntu 14.04 (LTS).

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:

   # apt-get update
   
   # apt-get 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

Restart the congress services:

# service openstack-congress_tempest_plugin-api restart